Skip to Content
dzshipBY DZBUILD

Ecotrack couriers integration guide (DHD, Conexlog, MSM Go & 80 more)

One integration for the 82 couriers that run on Ecotrack, including DHD, Conexlog, MSM Go, Rocket Delivery and World Express: the token, the courier keys and how desks are routed.

Edit on GitHub

Ecotrack isn't a courier; it's the platform a large slice of Algeria's regional couriers run on. DHD, Conexlog, MSM Go, World Express and dozens of others are each independent delivery companies with their own fleets and pricing, all exposing the same Ecotrack API on their own domain.

That's good news for you: one integration, 82 couriers. Pick the regional courier your customers trust, and the code doesn't change.

What you need

Just your API token from that courier's dashboard:

FieldExample
API tokencredentials.tokeneyJ0…

You do not need to know the courier's URL. Every Ecotrack courier below has its own courier key, and dzship keeps the address. Use "courier": "dhd", not "courier": "ecotrack" plus a URL you had to look up.

If your courier runs Ecotrack but isn't in the list yet, fall back to the generic key and name the tenant yourself — it must be a *.ecotrack.dz host:

{ "courier": "ecotrack", "credentials": { "token": "…" },
  "options": { "baseUrl": "https://yourname.ecotrack.dz" } }

Anything else is refused with EGRESS_BLOCKED: the API only ever connects to addresses a courier actually owns. Open an issue and we'll add your courier's key.

The 82 Ecotrack couriers

Use the key in the courier field. GET /v1/couriers?platform=ecotrack returns the same list live.

Couriercourier key
48Hr Livraisone48hrlivraison
AB Deliveryabdelivery
Alania Expressalania
Allo Livraisonallolivraison
Amana Speedamana
Anderson Deliveryandersondelivery
Aranexaranex
Areexareex
Assil Deliveryassildelivery
Atlas Expressatlasexpress
BA Consultbaconsult
BFK Expressbfkexpress
Boogi Technologieboogi
Champion Logisticschampionlogistics
Chronorexchronorex
Cirta Expresscirtaexpress
Colexcolex
Colirelicolireli
Colizonecolizone
Conexlogconexlog
Coyote Expresscoyoteexpress
Delivromaildelivromail
DHD Livraisondhd
Distazerodistazero
Eco Rapide Expressecorapideexpress
El Guide Deliveryelguidedelivery
Expedia Chronoexpediachrono
Fast Horse Expressfasthorse
FRET.Directfretdirect
FZ Deliveryfzdelivery
GOLIVRIgolivri
GS Ecommercegsecommerce
HHD Expresshhdexpress
Imir Logisticsimir
Jaguar Livraisonjaguar
Jo Expressjoexpress
LIH LIH Expresslihlihexpress
Lynx Expresslynx
Majorexmajorex
Mazaya Logisticsmazaya
Med Expressmedexpress
Mono Hubmonohub
MSM Gomsmgo
Navex Deliverynavexdelivery
Negmar Expressnegmarexpress
OKS Boxoksbox
OM Expressomexpress
On Time Expressontimeexpress
One Expressoneexpress
Ovredovred
Packerspackers
PDEXpdex
Prestprest
Quick Delivery DZquickdeliverydz
RB Livraisonrblivraison
Red Exredex
Rex Livraisonrexlivraison
Rihal Expressrihalexpress
RJ 360 Expressrj360express
RM Expressrmexpress
Rocket Deliveryrocketdelivery
Royaume Deliveryroyaumedelivery
RS Expressrsexpress
Ruta Expressrutaexpress
Salva Deliverysalvadelivery
Samexsamex
SBL Expresssbl
SI Expresssiexpress
Speed Deliveryspeeddelivery
Speed Mailspeedmail
Sultan Colis Expresssultancolisexpress
Swift Expressswiftexpress
Tawsil Startawsilstar
TSL Expresstslexpress
Ultra Expressultraexpress
Univer Deliveryuniverdelivery
Vitransvitrans
Wassim Expresswassimexpress
Wee Wee Deliveryweeweedelivery
Win Deliverywindelivery
WorldExpressworldexpress
Zinya Teczinyatec

Create a parcel

curl -X POST https://freeship.dzbuild.com/v1/orders \
  -H 'Content-Type: application/json' \
  -d '{
    "courier": "dhd",
    "credentials": { "token": "YOUR_TOKEN" },
    "order": {
      "reference": "ORD-1005",
      "recipient": {
        "fullName": "Nassim Merabet",
        "phone": "0561234567",
        "wilayaCode": 6,
        "communeName": "Bejaia"
      },
      "deliveryType": "home",
      "productList": "Cafetière italienne x1",
      "codAmount": 5200
    }
  }'

Ecotrack-specific behavior

  • Labels come back as PDF: the label endpoint returns raw PDF bytes rather than a URL. dzship handles the difference; if you get a labelUrl, it's printable.
  • Status wording drifts per tenant: each courier can customize status labels, so tenant A's "En livraison" can be tenant B's "Sorti en livraison". The known vocabulary maps to the canonical statuses; an unrecognized label comes through as unknown with rawStatus carrying the original text, so nothing is silently mislabeled.
  • Tracking lookups need care: the underlying Ecotrack tracking API answers list-style queries, and a lazy "take the first row" client can attach the wrong parcel's status to your order. The dzship integration matches the exact tracking number. Worth knowing if you ever debug against the raw API.
  • No cancel endpoint: cancel from the courier's dashboard.

Which Ecotrack courier should I pick?

The platform is identical; the companies aren't. Delivered rate, pickup punctuality and COD remittance speed vary by company and by region. Treat it like the general choosing-a-courier question: short-list couriers your target wilayas trust, run a small volume through each, compare outcomes. Switching later is a one-word change to courier.

Full request/response reference: freeship.dzbuild.com, or the endpoints guide.

Last updated on

On this page