Skip to main content
StartseiteBlogAnleitungenSo verbinden Sie Versandverfolgungsdaten mit einem Oms: Auftragszuordnung und Synchronisierungsregeln

So verbinden Sie Versandverfolgungsdaten mit einem Oms: Auftragszuordnung und Synchronisierungsregeln

17TRACK

Um Sendungsverfolgungsdaten mit einem Bestellverwaltungssystem (OMS) zu verbinden, ordnen Sie jedes verfolgte Paket einem internen Sendungsdatensatz zu und verknüpfen Sie diese Sendung anschließend mit ihrer Bestellung und den Fulfillment-Positionen. Empfangen Sie Tracking-Aktualisierungen über die vom Anbieter unterstützte Schnittstelle, bewahren Sie die ursprünglichen Ereignisse auf und wenden Sie explizite Regeln für Duplikate, verspätete Aktualisierungen, den Sendungsstatus und den Bestellabschluss an. Verwenden Sie eine Sendungsnummer allein nicht als Bestellkennung und lassen Sie nicht zu, dass ein einzelnes Zustellereignis eine Bestellung mit mehreren Paketen automatisch abschließt.

So verbinden Sie Sendungsverfolgungsdaten mit einer OMS-Bestellung

Dieser Leitfaden richtet sich an Integrationsingenieure und E-Commerce-Operationsteams, die diese Verbindung implementieren. Das empfohlene Design trennt Beobachtungen des Versanddienstleisters von geschäftlichen Entscheidungen: Trackingdaten beschreiben die Reise eines Pakets, während das OMS entscheidet, was diese Reise für Fulfillment, Kundenkommunikation und Bestellabschluss bedeutet.

Definieren Sie, welches System für welchen Datensatz zuständig ist

Bevor Sie eine API-Verbindung aufbauen, stimmen Sie die Zuständigkeiten mit dem OMS-Administrator, dem Fulfillment-Team und dem Kundenservice ab. Andernfalls kann eine technisch erfolgreiche Integration dennoch gültige Geschäftsdaten überschreiben.

  • OMS: Ist für Bestellungen, Bestellpositionen, erforderliche Mengen, Stornierungen und die Regeln für den Bestellabschluss zuständig.
  • Fulfillment-System: Ist für die von ihm erstellten Sendungs- oder Paketdatensätze zuständig, einschließlich Packzuweisungen und Etikettenzuordnungen. Dabei kann es sich um das OMS selbst oder um ein separates Lagerverwaltungssystem handeln.
  • Tracking-Anbieter: Liefert Tracking-Beobachtungen und vom Anbieter definierte Statusklassifizierungen.
  • Integrationsschicht: Ist für Querverweise zwischen Kennungen, Ereignisverarbeitung, Normalisierung, Wiederholungsbehandlung und Prüfdatensätze der Synchronisierung zuständig.

Betrachten Sie diese Punkte als empfohlene Abgrenzungen, nicht als Annahmen über Ihre Software. Dokumentieren Sie Ausnahmen. Wenn das Lager beispielsweise ein Versandetikett ersetzen kann, benötigt die Integration eine ausdrückliche Aktualisierung dieses Systems, anstatt anzunehmen, dass eine neu beobachtete Nummer eine alte ersetzt.

Erstellen Sie die Zuordnung von Bestellung zu Paket, bevor Sie Status synchronisieren

Eine praktische Beziehung lautet Bestellung → Fulfillment → Paket → Tracking-Zuordnung. Ihr OMS kann andere Bezeichnungen verwenden oder einige dieser Datensätze zusammenfassen. Bewahren Sie die Beziehungen auch dann auf, wenn sich die Datenbankstruktur unterscheidet.

Eine Bestellung kann mehrere Fulfillments enthalten, und ein Fulfillment kann mehrere Pakete umfassen. Ein Paket kann außerdem eine ersetzte Tracking-Zuordnung oder eine verknüpfte Kennung für die letzte Meile erhalten. Diese Kennungen dürfen keine zusätzlichen Bestellmengen erzeugen.

DatensatzEmpfohlene FelderZweck
BestellungMandanten- oder Shop-ID, unveränderliche OMS-Bestell-IDTrennt Händler und verhindert die Abhängigkeit von angezeigten Bestellnummern.
FulfillmentFulfillment-ID, Bestell-ID, zugewiesene Positions-IDs und MengenIdentifiziert die gekauften Artikel, die erfüllt werden.
PaketInterne Paket-ID, Fulfillment-ID, sofern verfügbar PaketzuweisungenBietet eine stabile Identität unabhängig von Tracking-Etiketten.
Tracking-ZuordnungZuordnungs-ID, Paket-ID, Anbieter-Konto, Versanddienstleisterkennung, Sendungsnummer, GültigkeitszeitraumVerknüpft eingehende Tracking-Beobachtungen mit dem richtigen Paket und dem Lebenszyklus der Zuordnung.

Ordnen Sie Aktualisierungen über einen gespeicherten Querverweis zu

Wenn eine Sendung erstellt wird, speichern Sie ihre internen IDs, bevor Sie sie zur Verfolgung registrieren. Speichern Sie jede vom Anbieter vergebene Tracking-Datensatz-ID, die der dokumentierte Registrierungsvorgang zurückgibt. Wenn der Anbieter eine Händlerreferenz unterstützt, verwenden Sie eine undurchsichtige interne Referenz und bewahren Sie die Zuordnung lokal auf.

Bei eingehenden Aktualisierungen lösen Sie zunächst die gespeicherte Anbieter-Datensatz-ID innerhalb des richtigen Anbieter-Kontos und Mandanten auf. Wenn diese Kennung nicht verfügbar ist, verwenden Sie die dokumentierte Kombination aus Sendungsnummer, Identität des Versanddienstleisters, Kontokontext und Zuordnungshistorie. Behandeln Sie dies als Suchstrategie, nicht als Garantie, dass die Kombination global eindeutig ist.

Ordnen Sie nicht anhand des Kundennamens, der E-Mail-Adresse oder einer nicht mandantenbezogenen angezeigten Bestellnummer zu. Bewahren Sie Sendungsnummern als Zeichenfolgen auf, damit führende Nullen erhalten bleiben. Entfernen Sie keine Zeichen und ändern Sie die Groß-/Kleinschreibung nicht, es sei denn, der jeweilige Vertrag mit dem Versanddienstleister oder Anbieter erlaubt diese Normalisierung.

Wenn eine Suche keine oder mehrere mögliche Übereinstimmungen liefert, stellen Sie die Aktualisierung zur Untersuchung unter Quarantäne. Ein ungelöstes Ereignis ist sicherer als eine selbstsichere Aktualisierung der Bestellung des falschen Kunden.

Bearbeiten Sie Teillieferungen, ohne Paketzuordnungen zu erfinden

Betrachten Sie beispielhaft eine Bestellung mit drei Einheiten. Paket A enthält zwei Einheiten und Paket B eine. Die Zustellung von Paket A bedeutet, dass für zwei Einheiten ein Zustellnachweis vorliegt; sie bedeutet nicht, dass die gesamte Bestellung zugestellt wurde.

Wenn das Fulfillment-System lediglich erfasst, dass beide Pakete zum selben Fulfillment gehören, erfinden Sie keine Zuordnungen auf Einheitsebene. Sie können weiterhin berechnen, ob alle erforderlichen Pakete zugestellt wurden, aber die Zustellmeldung auf Artikelebene sollte nicht verfügbar oder ausdrücklich ungewiss bleiben, bis Zuordnungsdaten vorhanden sind.

Verbinden Sie die Tracking-API über eine robuste Erfassungsschicht

Verwenden Sie eine Pipeline, die die Kommunikation mit dem Anbieter von OMS-Schreibvorgängen trennt:

Sendungserstellung → Tracking-Registrierung → eingehende Aktualisierung oder geplanter Abruf → dauerhafte Ereignisspeicherung → Zuordnung und Normalisierung → OMS-Aktualisierung → Abgleich

Für eine 17TRACK-Implementierung sind die Produktseite der Tracking-API und die offizielle API-Dokumentation die relevanten Ausgangspunkte. Bestätigen Sie vor der Implementierung des Adapters die geltende Registrierungsschnittstelle, Versanddienstleisterkennungen, Optionen für die Zustellung von Aktualisierungen, Authentifizierungsanforderungen, Statusdefinitionen und Kontolimits. Das Datenmodell dieses Leitfadens ist eine Integrationsempfehlung und keine Behauptung, dass 17TRACK diese Feldnamen verwendet oder einen nativen Konnektor für Ihr OMS bereitstellt.

Wenn Ihr ausgewählter Anbieter Webhooks unterstützt, authentifizieren Sie eingehende Anfragen mit dem dokumentierten Verfahren und speichern Sie akzeptierte Nachrichten dauerhaft, bevor Sie sie bestätigen. Halten Sie langsame OMS-Arbeiten aus dem Anfragepfad heraus. Befolgen Sie den tatsächlichen Bestätigungs- und Wiederholungsvertrag des Anbieters, anstatt einen bestimmten Antworttext oder Timeout anzunehmen.

Wenn Polling erforderlich ist, speichern Sie den Abruffortschritt, sofern die API dies unterstützt, steuern Sie die Nebenläufigkeit und befolgen Sie die dokumentierten Ratenlimits. Weder der Empfang eines Webhooks noch eine erfolgreiche Polling-Anfrage beweist, dass das OMS aktualisiert wurde; erfassen Sie diese Ergebnisse getrennt.

Definieren Sie Synchronisierungsregeln, die Wiederholungen und verspätete Ereignisse überstehen

1. Machen Sie die Verarbeitung idempotent

Die zweimalige Verarbeitung derselben Beobachtung darf keine doppelte Sendung erzeugen, Mengen nicht zweimal fortschreiben und nicht erneut dieselbe Kundenbenachrichtigung senden. HTTP macht eine beliebige POST-Operation nicht idempotent; die Integration muss einen Duplikatschutz implementieren. RFC 9110 erläutert die Idempotenz von HTTP-Methoden.

Verwenden Sie eine stabile Anbieter-Ereignis-ID, sofern diese dokumentiert und verfügbar ist. Definieren Sie andernfalls einen Fingerabdruck aus der Zuordnungs-ID und relevanten Ereignisfeldern, etwa Ereigniszeitpunkt, Quellstatus und Ort. Dokumentieren Sie die Möglichkeit von Kollisionen oder geänderten Ereignisbeschreibungen. Bewahren Sie die Rohbeobachtung auch dann auf, wenn sie keine weitere OMS-Aktion auslöst.

Schützen Sie jede Nebenwirkung separat. Beispielsweise benötigen ein OMS-Statusschreibvorgang und eine E-Mail-Benachrichtigung jeweils eigene Deduplizierungssteuerungen. Verwenden Sie eine transaktionale Outbox oder einen gleichwertigen dauerhaften Arbeitsdatensatz, damit ein Prozessabsturz kein akzeptiertes Ereignis ohne geplante Aktualisierung zurücklässt.

2. Speichern Sie Ereigniszeit und Empfangszeit getrennt

Der Zeitpunkt des Auftretens eines Ereignisses und der Zeitpunkt, zu dem Ihre Integration es empfangen hat, beantworten unterschiedliche Fragen. Speichern Sie beide zusammen mit der ursprünglichen Darstellung des Zeitstempels und jedem angegebenen Zeitzonenversatz. Weisen Sie einem Ereignis mit unbekannter Zeitzone nicht stillschweigend die Lagerzeitzone zu.

Ein verspätet eintreffender Scan während des Transports sollte normalerweise die Historie ergänzen, ohne einen neueren Status „zugestellt“ zu ersetzen. Zeitstempel allein reichen jedoch nicht aus: Ein Anbieter kann eine Korrektur ausstellen, und Ereignisse können unvollständige Zeitangaben enthalten. Verwenden Sie, sofern verfügbar, dokumentierte Sequenz- oder Revisionsfelder sowie eine ausdrückliche Korrekturrichtlinie.

3. Normalisieren Sie Status, ohne Quelldetails zu löschen

Erstellen Sie ein kleines internes Vokabular, das das OMS versteht, etwa Annahme durch den Versanddienstleister ausstehend, unterwegs, in Zustellung, zugestellt, Ausnahme und Rücksendung. Ordnen Sie die dokumentierten Status des Anbieters diesem Vokabular zu. Dies sind vorgeschlagene interne Kategorien, keine universellen Definitionen von Versanddienstleistern.

Speichern Sie den ursprünglichen Statuscode, die Beschreibung, den Ereignisort, die Referenz des Anbieter-Datensatzes und die Version der Zuordnungsregel. Ein nicht zugeordneter Wert sollte einen überprüfbaren Zustand erzeugen, statt standardmäßig als zugestellt oder fehlgeschlagen zu gelten. Die Erstellung eines Etiketts darf nicht als Nachweis der physischen Annahme durch den Versanddienstleister behandelt werden, sofern das Quellereignis diese Interpretation nicht ausdrücklich unterstützt.

4. Verwenden Sie Übergangsregeln statt einer einfachen numerischen Rangfolge

Sendungszustände bilden nicht immer eine gerade Linie. Auf eine Ausnahme kann ein normaler Transport folgen, und ein Zustellversuch ist keine Zustellung. Eine Rücksendung kann nach einem früheren Zustellereignis beginnen.

  • Erlauben Sie, dass eine Ausnahme aufgehoben wird, wenn nachfolgende Nachweise eine wiederaufgenommene Bewegung belegen.
  • Verhindern Sie, dass ein gewöhnlicher historischer Scan einen Status „zugestellt“ stillschweigend ersetzt.
  • Erlauben Sie dokumentierte Korrekturen über einen kontrollierten Revisionspfad.
  • Verfolgen Sie Rücksendungen getrennt vom Abschluss des Hinversands, sofern das OMS dies unterstützt.
  • Leiten Sie mehrdeutige oder widersprüchliche Nachweise an eine operative Warteschlange weiter.

Versionieren Sie diese Regeln. Wenn sich eine Zuordnung ändert, entscheiden Sie, ob sie nur für neue Ereignisse gilt oder ob historische Datensätze kontrolliert neu berechnet werden müssen.

Berechnen Sie den Bestellstatus anhand der erforderlichen Fulfillment-Verpflichtungen

Paketstatus und Bestellstatus sollten getrennte Felder sein. Ein als zugestellt markiertes Paket liefert einen Nachweis für dieses Paket; der Bestellabschluss hängt von den verbleibenden erforderlichen Mengen und Ihrer Geschäftspolitik ab.

Eine sinnvolle Standardeinstellung ist, eine Bestellung erst dann als vollständig zugestellt zu markieren, wenn für alle zustellpflichtigen Mengen gültige Zustellnachweise auf Pak unaebene vorliegen und keine erforderlichen Zuordnungen ungelöst bleiben. Schließen Sie stornierte Mengen gemäß den Stornierungsregeln des OMS aus. Behandeln Sie digitale Artikel, Abholbestellungen und andere nicht zu versendende Verpflichtungen über eigene Abschlussbedingungen.

Ersatzsendungen erfordern ausdrückliche Beziehungen. Wenn ein verlorenes Paket ersetzt wird, entscheiden Sie, ob der Ersatz die ursprüngliche Zustellverpflichtung ablöst. Andernfalls kann das ursprüngliche Paket den Abschluss dauerhaft blockieren oder beide Pakete können für das Fulfillment zählen. Zeichnen Sie die Entscheidung auf, statt sie allein aus dem Trackingstatus abzuleiten.

Halten Sie den Zustellabschluss getrennt von finanziellem Abschluss, Rückerstattungsberechtigung und Streitbeilegung. Ein Zustellereignis des Versanddienstleisters sollte nicht automatisch eine Rückerstattung genehmigen oder eine Kundenforderung erledigen.

Stellen Sie Fehler wieder her, ohne die Prüfspur zu verlieren

Wiederholen Sie vorübergehende Fehler mit begrenztem Backoff und allen dokumentierten Hinweisen zur Wiederholung. Trennen Sie vorübergehende Verbindungsfehler von ungültigen Kennungen, abgelaufenen Zugangsdaten, Berechtigungsfehlern und inkompatiblen Schemata. Letztere erfordern Korrekturmaßnahmen und keine endlosen Wiederholungen.

Führen Sie eine Warteschlange für fehlgeschlagene Arbeiten mit dem betroffenen Mandanten, Paket, Ereignisverweis, versuchten Vorgang, der Fehlerklassifizierung und der nächsten Aktion. Protokollieren Sie ausreichend Kontext für Untersuchungen, ohne unnötige Kundendaten oder Zugangsdaten in Protokolle zu kopieren.

Führen Sie zusätzlich zum normalen Aktualisierungspfad einen Abgleich aus. Prüfen Sie aktive Sendungen mit veralteten Trackinginformationen, akzeptierte Ereignisse, deren OMS-Schreibvorgänge fehlgeschlagen sind, nicht zugeordnete Beobachtungen sowie Unterschiede zwischen dem berechneten Zustand der Integration und dem OMS. Wählen Sie die Prüfhäufigkeit anhand von Lieferzusagen, API-Limits und Betriebsrisiken, anstatt einen beliebigen universellen Zeitplan anzuwenden.

Weisen Sie Zuständigkeiten zu: Die Entwicklung bearbeitet Erfassungs- und Schreibfehler; der Fulfillment-Betrieb löst fehlende Paketbeziehungen; der Kundenservice prüft Ausnahmen, die eine Kundenkommunikation erfordern. Eine Warteschlange ohne verantwortlichen Eigentümer ist nur ein Speicherort.

Testen Sie Zuordnung und Geschäftsregeln vor dem Start

Verwenden Sie kontrollierte Testdaten und einen begrenzten Rollout in der Produktion. Testen Sie die folgenden Fälle sowohl anhand der Ereignishistorie als auch des resultierenden OMS-Datensatzes:

  • Eine Bestellung mit einem Paket durchläuft den normalen Prozess bis zur Zustellung.
  • Eine geteilte Bestellung hat ein zugestelltes Paket und ein weiteres, das sich noch bewegt.
  • Dasselbe Ereignis wird wiederholt empfangen, ohne doppelte Nebenwirkungen zu erzeugen.
  • Ein älterer Transitscan trifft nach der Zustellung ein.
  • Ein unbekannter Versanddienstleister oder Status gelangt in die Prüfwarteschlange.
  • Ein Etikett wird ersetzt, ohne eine weitere Fulfillment-Verpflichtung zu erzeugen.
  • Eine Ersatzsendung ersetzt gemäß einer genehmigten Regel ein ursprüngliches Paket.
  • Das OMS ist nicht verfügbar, nachdem ein Ereignis akzeptiert wurde.
  • Ein Prozess startet zwischen einem OMS-Schreibvorgang und dessen Bestätigung neu.
  • Dieselbe angezeigte Bestellnummer existiert in zwei Shops, ohne mandantenübergreifende Zuordnung.

Starten Sie, wenn jedes akzeptierte Ereignis ein nachvollziehbares Verarbeitungsergebnis besitzt, mehrdeutige Zuordnungen Bestellungen nicht automatisch aktualisieren können und Bediener fehlgeschlagene Arbeiten sicher wiederholen können. Dies sind nützlichere Abnahmekriterien als der bloße Nachweis, dass eine API-Anfrage erfolgreich ist.

FAQ

Kann ich Sendungsnummern direkt mit Bestellungen verbinden?

Für einen strikt auf ein Paket begrenzten Prozess kann eine direkte Beziehung zunächst ausreichen. Verwenden Sie dennoch eine interne Sendungsidentität zwischen Bestellung und Tracking-Zuordnung. Sie bietet einen Migrationspfad für Teilsendungen, neue Etikettierungen und Ersatzsendungen, ohne die Bedeutung des Bestelldatensatzes zu ändern.

Sollte die Integration Webhooks oder Polling verwenden?

Verwenden Sie den vom Anbieter unterstützten und mit Ihrer Infrastruktur kompatiblen Zustellmechanismus. Webhooks können wiederholte Abrufe reduzieren, während Polling abrufbasierte Prozesse und, sofern verfügbar, Abgleiche unterstützen kann. Keine der beiden Methoden macht dauerhafte Speicherung, Duplikatbehandlung und Wiederherstellung überflüssig.

Was soll geschehen, wenn ein Trackingereignis keiner Bestellung zugeordnet werden kann?

Speichern Sie es in einer Warteschlange für nicht zugeordnete Ereignisse und untersuchen Sie den Registrierungsdatensatz, den Mandantenkontext, die Identität des Versanddienstleisters und den Zeitpunkt der Sendungserstellung. Erstellen Sie nicht automatisch eine Bestellung und ordnen Sie das Ereignis nicht automatisch einem plausiblen Kunden zu. Wiederholen Sie die Verarbeitung, nachdem die Zuordnung korrigiert wurde.

Sollten Zustellbenachrichtigungen vom OMS oder vom Trackingsystem versendet werden?

Wählen Sie für jeden Benachrichtigungstyp und jeden Auslöser einen Verantwortlichen. Wenn zwei Systeme dieselbe Nachricht senden können, deaktivieren Sie einen Pfad oder teilen Sie ein dauerhaftes Benachrichtigungsregister. Entscheiden Sie außerdem, ob sich eine Nachricht auf ein Paket oder die vollständige Bestellung bezieht, insbesondere bei geteiltem Fulfillment.

Bedeutet ein Ausnahmestatus, dass die Bestellung fehlgeschlagen ist?

Nein. Eine Ausnahme ist eine Beobachtung, die interpretiert werden muss, und nicht unbedingt ein dauerhaftes Ergebnis. Bewahren Sie den Grund auf, überwachen Sie nachfolgende Ereignisse und verwenden Sie Ihre Eskalationsrichtlinie, um zu entscheiden, wann der Betrieb eingreifen sollte.

Quellen