Terminal Delivery

Terminal Delivery est un transporteur algérien qui propose la livraison à domicile, ses propres stop-desks et des points relais partenaires (des boutiques qui gardent le colis pour l'acheteur). L'intégration demande une seule valeur : le jeton API de votre boutique.

Ce qu'il vous faut

• Une seule valeur, étiquetée API Token dans la fenêtre d'identifiants, fournie par votre compte Terminal Delivery. Terminal s'authentifie avec Authorization: Token <valeur>.

Si votre compte n'a pas encore de jeton, demandez à Terminal Delivery d'activer l'accès API.

Lier Terminal Delivery dans DZBuild

1. Ouvrez /dashboard/link-shipping et trouvez la tuile Terminal Delivery.
2. Cliquez sur Lier.
3. Collez votre API Token dans l'unique champ d'identifiant.
4. Cliquez sur Tester la connexion. DZBuild interroge Terminal en direct ; un jeton erroné est refusé tout de suite.
5. Cliquez sur Lier et enregistrer.

Les prix par wilaya se modifient sur /dashboard/shipping.

Ce qui est synchronisé

• Les wilayas desservies par Terminal.
• Les communes par wilaya, avec les identifiants de commune propres à Terminal.
• Les tarifs domicile et stop-desk par wilaya.
• Les stop-desks et points relais partenaires pour le sélecteur Stop Desk.

Tarifs

Synchroniser les tarifs depuis le transporteur lit les options de livraison de Terminal pour chaque wilaya et remplit le prix domicile et le prix stop-desk. Ce sont les prix standard (hors express).

Terminal fixe ses prix par commune, donc DZBuild lit la commune chef-lieu de chaque wilaya. Une wilaya dont le chef-lieu n'a pas de prix pour votre boutique reste à 0 ; saisissez-le à la main sur /dashboard/shipping.

Stop-desks et points relais

Terminal liste deux types de lieux par commune : ses propres stop-desks et des points relais partenaires. DZBuild affiche les deux dans le sélecteur Stop Desk. Il lit d'abord le chef-lieu de chaque wilaya ; quand une wilaya a un prix stop-desk mais que son chef-lieu ne liste aucun lieu, DZBuild vérifie jusqu'à 15 autres communes de cette wilaya.

La livraison en stop-desk n'est proposée que dans les communes où Terminal a listé un stop-desk ou un point relais. Une commande envoyée vers un point relais partenaire porte l'identifiant du point, pour que le colis arrive dans cette boutique.

Ce qui se passe à l'envoi d'une commande

DZBuild envoie la commande avec le nom, le téléphone et l'adresse du client, la commune sous forme d'identifiant de commune Terminal (ou les noms de la commune et de la wilaya quand la commune n'est pas dans la liste synchronisée ; Terminal les reconnaît en latin ou en arabe), le type de livraison (1 domicile, 2 stop-desk, 3 point relais), la liste des produits sur une seule ligne, votre numéro de commande comme external_id, et total_price. Une commande stop-desk part avec la commune du bureau choisi.

Trois règles à connaître :

• total_price inclut la livraison. C'est le montant que paie le client et il doit être au moins égal au prix de livraison de Terminal pour cette commune, sinon la commande est refusée (code 10).
• Les doublons sont refusés pendant 24 heures. Une commande avec le même nom et le même téléphone qu'une de vos commandes actives des dernières 24 heures est refusée (code 55). Corrigez le téléphone ou attendez ; ne renvoyez pas telle quelle.
• Pas d'annulation par l'API. Annulez un colis depuis votre compte Terminal Delivery.

Terminal répond avec un identifiant de commande (enregistré comme suivi) et un numéro de suivi imprimé sur le bordereau. DZBuild récupère le bordereau tout de suite ; Imprimer l'étiquette sur la commande l'imprime.

Signification des statuts

Statut Terminal	Ce que cela veut dire	Statut DZBuild
4 Created, 5 Pickup requested, 6 In process, 8 Waiting transit, 9 In transit, 11 Pending, 12 Out of stock, 15 Ready to ship, 22 Assigned	Le colis est chez Terminal, pas encore en tournée	En traitement
31 Shipped, 32 Alerted, 42 Postponed, 51 Ready to return	En tournée, ou une tentative échouée	Expédiée
33 Ready for pickup	Attend le client au bureau ou au point relais	Expédiée
41 Delivered	Livrée	Livrée
50 Aborted	Annulée par Terminal	Annulée
10 In transit to be returned, 53 Not received	Le colis revient	Retournée (le stock attend)
52 Taken by store	Le colis est de retour chez vous	Retournée (stock restitué)

Un retour qui n'atteint jamais le statut 52 récupère son stock après 15 jours, ou plus tôt quand vous le marquez reçu sur la commande.

Erreurs courantes et solutions

DZBuild affiche les refus de Terminal en arabe. Quand Terminal ajoute sa propre explication, elle suit le message entre parenthèses.

Symptôme	Cause probable	Solution
« بيانات الاعتماد غير صحيحة لدى Terminal Delivery (HTTP 401) - تأكد من رمز الـ Token »	Jeton erroné ou expiré	Recopiez le jeton depuis votre compte Terminal.
« فشل التحقق: السعر الإجمالي أقل من الحد الأدنى لدى Terminal Delivery، السعر يجب أن يشمل تكلفة التوصيل » (code 10)	Le total de la commande est sous le prix de livraison de Terminal pour cette commune	Vérifiez que le total inclut le prix de livraison, et augmentez les frais de livraison de la commande si ce n'est pas le cas.
« فشل التحقق: لا يوجد سعر توصيل لهذه البلدية في حساب Terminal Delivery » (code 70)	Votre compte Terminal n'a pas de prix pour cette commune	Demandez à Terminal Delivery d'ouvrir la commune, ou envoyez cette commande avec un autre transporteur.
« لم يتم العثور على البلدية لدى Terminal Delivery أو المنطقة غير مغطاة » (code 40)	Terminal ne connaît pas ou ne dessert pas la commune	Corrigez la commune, ou cliquez sur Actualiser sur la tuile pour resynchroniser la liste des communes.
« مكتب الاستلام (Stop Desk) أو نقطة الاستلام غير متوفرة في هذه البلدية لدى Terminal Delivery » (code 45)	Aucun stop-desk ni point relais dans cette commune	Passez la commande en livraison à domicile ou choisissez un autre bureau.
« طلب مكرر لدى Terminal Delivery: يوجد طلب نشط بنفس اسم العميل ورقم الهاتف خلال آخر 24 ساعة، لا تُعِد الإرسال » (code 55)	Même nom et même téléphone qu'une commande active des dernières 24 heures	Attendez, ou corrigez le téléphone ; ne renvoyez pas telle quelle.
« فشل التحقق: المنتج غير موجود أو غير متطابق في كتالوج Terminal Delivery » (code 50)	La ligne produit n'a pas pu être créée ni retrouvée dans le catalogue Terminal	Renommez le produit dans DZBuild, ou créez-le dans Terminal avec le même nom.
« فشل التحقق: حساب Terminal Delivery غير مفعّل للإرسال عبر API، تواصل مع Terminal » (code 120)	Votre compte Terminal n'est pas activé pour les commandes par API	Demandez à Terminal Delivery de l'activer.
« ملصق Terminal Delivery غير متوفر لهذا الطلب، اطبعه من لوحة Terminal Delivery »	Terminal n'a pas renvoyé le bordereau à l'envoi de la commande	Imprimez le bordereau depuis votre compte Terminal Delivery.

Conseils

• Le test de connexion fonctionne sur un compte sans aucun envoi.
• Un nouveau nom de produit crée un produit dans votre catalogue Terminal ; gardez des noms stables pour que la vue stock de Terminal reste lisible. Quand un nom existe déjà là-bas, DZBuild réutilise ce produit.
• Terminal autorise 300 appels API par minute et par compte ; DZBuild attend les secondes demandées par Terminal (10 au plus) avant une seule nouvelle tentative.