EcoTrack est une API de livraison partagée qui propulse une grande famille de transporteurs algériens. Il n'y a pas de tuile « EcoTrack » à choisir : vous choisissez la tuile de votre propre transporteur, et DZBuild dialogue avec lui via l'API EcoTrack au moyen d'un unique jeton bearer. 82 transporteurs ont leur propre tuile :

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, SI Express, Colex, OKS Box, Majorex, Chronorex, Samex, Aranex, Amana Speed, Wassim Express, One Express, AB Delivery, Royaume Delivery, Eco Rapide Express, SBL Express, Wee Wee Delivery, Jaguar Livraison, RJ 360 Express, Lynx Express, RM Express, Rihal Express, Atlas Express, Boogi Technologie, Cirta Express, Colizone, GS Ecommerce, Jo Express, On Time Express, Quick Delivery DZ, RS Express, Ruta Express, Tawsil Star, Vitrans, BFK Express, Alania Express, Champion Logistics, El Guide Delivery, Fast Horse Express, LIH LIH Express, Mazaya Logistics, Ovred, Speed Mail, Win Delivery, Zinya Tec, Sultan Colis Express, Red Ex.

Si votre transporteur figure dans cette liste, choisissez sa tuile — pas besoin d'intégration sur mesure.

Deux d'entre eux ne vivent pas sur des hôtes *.ecotrack.dz mais sont malgré tout des locataires EcoTrack : DHD (platform.dhd-dz.com) et Conexlog (app.conexlog-dz.com). Aucun des deux n'est une intégration directe distincte.

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/link-shipping et cherchez le nom de votre transporteur dans la grille de tuiles (par ex. DHD, Conexlog, MSM Go, …).
Cliquez sur Lier sur sa tuile.
Collez votre API token dans le champ d'identifiant unique, intitulé Bearer Token. Les fournisseurs EcoTrack n'utilisent qu'un seul champ.
Cliquez sur Tester la connexion. Le tableau de bord interroge le transporteur en direct et confirme la validité du jeton.
Cliquez sur Lier et enregistrer.

Les prix par wilaya s'éditent sur la page distincte /dashboard/shipping.

Custom EcoTrack

Si votre transporteur n'est pas dans la grille de tuiles mais s'appuie sur EcoTrack, choisissez Ecotrack personnalisé et fournissez :

L'API URL de l'instance EcoTrack de votre transporteur — l'hôte de base uniquement, par ex. https://yourcourier.ecotrack.dz. DZBuild ajoute /api/v1 lui-même.
Un nom d'affichage (champ Nom du transporteur), jusqu'à 100 caractères. Ce que vous saisissez est ce qui apparaîtra partout dans le tableau de bord pour ce transporteur.
Le jeton bearer.

L'URL doit commencer par https:// et pointer vers un hôte EcoTrack : une adresse se terminant par .ecotrack.dz, ou les hôtes DHD et Conexlog cités plus haut. Tout autre domaine est refusé avec « رابط API غير مسموح », et les adresses internes, loopback et réservées sont refusées pour des raisons de sécurité. Chaque URL personnalisée conserve ses propres données synchronisées de communes, bureaux et tarifs : changer l'URL relance donc une synchronisation à zéro. Préférez toujours une tuile native quand il en existe une pour votre transporteur.

Ce qui est synchronisé

Liste des wilayas et communes desservies.
Tarifs domicile par wilaya.
Tarifs stop-desk par wilaya.
Les communes qui ont un stop-desk. EcoTrack ne publie pas de liste de bureaux nommés : le sélecteur Stop Desk propose donc une entrée par commune à bureau, affichée avec le nom du transporteur et la commune.

Ce qui se passe à l'expédition d'une commande

Quand vous envoyez une commande à un transporteur EcoTrack (le bouton Envoyer à sur la commande, ou un envoi en masse), DZBuild envoie le colis vers l'endpoint EcoTrack du transporteur avec :

nom_client, telephone et adresse. telephone_2 reste vide, car une commande DZBuild ne porte qu'un seul numéro client.
code_wilaya + commune.
montant : le total de la commande (produits plus livraison, moins remise), c'est-à-dire ce que paie le client à la livraison. Chaque famille de transporteurs a son propre nom de champ et son propre montant : lisez le tableau par famille dans la vue d'ensemble des transporteurs plutôt que de supposer que celui-ci s'applique ailleurs. La famille Yalidine est celle qui envoie le sous-total, parce qu'elle facture les frais de livraison séparément.
produit (le résumé des articles), remarque (votre note), weight, et reference (votre numéro de commande DZBuild).
type — 1 pour une livraison, 2 pour un échange.
stop_desk — 0 ou 1. Il n'y a pas de champ delivery_type ni de stopdesk_id : un colis en bureau s'exprime en envoyant la commune du bureau comme commune avec stop_desk = 1.
fragile = 1, uniquement quand le produit est marqué fragile.

Le transporteur retourne un numéro de suivi.

Drapeau fragile

Marquer un produit Fragile ajoute fragile = 1 aux colis EcoTrack. Hors de la famille EcoTrack, seul MDM Express reçoit aussi un drapeau fragile ; aucun autre transporteur n'en reçoit (l'API de Yalidine rejette purement et simplement les paramètres inconnus).

Limite de la description produit

Le résumé des articles envoyé à EcoTrack est plafonné à 255 caractères. Une commande longue à plusieurs articles est raccourcie par paliers : la liste complète, puis la même liste sans les suffixes de variantes entre parenthèses, puis les premiers articles suivis de +N, et enfin le nom du premier article tronqué, suivi de +N si la commande contient d'autres articles.

Imprimer le bordereau officiel du transporteur

EcoTrack est l'une des deux seules familles (l'autre étant Elogistia) dont le bordereau PDF officiel s'imprime directement depuis DZBuild. Cliquer sur Imprimer l'étiquette sur une commande EcoTrack télécharge l'étiquette officielle du transporteur en PDF — instances Custom EcoTrack comprises, via l'URL d'API que vous avez enregistrée.

Les commandes EcoTrack disposent aussi d'un bouton Expédier (« تأكيد الشحن ») propre à EcoTrack sur le panneau de détail de la commande, pour confirmer l'expédition auprès du transporteur.

Erreurs fréquentes

Symptôme	Cause probable	Correction
Le test de connexion échoue avec "Invalid or expired API credentials"	Jeton incorrect ou expiré	Régénérez le jeton dans le tableau de bord du transporteur et recollez-le.
« يرجى إدخال رابط API » (Custom EcoTrack)	Le champ API URL est vide	Collez l'hôte de base de votre transporteur.
« يرجى إدخال رابط صحيح يبدأ بـ https:// » (Custom EcoTrack)	L'URL n'est pas en `https://`	Ressaisissez-la avec le schéma `https://`.
« يرجى إدخال رابط عام صحيح (لا يُسمح بعناوين داخلية) » (Custom EcoTrack)	L'URL pointe vers une adresse privée, loopback ou réservée	Utilisez le nom d'hôte public du transporteur. Un domaine public hors EcoTrack est refusé avec « رابط API غير مسموح » ; une adresse erronée sur un hôte EcoTrack se manifeste par un échec du test de connexion venant de l'API du transporteur.
Commande créée mais sans numéro de suivi	Adresse refusée par le transporteur	Vérifiez l'adresse sur la commande ; généralement une commune absente ou non reconnue.
« مكتب الاستلام (Stop Desk) غير متوفر في هذه الولاية لشركة التوصيل المختارة » ou « لا يوجد مكتب استلام (Stop Desk) متاح في هذه الولاية لشركة … »	Aucun bureau nulle part dans cette wilaya	Repassez la commande en livraison à domicile, ou cliquez sur Actualiser sur la tuile si vous pensez que les données des bureaux sont périmées.

Routage stop-desk

Une expédition EcoTrack en bureau n'est jamais rétrogradée en livraison à domicile. Si la commune du client n'a aucun bureau, DZBuild réachemine le colis vers une autre commune à bureau de la même wilaya, garde le drapeau bureau actif, et inscrit la redirection dans la remarque du colis (« مكتب الاستلام: X (بلدية الزبون: Y) »). Ce n'est que lorsque la wilaya n'a aucun bureau du tout que l'envoi échoue, avec un message vous invitant à passer 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 de lier la tuile du nouveau transporteur avec son jeton — les commandes, adresses et données client ne bougent pas.
Utilisez Ecotrack personnalisé pour les nouveaux transporteurs absents du tableau de bord DZBuild ; cela fonctionne tant que leur API est sur un hôte EcoTrack (une adresse se terminant par .ecotrack.dz) et expose les endpoints EcoTrack standards.