> For the complete documentation index, see [llms.txt](https://apidocs.gsped.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.gsped.com/spedizioni-e-dintorni/shipment/corrieri/dpd-germany.md). # 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 |