Versanddienstleister-APIs erklärt: UPS, FedEx, USPS, DHL & mehr
Versanddienstleister-APIs sind Softwareverbindungen, über die ein Shop, Lagerverwaltungssystem, Auftragsverwaltungssystem oder Kundenservice-Tool Versanddaten mit Dienstleistern wie UPS, FedEx, USPS und DHL austauschen kann. Sie können Aufgaben wie Tarifabfragen, die Erstellung von Versandetiketten, die Buchung von Sendungen, Tracking-Aktualisierungen, Adressprüfungen und Benachrichtigungen zu Zustellereignissen unterstützen. Der richtige API-Ansatz hängt weniger vom Namen des Versanddienstleisters ab als vom zu automatisierenden Workflow, den Ländern, in die Sie liefern, und den Systemen, die Sie bereits verwenden.
Eine Integration mit einem einzelnen Versanddienstleister kann gut funktionieren, wenn Ihr Versandvolumen und Ihr Liefergebiet vorhersehbar sind. Eine Multi-Carrier-API ist in der Regel praktischer, wenn ein Unternehmen Dienste vergleicht, international versendet oder ein einheitliches Tracking-Format über mehrere Dienstleister hinweg benötigt. Dieser Leitfaden erläutert die wichtigsten API-Typen, die grundlegenden Unterschiede zwischen den großen Versanddienstleistern und die Punkte, die Sie vor der Entwicklung oder dem Kauf einer Integration überprüfen sollten.
Was eine Versanddienstleister-API leistet
Eine API, also eine Programmierschnittstelle, definiert, wie zwei Softwaresysteme Anfragen und Antworten austauschen. Im Versand kann Ihre Anwendung Paketdaten, Absender- und Empfängeradressen, Servicepräferenzen und Zollinformationen senden. Der Versanddienstleister oder die Versandplattform gibt anschließend beispielsweise einen Versandtarif, Etikettendaten, eine Trackingnummer oder eine Fehlermeldung zurück.
APIs von Versanddienstleistern erfüllen normalerweise mehrere getrennte Funktionen:
- Tarifberechnung: Fordert eine geschätzte oder vertraglich vereinbarte Versandgebühr für ein Paket und einen Dienst an.
- Sendungserstellung: Übermittelt Sendungsdetails und erhält eine Trackingnummer oder eine Versandbestätigung.
- Etikettenerstellung: Erstellt ein druckbares Etikett, häufig als PDF, Bild oder Dokumentdaten.
- Tracking: Ruft, sofern verfügbar, Sendungsereignisse, Status, Standorte und Zustellinformationen ab.
- Adressdienste: Validiert, standardisiert oder ergänzt Adressinformationen, abhängig vom Versanddienstleister und dem Zielort.
- Abholung und Manifestierung: Unterstützt Abholanfragen oder Versanddokumente zum Tagesende, sofern Konto und Dienst dies erlauben.
- Benachrichtigungen: Übermittelt Statusinformationen durch Abruf, Webhooks, E-Mail-Funktionen oder einen anderen Ereignismechanismus.
Diese Funktionen sind nicht automatisch in jedem API-Konto eines Versanddienstleisters enthalten. Ein Versanddienstleister kann Dienste auf verschiedene Produkte aufteilen, eine Kontogenehmigung verlangen oder den Zugriff nach Land, Diensttyp, Kundenvereinbarung oder technischer Umgebung einschränken. Betrachten Sie jede Funktion als etwas, das in der aktuellen Dokumentation des Versanddienstleisters bestätigt werden muss, und nicht als etwas, das sich allein aus dem Vorhandensein einer API ableiten lässt.
Direkte APIs von Versanddienstleistern im Vergleich zu Multi-Carrier-APIs
Es gibt zwei praktische Integrationsmodelle. Eine direkte Integration verbindet Ihre Software mit der Entwicklerplattform eines einzelnen Versanddienstleisters. Eine Multi-Carrier-Integration verbindet Ihre Software mit einem Vermittler, der mehrere Versanddienstleister hinter einer gemeinsamen Schnittstelle vereinheitlicht.
| Modell | Vorteile | Nachteile | Am besten geeignet für |
|---|---|---|---|
| Direkte API des Versanddienstleisters | Direkter Zugriff auf die eigenen Dienste, Kontoregeln und Versanddaten des Versanddienstleisters | Separate Zugangsdaten, Formate, Tests, Fehlerbehandlung und Wartung für jeden Versanddienstleister | Ein Unternehmen mit einem Hauptversanddienstleister oder einem spezialisierten Versandworkflow |
| Multi-Carrier-API | Eine Integration kann Tracking, Auswahl des Versanddienstleisters und die vereinheitlichte Statusverarbeitung vereinfachen | Abdeckung, Funktionsumfang, Kont Anforderungen und kommerzielle Bedingungen unterscheiden sich je nach Anbieter | Multi-Carrier-E-Commerce, Marktplätze, 3PLs und grenzüberschreitende Abläufe |
Eine Multi-Carrier-API ersetzt nicht zwangsläufig die direkte Beziehung zu einem Versanddienstleister. Für einige Versandfunktionen können weiterhin ein Versanddienstleisterkonto, ausgehandelte Tarife, eine Genehmigung oder eine direkte Konfiguration erforderlich sein. Es lohnt sich außerdem zu prüfen, ob der Vermittler Etiketten erstellt, nur bestehende Sendungen verfolgt oder beides unterstützt.
Vergleich der APIs der wichtigsten Versanddienstleister
UPS API
UPS stellt Entwicklerressourcen bereit, um Geschäftsanwendungen mit UPS-Diensten zu verbinden. Abhängig von Konto, Region und Produkt können Entwickler Funktionen wie Tarifberechnung, Versand, Tracking, adressbezogene Dienste und Abholungsworkflows über die offizielle UPS-Entwicklerumgebung prüfen.
UPS wird häufig von Unternehmen in Betracht gezogen, die ein umfangreiches Paketgeschäft haben, Zugriff auf UPS-spezifische Dienste benötigen oder bereits ein UPS-Konto und einen Vertrag verwalten. Die praktische Frage lautet nicht einfach, ob UPS eine API besitzt. Entscheidend ist, ob der konkrete UPS-Dienst, die Abrechnungsvereinbarung, der Zielort und das Paketprofil über das für Ihr Konto verfügbare API-Produkt genutzt werden können.
Bestätigen Sie vor der Implementierung den aktuellen Authentifizierungsprozess, die Verfügbarkeit einer Sandbox, unterstützte Anfrageformate, die Etikettausgabe, die Tarifberechtigung, das Verhalten von Tracking-Ereignissen und die Migrationsanforderungen. Die Dokumentation und Produktnamen von UPS können sich ändern. Verwenden Sie daher das offizielle UPS-Entwicklerportal als Ausgangspunkt.
FedEx API
FedEx bietet eine Entwicklerplattform für Anwendungen, die mit FedEx-Versand- und Zustelldiensten arbeiten müssen. Die Dokumentation ist die geeignete Quelle, um verfügbare APIs, Zugangsdaten, Testumgebungen, Versandworkflows, Tracking und dienstspezifische Anforderungen zu prüfen.
FedEx kann eine gute Wahl sein, wenn ein Unternehmen auf FedEx-Dienste angewiesen ist oder eine dienstspezifische Kontrolle über Versand- und Tracking-Workflows benötigt. Der Integrationsaufwand kann mehr umfassen als das Senden einer Adresse und den Empfang eines Etiketts. Paketabmessungen, Dienstauswahl, Kontodetails, Zollinformationen, Vorschriften für Gefahrgut und internationale Dokumente können die Anfrage und Antwort beeinflussen.
Teams sollten sowohl erfolgreiche als auch fehlgeschlagene Anfragen testen. Eine Anwendung sollte beispielsweise wissen, wie sie mit einer ungültigen Adresse, einem nicht unterstützten Dienst, einer doppelten Versandanforderung, einem fehlenden Zollfeld und einem vorübergehenden Ausfall des Versanddienstleisters umgeht. Weitere Informationen zu aktueller Dokumentation und Zugangsanforderungen finden Sie im FedEx Developer Portal.
USPS API
USPS stellt Online-Ressourcen für Unternehmen und Entwickler bereit, deren Anwendungen USPS-Dienste nutzen. USPS ist besonders für inländische Paket- und Postabläufe in den USA relevant. Die genauen API-Produkte und Zugangsbedingungen sollten jedoch anhand der aktuellen offiziellen Dokumentation geprüft werden.
USPS-Integrationen erfordern sorgfältige Tests, da ein Unternehmen möglicherweise zwischen Postprodukten, Paketdiensten, Tracking-Ereignissen, Adressdaten sowie Etikett- oder Porto-Workflows unterscheiden muss. Eine reine Tracking-Anforderung unterscheidet sich erheblich von einer Anwendung, die Porto kaufen oder Versandetiketten erstellen muss.
Gehen Sie nicht davon aus, dass eine USPS-API dieselbe Anfragestruktur, Ereignisvokabular, Dienstverfügbarkeit oder dasselbe Kontomodell wie UPS oder FedEx besitzt. Prüfen Sie die USPS-Entwicklerressourcen und bestätigen Sie, welche Produkte für Ihren Anwendungsfall, geografischen Umfang und Ihre Kontostruktur verfügbar sind. Wenn Ihr Unternehmen lediglich eine einheitliche Tracking-Ansicht über mehrere Versanddienstleister hinweg benötigt, kann eine Tracking-orientierte Multi-Carrier-API weniger individuelle Logik für Versanddienstleister erfordern als mehrere direkte Integrationen.
DHL API
DHL ist eine Unternehmensgruppe mit unterschiedlichen Logistik- und Paketdiensten. Daher ist „die DHL API“ kein universelles Produkt für jede Sendung. Die Entwicklerressourcen von DHL decken APIs und Tools im Zusammenhang mit den eigenen Diensten ab. Das relevante Produkt hängt jedoch von der DHL-Geschäftseinheit, dem Zielort, dem Sendungstyp und der Kontobeziehung ab.
DHL ist eine naheliegende Option für internationale Sendungen, Expressdienste und grenzüberschreitende Abläufe. Dennoch muss die richtige Integration weiterhin auf den gekauften Dienst abgestimmt werden. Prüfen Sie vor der Gestaltung des Workflows, ob die Dokumentation für DHL Express, E-Commerce-Paketdienste, Fracht oder ein anderes DHL-Angebot gilt.
Prüfen Sie unterstützte Länder, Zoll- und Handelsrechnungsfelder, Servicecodes, Tracking-Verhalten, Etikettenformate und Anforderungen für die Kontoeröffnung im DHL Developer Portal. Beziehen Sie bei internationalen Implementierungen einen Prozess zur Behandlung von Zollausnahmen und unvollständigen Dokumenten ein, anstatt Tracking als den gesamten Lebenszyklus einer Sendung zu betrachten.
Andere Versanddienstleister
Unternehmen benötigen möglicherweise auch regionale oder nationale Versanddienstleister wie Canada Post, Royal Mail, Australia Post, DPD, GLS oder Japan Post. Ihre APIs unterscheiden sich hinsichtlich Abdeckung, Einrichtung, Dienstnamen, Detailtiefe der Tracking-Ereignisse, Etikettenformaten und Unterstützung internationaler Sendungen. „Mehr Versanddienstleister“ ist daher nicht automatisch besser. Die Abdeckung sollte anhand der tatsächlich genutzten Transportwege, Dienste und Sendungstypen gemessen werden.
Prüfen Sie für einen für Ihren Betrieb wichtigen Versanddienstleister zunächst dessen eigene Entwicklerinformationen. Wenn der Versanddienstleister über eine Drittanbieterplattform unterstützt wird, bestätigen Sie, ob die Integration direkt erfolgt, ob Sie Ihre eigenen Zugangsdaten für den Versanddienstleister bereitstellen und welche Funktionen verfügbar sind. Tracking-Unterstützung bedeutet nicht, dass auch Tarifberechnung, Etikettenerstellung oder Stornierung von Sendungen unterstützt werden.
Tracking-API oder vollständige Versand-API?
Viele Projekte verwenden den Begriff „Versand-API“, obwohl sie tatsächlich Sendungsverfolgung benötigen. Diese Bereiche sind unterschiedlich. Eine Tracking-API akzeptiert normalerweise eine Trackingnummer und einen Versanddienstleister und gibt anschließend vereinheitlichte Ereignisse oder einen aktuellen Status zurück. Eine vollständige Versand-API kann Tarife, Etiketten, Sendungserstellung, Zolldokumente und Tracking abdecken.
Wenn Ihr Hauptziel darin besteht, den Zustellfortschritt auf einer E-Commerce-Website, in einem Kundenportal oder in einem Support-Tool anzuzeigen, kann eine Tracking-orientierte Integration ausreichen. Die Tracking API von 17TRACK ist ein Beispiel für ein Multi-Carrier-Tracking-Produkt. Vor der Einführung sollte die Dokumentation verwendet werden, um die aktuelle Abdeckung der Versanddienstleister, Anfrageformate, Authentifizierung und das Verhalten von Ereignissen zu überprüfen.
Wenn Sie Porto kaufen oder Etiketten erstellen müssen, reicht Tracking allein nicht aus, um den Workflow abzuschließen. Sie benötigen möglicherweise direkte Konten bei Versanddienstleistern, eine Versandplattform oder eine Multi-Carrier-Versand-API mit dokumentierten Etikettenfunktionen. Durch die frühzeitige Trennung dieser Anforderungen wird ein häufiger Implementierungsfehler vermieden: die Auswahl eines Tracking-Produkts und die spätere Feststellung, dass es die für Ihr Lager erforderliche Sendung nicht erstellen kann.
Was Sie vor der Auswahl einer API prüfen sollten
1. Definieren Sie den Geschäftsworkflow
Notieren Sie die genaue Aktion, die das System ausführen muss. Beispiele sind „Tracking-Ereignisse anzeigen, nachdem eine Bestellung versendet wurde“, „den günstigsten berechtigten Dienst auswählen“, „ein Etikett im Lager erstellen“ oder „einen Kunden benachrichtigen, wenn sich die Zustellung verzögert“. Jede Aktion hat andere Daten-, Fehlerbehandlungs- und Betriebsanforderungen.
2. Ordnen Sie Versanddienstleister Transportwegen und Diensten zu
Listen Sie Absenderländer, Zielländer, Pakettypen, Servicelevel, Retourenabläufe und alle eingeschränkten Waren auf. Ein Versanddienstleister kann technisch unterstützt werden und dennoch für einen bestimmten Transportweg oder Dienst ungeeignet sein. Berücksichtigen Sie bei internationalen Sendungen Zollinformationen, Zölle, Steuern und Handelsdokumente in den Anforderungen.
3. Bestätigen Sie Zugangs- und kommerzielle Voraussetzungen
Prüfen Sie, ob die API ein Konto beim Versanddienstleister, eine Abrechnungseinrichtung, eine Genehmigung, ausgehandelte Tarife, ein Anwendungstoken oder eine Produktionsprüfung erfordert. Test- und Produktionszugangsdaten können sich unterscheiden. Speichern Sie niemals Produktionsgeheimnisse in Browsercode oder öffentlichen Repositories. Verwenden Sie eine sichere serverseitige Integration und wechseln Sie Zugangsdaten gemäß Ihrer Sicherheitsrichtlinie regelmäßig aus.
4. Vergleichen Sie die Datenqualität und nicht nur die Anzahl der Endpunkte
Fragen Sie, wie die API Sendungsstatus, voraussichtliche Zustellung, Zustellausnahmen, Zustellnachweise, Scans, Retouren und Sendungen mit mehreren Paketen darstellt. Eine lange Liste von Endpunkten garantiert keine nützliche Detailtiefe bei Ereignissen. Legen Sie fest, wie Ihre Anwendung Status wie Etikett erstellt, unterwegs, in Zustellung, zugestellt, Ausnahme und retourniert vereinheitlicht.
5. Testen Sie Fehler- und Änderungsszenarien
Eine produktionsreife Integration muss Zeitüberschreitungen, Ratenbegrenzungen, doppelte Anfragen, ungültige Adressen, fehlende Scans, Ausfälle von Versanddienstleistern, geänderte Trackingnummern sowie verspätete oder ungeordnet eintreffende Ereignisse verarbeiten. Verwenden Sie Idempotenz, sofern die API dies unterstützt, speichern Sie Anfragekennungen und gestalten Sie Wiederholungen sicher. Trackingsysteme sollten außerdem Zeiträume ohne neuen Scan tolerieren, anstatt jede Ruhephase als Fehler zu behandeln.
6. Bewerten Sie die Wartungskosten
APIs von Versanddienstleistern ändern sich. Versionsaktualisierungen, Zertifikatsänderungen, Änderungen von Servicecodes, neue Zollfelder und abgeschaltete Endpunkte können den Betrieb beeinflussen. Fragen Sie, wer Änderungen an der Dokumentation überwacht, wer für die Reaktion auf Vorfälle verantwortlich ist und wie schnell die Integration aktualisiert werden kann. Ein Multi-Carrier-Anbieter kann die Zahl der von Ihrem Team zu wartenden Integrationen reduzieren, führt aber eine Abhängigkeit ein, die hinsichtlich Betriebskontinuität und Supportqualität bewertet werden sollte.
Ein praktischer Entscheidungsrahmen
Wählen Sie eine direkte API eines Versanddienstleisters, wenn ein Versanddienstleister den Großteil Ihrer Sendungen abwickelt, Sie dienstspezifische Funktionen benötigen und Ihr Team die Integration warten kann. Wählen Sie eine Multi-Carrier-Versand-API, wenn Sie Tarife, Etiketten und Sendungserstellung über mehrere Versanddienstleister hinweg in einem Workflow benötigen, sofern die erforderlichen Dienste tatsächlich unterstützt werden.
Wählen Sie eine Multi-Carrier-Tracking-API, wenn die Hauptanforderung ein einheitliches Tracking-Erlebnis über Versanddienstleister, Kanäle oder Länder hinweg ist. Dies kann für E-Commerce-Teams nützlich sein, die ein gemeinsames Statusmodell nach dem Kauf wünschen, ohne für jeden Versanddienstleister separate Tracking-Parser zu entwickeln. Wenn Sie sowohl Etikettenerstellung als auch Tracking benötigen, prüfen Sie, ob ein Anbieter beides unterstützt, oder planen Sie eine zweiteilige Architektur.
Beginnen Sie bei einem neuen Projekt mit einem kleinen Proof of Concept. Testen Sie eine inländische Sendung, gegebenenfalls eine internationale Sendung, eine fehlgeschlagene Anfrage, ein Ausnahmeereignis sowie eine Retoure oder ein Stornierungsszenario. Vergleichen Sie die zurückgegebenen Daten mit der kundenorientierten Tracking-Seite des Versanddienstleisters und Ihren betrieblichen Erwartungen. Erst danach sollten Sie sich zu einer breiteren Einführung verpflichten.
FAQ
Kann eine API eines einzelnen Versanddienstleisters Tarife, Etiketten und Tracking bereitstellen?
Manchmal, aber dies sollte nicht vorausgesetzt werden. Diese Funktionen können separate Produkte sein oder unterschiedliche Kontoberechtigungen erfordern. Bestätigen Sie jede Funktion, jeden Dienst, jedes Land und jede Anforderung an Zugangsdaten in der aktuellen Dokumentation des Versanddienstleisters.
Ist eine Multi-Carrier-API immer besser als eine direkte Integration?
Nein. Eine Multi-Carrier-API kann den Entwicklungsaufwand reduzieren, wenn Sie gemeinsame Workflows über mehrere Versanddienstleister hinweg benötigen. Eine direkte Integration kann jedoch besseren Zugriff auf dienstspezifische Funktionen oder Kontrollen bieten. Die bessere Wahl hängt von den benötigten Funktionen und den Wartungskosten ab, die Sie tragen können.
Benötige ich ein Konto bei einem Versanddienstleister, um eine Versand-API zu nutzen?
Oft, insbesondere für Etikettenerstellung, Porto, Abrechnung oder ausgehandelte Tarife. Die Anforderungen unterscheiden sich je nach Versanddienstleister, Produkt, Land und Anbieter. Bestätigen Sie die kommerziellen und technischen Regeln für die Einrichtung, bevor Sie die Integration entwickeln.
Was ist der Unterschied zwischen Trackingnummern und Sendungs-IDs?
Eine Trackingnummer ist die Kennung, mit der ein Paket im Netzwerk eines Versanddienstleisters verfolgt wird. Eine Sendungs-ID kann eine Transaktion, eine Paketgruppe, eine Etikettenanfrage oder einen internen Datensatz identifizieren. Eine Sendung kann mehrere Pakete enthalten. Daher sollte Ihr Datenmodell nicht davon ausgehen, dass eine Bestellung immer genau einer Trackingnummer entspricht.
Wie sollte ein Team zwischen UPS, FedEx, USPS und DHL wählen?
Beginnen Sie mit den Transportwegen, Diensten, Paketprofilen, Kontobedingungen und erforderlichen API-Funktionen, anstatt allein nach der Marke zu wählen. Testen Sie anschließend die Dokumentation und tatsächlichen Antworten des Versanddienstleisters für Ihre häufigsten nationalen und internationalen Szenarien.
