Zum Hauptinhalt springen

MyParcel mit Nevuto verbinden

Was ist MyParcel?

MyParcel ist ein in den Niederlanden ansässiger Multi-Carrier-Versandaggregator. Über eine einzige API kannst du via PostNL, DPD und bpost sowohl innerhalb von NL/BE als auch EU-weit versenden. Statt mit jedem Carrier einen eigenen Vertrag zu pflegen, verbindest du dich einmal mit MyParcel und druckst alle Etiketten von einem Ort aus.

Wie Nevuto MyParcel verwaltet

  • Sobald du den API key einfügst und auf Submit klickst, erstellt Nevuto die Webhook-Verbindung automatisch in MyParcel — kein manueller Schritt nötig.
  • Die Absenderadresse wird aus deinem MyParcel-Konto übernommen (Nevuto kann den Absender nicht überschreiben — die MyParcel-API erlaubt das nicht).
  • Du druckst MyParcel-Etiketten direkt aus der Bestellzeile mit Print label; das PDF öffnet sich in einem neuen Tab.
  • Bei Post-Payment-Konten wird das Etikett sofort erzeugt und am Periodenende abgerechnet. Bei Pre-Payment-Konten werden die Kosten von deinem MyParcel-Wallet abgezogen.
  • Sobald der Carrier das Paket scannt, aktualisiert der Webhook shipping_status und ersetzt die vorläufige Referenz automatisch durch den echten Carrier-Barcode.

1. Voraussetzungen

  • Ein aktives MyParcel-Konto. Falls du noch keins hast, registriere dich unter myparcel.nl (NL-Gewerbeanmeldung erforderlich).
  • Eine im MyParcel-Konto hinterlegte Absenderadresse. Account → Settings → Sender address. Diese Adresse wird für jede Sendung verwendet (Nevuto kann den Absender nicht pro Bestellung überschreiben — die MyParcel-API erlaubt das nicht).
  • Die Absenderadresse muss in NL oder BE liegen. MyParcel versendet ausschließlich aus den Niederlanden und Belgien.
  • Deine Shop-Währung muss EUR sein. MyParcel akzeptiert für Zollwerte nur EUR; Shops in anderen Währungen sehen in der Provider-Liste "Not available".
  • Ein gefülltes Wallet (bei Pre-Payment-Konten Pflicht). Post-Payment-Konten werden nachträglich abgerechnet.

2. MyParcel API key

  1. Melde dich in deinem MyParcel-Konto an.
  2. Öffne Account → Settings → API.
  3. Klicke auf Generate API key, um einen neuen Token zu erzeugen.
  4. Kopiere den Token — du fügst ihn im nächsten Schritt in Nevuto ein.

⚠️ Es reicht, den Token unverändert einzufügen — Nevuto kümmert sich um das spezifische Auth-Format von MyParcel für dich.

3. MyParcel in Nevuto verbinden

  1. Gehe im Nevuto-Adminpanel zu Settings → Shipping → Shipping providers.
  2. Wähle MyParcel aus der Liste.
  3. Füge den aus MyParcel kopierten Token in das Feld API key ein.
  4. Aktiviere den Toggle Enable shipping method.
  5. Klicke auf Submit.

Beim Klick auf Submit:

  • speichert Nevuto den API key sicher,
  • erstellt automatisch das Webhook-Abo in deinem MyParcel-Konto — kein manueller Schritt,
  • empfängt Status-Updates für deine Bestellungen.

4. Preferred carrier (bevorzugter Carrier)

Nach dem Speichern erscheint unten eine Settings-Karte:

  1. Wähle aus dem Dropdown Preferred carrier einen oder mehrere Carrier (PostNL / DPD / bpost).
  2. Klicke auf Submit.

Verhalten:

  • Beim Erstellen einer Sendung verwendet Nevuto den ersten Carrier deiner Präferenzliste (MyParcel akzeptiert nur einen Carrier pro Sendung).
  • Wenn du mehrere auswählst, wird der oberste verwendet.
  • Wenn du keinen auswählst, wird PostNL als Standard verwendet (NL-eigener Carrier mit der größten Abdeckung).

5. Absenderadresse

MyParcel erlaubt kein Sender-Override pro Bestellung — pflege deine Absenderadresse im MyParcel-Panel:

  1. MyParcel-Konto → Account → Settings → Sender address.
  2. Die Adresse muss in NL oder BE liegen (Pflicht).
  3. Telefon, E-Mail und Firmenname sollten vollständig sein (der Carrier lehnt zwar nicht ab, aber in Edge-Cases kann es Probleme geben).

Nevuto verwendet diese Adresse automatisch bei jeder Sendung.

6. Shipping packages (Paketvorlagen)

MyParcel verlangt bei jeder Sendung Paketmaße und -gewicht. Nevuto holt diese in folgender Reihenfolge:

  1. Variant LWH — wenn auf der Produktvariante gepflegt (am genauesten).
  2. ShippingPackage-Referenz.
  3. Shop-Standardpaket.
  4. Letzter Ausweg: Maße werden weggelassen → MyParcel verwendet die eigene Schätzung (meist zu niedrig bepreist).

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

Wir empfehlen, auf jeder Variante echte Maße zu hinterlegen:

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

8. Zollanmeldung (international)

Bei Sendungen NL/BE → außerhalb der EU hängt Nevuto automatisch eine Zollanmeldung an:

  • Items: Bestellpositionen (Produktbeschreibung, Menge, Gewicht, Ursprungsland)
  • Item value: Einzelpreis der Position
  • Currency: immer in EUR übertragen

⚠️ MyParcel akzeptiert auf Zollanmeldungen nur EUR. Selbst wenn deine Shop-Währung USD/GBP ist, wird der Wert als EUR gesendet (der Zahlenwert bleibt erhalten, es findet keine Währungsumrechnung statt). Achte bei niedrigpreisigen Artikeln auf Freigrenzen wie €22.

HS-Code: in Nevuto nicht pro Produkt gespeichert → wird leer gesendet. Du kannst ihn manuell im MyParcel-Panel ergänzen.

9. Bestellung versenden

Sobald die Kundschaft bezahlt hat, taucht die Bestellung in deinem Admin-Panel mit dem Button "Mark as shipped" auf.

  1. Öffne die Bestelldetail-Seite.
  2. Klicke auf Mark as shipped.
  3. Wähle im Modal MyParcel als Provider und klicke auf Submit.
  4. Innerhalb weniger Sekunden erscheinen in der Bestellzeile eine vorläufige Tracking-Referenz und der Button "Print label". Die Sendung wird in MyParcel zunächst im Status "concept" (Entwurf) angelegt.
  5. Klicke auf Print label:
    • Post-Payment-Konto: Das PDF öffnet sich sofort, die Abrechnung erfolgt am Periodenende.
    • Pre-Payment-Konto: Der Wallet-Betrag wird abgebucht, dann öffnet sich das PDF. Wenn das Wallet leer ist, siehst du die Meldung "Label not available yet — wallet may need funding". Lade das Wallet auf und klicke erneut auf den Button.
  6. Drucke das Etikett, klebe es auf das Paket und übergib es dem ausgewählten Carrier.

💡 Sobald das Etikett gedruckt ist, wird die vorläufige Tracking-Referenz automatisch durch den echten Carrier-Barcode ersetzt. Auch die Kundschaft kann die Sendung über den Tracking-Link verfolgen.

10. Status-Lifecycle (Statusverlauf)

Mark as shipped
    │
    ▼
[shipping_status: PROCESSING]      ← concept-Status, shipment_id als vorläufiges Tracking
    │
    ▼   MyParcel erzeugt das Etikett (Status ≥2)
[tracking_number = barcode]        ← Webhook liefert den echten Carrier-Barcode, tracking number wird aktualisiert
    │
    ▼   Carrier scannt das Paket (Status ≥3)
[shipping_status: SHIPPED]         ← Webhook
    │
    ▼   An die Kundschaft zugestellt (Status ≥7)
[shipping_status: DELIVERED]       ← Webhook

MyParcel-Status-Mapping (Nevuto):

  • Entwurf / registriert → Processing (keine Änderung)
  • An Carrier übergeben, Sortierung, Verteilung, Zoll → Shipped
  • Zugestellt, abholbereit, abgeholt, Retoure-Schritte → Delivered
  • Gedruckt, storniert usw. → ignoriert

Das Webhook-Abo wird von Nevuto automatisch eingerichtet — kein manueller Eingriff notwendig.

11. Label-Download

Beim Klick auf "Print label" lädt Nevuto das Etikett von MyParcel herunter und öffnet es in einem neuen Tab:

  • Post-Payment-Konto: Das PDF öffnet sich sofort.
  • Pre-Payment-Konto (leeres Wallet): Du siehst die Meldung "Label not available yet — your shipping wallet may need funding".

In diesem Fall lade dein Wallet im MyParcel-Konto auf und versuche es erneut.

12. Testmodus

MyParcel bietet keine echte Sandbox/Testumgebung. Mögliche Strategien:

  • Auf der Concept-Stufe stehen lassen: die Sendung wird erzeugt, aber kein Etikett gedruckt → keine Kosten. Anschließend kannst du die Sendung im Panel löschen.
  • Niedrigpreisiger Echt-Test: eine PostNL-Pakketten-Buitenland-Sendung oder eine inländische €4-5-Testsendung.

13. Häufige Probleme

A. "Label not available yet — wallet may need funding"

  • Dein Konto ist im Pre-Payment-Modell und das Wallet ist leer. Melde dich bei MyParcel an, lade das Wallet auf und klicke erneut auf "Print label".

B. Die Tracking-Nummer hat sich geändert

  • Erwartetes Verhalten. Nevuto zeigt zunächst eine vorläufige Kennung; sobald der Carrier das Etikett druckt, wird der echte Tracking-Barcode automatisch aktualisiert.

C. Provider taucht nicht in der Liste auf

  • Deine Shop-Währung ist nicht EUR → "Not available in your store currency. Supports: EUR".
  • Dein Shop-Sitz ist nicht NL/BE → "Doesn't ship from your shop location".
  • Passe Settings → General → Currency bzw. Settings → Locations → Country auf einen unterstützten Wert an.

D. Webhook kommt nicht / Statuses werden nicht aktualisiert

  • Prüfe in deinem MyParcel-Konto die Webhook subscriptions. Öffne in Nevuto die MyParcel-Einstellungen und klicke erneut auf Submit — das Webhook-Abo wird neu eingerichtet.

14. Nächste Schritte

  • Beobachte die ersten Produktionsbestellungen in der ersten Woche.
  • Pflege HS-Codes im MyParcel-Panel für Sendungen außerhalb der EU.
  • Schlage eine Marge auf deine Versandtarife auf, damit du Carrier-Aufschläge nicht selbst trägst.

Hilfe

Verwandte Artikel