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 funkcjonalnosć/opcja która pozwala wysylać requesty do API z uslugą PLT(WY) - niezależnie czy ta usługa jest dostępna pomiędzy krajami Nadawcy i Odbiorcy (niedostępnosć całkowita lub wynikająca z przekroczenia limitu wartości przesyłki)

Po stronie API następuje weryfikacja dostępnosci usługi:
Jeżeli usługa PLT jest dostępna - tworzony jest list przewozowy z uslugą PLT (WY) - nie ma potrzeby dołączać wydrukowanej faktury
Jeżeli usługa PLT nie jest dostępna - tworzony jest list przewozowy z uslugą 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.

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żnosci 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 fakur (maksymalnie 2MB na jeden obraz) + uzupełniona sekcja celna

    pobierz plik
    {
        "plannedShippingDateAndTime": "2023-11-08T20:00:00 GMT+01:00",
        "pickup": {
            "isRequested": false
        },
        "productCode": "P",
        "getRateEstimates": true,
        "accounts": [
            {
                "number": "*********",
                "typeCode": "shipper"
            }
        ],
        "valueAddedServices": [
            {
                "serviceCode": "WY"
            }
        ],
        "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"
            }
        },
        "content": {
            "packages": [
                {
                    "weight": 1.097,
                    "dimensions": {
                        "length": 18,
                        "width": 13,
                        "height": 13
                    },
                    "labelDescription": "bespoke label description"
                }
            ],
            "isCustomsDeclarable": true,
            "declaredValue": 1139.75,
            "declaredValueCurrency": "GBP",
            "exportDeclaration": {
    			"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": "2022-01-31",
                    "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": "2023-11-08T20:00:00 GMT+01:00",
        "pickup": {
            "isRequested": false
        },
        "productCode": "P",
        "getRateEstimates": true,
        "accounts": [
            {
                "number": "*********",
                "typeCode": "shipper"
            }
        ],
        "valueAddedServices": [
            {
                "serviceCode": "WY"
            }
        ],
        "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": "ELAZIG ",
                    "countryCode": "TR",
                    "postalCode": "23040",
                    "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"
            }
        },
        "content": {
            "packages": [
                {
                    "weight": 1.097,
                    "dimensions": {
                        "length": 18,
                        "width": 13,
                        "height": 13
                    },
                    "labelDescription": "bespoke label description"
                }
            ],
            "isCustomsDeclarable": true,
            "declaredValue": 1139.75,
            "declaredValueCurrency": "GBP",
            "exportDeclaration": {
    			"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": "2022-01-31",
                    "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"
            }
        ]
    }
  • 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": "2023-11-08T20:00:00 GMT+01:00",
        "pickup": {
            "isRequested": false
        },
        "productCode": "P",
        "getRateEstimates": true,
        "accounts": [
            {
                "number": "*********",
                "typeCode": "shipper"
            }
        ],
        "valueAddedServices": [
            {
                "serviceCode": "WY"
            }
        ],
        "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"
            }
        },
        "content": {
            "packages": [
                {
                    "weight": 1.097,
                    "dimensions": {
                        "length": 18,
                        "width": 13,
                        "height": 13
                    },
                    "labelDescription": "bespoke label description"
                }
            ],
            "isCustomsDeclarable": true,
            "declaredValue": 1139.75,
            "declaredValueCurrency": "GBP",
            "exportDeclaration": {
    			"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": "2022-01-31",
                    "number": "100299777"
                },
                "placeOfIncoterm": "BASEL",
                "remarks": [
                    {
                        "value": "declaration remark"
                    }
                ]
            },
            "description": "Cosmetics: Skincare",
            "incoterm": "DAP",
            "unitOfMeasurement": "metric"
        }
    }


    pobierz plik
    {
        "plannedShippingDateAndTime": "2023-11-08T20:00:00 GMT+01:00",
        "pickup": {
            "isRequested": false
        },
        "productCode": "P",
        "getRateEstimates": true,
        "accounts": [
            {
                "number": "*********",
                "typeCode": "shipper"
            }
        ],
        "valueAddedServices": [
            {
                "serviceCode": "WY"
            }
        ],
        "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": "ELAZIG ",
                    "countryCode": "TR",
                    "postalCode": "23040",
                    "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"
            }
        },
        "content": {
            "packages": [
                {
                    "weight": 1.097,
                    "dimensions": {
                        "length": 18,
                        "width": 13,
                        "height": 13
                    },
                    "labelDescription": "bespoke label description"
                }
            ],
            "isCustomsDeclarable": true,
            "declaredValue": 1139.75,
            "declaredValueCurrency": "GBP",
            "exportDeclaration": {
    			"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": "2022-01-31",
                    "number": "100299777"
                },
                "placeOfIncoterm": "BASEL",
                "remarks": [
                    {
                        "value": "declaration remark"
                    }
                ]
            },
            "description": "Cosmetics: Skincare",
            "incoterm": "DAP",
            "unitOfMeasurement": "metric"
        }
    }

Lista krajów z dostępną usługą PLT v.19.07.2024 >>> 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


3.133.153.134 / 7.3.33