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.
Si inserisce direttamente l'url che si vuole esplicitare sul QrCode
Si compila solamente la parte post_upload inserendo l'estensione del file che verrà caricato in un secondo momento.
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.
Ecco un esempio di upload:
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.
