Vue d'ensemble des transporteurs

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	API mature ; wilayas, communes et bureaux proviennent de votre propre compte Yalidine
Famille EcoTrack	81 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	API à un seul jeton
Noest Express	noest	API Token + User GUID
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
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 tuiles.

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 :

• Un prix domicile et un prix bureau pour chaque wilaya, chacun derrière son propre interrupteur : vous pouvez donc désactiver la livraison à domicile, la livraison au bureau, ou les deux, sur une wilaya donnée.
• La liste des wilayas elle-même : 58 wilayas (la liste compatible avec les transporteurs) ou 69 wilayas (qui ajoute les plus récentes comme El Meniaa, Timimoun et Djanet). Le sélecteur de mode est en haut de la page. Lier un transporteur ramène la boutique à 58, car les API des transporteurs n'acceptent pas les nouvelles wilayas : le mode 69 n'est donc sélectionnable qu'avec aucun transporteur lié.
• 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

1. Vous confirmez la commande dans /dashboard/orders.
2. 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.
3. Le transporteur retourne un numéro de suivi, enregistré sur la commande.
4. 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.
5. 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.

C'est la règle tarifaire du transporteur lui-même ; DZBuild l'applique, elle ne l'invente pas. Si vous ne voulez pas qu'elle soit facturée sur un produit, laissez le poids de ce produit vide, ou activez la livraison gratuite dessus.

Étape par étape pour lier un transporteur

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

Si votre transporteur n'est pas dans la liste

Procédez dans cet ordre.

1. Demandez à votre transporteur s'il tourne sur EcoTrack. Une grande partie des transporteurs algériens le font, et 81 d'entre eux ont déjà leur propre tuile dans la grille. Si le vôtre est un locataire EcoTrack sans tuile dédiée, la tuile Custom EcoTrack prend son URL d'API plus un jeton Bearer et se comporte de la même façon. Voir la page EcoTrack.
2. Expédiez manuellement entre-temps. Confirmez la commande, remettez le colis au transporteur, puis marquez la commande shipped dans /dashboard/orders. Vous perdez le suivi automatique, rien d'autre ne change sur la commande.
3. Envoyez-nous la demande. Ouvrez un ticket de support avec le nom du transporteur et un lien vers sa documentation d'API. Ce lien est la partie qui compte : sans API publique, il n'y a rien sur quoi construire. Nous ne promettons pas de date pour un transporteur donné.

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 vous paie directement, selon son propre calendrier et les conditions convenues avec lui. DZBuild ne touche jamais cet argent et ne fait pas partie du règlement. Voir Paiement à la livraison.

Q : Mon transporteur n'est pas dans la liste. Puis-je quand même utiliser DZBuild ? R : Oui. Voir la section juste au-dessus pour les trois étapes.

Q : Une wilaya desservie par mon transporteur manque dans mon tableau de tarifs. R : Ce tableau reflète ce que couvre votre propre compte chez le transporteur, pas une liste DZBuild : il bouge donc quand le transporteur change votre couverture. Cliquez Actualiser sur la tuile du transporteur pour la retirer à nouveau. Si la wilaya manque toujours, ouvrez un ticket de support avec le message d'erreur exact et le numéro de commande, et saisissez cette commande directement dans la plateforme du transporteur pendant que nous regardons.