Order with customs (PL)

Przy zamawianiu przesyłki poprzez endpoint Simplified order placement (bestprice) lub Create order dla wywozu towarów poza UE można skorzystać z elektronicznej odprawy celnej.

Służy do tego sekcja customs w request.
Pola i struktura są dynamiczne i dla każdego przewoźnika mogą być inne. Informację o wymaganych polach należy pobrać /customsRequiredFields
Listę pól należy pobrać /customs/config

Endpoint wymaga podania parametrów:

productId - Identyfikator produktu pobrany za pomocą zasobu /products

senderCountryId oraz receiverCountryId - Identyfikator kraju nadawcy/odbiorcy pobrany za pomocą zasobu /countries

collectionType - Typ nadania (PICKUP, POINT, CROSSBORDER)

Na tej podstawie można przygotować sekcję "customs". Przykład:

"customs": {
    "sender": {
        "eori": "PL1234567890"
    },
    "receiver": {
        "eori": "NL987654321"
    },
    "commodities": [
        {
            "description": "shirt ;; shirt",
            "composition": "100% cotton ;; 100% cotton",
            "purpose": "clothing ;; everyday use",
            "hsCode": "6105.10.0010",
            "countryOfOrigin": "PL",
            "unitOfMeasurement": "EA",
            "quantity": 2,
            "unitValue": 29.99,
            "unitWeightGross": 0.350,
            "unitWeightNet": 0.300,
            "subTotalValue": 59.98,
            "mid": null
        }
    ],
    "totalWeight": [
        {
            "unit": "EA",
            "weightGross": 0.700,
            "weightNet": 0.600
        }
    ],
    "currency": "EUR",
    "purpose": "SOLD",
    "invoiceNumber": "INV/2026/001",
    "invoiceDate": "2026-04-17",
    "postalCharges": 12.50,
    "vatRegistrationNumber": "PL2220872890",
    "vatRegistrationNumberReceiver": "NL123456789B01"
}

Customs