Zum Inhalt
HALOWERK

Handelswerk

parcel normalize

Does two things that every shipping integration rebuilds and every one of them differently. First, carrier detection: the number is matched against the known formats and, where the format carries one, the check digit is actually computed — the UPS 1Z digit, the Universal Postal Union S10 digit and the GS1 mod-10 digit. This matters because pattern alone does not separate the formats: twelve digits can be DHL Paket or FedEx, fourteen can be GLS, DPD or Hermes.

POST https://handel.halowerk.com/v1/parcel-normalize

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
tracking_numberstringNeinTracking number to identify. Spaces and hyphens are ignored.
eventsarrayNeinCarrier status messages to normalize onto the common vocabulary.
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "tracking_number": {
      "type": "string",
      "minLength": 4,
      "maxLength": 40,
      "description": "Tracking number to identify. Spaces and hyphens are ignored."
    },
    "events": {
      "type": "array",
      "maxItems": 200,
      "description": "Carrier status messages to normalize onto the common vocabulary.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "status": {
            "type": "string",
            "maxLength": 500,
            "description": "Raw status text from the carrier, German or English."
          },
          "timestamp": {
            "type": "string",
            "maxLength": 40,
            "description": "Optional time of the event, passed through unchanged."
          },
          "location": {
            "type": "string",
            "maxLength": 200,
            "description": "Optional location, passed through unchanged."
          }
        }
      }
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "tracking_number": "1Z999AA10123456784",
  "events": [
    {
      "status": "Sendung wurde im Paketzentrum bearbeitet",
      "timestamp": "2026-08-12T08:00:00Z"
    },
    {
      "status": "Zustellversuch nicht erfolgreich, Benachrichtigung hinterlassen"
    }
  ]
}

Ergebnis & Dokumentation

Veröffentlichtes Ergebnisschema anzeigen
{
  "$ref": "https://handel.halowerk.com/v1/parcel-normalize/schema#/outputSchema"
}

Veröffentlichtes Ergebnisbeispiel öffnen

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →