Denna artikel förklarar hur man hämtar en platskod (t.ex. terminal- eller platskod såsom 9010 eller 0705) från försändelsehändelser när man arbetar med ShipmentData API. Fokus ligger på att identifiera var datan finns i svaret och hur man tolkar den.

Autentiseringsförutsättningar

Innan du anropar ShipmentData API behöver du en access-token:

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

När du byter ut ditt client_id och client_secret mot en token, använder du den token i Authorization: Bearer-huvudet för dina API-anrop.

Steg 1: Hämta en access-token

Använd cURL för att få din access-token:

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>'

Exempelsvar:

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

Steg 2: Fråga efter försändelsedata via streckkod

För att hämta händelser som kan innehålla platskoder, använd endpointen Aggregated-by-Barcode.

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
}'

Svaret inkluderar information på försändelse- och paketnivå, inklusive händelser.

Var platskoden visas

location-fältet ingår i vissa paketnivåhändelser. Det representerar vanligtvis en transportörs interna plats- eller terminalkod.

• Paketnivåhändelser: shipment.lines[].packages[].events[].location (föredras)

När location finns visas det tillsammans med:

• cityName
• postalCode
• country

• Valfritt, coordinates med latitud och longitud

   

Exempel: utdrag från svar

Nedan är ett förenklat exempel på ett svar som visar en pakethändelse med en platskod:

[
  {
    "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 detta exempel:

• location-koden är 9010
• Händelsestatus är Utleverans pågår
• Stad och postnummer ger ytterligare kontext (Aalborg, 9000)

Tolka platskoden

• location-värdet är specifikt för transportören, inte ett postnummer.
• Koder som 9010 eller 0705 är identifierare för terminaler eller sorteringsnav.
• Kombinera med cityName och postalCode för att ge användarna en tydligare bild.