Stop Desk laisse le client retirer son colis au bureau du transporteur au lieu d'une livraison à domicile. Dans DZBuild, Stop Desk est deux choses à la fois :

Un type de livraison intégré (delivery_type = 'desk') piloté par vos propres tarifs de livraison par wilaya — il fonctionne avec n'importe quel transporteur lié, et même sans aucun.
Un addon (Stop Desk Selector) qui ajoute un sélecteur structuré affichant nom, adresse et téléphone de chaque bureau au checkout.

Vous pouvez expédier des colis Stop Desk sans l'addon — mais l'addon rend l'expérience nettement plus fluide pour le client.

Pourquoi proposer Stop Desk

Raison	Impact
Moins cher pour le client	Les frais bureau sont en général inférieurs au domicile
Frais transporteur plus bas pour vous	Beaucoup de transporteurs facturent moins en retrait bureau
Moins d'absences	Le client s'engage en se rendant au bureau
Livraison plus rapide	Direct au bureau, sans tentatives de livraison à domicile ratées

Type de livraison intégré

Le toggle Home / Desk au checkout est piloté par votre propre table de tarifs de livraison, pas par un transporteur. Sur /dashboard/shipping, chaque wilaya dispose d'un interrupteur de livraison au bureau et d'un prix bureau ; activez l'interrupteur et les clients de cette wilaya obtiennent l'option Desk. Cela fonctionne même sans aucun transporteur lié.

Un transporteur lié n'influe que sur deux choses : la capacité de l'addon Stop Desk Selector à lister des bureaux nommés, et la réussite de l'envoi vers ce transporteur.

La commande porte ensuite delivery_type = 'desk' plus une référence de bureau jusqu'à l'API du transporteur — exprimée différemment par chaque famille, voir le tableau ci-dessous.

Pour Yalidine, DZBuild résout le stopdesk_id au moment de l'envoi plutôt que de le stocker sur la commande : 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 est alors celle du bureau, si bien que les deux concordent toujours). Une expédition en bureau n'est jamais silencieusement rétrogradée en domicile — si toute la wilaya n'a aucun bureau Yalidine, l'envoi est refusé net.

Addon Stop Desk Selector

L'addon Stop Desk Selector (slug : stop-desk) apporte une UI de sélection nette sur le storefront :

Stop Desk Selector
Description : Let customers choose a specific desk/pickup point when selecting desk delivery.

Fonctionnalités :

Desk selection on checkout
Shows desk name, address & phone
Fallback to commune when no desks available
Only works with linked providers

L'addon est gratuit (aucun plan requis) mais il est incompatible avec le thème de boutique digital et ne peut pas y être activé — les boutiques de produits numériques n'ont aucune page de livraison.

Textes localisés de l'addon

Le nom et la description de l'addon en arabe et en français :

العربية

Nom: اختيار نقطة الاستلام
Description: اسمح للعملاء باختيار نقطة استلام محددة عند اختيار التوصيل للمكتب.
Features:
اختيار نقطة الاستلام عند الدفع
عرض اسم المكتب والعنوان والهاتف
الرجوع للبلدية عند عدم توفر مكاتب
يعمل فقط مع شركات التوصيل المربوطة

Français

Nom: Sélection du point de retrait
Description: Permettez aux clients de choisir un bureau/point de retrait spécifique lors du choix de la livraison au bureau.
Features:
Sélection du point de retrait au checkout
Affiche nom, adresse et téléphone du bureau
Retour à la commune si aucun bureau disponible
Fonctionne uniquement avec les transporteurs liés

Côté client

Le client remplit l'adresse et choisit la wilaya.
Il bascule sur Delivery: Desk.
Avec l'addon activé et le transporteur lié, DZBuild liste tous les bureaux de la wilaya — nom, adresse et téléphone pour chacun.
Il en choisit un. La commande stocke l'identifiant et le nom de bureau propres à DZBuild ; chaque transporteur reçoit ensuite son propre type de référence de bureau au moment de l'envoi.
Si la wilaya n'a aucun bureau nommé pour ce transporteur, l'addon bascule sur la commune pour que le client puisse terminer le checkout.

Le sélecteur de bureau ne se limite pas au checkout classique — il apparaît aussi sur les landing pages et dans le fast checkout de la page produit.

Comment une wilaya est jugée « avec bureaux »

L'addon construit sa carte de disponibilité sur deux niveaux :

Bureaux nommés — de vrais bureaux synchronisés depuis vos transporteurs liés, avec adresse et téléphone.
Repli au niveau commune — pour un couple transporteur/wilaya sans bureau spécifique, toute commune que le transporteur marque comme éligible au bureau.

Si aucun fournisseur lié n'a la moindre donnée de bureau, le sélecteur disparaît entièrement et le checkout retombe sur une livraison au bureau simple, tarifée depuis votre propre table. Juste après avoir lié un nouveau transporteur, c'est généralement une simple absence de données synchronisées — ouvrez la tuile du transporteur sur /dashboard/link-shipping et cliquez sur Actualiser.

Activer Stop Desk

Liez un transporteur dans /dashboard/link-shipping.
Définissez le tarif bureau et l'interrupteur bureau par wilaya sur /dashboard/shipping. Les tarifs bureau peuvent être synchronisés depuis chaque fournisseur lié, ou saisis à la main.
(Optionnel) Activez l'addon gratuit Stop Desk Selector depuis /dashboard/addons.
Testez sur la boutique — choisissez une wilaya, basculez Desk, et vérifiez que la liste des bureaux s'affiche.

Disponibilité des bureaux par transporteur {#per-courier-desk-availability}

Transporteur	Source de la liste des bureaux	Ce qui est envoyé avec le colis
Famille Yalidine	Synchronisée depuis l'API	Le plus large réseau de bureaux. `is_stopdesk` + un `stopdesk_id` résolu au moment de l'envoi.
Famille EcoTrack	Synchronisée depuis l'API par transporteur	`stop_desk = 1`, avec la commune du bureau comme commune. Aucun identifiant de bureau n'existe dans cette API.
ZR Express — nouvelle plateforme	Synchronisée depuis l'API (hubs points de retrait)	`deliveryType: "pickup-point"` + `hubId`.
ZR Express — Procolis classique	Aucune liste de bureaux publiée	`TypeLivraison = 1`. Le sélecteur propose une « agence ZR Express » générique au niveau commune et ZR choisit le bureau réel à l'expédition.
Maystro	Synchronisée depuis l'API (points de retrait par commune)	Uniquement `delivery_type: 2`. La liste des bureaux est synchronisée, mais le bureau choisi n'est pas transmis aujourd'hui.
Noest	Synchronisée depuis l'API	`stop_desk: 1` + `station_code` (par ex. `16A`, où 16 est la wilaya). Refusé avec « لا توجد نقطة استلام (Stop Desk) متاحة في ولاية … » si aucune station n'est trouvée.

Quand un envoi en bureau est refusé

Un refus « aucun bureau dans cette wilaya » vient souvent des données synchronisées de DZBuild elles-mêmes, avant même que le transporteur soit appelé. Trois issues :

Cliquez sur Actualiser sur la tuile du transporteur pour rafraîchir ses données de bureaux, puis renvoyez.
Changez de transporteur. La fenêtre d'envoi en livraison grise les transporteurs sans bureau pour ce client et ajoute « لا يوجد مكتب » à leur nom.
Repassez la commande en livraison à domicile.

Stop Desk vs Retrait en boutique

Faciles à confondre :

	Stop Desk	Retrait en boutique
Où le client récupère	Le bureau du transporteur	Votre propre adresse
Coût pour le client	Les frais bureau du transporteur	Gratuit
Envoyé à un transporteur ?	Oui, c'est une expédition normale	Non — les commandes en retrait sont marquées et jamais envoyées à un transporteur
Plan	Gratuit (addon optionnel)	Unlimited
Géré depuis	`/dashboard/shipping` + l'addon Stop Desk Selector	`/dashboard/pickup-points`

Le retrait en boutique ajoute une troisième option au toggle du checkout : domicile, bureau, ou retrait en boutique. Il est lui aussi indisponible sur le thème digital.

Astuces

Définissez toujours les tarifs home ET desk par wilaya. Le client compare — un tarif desk un peu plus bas pousse à l'adoption.
Si l'addon est actif mais qu'une wilaya n'a aucun bureau nommé pour votre transporteur, le repli au niveau commune évite de casser le checkout.
Avec Yalidine, encouragez les clients à choisir un bureau précis. DZBuild se rabattra sinon sur un autre bureau de la commune ou de la wilaya, mais le colis atterrit alors là où pointe ce repli.
Combinez Stop Desk avec COD : les clients sont souvent plus à l'aise pour payer cash au bureau du transporteur qu'à domicile face à un inconnu.

Livraison Stop Desk