Wie E-Commerce-Marken mit Abonnementmodellen wiederkehrende Sendungen mithilfe einer Tracking-API verfolgen können
Um wiederkehrende Sendungen mit einer Tracking-API zu verfolgen, erstellen Sie für jedes physische Paket einen Sendungsdatensatz, verknüpfen Sie ihn mit dem Fulfillment-Auftrag für diesen Abonnementzyklus und registrieren Sie die Trackingnummer, sobald Ihr Lager oder Fulfillment-Partner sie bereitstellt. Verwenden Sie die Tracking-Updates der API, um Kunden anzuzeigen, wo sich das Paket befindet, und Lieferausnahmen für Ihr Team zu markieren. Behalten Sie die Abonnement-ID als Verknüpfung zwischen den Zyklen bei, nicht als Kennung eines Pakets.

Verfolgen Sie das Paket, nicht das Abonnement
Ein Abonnement informiert Sie darüber, was ein Kunde im Laufe der Zeit erhalten soll. Ein Fulfillment-Auftrag informiert Sie darüber, was in einem Zyklus versendet werden muss. Eine Trackingnummer informiert Sie über ein bestimmtes Paket. Durch die getrennte Verwaltung dieser Datensätze verhindern Sie, dass eine verspätete Sendung aus einem Zyklus auf der Trackingseite des nächsten Zyklus erscheint.
Angenommen, eine Abonnementbox für Mai wird in zwei Pakete aufgeteilt und die Juni-Box wird versendet, während sich ein Mai-Paket noch im Transport befindet. Der Kunde sollte unter der Mai-Bestellung zwei Pakete und unter der Juni-Bestellung ein separates Paket sehen. Das verspätete Mai-Update sollte nur das Mai-Paket ändern. Wenn Sie einen Ersatz versenden, erstellen Sie einen neuen Sendungsdatensatz und verknüpfen Sie ihn mit dem ursprünglichen, damit der Support sehen kann, warum beide existieren.
- Abonnement: Speichern Sie die Abonnement-ID, damit der Support die Versandhistorie des Kunden finden kann.
- Zyklus und Bestellung: Erfassen Sie die Zykluskennung oder das geplante Fulfillment-Datum, die Bestell-ID und alle benötigten Fulfillment-IDs, um Pakete der richtigen Bestellung zuzuordnen. Leiten Sie den Zyklus nicht aus dem Datum ab, an dem ein Tracking-Ereignis eintrifft.
- Sendung: Geben Sie jedem Paket eine interne Sendungs-ID. Speichern Sie den Transportdienst und die Trackingnummer, die relevante Fulfillment-Referenz sowie jede vom Anbieter zurückgegebene Tracking-Registrierungs-ID. Halten Sie stornierte Etiketten und ersetzte Trackingnummern aus der aktiven Kundenansicht fern, bewahren Sie den Verlauf jedoch für den Support auf.
Zeigen Sie auf einer Bestellseite den Fortschritt auf Paketebene zusammen mit einer Bestellübersicht an. Wenn ein Paket zugestellt und ein anderes unterwegs ist, geben Sie dies an. Zeigen Sie die gesamte Bestellung erst dann als zugestellt an, wenn alle für ihre Erfüllung erforderlichen Pakete eingetroffen sind, wobei stornierte Sendungen und Ersatzsendungen berücksichtigt werden.
Fulfillment mit der Tracking-API verbinden
- Aus einem Fulfillment-Ereignis registrieren. Lösen Sie die Registrierung aus, wenn ein Fulfillment-System, Lager oder Logistikpartner den Transportdienst und die Trackingnummer sendet. Eine Verlängerungszahlung kommt zu früh: Die Bestellung wartet möglicherweise noch auf den Versand, und es existiert eventuell noch keine Trackingnummer.
- Die Sendung vor dem API-Aufruf speichern. Speichern Sie den internen Sendungsdatensatz dauerhaft und stellen Sie die Registrierungsanfrage in eine Warteschlange. Wenn dieselbe Fulfillment-Nachricht zweimal eintrifft, verwenden Sie den vorhandenen Datensatz erneut, anstatt ein weiteres Paket zu erstellen. Wenn der API-Aufruf eine Zeitüberschreitung verursacht, prüfen Sie, ob die ursprüngliche Anfrage erfolgreich war, bevor Sie sie erneut senden, sofern der Anbieter dies ermöglicht.
- Updates dem registrierten Paket zuordnen. Verwenden Sie die Registrierungskennung des Anbieters, sofern sie in den Updates zurückgegeben wird. Ordnen Sie andernfalls anhand der in der Dokumentation angegebenen Kennungen zu und validieren Sie das Ergebnis anhand Ihrer Sendungsdatensätze. Wenn ein Update zu mehreren Datensätzen gehören könnte, senden Sie es zur Prüfung, anstatt es auf die neueste Bestellung anzuwenden.
- Etikettenerstellung und Transport durch den Dienstleister trennen. Eine Trackingnummer kann vorhanden sein, bevor der Transportdienst den Besitz des Pakets erfasst. Verwenden Sie eine Meldung wie „Vorbereitung der Abholung durch den Transportdienst“, wenn Ihnen nur ein Etikett vorliegt. Verwenden Sie „Unterwegs“ nur, wenn entsprechende Informationen des Transportdienstes vorliegen.
Die 17TRACK Tracking API ist eine Option für diese Einrichtung. Die Entwicklerdokumentation dient als Referenz für die Registrierung von Trackingnummern und den Empfang von Tracking-Updates. Verwenden Sie diese Updates, um den Paketdatensatz in Ihrem System zu pflegen; verwalten Sie die Zykluszuordnung, den Abschluss der Bestellung und die Regeln für Kundenbenachrichtigungen in Ihrer E-Commerce-Anwendung. Testen Sie vor der Einführung mit Paketen aus Ihren tatsächlichen Transportwegen und von Ihren Fulfillment-Partnern, anstatt sich allein auf eine Liste von Transportdiensten zu verlassen.
Updates sicher zweimal verarbeiten
Wenn Ihr Anbieter Webhooks bereitstellt, verwenden Sie diese, um Updates zu empfangen, ohne jedes Paket fortlaufend abzufragen. Ein Webhook ist eine HTTP-Anfrage, die der Anbieter an Ihre Anwendung sendet. Befolgen Sie die Verifizierungsanforderungen des Anbieters, speichern Sie akzeptierte Payloads dauerhaft und bestätigen Sie Anfragen gemäß den dokumentierten Antwortregeln. Führen Sie langsamere Aufgaben, etwa die Aktualisierung von Bestellansichten oder den Versand von E-Mails, außerhalb des Request-Handlers aus.
Entwickeln Sie den Verarbeitungspfad so, dass ein wiederholtes Update keine zusätzliche Wirkung hat. Wenn der Anbieter stabile Ereignis-IDs bereitstellt, verwenden Sie diese zur Erkennung von Wiederholungen. Wenn er Tracking-Snapshots statt einzelner Ereignisse sendet, vergleichen Sie den eingehenden Status und den Scanverlauf mit den bereits vorhandenen Daten, bevor Sie Maßnahmen ergreifen. Deduplizieren Sie Kundennachrichten separat: Eine bereits versendete Zustellbenachrichtigung sollte nicht erneut versendet werden, nur weil dieselben Sendungsdaten zweimal verarbeitet wurden.
Halten Sie den Zeitpunkt, zu dem ein Scan stattgefunden hat, getrennt von dem Zeitpunkt, zu dem Ihre Anwendung ihn empfangen hat. Ein verspätet eintreffender Scan „Unterwegs“ kann in den Paketverlauf aufgenommen werden, ohne einen neueren Status „Zugestellt“ zu ersetzen. Gehen Sie jedoch nicht davon aus, dass jede legitime Änderung ein Paket voranbringt. Eine Korrektur des Transportdienstes oder ein Update zur Rücksendung an den Absender kann eine Änderung der Anzeige erfordern. Wenn die neuen Daten mit dem gespeicherten Status kollidieren und Sie nicht feststellen können, welcher korrekt ist, stellen Sie die Sendung in eine Prüfwarteschlange.
Führen Sie regelmäßig eine Prüfung offener Sendungen durch, bei denen möglicherweise Handlungsbedarf besteht: noch ausstehende Registrierungen, Pakete ohne ersten Scan nach einer erwarteten Übergabe und Sendungen, deren Tracking verstummt ist. Wenn die API eine Abfrage oder Aktualisierung unterstützt, verwenden Sie diese gezielt innerhalb der Grenzen des Anbieters. Prüfen Sie das Muster über mehrere Transportdienste und Lager hinweg, bevor Sie eskalieren. Wenn Updates bei vielen unabhängigen Sendungen gleichzeitig ausbleiben, untersuchen Sie zunächst die Integration, bevor Sie einzelne Lieferfälle eröffnen.
Trackingdaten in nützliche Kundennachrichten umwandeln
Kunden benötigen selten für jeden Scan eine E-Mail. Beginnen Sie mit Nachrichten, die an etwas geknüpft sind, das sie wissen oder tun müssen: Das Paket ist in das Netzwerk des Transportdienstes eingegangen, ein Zustellversuch erfordert eine Handlung oder der Transportdienst meldet die Zustellung. Zeigen Sie die Bestellreferenz sowie das relevante Paket oder den Zyklus an, damit Abonnenten erkennen können, auf welche Sendung sich die Nachricht bezieht. Identifizieren Sie bei einer geteilten Bestellung das Paket und machen Sie deutlich, ob der Rest der Bestellung noch unterwegs ist.
- Etikett erstellt, kein Scan: Vergleichen Sie die erwartete Übergabe mit den Lageraufzeichnungen. Wenn das Übergabefenster abgelaufen ist, bitten Sie das Fulfillment-Team zu bestätigen, ob das Paket die Anlage verlassen hat, bevor Sie dem Kunden mitteilen, dass es sich im Transport verspätet.
- Tracking bewegt sich nicht mehr: Verwenden Sie Schwellenwerte, die Strecke und Service widerspiegeln, statt für jedes Paket denselben Timer einzusetzen. Prüfen Sie bei grenzüberschreitenden Sendungen das letzte Ereignis des Transportdienstes, bevor Sie entscheiden, ob Sie den Kunden kontaktieren oder eskalieren.
- Fehlgeschlagener Zustellversuch oder Abholung erforderlich: Teilen Sie dem Kunden mit, welche Handlung erforderlich ist, sofern der Transportdienst klare Anweisungen bereitstellt. Ist das Ereignis unklar, leiten Sie den Fall an den Support weiter, statt einen erneuten Zustelltermin oder Abholort zu erraten.
- Als zugestellt markiert, aber nicht erhalten: Bewahren Sie den vom Transportdienst gemeldeten Status und eröffnen Sie einen separaten Supportfall. Ihr Supportprozess sollte zwischen einer Kundenmeldung und einer Korrektur des Transportdienstes unterscheiden.
Geben Sie den Supportmitarbeitern eine einheitliche Ansicht des Zyklus, der Bestellung, des Paketverlaufs und der bereits versendeten Nachrichten. Weisen Sie jeder Ausnahme einen Verantwortlichen und einen nächsten Schritt zu. Das Fulfillment-Team kann eine fehlende Übergabe untersuchen, die Logistik kann eine Ausnahme beim Transportdienst verfolgen und der Support kann die Kundenkommunikation übernehmen. Ein Trackingstatus beschreibt das Paket; er entscheidet nicht darüber, ob ein Ersatz oder eine Rückerstattung fällig ist.
Die Überschneidung vor der Einführung testen
Beginnen Sie mit einem Fulfillment-Partner und einer Gruppe von Sendungen, die dessen tatsächliche Versandweise widerspiegelt. Schließen Sie einen Zyklus mit mehreren Paketen, einem ungültig gemachten Etikett, einem Ersatz und einer älteren noch offenen Sendung ein, wenn der nächste Zyklus versendet wird. Spielen Sie anschließend absichtlich einen doppelten Webhook erneut ab und liefern Sie ein älteres Ereignis nach einem neueren aus. Prüfen Sie den Paketdatensatz, die Kundenbestellseite, die Supportansicht und das Benachrichtigungsprotokoll. Ein Test, der nur eine erfolgreiche API-Antwort überprüft, kann den kostspieligsten Fehler übersehen: die Aktualisierung der falschen Bestellung oder die Benachrichtigung des falschen Kunden.
Überwachen Sie Registrierungsfehler, den Anteil der erfolgreich registrierten geeigneten Pakete, verspätete erste Scans und nicht zugeordnete Updates. Wenn Sie die Update-Latenz verfolgen, unterscheiden Sie zwischen der Zeit vom Ereignis des Transportdienstes bis zum Empfang und der Zeit, die Ihr eigenes System für die Verarbeitung benötigt. So können Sie entscheiden, ob Sie einen Datenfeed des Transportdienstes, Ihren Webhook-Endpunkt oder eine Warteschlange innerhalb Ihrer Anwendung untersuchen müssen.
Erweitern Sie die Abdeckung auf weitere Strecken, sobald Sie für jedes Paket drei Fragen beantworten können: Zu welchem Zyklus gehört es? Was hat der Transportdienst zuletzt gemeldet? Wer handelt, wenn das Update fehlt oder falsch ist? Wenn eine Antwort unklar ist, korrigieren Sie die Datensatzzuordnung oder den Ausnahmeprozess, bevor Sie weitere Benachrichtigungsregeln hinzufügen.
FAQ
Kann eine Tracking-API Kunden mitteilen, wann ihre nächste Abonnementbox versendet wird?
Verwenden Sie Ihren Abonnementzeitplan und Ihr Fulfillment-System für das nächste geplante Versanddatum. Eine Tracking-API ist für ein bestimmtes Paket vorgesehen, sobald Trackinginformationen vorhanden sind. Ein geplantes Versanddatum, eine vom Transportdienst geschätzte Lieferzeit und eine bestätigte Zustellung sind unterschiedliche Fakten und sollten separat gekennzeichnet werden.
Was ist, wenn das Lager eine Trackingnummer ersetzt, nachdem eine E-Mail versendet wurde?
Markieren Sie das alte Etikett als ersetzt und verknüpfen Sie die neue Trackingnummer mit derselben Bestellung. Wenn Ihre E-Mail auf eine Trackingseite auf Bestellungsebene verweist, aktualisieren Sie diese Seite, damit der Kunde das aktive Paket finden kann, ohne den ursprünglichen Link des Transportdienstes zu benötigen. Senden Sie eine Korrektur, wenn die Änderung Informationen betrifft, nach denen der Kunde handeln muss.
Was ist, wenn ein Fulfillment-Partner Trackingnummern ohne Transportdienst-Codes sendet?
Bitten Sie den Partner um ein einheitliches Feld für den Transportdienst oder um eine Zuordnung seiner Versanddienst-Codes. Wenn Ihre API eine Erkennung des Transportdienstes anbietet, prüfen Sie vor dem Einsatz, wie sie mit den Etiketten des Partners funktioniert. Leiten Sie unklare Zuordnungen zur Prüfung weiter, anstatt einen Transportdienst allein anhand der Trackingnummer auszuwählen.
Benötigen pausierte oder übersprungene Abonnements Trackingdatensätze?
Für einen Zyklus, der nie versendet wird, ist kein Paketdatensatz erforderlich. Wenn eine frühere Sendung noch offen ist, verfolgen Sie sie weiter, auch wenn das Abonnement pausiert, übersprungen oder gekündigt wurde. Der Abonnementstatus steuert das zukünftige Fulfillment; er sagt nicht aus, was mit einem Paket geschehen ist, das das Lager bereits verlassen hat.
Quellen
- 17TRACK Tracking API — Produktübersicht zur Integration der Paketverfolgung in Geschäftssysteme.
- Dokumentation der 17TRACK Tracking API — Implementierungsreferenz für die Registrierung von Trackingnummern und den Empfang von Trackingdaten.
- Stripe-Webhooks-Dokumentation — Referenz für allgemeine Webhook-Praktiken, etwa den Umgang mit doppelten Ereignissen und die Vermeidung von Annahmen über die Reihenfolge der Zustellung. Befolgen Sie für Verifizierung und Bestätigungen die eigenen Regeln Ihres Tracking-Anbieters.


