Zum Hauptinhalt springen
Zu nevuto.com

Shippo mit Nevuto verbinden

Veröffentlicht am 22. Mai 20267 Min. Lesezeit

Was ist Shippo?

Shippo ist ein nordamerikanisch ausgerichteter Multi-Carrier-Versand-Aggregator. Über eine einzige API kannst du mit USPS, UPS, FedEx, DHL Express, Canada Post und vielen weiteren Carriern versenden — sowohl innerhalb der USA und Kanadas als auch international. Für Nevuto-Shops, die in den USA oder Kanada verkaufen, ist es eine der einfachsten Möglichkeiten, zuverlässigen Versand hinzuzufügen, ohne mit jedem Carrier einzeln zu verhandeln.

Wie Nevuto Shippo verwaltet

  • Nevuto verbindet sich über die offizielle API mit Shippo und richtet den Webhook automatisch ein — kein manueller Schritt nötig.
  • Bei der Abwicklung einer Bestellung holt Shippo Live-Preise von allen Carriern und wählt den günstigsten aus.
  • Für jede Nevuto-Bestellung wird per Klick ein druckfertiges Label-PDF erzeugt.
  • Tracking-Nummern und Statusaktualisierungen werden automatisch über Shippo-Webhooks synchronisiert.
  • Du kannst mit einem Live-Token in Produktion gehen oder den Ablauf mit Test tokens sicher testen.

1. Voraussetzungen

  • Ein aktives Shippo-Konto. Falls du noch keins hast, registriere dich auf goshippo.com.
  • Mindestens ein Carrier-Konto, das in Shippo verbunden ist (USPS ist standardmäßig aktiviert; für UPS/FedEx musst du dein eigenes Konto verknüpfen).
  • Deine Shop-Währung muss USD oder CAD sein — in anderen Währungen erscheint Shippo in der Provider-Liste als "Not available".
  • Das Land deiner Absenderadresse sollte US oder CA sein (Standardfall); in anderen Ländern ist die Abdeckung eingeschränkt.
  • Kontofinanzierung: Lade dein Shippo-Wallet auf oder hinterlege eine Kreditkarte. Jedes Label wird in Echtzeit abgebucht.

2. Shippo-API-Token

  1. Melde dich im Shippo-Dashboard an.
  2. Oben rechts → Settings → API.
  3. Erzeuge unter dem Reiter Live tokens einen Token (oder unter Test tokens für Tests).
  4. Kopiere den Token — du fügst ihn im nächsten Schritt in Nevuto ein.

⚠️ Ein Live-Token erzeugt echte Etiketten und belastet dein Konto. Nutze zum Testen den Test mode (siehe unten).

3. Shippo in Nevuto verbinden

  1. Gehe im Nevuto-Admin zu Settings → Shipping → Shipping providers.
  2. Wähle in der Liste Shippo aus.
  3. Füge deinen Shippo-Token in das Feld API key ein.
  4. Schalte den Toggle Enable shipping method ein.
  5. (Optional) Test mode: schalte ihn ein, wenn du einen Test-Token nutzt. Lass ihn aus, wenn du einen Live-Token nutzt.
  6. Klicke auf Submit.

Beim Submit macht Nevuto Folgendes:

  • Speichert den API-Key sicher
  • Richtet den Webhook automatisch in deinem Shippo-Konto ein — kein manueller Schritt
  • Löscht einen vorhandenen Webhook und registriert ihn neu (erneutes Submit erneuert ihn auf gleiche Weise)

4. Preferred carriers (bevorzugte Carrier)

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

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

Verhalten:

  • Beim Versand holt Shippo Angebote von allen Carriern → filtert auf deine bevorzugten → wählt den günstigsten.
  • Wählst du keinen aus, nutzt Shippo seinen eigenen "best value"-Vorschlag.
  • Bedient dein bevorzugter Carrier eine Route nicht, wird automatisch der günstigste verfügbare gewählt (die Bestellung wird nicht blockiert).

💡 Im Dropdown erscheinen deine Carrier mit lesbaren Namen (USPS, UPS, DHL Express usw.).

5. Sender address (Absenderadresse)

Shippo nutzt für jede Sendung deine Absenderadresse. Nevuto zieht sie aus dem Standard-Lager deines Shops:

  1. Gehe zu Settings → Locations.
  2. Trage deine Default-Location als US/CA-Adresse ein:
    • Street, City, State (Kurzcode: CA, NY usw.), ZIP, Country (US/CA), Phone

⚠️ Verwende für State einen Kurzcode (z. B. CA, NY, TX) — Shippo akzeptiert den vollen State-Namen nicht.

6. Shipping packages (Paket-Templates)

Shippo verlangt Paketmaße und Gewicht bei jeder Sendung. Nevuto ermittelt sie in dieser Reihenfolge:

  1. Variant-LWH-Werte
  2. ShippingPackage-Referenz
  3. Shop-Default-Paket
  4. Fallback: Shippos eigener Default (meist nicht passend)

Schritte:

  1. Gehe zu Settings → Shipping → Packages.
  2. Add package → Name, Typ, L/B/H/Einheit, Gewicht.
  3. Set as default → shop-weiter Fallback.

7. Variant LWH

Trage an jeder Variante die echten Maße und das Gewicht ein:

  1. Products → Produkt bearbeiten → Variants.
  2. Fülle Length / Width / Height / Weight aus.
  3. Einheit: cm/in, Gewicht: g/kg/oz/lb.

8. Customs declaration (international)

Beim Versand aus den USA/Kanada in ein anderes Land hängt Nevuto die Zollerklärung automatisch an:

  • Items: Bestellpositionen (Artikelbeschreibung, Menge, Gewicht, Wert, Ursprungsland)
  • US-Zollanforderungen: notwendige Befreiungsmarker werden automatisch hinzugefügt
  • Currency: Shop-Währung (USD/CAD)
  • Contents type: MERCHANDISE

HS-Code: wird in Nevuto nicht pro Produkt gespeichert → wird leer gesendet. Du kannst ihn bei Bedarf manuell im Shippo-Dashboard eintragen.

9. Eine Bestellung verschicken

Sobald die Kundschaft bezahlt hat, erscheint in deinem Admin der Button "Mark as shipped".

  1. Öffne die Bestelldetailseite.
  2. Klicke auf Mark as shipped.
  3. Wähle im Modal Shippo als Provider und submitte.
  4. Innerhalb weniger Sekunden erscheinen in der Bestellzeile die Tracking-Nummer, der Tracking-Link und der Button "Print label". Gleichzeitig wird das Etikett deinem Shippo-Konto in Rechnung gestellt.
  5. Klicke auf Print label, öffne das Etikett als PDF, drucke es und klebe es auf das Paket.
  6. Übergib das Paket deinem gewählten Carrier — die weitere Verfolgung läuft automatisch.

💡 Die Kundschaft kann das Paket über den Tracking-Link in ihrer Bestellseite verfolgen und bekommt zusätzlich E-Mail-Updates bei Statuswechsel.

10. Status-Lifecycle

Mark as shipped
    │
    ▼
[shipping_status: PROCESSING]      ← Etikett gedruckt, Carrier hat noch nicht abgeholt
    │
    ▼   Carrier scannt das Paket
[shipping_status: SHIPPED]         ← Shippo-Webhook löst aus
    │
    ▼   An die Kundschaft zugestellt
[shipping_status: DELIVERED]       ← Webhook

Der Webhook wird bei der Einrichtung automatisch verbunden — Shippo-Tracking-Updates kommen in Nevuto an und der Bestellstatus wird automatisch aktualisiert.

11. Test mode

Shippo bietet eine echte Testumgebung:

  1. Shippo-Dashboard → API → Reiter Test tokens → Token holen.
  2. In Nevuto: Settings → Shipping → Shippo → schalte Test mode ein und ersetze den API-Key durch den Test-Token.
  3. Submit.
  4. Test-Sendungen:
    • Liefern eine Tracking-Nummer
    • Erzeugen ein Label-PDF (Shippo-gebrandete Testseite)
    • Keine echte Abbuchung auf deinem Konto
    • Test-Webhooks werden gesendet
  5. Bevor du live gehst, Test mode ausschalten und den API-Key auf den Live-Token wechseln.

12. Häufige Probleme

A. Etikett wurde erstellt, aber Tracking aktualisiert sich nicht

  • Möglicherweise gibt es ein Problem bei der Shippo-Tarifwahl. Häufige Ursachen:
    • Adressvalidierungsprobleme bei Absender/Empfänger (z. B. falscher State-Kurzcode)
    • Fehlender HS-Code bei internationalem Versand
    • Dein Carrier-Konto ist pausiert
  • Im Shippo-Dashboard zu Shipments → die betroffene Sendung → Fehlermeldung prüfen.

B. "Customs declaration is required for international shipments via the USPS"

  • Bei einer internationalen Sendung wird die Zollerklärung nicht angehängt. Stelle sicher, dass die Ländercodes in deiner Shop-Adresse und der Kundenadresse korrekt eingetragen sind.

C. State-Name wird abgelehnt

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

D. Erscheint nicht in der Provider-Liste

  • Wenn deine Shop-Währung nicht USD/CAD ist, siehst du "Not available in your store currency". Prüfe Settings → General → Currency.
  • Wenn das Land deiner Shop-Adresse nicht US/CA ist, siehst du "Doesn't ship from your shop location".

E. Webhook kommt nicht an

  • Gehe im Nevuto-Admin zurück zu den Shippo-Einstellungen und klicke erneut auf Submit — der Webhook wird neu registriert.

13. Nächste Schritte

  • Gleiche in der ersten Woche das Shippo-Dashboard mit Nevuto ab, damit beide konsistent bleiben.
  • Füge deinen Versandtarifen einen Aufschlag hinzu — Shippos günstigster Tarif ist dein Selbstkostenpreis; verlange von der Kundschaft, was für dich sinnvoll ist.
  • Wenn du internationale Services wie USPS Priority Mail Express International nutzt, vergiss nicht, HS-Codes zu pflegen.

Hilfe

Verwandte Artikel