Denne artikel forklarer, hvordan man henter en lokationskode (f.eks. terminal- eller stedkode såsom 9010 eller 0705) fra forsendelsesevents, når man arbejder med ShipmentData API'et. Den fokuserer på at identificere, hvor dataene findes i svaret, og hvordan man fortolker dem.

Autentificeringsforudsætninger

Før du kalder ShipmentData API'et, har du brug for et adgangstoken:

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

Når du har byttet dit client_id og client_secret til et token, bruger du dette token i Authorization: Bearer-headeren til dine API-kald.

Trin 1: Få en adgangstoken

Brug cURL til at hente din adgangstoken:

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å svar:

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

Trin 2: Forespørg Forsendelsesdata efter Stregkode

For at hente events, der kan indeholde lokationskoder, brug Aggregated-by-Barcode endpointet.

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 inkluderer information på forsendelses- og pakkesniveau, inklusive events.

Hvor lokationskoden fremgår

location-feltet er inkluderet i nogle events på pakkesniveau. Det repræsenterer typisk en transportørs interne sted- eller terminalkode.

• Events på pakkesniveau: shipment.lines[].packages[].events[].location (foretrukket)

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

• cityName
• postalCode
• country

• Valgfrit, coordinates med bredde- og længdegrad

   

Eksempel: Uddrag af svar

Nedenfor er et forenklet eksempel på et svar, der viser et pakkeevent med en lokationskode:

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

• location-koden er 9010
• Event-status er Out for delivery
• By og postnummer giver yderligere kontekst (Aalborg, 9000)

Fortolkning af lokationskoden

• location-værdien er specifik for transportøren, ikke et postnummer.
• Koder som 9010 eller 0705 er identifikatorer for terminaler eller sorteringscentre.
• Kombiner med cityName og postalCode for at give brugerne et klarere billede.