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.

Campo	Required	Codifica	Descrizione
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:

Protezione attraverso Pin Code

ATTENZIONE :

Questa funzionalità è in fase di sviluppo. Indicativamente sarà disponibile dopo la prima metà del mese di Agosto 2025

E' possibile proteggere il propio QR Code da accessi non desiderati attraverso l'utilizzo di un PIN Code.

Indipendetemente dalla tipologia di utilizzo, basterà aggiungere il parametro pin_code con il codice desiderato.

In questo modo alla lettura del QR Code, verrà richiesto di inserire il PIN Code per poter procedere.

Questo codice dovrà avere una lunghezza minima di 6 caratteri ed una lunghezza massima di 32.

Di seguito alcuni esempi :

"qrCode":{
  "url":"XXXXXX",
  "pin_code": "test1234"
}

"qrCode":{
  "post_upload":{
    "file_type" :"PDF"
  },
  "pin_code": "test1234"
}

"qrCode":{
  "registrazione_esito":true,
  "pin_code": "test1234"
}

Corrieri abilitati

ID	Corriere
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
101	GLS
104	DHL
131	Fercam
182	DHL WLA