När du skickar från EU till ett icke-EU-land, eller tvärtom, är det obligatoriskt att inkludera tulluppgifter för vissa transportörer. Vissa transportörer erbjuder tjänster för papperslösa fakturor, även kallat elektronisk fakturering. Denna artikel förklarar hur du inkluderar denna information i din förfrågan till nShifts Shipment Server API.

• Exempel på förfrågningar till Shipment Server API
• Flera tulluppgiftsrader
• Översikt över fält för uppgifter

Exempel på förfrågan till Shipment Server API

Observera att transportörer har olika krav på tulluppgifterna, så även om många av fälten är liknande kommer de att variera mellan transportörerna. 

Exemplet nedan visar en försändelse med transportören UPS som använder produkten "UPS Saver" och tjänsten "Commercial invoice (Paperless)". Avsändaren är belägen i Danmark och mottagaren i USA.

GroupID 1 avser gruppen av fält som kallas Artikelinfo och innehåller tullinformation relaterad till de enskilda artiklarna. Här är det möjligt att lägga till information på detaljnivå per rad.

GroupID 2 avser gruppen av fält som kallas Tullinfo och innehåller allmän tullinformation relaterad till försändelsen. 

Se vår bilaga för en lista över alla möjliga GroupIDs. 

De Kind IDs i varje grupp avser de enskilda tullfälten, t.ex. kindID 7 i grupp 1 avser beskrivningen av varorna. Se tabellen med alla möjliga Detalj Kind IDs längst ner i artikeln. Tabellen ger dig också en översikt över stödda detaljfälten hos de mest använda transportörerna som stöder tulluppgifter. Inte alla fält är obligatoriska för varje transportör. Du kan använda metoden ValidateShipment för att se om du har fyllt i de minimikrav som gäller för fälten i din förfrågan.

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

Flera tulluppgiftsrader

Om du har flera detaljrader i din försändelse kan du inkludera RowNo och LineNo i din förfrågan. RowNo anger detaljradens nummer som är kopplad till en specifik varulinje, och LineNo anger varulinjens nummer.

Exemplet nedan visar strukturen för DetailGroups med 3 detaljrader. De två första detaljraderna (Rows) är kopplade till den första varulinjen, och den tredje detaljrad är kopplad till den andra varulinjen:

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

Översikt över fält för uppgifter

Tabellen nedan visar alla Details-fält. Namnen på fälten kan variera mellan transportörerna, men namnet i API:et kommer alltid att vara detsamma. Fälten med blå text är de mest använda fälten. Kolumnerna för transportörerna visar vilka fält som stöds av respektive transportör.