Resi

In questa sezione viene illustrato come creare e gestire ordini di reso sulla piattaforma.

Gli ordini di reso su GEL Proximity sono spedizioni che hanno come punto di partenza un Punto di Ritiro appartenente ad una Rete o al Merchant e come punto di destinazione un magazzino del Merchant stesso.

Per utilizzare le API presenti in questa guida è necessario essere autenticati alla piattaforma. Per maggiori informazioni consultare la sezione Autenticazione.

Permette di aggiornare lo stato del tracking di un ordine di reso.

Parametri

Endpoint gel-api-server/api/network/return/updateTracking
Metodo POST

Request

Nome Tipo Obbl. Default Descrizione
shipmentCode string Si – Codice GEL dell’ordine di reso
statusCode ReturnStatusCode Si – Codice GEL dello stato
statusDescription string Si – Descrizione del cambio di stato
lastUpdateDate string No – Data di aggiornamento dello stato in formato dd/MM/yyyy
lastUpdateTime string No – Data di aggiornamento dello stato in formato hh:mm
networkStatusCode string No – Codice di stato della Rete
networkStatusReason string No – Descrizione di stato della Rete

ReturnStatusCode

Chiave Valore
RT_0001 Etichetta inviata
RT_0002 Consegnato al Punto di Ritiro
RT_0003 In transito
RT_0004 Arrivato a Destinazione
RT_0005 Consegna annullata
RT_0006 Errore
{
  {
    "shipmentCode": "RET_2022019642",
    "statusCode": "RT_0001",
    "statusDescription": "Descrizione del cambio di stato"
  },
}

Response

Nome Tipo Descrizione
success boolean Esito della richiesta
message string Messaggio di risposta
{
  "success": true,
  "message": "Tracking aggiornato",
}

Permessi di modifica

Ad ogni Rete è permesso impostare solamente determinati stati di tracking in base a diversi fattori, tra cui la tipologia di Merchant e l’appartenenza del Punto di Ritiro associato all’ordine di reso.

ReturnStatusCode Permesso
RT_0001 No
RT_0002 Si
RT_0003 No
RT_0004 No
RT_0005 Si
RT_0006 No