Skip to main content
Wenn dein Lager PeakWMS nutzt, können deine Packer Zippendo-Versandetiketten direkt aus PeakWMS bekommen. Sie packen ein Paket, PeakWMS fragt Zippendo nach dem Versandetikett, und das Versandetikett wird gedruckt. Es wird nichts installiert. Du kopierst ein paar Webadressen und einen API-Token aus Zippendo in PeakWMS, und fertig.
Du möchtest lieber mit Screenshots Schritt für Schritt vorgehen? Die Anleitung PeakWMS verbinden führt dich durch die Einrichtung. Diese Seite ist die vollständige Referenz, einschließlich jeder PeakWMS-Einstellung und der Bedeutung jeder Meldung.

Wie die Teile zusammenspielen

Dein Onlineshop, PeakWMS und Zippendo haben jeweils eine Aufgabe: Dein Kunde hat seine Versandart aus einer Liste gewählt, die von Zippendo kam. Zippendo weiß also schon, welchen Versanddienstleister und welches Versandprodukt die Bestellung braucht. Deshalb musst du dafür meistens nichts einrichten.
Deine Bestellungen bleiben in PeakWMS. Sie werden nicht nach Zippendo kopiert. Das schaltest du in Schritt 4 aus.

Begriffe auf dieser Seite

Bevor du loslegst

  • Dein Lager nutzt PeakWMS, und du kannst dessen Einstellungen ändern.
  • Dein Onlineshop ist mit Zippendo verbunden, sodass der Checkout schon die Versandarten von Zippendo zeigt.
  • Du hast mindestens eine Versandregel in Zippendo.

1. Die Verbindung in Zippendo erstellen

1

Apps & Integrationen öffnen

Klicke in Zippendo in der Seitenleiste auf Apps & Integrationen und dann auf den Tab Katalog. PeakWMS steht unter Integrationen.
2

Bei PeakWMS auf Verbinden klicken

Das Fenster PeakWMS verbinden öffnet sich.
3

Einen Namen vergeben

Tippe einen Name ein, den du später wiedererkennst, zum Beispiel „PeakWMS Lager Køge“. Wenn du mehrere Lager betreibst, erstelle pro Lager eine Verbindung und benenne jede danach.
4

Account ID ausfüllen (optional)

Wenn du später in PeakWMS eine Account ID eintragen willst, tippe unter Account ID (optional) denselben Wert ein. Wenn die beiden nicht übereinstimmen, lehnt Zippendo die Anfrage ab, sodass ein Forwarder, der mit den Webadressen eines anderen Lagers eingerichtet wurde, keine Versandetiketten über die falsche Verbindung drucken kann. Du kannst das Feld leer lassen.
5

Eine Marke wählen (nur mit Marken)

Wenn deine Organisation Marken nutzt, wähle die Marke, für die dieses Lager versendet.
6

Auf Verbindung erstellen klicken

Du siehst WMS-Verbindung erstellt, und die Seite der Verbindung öffnet sich mit dem API-Token und einer Liste von Webadressen. Lass diese Seite offen: Du brauchst beides im nächsten Schritt.
Seite der Verbindung, die den API-Token einmalig mit einer Schaltfläche zum Kopieren zeigtSeite der Verbindung, die den API-Token einmalig mit einer Schaltfläche zum Kopieren zeigt

Der API-Token wird einmal angezeigt, direkt nachdem du die Verbindung erstellt hast

Der API-Token wird einmal angezeigt. Kopiere ihn jetzt mit der Kopieren-Schaltfläche daneben. Wenn du ihn verlierst, klicke auf der Seite der Verbindung auf Token ersetzen, um einen neuen zu bekommen. Der alte Token funktioniert sofort nicht mehr, deshalb braucht PeakWMS den neuen, bevor deine Packer wieder drucken können.
Mit dem API-Token kann PeakWMS nur Sendungen erstellen und lesen. Er kann deine Konten bei Versanddienstleistern, deine Adressen, deine Bestellungen und deine Abrechnung nicht sehen. Der Token steht auch unter Einstellungen → API-Einstellungen (öffne Einstellungen über das Organisationsmenü → Verwalten), benannt nach der Verbindung mit „(WMS)“ am Ende. Wenn du ihn dort löschst, wird auch die Verbindung ausgeschaltet: Deine Packer können nicht mehr drucken, bis du auf Token ersetzen klickst, den neuen Token in PeakWMS einfügst und WMS darf Versandetiketten erstellen wieder einschaltest.

2. Sie in PeakWMS eintragen

Erstelle in PeakWMS einen neuen Forwarder und setze Provider auf Generic. Wenn du diese Ansicht nicht findest, führt dich das Hilfecenter von PeakWMS selbst durch. Die Einrichtung ist dieselbe, egal welches Versandunternehmen du nutzt. Kopiere nun jede Webadresse aus dem Abschnitt URLs für dein WMS in Zippendo in das PeakWMS-Feld mit demselben Namen. Jede Adresse hat eine eigene Kopieren-Schaltfläche.
Abschnitt URLs für dein WMS mit den Webadressen, die du in PeakWMS einfügstAbschnitt URLs für dein WMS mit den Webadressen, die du in PeakWMS einfügst

URLs für dein WMS auf der Seite der Verbindung, mit einer Kopieren-Schaltfläche für jede Adresse

Fülle dann die drei Felder aus, mit denen sich PeakWMS bei Zippendo anmeldet:
  • API key: der API-Token, den Zippendo dir gezeigt hat.
  • Auth scheme: wähle Bearer aus der Liste. So übergibt PeakWMS den Token einfach.
  • Account ID: derselbe Wert, den du in Zippendo eingetippt hast, falls du einen verwendet hast.
Lass „Sendung stornieren“ leer. Zippendo kann ein Versandetikett beim Versanddienstleister noch nicht stornieren. Wenn du das ausfüllst, würde PeakWMS deinen Packern sagen, ein Versandetikett sei storniert, obwohl es beim Versanddienstleister noch gültig ist. Bei leerem Feld storniert PeakWMS es nur in seinem eigenen System. Wenn du ein Versandetikett beim Versanddienstleister stornieren musst, wende dich an den Versanddienstleister.

3. PeakWMS mitteilen, welches Versandprodukt verwendet wird

In PeakWMS hat jede Versandart eine Host ID. So teilt PeakWMS Zippendo mit, welchen Versanddienstleister, welches Versandprodukt und welche Versandregel es verwenden soll. Du legst sie in PeakWMS an der Versandart selbst fest. So füllst du sie am einfachsten aus:
1

Eine Testbestellung in deinem Onlineshop aufgeben

Wähle im Checkout eine beliebige Versandart.
2

Die Bestellung öffnen und den Code der Versandart finden

Er sieht ungefähr so aus: postnord:PNL13:rule_01HZX9K2QF: der Versanddienstleister, das Versandprodukt und die Zippendo-Versandregel.
3

Den Code in das Feld Host ID in PeakWMS einfügen

Das war es schon. Zippendo erkennt den Code und weiß genau, welchen Versanddienstleister und welche Versandregel du meinst, ohne dass du in Zippendo etwas einrichten musst.
Wenn der Kunde einen Paketshop gewählt hat, hat der Code an der Bestellung den Paketshop am Ende angehängt, nach einem senkrechten Strich (dem Zeichen |). Er sieht so aus: postnord:PNL13:rule_01HZX9K2QF|1234567.Füge als Host ID nur den Teil vor dem senkrechten Strich ein. PeakWMS trennt den Code dort selbst: Es ordnet den ersten Teil deiner Versandart zu und gibt den Paketshop an Zippendo weiter. Eine Host ID deckt also jeden Paketshop ab.
Eine Sache kann dazwischenkommen. Manche Onlineshops haben an der Bestellung ein zusätzliches Feld namens peak_shipping_code, meist hinterlassen von einer Versand-App, die du früher genutzt hast. Wenn es vorhanden ist, liest PeakWMS dieses statt des Codes, den Zippendo an die Bestellung setzt.Wenn die Host ID also nie passt oder immer der falsche Versanddienstleister verwendet wird, prüfe das zuerst. Wer deinen Onlineshop betreut, kann das Feld für dich leeren.
Du möchtest lieber eigene Codes wie GLS_BUSINESS_PARCEL? Das geht. Öffne in Zippendo die Verbindung und gehe zu Host-ID-Zuordnungen. Klicke auf Zuordnung hinzufügen, tippe deinen Code unter Host ID im WMS ein und wähle die passende Regel unter Zippendo-Versandregel. Mach das für jede Versandart in PeakWMS und klicke dann auf Zuordnungen speichern. Eine Zeile ohne Versandregel kann nicht gespeichert werden.
Abschnitt Host-ID-Zuordnungen mit GLS_BUSINESS_PARCEL, zugeordnet zu einer GLS-Versandregel für HauszustellungAbschnitt Host-ID-Zuordnungen mit GLS_BUSINESS_PARCEL, zugeordnet zu einer GLS-Versandregel für Hauszustellung

Eine Host-ID-Zuordnung von deinem eigenen Code zu einer Zippendo-Versandregel

Du brauchst eigene Codes, wenn manche Bestellungen nicht aus einem mit Zippendo verbundenen Onlineshop kommen, zum Beispiel Bestellungen, die direkt in PeakWMS eingetippt werden.

4. Den Bestellimport durch Zippendo stoppen

PeakWMS ist jetzt für deine Bestellungen zuständig. Wenn Zippendo sie auch importieren würde, würden beide Systeme versuchen, dieselbe Bestellung zu versenden, und du könntest am Ende für zwei Versandetiketten für ein Paket bezahlen. Gehe zu Verkaufskanäle, öffne deinen Onlineshop und schalte unter Wofür Zippendo genutzt wird die Option Bestellungen aus diesem Onlineshop importieren aus.
Einstellungen des Verkaufskanals mit dem Abschnitt Wofür Zippendo genutzt wird und seinem ImportschalterEinstellungen des Verkaufskanals mit dem Abschnitt Wofür Zippendo genutzt wird und seinem Importschalter

Der Schalter, der den Import von Bestellungen aus einem Onlineshop durch Zippendo stoppt

Diesen Schalter findest du bei Shopify- und WooCommerce-Onlineshops. Wenn dein Onlineshop etwas anderes ist, schick uns eine Nachricht, dann schalten wir ihn für dich aus.
Was weiter funktioniert: Versandpreise und die Auswahl des Paketshops im Checkout, genau wie vorher. Was aufhört: Bestellungen werden nicht mehr nach Zippendo kopiert, und Zippendo markiert Bestellungen in deinem Onlineshop nicht mehr als versendet. Das übernimmt PeakWMS, weil es deine Bestellungen verwaltet.
Schalte das nur wieder ein, wenn Zippendo deine Bestellungen wieder verwalten soll.

5. Ausprobieren, dann live gehen

Mach zuerst einen Probelauf in deiner PeakWMS-Testumgebung. Pack eine Bestellung und prüfe drei Dinge:
  • Das Versandetikett wird gedruckt, und es ist der Versanddienstleister, den du erwartet hast
  • Das Paket erscheint in Zippendo unter Sendungen
  • Die Sendungsverfolgung erscheint an der Bestellung in PeakWMS
Wenn alle drei stimmen, stelle die Webadressen in PeakWMS auf deine Live-Einrichtung um, und du bist startklar.

Die Verbindung pausieren oder entfernen

Öffne die Verbindung: Klicke auf dem Tab Verbunden unter Apps & Integrationen auf ihre Zeile auf der PeakWMS-Karte.
  • Schalte WMS darf Versandetiketten erstellen aus, damit PeakWMS keine Versandetiketten mehr erstellt, ohne etwas zu löschen. Schalte es wieder ein, wenn du bereit bist.
  • Klicke unten auf Verbindung löschen, um die Verbindung und ihren API-Token endgültig zu entfernen. Sendungen, die bereits erstellt wurden, bleiben in Zippendo.

Gut zu wissen

Nichts Schlimmes. Wenn PeakWMS dasselbe Versandetikett zweimal anfordert, zum Beispiel weil die Verbindung ein Zeitlimit überschritten hat und es erneut versucht hat, gibt Zippendo das bereits erstellte Versandetikett zurück, statt ein zweites zu kaufen. Du wirst nie zweimal für dasselbe Paket belastet.Sehr selten erstellt der Versanddienstleister das Versandetikett, aber es kommt nicht bei PeakWMS an. Wenn das passiert, hält Zippendo an und sagt es deinem Packer, statt stillschweigend ein zweites Versandetikett zu kaufen. Das erste wartet unter Sendungen auf dich: Drucke es von dort.
Jedes Paket bekommt ein eigenes Versandetikett, und alle reisen zusammen als eine Sendung beim Versanddienstleister. Deine Packer drucken ein Versandetikett pro Paket.
Auf dem Tab Verbunden unter Apps & Integrationen zeigt jede PeakWMS-Verbindung, wann PeakWMS zuletzt Zippendo kontaktiert hat, oder „Noch nicht genutzt“. Wenn etwas schiefgelaufen ist, zeigt sie genau die Meldung, die dein Packer gesehen hat, und die Seite der Verbindung zeigt sie unter Letzter Fehler. Sendungen erscheinen wie alle anderen unter Sendungen.
PeakWMS sendet die Adresse des Kunden als Absender und dein Lager als Empfänger, und Zippendo bekommt ein Retourenetikett. Die Adresse, an die das Paket zurückkommt, ist immer die Absenderadresse deiner Zippendo-Versandregel, das Versandetikett stimmt also auch dann, wenn PeakWMS eine andere Adresse gespeichert hat.
Zippendo kann die Papiere, die Gefahrgut rechtlich braucht, nicht erstellen und lehnt diese Bestellungen deshalb ab, statt sie ohne zu versenden. Sende solche Bestellungen in PeakWMS über einen anderen Forwarder.

Wenn etwas schiefgeht

Dein Packer sieht die Meldung in PeakWMS, bitte ihn also, sie dir vorzulesen. Das bedeutet jede einzelne: Immer noch nicht weiter? Die Seite der Verbindung in Zippendo zeigt den jüngsten Fehler. Schick uns eine Nachricht mit der Bestellnummer, dann schauen wir nach.