Når du sender fra EU til et ikke-EU-land, eller omvendt, er det obligatorisk å inkludere tollopplysninger for enkelte transportører. Noen transportører tilbyr papirløs fakturering, også kjent som elektronisk fakturering. Denne artikkelen forklarer hvordan du inkluderer denne informasjonen i forespørselen til nShifts Shipment Server API.

• Eksempel på forespørsler til Shipment Server API
• Flere tollopplysningslinjer
• Oversikt over detaljfelt

Eksempel på forespørsel til Shipment Server API

Vær oppmerksom på at transportører har ulike krav til tollopplysninger, så selv om mange av feltene er like, vil de variere fra transportør til transportør. 

Eksempelet på forespørsel nedenfor viser en forsendelse med transportør UPS som bruker produktet "UPS Saver" og tjenesten "Commercial invoice (Paperless)". Avsenderen befinner seg i Danmark og mottakeren i USA.

GroupID 1 refererer til gruppen av felt kjent som Artikkelinfo og inneholder tollinformasjon knyttet til de enkelte varene. Her er det mulig å legge til informasjon på detaljlinjenivå.

GroupID 2 refererer til gruppen av felt kjent som Tollinformasjon og inneholder generell tollinformasjon knyttet til forsendelsen. 

Se vår appendiks for en liste over alle mulige GroupIDs. 

De Kind IDs i hver gruppe refererer til de enkelte tollfeltene, f.eks. kindID 7 i gruppe 1 refererer til beskrivelse av varer. Se tabellen med alle mulige Detalj Kind IDs nederst i artikkelen. Tabellen gir deg også en oversikt over støttede detaljfelt hos de mest brukte transportørene som støtter tollopplysninger. Ikke alle feltene er obligatoriske hos hver transportør. Du kan bruke metoden ValidateShipment for å se om du har fylt ut minimumskravene i forespørselen din.

{
  "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 tollopplysningslinjer

Hvis du har flere detaljlinjer på forsendelsen din, kan du inkludere RowNo og LineNo i forespørselen. RowNo spesifiserer detaljlinjenummeret knyttet til en bestemt varslinje, og LineNo spesifiserer varslinjenummeret.

Eksempelet nedenfor viser strukturen til DetailsGroups med 3 detaljlinjer. De to første detaljlinjene (Rows) er knyttet til den første varslinjen, og den tredje detaljlinjen er knyttet til den andre varslinjen:

 "DetailGroups": [
        {
          "GroupID": 1,
          "GroupDisplayName": "Article Info",
          "Rows": [
            {
              "RowNo": 1, //detaljlinje nr 1 knyttet til varslinje nr 1
              "LineNo": 1, //varslinje nr 1
              "Details": [
                //alle detaljfelt her...
              ]
            },
            {
              "RowNo": 2, //detaljlinje nr 2 også knyttet til varslinje nr 1
              "LineNo": 1, //varslinje nr 1
              "Details": [
                //alle detaljfelt her...
              ]
            },
            {
              "RowNo": 1, //detaljlinje nr 1 knyttet til varslinje nr 2
              "LineNo": 2, //varslinje nr 2
              "Details": [
               //alle detaljfelt her...
              ]
            }
          ]
        },
        {
          "GroupID": 2,
          "GroupDisplayName": "Customs Info",
          "Details": [
            //alle detaljfelt her
          ]
        }
      ],

Oversikt over detaljfelt

Tabellen nedenfor viser alle Details-feltene. Feltnavnene kan variere fra transportør til transportør, men navnet i API-et vil alltid være det samme. Feltene med blå tekst er de mest brukte feltene. Kolonnene for transportørene viser hvilke felt som støttes hos de enkelte transportørene.