Yalidine est l'un des transporteurs nationaux les plus utilisés en Algérie : couverture des 58 wilayas, large réseau de stop-desks et API stable. La même intégration DZBuild propulse aussi Yalitec, Guepex et Easy & Speed, qui partagent la structure d'API de Yalidine sous leurs propres tableaux de bord.
Ce qu'il vous faut
Deux valeurs depuis votre tableau de bord Yalidine :
API ID
API Token
Toutes deux sont émises depuis votre compte Yalidine ; si vous ne les voyez pas, demandez à Yalidine d'activer l'accès API sur votre compte. L'accès API exige généralement un compte professionnel vérifié.
Lier Yalidine dans DZBuild
Ouvrez
/dashboard/link-shippingdans le tableau de bord et cherchez « Yalidine » dans la grille de tuiles (ou Yalitec / Guepex / Easy & Speed si c'est votre revendeur).Cliquez sur Lier sur sa tuile.
Collez votre API ID dans le premier champ.
Collez votre API Token dans le second champ.
Cliquez sur Tester la connexion. Le tableau de bord interroge Yalidine en direct et affiche un check vert si les identifiants sont valides.
Cliquez sur Lier et enregistrer. Cochez Définir comme transporteur par défaut si Yalidine doit être le transporteur par défaut de la boutique.
Les tarifs, eux, vivent sur la page distincte /dashboard/shipping. Depuis là vous pouvez :
Synchroniser les tarifs — récupère les tarifs domicile + bureau de Yalidine pour chaque wilaya.
Surcharger manuellement n'importe quel tarif si vous voulez absorber une partie de la livraison ou appliquer une marge.
⚠️ Attention — Renseignez d'abord la wilaya de votre boutique
La synchronisation des tarifs pour la famille Yalidine (Yalidine, Yalitec, Guepex, Easy & Speed) a besoin de la wilaya de votre propre boutique. Si elle n'est pas renseignée dans les paramètres de la boutique, la synchronisation échoue avec « يرجى تحديد ولاية المتجر من إعدادات المتجر قبل مزامنة الأسعار. ». Cette même wilaya est envoyée comme from_wilaya_name sur chaque colis, et vaut Alger par défaut si elle n'est pas définie.
Express vs Économique (Guepex uniquement)
La fenêtre d'identifiants affiche un sélecteur de niveau de livraison — Express ou Économique — pour Guepex uniquement. Yalidine, Yalitec et Easy & Speed expédient toujours en Express, car leur API rejette purement et simplement le paramètre economic.
Le niveau choisi sert à la fois au tarif affiché au paiement et au colis envoyé : le changer change donc ce que paie votre client.
Ce qui est synchronisé
Liste complète des wilayas et communes. Les noms de communes proviennent en priorité de la liste de communes synchronisée depuis le fournisseur (l'orthographe de Yalidine), avec la liste de communes intégrée à DZBuild en repli. Une commune qui n'appartient pas à la wilaya de la commande fait échouer l'envoi (« البلدية المحددة لا تنتمي إلى الولاية المختارة ») au lieu d'être corrigée automatiquement.
Tarif domicile par wilaya.
Tarif stop-desk par wilaya.
Liste des stop-desks par wilaya, utilisée par le sélecteur de stop-desk.
Dimensions du produit
Le formulaire produit n'affiche les champs longueur / largeur / hauteur que si un transporteur de la famille Yalidine est lié — aucune autre famille n'accepte de dimensions. Si vous les laissez vides, le colis part en 10 × 10 × 10 cm et 0,5 kg.
Ce qui se passe à l'expédition d'une commande
Quand vous confirmez une commande dans /dashboard/orders et que le fournisseur de la boutique est Yalidine, DZBuild crée le colis chez Yalidine avec :
Prénom, nom, téléphone du client (formaté automatiquement au format local
0X). Un seul numéro parvient à Yalidine — un second numéro client est stocké sur la commande DZBuild mais n'est pas transmis.Adresse, wilaya de destination, commune de destination (résolue en français).
Wilaya d'origine (la wilaya de votre boutique — utilisée comme
from_wilaya_name).Résumé de la liste des produits.
Montant COD (
price= sous-total, c'est ce que paie le client à la livraison).Valeur déclarée, longueur, largeur, hauteur, poids.
Drapeau
is_stopdeskplus unstopdesk_idvalide quand la livraison au bureau est sélectionnée.freeshipping,do_insuranceet drapeaux d'échange si applicable.
Yalidine retourne :
Un numéro de suivi (enregistré sur la commande).
Une URL d'étiquette (PDF), captée et stockée sur la commande.
📝 Remarque — Imprimer l'étiquette Yalidine
Aucun bouton du tableau de bord DZBuild n'ouvre l'URL d'étiquette de Yalidine. Cliquer sur Imprimer l'étiquette sur une commande Yalidine imprime le bordereau HTML propre à DZBuild — imprimez l'étiquette officielle Yalidine depuis le portail Yalidine.
La commande passe à processing à l'envoi (et seulement si elle était pending ou confirmed), et le client voit le suivi sur la page de sa commande. Elle devient shipped quand la synchronisation de suivi automatique voit un statut de transit Yalidine tel que « Ramassé », « Expédié » ou « En cours de livraison », puis delivered (ou returned / cancelled).
Troncature de la liste des produits
Les commandes longues à plusieurs articles voient leur liste de produits raccourcie pour tenir dans la limite de 150 caractères de Yalidine. DZBuild dégrade par paliers : la liste complète a | b | c, puis la même liste sans les suffixes de variantes entre parenthèses, puis les premiers articles suivis de +N, et enfin un résumé du type x8 ORD-12345. L'addon Custom Delivery Label (Pro) vous permet de contrôler ce qui y est écrit.
Stop desk avec Yalidine
Yalidine dispose du plus grand réseau de stop-desks d'Algérie. Quand le client choisit la livraison au bureau :
L'addon Stop Desk montre les bureaux de la wilaya sélectionnée avec nom, adresse et téléphone.
La commande stocke les
desk_id/desk_namepropres à DZBuild. Lestopdesk_idde Yalidine est résolu au moment de l'envoi : le bureau choisi par le client, sinon n'importe quel bureau de sa commune, sinon n'importe quel bureau de la wilaya. La commune envoyée avec le colis est ensuite forcée à celle du bureau, si bien que l'identifiant et la commune concordent toujours.L'envoi est refusé — jamais rétrogradé en livraison à domicile — uniquement lorsque toute la wilaya n'a aucun bureau Yalidine. DZBuild peut le refuser avant même de contacter Yalidine, en se basant sur les données de bureaux déjà synchronisées.
Erreurs fréquentes
Message | Cause | Correction |
| API ID ou API Token mal formé | Recopiez les deux valeurs depuis le tableau Yalidine ; les deux champs sont faciles à inverser. |
| Identifiants rejetés par Yalidine | Même correction — et vérifiez que le compte a toujours l'accès API. |
| Compte présent mais API non activée | Contactez Yalidine pour activer l'accès API. |
| Trop de requêtes en peu de temps | Patientez une minute et réessayez ; Yalidine limite agressivement. |
| Toute la wilaya n'a aucun bureau Yalidine | Actualisez les données du fournisseur depuis la tuile, ou repassez la commande en livraison à domicile. |
| Commune et wilaya incohérentes sur la commande | Corrigez la commune sur la commande puis renvoyez. |
Commande créée mais sans suivi | Adresse ou commune non reconnues | Vérifiez l'orthographe de la commune sur la commande puis renvoyez. |
Astuces
Yalidine attend les communes en français. DZBuild compare d'abord à la liste de communes synchronisée depuis Yalidine puis se rabat sur sa liste de communes intégrée, mais les orthographes rares peuvent quand même échouer — gardez la liste de communes propre, et cliquez sur Actualiser sur la tuile Yalidine si la liste synchronisée semble périmée.
Le
priceenvoyé à Yalidine est le sous-total (prix produits), pas le total avec livraison. C'est ce que le transporteur encaisse en COD.Si vous avez aussi un compte Yalitec / Guepex / Easy & Speed, liez-le sous son slug ; même structure d'API mais identifiants non interchangeables.