> 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/gsped-api-english-version/spedizioni-e-dintorni/shipment/corrieri/dpd-germany.md). # DPD Germany ## Gsped code list | Service | Courier code | Service code | | ------------------------- | ------------ | ------------ | | 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 | ## Non-EU shipments For shipments outside the European Union the courier may require all the information that can be useful to customs. The fields to give when creating the shipment include: * **invoice\_number**: Invoice number * **invoice\_date**: Invoice date in YYYY-MM-DD format * **dettagli\_ordine:** Array with the details of the items being shipped * Incoterm data. See [Incoterms](https://apidocs.gsped.com/gsped-api-english-version/spedizioni-e-dintorni/shipment/shipment-objects/incoterm) * Courier-specific data to give inside the **dpdgermany** key: * **customsPaper**: Accompanying documents accepted by DPD. See [#document-types-handled-by-dpd-germany](#document-types-handled-by-dpd-germany "mention") * **countryRegistrationNumber**: Registration information in the destination country:\ Registration number or FDA * **reasonForExport**: The reason for export must be one of Sale, Return or Gift * **exportMrn**: Identification code of the electronic export declaration * **invoiceConsignee**: Invoice account fields * **name1** * **street** * **country** * **zipCode** * **city** * **contact** * **eori** * **phone** * **email** Below is an example payload for the Shipment endpoint with the data we currently handle: ```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" } } ``` Example (working as of 15/09/2026) with the minimum data required for a shipment to England: ```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" } } ``` ## B2B shipment If the shipment is not destined to a private individual, you can set the **commercialRecipient** parameter inside the courier-specific data (key dpdgermany): ```json "dpdgermany": { "commercialRecipient": true } ``` ## Return address for failed delivery For this courier you can give an address to which the goods must be returned in case of failed delivery. The address details can be given in the **returnAddress** parameter, inside the courier-specific data (key 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" } } ``` ## Shipment to an Access Point / PUDO For this courier you can use access points. You can do this in two ways: 1. Through the **generic\_service\_point** field, giving the identification code of the access point 2. Through the courier-specific data using the **accessPoint** key, where you can give the following data: 1. **parcelShopId**: Numeric code 2. **parcelShopPudoId**: Alphanumeric code with a maximum length of 20 characters 3. **notificationChannel**: Channel through which you prefer the courier to notify the recipient. Allowed values are: Email, Telephone, SMS The difference between the two methods is that in the first one the communication method to request from the courier is not chosen explicitly. The channel will be chosen automatically by our systems based on the data in the shipment, giving priority to the recipient's email. **Example case 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" } ``` **Example case 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" } } ``` ## Other accessory services handled * Phone notice * Floor delivery * Saturday delivery For how to use them, see [Shipment POST](/gsped-api-english-version/spedizioni-e-dintorni/shipment.md#shipment-post-1) ## Document types handled by DPD Germany | Document code | Description | | ------------- | ------------------- | | 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 |