Tipologie di dati
In questa sezione vengono illustrate le tipologie di dati generiche presenti sui sistemi di GEL Proximity.
Durante le diverse fasi di integrazione di GEL Proximity è probabile che il sistema restituirà o richiederà informazioni e dati specifici, come codici identificativi relativi a Punti di Ritiro, Reti, Servizi, e molto altro. In questa sezione vengono esplicitate tutte le diverse tipologie di dati che è necessario conoscere per una corretta integrazione tecnica.
Nei sistemi di GEL Proximity ogni Punto di Ritiro ha sempre una e una sola Rete specifica associata, che determina il tipo di corriere a cui verrà affidata la spedizione o il reso. Ogni Rete ha un identificativo univoco come indicato in tabella.
Codice | Rete | Servizi gestiti |
---|---|---|
NET_000003 |
Poste Uffici Postali | Spedizione, Reso |
NET_000004 |
Poste PuntoPoste | Spedizione, Reso |
NET_000005 |
TNT Point | Spedizione, Reso |
NET_000017 |
BRT Fermopoint | Spedizione, Reso |
NET_000019 |
PrimaEdicola | Spedizione |
NET_000020 |
UPS Access Point | Spedizione, Reso |
NET_000021 |
Send & Collect | Spedizione |
NET_000025 |
GLS Parcel Shop | Spedizione |
NET_000026 |
Correos | Spedizione, Reso |
NET_000027 |
Correos CityPaq | Spedizione, Reso |
NET_000028 |
InPost Poland | Spedizione |
NET_000029 |
Chronopost 2Shop | Spedizione, Reso |
NET_000030 |
InPost Italia | Spedizione, Reso |
NET_000031 |
Pakkipoint | Spedizione |
NET_000035 |
DHL | Spedizione, Reso |
NET_000036 |
DHL Locker | Spedizione, Reso |
Nei sistemi di GEL Proximity ogni Rete può essere abilitata in diverse modalità. Ogni tipologia ha un identificativo univoco come indicato in tabella.
Codice | Tipologia |
---|---|
PRENEGOTIATED |
Tariffe di spedizione definite nel contratto fornito da GEL Proximity |
LABELING |
Tariffe di spedizione definite nel contratto con la Rete che viene utilizzato |
Nei sistemi di GEL Proximity alcune Reti forniscono diversi tipi di servizi. Ogni tipologia ha un identificativo univoco come indicato in tabella.
Codice | Tipologia |
---|---|
POSTE_CRONO |
Servizio di spedizione con servizio CRONO Standard |
POSTE_CRONO_EXPRESS |
Servizio di spedizione con servizio CRONO Express |
POSTE_PDB |
Servizio di spedizione con servizio PosteDeliveryBusiness Standard |
POSTE_PDB_EXPRESS |
Servizio di spedizione con servizio PosteDeliveryBusiness Express |
Codice | Tipologia |
---|---|
INPOST_A2L |
Servizio di spedizione InPost con ritiro presso magazzino |
INPOST_L2L |
Servizio di spedizione InPost con deposito al locker |
Nei sistemi di GEL Proximity ogni ordine ha sempre un servizio associato in base alla tipologia o alla configurazione della Rete effettuata dal MerchantOgni servizio ha un identificativo univoco come indicato in tabella.
Codice | Valore | Descrizione |
---|---|---|
001 |
Point Delivery | Indica una spedizione effettuata con tariffe prenegoziate offerte da GEL Proximity |
002 |
Point Reverse | Indica un reso effettuato con tariffe prenegoziate offerte da GEL Proximity |
003 |
Labeling | Indica un ordine effettuato con un contratto personale |
004 |
C&C Delivery | Indica una spedizione effettuata con tariffe prenegoziate offerte da GEL Proximity diretta ad un Punto di Ritiro Proprietario |
005 |
C&C Reverse | Indica un reso effettuato con tariffe prenegoziate offerte da GEL Proximity partito da un Punto di Ritiro Proprietario |
Nei sistemi di GEL Proximity ogni ordine ha sempre una etichetta associata.Ogni etichetta può essere di diverse tipologie come indicato in tabella.
Alcune reti non supportano tutte le tipologie di etichette.
Codice | Tipologia |
---|---|
PDF |
Tipologia documento PDF |
THERMIC |
Tipologia termica |
ZPL |
Tipologia ZPL |
Seguendo una logica di standardizzazione degli stati di avanzamento di ogni ordine, i sistemi di GEL Proximity eseguono una mappatura degli stati comunicati da ogni singola Rete ed espone uno stato “unificato” per consentire una più semplice interpretazione dello stato di avanzamento. Gli stati degli ordini di spedizione previsti da GEL Proximity sono indicati in tabella.
Codice | Valore | Descrizione |
---|---|---|
- |
Nuovo | L’ordine è stato importato su GEL Proximity ed è possibile gestirlo |
ST_0001 |
Ricevute istruzioni | La Rete ha ricevuto le istruzioni necessarie per gestire l’ordine |
ST_0002 |
In gestione al magazzino | L’etichetta è stata generata dal magazzino |
ST_0003 |
In transito | Il pacco è stato spedito |
ST_0004 |
Consegnato al Point | Il pacco è pronto per essere ritirato al Punto di Ritiro |
ST_0005 |
Consegna annullata | La spedizione è stata annullata |
ST_0006 |
Errore | La spedizione è in errore |
ST_0007 |
Ritirato dal cliente | Il pacco è stato ritirato dal cliente finale |
ST_0008 |
Consegna effettuata | Il pacco è stato consegnato al Punto di Ritiro (utilizzato solo per Merchant STORAGE) |
Seguendo una logica di standardizzazione degli stati di avanzamento di ogni ordine, i sistemi di GEL Proximity eseguono una mappatura degli stati comunicati da ogni singola Rete ed espone uno stato “unificato” per consentire una più semplice interpretazione dello stato di avanzamento. Gli stati degli ordini di reso previsti da GEL Proximity sono indicati in tabella.
Codice | Valore | Descrizione |
---|---|---|
- |
Nuovo | L’ordine è stato importato su GEL Proximity ed è possibile gestirlo |
RT_0001 |
Etichetta inviata | L’etichetta è stata inviata all’utente finale |
RT_0002 |
In gestione al Point | Il pacco è stato consegnato al Punto di Ritiro dall’utente finale |
RT_0003 |
In transito | Il pacco è stato spedito |
RT_0004 |
Arrivato a destinazione | Il pacco è stato consegnato al magazzino |
RT_0005 |
Consegna annullata | Il reso è stato annullato |
RT_0006 |
Errore | Il reso è in errore |
Nei sistemi di GEL Proximity i giorni della settimana, dove richiesti, sono indicati con i seguenti valori.
Codice | Valore |
---|---|
1 |
Lunedì |
2 |
Martedì |
3 |
Mercoledì |
4 |
Giovedì |
5 |
Venerdì |
6 |
Sabato |
7 |
Domenica |
GEL Proximity mette a disposizione diversi tipi di Webhooks, ognuno identificato da un codice evento univoco. Le informazioni relative all’evento verranno comunicate dal Webhook stesso all’endpoint configurato dal Merchant.
Codice | Tipologia | Descrizione |
---|---|---|
EV_00001 |
Creazione di una spedizione | Un nuovo ordine di spedizione è stato creato su GEL Proximity |
EV_00002 |
Aggiornamento di una spedizione | Un ordine di spedizione ha ricevuto un aggiornamento di stato |
EV_00003 |
Creazione di un reso | Un nuovo ordine di reso è stato creato su GEL Proximity |
EV_00004 |
Aggiornamento di un reso | Un ordine di reso ha ricevuto un aggiornamento di stato |
EV_00005 |
Creazione di una spedizione diretta ad un Punto di Ritiro proprietario | Un nuovo ordine di spedizione diretto ad un Punto di Ritiro proprietario è stato creato su GEL Proximity |
EV_00006 |
Creazione di un reso diretto ad un Punto di Ritiro proprietario | Un nuovo ordine di reso diretto ad un Punto di Ritiro proprietario è stato creato su GEL Proximity |