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	Toutes les 58 wilayas, large réseau de stop-desks, API mature
EcoTrack	ecotrack (et 30+ partenaires basés sur EcoTrack : DHD, Conexlog, MSM Go, Rocket, Anderson, Speed Delivery, Worldexpress, …)	API à jeton Bearer partagée par tous les transporteurs propulsés par EcoTrack
ZR Express	zrexpress (ancienne API Procolis) et zr-express-new (nouvelle plateforme)	Deux API : choisissez celle qui correspond à votre tableau de bord ZR Express
Maystro Delivery	maystro	Forte couverture nationale, API à un seul jeton
Noest Express	noest	Jeton + GUID utilisateur, couverture serrée sur l'Algérie
Zimou Express	zimou	API autonome avec couverture nationale
Colivraison	colivraison	API autonome
DHD	dhd	API DHD direct ; DHD est aussi accessible via EcoTrack pour les utilisateurs de la plateforme EcoTrack
EcomDelivery	ecomdelivery	API autonome
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.

Où lier un transporteur

Allez dans /dashboard/shipping. Depuis là vous pouvez :

• Choisir le fournisseur de livraison par défaut de la boutique.
• Saisir les identifiants API du transporteur et cliquer sur Test API (le tableau de bord vérifie en direct auprès du fournisseur).
• Voir le statut API en temps réel (vert = lié, rouge = identifiants invalides).
• Synchroniser les tarifs depuis le fournisseur — récupère les prix domicile + bureau de chaque wilaya quand le transporteur le permet.
• Délier un fournisseur à tout moment sans perdre les commandes existantes.

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 permet à chaque produit de remplacer le tarif au niveau wilaya.

Ce qui est synchronisé depuis le transporteur

Donnée	Yalidine	EcoTrack	ZR Express	Maystro	Noest
Liste des wilayas	✅	✅	✅	(intégrée)	(intégrée)
Communes par wilaya	✅	✅	✅	✅	✅
Tarifs domicile + bureau	✅	✅	✅	❌ (manuel)	❌ (manuel)
Liste des stop-desks	✅	✅	✅	✅	✅

Ce qui se passe quand une commande part au transporteur

1. Vous confirmez la commande dans /dashboard/orders.
2. DZBuild appelle l'API du transporteur avec le nom du client, son téléphone, son adresse, les articles, le montant COD, la valeur déclarée, le poids et (pour la livraison au bureau) un stopdesk_id.
3. Le transporteur retourne un numéro de suivi et (selon le fournisseur) une URL d'étiquette.
4. Le statut de la commande passe à shipped, le suivi est enregistré et le client le voit sur la page de sa commande.
5. À chaque scan du colis chez le transporteur, le statut remonte vers DZBuild : processing → shipped → delivered (ou returned / cancelled).

DZBuild génère aussi sa propre étiquette de livraison (un bordereau prêt à imprimer à coller sur le colis) — distincte de l'étiquette officielle du transporteur, que la plupart des API exposent également. Utilisez celle que votre transporteur accepte.

Étape par étape pour lier un transporteur

1. Ouvrez /dashboard/shipping.
2. Cliquez Link provider et choisissez le transporteur.
3. Collez les identifiants fournis par le transporteur (jeton, ID, GUID — selon le transporteur, voir chaque page dédiée).
4. Cliquez sur Test API.
5. Si vert, enregistrez. Le transporteur devient le fournisseur par défaut, et les tarifs par wilaya peuvent être surchargés manuellement ou tirés du fournisseur.

Questions fréquentes

Q : Puis-je lier plusieurs transporteurs ? R : Un seul fournisseur de livraison est défini comme défaut à la fois, mais vous pouvez expédier des commandes individuelles manuellement via d'autres transporteurs. La plupart des marchands lient un transporteur principal en API et expédient le reste à la main.

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. Beaucoup de transporteurs propulsés par EcoTrack sont déjà couverts via le slug EcoTrack — demandez à votre transporteur avant de penser qu'il faut une intégration sur mesure.