Dropship settings and the supplier connection: how it works
Everything is set per supplier; this page explains how suppliers connect: the JSON the API connector posts to the supplier's order endpoint, the status call with the supplier's reference, the webhook payload a supplier can send for status and tracking, the optional signature and the license and accounting notes.
Lesson 9 of 14 · How it works
How it works
The API connector posts the order with your number, the ship-to address, the lines with the supplier's SKUs and the packing-slip link.
With a status URL containing {ref} the app asks the supplier for the status of open orders.
A supplier can post status, carrier, Tracking number The parcel’s number: prefix, 9 random digits and a Luhn check digit, printed as a barcode and QR on the label. More words in the glossary and tracking link to its own webhook link; with a webhook secret the body must be signed.
Statuses the app understands: confirmed, shipped, delivered, canceled and exception.
Where to find it
- Dropshipping → Dropship settings
/admin/dropship/settings
Settings that change it
- Dropshipping → Dropship suppliers
/admin/dropship/suppliers
Checklist
Before you move on, check that you can:
- Open Dropshipping → Dropship settings
- The API connector posts the order with your number, the ship-to address, the lines with the supplier's SKUs…
- With a status URL containing {ref} the app asks the supplier for the status of open orders.
- A supplier can post status, carrier, tracking number and tracking link to its own webhook link; with a…
- Statuses the app understands: confirmed, shipped, delivered, canceled and exception.
Tips and common mistakes
- Give each supplier only its own webhook link.
- Ask the supplier for its official API documentation before using the API connector.