Kun lähetetään EU:sta EU:n ulkopuoliseen maahan tai päinvastoin, joidenkin kuljetusyritysten osalta on pakollista sisällyttää tullitiedot. Jotkut kuljetusyritykset tarjoavat paperittomia laskutuspalveluja, joita kutsutaan myös sähköiseksi laskutukseksi. Tässä artikkelissa selitetään, miten nämä tiedot sisällytetään pyyntöön nShiftin Shipment Server API:lle.

• Esimerkkipyynnöt Shipment Server API:lle
• Useita tullitietorivejä
• Yleiskatsaus tietokenttiin

Esimerkkipyyntö Shipment Server API:lle

Huomioithan, että kuljetusyrityksillä on erilaiset vaatimukset tullitiedoille, joten vaikka monet kentistä ovat samankaltaisia, ne vaihtelevat kuljetusyrityksittäin. 

Alla oleva pyyntöesimerkki näyttää UPS-kuljetuksella lähetetyn lähetyksen, jossa käytetään tuotetta "UPS Saver" ja palvelua "Commercial invoice (Paperless)". Lähettäjä sijaitsee Tanskassa ja vastaanottaja Yhdysvalloissa.

GroupID 1 viittaa kenttäryhmään, joka tunnetaan nimellä Article Info ja sisältää yksittäisiin tuotteisiin liittyvät tullitiedot. Tässä on mahdollista lisätä tietoja rivikohtaisesti.

GroupID 2 viittaa kenttäryhmään, joka tunnetaan nimellä Customs Info ja sisältää yleisiä lähetykseen liittyviä tullitietoja. 

Katso liitteemme  saadaksesi luettelon kaikista mahdollisista GroupID:istä. 

Jokaisen ryhmän Kind ID:t viittaavat yksittäisiin tullikenttiin, esim. kindID 7 ryhmässä 1 tarkoittaa tavaran kuvausta. Katso artikkelin lopusta taulukko kaikista mahdollisista Detail Kind ID:istä. Taulukosta näet myös yleisimmät tullitietoja tukevat kuljetusyritykset ja niiden tukemat kentät. Kaikki kentät eivät ole pakollisia kaikilla kuljetusyrityksillä. Voit käyttää menetelmää ValidateShipment tarkistaaksesi, oletko täyttänyt pyynnössä vähimmäisvaatimukset.

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

Useita tullitietorivejä

Jos lähetyksessä on useita tietorivejä, voit sisällyttää pyyntöösi RowNo ja LineNo. RowNo määrittää tietorivin numeron tiettyyn tavarariviin liittyen ja LineNo määrittää tavararivin numeron.

Alla oleva esimerkki näyttää DetailsGroups-rakenteen, jossa on 3 tietoriviä. Ensimmäiset kaksi tietoriviä (Rows) liittyvät ensimmäiseen tavarariviin, ja kolmas tietorivi liittyy toiseen tavarariviin:

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

Yleiskatsaus tietokenttiin

Alla oleva taulukko näyttää kaikki Details-kentät. Kenttien nimet voivat vaihdella kuljetusyrityksittäin, mutta API:ssa nimi on aina sama. Sinisellä tekstillä merkityt kentät ovat yleisimmin käytettyjä. Kuljetusyritysten sarakkeet näyttävät, mitkä kentät ovat tuettuja kussakin kuljetusyrityksessä.