Etichette in 5 minuti

Ingredienti:

• apikey (fornita dal team di Gsped)

• nome dell'istanza dedicata (fornita dal team di Gsped)

• client_id (fornito dal team di Gsped)

L'url da chiamare sarà https://api.gsped.it/nomeistanza/shipment con metodo POST, il body della chiamata conterrà il payload, andranno impostati gli header Content-Type e Accept a application/json e andrà valorizzato l'header X-API-KEY con la stringa comunicata dal team di Gsped

Esempio di payload minimale, corriere e servizio andranno specificati usando i valori indicati nella pagina Corrieri e servizi

{
    "client_id": 390,
    "corriere": 101,
    "servizio": 0,
    "ddt_alpha": "rifmittente",
    "peso": 3.0,
    "colli": 1,
    "rcpt_name":"Mario Rossi",
    "rcpt_addr":"Piazza Castello 1",
    "rcpt_cap":"10121",
    "rcpt_city":"Torino",
    "rcpt_prov":"TO",
    "rcpt_country_code":"IT"
}

Sulla risposta andrà prima controllato lo status code

se è 400 i dati inviati NON hanno passato i controlli preliminari prima della creazione della spedizione e nel campo error ci sono i dettagli dell'errore

se è 200 i dati inviati sono stati accettati ed è stata avviata la comunicazione con il corriere per creare la spedizione, in questo caso andrà verificato il valore del campo status nella risposta

Il campo status può assumere due valori:

Status 0.6 il corriere NON ha accettato i dati e la spedizione non è stata creata, il campo error contiene il messaggio d'errore restituito dal corriere (ad esempio cap non coerente con il nome del comune oppure servizio non disponibile per la destinazione)

Ogni corriere usa un proprio sistema per la validazione degli indirizzi, indirizzi corretti possono essere segnalati come errati se il corriere ha degli errori nel proprio database.

Non necessariamente un indirizzo trovato su google maps sarà accettato da un corriere qualsiasi.

Status 0 il corriere ha accettato i dati e generato la spedizione, gli array label-pdf, label-jpg e label-zpl conterranno le etichette da applicare sui colli (jpg e pdf sono codificati in base64, i formati restituiti dipendono dal settaggio del clientid e dal corriere)

Nella risposta compare anche il campo id che contiene l'identificatore univoco della spedizione per Gsped, questo dato è essenziale per l'operazione di conferma della spedizione.

Ultimo passaggio....

Prima dell'affidamento al corriere dei colli andrà infine eseguita una chiamata all'indirizzo https://api.gsped.it/nomeistanza/shipmentConfirm passando gli id delle spedizioni affidate e valorizzando gli header come indicato in precedenza.

Esempio di payload per la shipmentConfirm

{
  "id": [
    "12345",
    "12346",
    "12347"
  ]
}

L'operazione di conferma è essenziale per la corretta gestione delle spedizioni da parte del corriere!