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.
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:
| Field | Example | |
|---|---|---|
| API token | credentials.token | eyJ0… |
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.
| Courier | courier key |
|---|---|
| 48Hr Livraison | e48hrlivraison |
| AB Delivery | abdelivery |
| Alania Express | alania |
| Allo Livraison | allolivraison |
| Amana Speed | amana |
| Anderson Delivery | andersondelivery |
| Aranex | aranex |
| Areex | areex |
| Assil Delivery | assildelivery |
| Atlas Express | atlasexpress |
| BA Consult | baconsult |
| BFK Express | bfkexpress |
| Boogi Technologie | boogi |
| Champion Logistics | championlogistics |
| Chronorex | chronorex |
| Cirta Express | cirtaexpress |
| Colex | colex |
| Colireli | colireli |
| Colizone | colizone |
| Conexlog | conexlog |
| Coyote Express | coyoteexpress |
| Delivromail | delivromail |
| DHD Livraison | dhd |
| Distazero | distazero |
| Eco Rapide Express | ecorapideexpress |
| El Guide Delivery | elguidedelivery |
| Expedia Chrono | expediachrono |
| Fast Horse Express | fasthorse |
| FRET.Direct | fretdirect |
| FZ Delivery | fzdelivery |
| GOLIVRI | golivri |
| GS Ecommerce | gsecommerce |
| HHD Express | hhdexpress |
| Imir Logistics | imir |
| Jaguar Livraison | jaguar |
| Jo Express | joexpress |
| LIH LIH Express | lihlihexpress |
| Lynx Express | lynx |
| Majorex | majorex |
| Mazaya Logistics | mazaya |
| Med Express | medexpress |
| Mono Hub | monohub |
| MSM Go | msmgo |
| Navex Delivery | navexdelivery |
| Negmar Express | negmarexpress |
| OKS Box | oksbox |
| OM Express | omexpress |
| On Time Express | ontimeexpress |
| One Express | oneexpress |
| Ovred | ovred |
| Packers | packers |
| PDEX | pdex |
| Prest | prest |
| Quick Delivery DZ | quickdeliverydz |
| RB Livraison | rblivraison |
| Red Ex | redex |
| Rex Livraison | rexlivraison |
| Rihal Express | rihalexpress |
| RJ 360 Express | rj360express |
| RM Express | rmexpress |
| Rocket Delivery | rocketdelivery |
| Royaume Delivery | royaumedelivery |
| RS Express | rsexpress |
| Ruta Express | rutaexpress |
| Salva Delivery | salvadelivery |
| Samex | samex |
| SBL Express | sbl |
| SI Express | siexpress |
| Speed Delivery | speeddelivery |
| Speed Mail | speedmail |
| Sultan Colis Express | sultancolisexpress |
| Swift Express | swiftexpress |
| Tawsil Star | tawsilstar |
| TSL Express | tslexpress |
| Ultra Express | ultraexpress |
| Univer Delivery | univerdelivery |
| Vitrans | vitrans |
| Wassim Express | wassimexpress |
| Wee Wee Delivery | weeweedelivery |
| Win Delivery | windelivery |
| WorldExpress | worldexpress |
| Zinya Tec | zinyatec |
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
unknownwithrawStatuscarrying 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
NOEST
Ship with NOEST Express through dzship: credentials, parcel creation, stop desk codes, and the validation step that leaves parcels stranded when it is skipped.
Overview
The dzship API reference, generated from the OpenAPI 3.1 spec. Every operation with its request schema, its responses and a request builder.