EcoTrack
EcoTrack est une API de livraison partagée qui propulse une grande famille de transporteurs algériens. En choisissant le bon slug dans DZBuild, vous vous authentifiez avec un seul jeton bearer et expédiez via n'importe lequel de ces partenaires :
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.
Si votre transporteur figure dans cette liste, choisissez son slug EcoTrack — pas besoin d'intégration sur mesure.
Ce qu'il vous faut
Une seule valeur depuis le tableau de bord EcoTrack de votre transporteur :
- API token (parfois appelé "Bearer token", "API key" ou "clé API").
Certains tableaux de bord EcoTrack la séparent sur deux écrans (compte → API → générer). Si vous ne la trouvez pas, demandez à votre interlocuteur d'activer l'accès API.
Lier un transporteur EcoTrack dans DZBuild
- Ouvrez
/dashboard/shipping. - Cliquez sur Link provider et choisissez votre transporteur (par ex. DHD, Conexlog, MSM Go, …).
- Collez votre API token dans le champ unique. Les transporteurs EcoTrack n'utilisent qu'un seul champ.
- Cliquez sur Test API. Le tableau de bord interroge le transporteur en direct et confirme la validité du jeton.
- Enregistrez.
Si votre transporteur n'est pas dans la liste mais s'appuie sur EcoTrack, choisissez Custom EcoTrack et fournissez :
- L'API URL de l'instance EcoTrack du transporteur (par ex.
https://yourcourier.ecotrack.dz). - Un nom d'affichage.
- Le jeton bearer.
Ce qui est synchronisé
- Liste des wilayas et communes desservies.
- Tarifs domicile par wilaya.
- Tarifs stop-desk par wilaya.
- Liste des stop-desks par wilaya (utilisée par le sélecteur Stop Desk).
Ce qui se passe à l'expédition d'une commande
Quand vous confirmez une commande dont la boutique est liée à un transporteur EcoTrack, DZBuild envoie le colis vers l'endpoint EcoTrack du transporteur avec :
- Nom, téléphone, adresse du client.
- Code wilaya de destination + commune.
- Sous-total comme montant COD.
- Poids et résumé des articles.
delivery_type = homeoustopdesk, avec unstopdesk_idvalide pour la livraison au bureau.
Le transporteur retourne un numéro de suivi et (sur la plupart des instances EcoTrack) une URL d'étiquette/bordereau que vous pouvez imprimer et coller sur le colis.
Erreurs fréquentes
| Symptôme | Cause probable | Correction |
|---|---|---|
| Test API renvoie "unauthorized" | Jeton incorrect ou expiré | Régénérez le jeton dans le tableau de bord du transporteur et recollez-le. |
| "API URL not reachable" (Custom EcoTrack) | Domaine incorrect | Vérifiez l'URL — la majorité des tenants EcoTrack vivent sur https://<nom>.ecotrack.dz. |
| Commande créée mais sans numéro de suivi | Adresse refusée par le transporteur | Consultez le journal de la commande ; généralement une commune absente ou non reconnue. |
| Livraison stop-desk repliée en domicile | Pas de stopdesk_id choisi | Faites resélectionner un bureau au client ou repassez en livraison à domicile. |
Astuces
- Beaucoup de transporteurs EcoTrack ont une force régionale (un cluster de wilayas). Demandez à votre interlocuteur où il est le plus rapide avant de promettre une livraison J+1.
- Si vous changez de transporteur tout en restant sur EcoTrack, il suffit d'échanger le slug + jeton — les commandes, adresses et données client ne bougent pas.
- Utilisez Custom EcoTrack pour les nouveaux transporteurs absents du tableau de bord DZBuild ; cela fonctionne tant qu'ils exposent les endpoints EcoTrack standards.