Diese Anleitung bietet detaillierte Informationen zur Einrichtung und Verwaltung der EasyPost-Integration in unserem System. EasyPost ist ein leistungsstarker Versand-API-Aggregator, der Ihnen Zugang zu zahlreichen internationalen Versanddienstleistern über eine einzige Schnittstelle bietet.
EasyPost ist eine moderne Versand-API-Plattform, die als Vermittler zwischen Ihrem System und dutzenden von Versanddienstleistern weltweit fungiert. Statt separate Integrationen für jeden Carrier zu pflegen, verbinden Sie sich einmal mit EasyPost und erhalten Zugang zu allen verfügbaren Services.
Hauptvorteile von EasyPost:
Vereinfachte Integration : Eine API für alle CarrierInternationale Abdeckung : Zugang zu Carriern weltweitAutomatische Ratenkalkulation : Vergleich von Versandkosten in EchtzeitFlexibilität : Einfacher Wechsel zwischen verschiedenen CarriernSkalierbarkeit : Von kleinen bis zu großen Versandvolumen
¶ Verfügbare VersanddienstleisterÜber EasyPost erhalten Sie Zugang zu zahlreichen internationalen Carriern, darunter:
DHL (Express, eCommerce, Paket)UPS (verschiedene Services)FedEx (Express, Ground, International)USPS (Priority, Express, First Class)Hermes (Deutschland und International)DPD (National und International)GLS (Paket Services)Und viele weitere...
Hinweis: Die verfügbaren Carrier und Services hängen von Ihrer Region, Ihrem EasyPost-Account und Ihren Carrier-Verträgen ab.
Import aller verfügbaren Versanddienstleister mit einem Klick
Automatische Erkennung aller verfügbaren Services pro Carrier
Zentrale Verwaltung aller EasyPost-Versandprodukte
Intelligente Service-Erkennung basierend auf verschiedenen Versandszenarien
Flexible Anpassung und Löschung einzelner Carrier oder Services
Einfache Aktualisierung bei Änderungen in Ihrem EasyPost-Account
Bevor Sie die Integration einrichten können, benötigen Sie einen aktiven EasyPost-Account:
Besuchen Sie https://www.easypost.com
Registrieren Sie sich für einen Account (Test- oder Production-Account)
Verifizieren Sie Ihre E-Mail-Adresse
Schließen Sie die Kontoeinrichtung ab
Nach erfolgreicher Registrierung:
Melden Sie sich im EasyPost Dashboard an
Navigieren Sie zu API Keys im Menü
Sie sehen zwei Arten von Schlüsseln:
Test API Key : Für Entwicklung und Tests (beginnt mit EZTK...)Production API Key : Für den Live-Betrieb (beginnt mit EZAK...)
Kopieren Sie den entsprechenden API Key
⚠️ Wichtiger Unterschied:
Test Keys : Kostenlos, keine echten Versandlabels, ideal zum TestenProduction Keys : Echte Versandlabels, echte Kosten, für den Produktivbetrieb
Beginnen Sie immer mit einem Test Key, bevor Sie in die Produktion gehen!
Für die Nutzung von EasyPost müssen Sie Ihre Carrier-Accounts verbinden:
Gehen Sie im EasyPost Dashboard zu Carriers
Klicken Sie auf Add Carrier Account
Wählen Sie den gewünschten Carrier aus
Geben Sie Ihre Carrier-Zugangsdaten ein (z.B. DHL API Key, UPS Account-Nummer)
Testen Sie die Verbindung
Wiederholen Sie dies für alle gewünschten Carrier
Hinweis: Sie benötigen separate Verträge mit den jeweiligen Carriern. EasyPost ist der Vermittler, aber die Carrier-Accounts müssen Sie selbst haben.
Der EasyPost API Key ermöglicht unserem System:
Lesezugriff:
Abruf verfügbarer Carrier und Services
Ratenkalkulation für Versandkosten
Adressvalidierung
Tracking-Informationen
Schreibzugriff:
Erstellung von Versandlabels
Stornierung von Sendungen
Adresserstellung
So verbinden Sie EasyPost zum ersten Mal:
Navigieren Sie zu Versand → EasyPost Integration
Sie sehen die Karte "EasyPost Versanddienstleister"
Geben Sie Ihren API Key ein
EasyPost API Key
Fügen Sie Ihren API Key ein
Format: Beginnt mit EZTK... (Test) oder EZAK... (Production)
Den Key finden Sie im EasyPost Dashboard unter API Keys
Klicken Sie auf Versanddienstleister importieren
Das System verbindet sich mit der EasyPost API
Der Import-Prozess startet automatisch
Der Import-Prozess ist intelligent und umfassend:
Carrier-Erkennung : Das System identifiziert alle in Ihrem EasyPost-Account verfügbaren CarrierService-Discovery : Für jeden Carrier werden alle verfügbaren Services ermitteltSzenario-Tests : Das System testet verschiedene Versandszenarien:
Deutschland → Deutschland (Inland)
Deutschland → Österreich (EU)
Deutschland → UK (Europa, außerhalb EU)
Deutschland → USA (Interkontinental)
Deutschland → Schweden (EU Nord)
Deutschland → Schweiz (Europa, Zollgebiet)
Service-Aggregation : Alle erkannten Services werden zusammengeführtDatenbank-Import : Carrier und Services werden in Ihr System importiert
Warum mehrere Szenarien? Verschiedene Carrier bieten unterschiedliche Services für verschiedene Zielregionen. Durch Tests mehrerer Szenarien stellen wir sicher, dass Sie Zugang zu allen verfügbaren Services erhalten.
Nach Abschluss des Imports sehen Sie:
Anzahl der importierten Anbieter (Carrier)
Anzahl der importierten Services
Erfolgs- oder Fehlermeldung
Beispiel: "Erfolgreich 8 Anbieter und 47 Services von EasyPost importiert"
Nach erfolgreicher Verbindung wird Ihr API Key (maskiert) angezeigt:
Format: EZAK****...****1234 (nur Anfang und Ende sichtbar)
Dies dient Ihrer Sicherheit und Privatsphäre
API-Schlüssel ändern
Klicken Sie auf API-Schlüssel ändern
Geben Sie einen neuen API Key ein
Klicken Sie auf Aktualisieren & Importieren
Services werden mit dem neuen Key neu importiert
Neu importieren
Klicken Sie auf Neu importieren
Verwendet den vorhandenen API Key
Aktualisiert alle Carrier und Services
Nützlich nach Änderungen in EasyPost (z.B. neuer Carrier verbunden)
Konto löschen
Klicken Sie auf Konto löschen
Bestätigen Sie die Löschung
Löscht API Key und alle importierten EasyPost-Daten
Diese Aktion kann nicht rückgängig gemacht werden!
Nach erfolgreichem Import sehen Sie den Bereich "EasyPost Anbieter verwalten" mit einer Übersicht aller importierten Carrier.
Die Tabelle zeigt alle importierten Carrier mit folgenden Informationen:
Name
Vollständiger Name des Carriers mit "EasyPost"-Präfix
Beispiel: "EasyPost DHL", "EasyPost UPS"
Das Präfix hilft, EasyPost-Carrier von anderen Quellen zu unterscheiden
Anbieter-ID
Eindeutige 5-stellige ID für den Carrier im System
Format: Numerisch (z.B. 90001, 90002)
Wird automatisch beim Import vergeben
Status
Aktiv (grün): Carrier ist verfügbar und kann verwendet werdenInaktiv (rot): Carrier ist deaktiviert
Services
Zeigt die Anzahl der verfügbaren Services für diesen Carrier
Beispiel: Badge mit "12" = 12 verschiedene Versandoptionen
Aktionen
Services : Zeigt/verbirgt die Service-Liste für diesen CarrierLöschen : Entfernt den Carrier und alle seine Services
Um die Services eines Carriers anzusehen:
Klicken Sie auf Services neben dem gewünschten Carrier
Eine erweiterte Ansicht öffnet sich mit allen Services
Die Service-Tabelle zeigt:
Service Name : Technischer Name des ServicesAnzeigename : Benutzerfreundlicher Name im Format "EasyPost Carrier - Service"Service-ID : Eindeutige 5-stellige IDStatus : Aktiv/InaktivAktionen : Löschen-Button für einzelne Services
Typische Services, die Sie nach dem Import sehen könnten:
EasyPost DHL:
EasyPost DHL - Express Worldwide
EasyPost DHL - Express 12:00
EasyPost DHL - Express 9:00
EasyPost DHL - Economy Select
EasyPost DHL - Paket National
EasyPost DHL - Europaket
EasyPost UPS:
EasyPost UPS - Express
EasyPost UPS - Express Saver
EasyPost UPS - Standard
EasyPost UPS - Expedited
EasyPost UPS - Ground
EasyPost USPS:
EasyPost USPS - Priority Mail
EasyPost USPS - Priority Mail Express
EasyPost USPS - First Class Package
EasyPost USPS - Parcel Select
Ein Neu-Import ist sinnvoll, wenn:
Sie einen neuen Carrier in EasyPost verbunden haben
Carrier neue Services anbieten
Services deaktiviert wurden
Sie sicherstellen möchten, dass alle Services verfügbar sind
Nach längerer Zeit ohne Import
Klicken Sie auf Neu importieren (bei vorhandenem API Key)
Bestätigen Sie die Aktion im Dialog
Das System importiert alle Carrier und Services erneut
Vorhandene Daten werden aktualisiert
Neue Services werden hinzugefügt
Hinweis: Der Neu-Import überschreibt keine manuellen Anpassungen wie deaktivierte Services. Nur die Verfügbarkeit wird aktualisiert.
Neue Carrier : Werden hinzugefügtNeue Services : Werden für bestehende Carrier ergänztCarrier-Namen : Werden aktualisiert (falls geändert)Bestehende Services : Bleiben erhalten
Status-Einstellungen : Ihre Aktivierung/Deaktivierung bleibt erhaltenDrucker-Zuordnungen : Konfigurierte Drucker bleiben zugeordnetVersandregeln : Bestehende Regeln bleiben bestehenGelöschte Carrier/Services : Werden nicht automatisch wiederhergestellt
Um einen spezifischen Service zu entfernen:
Klicken Sie auf Services beim entsprechenden Carrier
Suchen Sie den gewünschten Service in der Liste
Klicken Sie auf den Löschen -Button
Bestätigen Sie die Löschung im Dialog
Der Service wird sofort entfernt
Verwendung:
Wenn Sie bestimmte Services nicht anbieten möchten
Bei veralteten oder nicht mehr verfügbaren Services
Zur Vereinfachung der Service-Auswahl
Um einen Carrier mit allen seinen Services zu entfernen:
Klicken Sie auf Löschen neben dem Carrier
Bestätigen Sie die Löschung im Dialog
Der Carrier und alle seine Services werden gelöscht
Zuordnungen zu Druckern werden ebenfalls entfernt
⚠️ Warnung: Diese Aktion kann nicht rückgängig gemacht werden! Der Carrier muss neu importiert werden, um ihn wiederherzustellen.
Verwendung:
Wenn Sie einen Carrier nicht mehr nutzen
Bei Carrier-Verträgen, die gekündigt wurden
Zur Bereinigung ungenutzter Carrier
Um die komplette EasyPost-Integration zu entfernen:
Klicken Sie auf Konto löschen
Lesen Sie die Warnung sorgfältig
Bestätigen Sie die Löschung
Folgende Daten werden gelöscht:
API Key
Alle EasyPost-Carrier
Alle EasyPost-Services
Alle zugehörigen Zuordnungen
⚠️ Achtung: Diese Aktion ist endgültig und kann nicht rückgängig gemacht werden!
Verwendung:
Beim Wechsel zu einem anderen Versand-Aggregator
Wenn Sie EasyPost nicht mehr nutzen möchten
Bei Account-Wechsel (löschen, dann neu verbinden)
¶ Integration in den VersandprozessNach erfolgreichem Import stehen alle Services in Ihrem System zur Verfügung:
In Versandregeln:
Wählen Sie EasyPost-Services als Versandoptionen
Kombinieren Sie verschiedene Carrier basierend auf Kriterien
Beispiel: "DHL für Deutschland, UPS für USA"
In der Bestellabwicklung:
EasyPost-Services erscheinen in der Versandprodukt-Auswahl
Erkennbar am "EasyPost"-Präfix
Direkte Auswahl beim Versenden einer Bestellung
In Carrier-Zuordnungen:
Verknüpfen Sie EasyPost-Services mit Bestellquellen
Beispiel: Shopify-Bestellungen → EasyPost DHL Express
Wenn Sie eine Bestellung mit einem EasyPost-Service versenden:
System sendet Anfrage an EasyPost API
EasyPost kommuniziert mit dem gewählten Carrier
Versandlabel wird erstellt
Label wird an konfigurierten Drucker gesendet
Tracking-Nummer wird gespeichert
EasyPost-Gebühren:
EasyPost berechnet eine kleine Gebühr pro Label
Zusätzlich zu den Carrier-Kosten
Transparente Preisgestaltung im EasyPost Dashboard
Carrier-Kosten:
Werden direkt mit dem jeweiligen Carrier abgerechnet
Basierend auf Ihrem Vertrag mit dem Carrier
EasyPost zeigt Kosten vor Label-Erstellung an
Problem
Mögliche Lösung
"Import fehlgeschlagen"
Überprüfen Sie Ihren API Key auf Tippfehler
"Unauthorized"
API Key ist ungültig - prüfen Sie Test vs. Production
"Keine Services gefunden"
Keine Carrier in EasyPost verbunden - verbinden Sie Carrier
"Rate Limit erreicht"
Zu viele Anfragen - warten Sie einige Minuten
"Timeout"
EasyPost antwortet nicht - versuchen Sie es später erneut
"Invalid API Key format"
API Key muss mit EZTK oder EZAK beginnen
API Key kann nicht gefunden werden:
Melden Sie sich bei EasyPost an
Gehen Sie zu API Keys im Dashboard
Kopieren Sie den gesamten Key (nicht nur einen Teil)
Achten Sie auf Leerzeichen am Anfang/Ende
Test vs. Production Keys:
Test Keys (EZTK...) für Entwicklung und Tests
Production Keys (EZAK...) für echten Versand
Verwenden Sie den richtigen Key für Ihre Umgebung
Test Keys erstellen keine echten Labels
Carrier nicht verfügbar:
Überprüfen Sie, ob Carrier in EasyPost verbunden ist
Gehen Sie zu EasyPost Dashboard → Carriers
Fügen Sie fehlende Carrier-Accounts hinzu
Testen Sie Carrier-Verbindung in EasyPost
Führen Sie einen Neu-Import durch
Wenige Services nach Import:
Nicht alle Carrier sind in allen Regionen verfügbar
Einige Services erfordern spezielle Carrier-Verträge
Business-Accounts haben mehr Services als Basic-Accounts
Überprüfen Sie Ihre EasyPost Account-Stufe
Bestimmte Services fehlen:
Service ist in Ihrem EasyPost-Account nicht verfügbar
Carrier-Vertrag deckt diesen Service nicht ab
Service ist regional nicht verfügbar
Führen Sie einen Neu-Import durch
Services werden nicht angezeigt:
Überprüfen Sie den Status (Aktiv/Inaktiv)
Services könnten versehentlich gelöscht worden sein
Führen Sie einen Neu-Import durch
Prüfen Sie Filter in der Service-Auswahl
Label-Erstellung schlägt fehl:
Überprüfen Sie Adressdaten (Vollständigkeit, Format)
Gewicht und Abmessungen müssen angegeben sein
Service ist für diese Route nicht verfügbar
Carrier-Account hat Probleme (prüfen Sie EasyPost Dashboard)
Import dauert sehr lange:
Import testet mehrere Szenarien - dies ist normal
Bei vielen Carriern kann es 1-2 Minuten dauern
Warten Sie auf die Bestätigungsmeldung
Brechen Sie den Vorgang nicht ab
Import bricht ab:
Überprüfen Sie Ihre Internetverbindung
EasyPost API könnte temporär nicht verfügbar sein
Versuchen Sie es in einigen Minuten erneut
Kontaktieren Sie Support bei wiederholten Problemen
Keine oder wenige Carrier importiert:
Keine Carrier in EasyPost verbunden
API Key ist Test-Key ohne Carrier-Accounts
EasyPost-Account ist nicht vollständig eingerichtet
Überprüfen Sie EasyPost Dashboard
Langsame Label-Erstellung:
EasyPost benötigt Zeit zur Carrier-Kommunikation
Internationale Sendungen dauern länger
Überprüfen Sie Ihre Internetgeschwindigkeit
Bei anhaltenden Problemen Support kontaktieren
Zu viele Services:
Löschen Sie nicht benötigte Services
Deaktivieren Sie ungenutzte Carrier
Vereinfachen Sie die Auswahl für Benutzer
Verwenden Sie Versandregeln für Automatisierung
Das System zeigt detaillierte Fehlermeldungen an:
API-Fehler mit EasyPost-spezifischen Codes
Import-Probleme mit betroffenen Carriern
Verbindungsschwierigkeiten mit technischen Details
Label-Erstellungsfehler mit Carrier-Feedback
Support kontaktieren: Notieren Sie sich die vollständige Fehlermeldung und Screenshots. Kontaktieren Sie unser Support-Team unter support@beeship.io mit folgenden Informationen:
Fehlermeldung (vollständig)
Verwendeter API Key-Typ (Test/Production)
Betroffener Carrier/Service
Zeitpunkt des Fehlers
API Key Management:
Verwenden Sie Test Keys für Entwicklung und Tests
Wechseln Sie zu Production Keys erst nach gründlichen Tests
Bewahren Sie Keys sicher auf (Passwort-Manager)
Rotieren Sie Keys regelmäßig aus Sicherheitsgründen
Carrier-Auswahl:
Verbinden Sie nur Carrier, die Sie tatsächlich nutzen
Zu viele Carrier erschweren die Übersicht
Starten Sie mit 2-3 Hauptcarriern
Erweitern Sie bei Bedarf
Service-Management:
Löschen Sie ungenutzte Services
Benennen Sie Services klar und eindeutig
Gruppieren Sie Services nach Verwendungszweck
Dokumentieren Sie, welcher Service wofür genutzt wird
Regelmäßige Wartung:
Führen Sie monatlich einen Neu-Import durch
Überprüfen Sie neue verfügbare Services
Entfernen Sie veraltete Services
Aktualisieren Sie Versandregeln bei Änderungen
API-Schlüssel schützen:
Behandeln Sie API Keys wie Passwörter
Teilen Sie Keys niemals mit Dritten
Speichern Sie Keys verschlüsselt
Bei Kompromittierung sofort neuen Key generieren
Zugriffsverwaltung:
Beschränken Sie Zugriff auf EasyPost-Integration
Nur Administratoren sollten API Keys verwalten können
Protokollieren Sie Änderungen an Carrier-Konfiguration
Überprüfen Sie regelmäßig aktive Verbindungen
Test- vs. Production-Umgebung:
Verwenden Sie separate Keys für Test und Production
Testen Sie Änderungen immer zuerst mit Test Key
Production Keys nur in Live-Umgebung verwenden
Niemals Production Key in Test-Systemen
Daten-Backup:
EasyPost speichert Ihre Label-Historie
Exportieren Sie wichtige Versanddaten regelmäßig
Dokumentieren Sie Ihre Carrier-Konfiguration
Bewahren Sie Kopien von Labels für Buchhaltung auf
Service-Auswahl:
Vergleichen Sie Kosten verschiedener Services
Nutzen Sie Economy-Services wo möglich
Vermeiden Sie Express-Services für nicht-zeitkritische Sendungen
Prüfen Sie Carrier-Rabatte in Ihren Verträgen
Volume-Vorteile:
Höhere Versandvolumen = bessere Carrier-Konditionen
Verhandeln Sie bessere Raten bei wachsendem Volumen
Nutzen Sie EasyPost's transparente Preisübersicht
Vergleichen Sie Carrier-Preise regelmäßig
Automatisierung:
Verwenden Sie Versandregeln für automatische Service-Auswahl
Reduzieren Sie manuelle Eingriffe
Minimieren Sie Fehlversendungen durch Automatisierung
Sparen Sie Zeit und Kosten
Effiziente Carrier-Struktur:
Hauptcarrier für Standardversand
Backup-Carrier für Ausfälle
Spezial-Carrier für besondere Anforderungen
Express-Carrier für eilige Sendungen
Versandregeln einrichten:
Automatische Service-Auswahl nach Zielland
Gewichtsbasierte Carrier-Wahl
Kundengruppen-spezifische Services
Zeitbasierte Auswahl (z.B. Express für Same-Day-Orders)
Prozess-Integration:
Integrieren Sie EasyPost in Ihren Gesamt-Workflow
Schulen Sie Mitarbeiter in Service-Auswahl
Dokumentieren Sie Best Practices
Etablieren Sie klare Prozesse für Problemfälle
Qualitätssicherung:
Überprüfen Sie Labels vor dem Drucken
Validieren Sie Adressen vor Label-Erstellung
Tracken Sie Probleme mit bestimmten Services
Sammeln Sie Feedback von Mitarbeitern
EasyPost-Ressourcen:
Carrier-Dokumentation:
Links zu einzelnen Carrier-Websites
Tracking-Portale der Carrier
Carrier-spezifische Versandbedingungen
Bei Problemen mit der Integration:
E-Mail: support@beeship.io
Geben Sie immer Ihre Tenant-ID an
Beschreiben Sie das Problem detailliert
Fügen Sie Screenshots bei (ohne API Keys!)
Nennen Sie betroffene Carrier/Services
Bei EasyPost-Problemen:
EasyPost Support: support@easypost.com
Beschreiben Sie, ob Problem nur in EasyPost oder auch in Integration auftritt
Geben Sie EasyPost-Account-Informationen an
Bei Carrier-Problemen:
Kontaktieren Sie den jeweiligen Carrier direkt
Halten Sie Ihre Account-Nummer bereit
Beschreiben Sie spezifische Label- oder Versandprobleme
Für spezifische Fragen zu:
Versandregeln : Siehe Dokumentation "Versandregeln"Drucker-Konfiguration : Siehe Dokumentation "Drucker-Setup"Label-Erstellung : Siehe Dokumentation "Versandprozess"Tracking : Siehe Dokumentation "Sendungsverfolgung"
Brauche ich Verträge mit allen Carriern? Ja, EasyPost ist nur ein Vermittler. Sie benötigen eigene Accounts bei den Carriern, die Sie nutzen möchten.
Kann ich EasyPost und direkte Carrier-Integrationen parallel nutzen? Ja, Sie können beides parallel verwenden. EasyPost-Services haben das "EasyPost"-Präfix zur Unterscheidung.
Was kostet EasyPost? EasyPost berechnet eine kleine Gebühr pro erstelltem Label, zusätzlich zu den Carrier-Kosten. Details finden Sie auf der EasyPost Pricing-Seite.
Wie oft sollte ich neu importieren? Empfohlen wird ein monatlicher Neu-Import, oder immer dann, wenn Sie Änderungen in EasyPost vorgenommen haben.
Kann ich eigene Service-Namen vergeben? Die Display-Namen werden automatisch generiert. Für individuelle Bezeichnungen verwenden Sie am besten Versandregeln mit aussagekräftigen Namen.
Was passiert, wenn ich meinen API Key ändere? Das System importiert automatisch alle Services mit dem neuen Key neu. Bestehende Konfigurationen bleiben erhalten.