DWH API

Le API DWH sono accessibili solo agli utenti registrati e autorizzati.
Per utilizzare i servizi è necessario ottenere un token JWT tramite l'endpoint /token e includerlo nelle chiamate protette nell'header HTTP Authorization nel formato Authorization: Bearer <JWT_TOKEN>.

Per registrare una nuova utenza API è necessario inviare una richiesta tramite l'endpoint /register. La registrazione è soggetta ad approvazione.
Attenzione
Solo gli utenti autorizzati possono utilizzare questo servizio.
Tutti gli accessi non autorizzati saranno perseguiti a norma di legge.
Flusso operativo principale
1. Terminale
Se per l'utente è richiesto l'uso di un terminale, occorre prima chiamare /services/BeginUseTerminal. Il terminale viene impegnato in base al suo IMEI. Per verificare se esiste già un terminale associato si può usare /services/GotTerminal. A fine attività il terminale viene rilasciato con /services/ReleaseTerminal.
2. Identificazione utente e impostazioni
Il sistema identifica l'utente API e applica le sue assegnazioni operative. Le impostazioni sono consultabili con /services/GetMySettings. La filiale associata è disponibile con /services/GetMyWareHouse.
3. Sessione e linee assegnate
Il client può consultare l'ultima sessione con /services/GetLastSession e le sessioni/linee visibili con /services/GetMySessions. La partenza del giro è consentita solo se /services/CheckCanStartTour restituisce esito positivo.
4. Preparazione giro
Prima della partenza il client scarica le consegne disponibili con /services/GetMyDeliveries, quelle parcheggiate con /services/GetMyParkedDeliveries, la sequenza eventuale del giro con /services/GetTourSequence e può impostarla con /services/SetTourSequence.
5. Controlli prima della partenza
Per ogni spedizione si possono leggere i dettagli con /services/GetDeliveryDetails, gli oggetti da consegnare con /services/GetDeliveryActions, i vuoti da ritirare con /services/GetPickupActions e le regole di consegna con /services/GetDeliveryRules. Le regole disponibili sono elencate da /services/ListDeliveryRules e possono essere impostate con /services/SetDeliveryRules.
6. Operazioni sui colli
Durante il caricamento si usano /services/CheckParcel e /services/UncheckParcel. I colli possono essere parcheggiati o ripristinati con /services/ParkParcel e /services/UnParkParcel. Un'intera spedizione può essere parcheggiata con /services/ParkDelivery e ripristinata con /services/UnParkDelivery. Gli accorpamenti si gestiscono con /services/MergeParcels e /services/UnmergeParcel. Il reset operativo della spedizione avviene con /services/ResetDelivery.
7. Avvio tour
Quando tutte le linee assegnate sono complete, chiuse e oltre il cut-off, il giro può essere avviato con /services/StartDeliveryTour. Durante il giro la posizione può essere aggiornata con /services/SetCheckPoint.
8. Consegna merce
Presso il cliente lo scarico dei colli si registra con /services/SetDeliveredParcel e si annulla con /services/UnsetDeliveredParcel. /services/NextDelivery verifica se tutti i colli della spedizione sono stati scaricati o restituisce quelli ancora a bordo.
9. Ritiro vuoti
Il recupero dei vuoti presso il cliente si registra con /services/CheckPickUp e si annulla con /services/UncheckPickUp. L'elenco dei vuoti recuperati dopo la partenza è disponibile con /services/ListPickedUp.
10. Rientro e controllo magazzino
Il rientro dei vuoti in magazzino si registra con /services/CheckReturned e si annulla con /services/UncheckReturned. I vuoti ancora da riconsegnare sono consultabili con /services/GetEmptyReturnActions. I vuoti controllati dal magazzino sono disponibili con /services/GetCheckedReturns e /services/ListControlled.
11. Supporto operativo
I contenitori ancora assegnati al corriere sono consultabili con /services/ListAssignedContainers. I DDT dell'ultima sessione sono disponibili con /services/ListLastSessionDDT. Le coordinate del punto di consegna possono essere aggiornate con /services/SetGeoLocation.
GET/status
#900
Verifica stato servizio
POST/register
#901
Registrazione utenza/API client
POST/token
#902
Richiesta token JWT
POST/changepassword
#903
Cambio password dell'utente autenticato tramite token JWT
POST/me
#904
Restituisce i dati dell'utente autenticato
GET/version
#905
Restituisce versione applicativa e ora server
GET/health
#906
Verifica lo stato applicativo e la connessione al DB
POST/refreshtoken
#907
Rinnova il token JWT dell'utente autenticato
POST/services/GetWareHouses
#001
Restituisce l'elenco delle filiali
POST/services/GetMyWareHouse
#002
Restituisce la filiale associata all'utente
POST/services/GetLastSession
#011
Restituisce l'ultima sessione di allestimento per filiale
POST/services/GetMySessions
#012
Restituisce le sessioni visibili all'utente
POST/services/GetMyParkedDeliveries
#013
Restituisce le spedizioni parcheggiate visibili all'utente
POST/services/GetMyDeliveries
#014
Restituisce le spedizioni attive visibili all'utente in base alla sessione aperta
POST/services/GetDeliveryActions
#015
Restituisce gli oggetti da consegnare per una spedizione
POST/services/GetPickupActions
#016
Restituisce i vuoti da ritirare presso il cliente
POST/services/GetEmptyReturnActions
#017
Restituisce i vuoti da riconsegnare al magazzino
POST/services/GetCheckedReturns
#018
Restituisce i vuoti controllati dal magazzino
POST/services/ParkParcel
#020
Parcheggia un singolo collo della spedizione
POST/services/UnParkParcel
#021
Rimuove il parcheggio da un singolo collo della spedizione
POST/services/ParkDelivery
#022
Parcheggia tutta la spedizione
POST/services/UnParkDelivery
#023
Rimuove il parcheggio da tutta la spedizione
POST/services/MergeParcels
#024
Accorpa un collo sorgente in un collo destinazione
POST/services/UnmergeParcel
#025
Annulla l'accorpamento di un collo
POST/services/GetDeliveryDetails
#030
Restituisce i dettagli utili di una spedizione
POST/services/CheckParcel
#031
Spunta un collo della spedizione impostando il tipo scansione
POST/services/UncheckParcel
#032
Annulla la spunta di un collo della spedizione
POST/services/CheckPickUp
#033
Registra il recupero del vuoto presso il cliente
POST/services/UncheckPickUp
#034
Annulla il recupero del vuoto presso il cliente
POST/services/ListPickedUp
#035
Restituisce i vuoti recuperati dopo la partenza del tour
POST/services/CheckReturned
#036
Registra il rientro del vuoto in magazzino
POST/services/UncheckReturned
#037
Annulla il rientro del vuoto in magazzino
POST/services/ListAssignedContainers
#038
Restituisce i contenitori assegnati non ancora rientrati in magazzino
POST/services/ListControlled
#039
Restituisce i vuoti controllati dal magazzino nella giornata precedente
POST/services/SetCheckPoint
#040
Aggiorna la posizione corrente sulle spedizioni assegnate all'utente
POST/services/ResetDelivery
#049
Resetta lo stato operativo della spedizione
POST/services/TransferToSecondCarrier
#051
Trasferisce la spedizione al secondo vettore
POST/services/TransferToThirdCarrier
#052
Trasferisce la spedizione al terzo vettore
POST/services/ListLastSessionDDT
#053
Restituisce i DDT dell'ultima sessione visibili all'utente
POST/services/CheckCanStartTour
#060
Verifica se il tour può partire in base a completamento, chiusura linea e cut-off
POST/services/StartDeliveryTour
#061
Avvia il tour impostando la data ora di partenza sulle spedizioni assegnate
POST/services/SetDeliveredParcel
#062
Imposta lo scarico di un collo della spedizione
POST/services/UnsetDeliveredParcel
#063
Annulla lo scarico di un collo della spedizione
POST/services/GetTourSequence
#064
Restituisce la sequenza del tour assegnata all'utente
POST/services/SetTourSequence
#065
Imposta la sequenza del tour sulle SessionDetails assegnate all'utente
POST/services/GetBorderaux
#066
Restituisce sigla, numero e data del prossimo Borderaux disponibile
POST/services/SetBorderaux
#067
Carica il PDF firmato del Borderaux generato esternamente
POST/services/GenerateBorderaux
#068
Genera il PDF del Borderaux con QRCode per la firma digitale
POST/services/GetSignedBorderaux
#069
Restituisce il PDF firmato del Borderaux
POST/services/NextDelivery
#070
Verifica se tutti i colli della spedizione sono stati scaricati
POST/services/GetDeliveryRules
#071
Restituisce le regole di consegna applicate alla spedizione
POST/services/ListDeliveryRules
#072
Restituisce l'elenco delle regole di consegna disponibili
POST/services/SetDeliveryRules
#073
Imposta la regola di consegna sulla spedizione
POST/services/GetCustomerAddresses
#081
Restituisce i dati logistici del cliente
POST/services/GetCustomerShippingAddress
#082
Restituisce un singolo indirizzo di spedizione del cliente
POST/services/SetGeoLocation
#083
Aggiorna latitudine e longitudine del punto di consegna
POST/services/SetCustomerGeoLocation
#084
Aggiorna latitudine e longitudine del punto di consegna identificato da filiale, cliente e indirizzo di spedizione
POST/services/BeginUseTerminal
#091
Associa un terminale all'utente tramite IMEI
POST/services/GetMySettings
#092
Restituisce gli abbinamenti configurati per l'utente corrente
POST/services/GotTerminal
#093
Verifica se l'utente API autenticato ha un terminale associato
POST/services/ReleaseTerminal
#099
Rilascia un terminale precedentemente associato all'utente
Data e Ora del Server: 13/06/2026 08:59:16Developed by PdC