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.

Le service Yalidine de DZBuild fonctionne aussi avec Yalitec, Guepex, Easy & Speed, Economiqua et We Can Services. 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.

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 :

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é ou actif, une pastille orange qu'il est par défaut ou en pause. La pastille rouge API expirée apparaît après des échecs d'authentification répétés sur les 30 derniers jours. La pastille rouge API expirée, envois arrêtés signifie que le transporteur a refusé vos clés à plusieurs reprises : les envois et le suivi automatique sont arrêtés pour ce transporteur jusqu'à ce que vous colliez de nouveaux identifiants et cliquiez sur Enregistrer les modifications. 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 :

📝 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 ».

Tout transporteur lié peut synchroniser ses tarifs, sauf MDM Express et Near Delivery, dont vous saisissez les prix à la main ; un transporteur en pause reste hors de la liste de synchronisation tant que vous ne le réactivez pas. 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.

Tout ce qui figure dans le tableau ci-dessus est rafraîchi automatiquement une fois par nuit. Vos propres prix n'en font pas partie : les tarifs de /dashboard/shipping changent lorsque vous lancez une synchronisation avec Synchroniser les tarifs sur cette page (ou avec l'interrupteur de synchronisation quand vous liez un transporteur), ou lorsque vous les modifiez à la main. Pour forcer le rafraîchissement des wilayas, communes et bureaux d'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é, ne fonctionne que tant que ce transporteur est actif (pas en pause), et impose un délai de 5 minutes par transporteur.

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 :

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).

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.

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. Une annulation par le transporteur remet le stock aussitôt. Un retour le remet dès que le transporteur signale le colis revenu chez vous, quand vous cliquez sur Retour reçu sur la commande, ou 15 jours après le début du retour, selon ce qui arrive en premier.

Deux choses à savoir :

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.

Procédez dans cet ordre.

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 wilaya du client sont grisés dans cette liste et étiquetés « لا يوجد مكتب », et quand le client a choisi un bureau précis, le transporteur à qui il appartient est sélectionné pour vous.

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 renvoie votre propre compte chez le transporteur, pas une liste DZBuild : il bouge donc quand le transporteur change votre couverture. Cliquez sur Synchroniser les tarifs dans /dashboard/shipping pour récupérer à nouveau vos tarifs ; Actualiser sur la tuile du transporteur rafraîchit les communes et les bureaux, pas vos prix. 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.