Skip to main content

EcoTrack

EcoTrack is a shared shipping API that powers a large family of Algerian couriers. Picking the right slug in DZBuild lets you authenticate with a single bearer token and ship through any of these partners:

DHD, Conexlog, MSM Go, Rex Livraison, RB Livraison, Speed Delivery, Areex, Prest, Rocket Delivery, Worldexpress, BaConsult, Packers, 48hr Livraison, MonoHub, Anderson Delivery, Golivri, Coyote Express, Salva Delivery, Distazero, Fretdirect, TSL Express, Negmar Express, Ultra Express, OM Express, MedExpress, Allo Livraison, Assil Delivery, Expedia Chrono, HHD Express, Imir, Navex Delivery, Swift Express, Univer Delivery, Colireli, FZ Delivery, Delivromail, Pdex.

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

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​

  1. Open /dashboard/shipping.
  2. Click Link provider and pick your specific courier (e.g. DHD, Conexlog, MSM Go, …).
  3. Paste your API token into the single credential field. EcoTrack-based providers use one field only.
  4. Click Test API. The dashboard hits the courier live and confirms the token is valid.
  5. Save.

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

  • The API URL of your courier's EcoTrack instance (e.g. https://yourcourier.ecotrack.dz).
  • A display name for it.
  • The bearer token.

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:

  • Customer name, phone, address.
  • Destination wilaya code + commune.
  • Subtotal as the COD amount.
  • Weight and item summary.
  • delivery_type = home or stopdesk, with a valid stopdesk_id for desk delivery.

The courier returns a tracking number and (on most EcoTrack instances) a label/bordereau URL that you can print and stick on the parcel.

Common errors and fixes​

SymptomLikely causeFix
Test API returns "unauthorized"Wrong or expired tokenRegenerate the token in the courier's dashboard and paste it again.
"API URL not reachable" (Custom EcoTrack only)Wrong domainDouble-check the URL — most EcoTrack tenants live at https://<name>.ecotrack.dz.
Order created but no tracking numberAddress rejected by courierInspect the order log; usually a missing or unrecognized commune.
Stop-desk shipment downgraded to homeNo stopdesk_id selectedHave the customer pick a desk again, or 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 swap the slug + 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.