qrCode

object

Descrizione

Oggetto contenente informazioni per mostrare, per alcuni corrieri abilitati, un QrCode multifunzionalità.

L'etichetta deve avere lunghezza minima di 10x18 cm anziché le normali 10x15 cm

"qrCode":{
  "url":"XXXXXX", // QR code di questo url
  "post_upload":{ // crea 1 oggetto S3 sul bucket su cui poi verrà fatto PUT oggetto
    "file_type" :"PDF" // nome univoco deciso da Gsped (id spedizione)
  },
  "registrazione_esito":true
}

Questo oggetto ha un solo modo per volta di essere valorizzato.

CampoRequiredCodificaDescrizione

url

string

Url fisso da mostrare nel qrCode

post_upload

object

Contenitore di chiavi per creare un oggetto S3 sul bucket su cui poi verrà fatto PUT per valorizzarlo

post_upload.file_type

string

L'estensione del file che verrà poi caricato

registrazione_esito

bool

Crea un qrCode che rimanda ad una pagina in cui chi ha accesso (normalmente l'autista che vede l'etichetta) può modificare lo stato della spedizione su Gsped.

  1. Si inserisce direttamente l'url che si vuole esplicitare sul QrCode

  2. Si compila solamente la parte post_upload inserendo l'estensione del file che verrà caricato in un secondo momento.

  3. Si valorizza registrazione_esito per creare un url di modifica status spedizione.

Le varie modalità non sono compatibili, quindi sono da usare in modo esclusivo.

Dettagli post_upload

Nel caso di post_upload, in risposta alla SHIPMENT POST vi verrà fornito un url (dentro l'oggetto qrCode) al quale fare l'upload nel momento in cui avrete il file a disposizione.

"qrCode": [
    {
        "putUrl": "XXX", // Url pur il PUT
        "url":"XXX" // Url per il GET, presente nel barcode
    }
]

Ecco un esempio di upload:

curl -X PUT -T "/path/to/file" "Gsped upload url"

Per una questione di pulizia e coerenza il nome del file deve essere l'ID GSPED della spedizione appena creata comprensivo di estensione file, ad esempio 12345.pdf

I link hanno validità di 7 giorni Nel caso siano scaduti possono essere rinnovati tramite apposito endpoint API

Dettagli registrazione_esito

La pagina a cui avrà accesso chi atterrerà sulla pagina del qrCode avrà questo aspetto e potrà segnalare i seguenti stati:

Corrieri abilitati

IDCorriere

1

BRT

2

TNT

19

Poste Delivery Business Inviosystem

70

Dummy1

71

Dummy2

72

Dummy3

73

Dummy4

74

Dummy5

75

Dummy6

76

Dummy7

77

Dummy8

78

Dummy9

79

Dummy10

90

Italsempione

91

Logisticando

92

CSILogistica

93

Ribosped

94

Zust - Tiesse

95

Lynx

97

Speditalia

104

DHL

131

Fercam

182

DHL WLA

Last updated