Szczegóły techniczne dotyczące wdrożenia:
- PLT (PaperlessTrade)
- sekcji celnej/deklaracji eksportowej (CIN)

w integracji opartej o MyDHL API REST v.2

Opis zawiera wdrożenie PLT (PaperlessTrade) z opcją BypassPLTError
(last updated: 2024-10-25)


BypassPLTError to funkcjonalność-opcja, która pozwala wysyłać requesty do API z usługą PLT (WY) - niezależnie od tego, czy ta usługa jest dostępna pomiędzy krajami Nadawcy i Odbiorcy (niedostępność całkowita lub wynikająca z przekroczenia limitu wartości przesyłki).

Po stronie API następuje weryfikacja dostępności usługi:
  • Jeżeli usługa PLT jest dostępna - tworzony jest list przewozowy z usługą PLT (WY) - nie ma potrzeby dołączać wydrukowanej faktury.
  • Jeżeli usługa PLT nie jest dostępna - tworzony jest list przewozowy z usługą ADI (PJ) - niezbędne jest dołączenie do przesyłki wydrukowanej faktury, która jest niezbędna do odprawy celnej importowej w kraju przeznaczenia.

W obu powyższych przypadkach do systemów DHL transmitowany jest obraz faktury wystarczający do odprawy exportowej przesyłki.

W przypadku zmiany przez API usługi PLT(WY) na ADI(PJ) z powodu niedostępności usługi PLT, w odpowiedzi z API pojawi się stosowny komunikat:
"warnings": [
                        "7988: Please note on printing the hardcopy of all the shipment paperwork and affix it to the package."
                    ]

UWAGA: Użycie BypassPLTError wymaga dodania parametru bypassPLTError=true w adresie:

Środowisko testowe: https://express.api.dhl.com/mydhlapi/test/shipments?bypassPLTError=true
Środowisko produkcyjne: https://express.api.dhl.com/mydhlapi/shipments?bypassPLTError=true

Poniżej przykłady requestów w zależności od "źródła pochodzenia" faktury (własna / generowana przez API):

  • 1. Własne faktury - Obraz(y) własnych faktur + sekcja celna

    Załączone elektroniczne obrazy własnych faktur (maksymalnie 2MB na jeden obraz) + uzupełniona sekcja celna

    pobierz plik
    {
    "plannedShippingDateAndTime": "2025-05-27T20:00:00 GMT+01:00",
    "pickup": {
        "isRequested": false
    },
    "productCode": "P",
    "getRateEstimates": true,
    "accounts": [
        {
            "number": "{{account}}",
            "typeCode": "shipper"
        }
    ],
    "valueAddedServices": [
        {
            "serviceCode": "WY"
        }
        /* Neutral Delivery Service - Importer details needed
        ,
        {
            "serviceCode": "NN"
        }
        */
    ],
    "outputImageProperties": {
        "encodingFormat": "pdf",
        "imageOptions": [
            {
                "typeCode": "invoice",
                "invoiceType": "commercial",
                "isRequested": false
            },
            {
                "typeCode": "waybillDoc",
                "hideAccountNumber": false,
                "isRequested": true
            },
            {
                "typeCode": "label",
                "templateName": "ECOM26_84_001",
                "isRequested": true,
                "renderDHLLogo": true
            }
        ],
        "splitTransportAndWaybillDocLabels": false
    },
    "customerReferences": [
        {
            "value": "Shipment Reference",
            "typeCode": "CU"
        }
    ],
    "customerDetails": {
        "shipperDetails": {
            "postalAddress": {
                "cityName": "KATY WROCLAWSKIE",
                "countryCode": "PL",
                "postalCode": "55080",
                "addressLine1": "Legionow Street",
                "addressLine2": "bldg 567",
                "addressLine3": "line 3"
            },
            "contactInformation": {
                "email": "shipper@email.com",
                "phone": "+1234567890",
                "companyName": "Shipper Company",
                "fullName": "Shipper Name"
            },
            "typeCode": "business"
        },
        "receiverDetails": {
            "postalAddress": {
                "cityName": "BASEL ",
                "countryCode": "CH",
                "postalCode": "9000",
                "addressLine1": "RECEIVER ADDRESS 1",
                "addressLine2": "RECEIVER ADDRESS 2",
                "addressLine3": "RECEIVER ADDRESS 3"
            },
            "contactInformation": {
                "email": "receiver@email.com",
                "phone": "1234567890",
                "companyName": "Receiver Company",
                "fullName": "Receiver Name"
            },
            "typeCode": "business"
        }
        /* Importer details
		,
        "importerDetails": {
            "postalAddress": {
                "cityName": "BASEL ",
                "countryCode": "CH",
                "postalCode": "9000",
                "addressLine1": "IMPORTER ADDRESS 1",
                "addressLine2": "IMPORTER ADDRESS 2",
                "addressLine3": "IMPORTER ADDRESS 3"
            },
            "contactInformation": {
                "email": "receiver@email.com",
                "phone": "1234567890",
                "companyName": "Importer Company",
                "fullName": "Importer Name"
            },
            "typeCode": "business"
        }
        */		
    },
    "content": {
        "packages": [
            {
                "weight": 1.097,
                "dimensions": {
                    "length": 18,
                    "width": 13,
                    "height": 13
                },
                "labelDescription": "bespoke label description"
            }
        ],
        "isCustomsDeclarable": true,
        "declaredValue": 1139.75,
        "declaredValueCurrency": "GBP",
        "exportDeclaration": {
            /* transport cost 
			"additionalCharges": [
                {
                    "value": 45.11,
                    "typeCode": "freight"
                }
            ],
			*/
            "lineItems": [
                {
                    "number": 1,
                    "commodityCodes": [
                        {
                            "value": "33059040",
                            "typeCode": "outbound"
                        },
                        {
                            "value": "123456",
                            "typeCode": "inbound"
                        }
                    ],
                    "priceCurrency": "GBP",
                    "quantity": {
                        "unitOfMeasurement": "BOX",
                        "value": 1
                    },
                    "price": 608.39,
                    "description": "La Prairie Skin Caviar Luxe Cream 100ml",
                    "weight": {
                        "netValue": 0.634,
                        "grossValue": 0.634
                    },
                    "exportReasonType": "permanent",
                    "manufacturerCountry": "GB"
                },
                {
                    "number": 2,
                    "commodityCodes": [
                        {
                            "value": "33049900",
                            "typeCode": "outbound"
                        },
                        {
                            "value": "123456",
                            "typeCode": "inbound"
                        }
                    ],
                    "priceCurrency": "GBP",
                    "quantity": {
                        "unitOfMeasurement": "BOX",
                        "value": 1
                    },
                    "price": 174.96,
                    "description": "La Prairie Cellular Hydrating Serum 30ml",
                    "weight": {
                        "netValue": 0.1,
                        "grossValue": 0.1
                    },
                    "exportReasonType": "permanent",
                    "manufacturerCountry": "GB"
                },
                {
                    "number": 3,
                    "commodityCodes": [
                        {
                            "value": "33049900",
                            "typeCode": "outbound"
                        },
                        {
                            "value": "123456",
                            "typeCode": "inbound"
                        }
                    ],
                    "priceCurrency": "GBP",
                    "quantity": {
                        "unitOfMeasurement": "BOX",
                        "value": 1
                    },
                    "price": 356.4,
                    "description": "La Prairie Skin Caviar Liquid Lift ",
                    "weight": {
                        "netValue": 0.2,
                        "grossValue": 0.2
                    },
                    "exportReasonType": "permanent",
                    "manufacturerCountry": "GB"
                }
            ],
            "invoice": {
                "date": "2025-05-27",
                "number": "100299777"
            },
            "placeOfIncoterm": "BASEL",
            "remarks": [
                {
                    "value": "declaration remark"
                }
            ]
        },
        "description": "Cosmetics: Skincare",
        "incoterm": "DAP",
        "unitOfMeasurement": "metric"
    },
    "documentImages": [
        {
            "typeCode": "INV",
            "imageFormat": "PDF",
            "content": "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IDAgMCAwIDYwMCAwIDAgMAo2MDAgMCAwIDYwMCA2MDBdCi9FbmNvZGluZy9XaW5BbnNpRW5jb2RpbmcvU3VidHlwZS9UeXBlMT4+CmVuZG9iago4IDAgb2JqCjw8L1R5cGUvRm9udERlc2NyaXB0b3IvRm9udE5hbWUvT0JYSVVTK0NvdXJpZXIvRm9udEJCb3hbMCAtMTYgNTM1IDU3Nl0vRmxhZ3MgNQovQXNjZW50IDU3NgovQ2FwSGVpZ2h0IDU3NgovRGVzY2VudCAtMTYKL0l0YWxpY0FuZ2xlIDAKL1N0ZW1WIDgwCi9BdmdXaWR0aCA2MDAKL01heFdpZHRoIDYwMAovTWlzc2luZ1dpZHRoIDYwMAovQ2hhclNldCgvTC9vbmUvUC9FL1MvVC9zcGFjZSkvRm9udEZpbGUzIDEyIDAgUj4+CmVuZG9iagoyIDAgb2JqCjw8L1Byb2R1Y2VyKEdQTCBHaG9zdHNjcmlwdCA4LjE1KQovQ3JlYXRpb25EYXRlKEQ6MjAyMDA1MjcxNTA4NTMpCi9Nb2REYXRlKEQ6MjAyMDA1MjcxNTA4NTMpCi9UaXRsZShuZXcgMSkKL0NyZWF0b3IoUFNjcmlwdDUuZGxsIFZlcnNpb24gNS4yLjIpCi9BdXRob3IobWtvbGFrKT4+ZW5kb2JqCnhyZWYKMCAxNAowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDA1MjcgMDAwMDAgbiAKMDAwMDAwMjEzOCAwMDAwMCBuIAowMDAwMDAwNDU5IDAwMDAwIG4gCjAwMDAwMDAyOTkgMDAwMDAgbiAKMDAwMDAwMDAxNSAwMDAwMCBuIAowMDAwMDAwMjgwIDAwMDAwIG4gCjAwMDAwMDA1NzUgMDAwMDAgbiAKMDAwMDAwMTg4MyAwMDAwMCBuIAowMDAwMDAxNjEzIDAwMDAwIG4gCjAwMDAwMDA2MTYgMDAwMDAgbiAKMDAwMDAwMDY0NiAwMDAwMCBuIAowMDAwMDAwNjc2IDAwMDAwIG4gCjAwMDAwMDE1OTMgMDAwMDAgbiAKdHJhaWxlcgo8PCAvU2l6ZSAxNCAvUm9vdCAxIDAgUiAvSW5mbyAyIDAgUgovSUQgWyh8jAba95hzmAIlia50X4QCKSh8jAba95hzmAIlia50X4QCKV0KPj4Kc3RhcnR4cmVmCjIzMTQKJSVFT0YK"
        }
    ]
}

    pobierz plik
     {
    "plannedShippingDateAndTime": "2025-06-18T20:00:00 GMT+01:00",
    "pickup": {
        "isRequested": false
    },
    "productCode": "P",
    "getRateEstimates": true,
    "accounts": [
        {
            "number": "{{account}}",
            "typeCode": "shipper"
        }
    ],
    "valueAddedServices": [
        {
            "serviceCode": "WY"
        }
        /* Neutral Delivery Service - Importer details needed
        ,
        {
            "serviceCode": "NN"
        }
        */
    ],
    "outputImageProperties": {
        "encodingFormat": "pdf",
        "imageOptions": [
            {
                "typeCode": "invoice",
                "invoiceType": "commercial",
                "isRequested": false
            },
            {
                "typeCode": "waybillDoc",
                "hideAccountNumber": false,
                "isRequested": true
            },
            {
                "typeCode": "label",
                "templateName": "ECOM26_84_001",
                "isRequested": true,
                "renderDHLLogo": true
            }
        ],
        "splitTransportAndWaybillDocLabels": false
    },
    "customerReferences": [
        {
            "value": "Shipment Reference",
            "typeCode": "CU"
        }
    ],
    "customerDetails": {
        "shipperDetails": {
            "postalAddress": {
                "cityName": "KATY WROCLAWSKIE",
                "countryCode": "PL",
                "postalCode": "55080",
                "addressLine1": "Legionow Street",
                "addressLine2": "bldg 567",
                "addressLine3": "line 3"
            },
            "contactInformation": {
                "email": "shipper@email.com",
                "phone": "+1234567890",
                "companyName": "Shipper Company",
                "fullName": "Shipper Name"
            },
            "typeCode": "business"
        },
        "receiverDetails": {
            "postalAddress": {
                "cityName": "SAO PAULO",
                "countryCode": "BR",
                "postalCode": "01001",
                "addressLine1": "RECEIVER ADDRESS 1",
                "addressLine2": "RECEIVER ADDRESS 2",
                "addressLine3": "RECEIVER ADDRESS 3"
            },
            "contactInformation": {
                "email": "receiver@email.com",
                "phone": "1234567890",
                "companyName": "Receiver Company",
                "fullName": "Receiver Name"
            },
            "typeCode": "business"
        }
        /* Importer details
		,
        "importerDetails": {
            "postalAddress": {
                "cityName": "SAO PAULO",
                "countryCode": "BR",
                "postalCode": "01001",
                "addressLine1": "IMPORTER ADDRESS 1",
                "addressLine2": "IMPORTER ADDRESS 2",
                "addressLine3": "IMPORTER ADDRESS 3"
            },
            "contactInformation": {
                "email": "receiver@email.com",
                "phone": "1234567890",
                "companyName": "Importer Company",
                "fullName": "Importer Name"
            },
            "typeCode": "business"
        }
        */
    },
    "content": {
        "packages": [
            {
                "weight": 1.097,
                "dimensions": {
                    "length": 18,
                    "width": 13,
                    "height": 13
                },
                "labelDescription": "bespoke label description"
            }
        ],
        "isCustomsDeclarable": true,
        "declaredValue": 1139.75,
        "declaredValueCurrency": "GBP",
        "exportDeclaration": {
            /* transport cost 
			"additionalCharges": [
                {
                    "value": 45.11,
                    "typeCode": "freight"
                }
            ],
			*/
            "lineItems": [
                {
                    "number": 1,
                    "commodityCodes": [
                        {
                            "value": "33059040",
                            "typeCode": "outbound"
                        },
                        {
                            "value": "123456",
                            "typeCode": "inbound"
                        }
                    ],
                    "priceCurrency": "GBP",
                    "quantity": {
                        "unitOfMeasurement": "BOX",
                        "value": 1
                    },
                    "price": 608.39,
                    "description": "La Prairie Skin Caviar Luxe Cream 100ml",
                    "weight": {
                        "netValue": 0.634,
                        "grossValue": 0.634
                    },
                    "exportReasonType": "permanent",
                    "manufacturerCountry": "GB"
                },
                {
                    "number": 2,
                    "commodityCodes": [
                        {
                            "value": "33049900",
                            "typeCode": "outbound"
                        },
                        {
                            "value": "123456",
                            "typeCode": "inbound"
                        }
                    ],
                    "priceCurrency": "GBP",
                    "quantity": {
                        "unitOfMeasurement": "BOX",
                        "value": 1
                    },
                    "price": 174.96,
                    "description": "La Prairie Cellular Hydrating Serum 30ml",
                    "weight": {
                        "netValue": 0.1,
                        "grossValue": 0.1
                    },
                    "exportReasonType": "permanent",
                    "manufacturerCountry": "GB"
                },
                {
                    "number": 3,
                    "commodityCodes": [
                        {
                            "value": "33049900",
                            "typeCode": "outbound"
                        },
                        {
                            "value": "123456",
                            "typeCode": "inbound"
                        }
                    ],
                    "priceCurrency": "GBP",
                    "quantity": {
                        "unitOfMeasurement": "BOX",
                        "value": 1
                    },
                    "price": 356.4,
                    "description": "La Prairie Skin Caviar Liquid Lift ",
                    "weight": {
                        "netValue": 0.2,
                        "grossValue": 0.2
                    },
                    "exportReasonType": "permanent",
                    "manufacturerCountry": "GB"
                }
            ],
            "invoice": {
                "date": "2025-06-18",
                "number": "100299777"
            },
            "placeOfIncoterm": "SAO PAULO",
            "remarks": [
                {
                    "value": "declaration remark"
                }
            ]
        },
        "description": "Cosmetics: Skincare",
        "incoterm": "DAP",
        "unitOfMeasurement": "metric"
    },
    "documentImages": [
        {
            "typeCode": "INV",
            "imageFormat": "PDF",
            "content": "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IDAgMCAwIDYwMCAwIDAgMAo2MDAgMCAwIDYwMCA2MDBdCi9FbmNvZGluZy9XaW5BbnNpRW5jb2RpbmcvU3VidHlwZS9UeXBlMT4+CmVuZG9iago4IDAgb2JqCjw8L1R5cGUvRm9udERlc2NyaXB0b3IvRm9udE5hbWUvT0JYSVVTK0NvdXJpZXIvRm9udEJCb3hbMCAtMTYgNTM1IDU3Nl0vRmxhZ3MgNQovQXNjZW50IDU3NgovQ2FwSGVpZ2h0IDU3NgovRGVzY2VudCAtMTYKL0l0YWxpY0FuZ2xlIDAKL1N0ZW1WIDgwCi9BdmdXaWR0aCA2MDAKL01heFdpZHRoIDYwMAovTWlzc2luZ1dpZHRoIDYwMAovQ2hhclNldCgvTC9vbmUvUC9FL1MvVC9zcGFjZSkvRm9udEZpbGUzIDEyIDAgUj4+CmVuZG9iagoyIDAgb2JqCjw8L1Byb2R1Y2VyKEdQTCBHaG9zdHNjcmlwdCA4LjE1KQovQ3JlYXRpb25EYXRlKEQ6MjAyMDA1MjcxNTA4NTMpCi9Nb2REYXRlKEQ6MjAyMDA1MjcxNTA4NTMpCi9UaXRsZShuZXcgMSkKL0NyZWF0b3IoUFNjcmlwdDUuZGxsIFZlcnNpb24gNS4yLjIpCi9BdXRob3IobWtvbGFrKT4+ZW5kb2JqCnhyZWYKMCAxNAowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDA1MjcgMDAwMDAgbiAKMDAwMDAwMjEzOCAwMDAwMCBuIAowMDAwMDAwNDU5IDAwMDAwIG4gCjAwMDAwMDAyOTkgMDAwMDAgbiAKMDAwMDAwMDAxNSAwMDAwMCBuIAowMDAwMDAwMjgwIDAwMDAwIG4gCjAwMDAwMDA1NzUgMDAwMDAgbiAKMDAwMDAwMTg4MyAwMDAwMCBuIAowMDAwMDAxNjEzIDAwMDAwIG4gCjAwMDAwMDA2MTYgMDAwMDAgbiAKMDAwMDAwMDY0NiAwMDAwMCBuIAowMDAwMDAwNjc2IDAwMDAwIG4gCjAwMDAwMDE1OTMgMDAwMDAgbiAKdHJhaWxlcgo8PCAvU2l6ZSAxNCAvUm9vdCAxIDAgUiAvSW5mbyAyIDAgUgovSUQgWyh8jAba95hzmAIlia50X4QCKSh8jAba95hzmAIlia50X4QCKV0KPj4Kc3RhcnR4cmVmCjIzMTQKJSVFT0YK"
        }
    ]
}

  • 2. Faktura generowana przez WebService - sekcja celna która tworzy fakturę - Uwaga: można utworzyć tylko jedną fakturę do przesyłki

    Wypełniona sekcja celna na podstawie której generowana jest faktura i przesyłana do systemów DHL Express.

    pobierz plik
    {
    "plannedShippingDateAndTime": "2025-05-27T20:00:00 GMT+01:00",
    "pickup": {
        "isRequested": false
    },
    "productCode": "P",
    "getRateEstimates": true,
    "accounts": [
        {
            "number": "{{account}}",
            "typeCode": "shipper"
        }
    ],
    "valueAddedServices": [
        {
            "serviceCode": "WY"
        }
        /* Neutral Delivery Service - Importer details needed
        ,
        {
            "serviceCode": "NN"
        }
        */
    ],
    "outputImageProperties": {
        "encodingFormat": "pdf",
        "imageOptions": [
            {
                "typeCode": "invoice",
                "invoiceType": "commercial",
                "isRequested": true
            },
            {
                "typeCode": "waybillDoc",
                "hideAccountNumber": false,
                "isRequested": true
            },
            {
                "typeCode": "label",
                "templateName": "ECOM26_84_001",
                "isRequested": true,
                "renderDHLLogo": true
            }
        ],
        "splitTransportAndWaybillDocLabels": false
    },
    "customerReferences": [
        {
            "value": "Shipment Reference",
            "typeCode": "CU"
        }
    ],
    "customerDetails": {
        "shipperDetails": {
            "postalAddress": {
                "cityName": "KATY WROCLAWSKIE",
                "countryCode": "PL",
                "postalCode": "55080",
                "addressLine1": "Legionow Street",
                "addressLine2": "bldg 567",
                "addressLine3": "line 3"
            },
            "contactInformation": {
                "email": "shipper@email.com",
                "phone": "+1234567890",
                "companyName": "Shipper Company",
                "fullName": "Shipper Name"
            },
            "typeCode": "business"
        },
        "receiverDetails": {
            "postalAddress": {
                "cityName": "BASEL ",
                "countryCode": "CH",
                "postalCode": "9000",
                "addressLine1": "RECEIVER ADDRESS 1",
                "addressLine2": "RECEIVER ADDRESS 2",
                "addressLine3": "RECEIVER ADDRESS 3"
            },
            "contactInformation": {
                "email": "receiver@email.com",
                "phone": "1234567890",
                "companyName": "Receiver Company",
                "fullName": "Receiver Name"
            },
            "typeCode": "business"
        }
        /* Importer details
		,
        "importerDetails": {
            "postalAddress": {
                "cityName": "BASEL ",
                "countryCode": "CH",
                "postalCode": "9000",
                "addressLine1": "IMPORTER ADDRESS 1",
                "addressLine2": "IMPORTER ADDRESS 2",
                "addressLine3": "IMPORTER ADDRESS 3"
            },
            "contactInformation": {
                "email": "receiver@email.com",
                "phone": "1234567890",
                "companyName": "Importer Company",
                "fullName": "Importer Name"
            },
            "typeCode": "business"
        }
        */
    },
    "content": {
        "packages": [
            {
                "weight": 1.097,
                "dimensions": {
                    "length": 18,
                    "width": 13,
                    "height": 13
                },
                "labelDescription": "bespoke label description"
            }
        ],
        "isCustomsDeclarable": true,
        "declaredValue": 1139.75,
        "declaredValueCurrency": "GBP",
        "exportDeclaration": {
            /* transport cost 
			"additionalCharges": [
                {
                    "value": 45.11,
                    "typeCode": "freight"
                }
            ],
			*/	
            "lineItems": [
                {
                    "number": 1,
                    "commodityCodes": [
                        {
                            "value": "33059040",
                            "typeCode": "outbound"
                        },
                        {
                            "value": "123456",
                            "typeCode": "inbound"
                        }
                    ],
                    "priceCurrency": "GBP",
                    "quantity": {
                        "unitOfMeasurement": "BOX",
                        "value": 1
                    },
                    "price": 608.39,
                    "description": "La Prairie Skin Caviar Luxe Cream 100ml",
                    "weight": {
                        "netValue": 0.634,
                        "grossValue": 0.634
                    },
                    "exportReasonType": "permanent",
                    "manufacturerCountry": "GB"
                },
                {
                    "number": 2,
                    "commodityCodes": [
                        {
                            "value": "33049900",
                            "typeCode": "outbound"
                        },
                        {
                            "value": "123456",
                            "typeCode": "inbound"
                        }
                    ],
                    "priceCurrency": "GBP",
                    "quantity": {
                        "unitOfMeasurement": "BOX",
                        "value": 1
                    },
                    "price": 174.96,
                    "description": "La Prairie Cellular Hydrating Serum 30ml",
                    "weight": {
                        "netValue": 0.1,
                        "grossValue": 0.1
                    },
                    "exportReasonType": "permanent",
                    "manufacturerCountry": "GB"
                },
                {
                    "number": 3,
                    "commodityCodes": [
                        {
                            "value": "33049900",
                            "typeCode": "outbound"
                        },
                        {
                            "value": "123456",
                            "typeCode": "inbound"
                        }
                    ],
                    "priceCurrency": "GBP",
                    "quantity": {
                        "unitOfMeasurement": "BOX",
                        "value": 1
                    },
                    "price": 356.4,
                    "description": "La Prairie Skin Caviar Liquid Lift ",
                    "weight": {
                        "netValue": 0.2,
                        "grossValue": 0.2
                    },
                    "exportReasonType": "permanent",
                    "manufacturerCountry": "GB"
                }
            ],
            "invoice": {
                "date": "2025-05-27",
                "number": "100299777"
            },
            "placeOfIncoterm": "BASEL",
            "remarks": [
                {
                    "value": "declaration remark"
                }
            ]
        },
        "description": "Cosmetics: Skincare",
        "incoterm": "DAP",
        "unitOfMeasurement": "metric"
    }
}

    pobierz plik
    {
    "plannedShippingDateAndTime": "2025-06-18T20:00:00 GMT+01:00",
    "pickup": {
        "isRequested": false
    },
    "productCode": "P",
    "getRateEstimates": true,
    "accounts": [
        {
            "number": "{{account}}",
            "typeCode": "shipper"
        }
    ],
    "valueAddedServices": [
        {
            "serviceCode": "WY"
        }
        /* Neutral Delivery Service - Importer details needed
        ,
        {
            "serviceCode": "NN"
        }
        */
    ],
    "outputImageProperties": {
        "encodingFormat": "pdf",
        "imageOptions": [
            {
                "typeCode": "invoice",
                "invoiceType": "commercial",
                "isRequested": true
            },
            {
                "typeCode": "waybillDoc",
                "hideAccountNumber": false,
                "isRequested": true
            },
            {
                "typeCode": "label",
                "templateName": "ECOM26_84_001",
                "isRequested": true,
                "renderDHLLogo": true
            }
        ],
        "splitTransportAndWaybillDocLabels": false
    },
    "customerReferences": [
        {
            "value": "Shipment Reference",
            "typeCode": "CU"
        }
    ],
    "customerDetails": {
        "shipperDetails": {
            "postalAddress": {
                "cityName": "KATY WROCLAWSKIE",
                "countryCode": "PL",
                "postalCode": "55080",
                "addressLine1": "Legionow Street",
                "addressLine2": "bldg 567",
                "addressLine3": "line 3"
            },
            "contactInformation": {
                "email": "shipper@email.com",
                "phone": "+1234567890",
                "companyName": "Shipper Company",
                "fullName": "Shipper Name"
            },
            "typeCode": "business"
        },
        "receiverDetails": {
            "postalAddress": {
                "cityName": "SAO PAULO",
                "countryCode": "BR",
                "postalCode": "01001",
                "addressLine1": "RECEIVER ADDRESS 1",
                "addressLine2": "RECEIVER ADDRESS 2",
                "addressLine3": "RECEIVER ADDRESS 3"
            },
            "contactInformation": {
                "email": "receiver@email.com",
                "phone": "1234567890",
                "companyName": "Receiver Company",
                "fullName": "Receiver Name"
            },
            "typeCode": "business"
        }
        /* Importer details
		,
        "importerDetails": {
            "postalAddress": {
                "cityName": "SAO PAULO",
                "countryCode": "BR",
                "postalCode": "01001",
                "addressLine1": "IMPORTER ADDRESS 1",
                "addressLine2": "IMPORTER ADDRESS 2",
                "addressLine3": "IMPORTER ADDRESS 3"
            },
            "contactInformation": {
                "email": "receiver@email.com",
                "phone": "1234567890",
                "companyName": "Importer Company",
                "fullName": "Importer Name"
            },
            "typeCode": "business"
        }
        */
    },
    "content": {
        "packages": [
            {
                "weight": 1.097,
                "dimensions": {
                    "length": 18,
                    "width": 13,
                    "height": 13
                },
                "labelDescription": "bespoke label description"
            }
        ],
        "isCustomsDeclarable": true,
        "declaredValue": 1139.75,
        "declaredValueCurrency": "GBP",
        "exportDeclaration": {
            /* transport cost 
			"additionalCharges": [
                {
                    "value": 45.11,
                    "typeCode": "freight"
                }
            ],
			*/
            "lineItems": [
                {
                    "number": 1,
                    "commodityCodes": [
                        {
                            "value": "33059040",
                            "typeCode": "outbound"
                        },
                        {
                            "value": "123456",
                            "typeCode": "inbound"
                        }
                    ],
                    "priceCurrency": "GBP",
                    "quantity": {
                        "unitOfMeasurement": "BOX",
                        "value": 1
                    },
                    "price": 608.39,
                    "description": "La Prairie Skin Caviar Luxe Cream 100ml",
                    "weight": {
                        "netValue": 0.634,
                        "grossValue": 0.634
                    },
                    "exportReasonType": "permanent",
                    "manufacturerCountry": "GB"
                },
                {
                    "number": 2,
                    "commodityCodes": [
                        {
                            "value": "33049900",
                            "typeCode": "outbound"
                        },
                        {
                            "value": "123456",
                            "typeCode": "inbound"
                        }
                    ],
                    "priceCurrency": "GBP",
                    "quantity": {
                        "unitOfMeasurement": "BOX",
                        "value": 1
                    },
                    "price": 174.96,
                    "description": "La Prairie Cellular Hydrating Serum 30ml",
                    "weight": {
                        "netValue": 0.1,
                        "grossValue": 0.1
                    },
                    "exportReasonType": "permanent",
                    "manufacturerCountry": "GB"
                },
                {
                    "number": 3,
                    "commodityCodes": [
                        {
                            "value": "33049900",
                            "typeCode": "outbound"
                        },
                        {
                            "value": "123456",
                            "typeCode": "inbound"
                        }
                    ],
                    "priceCurrency": "GBP",
                    "quantity": {
                        "unitOfMeasurement": "BOX",
                        "value": 1
                    },
                    "price": 356.4,
                    "description": "La Prairie Skin Caviar Liquid Lift ",
                    "weight": {
                        "netValue": 0.2,
                        "grossValue": 0.2
                    },
                    "exportReasonType": "permanent",
                    "manufacturerCountry": "GB"
                }
            ],
            "invoice": {
                "date": "2025-06-18",
                "number": "100299777"
            },
            "placeOfIncoterm": "SAO PAULO",
            "remarks": [
                {
                    "value": "declaration remark"
                }
            ]
        },
        "description": "Cosmetics: Skincare",
        "incoterm": "DAP",
        "unitOfMeasurement": "metric"
    }
}

Lista krajów z dostępną usługą PLT v.23.06.2025 >>> Tabela | TXT
IB-Inbound, OB-Outbund - dla wysyłek z PL istotny jest wskaźnik IB poszczególnych krajów.

Kody ISO krajów>>> otwórz