EcoTrack is a shared shipping API that powers a large family of Algerian couriers. There is no "EcoTrack" tile to pick — you pick your own courier's tile, and DZBuild talks to it over the EcoTrack API with a single bearer token. 37 couriers have their own tile:

DHD, Conexlog, MSM Go, Rex Livraison, RB Livraison, Speed Delivery, Areex, Prest, Rocket Delivery, WorldExpress, BA Consult, Packers, 48Hr Livraison, Mono Hub, Anderson Delivery, GOLIVRI, Coyote Express, Salva Delivery, Distazero, FRET.Direct, TSL Express, Negmar Express, Ultra Express, OM Express, Med Express, Allo Livraison, Assil Delivery, Expedia Chrono, HHD Express, Imir Logistics, Navex Delivery, Swift Express, Univer Delivery, Colireli, FZ Delivery, Delivromail, PDEX.

If your courier is on this list, pick its tile — there is no need for a custom integration.

Two of them do not sit on *.ecotrack.dz hosts but are EcoTrack tenants all the same: DHD (platform.dhd-dz.com) and Conexlog (app.conexlog-dz.com). Neither is a separate direct integration.

Mono Hub is a special case: the tile exists, but its host mono.ecotrack.dz currently returns 404 and the tenant appears decommissioned. If Mono Hub is your courier, ask them for their current API URL and use Custom EcoTrack.

What you need

A single value from your courier's EcoTrack-powered dashboard:

API token (sometimes called "Bearer token", "API key" or "clé API").

Some EcoTrack-based dashboards split it across two screens (account → API → generate). If you can't find it, ask your account manager to enable API access.

Linking an EcoTrack courier in DZBuild

Open /dashboard/link-shipping and search your courier's name in the tile grid (e.g. DHD, Conexlog, MSM Go, …).
Click Lier / ربط on its tile.
Paste your API token into the single credential field. EcoTrack-based providers use one field only.
Click Tester la connexion (« اختبار الاتصال »). The dashboard hits the courier live and confirms the token is valid.
Click Lier et enregistrer (« ربط وحفظ »).

Per-wilaya prices are edited on the separate page /dashboard/shipping.

Custom EcoTrack

If your courier is not in the tile grid but is built on EcoTrack, pick Custom EcoTrack and provide:

The API URL of your courier's EcoTrack instance — the base host only, e.g. https://yourcourier.ecotrack.dz. DZBuild appends /api/v1 itself.
A display name. Whatever you type is what appears throughout the dashboard for that courier.
The bearer token.

The URL must start with https:// and resolve to a public host; internal, loopback and reserved addresses are refused for security. Each custom URL keeps its own synced commune, desk and rate knowledge, so switching the URL starts a fresh sync. Prefer a native tile whenever one exists for your courier.

What gets synced

The list of wilayas and communes the courier serves.
Home delivery rates per wilaya.
Stop-desk rates per wilaya.
The stop-desk list per wilaya (used by the Stop Desk picker).

What happens when an order ships

When you confirm an order whose store is linked to an EcoTrack courier, DZBuild posts the parcel to the courier's EcoTrack endpoint with:

nom_client, telephone and telephone_2, adresse.
code_wilaya + commune.
montant — the order total (products + shipping − discount), i.e. what the customer pays on delivery. Only Yalidine-family parcels use the subtotal, because Yalidine bills the delivery fee separately.
produit (the item summary), remarque (your note), weight, and reference (your DZBuild order number).
type — 1 for a delivery, 2 for an exchange.
stop_desk — 0 or 1. There is no delivery_type field and no stopdesk_id: a desk parcel is expressed by sending the desk's commune as commune while stop_desk = 1.
fragile = 1, only when the product is flagged fragile.

The courier returns a tracking number.

Fragile flag

Marking a product Fragile adds fragile = 1 to EcoTrack parcels — and only to EcoTrack parcels. No other courier family receives it (Yalidine's API rejects unknown parameters outright).

Product description limit

The item summary sent to EcoTrack is capped at 255 characters. A long multi-item order is shortened in steps: the full list, then the same list with variant suffixes in parentheses stripped, then the first few items plus +N, and finally a summary like x8 ORD-12345.

Printing the courier's own bordereau

EcoTrack is one of only two families (the other is Elogistia) whose own PDF bordereau prints straight from DZBuild. Clicking Print label on an EcoTrack order downloads the courier's official label as a PDF — Custom EcoTrack instances included, using the API URL you stored.

EcoTrack orders also get an EcoTrack-only Expédier (« تأكيد الشحن ») button on the order detail panel, to confirm the shipment with the courier.

Common errors and fixes

Symptom	Likely cause	Fix
The connection test returns "unauthorized"	Wrong or expired token	Regenerate the token in the courier's dashboard and paste it again.
« يرجى إدخال رابط API » (Custom EcoTrack)	The API URL field is empty	Paste your courier's base host.
« يرجى إدخال رابط صحيح يبدأ بـ https:// » (Custom EcoTrack)	The URL isn't `https://`	Re-enter it with the `https://` scheme.
« يرجى إدخال رابط عام صحيح (لا يُسمح بعناوين داخلية) » (Custom EcoTrack)	The URL points at a private, loopback or reserved address	Use the courier's public hostname. A wrong-but-public domain instead shows up as a failed connection test coming from the courier's own API.
Order created but no tracking number	Address rejected by courier	Check the address on the order; usually a missing or unrecognized commune.
« لا يوجد مكتب استلام (Stop Desk) متاح في هذه الولاية لشركة … »	No desk anywhere in that wilaya	Switch the order to home delivery, or click Actualiser on the tile if you think the desk list is stale.

Stop-desk routing

An EcoTrack desk shipment is never downgraded to home delivery. If the customer's commune has no desk, DZBuild reroutes the parcel to another desk commune in the same wilaya, keeps the desk flag on, and writes the redirect into the parcel remark (« مكتب الاستلام: X (بلدية الزبون: Y) »). Only when the wilaya has no desk at all does the send fail, with a message telling you to switch to home delivery.

Tips

Many EcoTrack-based couriers have regional strengths (a specific wilaya cluster). Ask your account manager where they're fastest before promising next-day delivery.
If you change couriers but stay inside EcoTrack, you only need to link the new courier's tile with its token — orders, addresses and customer data are unaffected.
Use Custom EcoTrack for new couriers that haven't shown up in the DZBuild dashboard yet; it works as long as the courier exposes the standard EcoTrack endpoints.