Zum Hauptinhalt springen
Zu nevuto.com

EasyPost mit Nevuto verbinden

Veröffentlicht am 22. Mai 20267 Min. Lesezeit

Was ist EasyPost?

EasyPost ist ein US-basierter Multi-Carrier-Versand-Aggregator. Über eine einzige API erreichst du USPS, UPS, FedEx, DHL Express, OnTrac und mehr als 100 weitere Carrier für US-Inlands- und internationalen Versand. Der Fokus liegt auf US-Inlandssendungen, internationale Lieferungen werden aber ebenfalls unterstützt.

Wie Nevuto EasyPost verwaltet

  • Du fügst einen API-Key ein; Nevuto richtet die Webhook-Verbindung automatisch ein.
  • Neue EasyPost-Konten durchlaufen eine Anti-Fraud-Prüfung — darauf weisen wir dich vorab hin.
  • Bei jeder Sendung wird live die günstigste Rate gewählt, gefiltert nach deinen bevorzugten Carriern.
  • Alle Webhooks kommen signiert an; Nevuto verifiziert die Signatur für dich.
  • Test Key und Production Key werden beide unterstützt; Test mode lässt sich mit einem Toggle umschalten.

1. Voraussetzungen

  • Ein aktives EasyPost-Konto. Falls du noch keins hast, registriere dich unter easypost.com.
    • ⚠️ EasyPost führt bei neuen Konten eine Anti-Fraud-Prüfung durch. Innerhalb von 1-3 Werktagen nach der Registrierung bekommst du eine Mail mit ID-Verifizierung und Business-Details. Bis dein Konto aktiviert ist, kann der API-Key-Tab leer bleiben.
  • Mindestens ein Carrier Account muss in EasyPost verbunden sein. Im Free Tier ist ein USPS-Testkonto vorinstalliert; in Production kannst du deine eigenen USPS/UPS/FedEx-Verträge hinterlegen.
  • Deine Shop-Währung muss USD sein — EasyPost arbeitet nur in USD.
  • Die Absenderadresse sollte in den USA liegen (Standardfall); andere Länder sind eingeschränkt.
  • Du musst dein EasyPost Wallet aufladen (Labelkosten werden pro Sendung abgebucht). Settings → Billing.

2. EasyPost API key

  1. Melde dich im EasyPost-Dashboard an.
  2. Account Settings → API Keys (https://app.easypost.com/account/settings?tab=api-keys).
  3. Kopiere deinen Test Key oder Production Key.
  4. Ist dein Konto noch nicht aktiv, ist der "API Keys"-Tab eventuell leer. Das bedeutet, die Anti-Fraud-Prüfung läuft noch; antworte auf die Signup-Mail oder schreibe an den Support.

⚠️ Mit dem Test Key werden Testlabels erzeugt (ohne Berechnung). Der Production Key druckt echte Carrier-Labels und bucht dein Wallet ab.

3. EasyPost in Nevuto verbinden

  1. Öffne im Nevuto-Adminpanel Settings → Shipping → Shipping providers.
  2. Wähle EasyPost aus der Liste.
  3. Füge deinen EasyPost-Token ins API key-Feld ein.
  4. Aktiviere den Toggle Enable shipping method.
  5. (Optional) Test mode Toggle: aktiviere ihn, wenn du einen Test Key benutzt.
  6. Klicke auf Submit.

Beim Submit übernimmt Nevuto:

  • Speichert den API-Key sicher
  • Richtet die Webhook-Verbindung automatisch in deinem EasyPost-Konto ein — kein manueller Schritt nötig
  • Empfängt alle Webhooks signiert; Nevuto prüft die Authentizität für dich

4. Preferred carrier accounts

Nach dem Speichern öffnet sich darunter eine Settings-Karte:

  1. Wähle eine oder mehrere Carrier-Account-IDs aus dem Preferred carriers-Dropdown.
  2. Das Dropdown wird live aus deinem EasyPost-Konto geladen — du siehst nur Carrier, die in deinem Konto aktiv sind.
  3. Submit.

Verhalten:

  • Bei jeder Sendung holt Nevuto die EasyPost-Ratenliste, filtert nach deinen bevorzugten Carriern und kauft die günstigste Rate.
  • Ohne Auswahl wird die günstigste Rate über alle aktiven Carrier hinweg gewählt.

💡 Im Dropdown erscheinen die Carrier mit ihren lesbaren Namen (USPS, UPS, FedEx usw.).

5. Absenderadresse

EasyPost nutzt deine Absenderadresse bei jeder Sendung. Nevuto bezieht sie aus deinem Default Store Location:

  1. Settings → Locations.
  2. Fülle die Default Location als US-Adresse aus:
    • Street, City, State (Kurzcode: CA, NY), ZIP, Country (US), Phone

⚠️ Wir empfehlen die Telefonnummer im internationalen Format einzugeben: +12125551234. Das lokale Format wird ebenfalls akzeptiert, das internationale Format ist aber am zuverlässigsten.

6. Shipping packages

EasyPost fragt bei jeder Sendung nach Paketmaßen. Nevuto löst sie in dieser Reihenfolge auf:

  1. Variant LWH-Daten
  2. ShippingPackage-Referenz
  3. Default-Paket des Shops
  4. Fallback: 12×9×1 inch (USPS Flat Rate Envelope)

Schritte:

  1. Öffne Settings → Shipping → Packages.
  2. Add package → Name, Typ, L/W/H/Einheit, Gewicht.
  3. Set as default.

7. Variant LWH

Trage echte Maße und das Gewicht bei jeder Variante ein:

  1. Products → Produkt bearbeiten → Variants.
  2. Length / Width / Height / Weight.
  3. Einheiten: cm/in, Gewicht: g/kg/oz/lb.

💡 In den USA sind in (Inch) und oz (Ounce) Standard. EasyPost akzeptiert beide; Nevuto konvertiert automatisch.

8. Zollerklärung (international)

Bei Sendungen von den USA in andere Länder fügt Nevuto die Zollerklärung automatisch hinzu:

  • Items: Bestellzeilen (Produktbeschreibung, Menge, Gewicht, Wert, Ursprungsland)
  • US-Zollanforderungen: erforderliche Befreiungsmerkmale werden automatisch gesetzt
  • Currency: USD
  • Contents type: merchandise
  • Non-delivery option: return (bei Unzustellbarkeit Rücksendung)

HS-Code: Wird in Nevuto nicht pro Produkt gespeichert → wird leer übertragen. Du kannst ihn manuell im EasyPost-Panel ergänzen.

9. Bestellung versenden

Nachdem der Kunde bezahlt hat, taucht die Bestellung in deinem Adminpanel mit dem "Mark as shipped"-Button auf.

  1. Öffne die Bestelldetailseite.
  2. Klicke auf Mark as shipped.
  3. Wähle im Modal EasyPost als Provider und klicke Submit.
  4. Innerhalb weniger Sekunden erscheinen in der Bestellzeile eine Tracking-Nummer, ein Tracking-Link und ein "Print label"-Button. Gleichzeitig werden die Labelkosten von deinem EasyPost-Wallet abgebucht.
  5. Klicke auf Print label, um das Label als PDF zu öffnen, drucke es aus und klebe es aufs Paket.
  6. Übergib das Paket an deinen bevorzugten Carrier — der Rest wird automatisch nachverfolgt.

💡 Der Kunde kann die Sendung über den Tracking-Link in seiner eigenen Bestellseite verfolgen und erhält bei Statusänderungen E-Mail-Benachrichtigungen.

10. Status lifecycle

Mark as shipped
    │
    ▼
[shipping_status: PROCESSING]      ← Label gedruckt, Carrier hat noch nicht abgeholt
    │
    ▼   Wenn der Carrier das Paket scannt
[shipping_status: SHIPPED]         ← EasyPost-Webhook wird ausgelöst (tracker.updated)
    │
    ▼   An den Kunden zugestellt
[shipping_status: DELIVERED]       ← Webhook

EasyPost-Status-Mapping (Nevuto):

  • Unterwegs, in Transit, in Zustellung → Shipped
  • Zugestellt, abholbereit → Delivered
  • Retoure, Fehler, Storno → ignoriert

Die Webhook-Verbindung wird beim Setup automatisch eingerichtet und jede Benachrichtigung wird signaturgeprüft — keine manuelle Pflege nötig.

11. Test mode

EasyPost bietet eine echte Testumgebung:

  1. EasyPost Dashboard → API Keys → kopiere deinen Test Key.
  2. In Nevuto admin → Settings → Shipping → EasyPost → füge den Test Key ins API-key-Feld ein und aktiviere den Test mode-Toggle.
  3. Submit.
  4. Testsendungen liefern:
    • Eine Tracking-Nummer (Format EZ100…)
    • Ein PDF-Label (als Test markiert)
    • Keine Wallet-Belastung
    • Test-Benachrichtigungen
  5. Vor dem Go-Live den Test mode deaktivieren und auf den Live Key umstellen.

12. Häufige Probleme

A. Mail "We need a bit more information about your account"

  • EasyPost prüft neue Konten manuell. Beantworte die Fragen in der Mail und schließe den Stripe-ID-Verifizierungslink ab; innerhalb von 1-3 Werktagen wird dein Konto aktiviert.

B. API-Key-Tab wird nicht angezeigt

  • Konto noch nicht aktiviert (siehe A oben). Oder du hast "Personal" als Kontotyp gewählt, obwohl Business-Daten verlangt werden.

C. Kein Guthaben im Wallet, ich kann keine Labels drucken

  • EasyPost Dashboard → Account → Billing → Add funds, um dein Wallet aufzuladen. Im Test mode wird nichts abgebucht.

D. Fehler "Customs declaration is required for international"

  • Bei internationalen Sendungen werden Zolldaten benötigt. Prüfe, dass im Country-Feld der Kundenadresse das korrekte Land hinterlegt ist.

E. State-Name wird abgelehnt

  • EasyPost erwartet einen kurzen State-Code: CA, NY. Der volle Name (California) wird abgelehnt. Trage den State in Settings → Locations als Kurzcode ein.

F. Erscheint nicht in der Provider-Liste

  • Ist deine Shop-Währung nicht USD, erscheint die Warnung "Not available in your store currency".
  • Ist das Land deiner Shop-Adresse nicht US, erscheint die Warnung "Doesn't ship from your shop location".

G. Kein Webhook kommt an / Fehler "Unauthorized"

  • Wenn du den API-Key gewechselt hast, klicke im Nevuto-Admin erneut auf Submit — die Webhook-Verbindung wird neu aufgebaut und der Signaturschlüssel aktualisiert.

13. Nächste Schritte

  • Sobald die EasyPost-Anti-Fraud-Freigabe vorliegt, verbinde den API-Key und führe eine kleine Testsendung durch
  • Trage HS-Codes einmal pro Produkt im EasyPost-Panel ein — kritisch für internationale Bestellungen
  • Schlage auf deine Versandraten eine Marge auf

Hilfe

Verwandte Artikel