DZBuild prend en charge les principaux transporteurs algériens. Une fois un transporteur lié dans votre tableau de bord, DZBuild peut pousser les nouvelles commandes vers son API, renvoyer les numéros de suivi à vos clients et synchroniser tarifs et points de retrait directement depuis le fournisseur.

🎬 Vidéo

Transporteurs supportés

Transporteur	Slug	Notes
Yalidine	`yalidine`	Toutes les 58 wilayas, large réseau de stop-desks, API mature
Famille EcoTrack	37 tuiles de transporteurs (`dhd`, `conexlog`, `msmgo`, `rocketdelivery`, `andersondelivery`, `speeddelivery`, `worldexpress`, …) plus `customecotrack`	Il n'existe pas de slug `ecotrack` à choisir — EcoTrack est une API à jeton Bearer partagée, vous choisissez donc la tuile de votre propre transporteur
ZR Express	`zrexpressnew`	Une seule tuile fusionnée. Collez l'une ou l'autre paire d'identifiants — DZBuild détermine seul si vous êtes sur la nouvelle plateforme ou sur l'ancienne API Procolis
Maystro Delivery	`maystro`	Forte couverture nationale, API à un seul jeton
Noest Express	`noest`	API Token + User GUID, couverture serrée sur l'Algérie
Abex Express	`abexexpress`	Même structure d'API Procolis que l'ancien ZR Express, mais avec ses propres Token + Key
Zimou Express	`zimou`	API autonome avec couverture nationale
Colivraison	`colivraison`	API autonome
Ecom Delivery	`ecomdelivery`	API autonome
Elogistia	`elogistia`	Un seul champ API Key ; l'une des deux seules familles dont le bordereau PDF officiel s'imprime depuis le tableau de bord
Stop Desk	type de livraison + addon	Retrait client au bureau du transporteur, fonctionne avec n'importe quel fournisseur lié

Le service Yalidine de DZBuild fonctionne aussi avec Yalitec, Guepex et Easy & Speed — ils partagent la même structure d'API et apparaissent sous leurs propres slugs dans le tableau de bord.

DHD et Conexlog sont des locataires EcoTrack, pas des intégrations distinctes — ils vivent simplement sur leurs propres hôtes (platform.dhd-dz.com et app.conexlog-dz.com) au lieu de *.ecotrack.dz. Voir la page EcoTrack pour la liste complète des 37 transporteurs.

Où lier un transporteur

Les transporteurs se lient depuis /dashboard/link-shipping — dans la barre latérale, Paramètres de livraison → « Connecter un transporteur ». La page est une grille de tuiles avec recherche. Depuis là vous pouvez :

Lier un transporteur : cliquez Lier sur sa tuile, saisissez les identifiants et enregistrez.
Gérer un transporteur déjà lié : le bouton de la tuile devient Gérer.
Définir un transporteur lié comme transporteur par défaut de la boutique (Définir comme transporteur par défaut).
Mettre un transporteur en pause ou le Délier à tout moment sans perdre les commandes existantes.

Les pastilles des tuiles indiquent l'état du lien, pas une vérification en direct des identifiants : une pastille verte signifie que le transporteur est lié / par défaut / actif / en pause. La pastille rouge API expirée n'apparaît qu'après des échecs d'authentification répétés sur les 30 derniers jours. Pour vérifier les identifiants sur-le-champ, ouvrez la tuile et cliquez Tester la connexion.

La page distincte /dashboard/shipping (« Tarifs de livraison ») est le tableau des prix de livraison par wilaya. C'est là que vous trouvez :

Le prix domicile et le prix bureau pour chacune des 58 wilayas, plus l'interrupteur de livraison au bureau par wilaya.
Synchroniser les tarifs — récupère les prix domicile + bureau de chaque wilaya auprès du transporteur lié.

📝 Remarque

Les pages de livraison n'existent pas pour les boutiques de produits numériques (le thème digital redirige les deux pages vers le tableau de bord). Les membres de l'équipe ont besoin de la permission shipping.view pour les ouvrir et de shipping.edit pour modifier quoi que ce soit, et l'abonnement de la boutique doit être actif.

Si votre activité a besoin de prix de livraison par produit (articles lourds, frais selon le volume, livraison gratuite sur certains SKU), activez l'addon Custom Product Shipping. Il exige le plan Pro ou supérieur (l'activer sur le plan gratuit est refusé avec « هذه الإضافة تتطلب خطة pro »), n'est pas disponible sur le thème digital, et dispose de sa propre page à /dashboard/addons/custom-shipping. Il vous donne un tarif forfaitaire par produit ou une tarification par wilaya, la livraison gratuite par produit, le prix le plus élevé qui l'emporte pour les paniers mixtes, et un raccourci « copier depuis les tarifs de la boutique ».

Ce qui est synchronisé depuis le transporteur

Donnée	Yalidine	EcoTrack	ZR Express	Maystro	Noest
Liste des wilayas	✅	✅	✅	✅	✅
Communes par wilaya	✅	✅	✅	✅	✅
Tarifs domicile + bureau	✅	✅	✅	✅	✅
Liste des stop-desks	✅	✅	Nouvelle plateforme ✅ / ancienne : pas de liste de bureaux	✅ (points de retrait)	✅

Aucun fournisseur lié n'est exclu de la synchronisation des tarifs. Maystro tarifie par commune : chaque wilaya est donc estimée à partir de sa commune-centre ; Noest renvoie un prix domicile et un prix bureau par wilaya.

L'ancienne plateforme ZR Express (Procolis) ne publie aucune liste de bureaux : toute une wilaya est alors considérée éligible au bureau dès que son prix Stopdesk est supérieur à zéro, le client voit une option générique au niveau commune « agence ZR Express », et ZR choisit le point de retrait réel à l'expédition. La nouvelle plateforme ZR renvoie une véritable liste de hubs.

Rafraîchir les données du fournisseur

Tout ce qui précède est rafraîchi automatiquement une fois par nuit. Pour le forcer sur un transporteur — c'est le remède à « mon nouveau transporteur n'affiche encore aucun bureau ni aucune commune » — ouvrez la tuile du transporteur à /dashboard/link-shipping et cliquez Actualiser dans la fenêtre. Le bouton n'apparaît que pour un transporteur déjà lié et impose un délai de 5 minutes par transporteur.

Ce qui se passe quand une commande part au transporteur

Vous confirmez la commande dans /dashboard/orders.
Dans la fenêtre d'envoi en livraison, vous choisissez le transporteur lié qui l'expédie, et DZBuild appelle l'API de ce transporteur avec le nom du client, son téléphone, son adresse, la liste des articles et le montant COD.
Le transporteur retourne un numéro de suivi, enregistré sur la commande.
La commande passe à processing — mais uniquement si elle était pending ou confirmed ; un statut plus avancé est laissé tel quel. DZBuild enregistre aussi le numéro de suivi, le nom du transporteur et l'horodatage de l'envoi.
La commande devient shipped d'elle-même dès que la synchronisation du suivi voit un statut d'enlèvement ou de transit, puis delivered (ou returned / cancelled).

Les données envoyées diffèrent selon la famille de transporteur, et c'est le point que les marchands comprennent le plus souvent de travers :

Ce qui est envoyé	Famille Yalidine	Famille EcoTrack	ZR Express (ancien)	ZR Express (nouveau)	Maystro	Noest
Montant COD	`price` = sous-total	`montant` = total de la commande	`Total` = total de la commande	`amount` = total de la commande	`product_price` = total de la commande	`montant` = total de la commande
Référence bureau	`is_stopdesk` + `stopdesk_id`	`stop_desk` 0/1 (commune = celle du bureau)	`TypeLivraison` 0/1	`deliveryType: "pickup-point"` + `hubId`	`delivery_type: 2`	`stop_desk: 1` + `station_code`
Poids	✅	✅	non envoyé	non envoyé	non envoyé	`poids`
Valeur déclarée	✅	—	—	—	—	—

La famille Yalidine est la seule à recevoir une valeur déclarée et un stopdesk_id, et la seule dont le montant COD est le sous-total plutôt que le total de la commande (Yalidine facture les frais de livraison séparément).

Impression des étiquettes

Imprimer l'étiquette récupère le bordereau PDF du transporteur uniquement pour les transporteurs de la famille EcoTrack et pour Elogistia (dont le bordereau existe en trois formats — 15×20, 10×15 et 10×10 cm, avec 10×15 par défaut). Pour tous les autres transporteurs, c'est le bordereau HTML propre à DZBuild qui s'imprime. Les URL d'étiquettes de Yalidine, Maystro et Noest sont bien captées et stockées sur la commande, mais aucun bouton du tableau de bord ne les ouvre aujourd'hui — imprimez-les depuis le portail du transporteur.

Synchronisation du suivi

DZBuild interroge automatiquement chaque transporteur lié sur les commandes qu'il a en cours et les fait avancer toute seule : processing → shipped → delivered, ou returned / cancelled. Un changement de statut côté transporteur apparaît en général sur votre commande en quelques minutes. Les retours et annulations restaurent le stock automatiquement.

Deux choses à savoir :

Un statut transporteur que DZBuild ne reconnaît pas laisse la commande intacte.
Un colis que le transporteur ne trouve pas n'est jamais annulé automatiquement — il est laissé tel quel et revérifié au cycle suivant. Seul un statut cancelled explicite du transporteur annule une commande.

Supplément de poids

Les colis de plus de 5 kg ajoutent un supplément au tarif de la wilaya au moment du paiement : 50 DA par kg supplémentaire, porté à 100 DA par kg supplémentaire pour les 13 wilayas du grand sud (Adrar, Béchar, Tamanrasset, El Bayadh, Illizi, Tindouf, Naâma, Timimoun, Bordj Badji Mokhtar, Béni Abbès, In Salah, In Guezzam, Djanet) lorsque le transporteur est Yalidine, Yalitec ou Guepex. Easy & Speed est délibérément exclu du tarif grand sud.

Le supplément est calculé à partir du poids de vos produits et s'ajoute à ce que paie le client — il n'apparaît pas comme une ligne du tableau des tarifs, si bien qu'une wilaya affichée à 600 DA peut coûter plus de 600 DA pour un panier lourd.

Étape par étape pour lier un transporteur

Ouvrez /dashboard/link-shipping et cherchez votre transporteur dans la grille de tuiles.
Cliquez Lier sur sa tuile.
Collez les identifiants fournis par le transporteur (jeton, ID, GUID — selon le transporteur, voir chaque page dédiée).
Cliquez sur Tester la connexion.
Cliquez sur Lier et enregistrer. Cochez éventuellement Définir comme transporteur par défaut.
Allez sur /dashboard/shipping pour synchroniser les tarifs par wilaya depuis le fournisseur ou les saisir à la main.

Questions fréquentes

Q : Puis-je lier plusieurs transporteurs ? R : Oui — liez-en autant que vous voulez et désignez-en un comme transporteur par défaut de la boutique. Au moment d'envoyer une commande (à l'unité ou en masse), vous choisissez le transporteur dans une liste déroulante de la fenêtre d'envoi en livraison, et DZBuild l'expédie via l'API de ce transporteur. Rien n'a besoin d'être expédié manuellement. Pour les commandes en bureau, les transporteurs sans bureau dans la commune du client sont grisés dans cette liste et étiquetés « لا يوجد مكتب ».

Q : Comment fonctionnent les versements COD ? R : Le transporteur encaisse à la livraison et reverse sur votre compte bancaire/CCP selon son calendrier (généralement chaque semaine). DZBuild ne gère pas la partie cash. Voir Paiement à la livraison.

Q : Mon transporteur n'est pas dans la liste — puis-je quand même utiliser DZBuild ? R : Oui. Expédiez manuellement : confirmez la commande, remettez le colis au transporteur, puis marquez la commande shipped dans /dashboard/orders. Pas de suivi automatique, mais le reste fonctionne. Avant de penser qu'il vous faut une intégration sur mesure, demandez à votre transporteur s'il tourne sur EcoTrack — 37 transporteurs EcoTrack ont déjà leur propre tuile, et la tuile Custom EcoTrack couvre n'importe quel autre locataire EcoTrack si vous disposez de son URL d'API.

Vue d'ensemble des transporteurs