Dieser Artikel erklärt, wie man einen Standortcode (z. B. Terminal- oder Standortcode wie 9010 oder 0705) aus Versandereignissen abruft, wenn man mit der ShipmentData API arbeitet. Der Fokus liegt darauf, wo sich die Daten in der Antwort befinden und wie man sie interpretiert.

Authentifizierungs-Voraussetzungen

Bevor Sie die ShipmentData API aufrufen, benötigen Sie ein Zugriffstoken:

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

Sobald Sie Ihre client_id und client_secret gegen ein Token eingetauscht haben, verwenden Sie dieses Token im Authorization: Bearer-Header für Ihre API-Aufrufe.

Schritt 1: Zugriffstoken erhalten

Verwenden Sie cURL, um Ihr Zugriffstoken zu erhalten:

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

Beispielantwort:

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

Schritt 2: Versanddaten per Barcode abfragen

Um Ereignisse abzurufen, die Standortcodes enthalten können, verwenden Sie den Aggregated-by-Barcode-Endpunkt.

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

Die Antwort enthält Informationen auf Versand- und Paketeebene, einschließlich Ereignissen.

Wo der Standortcode erscheint

Das location-Feld ist in einigen Ereignissen auf Paketeebene enthalten. Es repräsentiert typischerweise den internen Standort- oder Terminalcode eines Spediteurs.

• Ereignisse auf Paketeebene: shipment.lines[].packages[].events[].location (bevorzugt)

Wenn vorhanden, erscheint location zusammen mit:

• cityName
• postalCode
• country

• Optional coordinates mit Breiten- und Längengrad

   

Beispiel: Antwortausschnitt

Unten sehen Sie ein vereinfachtes Beispiel einer Antwort, die ein Paketereignis mit einem Standortcode zeigt:

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

In diesem Beispiel:

• Der location-Code ist 9010
• Der Ereignisstatus ist Out for delivery
• Stadt und Postleitzahl bieten zusätzlichen Kontext (Aalborg, 9000)

Interpretation des Standortcodes

• Der Wert location ist spediteurspezifisch, nicht eine Postleitzahl.
• Codes wie 9010 oder 0705 sind Kennungen für Terminals oder Sortierzentren.
• Kombinieren Sie ihn mit cityName und postalCode, um den Nutzern ein klareres Bild zu geben.