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.

• Voorbeeldverzoeken aan Shipment Server API
• Meerdere douanedetaillijnen
• Overzicht van detailsvelden

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.