Skip to main content
If your warehouse runs PeakWMS, your packers can get Zippendo shipping labels straight from PeakWMS. They pack a parcel, PeakWMS asks Zippendo for a label, and the label prints. Nothing gets installed. You copy a few web addresses and a key from Zippendo into PeakWMS, and you’re done.

​
How the pieces fit together

Your webshop, PeakWMS and Zippendo each do one job: Your customer picked their shipping option from a list that came from Zippendo. So Zippendo already knows which carrier that order needs — which is why there’s usually nothing to set up for it.
Your orders stay in PeakWMS. They are not copied into Zippendo. You’ll turn that off in step 4.

​
Before you start

  • Your warehouse uses PeakWMS, and you can edit settings there.
  • Your webshop is connected to Zippendo, so checkout already shows Zippendo’s shipping options.
  • You have at least one shipping rule set up in Zippendo.

​
1. Create the connection in Zippendo

1

Open Warehouse Systems

In Zippendo, go to Warehouse Systems in the main menu.
2

Click Connect a WMS

You’ll see the systems Zippendo works with. Click Connect on PeakWMS.
3

Give it a name

Something you’ll recognise later, like “PeakWMS – Køge warehouse”. If you run more than one warehouse, name each one after its warehouse.
4

Fill in the Account ID (optional)

If you’re going to type an Account ID in PeakWMS later, type the same thing here. It’s a safety net: if the two don’t match, Zippendo stops and says so, instead of printing a label with the wrong return address on it. You can leave this empty.
5

Click Create connection

Zippendo shows you a key and a list of web addresses. Keep this page open — you need both in the next step.
The key is shown once. Copy it now. If you lose it, you can make a new one from this page, but the old key stops working immediately — so PeakWMS will need the new one before your packers can print again.
The key only lets PeakWMS create and read shipments. It can’t see your carrier accounts, your addresses, your orders or your billing. You can delete the key whenever you want, under Settings → API Settings. Just know that deleting it also switches this connection off — your packers stop printing until you make a new key, paste it into PeakWMS, and switch the connection back on.

​
2. Put them into PeakWMS

In PeakWMS, create a new Forwarder and set Provider to Generic. (If you can’t find the screen, PeakWMS’s own help centre has the walkthrough — it’s the same setup whichever shipping company you use.) Now copy each web address from Zippendo into the matching field on that forwarder. There’s a copy button next to each one in Zippendo: Then fill in the three login fields:
  • API key — the key Zippendo gave you.
  • Auth scheme — pick Bearer from the list. It’s just how PeakWMS hands the key over.
  • Account ID — the same thing you typed in Zippendo, if you used one.
Leave “Cancel shipment” empty. Zippendo can’t cancel a label with the carrier yet. If you filled this in, PeakWMS would tell your packers a label was cancelled while it’s actually still live with the carrier. With the field empty, PeakWMS simply cancels it in its own system — and if you need the label properly cancelled, ring the carrier.

​
3. Tell PeakWMS which shipping service to use

In PeakWMS, each shipping method has a Host ID. That’s how it tells Zippendo which carrier and service to use. The easiest way to fill it in:
1

Place a test order in your webshop

Pick any shipping option at checkout.
2

Open the order and find the shipping method's code

It looks something like postnord:PNL13:rule_01HZX9K2QF.
3

Paste that code into the Host ID field in PeakWMS

That’s it. Zippendo recognises the code and knows exactly which carrier and shipping rule you mean — no extra setup.
If the customer chose a pickup point, the code on the order has the pickup point added on the end, after a bar — the | character. It looks like postnord:PNL13:rule_01HZX9K2QF|1234567.Paste only the part before the bar as the Host ID. PeakWMS splits the code there itself: the first part it matches to your shipping method, and the pickup point it passes on to Zippendo. So one Host ID covers every pickup point — you don’t need one per shop.
One thing can get in the way. Some webshops carry an extra field on the order called peak_shipping_code, usually left behind by a shipping app you used before. If it’s there, PeakWMS reads that instead of the code Zippendo puts on the order.So if the Host ID never matches, or the wrong carrier keeps being used, that’s the first thing to check. Whoever looks after your webshop can empty that field for you.
Prefer your own codes, like GLS_BUSINESS_PARCEL? You can. In Zippendo, open the connection and add a Host ID mapping: type your code on the left and pick the matching shipping rule on the right. Do that for each shipping method in PeakWMS.
You’ll need your own codes if some orders don’t come from a webshop connected to Zippendo — orders typed straight into PeakWMS, for example.

​
4. Stop Zippendo importing your orders

PeakWMS is now in charge of your orders. If Zippendo also imported them, both systems would try to ship the same order — and you could end up paying for two labels for one parcel. Go to Order channels, open your store, and under What Zippendo is used for, turn off Import orders from this store.
Right now you’ll find this switch on Shopify stores. If your webshop is something else, just send us a message and we’ll turn it off for you.
What keeps working: shipping prices and pickup-point selection at checkout, exactly as before. What stops: orders are no longer copied into Zippendo, and Zippendo no longer marks orders as shipped in your webshop. PeakWMS does that, since it’s the system holding your orders.
Only turn this back on if you want Zippendo to manage your orders again.

​
5. Try it, then go live

Do a dry run in your PeakWMS test environment first. Pack one order, and check three things:
  • the label prints, and it’s the carrier you expected
  • the parcel shows up under Shipments in Zippendo
  • tracking appears on the order in PeakWMS
When all three look right, swap the web addresses in PeakWMS over to your live setup and you’re running.

​
Good to know

Nothing bad happens. If PeakWMS asks for the same label twice — say the connection timed out and it tried again — Zippendo gives back the label it already made instead of buying a second one. You’re never charged twice for the same parcel.Very occasionally the carrier makes the label but it doesn’t make it back to PeakWMS. If that happens, Zippendo stops and tells your packer, rather than quietly buying a second label. The first one is waiting for you under Shipments — print it from there.
Each parcel gets its own label and its own tracking number, and they all travel together as one shipment with the carrier. Your packers just print one label per parcel.
Open the connection under Warehouse Systems. It shows when PeakWMS last contacted Zippendo and, if something went wrong, the exact message your packer saw. Shipments themselves appear under Shipments like any other.
PeakWMS sends the customer’s address as the sender and your warehouse as the receiver, and Zippendo buys a return label. Your warehouse address always comes from your Zippendo shipping rule, so the label is right even if PeakWMS has a different address on file.
Zippendo can’t produce the paperwork that hazardous shipments legally require, so it refuses these orders rather than shipping them without it. Send those through a different shipping setup in PeakWMS.

​
If something goes wrong

Your packer sees the message, so ask them to read it out. Here’s what each one means: Still stuck? Every request PeakWMS makes is recorded on the connection page in Zippendo, so we can see exactly what happened. Send us a message and we’ll look.