Denne artikkelen forklarer hvordan du henter en lokasjonskode (f.eks. terminal- eller steds-kode som 9010 eller 0705) fra forsendelseshendelser når du arbeider med ShipmentData API. Den fokuserer på å identifisere hvor dataene ligger i responsen og hvordan de skal tolkes.

Autentiseringsforutsetninger

Før du kaller ShipmentData API, trenger du et tilgangstoken:

• Auth URL: https://account.nshiftportal.com/idp/connect/token
• Grant type: client_credentials
• Scope: public_api_portal_shipment_data

Når du har byttet din client_id og client_secret mot et token, bruker du dette tokenet i Authorization: Bearer-headeren for API-kallene dine.

Trinn 1: Skaff et tilgangstoken

Bruk cURL for å hente tilgangstokenet ditt:

curl -X POST 'https://account.nshiftportal.com/idp/connect/token'   
   -H 'Content-Type: application/x-www-form-urlencoded'   
   -d 'grant_type=client_credentials'   
   -d 'client_id=<YOUR_CLIENT_ID>'   
   -d 'client_secret=<YOUR_CLIENT_SECRET>'

Eksempel på respons:

{
  "access_token": "<JWT>",
  "expires_in": 3600,
  "token_type": "Bearer",
  "scope": "public_api_portal_shipment_data"
}

Trinn 2: Forespørsel om forsendelsesdata via strekkode

For å hente hendelser som kan inneholde lokasjonskoder, bruk Aggregated-by-Barcode-endepunktet.

curl -X POST 'https://api.nshiftportal.com/track/shipmentdata/Operational/Shipments/Aggregated/ByBarcode'   
-H "Authorization: Bearer <ACCESS_TOKEN>"   
-H "Content-Type: application/json"   
-d '{
    "query": "<BARCODE>",
    "startDate": "2025-08-24T00:00:00Z",
    "endDate": "2025-08-26T23:59:59Z",
    "pageSize": 20,
    "pageIndex": 0,
    "installationTags": [],
    "actorTags": [],
    "carrierTags": [],
    "dateRangeSource": 1
}'

Responsen inkluderer informasjon på forsendelsesnivå og pakkenivå, inkludert hendelser.

Hvor lokasjonskoden vises

location-feltet finnes i noen hendelser på pakkenivå. Det representerer vanligvis en transportørs interne sted- eller terminalkode.

• Hendelser på pakkenivå: shipment.lines[].packages[].events[].location (foretrukket)

Når det er til stede, vises location sammen med:

• cityName
• postalCode
• country

• Valgfritt, coordinates med breddegrad og lengdegrad

   

Eksempel: Utdrag av respons

Nedenfor er et forenklet eksempel på en respons som viser en pakkehending med en lokasjonskode:

[
  {
    "shipment": {
      "lines": [
        {
          "packages": [
            {
              "number": "00073123400271295954",
              "events": [
                {
                  "uuid": "b4e5a99b-0aee-41a2-11dd-b1e539a1a4d1",
                  "configurationName": "The delivery of the shipment item is in progress",
                  "normalizedStatusId": 2001,
                  "normalizedStatusName": "Out for delivery",
                  "date": "2025-08-26T09:16:14+02:00",
                  "cityName": "Aalborg",
                  "postalCode": "9000",
                  "country": "Denmark",
                  "location": "9010"
                }
              ]
            }
          ]
        }
      ]
    }
  }
]

I dette eksempelet:

• location-koden er 9010
• Hendelsesstatusen er Out for delivery
• By og postnummer gir ekstra kontekst (Aalborg, 9000)

Tolkning av lokasjonskoden

• location-verdien er spesifikk for transportør, ikke et postnummer.
• Koder som 9010 eller 0705 er identifikatorer for terminaler eller sorteringsknutepunkter.
• Kombiner med cityName og postalCode for å gi brukerne et klarere bilde.