Bij verzending van de EU naar een niet-EU land, of andersom, is het verplicht om douanegegevens op te nemen voor bepaalde vervoerders. Sommige vervoerders bieden papierloze facturering aan, ook wel elektronische facturering genoemd. Dit artikel legt uit hoe u deze informatie kunt opnemen in uw verzoek aan de Shipment Server API van nShift.
Voorbeeldverzoek aan Shipment Server API
Houd er rekening mee dat vervoerders verschillende eisen stellen aan de douanegegevens, dus hoewel veel velden vergelijkbaar zijn, zullen ze per vervoerder verschillen.
Het onderstaande voorbeeldverzoek toont een zending met vervoerder UPS, gebruikmakend van het product "UPS Saver" en de dienst "Commercial invoice (Paperless)". De afzender bevindt zich in Denemarken en de ontvanger in de Verenigde Staten.
GroupID 1 verwijst naar de groep velden die bekend staat als Artikelinfo en bevat douane-informatie gerelateerd aan de individuele artikelen. Hier is het mogelijk om informatie op detailregelniveau toe te voegen.
GroupID 2 verwijst naar de groep velden die bekend staat als Douane-info en bevat algemene douane-informatie gerelateerd aan de zending.
Bekijk onze bijlage voor een lijst van alle mogelijke GroupIDs.
De Kind IDs in elke groep verwijzen naar de individuele douanevelden, bijvoorbeeld kindID 7 in groep 1 verwijst naar de omschrijving van de goederen. Zie de tabel met alle mogelijke Detail Kind IDs onderaan het artikel. De tabel geeft ook een overzicht van ondersteunde detailvelden bij de meest gebruikte vervoerders die douanegegevens ondersteunen. Niet alle velden zijn verplicht bij elke vervoerder. U kunt de methode ValidateShipment gebruiken om te controleren of u de minimaal vereiste velden in uw verzoek heeft ingevuld.
{
"Kind": 1,
"OrderNo": "12345",
"ActorCSID": 1378,
"ProdConceptID": 677,
"Addresses": [
{
"Kind": 2,
"Name1": "nshift",
"Street1": "Runevej 2A",
"PostCode": "8210",
"City": "AARHUS V",
"Phone": "70273377",
"Attention": "Jane Doe",
"CountryCode": "DK"
},
{
"Kind": 1,
"Name1": "Beverly Hills Hotel",
"Street1": "9641 Sunset Blvd",
"PostCode": "90210",
"City": "Beverly Hills",
"State": "CA",
"Phone": "+13102762251",
"Attention": "John Doe",
"CountryCode": "US"
}
],
"Amounts": [
{
"Kind": 10,
"CurrencyCode": "6",
"Value": 18
}
],
"References": [
{
"Kind": 140,
"Value": "test@test.com"
},
{
"Kind": 108,
"Value": "2025-02-24T13:14:13+0200"
},
{
"Kind": 27,
"Value": "John Doe"
},
{
"Kind": 109,
"Value": "2025-02-24T16:14:00"
}
],
"Lines": [
{
"GoodsTypeID": 1,
"GoodsTypeName": "UPS Letter",
"GoodsTypeKey1": "01",
"GoodsTypeKey2": "02",
"Number": 1,
"RecycleTypeID": -1,
"References": [
{
"Kind": 23,
"Value": "Postcards"
}
],
"PkgWeight": 2000,
"LineWeight": 2000
}
],
"Services": [
60023
],
"DetailGroups": [
{
"GroupID": 1, //Article Info
"Rows": [
{
"Details": [
{
"KindID": 193, //goods line number
"Value": 1
},
{
"KindID": 5, //No units
"Value": "1"
},
{
"KindID": 8, //Unit of Measure (code)
"Value": "KG"
},
{
"KindID": 7, //Description of goods
"Value": "Commercial postcards"
},
{
"KindID": 4, //Country of Origin
"Value": "DK"
},
{
"KindID": 2, //Unit Value
"Value": "125"
},
{
"KindID": 1, //Article No
"Value": "121212"
},
{
"KindID": 18, //Commodity code
"Value": "48817300000"
}
]
}
]
},
{
"GroupID": 2, //Customs info
"Details": [
{
"KindID": 19, //Invoice number
"Value": "12345678"
},
{
"KindID": 24, //Invoice date
"Value": "20180924"
},
{
"KindID": 21, //Currency
"Value": "DKK"
},
{
"KindID": 20, //Reason for Export
"Value": "Other"
}
]
}
]
}
Meerdere douanedetaillijnen
Als u meerdere detaillijnen bij uw zending heeft, kunt u RowNo en LineNo opnemen in uw verzoek. RowNo specificeert het nummer van de detaillijn gerelateerd aan een specifieke goederenlijn, en LineNo specificeert het nummer van de goederenlijn.
Het onderstaande voorbeeld toont de structuur van de DetailsGroups met 3 detaillijnen. De eerste twee detaillijnen (Rows) zijn gerelateerd aan de eerste goederenlijn, en de derde detaillijn is gerelateerd aan de tweede goederenlijn:
"DetailGroups": [
{
"GroupID": 1,
"GroupDisplayName": "Article Info",
"Rows": [
{
"RowNo": 1, //detail line no 1 related to goodsline no 1
"LineNo": 1, //goods line number 1
"Details": [
//all detail fields here...
]
},
{
"RowNo": 2, //detail line no 2 also related to goodsline no 1
"LineNo": 1, //goods line number 1
"Details": [
//all detail fields here...
]
},
{
"RowNo": 1, //detail line no 1 related to goodsline no 2
"LineNo": 2, //goods line number 2
"Details": [
//all detail fields here...
]
}
]
},
{
"GroupID": 2,
"GroupDisplayName": "Customs Info",
"Details": [
//all detail fields here
]
}
],
Overzicht van detailsvelden
De onderstaande tabel toont alle Details-velden. De namen van de velden kunnen per vervoerder verschillen, maar de naam in de API blijft altijd hetzelfde. De velden met blauwe tekst zijn de meest gebruikte velden. De kolommen van de vervoerders tonen welke velden worden ondersteund door de individuele vervoerders.
| Kind ID | Group ID | Name of field / description | Name of field in API | MyDHL (862) | FedEx API (977) | DHL Parcel (973) | UPS (950) |
|---|---|---|---|---|---|---|---|
| 1 | 1 | Article No | eDekArticleNo.CustomsArticle | x |
|
|
x |
| 2 | 1 | Unit value | eDekUnitValue.CustomsArticle | x |
x |
|
x |
| 3 | 1 | Tariff code | eDekTariffCode.CustomsArticle |
|
|
|
|
| 4 | 1 | Country of Origin | eDekCountryOfOrigin.CustomsArticle | x |
x |
x |
x |
| 5 | 1 | No units | eDekQuantity.CustomsArticle | x |
x |
x |
x |
| 6 | 1 | GrossWeight (KG/LB) / Unit Weight | eDekUnitWeight.CustomsArticle | x |
x |
x |
|
| 7 | 1 | Description / Description of goods | eDekDescrOfGoods.CustomsArticle | x |
x |
x |
x |
| 8 | 1 | Units of Measure (code) | eDekUnitOfMeasure.CustomsArticle | x |
|
x |
x |
| 9 | 1 | Gross Weight | eDekTotalWeight.CustomsArticle |
|
|
|
|
| 10 | 1 | Amount | eDekTotalValue.CustomsArticle |
|
|
|
|
| 11 | 2 | VAT No Sender | eDekVATSender.CustomsInfo |
|
|
|
|
| 12 | 2 | VAT No Receiver | eDekVATReceiver.CustomsInfo |
|
|
|
|
| 13 | 2 | VAT No Buyer | eDekVATBuyer.CustomsInfo |
|
|
|
|
| 14 | 2 | Additional Comments | eDekOtherComments.CustomsInfo | x |
x |
x |
x |
| 16 | 1 | Customs Value | eDekCustomsValue.CustomsArticle |
|
x |
x |
|
| 17 | 1 | Unit Value Currency | eDekCurrency.CustomsArticle | x |
x |
x |
|
| 18 | 1 | Commodity Code | eDekCommodityCode.CustomsArticle | x |
x |
x |
x |
| 19 | 2 | Invoice Number | eDekInvoiceNumber.CustomsInfo | x |
x |
|
x |
| 20 | 2 | Reason for Export | eDekReasonForExport.CustomsInfo | x |
x |
x |
x |
| 21 | 2 | Currency | eDekCurrency.CustomsInfo |
|
x |
x |
x |
| 22 | 2 | Declaration Statement | eDekDeclarationStatement.CustomsInfo | x |
x |
|
x |
| 23 | 2 | Commodity Code | eDekCommodityCode.CustomsInfo |
|
|
|
|
| 24 | 2 | Invoice Date | eDekInvoiceDate.CustomsInfo | x |
|
|
x |
| 25 | 2 | Terms of Sale (Incoterm) / Terms of trade | eDekTermsofShipment.CustomsInfo |
|
|
x |
|
| 26 | 2 | Discount | eDekDiscount.CustomsInfo |
|
|
|
x |
| 27 | 2 | Freight Charges / Additional fee | eDekFreightCharges.CustomsInfo | x |
x |
|
x |
| 28 | 2 | Insurance | eDekInsuranceCharges.CustomsInfo | x |
|
|
x |
| 29 | 2 | Charges Value / Shipment Amount | eDekChargesValue.CustomsInfo |
|
|
x |
x |
| 30 | 2 | Charges Description / Shipment Description | eDekChargesDesc.CustomsInfo |
|
|
|
x |
| 31 | 2 | Booking Confirmation Number / Permit Number | eDekBookingNumber.CustomsInfo |
|
|
x |
x |
| 32 | 1 | Number of Pieces | eDekNumberOfPieces.CustomsArticle |
|
x |
|
|
| 33 | 2 | Contents | eDekContents.CustomsInfo |
|
x |
|
|
| 34 | 2 | Gross Weight | eDekGrossWeight.CustomsInfo |
|
|
|
|
| 35 | 2 | TDoc No | eDekTDocNo.CustomsInfo |
|
x |
|
|
| 36 | 1 | NetWeight (KG/LB) | eDekNettoWeight.CustomsArticle | x |
|
|
|
| 174 | 4 | Customs Amount | eDekCustomsAmount.FedExCustomsInformation |
|
|
|
|
| 175 | 4 | Customs Currency | eDekCustomsCurrency.FedExCustomsInformation |
|
|
|
|
| 176 | 2 | VAT Broker | eDekVATBroker.CustomsInfo |
|
|
|
|
| 177 | 2 | Description of Goods | eDekDescriptionOfGoods.CustomsInfo |
|
|
|
|
| 178 | 2 | Special instructions | eDekSpecialInstructions.CustomsInfo |
|
x |
|
|
| 179 | 2 | Customs Creditor No | eDekCustomsCreditorNo.CustomsInfo |
|
|
|
|
| 180 | 1 | Number of Items | eDekNumberOfItems.CustomsArticle |
|
|
|
|
| 181 | 2 | Total Value | eDekTotalValue.CustomsInfo |
|
x |
|
|
| 182 | 2 | Shippers EORI | eDekShippersEORI.CustomsInfo |
|
|
|
|
| 183 | 2 | FDA Registration | eDekFDARegistration.CustomsInfo |
|
|
|
|
| 184 | 1 | Products Description | eDekProductDescription.CustomsArticle | x |
|
|
|
| 185 | 1 | Product Composition | eDekProductComposition.CustomsArticle | x |
|
|
|
| 187 | 1 | Product Size | eDekProductSize.CustomsArticle | x |
|
|
|
| 507 | 1 | Construction | eDekConstruction.CustomsArticle | x |
|
|
|
| 510 | 1 | Manufacturer | eDekManufacturer.CustomsArticle | x |
|
|
|
| 519 | 2 | Origin Certificate Number | eDekOriginCertificateNumber |
|
x |
x |
|
| 540 | 2 | Document Type | eDekDocumentType | x |
|
|
|
| 541 | 2 | Document Id | eDekDocumentId | x |
|
|
|
| 542 | 2 | Shipment Type | eDekShipmentType | x |
|
|
|
| 544 | 2 | Handling Charges | eDekHandlingCharges | x |
x |
|
|
| 547 | 2 | Movement Reference Number | eDekMovementReferenceNumber | x |
|
|
x |
| 550 | 1 | Commodity Code | eDekInboundCommodityCode | x |
|
|
|
| 552 | 1 | DDS Reference No | eDekDDSReferenceNo | x |
|
|
|
| 553 | 1 | TARIC Document Code | eDekTARICDocumentCode | x |
|
|
|