Aller au contenu principal

Yalidine

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​

  1. Ouvrez /dashboard/shipping dans le tableau de bord.
  2. Cliquez sur Link provider et choisissez Yalidine (ou Yalitec / Guepex / Easy & Speed si c'est votre revendeur).
  3. Collez votre API ID dans le premier champ.
  4. Collez votre API Token dans le second champ.
  5. Cliquez sur Test API. Le tableau de bord interroge Yalidine en direct et affiche un check vert si les identifiants sont valides.
  6. Enregistrez.

Yalidine devient le fournisseur de livraison par défaut de la boutique. Depuis la même page vous pouvez :

  • Sync rates from provider — récupère les tarifs domicile + bureau de chaque wilaya.
  • Surcharger manuellement n'importe quel tarif si vous voulez absorber une partie de la livraison ou appliquer une marge.

Ce qui est synchronisé​

  • Liste complète des wilayas et communes (avec résolution automatique arabe ↔ français — DZBuild traduit les noms de communes arabes vers les noms français attendus par Yalidine).
  • Tarif domicile par wilaya.
  • Tarif stop-desk par wilaya.
  • Liste des stop-desks par wilaya, utilisée par le sélecteur de stop-desk.

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 appelle l'endpoint /parcels/ de Yalidine avec :

  • Prénom, nom, téléphone du client (formaté automatiquement au format local 0X, avec un second numéro si vous l'avez collecté).
  • 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_stopdesk plus un stopdesk_id valide quand la livraison au bureau est sélectionnée.
  • freeshipping, do_insurance et drapeaux d'échange si applicable.

Yalidine retourne :

  • Un numéro de suivi (enregistré sur la commande).
  • Une URL d'étiquette (PDF) prête à imprimer.

Le statut de la commande passe à shipped et le client voit le suivi sur sa page commande. Au fil du transport, les mises à jour remontent dans la timeline de la commande (processing → shipped → delivered, ou returned / cancelled).

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.
  • DZBuild stocke stopdesk_id sur la commande — Yalidine l'exige ; s'il manque pour une livraison au bureau, DZBuild lève une erreur avant l'envoi pour que le colis ne soit jamais redirigé par erreur en livraison à domicile.

Erreurs fréquentes​

MessageCauseCorrection
بيانات API غير صحيحة / HTTP 401API ID ou API Token incorrectRecopiez les deux valeurs depuis le tableau Yalidine ; les deux champs sont faciles à inverser.
غير مصرح / HTTP 403Compte présent mais API non activéeContactez Yalidine pour activer l'accès API.
تم تجاوز حد الطلبات / HTTP 429Trop de requêtes en peu de tempsPatientez une minute et réessayez ; Yalidine limite agressivement.
لا يوجد مكتب استلام (Stop Desk) متاحLivraison au bureau sans stopdesk_idDemandez au client de choisir un autre bureau ou repassez la commande en livraison à domicile.
Commande créée mais sans suiviAdresse ou commune non reconnuesVérifiez l'orthographe de la commune puis renvoyez. Le journal de la commande dans DZBuild montre la réponse brute de Yalidine.

Astuces​

  • Yalidine attend les communes en français. DZBuild gère automatiquement la résolution arabe → français via la table communes, mais les orthographes rares peuvent échouer — gardez la liste de communes propre.
  • Le price envoyé à 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.