Couriers overview
DZBuild supports the major Algerian couriers. Once you link a courier in your dashboard, DZBuild can push new orders to the courier's API, return tracking numbers to your customer, and pull rates and stop-desk lists straight from the provider.
🎬 Video
Supported couriers
| Courier | Slug | Notes |
|---|---|---|
| Yalidine | yalidine | All 58 wilayas, large stop-desk network, mature API |
| EcoTrack | ecotrack (and 30+ EcoTrack-based partners like DHD, Conexlog, MSM Go, Rocket, Anderson, Speed Delivery, Worldexpress, …) | Bearer-token API shared by every EcoTrack-powered courier |
| ZR Express | zrexpress (legacy Procolis API) and zr-express-new (new platform) | Two APIs: pick the one matching your ZR Express dashboard |
| Maystro Delivery | maystro | Strong nationwide coverage, single-token API |
| Noest Express | noest | Token + user GUID; tight Algeria coverage |
| Zimou Express | zimou | Standalone courier API with Algeria-wide coverage |
| Colivraison | colivraison | Standalone courier API |
| DHD | dhd | Direct DHD API; DHD also accessible via EcoTrack for EcoTrack-platform users |
| EcomDelivery | ecomdelivery | Standalone courier API |
| Stop Desk | delivery type + addon | Customer pickup at courier offices; works with any linked provider |
The Yalidine API service also works with Yalitec, Guepex, and Easy & Speed — they share the same API shape and are exposed under their own slugs in the dashboard.
Where to link a courier
Go to /dashboard/shipping in your dashboard. From there you can:
- Pick a default delivery provider for the store.
- Enter the courier's API credentials and click Test API (the dashboard verifies live with the provider).
- See the live API status (green = linked, red = bad credentials).
- Sync rates from provider — pulls each wilaya's home + desk rates from the courier when supported.
- Unlink a provider at any time without losing your existing orders.
If your business model needs per-product shipping prices (heavy items, size-based fees, free-shipping flags on specific SKUs), enable the Custom Product Shipping addon — it lets each product override the wilaya-level rate.
What gets synced from the courier
| Data | Yalidine | EcoTrack | ZR Express | Maystro | Noest |
|---|---|---|---|---|---|
| Wilayas list | ✅ | ✅ | ✅ | (built-in) | (built-in) |
| Communes per wilaya | ✅ | ✅ | ✅ | ✅ | ✅ |
| Home + desk rates | ✅ | ✅ | ✅ | ❌ (set manually) | ❌ (set manually) |
| Stop desk list | ✅ | ✅ | ✅ | ✅ | ✅ |
What happens when an order is sent to the courier
- You confirm the order in
/dashboard/orders. - DZBuild calls the courier API with customer name, phone, address, items, COD amount, declared value, weight, and (for desk delivery) a
stopdesk_id. - The courier returns a tracking number and (when supported) a label URL.
- Order status flips to
shipped, the tracking is saved on the order, and your customer sees it on their order page. - As the courier scans the parcel, status flows back:
processing → shipped → delivered(orreturned/cancelled).
DZBuild also generates its own delivery label (a print-ready bordereau you can paste on the parcel) — separate from the courier's official label, which most APIs also expose. Use whichever your courier accepts.
Linking flow (high level)
- Open
/dashboard/shipping. - Click Link provider and pick the courier.
- Paste the credentials the courier issued you (token, ID, GUID — depends on the courier; see each per-courier page).
- Click Test API.
- If green, save. The provider becomes the store's default; per-wilaya rates can be overridden manually or pulled from the provider.
Frequently asked
Q: Can I link more than one courier? A: One courier is set as the store's default delivery provider at any given time, but you can still ship individual orders manually through other couriers. Most merchants pick one main API-linked courier and ship overflow manually.
Q: How do COD payouts work? A: COD is collected by the courier at delivery and settled to your bank/CCP on the courier's schedule (usually weekly). DZBuild does not handle the cash leg — see Cash on Delivery.
Q: My courier isn't on the list — can I still use DZBuild?
A: Yes. Ship manually: confirm the order, hand the parcel to the courier, then mark the order shipped in /dashboard/orders. You won't get automatic tracking, but everything else works. Many EcoTrack-based couriers are already supported under the EcoTrack slug — check with your courier before assuming they need a custom integration.