Beim Versand von der EU in ein Nicht-EU-Land oder umgekehrt ist es bei bestimmten Spediteuren Pflicht, Zolldetails anzugeben. Einige Spediteure bieten papierlose Rechnungsstellungsdienste an, auch bekannt als elektronische Rechnungsstellung. Dieser Artikel erklärt, wie Sie diese Informationen in Ihre Anfrage an die Shipment Server API von nShift einfügen können.

• Beispielanfragen an die Shipment Server API
• Mehrere Zolldetailzeilen
• Übersicht der Detailfelder

Beispielanfrage an die Shipment Server API

Bitte beachten Sie, dass verschiedene Spediteure unterschiedliche Anforderungen an die Zolldetails haben, sodass sich die Felder zwar ähneln, aber von Spediteur zu Spediteur variieren können. 

Das untenstehende Anfragenbeispiel zeigt eine Sendung mit dem Spediteur UPS unter Verwendung des Produkts „UPS Saver“ und der Dienstleistung „Commercial invoice (Paperless)“. Der Absender befindet sich in Dänemark und der Empfänger in den Vereinigten Staaten.

GroupID 1 bezieht sich auf die Gruppe der Felder, die als Artikelinfo bekannt sind, und enthält Zollinformationen zu den einzelnen Artikeln. Hier ist es möglich, Informationen auf Detailzeilenebene hinzuzufügen.

GroupID 2 bezieht sich auf die Gruppe der Felder, die als Zollinformationen bekannt sind, und enthält allgemeine Zollinformationen zur Sendung. 

Siehe unseren Anhang für eine Liste aller möglichen GroupIDs. 

Die Kind IDs in jeder Gruppe beziehen sich auf die einzelnen Zollfelder, z. B. bezieht sich kindID 7 in Gruppe 1 auf die Warenbeschreibung. Siehe die Tabelle mit allen möglichen Detail Kind IDs am Ende des Artikels. Die Tabelle gibt auch einen Überblick über die unterstützten Detailfelder bei den am häufigsten verwendeten Spediteuren, die Zolldetails unterstützen. Nicht alle Felder sind bei jedem Spediteur verpflichtend. Sie können die Methode ValidateShipment verwenden, um zu prüfen, ob Sie die minimal erforderlichen Felder in Ihrer Anfrage ausgefüllt haben.

{
  "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"
        }
      ]
    }
  ]
}

Mehrere Zolldetailzeilen

Wenn Ihre Sendung mehrere Detailzeilen enthält, können Sie RowNo und LineNo in Ihre Anfrage aufnehmen. RowNo gibt die Detailzeilennummer an, die sich auf eine bestimmte Warenzeile bezieht, und LineNo gibt die Warenzeilennummer an.

Das folgende Beispiel zeigt die Struktur der DetailGroups mit 3 Detailzeilen. Die ersten zwei Detailzeilen (Rows) beziehen sich auf die erste Warenzeile, und die dritte Detailzeile bezieht sich auf die zweite Warenzeile:

 "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
          ]
        }
      ],

Übersicht der Detailfelder

Die folgende Tabelle zeigt alle Detail-Felder. Die Namen der Felder können von Spediteur zu Spediteur variieren, aber der Name in der API bleibt immer gleich. Die Felder mit blauem Text sind die am häufigsten verwendeten Felder. Die Spediteurs-Spalten zeigen, welche Felder bei den einzelnen Spediteuren unterstützt werden.