# 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à **** 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](/overview/corrieri-e-servizi) ```json { "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) {% hint style="info" %} 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. {% endhint %} **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. {% hint style="info" %} **NOTA BENE :** Normalmente, i corrieri forniscono le etichette in due formati : PDF e ZPL. Alcuni corrieri forniscono entrambi i formati, mentre altri forniscono un solo formato. Tipicamente il formato del etichetta in PDF restituita dal corriere è A4 mentre l'etichetta ZPL è di dimensione 10x15cm a 203dpi {% endhint %} ### Ultimo passaggio.... Prima dell'affidamento al corriere dei colli andrà infine eseguita una chiamata all'indirizzo passando gli **id** delle spedizioni affidate e valorizzando gli header come indicato in precedenza. Esempio di payload per la shipmentConfirm ```json { "id": [ "12345", "12346", "12347" ] } ``` {% hint style="info" %} L'operazione di conferma è essenziale per la corretta gestione delle spedizioni da parte del corriere! {% endhint %} # Introduzione L’API di GSPED è un’applicazione RESTful che prevede le possibilità di creare risorse e di ottenere informazioni su risorse già create. L'indirizzo base per accedere all'API è \*\*; Nel caso si stia usando una istanza dedicata, all’URL dovrà essere aggiunto il nome dell’istanza in cui si lavora: **]** Il nome dell’istanza vi verrà fornito dal team di Gsped al momento del rilascio in produzione delle vostre configurazioni. ## Area di test In fase di onboarding a Gsped vi verrà fornita una chiave API per le chiamate di test alla nostra sandbox. L'indirizzo per eseguire le chiamata alla sandbox è **** # Autenticazione metodo di autenticazione chiamate API Le API di Gsped necessitano di autenticazione per essere interrogate. Al momento del rilascio della propria utenza, viene rilasciata anche una APIKEY da usare per le chiamate REST. Questa deve essere inserita nell' HEADER della chiamata con la chiave **X-API-KEY**. # Formato Richieste e Risposte Come definire il formato di comunicazione Le API Gsped supportano due formati di trasmissione dati: * JSON * XML Per impostare il formato voluto basta definire gli header **CONTENT-TYPE** e **ACCEPT** > Esempio per JSON (default) > > Content-Type : application/json\ > Accept : application/json # Corrieri e servizi Lista dei corrieri e relativi servizi Per identificare i corrieri e i relativi servizi nelle chiamate alle API di Gsped vanno utilizzati i codici numerici nella pagina del corriere dedicato. {% hint style="info" %} Questa lista è soggetta a modifiche ed aggiornamenti {% endhint %} | Corriere | | --------------------------------------------------------------------------------------------------------------------------------------------- | | [AlpiExpress](/spedizioni-e-dintorni/shipment/corrieri/alpiexpress#lista-codici-gsped) | | [ALT](/spedizioni-e-dintorni/shipment/corrieri/alt#lista-codici-gsped) | | [Amazon Prime](/spedizioni-e-dintorni/shipment/corrieri/amazon-prime#lista-codici-gsped) | | [Amazon Shipping](/spedizioni-e-dintorni/shipment/corrieri/amazon-shipping#lista-codici-gsped) | | [Arcese B2C](/spedizioni-e-dintorni/shipment/corrieri/arcese-b2c#lista-codici-gsped) | | [Arco Spedizioni](/spedizioni-e-dintorni/shipment/corrieri/arco-spedizioni#lista-codici-gsped) | | [Asendia](/spedizioni-e-dintorni/shipment/corrieri/asendia#lista-codici-gsped) | | [Attanasio](/spedizioni-e-dintorni/shipment/corrieri/attanasio) | | [Barone Trasporti](/spedizioni-e-dintorni/shipment/corrieri/barone-trasporti) | | [B](/spedizioni-e-dintorni/shipment/corrieri/bianchi-trasporti)[ianchi Trasporti](/spedizioni-e-dintorni/shipment/corrieri/bianchi-trasporti) | | [Bracchi](/spedizioni-e-dintorni/shipment/corrieri/bracchi#lista-codici-gsped) | | [BRT](/spedizioni-e-dintorni/shipment/corrieri/brt#lista-codici-gsped) | | [Ceva](/spedizioni-e-dintorni/shipment/corrieri/ceva#lista-codici-gsped) | | [Chronopost](/spedizioni-e-dintorni/shipment/corrieri/chronopost#lista-codici-gsped) | | [Colissimo](/spedizioni-e-dintorni/shipment/corrieri/colissimo#lista-codici-gsped) | | [Correos ES](/spedizioni-e-dintorni/shipment/corrieri/correos-es#lista-codici-gsped) | | [Correos Express](/spedizioni-e-dintorni/shipment/corrieri/correos-express#lista-codici-gsped) | | [CSI Logistica](/spedizioni-e-dintorni/shipment/corrieri/csi-logistica#lista-codici-gsped) | | [Da Rold Cassol](https://apidocs.gsped.com/spedizioni-e-dintorni/shipment/corrieri/da-rold-cassol#lista-codici-gsped) | | [Dachser Iberia](/spedizioni-e-dintorni/shipment/corrieri/dachser-iberia#lista-codici-gsped) | | [DBSchenker](/spedizioni-e-dintorni/shipment/corrieri/db-schenker#lista-codici-gsped) | | [DHL](/spedizioni-e-dintorni/shipment/corrieri/dhl#lista-codici-gsped) | | [DHL BENELUX](/spedizioni-e-dintorni/shipment/corrieri/dhl-benelux#lista-codici-gsped) | | [DHL Freight](/spedizioni-e-dintorni/shipment/corrieri/dhl-freight#lista-codici-gsped) | | [DHL Parcel](/spedizioni-e-dintorni/shipment/corrieri/dhl-parcel#lista-codici-gsped) | | [DHL Paket](/spedizioni-e-dintorni/shipment/corrieri/dhl-paket#lista-codici-gsped) | | [DHL Parcel DE](/spedizioni-e-dintorni/shipment/corrieri/dhl-parcel-de#undefined) | | [DHL WLA](/spedizioni-e-dintorni/shipment/corrieri/dhl-wla#lista-codici-gsped) | | [DPD France](/spedizioni-e-dintorni/shipment/corrieri/dpd-france) | | [DPD Germany](https://apidocs.gsped.com/spedizioni-e-dintorni/shipment/corrieri/dpd-germany) | | [DSV](/spedizioni-e-dintorni/shipment/corrieri/dsv#lista-codici-gsped) | | [DVAExpress](https://apidocs.gsped.com/spedizioni-e-dintorni/shipment/corrieri/dvaexpress#lista-codici-gsped) | | [Ecourier](/spedizioni-e-dintorni/shipment/corrieri/ecourier#lista-codici-gsped) | | [Fedex](/spedizioni-e-dintorni/shipment/corrieri/fedex) | | [Fercam](/spedizioni-e-dintorni/shipment/corrieri/fercam#lista-codici-gsped) | | [Ferrari Trasporti](/spedizioni-e-dintorni/shipment/corrieri/ferrari-trasporti#lista-codici-gsped) | | [Geodis](/spedizioni-e-dintorni/shipment/corrieri/geodis#lista-codici-gsped) | | [Glovo](/spedizioni-e-dintorni/shipment/corrieri/glovo#lista-codici-gsped) | | [GLS](/spedizioni-e-dintorni/shipment/corrieri/gls#lista-codici-gsped) | | [GLS France](/spedizioni-e-dintorni/shipment/corrieri/gls-france) | | [GLS Spain](/spedizioni-e-dintorni/shipment/corrieri/gls-spain#lista-codici-gsped) | | [Grendi](/spedizioni-e-dintorni/shipment/corrieri/grendi) | | [Gruber](/spedizioni-e-dintorni/shipment/corrieri/gruber) | | [Inpost](/spedizioni-e-dintorni/shipment/corrieri/inpost#lista-codici-gsped) | | [Italsempione](/spedizioni-e-dintorni/shipment/corrieri/italsempione#lista-codici-gsped) | | [HR PARCEL](/spedizioni-e-dintorni/shipment/corrieri/hr-parcel#lista-codici-gsped) | | [Liccardi](/spedizioni-e-dintorni/shipment/corrieri/liccardi#lista-codici-gsped) | | [Lynx](/spedizioni-e-dintorni/shipment/corrieri/lynx#lista-codici-gsped) | | [Logisticando](/spedizioni-e-dintorni/shipment/corrieri/logisticando#lista-codici-gsped) | | [MBE](/spedizioni-e-dintorni/shipment/corrieri/mbe) | | [Milkman](/spedizioni-e-dintorni/shipment/corrieri/milkman#lista-codici-gsped) | | [Monaci Trasporti](/spedizioni-e-dintorni/shipment/corrieri/monaci-trasporti) | | [Nacex](/spedizioni-e-dintorni/shipment/corrieri/nacex#lista-codici-gsped) | | [Nexive](/spedizioni-e-dintorni/shipment/corrieri/nexive#lista-codici-gsped) | | [Paack](/spedizioni-e-dintorni/shipment/corrieri/paack#lista-codici-gsped) | | [Palletways](https://apidocs.gsped.com/spedizioni-e-dintorni/shipment/corrieri/palletways) | | [Pitagorando](/spedizioni-e-dintorni/shipment/corrieri/pitagorando) | | [Poletto Group](https://apidocs.gsped.com/spedizioni-e-dintorni/shipment/corrieri/poletto-group#lista-codici-gsped) | | [Poste CH](/spedizioni-e-dintorni/shipment/corrieri/poste-ch#lista-codici-gsped) | | [Poste Delivery Business](/spedizioni-e-dintorni/shipment/corrieri/poste-delivery-business) | | [QHD](/spedizioni-e-dintorni/shipment/corrieri/qhd#lista-codici-gsped) | | [Rhenus Logistics](/spedizioni-e-dintorni/shipment/corrieri/rhenus-logistics) | | [Ribosped](/spedizioni-e-dintorni/shipment/corrieri/ribosped#lista-codici-gsped) | | [San Marino Mail](/spedizioni-e-dintorni/shipment/corrieri/san-marino-mail#lista-codici-gsped) | | [SDA](/spedizioni-e-dintorni/shipment/corrieri/sda#lista-codici-gsped) | | [Sendabox](/spedizioni-e-dintorni/shipment/corrieri/sendabox#lista-codici-gsped) | | [Sending](/spedizioni-e-dintorni/shipment/corrieri/sending#lista-codici-gsped) | | [Seur](/spedizioni-e-dintorni/shipment/corrieri/seur#lista-codici-gsped) | | [Skynet](/spedizioni-e-dintorni/shipment/corrieri/skynet#lista-codici-gsped) | | [Speditalia](/spedizioni-e-dintorni/shipment/corrieri/speditalia#lista-codici-gsped) | | [Spring](/spedizioni-e-dintorni/shipment/corrieri/spring#lista-codici-gsped) | | [Stef](/spedizioni-e-dintorni/shipment/corrieri/stef#lista-codici-gsped) | | [Stuart](/spedizioni-e-dintorni/shipment/corrieri/stuart#lista-codici-gsped) | | [Stucci](https://apidocs.gsped.com/spedizioni-e-dintorni/shipment/corrieri/stucci) | | [Susa](/spedizioni-e-dintorni/shipment/corrieri/susa#lista-codici-gsped) | | [SVL](/spedizioni-e-dintorni/shipment/corrieri/svl#lista-codici-gsped) | | [SwissPost](/spedizioni-e-dintorni/shipment/corrieri/swisspost#lista-codici-gsped) | | [Tiesse Zust](/spedizioni-e-dintorni/shipment/corrieri/tiesse-zust#lista-codici-gsped) | | [Tipsa](/spedizioni-e-dintorni/shipment/corrieri/tipsa#lista-codici-gsped) | | [TNT](/spedizioni-e-dintorni/shipment/corrieri/tnt#lista-codici-gsped) | | [TopFly](/spedizioni-e-dintorni/shipment/corrieri/topfly) | | [TWS](/spedizioni-e-dintorni/shipment/corrieri/tws) | | [UBV](/spedizioni-e-dintorni/shipment/corrieri/ubv) | | [UPS](/spedizioni-e-dintorni/shipment/corrieri/ups#lista-codici-gsped) | | [UPS Healthcare](/spedizioni-e-dintorni/shipment/corrieri/ups-healthcare) | | [USPS Return](/spedizioni-e-dintorni/shipment/corrieri/usps-return#lista-codici-gsped) | | [Veepee](/spedizioni-e-dintorni/shipment/corrieri/veepee#lista-codici-gsped) | # Codici Gsped Lista dei codici ed ID Gsped ## Tipologia incassi contrassegno
Codice IncassoDescrizione
10Assegno circolare intestato al mittente originale
11Accettare assegno bancario intestato al mittente originale
12Solo contanti
15Accettare assegno datato intestato al mittente originale
## Codici status spedizione
Codice StatusDescrizione StatusNote
-1.0RICHIESTOviene assegnato alle spedizioni GLS ante conferma, gestito tramite API (no interfaccia)
0.0CREATOviene assegnato alle spedizioni bollettate correttamente, è visibile dopo la conferma delle spedizioni
0.2PARTENZA DIFFERITAstatus ad hoc per clienti con esigenze specifiche, gestito tramite API (no interfaccia)
0.3DA AUTORIZZAREstatus ad hoc per clienti con esigenze specifiche, gestito tramite API (no interfaccia)
0.5IN ELABORAZIONEusato ormai raramente, viene assegnato alle spedizioni in coda di bollettazione, gestito tramite API (no interfaccia)
0.6ELABORATO CON ERRORIassegnato alle spedizioni per cui fallisce la bollettazione, gestito tramite API (no interfaccia)
0.7ERRORE COMUNICAZIONE CON TNT
1.0INVIATOassegnato alle richieste di ritiro trasmesse correttamente al corriere (si applica ai corrieri come BRT per cui passiamo un file)
2.0RICEVUTOassegnato alle richieste di ritiro per cui il corriere ha confermato il ricevimento della richiesta stessa
3.0TRASMESSO A FILIALE DI COMPETENZAassegnato alle richieste di ritiro
4.0CONFERMATOassegnato alle richieste di ritiro
5.0IN RITIROassegnato alle richieste di ritiro
6.0RITIRATOassegnato alle richieste di ritiro
7.0NON ANCORA RITIRATO: MANCANZA DI TEMPOassegnato alle richieste di ritiro
8.0NON ANCORA RITIRATO: MERCE NON PRONTAassegnato alle richieste di ritiro
9.0NON ANCORA RITIRATO: CLIENTE ASSENTE/CHIUSOassegnato alle richieste di ritiro
10.0ANNULLATO: ANNULLAMENTO PRIMA DELL'AFFIDAMENTOassegnato alle richieste di ritiro
11.0ANNULLATO: RIFIUTATO DAL CLIENTEassegnato alle richieste di ritiro
12.0ANNULLATO: GIA' RITIRATOassegnato alle richieste di ritiro
12.1ANNULLATO: NULLA DA RITIRAREassegnato alle richieste di ritiro
13.0ANNULLATO: MERCE NON IN PRODOTTOassegnato alle richieste di ritiro
14.0ANNULLATO: CLIENTE INESISTENTE ALL'INDIRIZZOassegnato alle richieste di ritiro
15.0ANNULLATO: TELEFONO ERRATO E/O NON RISPONDEassegnato alle richieste di ritiro
16.0ANNULLATO: GIA' EFFETTUATI DUE TENTATIVIassegnato alle richieste di ritiro
16.5NON RITIRATOassegnato alle richieste di ritiro
17.0SPEDIZIONE PARTITAil corriere ha confermato la partenza della spedizione
17.4ARRIVATA IN FILIALEspedizione arrivata alla filiale di destino
17.5IN TRANSITOla merce è in transito
17.6IN DEPOSITO CAUSA FORZA MAGGIOREla merce è ferma in deposito per un evento di nataura straodinaria
17.7FERMO DEPOSITOè un servizio accessorio che permette al destinatario di ritirare le spedizioni direttamente presso gli uffici del corriere
17.8IN DEPOSITO CAUSA NON DIPENDENTE DA CORRIEREla merce si trova negli uffici del corriere per cause come ad esempio sciopero, nevicata o altro
18.0IN CONSEGNAla merce è stata presa in carico dal corriere per la consegna
18.1CHIUSO PER TURNOdestinatario non disponibile per la consegna
18.4ARRIVATA PUNTO DI RITIROper il momento è usata solo con BRT indica che la spedizione è arrivata al fermopoint
18.5CONSEGNA PARZIALEconsegnata solo una parte dei colli della spedizione
19.0CONSEGNATOla merce è stata consegnata
19.1RICONSEGNATO AL MITTENTEquando possibile registriamo cosi la consegna all'indirizzo del mittente di spedizioni rese al mittente
20.0DIROTTATOarrivato alla filiale di destino sbagliata, reinoltrato alla filiale giusta
20.5ASSENTEil destinatario assente
21.0RESO AL MITTENTEscatta quando la spedizione parte dalla filiale di destino per tornare al mittente
22.0SPEDIZIONE RIPRISTINATA DOPO ERRATA IMPUTAZIONE DI CONSEGNA
23.0RAPINATO INCASSO
24.0CHIUSURA SPEDIZIONE CON PRATICA ANOMALIA
25.0CHIUSURA SPEDIZIONE CON AVARIA RESA AL MITTENTE
26.0MERCE MAI AFFIDATA
27.0APERTURA PRATICA ANOMALIA
28.0RAPINATA MERCE
29.0MERCE DISTRUTTA
30.0GIACENZA APERTAla merce è in giacenza in attesa di essere svincolata
31.0GIACENZA CHIUSAscatta quando il corriere conferma lo svincolo della giacenza, per i corrieri per cui non abbiamo l'informazione scatta quando la spedizione si rimette in movimento
32.0SPEDIZIONE RIFIUTATAla merce è stata rifiutata dal destinatario
35.0ANNULLATO SENZA ADDEBITO
40.0INOLTRATA ALL'ESTERO
41.0SPEDIZIONE IN DOGANA
50.0VIAGGIO DIRETTO
500.0NON ANCORA RITIRATO
999.0ANNULLATO
# Throttling Limiti di chiamate consecutive Per mantenere alto il livello di servizio GSPED applica delle regole di throttling per le chiamate alle API. Nella tabella seguente sono riportati i limiti da non superare. {% hint style="info" %} **I limiti si riferiscono a intervalli di 5 minuti** {% endhint %} | Tipo chiamata | Limite Chiamate | | --------------------------------------- | :-------------: | | Tutte le chiamate POST complessivamente | 450 | | Shipment POST | 300 | | Shipment Confirm POST | 300 | | Chiamate DELETE | 600 | | Chiamate GET | 1200 | Superando questi limiti si otterranno dei 403 - FORBIDDEN Per le chiamate all'endpoint del tracking si suggerisce di non chiamare piû di una volta all'ora per la singola spedizione considendo che in media i sistemi di Gsped interrogano i sistemi dei corrieri ogni 60 minuti. Sempre a proposito del tracking è possibile richiedere l'attivazione di webhook verso i propri sistemi evitando di fare dei polling verso Gsped. # Shipment Gestione delle spedizioni ## Shipment - GET Questo endpoint permette di gestire la creazione, recupero e la cancellazione delle spedizioni su Gsped. ## Shipment -GET `GET` `https://api.gsped.it/[ISTANZA]/Shipment` Recupera tutte le informazioni di una spedizione compre le etichette #### Query Parameters | Name | Type | Description | | ------------------------------------ | ------ | --------------------------------- | | id\* | String | ID univoco Gsped della spedizione | #### Headers | Name | Type | Description | | ------------------------------------------- | ------ | ----------------------- | | x-api-key\* | String | Apikey fornita da GSPED | {% tabs %} {% tab title="200: OK Informazioni spedizione" %} ```javascript { // Response } ``` {% endtab %} {% tab title="400: Bad Request Errore input" %} ```javascript { // Response } ``` {% endtab %} {% tab title="403: Forbidden Apikey invalida" %} ```javascript { // Response } ``` {% endtab %} {% tab title="404: Not Found Spedizione non trovata" %} ```javascript { // Response } ``` {% endtab %} {% endtabs %} ### Snippets codice di esempio {% tabs %} {% tab title="PHP" %} ```php "https://api.gsped.it/sandbox/Shipment?id=70059765", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "GET", CURLOPT_POSTFIELDS => "", CURLOPT_HTTPHEADER => [ "x-api-key: YOUR-API-KEY" ], ]); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; } ``` {% endtab %} {% tab title="PYTHON" %} ```python import http.client conn = http.client.HTTPSConnection("api.gsped.it") payload = "" headers = { 'x-api-key': "YOUR-API-KEY" } conn.request("GET", "/sandbox/Shipment?id=70059765", payload, headers) res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` {% endtab %} {% tab title="GO" %} ```go package main import ( "fmt" "net/http" "io/ioutil" ) func main() { url := "https://api.gsped.it/sandbox/Shipment?id=70059765" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("x-api-key", "YOUR-API-KEY") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := ioutil.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` {% endtab %} {% tab title="C#" %} ```csharp // Some codevar client = new HttpClient(); var request = new HttpRequestMessage { Method = HttpMethod.Get, RequestUri = new Uri("https://api.gsped.it/sandbox/Shipment?id=70059765"), Headers = { { "x-api-key", "YOUR-API-KEY" }, }, }; using (var response = await client.SendAsync(request)) { response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body); } ``` {% endtab %} {% tab title="cURL" %} ```shell curl --request GET \ --url 'https://api.gsped.it/sandbox/Shipment?id=70059765' \ --header 'x-api-key: YOUR-API-KEY' ``` {% endtab %} {% endtabs %} ## Shipment - POST La chiamata Shipment Post permette di creare la spedizione. Se l’operazione ha esito positivo, restituisce i dati della spedizione insieme alle relative etichette nei formati disponibili. {% hint style="info" %} La creazione di una spedizione non necessariamente va sempre a buon fine, sia Gsped che i sistemi del corriere eseguono una serie di controlli sulla correttezza dei dati ricevuti, bisogna assicurarsi di gestire correttamente i possibili errori! {% endhint %} {% hint style="warning" %} **NOTA BENE**\ Ogni corriere dispone di limiti sulla lunghezza dei singoli campi.\ Verificare nella pagina del singolo corriere la lunghezza consentita (se disponibile), viceversa i nostri tecnici sapranno rispondere alle lunghezze sui corrieri di vostro utilizzo. {% endhint %} La​ ​logica​ ​da​ ​implementare​ ​per controllare l'esito delle ​chiamate​ ​è​ ​la​ ​seguente:​ ​ sulla​ ​risposta​ ​delle API​ ​sulla​ ​POST​ ​di​ ​creazione​ ​spedizione​ ​va​ ​innanzitutto controllato​ ​il​ ​codice​ ​di​ ​risposta​ ​HTTP,​ ​se​ ​è​ ​400​ ​i dati​ ​passati​ ​non​ ​hanno​ ​passato​ ​la​ ​prima​ ​serie​ ​di​ ​controlli​ ​sui​ ​dati,​ ​in​ ​quel​ ​caso​ ​il​ ​campo​ ​error contiene​ ​indicazioni​ ​sul​ ​problema​ ​riscontrato​ ​(ad​ ​esempio​ ​campi​ ​obbligatori​ ​mancanti). Se​ ​il codice di risposta ​è​ ​200​ ​i​ ​dati​ ​hanno​ ​passato​ ​il primo livello di validazione ​ed​ ​è​ ​stata​ ​avviata​ ​la generazione​ ​della​ ​lettera​ ​di​ ​vettura.​ ​Andrà quindi verificato il valore del campo​ ​status,​ ​se contiene​ ​0​ ​la​ ​lettera​ ​di​ ​vettura​ ​è​ ​stata​ ​generata​ ​correttamente​ ​e​ ​potrà​ ​essere​ ​recuperata​ ​dai campi​ ​preposti​ ​nella​ ​risposta.​ ​**Se​ ​invece​ ​il campo status​ ​è​ ​uguale​ ​a​ ​0.6​ ​la​ ​generazione​ ​della​ ​lettera​ ​di vettura​ ​è​ ​fallita​ ​e​ ​il​ ​campo​ ​error​ ​conterrà​ ​la​ ​descrizione​ ​dell’errore.**​ ​Questo​ ​tipo​ ​di​ ​errori​ ​si può​ ​verificare​ ​per​ ​situazioni​ ​tipo​ ​cap​ ​e​ ​località​ ​non​ ​coerenti,​ ​indirizzo​ ​non​ ​accettato​ ​dai sistemi​ ​del​ ​corriere,​ ​servizio​ ​richiesto​ ​non​ ​disponibile​ ​per​ ​la​ ​località​ ​di​ ​destinazione​ ​*et cetera*. {% hint style="info" %} I seguenti campi proposti nell'esempio fanno parte di un set che si può considerare "base" e comune un po' a tutti i corrieri per creare spedizioni.\ In caso si vogliano espandere le funzionalità o si debbano richiedere funzionalità disponibili presso uno specifico corriere va consultata la sezione degli [Shipment objects](/spedizioni-e-dintorni/shipment/shipment-objects), dei [casi d'uso](/spedizioni-e-dintorni/shipment/casi-duso) o dei [corrieri](/spedizioni-e-dintorni/shipment/corrieri). {% endhint %} ## Shipment POST `POST` `https://api.gsped.it/[ISTANZA]/Shipment` Creazione di una spedizione #### Headers | Name | Type | Description | | ------------------------------------------- | ------ | -------------------------- | | x-api-key\* | String | Apikey rilasciata da Gsped | #### Request Body | Name | Type | Description | | ----------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | corriere\* | Int | ID corriere Gsped ( [Corrieri e servizi](/overview/corrieri-e-servizi) ) | | colli\* | Int | Numero colli della spedizione | | volume\* | Float | Volume spedizione in Metri Cubi | | peso\* | Float | Peso spedizione espresso in KG | | origine\* | String | Nazione origine della merce sigla iso 2 char | | merce\* | String | Descrizione generica della merce spedita | | ddt\_num | String | Riferimento numerico della spedizione, se non definito Gsped ne crea uno automaticamente | | ddt\_alpha | String | Riferimento alfanumerico della spedizione, se non definito Gsped ne crea uno automaticamente | | client\_id\* | Int | ID cliente fornito da Gsped | | servizio\* | Int | ID servizio Gsped ( [Corrieri e servizi](/overview/corrieri-e-servizi) ) | | sender\_cap | String | Zipcode del mittente | | sender\_city | String | Località mittente | | sender\_addr | String | Indirizzo mittente | | sender\_contact | String | Nome contatto mittente | | sender\_name | String | Nome mittente | | rcpt\_contact\* | String | Nome contatto destinatario | | rcpt\_name\* | String | Nome destinatario | | sender\_email | String | Email mittente | | sender\_phone | String | Telefono mittente | | sender\_country\_code | String | Nazione mittente sigla iso 2 char | | rcpt\_prov\* | String | Provincia/Stato desinatario sigla iso 2 char | | rcpt\_cap\* | String | Zipcode destinatario | | rcpt\_city\* | String | Località destinatario | | rcpt\_addr\* | String | Indirizzo destinatario | | sender\_prov | String | Provincia/Stato mittente siga iso 2 char | | rcpt\_phone\* | String | Telefono destinatario | | rcpt\_email\* | String | Email destinatario | | rcpt\_emails\_extra | Array | Email aggiuntive per altri destinatari | | rcpt\_country\_code\* | String | Nazione destinatario sigla iso 2 char | | note\_sender | String | Note del mittente | | valuta | | Sigla valuta iso 4217 | | valore | Float | Valore importo assicurazione | | dropshipping | String | Flag 1 per inviare lettera di vettura alla mail del mittente | | al\_sabato | String | Flag S\|N per attivare servizio al sabato (solo per corrieri abilitati) | | al\_piano | String | Flag S\|N per attivare servizio al piano (solo per corrieri abilitati) | | preavviso\_telefonico | String | Flag S\|N per attivare servizio (solo per corrieri abilitati) | | fermo\_deposito | String | Flag S\|N per identificare una spedizione in fermo deposito | | reso\_contestuale | String | Flag S\|N per attivare servizio EXCHANGE (solo per corrieri abilitati) | | documenti | String | Flag 0\|1 per identificare una spedizione di documenti | | flag\_reso | Int | Flag 0\|1 per identificare una spedizione di reso | | addebito\_dogana | Int |

Assegnazione oneri doganali.
Valori ammessi :
- 0 : Oneri doganali al destinatario
- 1 : Oneri doganali al mittente
- 2 : Oneri doganalia terzo

| | chi\_paga | Int |

Assegnazione costi spedizione :
- 0 : Paga il mittente
- 1 : Paga il destinatario

| | valore\_doganale | Float | Indicazione del valore doganale | | id\_order\_gelproximity | String | ID ordine sui sistemi di Gel Proximity per invio tracking | | invoice\_date | String | Data formato YYYY-MM-GG della data della fattura | | invoice\_number | String | Numero della fattura | | invoiced\_client\_id | Int |

DA VALORIZZARE SOLO PER LE ISTANZE RESELLER
Da utilizzare per indicare a quale cliente del reseller abbinare la spedizione.

| | labelType | Enum |

Campo opzionale per definire il tipo di etichetta richiesto.

Valori possibili: PDF/ZPL

Attenzione: alcuni corrieri potrebbero avere limitazioni sul formato

| {% tabs %} {% tab title="200: OK Spedizione creata" %} ```javascript { "client_id": 390, "cod_destinatario": "", "colli": 1, "contrassegno": 0, "corriere": 104, "date_req_cons": "0000-00-00 00:00:00", "ddt_alpha": "TEST_GSPED", "ddt_num": 12346, "merce": "", "note_sender": "", "origine": "IT", "peso": 1.8, "preavviso_telefonico": "", "rcpt_addr": "115 E Endfield Rd", "rcpt_cap": 19053, "rcpt_city": "Feasterville Trevose", "rcpt_contact": "Tester", "rcpt_country_code": "US", "rcpt_email": "test@test.edu", "rcpt_emails_extra": ["mail1@example.com", "mail2@example.com"], "rcpt_name": "TEST MITTENTE", "rcpt_phone": "123456789", "rcpt_prov": "PA", "servizio": 9, "tipo_incasso": 0, "valore": 0, "valore_doganale": 37.5, "volume": 0.029, "status": 0, "fid_partenza": "", "num_serie": 0, "num_spedizione": "1253863656", "date_upd": "0000-00-00 00:00:00", "error": "", "sender_name": "test mittente", "sender_addr": "p.za Ambrosoli 13", "sender_cap": 15121, "sender_city": "Alessandria", "sender_contact": "Rossi Pino", "sender_prov": "AL", "sender_country_code": "IT", "sender_email": "test@test.it", "label_jpg": [ "base64 encoded label string" ], "label_pdf": [ "base64 encoded label string" ], "label_zpl": [ "ZPL label string" ], "id": 50003621, "tnt_options": [], "tracking_link": "", "valuta": "EUR", "dropshipping": 0, "sender_phone": 12345562, "al_piano": "", "al_sabato": "", "reso_contestuale": "", "fermo_deposito": 0, "note": "", "centro_costo": "", "sda_servizio": "", "user_id": 0, "opening_time": "00:00:00", "closing_time": "00:00:00", "date_req_ritiro": "0000-00-00 00:00:00", "ups_uap_id": "", "sda_id_fermoposta": "", "note_2": "", "confermato": 0, "ups_signature_required": 0, "id_pickup": null, "documenti": 0, "sda_accessori": 0, "packaging": "", "dropoff_type": "", "vat_seller": "", "vat_buyer": "", "generic_service_point": "", "tipo_transazione": "supSoglia", "rcpt_language": "", "sender_eori": "", "rcpt_eori": "", "link_pickup_booking": "" } ``` {% endtab %} {% tab title="400: Bad Request Input errato" %} ```javascript { "error": "client_id: deve essere lungo al massimo 7 caratteri" } ``` {% endtab %} {% tab title="403: Forbidden Apikey invalida" %} ```javascript { "status": false, "error": "Invalid API key " } ``` {% endtab %} {% endtabs %} ### Snippets codice di esempio {% tabs %} {% tab title="PHP" %} ```php "https://api.gsped.it/sandbox/shipment", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_POSTFIELDS => "{\n \"client_id\": 390,\n \"colli\": 2,\n \"corriere\": 104,\n \"ddt_alpha\": \"TEST_GSPED\",\n \"ddt_num\": 12346,\n \"origine\": \"IT\",\n\t\"dropshipping\" : 0,\n \"peso\": 2.4,\n \"rcpt_addr\": \"115 E Endfield Rd\",\n \"rcpt_cap\": \"19053\",\n \"rcpt_city\": \"Feasterville Trevose\",\n \"rcpt_contact\": \"Tester\",\n \"rcpt_country_code\": \"US\",\n \"rcpt_email\": \"test@test.it\",\n \"rcpt_name\": \"TEST DESTINATARIO\",\n \"rcpt_phone\": \"2159005458\",\n \"rcpt_prov\": \"PA\",\n \"servizio\": 9,\n \"valore\": 0,\n \"valore_doganale\": 37.50,\n \"valuta\": \"EUR\",\n \"volume\": 0.0972,\n \"invoiced_client_id\": 1001}", CURLOPT_HTTPHEADER => [ "x-api-key: YOUR-API-KEY" ], ]); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; } ``` {% endtab %} {% tab title="PYTHON" %} ```python import http.client conn = http.client.HTTPSConnection("api.gsped.it") payload = json.dumps({ "client_id": 390, "colli": 2, "corriere": 104, "ddt_alpha": "TEST_GSPED", "ddt_num": 12346, "origine": "IT", "dropshipping": 0, "peso": 2.4, "rcpt_addr": "115 E Endfield Rd", "rcpt_cap": "19053", "rcpt_city": "Feasterville Trevose", "rcpt_contact": "Tester", "rcpt_country_code": "US", "rcpt_email": "test@test.it", "rcpt_name": "TEST DESTINATARIO", "rcpt_phone": "2159005458", "rcpt_prov": "PA", "servizio": 9, "valore": 0, "valore_doganale": 37.50, "valuta": "EUR", "volume": 0.0972, "invoiced_client_id": 1001 }) headers = { 'x-api-key': "YOUR-API-KEY" } conn.request("POST", "/sandbox/shipment", payload, headers) res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` {% endtab %} {% tab title="GO" %} ```go package main import ( "fmt" "strings" "net/http" "io/ioutil" ) func main() { url := "https://api.gsped.it/sandbox/shipment" payload := strings.NewReader("{\n \"client_id\": 390,\n \"colli\": 2,\n \"corriere\": 104,\n \"ddt_alpha\": \"TEST_GSPED\",\n \"ddt_num\": 12346,\n \"origine\": \"IT\",\n\t\"dropshipping\" : 0,\n \"peso\": 2.4,\n \"rcpt_addr\": \"115 E Endfield Rd\",\n \"rcpt_cap\": \"19053\",\n \"rcpt_city\": \"Feasterville Trevose\",\n \"rcpt_contact\": \"Tester\",\n \"rcpt_country_code\": \"US\",\n \"rcpt_email\": \"test@test.it\",\n \"rcpt_name\": \"TEST DESTINATARIO\",\n \"rcpt_phone\": \"2159005458\",\n \"rcpt_prov\": \"PA\",\n \"servizio\": 9,\n \"valore\": 0,\n \"valore_doganale\": 37.50,\n \"valuta\": \"EUR\",\n \"volume\": 0.0972,\n \"invoiced_client_id\": 1001}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("x-api-key", "YOUR-API-KEY") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := ioutil.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` {% endtab %} {% tab title="C#" %} ```csharp var client = new HttpClient(); var request = new HttpRequestMessage { Method = HttpMethod.Post, RequestUri = new Uri("https://api.gsped.it/sandbox/shipment"), Headers = { { "x-api-key", "YOUR-API-KEY" }, }, Content = new StringContent("{\n \"client_id\": 390,\n \"colli\": 2,\n \"corriere\": 104,\n \"ddt_alpha\": \"TEST_GSPED\",\n \"ddt_num\": 12346,\n \"origine\": \"IT\",\n\t\"dropshipping\" : 0,\n \"peso\": 2.4,\n \"rcpt_addr\": \"115 E Endfield Rd\",\n \"rcpt_cap\": \"19053\",\n \"rcpt_city\": \"Feasterville Trevose\",\n \"rcpt_contact\": \"Tester\",\n \"rcpt_country_code\": \"US\",\n \"rcpt_email\": \"test@test.it\",\n \"rcpt_name\": \"TEST DESTINATARIO\",\n \"rcpt_phone\": \"2159005458\",\n \"rcpt_prov\": \"PA\",\n \"servizio\": 9,\n \"valore\": 0,\n \"valore_doganale\": 37.50,\n \"valuta\": \"EUR\",\n \"volume\": 0.0972,\n \"invoiced_client_id\": 1001}") { Headers = { ContentType = new MediaTypeHeaderValue("application/json") } } }; using (var response = await client.SendAsync(request)) { response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body); } ``` {% endtab %} {% tab title="cURL" %} ```shell curl --request POST \ --url https://api.gsped.it/sandbox/shipment \ --header 'x-api-key: YOUR-API-KEY' \ --data '{ "client_id": 390, "colli": 2, "corriere": 104, "ddt_alpha": "TEST_GSPED", "ddt_num": 12346, "origine": "IT", "dropshipping" : 0, "peso": 2.4, "rcpt_addr": "115 E Endfield Rd", "rcpt_cap": "19053", "rcpt_city": "Feasterville Trevose", "rcpt_contact": "Tester", "rcpt_country_code": "US", "rcpt_email": "test@test.it", "rcpt_name": "TEST DESTINATARIO", "rcpt_phone": "2159005458", "rcpt_prov": "PA", "servizio": 9, "valore": 0, "valore_doganale": 37.50, "valuta": "EUR", "volume": 0.0972, "invoiced_client_id": 1001 }' ``` {% endtab %} {% endtabs %} ### Scelta del corriere più economico Nel caso si desideri che Gsped esegua la scelta del corriere più economico in base ai propri listini (configurati su Gsped) bisogna impostare nella chiamata **corriere = 0** e **servizio = 0** **Esempio payload :** ``` { "client_id": 391, "corriere": 0, "servizio": 0, "ddt_num": 123, "ddt_alpha": "Test123", "colli": 1, "rcpt_name": "Test destinatario", "rcpt_addr": "INDUSTRIESTRASSE 7", "rcpt_cap": "4313", "rcpt_city": "MOEHLIN", "rcpt_country_code": "CH", "rcpt_email": "test@gsped.com", "sender_name": "Test mittente", "sender_addr": "Via Marzorati 14", "sender_cap": "20014", "sender_city": "Nerviano", "sender_country_code": "IT", "peso": 1, "volume": 0 } ``` ## Shipment - DELETE Questo endpoint consente di cancellare spedizioni create in precedenza **solo se non sono ancora state confermate.** {% hint style="info" %} Quando si cancella una spedizione le etichette restituite dalla POST NON sono più valide e devono essere eliminate! {% endhint %} ## Shipment DELETE `DELETE` `https://api.gsped.it/[ISTANZA]/Shipment` Cancellazione di una spedizione sui sistemi Gsped e del corriere #### Query Parameters | Name | Type | Description | | ------------------------------------ | ------ | --------------------------------- | | id\* | String | ID univoco Gsped della spedizione | #### Headers | Name | Type | Description | | ------------------------------------------- | ------ | ----------------------- | | x-api-key\* | String | Apikey fornita da Gsped | {% tabs %} {% tab title="200: OK Cancellazione avvenuta" %} ```javascript { "error": "" } ``` {% endtab %} {% tab title="404: Not Found Spedizione non trovata" %} ```javascript { "error": "Spedizione non trovata" } ``` {% endtab %} {% tab title="403: Forbidden Apikey invalida" %} ```javascript { "status": false, "error": "Invalid API key " } ``` {% endtab %} {% tab title="400: Bad Request Errore input" %} ```javascript { "error": "ID spedizione non indicata" } ``` {% endtab %} {% endtabs %} ### Snippets codice di esempio {% tabs %} {% tab title="PHP" %} ```php "http://api.gsped.it/sandbox/Shipment?id=53", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "DELETE", CURLOPT_POSTFIELDS => "", CURLOPT_HTTPHEADER => [ "x-api-key: YOUR-API-KEY" ], ]); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; } ``` {% endtab %} {% tab title="PYTHON" %} ```python import http.client conn = http.client.HTTPConnection("api.gsped.it") payload = "" headers = { 'x-api-key': "YOUR-API-KEY" } conn.request("DELETE", "/sandbox/Shipment?id=53", payload, headers) res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` {% endtab %} {% tab title="GO" %} ```go package main import ( "fmt" "net/http" "io/ioutil" ) func main() { url := "http://api.gsped.it/sandbox/Shipment?id=53" req, _ := http.NewRequest("DELETE", url, nil) req.Header.Add("x-api-key", "YOUR-API-KEY") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := ioutil.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` {% endtab %} {% tab title="C#" %} ```csharp // Some codevar clientHandler = new HttpClientHandler { UseCookies = false, }; var client = new HttpClient(clientHandler); var request = new HttpRequestMessage { Method = HttpMethod.Delete, RequestUri = new Uri("http://api.gsped.it/sandbox/Shipment?id=53"), Headers = { { "x-api-key", "YOUR-API-KEY" }, }, }; using (var response = await client.SendAsync(request)) { response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body); } ``` {% endtab %} {% tab title="cURL" %} ```shell curl --request DELETE \ --url 'http://api.gsped.it/sandbox/Shipment?id=53' \ --header 'x-api-key: YOUR-API-KEY' ``` {% endtab %} {% endtabs %} ## Shipment - PATCH Questo endpoint permette di modificare una spedizione senza bisogno di ricreare l'etichetta **SOLO se la spedizione non è ancora stata confermata.** {% hint style="info" %} N.B. Questo endpoint è valido SOLO per alcuni campi e SOLO per alcuni corrieri. Fare riferimento alla pagina del corriere specifico per vedere i campi modificabili. {% endhint %} `PATCH` `https://api.gsped.it/[ISTANZA]/Shipment/[idSpedizione]` Recupera tutte le informazioni di una spedizione compre le etichette #### Headers | Name | Type | Description | | ------------------------------------------- | ------ | ----------------------- | | x-api-key\* | String | Apikey fornita da GSPED | {% tabs %} {% tab title="200: OK Informazioni spedizione" %} ```javascript { "result": "Spedizione aggiornata con successo", "status": 200 } ``` {% endtab %} {% tab title="500: Internal Server Error" %} ```json { "result": , "status": 500 } ``` {% endtab %} {% tab title="400: Bad Request Errore input" %} ```javascript { "result": , "status": 400 } ``` {% endtab %} {% tab title="403: Forbidden Apikey invalida" %} ```javascript { "status": false, "error": "Invalid API key " } ``` {% endtab %} {% tab title="404: Not Found Spedizione non trovata" %} ```javascript { "result": "Spedizione non trovata", "status": 500 } ``` {% endtab %} {% endtabs %} #### Request Body Dipende dal corriere: [VEDI QUI](/spedizioni-e-dintorni/shipment/corrieri) ### Snippets codice di esempio {% tabs %} {% tab title="PHP" %} ```php "https://api.gsped.it/sandbox/Shipment/70059765", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "PATCH", CURLOPT_POSTFIELDS => "{\"campo\": \"nuovo valore\"}", CURLOPT_HTTPHEADER => [ "x-api-key: YOUR-API-KEY" ], ]); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; } ``` {% endtab %} {% tab title="PYTHON" %} ```python import http.client conn = http.client.HTTPSConnection("api.gsped.it") payload = json.dumps({ "campo" => "nuovo valore" }) headers = { 'x-api-key': "YOUR-API-KEY" } conn.request("PATCH", "/sandbox/shipment/70059765", payload, headers) res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` {% endtab %} {% tab title="GO" %} ```go package main import ( "fmt" "strings" "net/http" "io/ioutil" ) func main() { url := "https://api.gsped.it/sandbox/shipment/70059765" payload := strings.NewReader("{ \"campo\": \"nuovo valore\" }") req, _ := http.NewRequest("PATCH", url, payload) req.Header.Add("x-api-key", "YOUR-API-KEY") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := ioutil.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` {% endtab %} {% tab title="C#" %} ```csharp var client = new HttpClient(); var request = new HttpRequestMessage { Method = HttpMethod.Patch, RequestUri = new Uri("https://api.gsped.it/sandbox/shipment/70059765"), Headers = { { "x-api-key", "YOUR-API-KEY" }, }, Content = new StringContent("{ \"campo\": \"nuovo valore\" }") { Headers = { ContentType = new MediaTypeHeaderValue("application/json") } } }; using (var response = await client.SendAsync(request)) { response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body); } ``` {% endtab %} {% tab title="cURL" %} ``` curl --request PATCH \ --url https://api.gsped.it/sandbox/shipment/70059765 \ --header 'x-api-key: YOUR-API-KEY' \ --data '{"campo": "nuovo valore"}' ``` {% endtab %} {% endtabs %} # Shipment objects # carrierData {% hint style="warning" %} Questo oggetto è possibile solamente riceverlo in risposta e non valorizzarlo {% endhint %} Oggetto contenente informazioni supplementari ottenute dal corriere ed esposte via API. L'uso tipico è di un corriere "aggregatore" di altri corrieri in cui è contenuto il corriere che si occupa fisicamente della spedizione o un tracking aggiuntivo per le spedizioni internazionali. ``` "carrierData": { "carrierAlias": "XXX", "shipmentNumber": "XXXXXXXXXXXXXXX" } ```
CampoTypeDescrizione
carrierAliasstringCorriere che si occupa fisicamente della spedizione (dipende da corriere a corriere)
shipmentNumberstringNumero di spedizione "supplementare" del corriere (dipende da corriere a corriere)
# courierSpecificData Oggetto con chiave l'alias del corriere che può contenere dati specifici del corriere non nativamente gestiti da gsped ```json : { "campo_1":"valore_1", "campo_2":"valore_2" } ``` I campi passabili dipendono dallo specifico corriere # courierData object Oggetto contenente informazioni aggiuntive per alcuni corrieri ```json "courierData":{ "clientCode":"588326", "data_previsto_affidamento":"2024-12-31", "additional_charges":{} } ``` Di seguito il dettaglio dei campi
CampoRequiredTypeDescrizione
clientCodefalsestringCodice cliente / contratto presso il corriere da utilizzare come forzatura per la spedizione in oggetto.
Valido per i corrieri:
- Colissimo
data_previsto_affidamentofalsestringData nel futuro per indicare al corriere di quando verrà affidata la merce (utile, spesso, per l'indicare data futura in etichetta).
Valido per i corrieri:
- TNT (vedi note in sezione dedicata)
additional_chargesfalseobjectVedi sezione dedicata
# additional\_charges Oggetto contenente i costi aggiuntivi che si possono indicare per alcuni corrieri che li gestiscono in fattura. **Gestito SOLO da DHL.** Viene valorizzato dentro la sezione [courierData](/spedizioni-e-dintorni/shipment/shipment-objects/courierdata). ```json "courierData":{ "additional_charges":{ "other":10 } } ```
CampoRequiredTypeDescrizione
otherfalseint / floatCosti segnati come "altro"
# uploadDocAfterwards Per poter caricare documenti postumi, ovvero dopo aver generato la spedizione, all'atto della creazione della spedizione con la **Shipment POST** bisogna indicarlo esplicitamente, dato che il corriere **ha bisogno di sapere che per una specifica spedizione verranno caricati dei documenti in un secondo momento.** ```json "courierData": { "uploadDocAfterwards": true }, ``` Una volta generata la spedizione utilizzando questa opzione, sarà possibile aggiungere il documento alla spedizione attraverso la Shipment PATCH utilizzando il seguente payload : ```json { "trade_documents": [ { "nome": "COMMERCIAL_INVOICE_5123025_1.pdf", "contenuto": "Tm90aWNlDQpJbi......" } ] } ``` ### Corrieri supportati: * Fedex * DHL # dettagli\_ordine array Array contenente vari oggetti di dettaglio del contenuto della spedizione. ```json "dettagli_ordine": [ { "sku": "PBK1", "description": "Cosa blu", "qty": "1", "um":"PCS", "barcode_riga": "12345464", "hs_code": "123456454", "prezzo_singolo": "12.50", "peso_riga": "1", "country_of_origin":"IT" }, { "sku": "PBK12", "description": "Cosa blu e rossa", "qty": "1", "um":"BOX", "barcode_riga": "12345465", "hs_code": "123456454", "prezzo_singolo": "25.00", "peso_riga": "1", "country_of_origin":"FR" } ] ``` Di seguito il dettaglio di un singolo oggetto
CampoRequiredCodificaDescrizione
skutruestringSKU singolo item
descriptiontruestringDescrizione singolo item
qtytrueintQuantità singolo item
umtrueenum

Unità di misura della riga d'ordine:

  • BOX (scatole)
  • KG (chilogrammi)
  • L (litri)
  • M (metri)
  • NO (numero)
  • PCS (pezzi)
  • CM (centimetri)
barcode_rigafalsestringStringa barcode singolo item
hs_codefalsestringCodice HS o TARIC singolo item
Potrebbe essere obbligatorio lato corriere si prega di verificare la scheda dedicata
prezzo_singolotruePrezzo singolo item
peso_rigatruePeso riga (kg)
country_of_origintruestringNazione di produzione del prodotto, ISO 2 CHAR
{% hint style="warning" %} Alcuni corrieri richiedono obbligatoriamente i dati valorizzati (CIN) per le spedizioni extraUE {% endhint %} # dati\_colli array Array contenente vari oggetti di dettaglio dei vari colli. I vari colli possono avere dimensioni differenti. ```json "daticolli": [ { "altezza": 39, "larghezza": 29, "lunghezza": 43, "volume": 0.048633, "peso": 1.2, "codice_collo": "9999999999" }, { "altezza": 45, "larghezza": 33, "lunghezza": 55, "volume": 0.081675, "peso": 3.2, "codice_collo": "8888888888" } ] ``` Di seguito il dettaglio di un singolo oggetto.
CampoRequiredCodificaDescrizione
altezzafalseintAltezza singolo collo in CM
larghezzafalseintLarghezza singolo collo in CM
lunghezzafalseintLunghezza singolo collo in CM
pesofalsefloatPeso singolo collo in KG
volumefalsefloatVolume singolo collo in Metri Cubi
codice_collofalsestringCodice del cliente da assegnare al collo
l'utilizzo di questo è personalizzato e non viene inviato di default a nessun corriere
# dettagli\_scarico Array di un oggetto contenente gli orari di apertura del destinatario ```json "dettagli_scarico": [{ "mattino_dalle": "8:00", "mattino_alle": "11:00", "pomeriggio_dalle": "13:00", "pomeriggio_alle": "16:30" }], ``` ## Corrieri abilitati
IDCorriere
1BRT
# incoterm object Oggetto contenente i dati Incoterm necessari per indicazioni doganali ```json "incoterm": { "incoterm_code": "EXW", "location": "C.So felice cavallotti 15 15121 Alessandria" } ``` Di seguito il dettaglio dei campi
CampoRequiredCodificaDescrizione
incoterm_codetruestringSigla Incoterm
locationtruestringLocation
{% hint style="warning" %} Per alcuni corrieri vanno inviati contestualmente ai [Parties ](/spedizioni-e-dintorni/shipment/shipment-objects/parties)ai fini doganali {% endhint %} ## Corrieri abilitati
IDCorriere
17DB Schenker
70Dummy1
71Dummy2
72Dummy3
73Dummy4
74Dummy5
75Dummy6
76Dummy7
77Dummy8
78Dummy9
79Dummy10
90Italsempione
91Logisticando
92CsiLogistica
113DHL Freight
171Skynet (solo incoterm_code)
182DHL WLA (solo incoterm_code)
185DSV WS
# operativita\_destinatario Un array di un oggetto che, per alcuni corrieri, permette di indicare i giorni di apertura e chiusura del destinatario. * A -> Aperto * C -> Chiuso * M -> Aperto solo mattino * P -> Aperto solo pomeriggio ```json "operativita_destinatario": [{ "lunedi": "A", "martedi": "C", "mercoledi": "M", "giovedi": "C", "venerdi": "C", "sabato": "P", "domenica": "P" }], ``` ## Corrieri abilitati
IDCorriere
1BRT
19Poste Delivery Business Inviosystem
105SDA
# parties object Oggetto contenente i soggetti partecipanti alla spedizione per i dati doganali o altre funzionalità {% code fullWidth="false" %} ```json "parties": { "delivery": { "name":"Gsped SC", "address":"Corso Felice Cavallotti 15", "city":"Alessandria", "zipcode":"15121", "state":"Italia", "country":"IT", "email":"noreply@gsped.com", "phone":"123", "eori":"IT12345678901", "contact":"Franco", "clientCode":"12345" }, "pickup": { "name":"Magazzino Gsped", "address":"Corso Felice Cavallotti 17", "city":"Alessandria", "zipcode":"15121", "state":"Italia", "country":"IT", "email":"noreply@gsped.com", "phone":"123", "eori":"IT12345678901", "contact":"Mario", "clientCode":"67890" }, "freightPayer": { "name":"Gsped SC", "address":"Corso Felice Cavallotti 18", "city":"Alessandria", "zipcode":"15121", "state":"Italia", "country":"IT", "email":"noreply@gsped.com", "phone":"123", "eori":"IT12345678901", "contact":"Giovanni", "clientCode":"abcdef" }, "customsPayer": { "name":"Gsped SC", "address":"Corso Felice Cavallotti 19", "city":"Alessandria", "zipcode":"15121", "state":"Italia", "country":"IT", "email":"noreply@gsped.com", "phone":"123", "eori":"IT12345678901", "contact":"Luigi", "clientCode":"ghjki" }, "importer": { "name":"Gsped SC", "address":"Corso Felice Cavallotti 20", "city":"Alessandria", "zipcode":"15121", "state":"Italia", "country":"IT", "email":"noreply@gsped.com", "phone":"123", "eori":"IT12345678901", "contact":"Giovanni", "clientCode":"lmnop" }, "exporter": { "name":"Gsped SC", "address":"Corso Felice Cavallotti 21", "city":"Alessandria", "zipcode":"15121", "state":"Italia", "country":"IT", "email":"noreply@gsped.com", "phone":"123", "eori":"IT12345678901", "contact":"Giovanni", "clientCode":"qrstu" } } ``` {% endcode %} I vari soggetti possono essere (non tutti i corrieri hanno tutti i soggetti): * delivery -> soggeto in caso di consegna in luogo diverso dall'indirizzo del destinatario. * pickup -> soggetto in caso di ritiro in luogo diverso dall'indirizzo del mittente. * freightPayer -> dati soggetto che si occupa del pagamento della spedizione * customsPayer -> dati soggetto che si occupa del pagamento dei dazi doganali * importer -> soggetto che si occupa di importare la merce * exporter -> soggetto che si occupa di esportare la merce Di seguito il dettaglio di campi, comuni ad ogni soggetto
CampoRequiredCodificaDescrizione
nametruestringRagione sociale
addresstruestringIndirizzo
citytruestringCittà
zipcodetruestringCAP
statetruestringNome nazione
countrytruestringISO 2 Char nazione
emailtruestringEmail
phonetruestringTelefono
eoritruestringCodice EORI
contacttruestringNome contatto
clientCodefalsestringAccount Number presso il corriere
## Corrieri abilitati
IDCorriere
20Fedex
113Dhl Freight
185DSV WS
103UPS
104DHL
# qrCode object ## Descrizione Oggetto contenente informazioni per mostrare, per alcuni [corrieri abilitati](#corrieri-abilitati), un QrCode multifunzionalità. {% hint style="warning" %} L'**etichetta** deve avere lunghezza minima di **10x18 cm** anziché le normali 10x15 cm {% endhint %} ```json "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
urlfalsestringUrl fisso da mostrare nel qrCode
post_uploadfalseobjectContenitore di chiavi per creare un oggetto S3 sul bucket su cui poi verrà fatto PUT per valorizzarlo
post_upload.file_typefalsestringL'estensione del file che verrà poi caricato
registrazione_esitofalseboolCrea 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. {% hint style="danger" %} **Le varie modalità non sono compatibili, quindi sono da usare in modo esclusivo.** {% endhint %} ### **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. ```json "qrCode": [ { "putUrl": "XXX", // Url pur il PUT "url":"XXX" // Url per il GET, presente nel barcode } ] ``` Ecco un esempio di upload: ```bash 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 {% hint style="warning" %} I link hanno validità di 7 giorni\ Nel caso siano scaduti possono essere rinnovati tramite [apposito endpoint API](/spedizioni-e-dintorni/refreshqr) {% endhint %} ### 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 {% hint style="warning" %} **ATTENZIONE :** Questa funzionalità è in fase di sviluppo. Indicativamente sarà disponibile dopo la prima metà del mese di Agosto 2025 {% endhint %} 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 : ```json "qrCode":{ "url":"XXXXXX", "pin_code": "test1234" } ``` ```json "qrCode":{ "post_upload":{ "file_type" :"PDF" }, "pin_code": "test1234" } ``` ```json "qrCode":{ "registrazione_esito":true, "pin_code": "test1234" } ``` ## Corrieri abilitati
IDCorriere
1BRT
2TNT
19Poste Delivery Business Inviosystem
70Dummy1
71Dummy2
72Dummy3
73Dummy4
74Dummy5
75Dummy6
76Dummy7
77Dummy8
78Dummy9
79Dummy10
90Italsempione
91Logisticando
92CSILogistica
93Ribosped
94Zust - Tiesse
95Lynx
97Speditalia
101GLS
104DHL
131Fercam
182DHL WLA
# trade\_documents Array Invio di Documenti elettronici (PLT) per i corrieri che lo gestiscono [Corrieri abilitati al PLT(paperless)](/spedizioni-e-dintorni/shipment/corrieri/corrieri-abilitati-al-plt-paperless) ```json "trade_documents":[ { "nome":"COMMERCIAL_INVOICE_TESTRIF1234_1.pdf", "contenuto":"" } ] ``` Di seguito la descrizione dei campi, la nomenclatura è definita nella pagina [Corrieri abilitati al PLT(paperless)](/spedizioni-e-dintorni/shipment/corrieri/corrieri-abilitati-al-plt-paperless)
CampoRequiredCodificaDescrizione
nometruestringNome documento
contenutotruestringStringa in base64 del documento
# Casi d'uso # Contrassegni # Contrassegno nazionale Esempio per incasso contrassegno nazionale ```json { "contrassegno":100.50, "tipo_incasso":12, "valuta":"EUR" } ``` Rispetto alla chiamata originale della [Shipment POST](/spedizioni-e-dintorni/shipment#shipment-post) si aggiungono questi campi con relativa descrizione
CampoRequiredTypeDescrizione
contrassegnotruefloatValore del contrassegno da incassare
tipo_incassotrueintvedi -> Codici Gsped
valutatruestringSigla valuta iso 4217
# Contrassegno Internazionale I campi ed il modo di utilizzo sono gli stessi del [contrassegno nazionale ](/spedizioni-e-dintorni/shipment/casi-duso/contrassegni/contrassegno-nazionale)ma solo alcuni corrieri gestiscono questa funzionalità. * UPS # PUDO (punti di ritiro) I punti di ritiro sono gestiti per diversi corrieri, in questa pagina sono indicati i dati da passare nella chiamata POST alla shipment per passare le informazioni relative al punto di ritiro al corriere. ## BRT - TNT - DHL - GLS - COLISSIMO-InPOST Inserire il codice identificativo del PUDO / dropoff point nel campo **generic\_service*****\_*****point** ```json { "generic_service_point":"" } ```
CampoRequiredTypeDescription
generic_service_pointtruestringCodice identificativo del PUDO
N.B. per GLS nella forma {PARTNER_SHOP_ID}-{SHOP_ID}
{% hint style="info" %} COLISSIMO: gestione service point possibile solo con servizio corriere OUT HOME, id servizio Gsped 3 {% endhint %} ## UPS Questo corriere richiede i dati completi del punto di ritiro e del suo codice identificativo. ```json "ups_uap_id": "", "uap": [ { "address": "", "city": "", "country_code": "", "name": "", "postal_code": "", "state_province_code": "" } ] ```
CampoRequiredTypeDescription
ups_uap_idtruestringCodice identificativo del PUDO
uap.addresstruestringIndirizzo PUDO
uap.citytruestringCittà PUDO
uap.country_codetruestringISO 2 Char nazione PUDO
uap.nametruestringNome PUDO
uap.postal_codetruestringCAP PUDO
uap.state_province_codetruestringSigla provincia PUDO
## SDA/Crono Questo corriere richiede i dati completi del punto di ritiro e del suo codice identificativo. ```json "sda_id_fermoposta":"", "sda_fermoposta":{ "state_province_code":"", "name":"", "address":"", "city":"", "postal_code":"" } ```
CampoRequiredTypeDescription
sda_id_fermopostatruestringCodice identificativo del PUDO
sda_fermoposta.state_province_codetruestringCodice provincia/stato PUDO
sda_fermoposta.nametruestringNome PUDO
sda_fermoposta.addresstruestringIndirizzo PUDO
sda_fermoposta.citytruestringCittà PUDO
sda_fermoposta.postal_codetruestringCAP PUDO
## POSTE Delivery Business PosteDB gestisce il punto di ritiro come accessorio, distinguendo in base alla tipologia del punto, per i punti di ritiro andrà compilato un oggetto nell'array **pdb\_accessori** con gli elementi accessorio, param1 e param2. Param1 conterrà il codice del punto, param2 la denominazione del punto e accessorio sarà una di queste stringhe in base al tipo di punto. ```json "pdb_accessori":[ { "accessorio":"", "param1":"", "param2":"", "param3":"", "param4":"" } ] ```
CampoRequiredTypeDescription
accessoriotrueenumIn base al PUDO:
- ConsegnaPUDOUPS
- ConsegnaPuntoPoste
- ConsegnaLocker
- ConsegnaUfficioPostale
param1truestringCodice identificativo PUDO
param2truestringNome PUDO
param3falsestringnon utilizzato
param4falsestringnon utilizzato
## TNT (vecchia implementazione, deprecata nel 2024) Questa implementazione verrà rimossa in favore di [quella nuova](#brt-dhl) nel corso del 2024. Nella chiamata andrà inserito un array a indici numerici denominato **tnt\_options** ```json "tnt_options":[ "", // 1° valore "" // 2° valore ] ```
CampoRequiredTypeDescription
1° valoretrueenumValorizzare con 3
(TNT Point)
2° valoretruestringCodice identificativo PUDO
## DHL Parcel Connect (169) Questo corriere richiede il codice identificativo dell'accesspoint (KeywordID) insieme a CAP, città e nazione in cui si trova. Esempio : ```json "accessPoint": { "apId": "501", "apCity": "Zukowo", "apPostalCode": "83-330", "apCountryCode": "PL" } ``` Per la Germania e Lussemburgo viene richiesto anche un codice identificativo del destinatario, in quanto questi ultimi devono essere registrati per poter ricevere spedizioni negli Access Points. Esempio : ```json "accessPoint": { "apId": "501", "apCity": "Berlin", "apPostalCode": "10557", "apCountryCode": "DE", "apAncillaryData": { "customerId": "123456" } } ``` #### Gestione identificativi di Access Point proveniente da Zalando Per gli ordini provenienti da Zalando, nel caso il cliente abbia richieda la consegna in Access Point, questa piattaforma ritornerà un identificativo particolare per l'access point scelto dal cliente. Quest'ultimo non potrà essere utilizzato all'interno del campo **apId,** ma bensi bisognerà indicarlo all'interno del campo **zalandoServicePointID.** Esempio : ```json "accessPoint": { "zalandoServicePointID": "4517265", "apCity": "Zukowo", "apCountryCode": "PL" } ``` {% hint style="danger" %} **ATTENZIONE:** Questa funzionalità sarà disponibile nelle prime settimane di Gennaio 2026 {% endhint %} # Ritiro contestuale Esempio per ritiro contestuale alla spedizione ```json { "date_req_ritiro":"2023-11-01", "opening_time":"08:00:00", "closing_time":"12:00:00", "opening_time2":"14:00:00", "closing_time2":"18:00:00" } ``` Rispetto alla chiamata originale della [Shipment POST](/spedizioni-e-dintorni/shipment#shipment-post) si aggiungono questi campi con relativa descrizione
CampoRequiredTypeDescrizione
date_req_ritirotruestringData per ritiro (formato YYYY-MM-DD)
opening_timetruestringOra apertura per ritiro (formato HH:MM:SS)
closing_timetruestringOra chiusura per ritiro (formato HH:MM:SS)
opening_time2falsestringSeconda Ora apertura per ritiro (formato HH:MM:SS) SOLO PER TNT
closing_time2falsestringSeconda Ora chiusura per ritiro (formato HH:MM:SS) SOLO PER TNT
{% hint style="warning" %} Alcuni corrieri chiedono l'obbligatorietà di alcuni di questi dati in quanto effettuano contestualmente ritiro della merce {% endhint %} # Servizi accessori Alcuni corrieri mettono a disposizione dei servizi accessori che sono indicabili su Gsped. {% hint style="info" %} Per l'effettivo utilizzo da parte di ogni corriere fare riferimento a Gsped.\ La lista è parziale ed in continuo aggiornamento. {% endhint %}
CampoRequiredTypeDescrizione
preavviso_telefonicofalseS/NSe si richiede appuntamento telefonico prima della consegna
- BRT (1)
- PDB Inviosystem (19)
- Da Rold Cassol (30)
- GLS (101)
- SDA (105)
- Susa (186)
al_sabatofalseS/NSe è possibile consegnare al sabato
- PDB Inviosystem (19)
- GLS (101)
- SDA (105)
- Seur (140)
- Asendia (155)
- DHL Benelux (184)
al_pianofalseS/N

Se è richiesto servizio di consegna al piano (alcuni corrieri lo chiamano facchinaggio)
- BRT (1)
- TNT (2)
- PDB Inviosystem (19)

- Da Rold Cassol (30)
- GLS (101)
- SDA (105)

date_req_consfalseDateData richiesta di consegna specifica
- PDB Inviosystem (19)
- SDA (105)
- Fercam (131)
facchinaggiofalsetrue/false- Da Rold Cassol (30)
spondafalse1/0

Si richiede sponde idraulica :
- Da Rold Cassol (30)

-BRT (solo stima costi; nessuna trasmissione dato al corriere)
- GLS (101)

# Corrieri Segnaliamo eventuali particolarità di gestione dei corrieri per alcune funzionalità # Corrieri abilitati al PLT(paperless) Corrieri che gestiscono il Paperless Il PLT o paperless è una modalità di creazione delle spedizioni che consente di trasmettere al corriere in formato digitale i documenti richiesti per le operazioni doganali. Per poter essere utilizzati i documenti devono essere inseriti nel corpo della chiamata POST alla risorsa shipment codificati in base64 (si veda la pagina relativa nella documentazione). La dimensione massima di ogni file è 5 MB. È possibile caricare più di un file per spedizione. **IMPORTANTE:** Il nome di ogni file deve corrispondere alla seguente convenzione: > (tipo documento)\_*(riferimento ordine)\_*(numero sequenziale).(estensione)\ > \ > esempio: COMMERCIAL\_INVOICE\_TESTRIF1234\_1.pdf Le estensioni valide sono: PDF, TXT, PNG, JPG, GIF, BMP, TIF, RTF, DOC, XLS, DOCX, XLSX I corrieri attualmente abilitati al PLT su Gsped (con i relativi **tipi\_documento**) sono:
IDCorriereTipi di documento
70
71
72
73
74
75
76
77
78
79		DummyAUTHORIZATION_FORM
CERTIFICATE_OF_ORIGIN
COMMERCIAL_INVOICE
DECLARATION
EXPORT_ACCOMPAYING_DOCUMENT
EXPORT_LICENSE
IMPORT_PERMIT
NAFTA_CERTIFICATE_OF_ORIGIN
ONE_TIME_NAFTA
OTHER
OTHER_DOCUMENT
PACKING_LIST
POWER_OF_ATTORNEY
PRO_FORMA_INVOICE
SED_DOCUMENT
SHIPPER_LETTER_OF_INSTRUCTION
90ItalsempioneAUTHORIZATION_FORM
CERTIFICATE_OF_ORIGIN
COMMERCIAL_INVOICE
DECLARATION
EXPORT_ACCOMPAYING_DOCUMENT
EXPORT_LICENSE
IMPORT_PERMIT
NAFTA_CERTIFICATE_OF_ORIGIN
ONE_TIME_NAFTA
OTHER
OTHER_DOCUMENT
PACKING_LIST
POWER_OF_ATTORNEY
PRO_FORMA_INVOICE
SED_DOCUMENT
SHIPPER_LETTER_OF_INSTRUCTION
91LogisticandoAUTHORIZATION_FORM
CERTIFICATE_OF_ORIGIN
COMMERCIAL_INVOICE
DECLARATION
EXPORT_ACCOMPAYING_DOCUMENT
EXPORT_LICENSE
IMPORT_PERMIT
NAFTA_CERTIFICATE_OF_ORIGIN
ONE_TIME_NAFTA
OTHER
OTHER_DOCUMENT
PACKING_LIST
POWER_OF_ATTORNEY
PRO_FORMA_INVOICE
SED_DOCUMENT
SHIPPER_LETTER_OF_INSTRUCTION
92CSI LogisticaAUTHORIZATION_FORM
CERTIFICATE_OF_ORIGIN
COMMERCIAL_INVOICE
DECLARATION
EXPORT_ACCOMPAYING_DOCUMENT
EXPORT_LICENSE
IMPORT_PERMIT
NAFTA_CERTIFICATE_OF_ORIGIN
ONE_TIME_NAFTA
OTHER
OTHER_DOCUMENT
PACKING_LIST
POWER_OF_ATTORNEY
PRO_FORMA_INVOICE
SED_DOCUMENT
SHIPPER_LETTER_OF_INSTRUCTION
93RibospedAUTHORIZATION_FORM
CERTIFICATE_OF_ORIGIN
COMMERCIAL_INVOICE
DECLARATION
EXPORT_ACCOMPAYING_DOCUMENT
EXPORT_LICENSE
IMPORT_PERMIT
NAFTA_CERTIFICATE_OF_ORIGIN
ONE_TIME_NAFTA
OTHER
OTHER_DOCUMENT
PACKING_LIST
POWER_OF_ATTORNEY
PRO_FORMA_INVOICE
SED_DOCUMENT
SHIPPER_LETTER_OF_INSTRUCTION
94TiesseZustAUTHORIZATION_FORM
CERTIFICATE_OF_ORIGIN
COMMERCIAL_INVOICE
DECLARATION
EXPORT_ACCOMPAYING_DOCUMENT
EXPORT_LICENSE
IMPORT_PERMIT
NAFTA_CERTIFICATE_OF_ORIGIN
ONE_TIME_NAFTA
OTHER
OTHER_DOCUMENT
PACKING_LIST
POWER_OF_ATTORNEY
PRO_FORMA_INVOICE
SED_DOCUMENT
SHIPPER_LETTER_OF_INSTRUCTION
95LynxAUTHORIZATION_FORM
CERTIFICATE_OF_ORIGIN
COMMERCIAL_INVOICE
DECLARATION
EXPORT_ACCOMPAYING_DOCUMENT
EXPORT_LICENSE
IMPORT_PERMIT
NAFTA_CERTIFICATE_OF_ORIGIN
ONE_TIME_NAFTA
OTHER
OTHER_DOCUMENT
PACKING_LIST
POWER_OF_ATTORNEY
PRO_FORMA_INVOICE
SED_DOCUMENT
SHIPPER_LETTER_OF_INSTRUCTION
20
102		FedexCERTIFICATE_OF_ORIGIN
COMMERCIAL_INVOICE
NAFTA_CERTIFICATE_OF_ORIGIN
OTHER
PRO_FORMA_INVOICE
103UPSAUTHORIZATION_FORM
CERTIFICATE_OF_ORIGIN
COMMERCIAL_INVOICE
DECLARATION
EXPORT_ACCOMPAYING_DOCUMENT
EXPORT_LICENSE
IMPORT_PERMIT
ONE_TIME_NAFTA
OTHER_DOCUMENT
PACKING_LIST
POWER_OF_ATTORNEY
SED_DOCUMENT
SHIPPER_LETTER_OF_INSTRUCTION
104
182		DHL
DHL WLA

AIR_WAYBILL

CERTIFICATE_OF_ORIGIN
COMMERCIAL_INVOICE
DECLARATION

INVOICE
NAFTA_CERTIFICATE_OF_ORIGIN
PRO_FORMA_INVOICE

183MBE2CERTIFICATE_OF_ORIGIN
COMMERCIAL_INVOICE
OTHER
# AlpiExpress ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Più economico250
## Trade documents ```json "trade_documents":[ { "nome":"COMMERCIAL_INVOICE_TESTRIF1234_1.pdf", "contenuto":"" } ] ``` # ALT ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Espresso1780Domestico
# Amazon Prime {% hint style="warning" %} Corriere dal funzionamento particolare. Per utilizzarlo serve avere credenziali Amazon ed ordini Amazon su Gsped. Infine vanno attivati i corrieri disponibili sul pannello Amazon. {% endhint %} ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Più economico1610Domestico
TNT1611Domestico
Poste Delivery Business1612Domestico
Poste Delivery Business Saturday1613Domestico
{% hint style="danger" %} Poste Delivery Business Per usare Poste Delivery Business è necessario inserire un proprio account nel Seller Central ed accettare le policy di Amazon {% endhint %} # Amazon Shipping ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Spedizione Nazionale Express120Domestico, monocollo, max 34Kg
## Gestione campi generici in creazione spedizione Per questo corriere è possibile gestire fino 10 campi generici che possono andare a modificare i dati che vengono trasmessi al corriere. Questo vale **SOLO** nei casi in cui non vi può essere una gestione standard tra i campi messi a disposizione dall'endpoint Shipment. ```json "courierData":{ "generic1": "", "generic2": "", "generic3": "", "generic4": "", "generic5": "", "generic6": "", "generic7": "", "generic8": "", "generic9": "", "generic10": "" } ``` ### Come possono essere utilizzati questi campi? Per usufruire dei campi generici che non hanno ancora uno specifico utilizzo, bisognerà contattare Gsped per valutare / analizzare i seguenti punti : * Quali informazioni devono essere trasmesse al corriere che non sono ancora gestiti in maniera standard? * In quale modalità dovranno essere trasmessi al corriere (campi specifici nella richiesta di creazione spedizione da inviare al corriere) * Fattibilità della richiesta # Arcese B2C ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Spedizione Nazionale Express1670Domestico
# Arco Spedizioni ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Standard1000Domestico
Urgente1001Domestico
Espresso1002Domestico
Internazionale Standard1006Internazionale
Internazionale Urgente1007Internazionale
Internazionale Espresso1008Internazionale
# Asendia ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Standard Goods Economy15520
Standard Goods Priority15521
Country-Tracked Goods15522
Fully-Tracked Goods Mailbox Delivery15523
Fully-Tracked Goods Personal Delivery15524
e-PAQ Plus15531
e-PAQ Sekect15532
# Attanasio ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Veloce330Domestico
Standard331Domestico
Espresso332Domestico
## Campi per Shipment PATCH | campo | Limitazioni | | ---------- | ---------------------- | | ddt\_alpha | String (minimo 1 char) | # Bianchi Trasporti ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Italia e San Marino1651Domestico
Estero1652Internazionale
# Barone Trasporti ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Standard451Domestico
# Bracchi ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Nazionale1910Domestico
## [Trade documents](/spedizioni-e-dintorni/shipment/shipment-objects/trade_documents) **Disponibile nelle chiamate: Shipment POST e Shipment PATCH** ``` "trade_documents":[ { "nome":"COMMERCIAL_INVOICE_TESTRIF1234_1.pdf", "contenuto":"" } ] ``` ## Campi per Shipment PATCH | campo | Limitazioni | | ---------------------------------------------- | ---------------------- | | [trade\_documents](#trade-documents).nome | String | | [trade\_documents](#trade-documents).contenuto | String | | ddt\_alpha | String (minimo 1 char) | # BRT ## Limitazioni campi corriere | Campo | Limitazione | | ------------------- | ----------- | | ddt\_alpha | Max 15 char | | rcpt\_addr | Max 35 char | | rcpt\_cap | Max 9 char | | rcpt\_city | Max 35 char | | rcpt\_country\_code | Max 2 char | | rcpt\_name | Max 35 char | | rcpt\_prov | Max 2 char | ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Express10Domestico
Priority11Domestico
10:3012Domestico
Messaggeria13Domestico
ESTERO DPD16Internazionale
ESTERO EUROEXPRESS17Internazionale
ESTERO FEDEX18Internazionale
DPD Direct Infeed19Internazionale, monocollo
ESTERO DPD Multicollo110Internazionale, max 5 colli
Home To Home111Domestico
## Mappatura incasso [contrassegni](/overview/codici-gsped#tipologia-incassi-contrassegno) | ID Gsped | Codice BRT | | -------- | ---------- | | 10 | OC | | 11 | OM | | 14 | TO | | 15 | BB | ## Shipment PATCH Di seguito l'elenco dei campi patchabili: ```json { "ddt_alpha":"XXXXX", "ddt_num":1234, "contrassegno":0.0, "valore":0.0, "valore_doganale":0.0, "tipo_incasso":10, "al_piano":"S/N", "invoiced_client_id":0, "date_req_cons":"YYYY-MM-DD", "preavviso_telefonico":"S/N", "al_sabato":"S/N", "flag_reso":0/1 } ``` # Ceva ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Standard1641
# Chronopost ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Chrono_10 - working days220
Chrono_10 - on saturday221
Chrono_13 - working days222
Chrono_13 - on saturday223
Chrono_18 - working days224
Chrono_18 - on saturday225
Chrono_Express226
Chrono_Classic_B2B - over_3Kg227
Chrono_Classic_B2B - under_3Kg228
Chrono_Classic_B2C - over_3Kg229
Chrono_Classic_B2C - under_3Kg2210
# Colissimo ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Home no signature1730
Home with signature1731
Out of home - Pickup Points1733
International Domestic no signature1736
International Domestic with signature1737
Expert International1738
Retour France1739
Home OM - with signature17310
Eco OM - no signature17311
Eco OM - with signature17312
Retuor International17313
Home OM - no signature17314
## Forzatura codice cliente Possibilità di inviare il codice cliente per forzare la bollettazione con un dato codice contratto ```json "courierData":{ "clientCode":"588326" } ``` # Correos ES ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
PAQUETE POSTAL PRIORITARIO14520Internazionale
POSTAL EXPRÉS14521Internazionale
PAQ ESTÁNDAR DOMICILIO14522Domestico
PAQ ESTÁNDAR OFICINA14523Domestico
PAQ STANDARD INTERNACIONAL14524Internazionale
PAQ RETORNO PREMIUM CON ENVÍO ASOCIADO14525Domestico
S0148 PAQ RETORNO14526Domestico
PAQ PREMIUM DOMICILIO14527Domestico
PAQ PREMIUM EN OFICINA14528Domestico
PAQ PREMIUM INTERNACIONAL14529Internazionale
PAQUETE POSTAL ECONÓMICO14530Internazionale
PAQ PREMIUM ENTREGA EN HOMEPAQ14531Domestico
PAQ PREMIUM ENTREGA EN CITYPAQ14532Domestico
PAQ ESTÁNDAR ENTREGA EN HOMEPAQ14533Domestico
PAQ ESTÁNDAR ENTREGA EN CITYPAQ14534Domestico
PAQ INTERNACIONAL LIGHT14535Domestico
PAQ ESTANDAR DOMICILIO Y RETORNO14536Domestico
# Correos Express ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Paq 1014120
Paq 1414121
Paq 2414122
Baleares Express14123
Canarias Express14124
Canarias Aéreo14125
Canarias Marítimo14126
Internacional Estándar14127
Internacional Express14128
Paq Empresa 1414129
ePaq 2414130
Entrega Plus14131
# CSI Logistica ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Nazionale920Domestico
## [Trade documents](/spedizioni-e-dintorni/shipment/shipment-objects/trade_documents) **Disponibile nelle chiamate: Shipment POST e Shipment PATCH** ``` "trade_documents":[ { "nome":"COMMERCIAL_INVOICE_TESTRIF1234_1.pdf", "contenuto":"" } ] ``` ## Campi per Shipment PATCH | campo | Limitazioni | | ---------------------------------------------- | ---------------------- | | [trade\_documents](#trade-documents).nome | String | | [trade\_documents](#trade-documents).contenuto | String | | ddt\_alpha | String (minimo 1 char) | # Da Rold Cassol ## Lista codici Gsped | Servizio | Codice corriere | Codice servizio | Note | | -------------- | --------------- | --------------- | -------------- | | Nazionale | 30 | 0 | Domestico | | Internazionale | 30 | 1 | Internazionale | ## Consegna oltre il primo piano Per richiedere il servizio accessorio, inserire nella richiesta di creazione spedizione quanto segue : ```json "darold": { "oltrePrimoPiano": true } ``` ## Consegna ore 12 Per richiedere il servizio accessorio, inserire nella richiesta di creazione spedizione quanto segue : ```json "darold": { "ore12": true } ``` ## Sponda Idraulica e transpallet Per richiedere il servizio accessorio, inserire nella richiesta di creazione spedizione quanto segue : ```json "darold": { "spondaTranspallet": true } ``` ## Altri servizi accessori Oltre ai servizi accessori specifici per Da Rold, gestiamo anche i seguenti servizi accessori :
* Consegna al piano : Per Da Rold questo servizio prevede la consegna fino al primo piano o in cantina\ \ Utilizzare il campo **al\_piano** valorizzato a "S"
* Prenotazione telefonica :\ \ Utilizzare il campo **preavviso\_telefonico** valorizzato a "S".\ \ In questo caso il corriere prevede che venga indicato il numero di telefono del destinatario o che nelle note venga indicato l'url dove il corriere deve eseguire la prenotazione.
* Facchinaggio : \ \ Utilizzare il campo **facchinaggio** valorizzandolo a true.
* Sponda Idraulica : \ \ Utilizzare il campo **sponda** valorizzato a true.
* Contrassegno : \ \ Utilizzare il campo **contrassegno** per indicare l'importo ed il campo **tipo\_incasso** per indicare la modalità in cui il corriere deve riscuotere il conttrassegno.
Sono ammessi solo i seguenti codici di tipo\_incasso : * Contanti : 0, 12 * Assegno intestato al mittente : 10, 11, 15
* Assicurazione : \ \ Utilizzare il campo **valore** per riportare il valore complessivo da assicurare. \ **Importante :** \ \ Questi servizi accessori, sono gestiti attraverso campi che non sono utilizzabili anche per altri corrieri, di conseguenza questi **NON** vanno indicati all'inteno del campo **darold**, ma insieme agli altri dati della richiesta di creazione spedizione. Quindi se ad esempio richiedo una spedizione dove sono richiesti i seguenti accessori : * Prenotazione telefonica * Facchinaggio * Sponda Idraulica e transpalet Nel payload andranno indicati i seguenti campi : ```json "preavviso_telefonico": "S", "facchinaggio": "true", "darold": { "spondaTranspallet": true } ``` Per altri dettagli relativi ai servizi accessori, consultare la seguente pagina : # Dachser Iberia ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Express1620
Express canarias1622
Premium Hora Limite1624
# Db Schenker ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
System1743
System Premium1744
System Home1745
Full Load1771
Part Load1772
* Il [ritiro contestuale](/spedizioni-e-dintorni/shipment/casi-duso/ritiro-contestuale) alla spedizione è **OBBLIGATORIO** ```json { "date_req_ritiro":"2023-11-01", "opening_time":"08:00:00", "closing_time":"12:00:00" } ``` * Il volume NON può essere 0 e deve essere passato con massimo 2 cifre decimali * Il **peso** può contenere al massimo 2 cifre decimali * Il corriere tratta ogni collo come minimo 1 Kg anche se più leggero * La sezione [incoterm](/spedizioni-e-dintorni/shipment/shipment-objects/incoterm) (location max 35 caratteri) è **OBBLIGATORIA**. ```json "incoterm": { "incoterm_code": "EXW", "location": "C.So f. cavallotti 15 Alessandria" } ``` # DHL ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Domestic Express1040Domestico
Domestic Express H121041Domestico
Domestic Express H10:301042Domestico
Domestic Express H91044Domestico
Express Worldwide H121047Internazionale
Economy Select1048Internazionale
Express Worldwide1049Internazionale
Express Worldwide H910410Internazionale
Medical Express10420Domestico / Internazionale
## DHL ICS2 (CIN) Per le spedizioni extraUe il corriere richiede obbligatoriamente che nella chiamata Shipment vengano valorizzati: * **RICHIESTO: ddt\_alpha** Riferimento alfanumerico * [dettagli\_ordine](/spedizioni-e-dintorni/shipment/shipment-objects/dettagli_ordine) * Opzionale: invoice\_date * Opzionale: invoice\_number * Opzionale: [additional\_charges](/spedizioni-e-dintorni/shipment/shipment-objects/courierdata/additional_charges) ### Additional Charges E' possibile definire dei valori che non sono relativi al valore reale della merce, come ad esempio i costi di spedizione, costi di packaging etc.\ Per passarli a DHL bisogna compilare la sezione [**additional\_charges**](/spedizioni-e-dintorni/shipment/shipment-objects/courierdata/additional_charges), di seguito la lista completa dei campi disponibili: ```json "courierData": {       "additional_charges": {         "administration": 1,         "delivery": 0,         "documentation": 0,         "expedit": 0,         "export": 0,         "freight": 0,         "fuel": 0,         "logistic": 0,         "other": 0,         "packaging": 0,         "pickup": 0,         "handling": 0,         "vat": 0,         "insurance": 0,         "reverse": 0       }     } ``` ## Fatture attive C'è la possibilità di inviare dati della fattura (per ora solamente la p.iva / codice fiscale) dello Shipper al corriere valorizzando il campo *fattura\_dhl* in questo modo ```json "fattura_dhl": [ { "codice_fiscale": "02554360061", // codice fiscale o partita iva "pec": null, "sdi": "0000000", "nome": "Nome intestatario", "indirizzo": "Indirizzo completo", "cap": "20148", "citta": "Milano", "provincia": "MI", "nazione": "IT", "type": "privato", "email": "noreply@gsped.com", "nolo": 18.01, "totale_fattura": 18.01, "assicurazione": null, "valore": 0 } ``` ## Addebito terzo Per DHL è stato reso possibile indicare i codici clienti di un terzo per addebitargli i costi di spedizione e/o gli oneri doganali. Di seguito alcuni esempi di payload da utilizzare nelle varie casistiche : **Costi spedizione e oneri doganali a terzo :** ```json "parties": { "freightPayer": { "country": "IT", "clientCode": "abcdef" }, "customsPayer": { "country": "IT", "clientCode": "ghjki" } } ``` {% hint style="danger" %} **ATTENZIONE:** In caso il codice terzo sia radicato nella stessa nazione in cui è destinata la spedizione, il codice cliente **DEVE** essere di tipo **IMPORT** {% endhint %} **Costi spedizione a terzo :** ```json "parties": { "freightPayer": { "country": "IT", "clientCode": "abcdef" } } ``` **Costi oneri doganali a terzo :** ```json "parties": { "customsPayer": { "country": "IT", "clientCode": "ghjki" } } ``` ## Codici utili alla dogana in spedizioni internazionali Per le spedizioni internazionali dove la merce è soggetta a controlli doganali, vi può essere la necessità di indicare dei codici specifici utili alla doaana, come può essere ad esempio il codice ITN per le spedizioni in **export** dagli Stati Uniti. Ogni codice da indicare al corriere è composto da due informazioni : Il tipo di codice (a cosa corrisponde) ed il rispettivo valore. Ecco un esempio del payload da utilizzare : ```json "dhl": { "invoiceReferences": { "ITN": "codice_123", "FTR": "codice_456" } } ``` Di seguito l'elenco di codici ammessi dal corriere : * ACL -> Parent Shipment ID for BBX * CID -> Customer Identifier * CN -> Contract Number * CU -> Consignor reference number * ITN -> US Export declaration reference ID * MRN -> Movement Reference number * UCN -> Unique reference of a consignment (UCRN) * OID -> Order Number * PON -> Purchase Order Number * RMA -> RMA Number * AAM -> AWB Ref # * ABT -> Goods Declaration number * ADA -> Buyer Reference number * AES -> AES Post Clearance * AFD -> 1496 Item number * ANT -> Consignee Reference number * BKN -> Booking Number * BOL -> Bill of Lading Number * CDN -> Customs Declaration number * COD -> Cash On Delivery * DSC -> Weltpaket Reference * FF -> Freight forwarder's reference number * FN -> Freight bill number * FTR -> Post Clearance Exemption US * HWB -> Shipment Identifiers * IBC -> Inbound center reference number * IPP -> Insurance Policy Provider * LLR -> Load list reference * MAB -> Master Airwaybill Number * MWB -> MAWB Reference number * NLR -> ECCN - No License Required indicator (NLR) * OBC -> Outbound center reference number * PD -> Vendor Reference Number * PRN -> Pickup request number * RTL -> Return Leg waybill number * SID -> Shipment ID 15 Digit CODA * SS -> Seller Reference number * SWN -> Original Waybill number (Return) ## Servizio Go Green Plus Servizi di trasporto a basse emissioni, facilitati da carburante per l'aviazione sostenibile. ```json "dhl": { "goGreenPlus": true } ``` ## Servizio Firma Adulto DHL richiederà la firma di consegna da parte di un adulto all'indirizzo di consegna concordato. ```json "dhl": { "adultSignature": true } ``` ## Servizio Firma Diretta DHL otterrà la firma dal destinatario o da un rappresentante all'indirizzo di consegna. Nel caso in cui non ci sia nessuno all'indirizzo di consegna, DHL ritenterà la consegna. Il servizio Firma Diretta assicura che le tue spedizioni non possano essere reindirizzate, lasciate in una cassetta postale o lasciate al vicino. ```json "dhl": { "directSignature": true } ``` ## Proactive Tracking Monitoraggio del transito della tua spedizione, con incidenti e notifiche di consegna in tempo reale. ```json "dhl": { "proactiveTracking": true } ``` ## Modifica di una spedizione (Shipment PATCH) ### Aggiungere Documento elettronico a spedizione Per poter caricare documenti postumi, ovvero dopo aver generato la spedizione, all'atto della creazione della spedizione con la **Shipment POST** bisogna indicarlo esplicitamente, dato che il corriere **ha bisogno di sapere che per una specifica spedizione verranno caricati dei documenti in un secondo momento.** Il parametro da utilizzare è **uploadDocAfterwards,** ed è da indicare all'interno del campo **courierData**. Qui la documentazione: {% content-ref url="/pages/mJs8XwbrGAIhJjZ2Rgcq" %} [uploadDocAfterwards](/spedizioni-e-dintorni/shipment/shipment-objects/courierdata/uploaddocafterwards) {% endcontent-ref %} ## Barcode in etichetta DHL offre la possibilità di inserire in etichetta un codice barcode. Payload da utilizzare al momento della creazione della spedizione : ```json "dhl": { "customerBarcode": { "barcodeType": TIPO_BARCODE, "barcodeContent": CONTENUTO_BARCODE, "textBelowBarcode": TESTO_DA_RIPORTARE_SOTTO_IL_BARCODE [OPZIONALE] } } ``` Dove : * **barcodeType :** Tipologia di Barcode. Valori ammessi --> 39, 93 e 128 * **barcodeContent :** Contenuto che verrà riportato sotto forma di Barcode * **textBarlowBarcode :** Questo campo è opzionale e sarà il testo che verrà riportato sotto il barcode. {% hint style="info" %} **ATTENZIONE :** Nelle spedizioni multicollo, il barcode verrà riportato su tutte le etichette (non è possibile avere un codice diverso per ognuna di esse) {% endhint %} {% hint style="info" %} **ATTENZIONE :** Se utilizzate le etichette ZPL, dovete tenere a mente che con questa funzionalità le etichette fornite dal corriere saranno in formato **10x20 CM** {% endhint %} ## Spedizioni Label-Free / Label-Less DHL offre la possibilità di generare spedizioni sulle quali non viene richiesta un etichetta, ovvero, il corriere non restiuirà un etichetta, ma ritornerà un QR Code che il mittente dovrà mostrare all'atto della consegna del collo da spedire nel service point DHL. Questi tipo di servizio è molto utile per i resi, dove sostanzialmente viene permesso al cliente finale di portare il proprio pacchetto da spedire al service point e, fornendo il QR code dal proprio cellulare, depositare il collo da inviare o rendere senza dover stampare l'etichetta a casa. Nella richiesta di generazione spedizione attraverso la Shipment dovrà essere indicato quanto segue: ```json "courierData": { "labelLessReturn": true } ``` Ecoo un esempio del QrCode restituito :
# Resi in franchigia - RGR Il reso in franchigia o Returned Goods Relief (RGR) è un servizio offerto da DHL per esonerare dei dazi doganali il proprietario del contratto per prodotti resi dall'estero (SOLO per flussi di andata e ritorno). Gsped mette a disposizione l'endpoint **RGR** per la generazione del file SPED per la sola spedizione di andata oppure la generazione del file RGR per la spedizione di reso. ## Endpoint RGR `POST` `/https://api.gsped.it/{istanza}/dhl/rgr` **Headers** | Name | Value | | ------------ | ------------------ | | Content-Type | `application/json` | | x-api-key | `YOUR API KEY` | **Body** | Name | Type | Description | | --------------------------------------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | flag\_reso\* | number |

Indicazione se si tratta di una spedizione di reso o meno.

Valori possibili :
0 -> Spedizione di andata
1 -> Spedizione di reso

| | client\_id\* | number | Valore comunicato da Gsped | | num\_spedizione\* | string | Numero di spedizione (tracking number) | | colli\* | number | Numero di colli | | addebito\_dogana\* | number |

Valore numerico che indica a chi spettano gli oneri doganali.

Valori possibili :
0 -> Destinatario
1 -> Mittente

| | valuta\* | string | Codice a tre caratteri che indica la valuta di riferimento (Esempio EUR) | | rcpt\_email\* | string | Indirizzo email del destinatario | | rcpt\_name\* | string | Nome del destinatario | | rcpt\_addr\* | string | Indirizzo del destinatario | | rcpt\_city\* | string | Cità del destinatario | | rcpt\_country\_code\* | string | Nazione del destinatario in formato ISO code a 2 caratteri | | sender\_eori\* | string | Codice eori del mittente | | ordersData\* | object | Contiene i dettagli detagli del ordine e/o merce spedita | | ordersData.totale\_lordo\* | number | Valore complessivo della merce spedita | | ordersData.invoice\_number\* | string | Numero fattura e/o riferimento ordine | | ordersData.invoice\_date\* | string | Data della fattura in formato YYYY-MM-DD | | ordersData.detailsData\* | array | Array che contiene i dettagli dei prodotti spediti | | ordersData.detailsData.\*.sku\* | string | SKU del prodotto | | ordersData.detailsData.\*.description\* | string | Descrizione del prodotto | | ordersData.detailsData.\*.hs\_code\* | string | HS Code del prodotto | | ordersData.detailsData.\*.country\_of\_origin\* | string | Nazione di provenienza del prodotto | | ordersData.detailsData.\*.prezzo\_singolo\* | number | Prezzo del singolo prodotto | | ordersData.detailsData.\*.qty\* | number | Numero di pezzi spediti | | ordersData.detailsData.\*.peso\_riga\* | number | Peso del prodotto | | originalAwbData | object |

Contiene i dati relativi alla spedizione di andata.

Nota bene : Solo in caso si tratti di un reso (flag\_reso = 1)

| | originalAwbData.num\_spedizione | string | Numero di tracking della spedizione di andata | | originalAwbData.detailsData | array | Array che contiene i dettagli dei prodotto spediti nella spedizione di anadata | | originalAwbData.detailsData.\*.sku | string | SKU del prodotto | **Legenda :** \* -> Dato obbligatorio \* -> Dato obbligatorio **SOLO** in caso si tratti di una spedizione di andata **Response** {% tabs %} {% tab title="200" %} ```json { "status": "ok" } ``` {% endtab %} {% tab title="400" %} ```json { "errors": [ "The field colli must be numeric.", "The field colli must be greater than 0." ] } ``` {% endtab %} {% endtabs %} ## Esempi ### Payload generazione file SPED per le spedizioni di andata : ```json { "flag_reso": "0", "client_id": YOUR_CLIENT_ID, "num_spedizione": "123456789", "colli": "1", "addebito_dogana": "1", "valuta": "EUR", "rcpt_email": "test@gsped.com", "rcpt_name": "test destinatario", "rcpt_addr": "via palma 12", "rcpt_city": "Alessandria", "rcpt_country_code": "IT", "sender_eori": "codiceEori", "ordersData": { "totale_lordo": "55", "invoice_number": "fatt123", "invoice_date": "2024-07-08", "detailsData": [ { "sku": "sku123", "description": "prodotto 123", "hs_code": "hsc123", "country_of_origin": "CO", "prezzo_singolo": "20", "qty": "1", "peso_riga": "2" }, { "sku": "sku124", "description": "prodotto 124", "hs_code": "hsc124", "country_of_origin": "IT", "prezzo_singolo": "35", "qty": "1", "peso_riga": "1" } ] } } ``` ### Payload generazione file RGR per le spedizioni di reso : ```json { "flag_reso": "1", "client_id": YOUR_CLIENT_ID, "num_spedizione": "123456789", "ordersData": { "detailsData": [ { "sku": "sku123" }, { "sku": "sku124" } ] }, "originalAwbData": { "num_spedizione": "987654321" } } ``` ## Log I file inviati vengono salvati su bucket gsped-etds su S3. # DHL BENELUX ## Lista codici Gsped {% hint style="info" %} Verificare con il commerciale DHL quali servizi sono attivi sul proprio account {% endhint %}
ServizioCodice corriereCodice servizioNote
EUROPLUS18420
DHL Parcel Europlus International - ESI18421
DFY18422
PACKET18423
DHL PARCEL RETURN CONNECT18424
DHL Parcel International18425
DHL PARCEL FOR YOU INTERNATIONAL18426
EUROPLUS PALLET DIRECT18427
DHL PARCEL IBERIA18428
DHL Parcel Europlus Doméstico18429
DHL PARCEL FOR YOU INTERNATIONAL18430
DHL PARCEL FOR YOU IBERIA18431
DHL PARCEL RETURN IBERIA18432
DFY18433
DHL PARCEL CONNECT18434
DHL Parcel For You International18435
DFY/EPL RETURN18436
DHL PARCEL RETURN CONNECT18437
DHL Parcel International18438
DHL Parcel Europlus International - ESU18439
DHL Parcel For You International18440
Speedpack18441
EUROPLUS PALLET INT18442
DFY/EPL RETURN18443
DHL PARCEL CONNECT18444
DHL PARCEL CONNECT18445
EUROPLUS INT.18446
DPI18447
DFY18448
DHL PARCEL CONNECT18449
EXPRESS18450
# DHL Freight ## Lista codici Gsped
ServizioCodice corriereCodice servizio
Euroline Domestic1130
Euroconnect Domestic1131
Eurapid Domestic1132
Standard Pallet Domestic1133
Premium Pallet Domestic1134
Home Delivery Domestic1135
Euroconnect International1136
Eurapid International1137
Euroline International1138
Home Delivery International1139
Standard Pallet International11310
Premium Pallet International11311
#### **Elenco tipologie di collo utilizzabili :** | Codice | Descrizione | | ------ | ----------------------------- | | BB | RO/BOBBIN | | BE | BUNDLE | | BG | BAG / SACK | | BL | BALE | | BX | BOX / CASE | | CA | CAN | | CG | CAGE | | CR | CRATE | | CT | CARTON / PACKAGE | | DL | DOLLY | | DR | DRUM / BARREL | | FPLE | EURO-PALLET (WITH FRAME) | | FPLH | HALF EURO-PALLET (WITH FRAME) | | GR | GARMENT ROLLER | | H1 | H1 FOOD PALLET | | HPLZ | HALF PALLET (NO POOLING) | | IBC | IBC | | OC | OCTABIN | | PAL | PALLET | | PLD | PALLET - DOUBLE EXTRA LARGE | | PLE | EURO-PALLET | | PLH | HALF PALLET | | PLL | PALLET - LARGE | | PLO | PALLET - OVERSIZED | | PLX | PALLET - EXTRA LARGE | | PLZ | PALLET EURO SIZE | | SK | SKELETON BOX | | TK | TANKTAINER | # DHL Parcel ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Connect1696Internazionale
Return connect1697Internazionale
Connect international1698Internazionale
Parcel Europe return international1699Internazionale
## Spedizioni Label-Free / Label-Less DHL offre la possibilità di generare spedizioni sulle quali non viene richiesta un etichetta, ovvero, il corriere non restiuirà un etichetta, ma ritornerà un QR Code che il mittente dovrà mostrare all'atto della consegna del collo da spedire nel service point DHL. Questi tipo di servizio è molto utile per i resi, dove sostanzialmente viene permesso al cliente finale di portare il proprio pacchetto da spedire al service point e, fornendo il QR code dal proprio cellulare, depositare il collo da inviare o rendere senza dover stampare l'etichetta a casa. Nella richiesta di generazione spedizione attraverso la Shipment dovrà essere indicato quanto segue: ```json "courierData": { "labelLessReturn": true } ``` Ecoo un esempio del QrCode restituito :
# DHL Paket ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Paket1170Domestico
WeltPaket1176Internazionale
# DHL Parcel DE ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
DHL Paket180Domestico
DHL Paket + Retoure181Domestico
DHL Paket International186Internazionale
Europaket188Internazionale
Retoure1810Internazionale
## DHL ICS2 (CIN) Per le spedizioni extraUe il corriere richiede **obbligatoriamente** che vengano valorizzati: * ddt\_alpha: Riferimento alfanumerico * [dettagli\_ordine](/spedizioni-e-dintorni/shipment/shipment-objects/dettagli_ordine) * Opzionale: invoice\_date * Opzionale: invoice\_number # DHL WLA ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Standard nazionali1820Domestico
Nazionali entro ore 101821Domestico
Nazionali entro ore 121822Domestico
Nazionali entro ore 91823Domestico
Standard UE1826Internazionale
Camionistico UE1827Internazionale
Standard Extra-UE con dogana1828Internazionale
Standard Extra-UE esente dogana1829Internazionale
Camionistico Extra-UE con dogana18210Internazionale
Internazionale entro ore 9 senza dogana18211Internazionale
Internazionale entro ore 12 senza dogana18212Internazionale
Internazionale entro ore 12 con dogana18213Internazionale
Internazionale entro ore 9 con dogana18214Internazionale
ExtraUE con servizio Break Bulk18215Internazionale
Servizio medical UE e nazionale18216
Servizio medical Extra-UE con dogana18217Internazionale
## Aggiungere documento a spedizione già generata Attraverso l'endpoint **Shipment** e verbo **PATCH** è possibile associare dei documenti elettronici alla spedizione. Il payload da utilizzare nella Shipment PATCH è il seguente : ```json { "trade_documents": [ { "nome": "COMMERCIAL_INVOICE_5123025_1.pdf", "contenuto": "Tm90aWNlDQpJbi......" } ] } ``` # DPD France ## Lista codici Gsped
ServizioCorriereServizioNote
CLASSIC60Valido da FR -> UE
Monocollo
CLASSIC MULTICOLLO61Valido da FR -> UE
Possibilità di addParcel

Attenzione! la possibilità di export internazionale dipende dal contratto con il corriere
INTERCONTINENTAL62Valido da FR -> resto del mondo ma NON UE
Monocollo
PREDICT63Valido da FR -> UE
Monocollo
RELAIS64

Valido da FR -> FR Monocollo

  • generic_service_point da passare
  • l'indirizzo del destinatario DEVE essere quello del PUDO

Pagina per la ricerca dei PUDO: https://relais.dpd.fr/fr/recherche-relais

# DPD Germany ## Lista codici Gsped | Servizio | Codice corriere | Codice servizio | | ------------------------- | --------------- | --------------- | | DPD CLASSIC | 46 | 0 | | DPD 8:30 | 46 | 1 | | DPD 12:00 | 46 | 2 | | DPD 18:00 | 46 | 3 | | DPD Express International | 46 | 4 | | DPD PARCELLetter | 46 | 5 | | DPD International Mail | 46 | 6 | | DPD MAX | 46 | 7 | ## Spedizioni Extra UE Nel caso di spedizioni al fuori dell'unione europea potrebbe essere richiesto dal corriere tutte le informazioni che possono essere utili alla dogana. Tra i campi da indicare al momomento della creazione della spedizione vi sono: * **invoice\_number** : Numero di fattura * **invoice\_date** : Data della fattura nel formatto YYYY-MM-DD * **dettagli\_ordine :** Array con i dettagli degli articoli che si stanno spedendo * Dati incoterm. Vedere [Incoterms](https://apidocs.gsped.com/spedizioni-e-dintorni/shipment/shipment-objects/incoterm) * Dati specifici del corriere da indicare all'interno della chiave **dpdgermany** : * **customsPaper** : Documenti di accompagnamento ammessi da DPD. Vedere [#tipi-di-documenti-gestiti-da-dpd-germany](#tipi-di-documenti-gestiti-da-dpd-germany "mention") * **countryRegistrationNumber** : Informazioni di registrazione nel paese di destinazione:\ Numero di registrazione o FDA * **reasonForExport** : Ll motivo dell'esportazione deve essere un valore tra Sale, Return o Gift * **exportMrn** : Codice identificativo della dichiarazione elettronica di esportazione * **invoiceConsignee** : Campi dell'anagrafica in fattura * **name1** * **street** * **country** * **zipCode** * **city** * **contact** * **eori** * **phone** * **email** Di seguito un esempio di payload dell'endpoint Shipment con i dati che gestiamo attualmente: ```json { "labelType": "ZPL", "corriere": 46, "servizio": 0, "client_id": TUO_CLIENT_ID, "chi_paga": 0, "addebito_dogana": 0, "valore_doganale": 150.50, "ddt_alpha": "test15487", "sender_addr": "Dorfplatz 1", "sender_cap": "01326", "sender_prov": "", "sender_city": "Dresden", "sender_contact": "Test mittente", "sender_country_code": "DE", "sender_email": "assistenza@test.com", "sender_name": "Test mittente", "sender_phone": "3278101234", "rcpt_addr": "35 Corbridge Crescent Containerville Unit 14", "rcpt_cap": "E29EZ", "rcpt_city": "London", "rcpt_contact": "Test destinatario", "rcpt_country_code": "GB", "rcpt_email": "test@gsped.com", "rcpt_name": "Test destinatario", "rcpt_phone": "3395212345", "rcpt_prov": "", "merce": "Fashion articles", "note_sender": "Questo e un test", "volume": 0.0, "origine": "IT", "valuta": "EUR", "peso": 2.0, "colli": 2, "invoice_number": "321654", "invoice_date": "2026-08-27", "dettagli_ordine": [ { "sku": "PBK1", "description": "Cosa blu", "qty": "1", "um": "PCS", "barcode_riga": "12345464", "hs_code": "123456454", "prezzo_singolo": "12.50", "peso_riga": "1", "country_of_origin": "IT" }, { "sku": "PBK12", "description": "Cosa blu e rossa", "qty": "1", "um": "BOX", "barcode_riga": "12345465", "hs_code": "123456454", "prezzo_singolo": "25.00", "peso_riga": "1", "country_of_origin": "FR" } ], "dpdgermany": { "customsPaper": [ "A", "B", "C" ], "countryRegistrationNumber": "123456", "reasonForExport": "Gift", "exportMrn": "987654", "invoiceConsignee": { "name1": "Jhon Rossi", "street": "Via Palermo 55", "country": "IT", "zipCode": "15121", "city": "Alessandria", "contact": "Jhon Rossi", "eori": "IT123456789", "phone": "3278101234", "email": "test@gsèed.com" } }, "incoterm": { "incoterm_code": "EXW", "location": "C.So felice cavallotti 15 15121 Alessandria" } } ``` Esempio (funzionante al 15/09/2026) con i minimi dati richiesti per una spefizione verso l'Inghilterra : ```json { "labelType": "ZPL", "corriere": 46, "servizio": 0, "client_id": TUO_CLIENT_ID, "chi_paga": 0, "addebito_dogana": 0, "valore_doganale": 37.50, "ddt_alpha": "Test16587", "sender_addr": "Dorfplatz 1", "sender_cap": "01326", "sender_prov": "", "sender_city": "Dresden", "sender_contact": "Test mittente", "sender_country_code": "DE", "sender_email": "assistenza@test.net", "sender_name": "Test mittente", "sender_phone": "3278101234", "rcpt_addr": "35 Corbridge Crescent Containerville Unit 14", "rcpt_cap": "E29EZ", "rcpt_city": "London", "rcpt_contact": "Test destinatario", "rcpt_country_code": "GB", "rcpt_email": "test@gsped.com", "rcpt_name": "Test destinatario", "rcpt_phone": "3395212345", "rcpt_prov": "", "merce": "Fashion articles", "note_sender": "Questo e un test", "volume": 0.0, "origine": "IT", "valuta": "EUR", "peso": 2.0, "colli": 2, "invoice_number": "321654", "invoice_date": "2026-08-27", "dettagli_ordine": [ { "sku": "PBK1", "description": "Cosa blu", "qty": "1", "um": "PCS", "barcode_riga": "12345464", "hs_code": "123456454", "prezzo_singolo": "12.50", "peso_riga": "1", "country_of_origin": "IT" }, { "sku": "PBK12", "description": "Cosa blu e rossa", "qty": "1", "um": "BOX", "barcode_riga": "12345465", "hs_code": "123456454", "prezzo_singolo": "25.00", "peso_riga": "1", "country_of_origin": "FR" } ], "dpdgermany": { "reasonForExport": "Gift", "invoiceConsignee": { "name1": "Test Consignee", "street": "Via Palermo 55", "country": "IT", "zipCode": "15121", "city": "Alessandria", "contact": "Test Consignee", "eori": "IT123456789", "phone": "3278101234", "email": "test@gsèed.com" } }, "incoterm": { "incoterm_code": "EXW", "location": "C.So felice cavallotti 15 15121 Alessandria" } } ``` ## Spedizione B2B Nel caso la spedizione non sia destinata ad un privato, è possibile indicare il pamatro **commercialRecipient** all'interno dei dati specifici del corriere (chiave dpdgermany) : ```json "dpdgermany": { "commercialRecipient": true } ``` ## Indirizzo di restituzione per mancata consegna Per questo corriere è possibile indicare un indirizzo al quale deve essere restituita la merce i caso di mancata consegna. I dettagli dell'indirizzo possono essere indicati all'interno del parametro **returnAddress**, all'interno dei dati specifici del corriere (chiave dpdgermany) : ```json "dpdgermany": { "returnAddress": { "name1": "Test return", "street": "Via Palermo 55", "country": "IT", "zipCode": "15121", "city": "Alessandria", "contact": "Test return", "phone": "3278101234", "email": "test@gsèed.com" } } ``` ## Spedizione ad Access Point / PUDO Per questo corriere è possibile l'utilizzo degli access point. E' possibile farlo un due modalità : 1. Attraverso il campo **generic\_service\_point** indicando il codice identificativo dell'access point 2. Attraverso i dati specifici del corriere utilizzando la chiave **accessPoint,** dove è possibile indicare i seguenti dati: 1. **parcelShopId** : Codice numerico 2. **parcelShopPudoId** : Codice alfanumerico con lunghezza massima di 20 caratteri 3. **notificationChannel** : Canale attraverso il quale si prefesce che il corriere notifichi il destinatario. I valori ammessi sono : Email, Telephone, SMS La differenza tra i due metodi è che nel primo metodo non viene scelto esplicitamente il metodo di comunicazione da richiedere al corriere. Il canale verrà scelto automaticamente dai nostri sistemi in base ai dati presenti sulla spedizione, dando priorità alla mail del destintario. **Esempio caso 1 :** ```json { "labelType": "ZPL", "corriere": 46, "servizio": 1, "client_id": TUO_CLIENT_ID, "chi_paga": 0, "ddt_alpha": "test12345", "sender_addr": "Dorfplatz 1", "sender_cap": "01326", "sender_prov": "", "sender_city": "Dresden", "sender_contact": "Test mittente", "sender_country_code": "DE", "sender_email": "assistenza@scarpa.net", "sender_name": "Test mittente", "sender_phone": "3278101234", "rcpt_addr": "Herzogstandweg 7", "rcpt_cap": "84034", "rcpt_city": "Landshut", "rcpt_contact": "Test destinatario", "rcpt_country_code": "DE", "rcpt_email": "test@gsped.com", "rcpt_name": "Test destinatario", "rcpt_phone": "+49#1725673423", "rcpt_prov": "", "merce": "Fashion articles", "note_sender": "Questo e un test", "volume": 0.0, "origine": "IT", "valuta": "EUR", "peso": 2.0, "colli": 2, "generic_service_point": "DE48740" } ``` **Esempio caso 2 :** ```json { "labelType": "ZPL", "corriere": 46, "servizio": 1, "client_id": TUO_CLIENT_ID, "chi_paga": 0, "ddt_alpha": "express_IT_41", "sender_addr": "Dorfplatz 1", "sender_cap": "01326", "sender_prov": "", "sender_city": "Dresden", "sender_contact": "Test mittente", "sender_country_code": "DE", "sender_email": "assistenza@scarpa.net", "sender_name": "Test mittente", "sender_phone": "3278101234", "rcpt_addr": "Herzogstandweg 7", "rcpt_cap": "84034", "rcpt_city": "Landshut", "rcpt_contact": "Test destinatario", "rcpt_country_code": "DE", "rcpt_email": "test@gsped.com", "rcpt_name": "Test destinatario", "rcpt_phone": "+49#1725673423", "rcpt_prov": "", "merce": "Fashion articles", "note_sender": "Questo e un test", "volume": 0.0, "origine": "IT", "valuta": "EUR", "peso": 2.0, "colli": 2, "accessPoint": { "parcelShopPudoId": "DE48740", "notificationChannel": "Email" } } ``` ## Altri servizi accessori gestiti * Preavviso telefonico * Consegna al piano * Consegna al sabato Sul relativo utilizzo vedere [Shipment POST](https://apidocs.gsped.com/spedizioni-e-dintorni/shipment#shipment-post-1) ## Tipi di documenti gestiti da DPD Germany | Codice Documenti | Descrizione | | ---------------- | ------------------- | | A | Commercial invoice | | B | Pro forma invoice | | C | Export declaration | | D | EUR1 | | E | EUR2 | | F | ATR | | G | Delivery note | | H | Third party billing | | I | T1 document | # DSV ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Camionistico18510
# Dummy 1-10 ## [Trade documents](/spedizioni-e-dintorni/shipment/shipment-objects/trade_documents) **Disponibile nelle chiamate: Shipment POST e Shipment PATCH** ``` "trade_documents":[ { "nome":"COMMERCIAL_INVOICE_TESTRIF1234_1.pdf", "contenuto":"" } ] ``` ## Campi per Shipment PATCH | campo | Limitazioni | | ---------------------------------------------- | ---------------------- | | [trade\_documents](#trade-documents).nome | String | | [trade\_documents](#trade-documents).contenuto | String | | ddt\_alpha | String (minimo 1 char) | # DVAExpress ## Lista codici Gsped | Servizio | Codice corriere | Codice servizio | Note | | ------------------------------------- | --------------- | --------------- | -------------------------- | | Corriere più economico | 35 | 0 | Domestico / Internazionale | | SDA Extralarge | 35 | 1 | Domestico | | BRT Standard | 35 | 2 | Domestico | | BRT Standard 2025 | 35 | 3 | Domestico | | Crono - Poste Italiane | 35 | 4 | Domestico | | DHL Express | 35 | 5 | Domestico / Internazionale | | DHL Economy | 35 | 6 | Domestico / Internazionale | | Crono Internazionale - Poste Italiane | 35 | 7 | Internazionale | | Pacco Celere - Poste Italiane | 35 | 8 | Domestico | | Poste Delivery Business | 35 | 9 | Domestico | | Poste Delivery Business US | 35 | 10 | | | Poste Delivery Express | 35 | 11 | Domestico | | SDA Road Europe | 35 | 12 | Internazionale | | SDA Extralarge Promo | 35 | 13 | Domestico | | SDA Extralarge - SDAM | 35 | 14 | Domestico | | TNT | 35 | 15 | Domestico | | UPS Standard | 35 | 16 | Domestico / Internazionale | | UPS Expedited | 35 | 17 | Domestico / Internazionale | | UPS Standard Promo | 35 | 18 | Domestico / Internazionale | | UPS Saver | 35 | 19 | Domestico / Internazionale | | UPS Easy Expedited | 35 | 20 | Domestico / Internazionale | | UPS Easy Express | 35 | 21 | Domestico / Internazionale | | UPS Easy Saver | 35 | 22 | Domestico / Internazionale | | UPS Easy Standard | 35 | 23 | Domestico / Internazionale | # Ecourier ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Più economico250
## Trade documents ```json "trade_documents":[ { "nome":"COMMERCIAL_INVOICE_TESTRIF1234_1.pdf", "contenuto":"" } ] ``` # FedEx ## Limitazioni campi corriere | Campo | Limitazione | | ------------------- | ----------- | | ddt\_alpha | Max 40 char | | rcpt\_addr | Max 35 char | | rcpt\_cap | Max 10 char | | rcpt\_city | Max 30 char | | rcpt\_country\_code | Max 2 char | | rcpt\_name | Max 35 char | | rcpt\_prov | Max 2 char | ## Lista codici Gsped
ServizioCodice corriereCodice servizioaddParcel (pasgo)Note
Priority Overnight200trueDomestico
First201trueDomestico
Priority Express202trueDomestico
Priority203trueDomestico
Priority Express Freight204trueDomestico
Priority Freight205trueDomestico
International Priority Express206trueInternazionale
International Priority Freight207falseInternazionale
International Priority208trueInternazionale
International Connect Plus209trueInternazionale
International Economy2010trueInternazionale
International Economy Freight2011falseInternazionale
International First2012falseInternazionale
Regional Economy2016trueInternazionale
Regional Economy Freight2017trueInternazionale
International Deferred Freight2019falseinternazionale
## ICS2 Per le spedizioni non domestiche il corriere richiede obbligatoriamente che vengano valorizzati: * [dettagli\_ordine](/spedizioni-e-dintorni/shipment/shipment-objects/dettagli_ordine) * Opzionale: invoice\_number ## [Trade documents](/spedizioni-e-dintorni/shipment/shipment-objects/trade_documents) **Disponibile nelle chiamate: POST e PATCH** ```json "trade_documents":[ { "nome":"COMMERCIAL_INVOICE_TESTRIF1234_1.pdf", "contenuto":"" } ] ``` ## Export Compliance Statement Questo campo permette di inserire un numero/dichiarazione AES, permettendo all'utente di confermare spedizioni dall'America all'estero con un valore doganale superiore ai 2500 dollari. ```json "fedexrest": { "exportComplianceStatement": "AES X20240115123456" } ``` ### Spedizione verso zona residenziale È possibile indicare a FedEx se si sta spedendo verso un indirizzo residenziale ```json "rcpt_residential" : 1 ``` ### Identificativo destinatario per la dogana Campo utile per passare a FedEx un identificativo del mittente per spedizioni doganali ```json "fedexrest": { "recipientCustomsId": { "type": "PASSPORT", "value": 12345678 } } ``` I possibili valori del type e relativo valore sono i seguenti: | type | value | | ---------- | -------------------------------------- | | PASSPORT | Numero del passaporto del destinatario | | INDIVIDUAL | Codice fiscale del destinatario | | COMPANY | Partita iva del destinatario | ### Forzatura tins per lo shipper ```json "fedexrest": { "shipper": { "tins": { "tinType": "BUSINESS_UNION", "number": "IT12345678901" } } } ``` Possibili valori per il tinType: * BUSINESS\_NATIONAL * BUSINESS\_STATE * BUSINESS\_UNION * PERSONAL\_NATIONAL * PERSONAL\_STATE {% hint style="warning" %} **ATTENZIONE!** Questo parametro va in sovrascrittura di un eventuale EORI configurato per il sender {% endhint %} ### Forzatura rateRequestType ```json "fedexrest": { "rateRequestType": "ACCOUNT" } ``` Possibili valori: * LIST * INCENTIVE * ACCOUNT * PREFERRED * RETAIL Default: ACCOUNT ### Dettagli dangerousGoods ```json "fedexrest": { "dangerousGoodsDetail": { "accessibility": "ACCESSIBLE", "cargoAircraftOnly": true } } ``` Valori possibili: | campo | valori | | ----------------- | ----------------------- | | accessibility | ACCESSIBLE/INACCESSIBLE | | cargoAircraftOnly | true/false | ## Gestione documenti Per alcune destinazioni è obbligatorio allegare documenti doganali alla spedizione. #### Caricamento dei documenti elettronici contestualmente alla creazione della spedizione Soluzione da privilegiare, quanto possibile, aggiungendo la sezione trade\_documents alla shipment POST #### Caricamento postumo dei documenti elettronici Nel caso si voglia allegare in un secondo momento i documenti elettronici è possibile farlo aggiungendo il seguente parametro in Shipment POST. Vedi pagina dedicata qui: {% content-ref url="/pages/mJs8XwbrGAIhJjZ2Rgcq" %} [uploadDocAfterwards](/spedizioni-e-dintorni/shipment/shipment-objects/courierdata/uploaddocafterwards) {% endcontent-ref %} Con l'aggiunta di questo parametro se gli ETD fossero obbligatori la spedizione viene creata ugualmente ma è assolutamente necessario procedere con il caricamento dei documenti mediante shipment PATCH. Senza il caricamento dei documenti c'è la possibilità che la merce venga bloccata in dogana. {% hint style="danger" %} Vecchio metodo deprecato: ``` "fedexrest": { "willUploadDocAfterShipment": true } ``` {% endhint %} #### Aggiunta dei documenti in formato cartaceo Modalità sconsigliata, ma se inevitabile contattare l'assistenza per poter abiltare la funzionalità. {% hint style="danger" %} **Attenzione!!!** Con la modalità ***pasgo*** attiva il caricamento postumo del documento ( ***uploadDocAfterWards*** ) è implicito quindi è **SEMPRE** responsabilità del cliente caricare i documenti elettronici per le destinazioni che lo richiedono **PRIMA** di confermare la spedizione. {% endhint %} # Fercam ## Limitazioni campi corriere | Campo | Limitazione | | ------------------- | ----------- | | ddt\_alpha | Max 35 char | | rcpt\_addr | Max 35 char | | rcpt\_cap | Max 8 char | | rcpt\_city | Max 25 char | | rcpt\_country\_code | Max 2 char | | rcpt\_name | Max 20 char | | rcpt\_prov | Max 2 char | ## Lista codici Gsped A gennaio 2026 Fercam ha rinominato i propri servizi nell'ambito dell'integrazione con DACHSER. I codici servizio Gsped non cambiano: è variata solo la denominazione, riportata di seguito con il nome precedente tra parentesi.
ServizioCodice corriereCodice servizioNote
Speed & Book1310Domestico. Deprecato, vedi Prenotazione telefonica e servizio Book
Targo Fix (ex Fix)1311Domestico
Targo Flex (ex Flex)1312Domestico
Targo Speed (ex Speed)1313Domestico
Targo On site (ex Private)1315Domestico
Speed & Book Internazionale1316Internazionale. Deprecato, vedi Prenotazione telefonica e servizio Book
Targo Fix Internazionale (ex Fix Internazionale)1317Internazionale
Targo Flex Internazionale (ex Flex Internazionale)1318Internazionale
Targo Speed Internazionale (ex Speed Internazionale)1319Internazionale
Home delivery13120Vedere sezione dedicata
## Prenotazione telefonica e servizio Book Il corriere ha dismesso il servizio Book: la prenotazione telefonica non è più un servizio a sé stante, ma un accessorio attivabile su qualunque servizio, Targo Fix e Targo Speed compresi. Per richiederla è sufficiente valorizzare il campo `preavviso_telefonico` con `S`, indicando il recapito del destinatario in `rcpt_phone`. I codici servizio 0 e 6 restano accettati per compatibilità, ma per le nuove integrazioni usare Targo Flex (2 e 8) o Targo Speed (3 e 9) insieme a `preavviso_telefonico`. ## Fercam home delivery Per questo tipo di consegna il corriere richiede informazioni sulle operazioni di installazione/montaggio dei prodotti consegnati. Nella chiamata alla Shipment POST andrà incluso un array di oggetti denominato fercam\_hd. ```json "fercam_hd":[ { "assembly_type":"", "qty":"", "code":"", "description":"" } ] ``` Per ogni oggetto dovranno essere indicate le seguenti informazioni:
CampoRequiredTypeDescrizione
assembly_typetruestringcodifica Fercam del tipo di operazione da fare a destino
qtytrueintnumero di installazioni da fare per l'assembly_type
codetruestringcodice del prodotto da installare
descriptiontruestringdescrizione del prodotto da installare
# Ferrari Trasporti ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Nazionale1900Domestico
Internazionale1906Internazionale
## [Trade documents](/spedizioni-e-dintorni/shipment/shipment-objects/trade_documents) **Disponibile nelle chiamate: Shipment POST e Shipment PATCH** ``` "trade_documents":[ { "nome":"COMMERCIAL_INVOICE_TESTRIF1234_1.pdf", "contenuto":"" } ] ``` ## Campi per Shipment PATCH | campo | Limitazioni | | ---------------------------------------------- | ---------------------- | | [trade\_documents](#trade-documents).nome | String | | [trade\_documents](#trade-documents).contenuto | String | | ddt\_alpha | String (minimo 1 char) | # Geodis ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Messagerie France - Mess.plus230Domestico
Messagerie Europe - Eurofirst231Internazionale
# Grendi ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Collettame420Domestico
# Gruber ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
MyGreen411Domestico
MyDelivery412Domestico
MyBooking413Domestico
MyFast414Domestico
# Glovo ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
On demand140Domestico
# GLS ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Espresso1010Domestico
Espresso ore 12:001012Domestico
Express121013Domestico
Parcel1016Internazionale
## CIN Per le spedizioni extraUe il corriere richiede obbligatoriamente che vengano valorizzati: * [dettagli\_ordine](/spedizioni-e-dintorni/shipment/shipment-objects/dettagli_ordine) * invoice\_date * invoice\_number Ricordarsi di indicare a Gsped la **categoria merceologica** da inserire in configurazione sul proprio client\_id / invoiced\_client\_id.\ Categorie merceologiche al 14/05/2024:
## Shipment PATCH Di seguito l'elenco dei campi patchabili: ```json { "ddt_alpha":"XXXXX", "contrassegno":0.0, "valore_doganale":0.0, "tipo_incasso":12 } ``` # GLS France ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Standard17720
FlexDeliveryService17721
ShopDeliveryService17722
ExpressParcelGuaranteed17723
PharmaService17724
# GLS Spain ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
COURIER 14:00 Service15620
COURIER BusinessParcel15621
COURIER 10:00 Service15622
COURIER SaturdayService15623
COURIER MASIVO15624
COURIER REC. EN NAVE15625
ECONOMY PARCEL15626
CARGA MARITIMO15627
COURIER ParcelShop15628
ECONOMY PARCEL ParcelShop15629
EUROBUSINESS PARCEL EBP15630
EUROBUSINESS SMALL PARCEL EBP15631
ASM TRAVELLERS ASM TRAVELLERS15632
RECOGIDA BusinessParcel15633
DEVOLUCION BusinessParcel15634
RETORNO BusinessParcel15635
RC.SELLADA BusinessParcel15636
# HR Parcel ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Standard1590
# Inpost ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Hub to InPost Point150integrazione lambda
Return With Label151integrazione lambda
Return Without Label152integrazione lambda
Consegna PUDO da magazzino158integrazione mondial relay
Consegna PUDO da PUDO1511integrazione mondial relay
Address to Address1520Integrazione inpost rest
Point to Point1521Integrazione inpost rest
Address to Point1522Integrazione inpost rest
Point to address1523Integrazione inpost rest
## Ricerca PUDO
IntegrazionePagina per il recupero dei PUDO
inpost lambda
inpost mondial relayhttps://www.mondialrelay.fr/trouver-le-point-relais-le-plus-proche-de-chez-moi/
inpost resthttps://geowidget.inpost-group.com/
# Italsempione ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Nazionale900Domestico
Internazionale906Internazionale
## [Trade documents](/spedizioni-e-dintorni/shipment/shipment-objects/trade_documents) **Disponibile nelle chiamate: Shipment POST e Shipment PATCH** ``` "trade_documents":[ { "nome":"COMMERCIAL_INVOICE_TESTRIF1234_1.pdf", "contenuto":"" } ] ``` ## Campi per Shipment PATCH | campo | Limitazioni | | ---------------------------------------------- | ---------------------- | | [trade\_documents](#trade-documents).nome | String | | [trade\_documents](#trade-documents).contenuto | String | | ddt\_alpha | String (minimo 1 char) | # Liccardi ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Espresso1790Domestico
Espresso STD1791Domestico
Bancale1792Domestico
# Lynx ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Nazionale950Domestico
## [Trade documents](/spedizioni-e-dintorni/shipment/shipment-objects/trade_documents) **Disponibile nelle chiamate: Shipment POST e Shipment PATCH** ``` "trade_documents":[ { "nome":"COMMERCIAL_INVOICE_TESTRIF1234_1.pdf", "contenuto":"" } ] ``` ## Campi per Shipment PATCH | campo | Limitazioni | | ---------------------------------------------- | ---------------------- | | [trade\_documents](#trade-documents).nome | String | | [trade\_documents](#trade-documents).contenuto | String | | ddt\_alpha | String (minimo 1 char) | # Logisticando ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Nazionale910Domestico
Internazionale916Internazionale
## [Trade documents](/spedizioni-e-dintorni/shipment/shipment-objects/trade_documents) **Disponibile nelle chiamate: Shipment POST e Shipment PATCH** ``` "trade_documents":[ { "nome":"COMMERCIAL_INVOICE_TESTRIF1234_1.pdf", "contenuto":"" } ] ``` ## Campi per Shipment PATCH | campo | Limitazioni | | ---------------------------------------------- | ---------------------- | | [trade\_documents](#trade-documents).nome | String | | [trade\_documents](#trade-documents).contenuto | String | | ddt\_alpha | String (minimo 1 char) | # MBE {% hint style="warning" %} Su Gsped sono presenti 2 integrazioni di MBE: * MBE -> deprecata * MBE 2.0 -> nuova implementazione {% endhint %} ## Lista codici Gsped MBE 2.0
ServizioCodice corriereCodice servizioNote
MBE DHL DH3 Express 10:3018320
MBE Morning DHL Express 10:3018321
MBE Morning DHL Express 1218322
MBE DHL DH4 Express 1218323
MBE DHL DH2 Express 10:3018324
MBE DHL DH1 Express18325
MBE DHL DH6 Express 0918326
MBE DHL DH7 Express 0918327
MBE DHL DHN Express18328
MBE DHL DHC Economy Select18329
MBE FedEx FPF Priority Freight18330
MBE FedEx FIP Priority18331
MBE FedEx FEF Economy Freight18332
MBE FedEx FIE Economy18333
MBE GLS GL2 Light Express 1218334
MBE GLS GL4 Express 1218335
MBE GLS GL1 Light Express18336
MBE GLS GL3 Express18337
MBE SDA SE0 ExtraLarge 1018338
MBE SDA SE2 ExtraLarge 1218339
MBE SDA SE9 ExtraLarge 0918340
MBE SDA SEX ExtraLarge18341
MBE TNT TI3 Express 1218342
MBE TNT T12 Express 1218343
MBE TNT TI2 Express18344
MBE TNT TNE Express18345
MBE TNT T09 Express 0918346
MBE TNT TI5 Express 0918347
MBE TNT TI4 Express 1018348
MBE TNT T10 Express 1018349
MBE TNT TNC Economy Express18350
MBE TNT TI1 Economy Express18351
MBE Morning UPS Express18352
MBE UPS USA Express Saver18353
MBE UPS UEP Express Plus18354
MBE UPS UST Standard18355
MBE UPS UED Expedited18356
MBE Standard18357
MBE Express18358
MBE Express Internazionale18359
MBE Standard Internazionale18360
## Lista codici Gsped MBE
ServizioCodice corriereCodice servizioNote
Economy1501
Standard1502
# Milkman ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Standard1290Domestico
Premium1291Domestico
# Monaci Trasporti ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Domestico320
## Campi per Shipment PATCH | campo | Limitazioni | | ---------- | ---------------------- | | ddt\_alpha | String (minimo 1 char) | # Nacex ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
NACEX 10:00H16020
NACEX 12:00H16021
INTERDIA mañana16022
INTERDIA tarde16023
INTERDIA aéreo16024
PLUS BAG 116025
PLUS BAG 216026
VALIJA16027
VALIJA IDA Y VUELTA16028
NACEX 19:00H16029
PUENTE URBANO mañana16030
PUENTE URBANO tarde16031
PUENTE URBANO nocturno16032
DEVOLUCION ALBARAN CLIENTE16033
NACEX 08:30H16034
DEVOLUCION TALON16035
DEVOLUCION PLUS BAG 116036
DEVOLUCION PLUS BAG 216037
DEVOLUCION E-NACEX16038
NACEX SABADO16039
CANARIAS MARITIMO16040
CANARIAS 24H16041
PLUS PACK16042
E-NACEX16043
PREMIUM16044
# Nexive ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Sistema Completo1140
Sistema SLIM1141
Sistema ECONOMY1142
Sistema ESPRESSO1143
# Paack ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Same-day delivery - Timeslot available - 2 hours160
Next-day delivery - Timeslot available - 2 hours161
Precise-day delivery - Timeslot available - 2 hours162
Two-day delivery - Timeslot available - 2 hours163
Any-day delivery - Timeslot available - 2 hours164
Return - Timeslot available - 2 hours165
Same-day delivery - Timeslot available - 3 hours166
Same-day delivery - Timeslot available - 4 hours167
Next-day delivery - Timeslot available - 4 hours168
Precise-day delivery - Timeslot available - 4 hours169
Two-day delivery - Timeslot available - 4 hours1610
Any-day delivery - Timeslot available - 4 hours1611
Return - Timeslot available - 4 hours1612
Next-day delivery - Timeslot available - morning or evening slots1613
Precise-day delivery - Timeslot available - morning or evening slots1614
Two-day delivery - Timeslot available - morning or evening slots1615
Any-day delivery - Timeslot available - morning or evening slots1616
Precise-day delivery - Timeslot available - All day1617
Same-day delivery - Timeslot available - Other1618
Next-day delivery - Timeslot available - Other1619
Precise-day delivery - Timeslot available - Other1620
Two-day delivery - Timeslot available - Other1621
Any-day delivery - Timeslot available - Other1622
Store model delivery with timeslot not specified1623
Same-day delivery - Fixed timeslot - 2 hours1624
Next-day delivery - Fixed timeslot - 2 hours1625
Precise-day delivery - Fixed timeslot - 2 hours1626
Two-day delivery - Fixed timeslot - 2 hours1627
Any-day delivery - Fixed timeslot - 2 hours1628
Same-day / express delivery - Fixed timeslot - 2 hours1629
Same-day delivery - Fixed timeslot - 4 hours1630
Next-day delivery - Fixed timeslot - 4 hours1631
Precise-day delivery - Fixed timeslot - 4 hours1632
Two-day delivery - Fixed timeslot - 4 hours1633
Any-day delivery - Fixed timeslot - 4 hours1634
Same-day / express delivery - Fixed timeslot - 4 hours1635
Next-day delivery - Fixed timeslot - All day1636
Precise-day delivery - Fixed timeslot - All day1637
Two-day delivery - Fixed timeslot - All day1638
Any-day delivery - Fixed timeslot - All day1639
Return - Fixed timeslot - All day1640
Next-day delivery - Fixed timeslot - Other1641
Precise-day delivery - Fixed timeslot - Other1642
Two-day delivery - Fixed timeslot - Other1643
Any-day delivery - Fixed timeslot - Other1644
Same-day / express delivery - Fixed timeslot - Other1645
Same-day (legacy)1646
Next-day (legacy)1647
Defined-day delivery (legacy)1648
# Palletways ## Lista codici Gsped | Servizio | Codice corriere | Codice servizio | Note | | ----------------------------------------- | --------------- | --------------- | -------------- | | PREMIUM - 24h | 176 | 0 | Domestico | | PREMIUM - 24h GDO | 176 | 1 | Domestico | | PREMIUM - 24h TIMED | 176 | 2 | Domestico | | PREMIUM - 48h | 176 | 3 | Domestico | | PREMIUM - 48h GDO | 176 | 4 | Domestico | | PREMIUM - 48h TIMED | 176 | 5 | Domestico | | PREMIUM - 72h | 176 | 6 | Domestico | | PREMIUM - 72h GDO | 176 | 7 | Domestico | | PREMIUM - 72h TIMED | 176 | 8 | Domestico | | ECONOMY - 48h | 176 | 9 | Domestico | | ECONOMY - 48h TIMED | 176 | 10 | Domestico | | ECONOMY - 72h | 176 | 11 | Domestico | | ECONOMY - 72h GDO | 176 | 12 | Domestico | | ECONOMY - 72h TIMED | 176 | 13 | Domestico | | ECONOMY - 96h | 176 | 14 | Domestico | | ECONOMY - 96h GDO | 176 | 15 | Domestico | | ECONOMY - 96h TIMED | 176 | 16 | Domestico | | EUROPE PREMIUM - 2 GIORNI | 176 | 17 | Internazionale | | EUROPE PREMIUM - 3 GIORNI | 176 | 18 | Internazionale | | EUROPE PREMIUM - 4 GIORNI | 176 | 19 | Internazionale | | EUROPE PREMIUM - 5 GIORNI | 176 | 20 | Internazionale | | EUROPE PREMIUM - 6 GIORNI | 176 | 21 | Internazionale | | EUROPE PREMIUM - 7 GIORNI | 176 | 22 | Internazionale | | EUROPE PREMIUM - 3 GIORNI TIMED | 176 | 23 | Internazionale | | EUROPE PREMIUM - 4 GIORNI TIMED | 176 | 24 | Internazionale | | EUROPE PREMIUM - 5 GIORNI TIMED | 176 | 25 | Internazionale | | EUROPE PREMIUM - 6 GIORNI TIMED | 176 | 26 | Internazionale | | EUROPE PREMIUM - 7 GIORNI TIMED | 176 | 27 | Internazionale | | EUROPE PREMIUM - 2 GIORNI MATTINA | 176 | 28 | Internazionale | | EUROPE PREMIUM - 3 GIORNI MATTINA | 176 | 29 | Internazionale | | EUROPE PREMIUM - 4 GIORNI MATTINA | 176 | 30 | Internazionale | | EUROPE PREMIUM - 5 GIORNI MATTINA | 176 | 31 | Internazionale | | EUROPE PREMIUM - 6 GIORNI MATTINA | 176 | 32 | Internazionale | | EUROPE PREMIUM - 7 GIORNI MATTINA | 176 | 33 | Internazionale | | FREE - DELIVERY CURTAINS | 176 | 34 | Domestico | | FREE - RESO DANNO | 176 | 35 | Domestico | | FREE - RESO EPAL | 176 | 36 | Domestico | | EUROPE ECONOMY - 5 GIORNI | 176 | 37 | Internazionale | | EUROPE ECONOMY - 3 GIORNI | 176 | 38 | Internazionale | | EUROPE ECONOMY - 4 GIORNI | 176 | 39 | Internazionale | | EUROPE ECONOMY - EUROPE COLLECT ECONOMY | 176 | 40 | Internazionale | | EUROPE ECONOMY - 6 GIORNI | 176 | 41 | Internazionale | | EUROPE ECONOMY - 7 GIORNI | 176 | 42 | Internazionale | | EUROPE ECONOMY - 8 GIORNI | 176 | 43 | Internazionale | | EUROPE ECONOMY - 7 GIORNI TIMED | 176 | 44 | Internazionale | | EUROPE ECONOMY - 3 GIORNI TIMED | 176 | 45 | Internazionale | | EUROPE ECONOMY - 4 GIORNI TIMED | 176 | 46 | Internazionale | | EUROPE ECONOMY - 5 GIORNI TIMED | 176 | 47 | Internazionale | | EUROPE ECONOMY - 6 GIORNI TIMED | 176 | 48 | Internazionale | | EUROPE ECONOMY - 8 GIORNI TIMED | 176 | 49 | Internazionale | | EUROPE ECONOMY - 3 GIORNI MATTINA | 176 | 50 | Internazionale | | EUROPE ECONOMY - 4 GIORNI MATTINA | 176 | 51 | Internazionale | | EUROPE ECONOMY - 5 GIORNI MATTINA | 176 | 52 | Internazionale | | EUROPE ECONOMY - 6 GIORNI MATTINA | 176 | 53 | Internazionale | | EUROPE ECONOMY - 7 GIORNI MATTINA | 176 | 54 | Internazionale | | EUROPE ECONOMY - 8 GIORNI MATTINA | 176 | 55 | Internazionale | | EUROPE ECONOMY - EUROPE COLLECT GROUPAGE | 176 | 56 | Internazionale | | EUROPE ECONOMY - EUROPE DELIVERY GROUPAGE | 176 | 57 | Internazionale | # Pitagorando ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Nazionale370Domestico
Internazionale376Internazionale
## [Trade documents](/spedizioni-e-dintorni/shipment/shipment-objects/trade_documents) **Disponibile nelle chiamate: Shipment POST e Shipment PATCH** ``` "trade_documents":[ { "nome":"COMMERCIAL_INVOICE_TESTRIF1234_1.pdf", "contenuto":"" } ] ``` ## Campi per Shipment PATCH | campo | Limitazioni | | ---------------------------------------------- | ---------------------- | | [trade\_documents](#trade-documents).nome | String | | [trade\_documents](#trade-documents).contenuto | String | | ddt\_alpha | String (minimo 1 char) | # Poletto Group ## Lista codici Gsped | Servizio | Codice corriere | Codice servizio | Note | | -------------- | --------------- | --------------- | -------------------------- | | Standard | 40 | 0 | Domestico / Internazionale | | Standard Timed | 40 | 1 | Domestico / Internazionale | | Non Stop | 40 | 2 | Domestico / Internazionale | | Non Stop Timed | 40 | 3 | Domestico / Internazionale | ## Segnacolli custom Questo corriere permette di utilizzare i propri segnacolli al posto di quelli forniti dal corriere. I segnacolli possono essere indicati all'interno dei dettagli dei colli, nel campo **label\_barcode** : ```json "daticolli": [ { "altezza": 25, "larghezza": 33, "lunghezza": 35, "volume": 0.028875, "peso": 3.75, "label_barcode": "lblCustom-1" }, { "altezza": 25, "larghezza": 33, "lunghezza": 35, "volume": 0.028875, "peso": 3.75, "label_barcode": "lblCustom-2" } ] ``` Nel caso particolari non si abbiano i dettagli dei colli (peso, volume, dimensioni) è possibile indicare solo i segnacolli all'interno dei dati specifici per poletto : ```json "poletto": { "segnacolli": [ "lblCustom-1", "lblCustom-2" ] } ``` {% hint style="warning" %} **ATTENZIONE:** Il numero di segnacolli **DEVE** coincidere con il numero totale di colli della spedizione {% endhint %} Di seguito un esempio di un etichetta che riporta il proprio barcode
### Segnacollo custom in fase di Add Parcel Anche in fase di add parcel è possibile utilizzare i propri segnacolli. Nella chiamata di aggiunta di un nuovo collo attraverso l'endpoint Parcels (POST) basterà aggiungere il parametro **label\_barcode** all'interno dei dettagli del collo. Esempio : ```json { "id_sped":ID_SPEDIZIONE, "collo": { "peso": "4.71", "volume": "0.02", "larghezza": "20", "altezza": "21", "lunghezza": "22", "label_barcode": "lblCustom-3" } } ``` ## Merce Lunga Per richiedere il servizio accessorio, inserire nella richiesta di creazione spedizione quanto segue : ```json "poletto": { "merceLunga": true } ``` ## Consegna in cantina Per richiedere il servizio accessorio, inserire nella richiesta di creazione spedizione quanto segue : ```json "poletto": { "inCantina": true } ``` ## Consegna al piano Il corriere offre tre modalità : * Scarico a terra / facchinaggio * consegna al primo piano * consegna al secondo piano * consegna al terzo piano o superiore Per richiedere uno di questi servizi basterà utilizzare il campo **consegnaAlPiano** indicante il numero del piano in cui si vuole la consegna al piano, ovvero : * 0 per la consegna al piano terra * 1 per la consegna al primo piano * 2 per la consegna al secondo piano * 0 per la consegna al terzo piano o superiore Esempio di richiesta di consegna al secondo piano : ```json "poletto": { "consegnaAlPiano": 2 } ``` ## Prenotazione su portale Per richiedere il servizio accessorio, inserire nella richiesta di creazione spedizione quanto segue : ```json "poletto": { "prenotazioneSuPortale": true } ``` ## Avviso di consegna in itinere Per richiedere il servizio accessorio, inserire nella richiesta di creazione spedizione quanto segue : ```json "poletto": { "preavviso_itinere": true } ``` ## ZTL Per richiedere il servizio accessorio, inserire nella richiesta di creazione spedizione quanto segue : ```json "poletto": { "ztl": true } ``` ## GDO Per richiedere il servizio accessorio, inserire nella richiesta di creazione spedizione quanto segue : ```json "poletto": { "gdo": true } ``` ## Altri servizi accessori Oltre ai servizi accessori specifici per Da Rold, gestiamo anche i seguenti servizi accessori :
* Prenotazione telefonica :\ \ Utilizzare il campo **preavviso\_telefonico** valorizzato a "S".\ \ In questo caso il corriere prevede che venga indicato il numero di telefono del destinatario o che nelle note venga indicato l'url dove il corriere deve eseguire la prenotazione.
* Sponda Idraulica : \ \ Utilizzare il campo **sponda** valorizzato a true.
* Contrassegno : \ \ Utilizzare il campo **contrassegno** per indicare l'importo ed il campo **tipo\_incasso** per indicare la modalità in cui il corriere deve riscuotere il conttrassegno.
Sono ammessi solo i seguenti codici di tipo\_incasso : * Contanti : 0, 12 * Assegno intestato al mittente : 10, 11, 15
* Assicurazione : \ \ Utilizzare il campo **valore** per riportare il valore complessivo da assicurare. ## Cancellazione spedizione Il corriere non prevede un'opzione di annullamento. Di conseguenza, non è possibile cancellare le spedizioni già generate correttamente. # Poste CH ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
PostPac Priority15810
PostPac Priority + Signature15811
PostPac Priority + Signature (Insurance)15812
# Poste Delivery Business {% hint style="warning" %} PDB è disponibile con due tecnologie differenti in Gsped: * PDB Inviosystem (19) * solo domestico * permette AddParcel * va chiesta specifica attivazione a Poste * PDB WS (166) * domestico ed internazionale * non permette AddParcel {% endhint %} ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Standard190Domestico
Express191Domestico
Express ore 9192Domestico
Express ore 10193Domestico
Express ore 12194Domestico
## Lista codici Gsped PDB WS
ServizioCodice corriereCodice servizioNote
Standard1660Domestico
Express1661Domestico
Standard internazionale1666Internazionale
Express internazionale1667Internazionale
International Plus1668Internazionale
## Internazionale ### ICS2 (CIN) Per le spedizioni extraUE il corriere richiede **obbligatoriamente** che vengano valorizzati: * ddt\_alpha * [dettagli\_ordine](/spedizioni-e-dintorni/shipment/shipment-objects/dettagli_ordine) * invoice\_date * invoice\_number ### [carrierData](/spedizioni-e-dintorni/shipment/shipment-objects/carrierdata) ``` "carrierData": { "shipmentNumber": "XXXXXXXXXXXXXXX" } ```
CampoTypeDescrizione
shipmentNumberstring(IN RISPOSTA) Numero di spedizione del corriere che si occuperà del trasporto internazionale
# QHD ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Standard1540
# Rhenus Logistics ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Fix Nazionale1930
Premium Nazionale1931
Standard Nazionale1932
Fix Internazionale1936
Premium Internazionale1937
Standard Internazionale1938
## Campi per Shipment PATCH | campo | Limitazioni | | ---------- | ---------------------- | | ddt\_alpha | String (minimo 1 char) | # Ribosped ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Nazionale930Domestico
## [Trade documents](/spedizioni-e-dintorni/shipment/shipment-objects/trade_documents) **Disponibile nelle chiamate: Shipment POST e Shipment PATCH** ``` "trade_documents":[ { "nome":"COMMERCIAL_INVOICE_TESTRIF1234_1.pdf", "contenuto":"" } ] ``` ## Campi per Shipment PATCH | campo | Limitazioni | | ---------------------------------------------- | ---------------------- | | [trade\_documents](#trade-documents).nome | String | | [trade\_documents](#trade-documents).contenuto | String | | ddt\_alpha | String (minimo 1 char) | # San Marino Mail ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
AT_DPD_PRIME_GEN16320
AT_POST_058416321
BE_G3_STA16322
CH_SWP_PPECO16323
DE_490_WINE16324
DE_DHL_STA_POST16325
DE_DPD_B2C16326
DE_HERM_DROPOFF16327
DE_HERM_STA16328
DE_HERM_WINE16329
ES_CORR_DROPOFF16330
ES_CORR_STA16331
FR_GLS_ADO16332
FR_GLS_STA16333
FR_GLS_WINE16334
FR_LPF_OTH16335
FR_MONDIAL_DROPOFF16336
INT_DHL_ECO16337
INT_DHL_EXPMB16338
IT_GLS_LIGHT16339
IT_SDA_MULTI16340
NL_G3_STA16341
PT_CORR_RAN16342
# SDA ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Extralarge1050Domestico
CRONO1051Domestico
CRONO Express1052Domestico
CRONO Economy1053Domestico
CRONO Reverse1054Domestico
CRONOPLUS1055Domestico
EXPORT BOX1056Internazionale
ROAD EUROPE - EURODIS1057Internazionale
CRONO Internazionale1058Internazionale
# Sendabox ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
Nazionale1880Domestico
Internazionale1886Internazionale
# Sending ## Lista codici Gsped
ServizioCodice corriereCodice servizioNote
01 SEND EXPRES1920
02 SEND TOP 10h1921
03 SEND SECTORIAL1922
08 SEND ECOMMERCE1924
17 SEND INTERNACIONAL CARGA1925
18 SEND MARITIMO1926
22 SEND TOP 8:301927
40 SEND OPTICA1928
## Campi per Shipment PATCH | campo | Limitazioni | | ---------- | ---------------------- | | ddt\_alpha | String (minimo 1 char) | --- [Next Page](/llms-full.txt/1)