Når du sender fra EU til et ikke-EU land, eller omvendt, er det obligatorisk at inkludere toldoplysninger for visse transportører. Nogle transportører tilbyder papirløse faktureringstjenester, også kendt som elektronisk fakturering. Denne artikel forklarer, hvordan du inkluderer disse oplysninger i din forespørgsel til nShift's Shipment Server API.

• Eksempel på forespørgseler til Shipment Server API
• Flere toldoplysningslinjer
• Oversigt over feltoplysninger

Eksempel på forespørgsel til Shipment Server API

Vær opmærksom på, at transportører har forskellige krav til toldoplysninger, så selvom mange af felterne ligner hinanden, vil de variere fra transportør til transportør. 

Eksemplet nedenfor viser en forsendelse med transportøren UPS, der bruger produktet "UPS Saver" og tjenesten "Commercial invoice (Paperless)". Afsenderen er placeret i Danmark, og modtageren er i USA.

GroupID 1 henviser til gruppen af felter kendt som Articleinfo og indeholder toldoplysninger relateret til de enkelte varer. Her er det muligt at tilføje oplysninger på detaljeniveau.

GroupID 2 henviser til gruppen af felter kendt som Toldinfo og indeholder generelle toldoplysninger relateret til forsendelsen. 

Se vores appendiks for at få en liste over alle mulige GroupIDs. 

De Kind IDs i hver gruppe henviser til de enkelte toldfelter, f.eks. kindID 7 i gruppe 1 henviser til beskrivelsen af varerne. Se tabellen med alle mulige Detail Kind IDs nederst i artiklen. Tabellen giver også et overblik over understøttede detaljefelter hos de mest brugte transportører, der understøtter toldoplysninger. Ikke alle felter er obligatoriske hos hver transportør. Du kan bruge metoden ValidateShipment for at se, om du har udfyldt minimumskravene i din forespørgsel.

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

Flere toldoplysningslinjer

Hvis du har flere detaljelinjer på din forsendelse, kan du inkludere RowNo og LineNo i din forespørgsel. RowNo angiver detaljelinjens nummer relateret til en specifik varslinje, og LineNo angiver varslinjens nummer.

Eksemplet nedenfor viser strukturen af DetailsGroups med 3 detaljelinjer. De første to detaljelinjer (Rows) relaterer til den første varslinje, og den tredje detaljelinje relaterer til den anden varslinje:

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

Oversigt over detaljefelter

Tabellen nedenfor viser alle Details-felterne. Feltnavnene kan variere fra transportør til transportør, men navnet i API'en vil altid være det samme. Felter med blå tekst er de mest anvendte felter. Transportørkolonnerne viser, hvilke felter der understøttes hos de enkelte transportører.