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	Mature API; wilayas, communes and desks come from your own Yalidine account
EcoTrack family	81 courier tiles (dhd, conexlog, msmgo, rocketdelivery, andersondelivery, speeddelivery, worldexpress, …) plus customecotrack	There is no ecotrack slug to pick. EcoTrack is a shared Bearer-token API, so you pick your own courier's tile
ZR Express	zrexpressnew	One merged tile. Paste either credential pair — DZBuild works out whether you are on the new platform or the legacy Procolis API
Maystro Delivery	maystro	Single-token API
Noest Express	noest	API Token + User GUID
Abex Express	abexexpress	Same Procolis API shape as legacy ZR Express, but its own Token + Key
Zimou Express	zimou	Standalone courier API
Colivraison	colivraison	Standalone courier API
Ecom Delivery	ecomdelivery	Standalone courier API
Elogistia	elogistia	Single API Key field; one of only two families whose own PDF bordereau prints from the dashboard
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.

DHD and Conexlog are EcoTrack tenants, not separate integrations: they just live on their own hosts (platform.dhd-dz.com and app.conexlog-dz.com) instead of *.ecotrack.dz. See the EcoTrack page for the full tile list.

Where to link a courier

Couriers are linked at /dashboard/link-shipping — in the sidebar, Paramètres de livraison → « Connecter un transporteur » (« ربط شركة التوصيل »). The page is a searchable grid of courier tiles. From there you can:

• Link a courier: click Lier / ربط on its tile, fill the credentials, and save.
• Manage an already-linked courier: the tile's button becomes Gérer / إدارة.
• Set one linked courier as the store's default (Définir comme transporteur par défaut / تعيين كشركة افتراضية).
• Pause a courier or Délier / إلغاء الربط it at any time without losing your existing orders.

Tile chips show link state, not a live credential check: green chips mean the courier is linked / default / active / paused. A red API expirée (« بيانات API منتهية ») pill only appears after repeated authentication failures over the last 30 days. To check credentials right now, open the tile and click Tester la connexion.

The separate page /dashboard/shipping (« Tarifs de livraison » / « أسعار الشحن ») is the per-wilaya shipping-price table. That is where you find:

• A home price and a desk price for every wilaya, each behind its own switch, so you can turn off home delivery, desk delivery, or both for a given wilaya.
• The wilaya list itself: 58 wilayas (the courier-compatible list) or 69 wilayas (which adds the newer ones such as El Meniaa, Timimoun and Djanet). The mode selector sits at the top of the page. Linking a courier forces the store back to 58, because courier APIs do not accept the newer wilayas, so 69 is only selectable with no courier linked.
• Sync rates from provider — pulls each wilaya's home + desk rates from the linked courier.

note

Shipping pages do not exist for digital-product stores (the digital theme redirects both pages to the dashboard). Team members need the shipping.view permission to open them and shipping.edit to change anything, and the store's subscription must be active.

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 requires the Pro plan or higher (activating it on Free is refused with « هذه الإضافة تتطلب خطة pro »), is unavailable on the digital theme, and has its own page at /dashboard/addons/custom-shipping. It gives you a per-product flat rate or per-wilaya pricing, per-product free shipping, highest-price-wins for mixed carts, and a "copy from store rates" shortcut.

What gets synced from the courier

Data	Yalidine	EcoTrack	ZR Express	Maystro	Noest
Wilayas list	✅	✅	✅	✅	✅
Communes per wilaya	✅	✅	✅	✅	✅
Home + desk rates	✅	✅	✅	✅	✅
Stop desk list	✅	✅	New platform ✅ / legacy: no desk list	✅ (pickup points)	✅

No linked provider is excluded from rate syncing. Maystro prices per commune, so each wilaya is quoted from its centre commune; Noest returns one home price and one desk price per wilaya.

The legacy ZR Express (Procolis) platform publishes no desk list: a whole wilaya counts as desk-eligible whenever its Stopdesk price is above zero, the customer sees a generic commune-level "ZR Express agency" option, and ZR picks the actual pickup point on dispatch. The new ZR platform returns a real hub list.

Refreshing provider data

All of the above refreshes automatically overnight, once a day. To force it for one courier — the fix for "my new courier shows no desks or communes yet" — open the courier's tile at /dashboard/link-shipping and click Actualiser (« تحديث البيانات ») inside the modal. The button only appears for an already-linked courier and has a 5-minute cooldown per courier.

What happens when an order is sent to the courier

1. You confirm the order in /dashboard/orders.
2. In the send-to-delivery modal you pick which linked courier ships it, and DZBuild calls that courier's API with the customer's name, phone, address, item list and the COD amount.
3. The courier returns a tracking number, saved on the order.
4. The order moves to processing — but only if it was pending or confirmed; a later status is left alone. DZBuild also stores the tracking number, the courier name, and the send timestamp.
5. The order becomes shipped on its own once the tracking sync sees a pickup or transit status, then delivered (or returned / cancelled).

The payload differs per courier family, and this is the part merchants most often get wrong:

What is sent	Yalidine family	EcoTrack family	ZR Express (legacy)	ZR Express (new)	Maystro	Noest
COD amount	price = subtotal	montant = order total	Total = order total	amount = order total	product_price = order total	montant = order total
Desk reference	is_stopdesk + stopdesk_id	stop_desk 0/1 (commune = the desk's commune)	TypeLivraison 0/1	deliveryType: "pickup-point" + hubId	delivery_type: 2	stop_desk: 1 + station_code
Weight	✅	✅	not sent	not sent	not sent	poids
Declared value	✅	—	—	—	—	—

Yalidine is the only family that receives a declared value and a stopdesk_id, and the only one whose COD amount is the subtotal rather than the order total (Yalidine bills the delivery fee separately).

Printing labels

Print label fetches the courier's own PDF bordereau only for EcoTrack-family couriers and Elogistia (whose bordereau comes in three sizes — 15×20, 10×15 and 10×10 cm, with 10×15 as the default). For every other courier it prints DZBuild's own HTML bordereau. Yalidine, Maystro and Noest label URLs are captured and stored on the order, but no dashboard button opens them today — print those from the courier's own portal.

Tracking sync

DZBuild checks each linked courier automatically for the orders it has in flight and moves them along on its own: processing → shipped → delivered, or returned / cancelled. A status change on the courier's side usually shows up on your order within a few minutes. Returns and cancellations restore stock automatically.

Two things worth knowing:

• A courier status DZBuild does not recognise leaves the order untouched.
• A parcel the courier cannot find is never cancelled automatically — it is left as-is and re-checked next cycle. Only an explicit cancelled status from the courier cancels an order.

Weight surcharge

Parcels heavier than 5 kg add a surcharge on top of the wilaya rate at checkout: 50 DA per extra kg, rising to 100 DA per extra kg for the 13 deep-south wilayas (Adrar, Béchar, Tamanrasset, El Bayadh, Illizi, Tindouf, Naâma, Timimoun, Bordj Badji Mokhtar, Béni Abbès, In Salah, In Guezzam, Djanet) when the courier is Yalidine, Yalitec or Guepex. Easy & Speed is deliberately excluded from the deep-south rate.

The surcharge is computed from your products' weights and is added to what the customer pays. It does not appear as a line in the shipping-rates table, so a wilaya priced at 600 DA can quote more than 600 DA for a heavy cart.

This is the courier's own pricing rule; DZBuild applies it rather than inventing it. If you do not want it charged on a given product, leave that product's weight empty, or set free shipping on it.

Linking flow (high level)

1. Open /dashboard/link-shipping and search the tile grid for your courier.
2. Click Lier / ربط on its tile.
3. Paste the credentials the courier issued you (token, ID, GUID — depends on the courier; see each per-courier page).
4. Click Tester la connexion (« اختبار الاتصال »).
5. Click Lier et enregistrer (« ربط وحفظ »). Optionally tick Définir comme transporteur par défaut.
6. Go to /dashboard/shipping to sync per-wilaya rates from the provider or set them by hand.

When your courier is not on the list

Work through this in order.

1. Ask your courier whether they run on EcoTrack. A large share of Algerian couriers do, and 81 of them already have their own tile in the grid. If yours is an EcoTrack tenant with no tile of its own, the Custom EcoTrack tile takes its API URL plus a bearer token and behaves identically. See the EcoTrack page.
2. Ship manually in the meantime. Confirm the order, hand the parcel to the courier, then mark the order shipped in /dashboard/orders. You lose automatic tracking; nothing else about the order changes.
3. Send us the request. Open a support ticket with the courier's name and a link to their API documentation. The documentation link is the part that matters, because without a public API there is nothing to build against. We cannot promise a date for any specific courier.

Frequently asked

Q: Can I link more than one courier? A: Yes — link as many as you want, and flag one as the store's default. When you send an order (single or in bulk) you choose the courier from a dropdown in the send-to-delivery modal, and DZBuild ships it through that courier's API. Nothing has to be shipped manually. For desk orders, couriers with no desk in the customer's commune are greyed out in that dropdown and labelled « لا يوجد مكتب ».

Q: How do COD payouts work? A: The courier collects the cash at delivery and pays you directly, on its own schedule, under whatever terms you agreed with it. DZBuild never touches that money and is not part of the settlement. See Cash on Delivery.

Q: My courier is not on the list. Can I still use DZBuild? A: Yes. See the section just above for the three steps.

Q: A wilaya my courier serves is missing from my rate table. A: That list mirrors what your own courier account covers, not a DZBuild list, so it moves when the courier changes your account. Click Actualiser on the courier's tile to pull it again. If the wilaya is still missing, open a support ticket with the exact error message and the order number, and enter that one order directly in the courier's own platform while we look at it.