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.

Rete Poste Uffici Postali, Poste PuntoPoste

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

Rete InPost IT

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