Stop Desk delivery

Stop Desk lets the customer pick up the parcel at the courier's office instead of getting it delivered home. In DZBuild, Stop Desk is two things at once:

1. A built-in delivery type (delivery_type = 'desk') driven by your own per-wilaya shipping rates — it works with any linked courier, and even with none.
2. An addon (Stop Desk Selector) that adds a structured picker showing each desk's name, address and phone at checkout.

You can ship desk parcels without the addon — but the addon makes the experience much smoother for your customer.

Why offer Stop Desk

Reason	Impact
Cheaper for the customer	Desk fees are usually lower than home delivery
Lower courier fee for you	Many couriers charge less for desk pickups
Fewer no-shows	The customer commits when they walk into the office
Faster delivery	Goes straight to the desk without failed home-delivery attempts

Built-in delivery type

The Home / Desk toggle at checkout is driven by your own shipping-rate table, not by any courier. On /dashboard/shipping each wilaya has a desk-delivery switch and a desk price; turn the switch on and customers in that wilaya get the Desk option. This works with no courier linked at all.

A linked courier only affects two things: whether the Stop Desk Selector addon can list named desks, and whether the send to that courier succeeds.

The order then carries delivery_type = 'desk' plus a desk reference into the courier API — expressed differently by each courier family, see the table below.

For Yalidine, DZBuild resolves the stopdesk_id at send time rather than storing it on the order: the desk the customer picked, else any desk in their commune, else any desk in the wilaya (the commune sent is then the desk's own commune, so the two always agree). A desk shipment is never silently downgraded to home — if the whole wilaya has no Yalidine desk the send is refused outright.

Stop Desk Selector addon

The Stop Desk Selector addon (slug: stop-desk) gives your customers a clean picker UI on the storefront:

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

Features:

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

The addon is free (no plan requirement) but is incompatible with the digital storefront theme and cannot be activated there — digital-product stores have no shipping pages at all.

Localized addon copy

The addon's display name and description in Arabic and French:

العربية

• Name: اختيار نقطة الاستلام
• 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

How customers experience it

1. The customer fills the address form and picks the wilaya.
2. They toggle Delivery: Desk.
3. With the addon enabled and the courier linked, DZBuild lists every desk in that wilaya — name, address and phone for each.
4. The customer picks one. The order stores DZBuild's own desk id and desk name; each courier then receives its own kind of desk reference at send time.
5. If the wilaya has no named desks for that courier, the addon falls back to the commune so the customer can still finish checkout.

The desk picker isn't limited to the classic checkout — it also appears on landing pages and in the product-page fast checkout.

How a wilaya is judged to "have desks"

The addon builds its availability map in two levels:

1. Named desks — actual desks synced from your linked couriers, with address and phone.
2. Commune-level fallback — for a courier/wilaya pair with no specific desks, any commune the courier flags as desk-eligible.

If no linked provider has any desk data at all, the picker disappears entirely and checkout falls back to plain desk delivery priced from your own rate table. Right after linking a new courier, that's usually just missing sync data — open the courier's tile at /dashboard/link-shipping and click Actualiser.

Enabling Stop Desk

1. Link a courier at /dashboard/link-shipping.
2. Set the desk rate and the desk switch per wilaya on /dashboard/shipping. Desk rates can be synced from every linked provider, or set by hand.
3. (Optional) Enable the free Stop Desk Selector addon from /dashboard/addons.
4. Test on the storefront — pick a wilaya, toggle Desk, and verify the desk list shows up.

Per-courier desk availability

Courier	Desk list source	What is sent with the parcel
Yalidine family	Synced from API	Largest desk network. is_stopdesk + a stopdesk_id resolved at send time.
EcoTrack family	Synced from API per courier	stop_desk = 1, with the desk's commune as the commune. No desk id exists in the API.
ZR Express — new platform	Synced from API (pickup-point hubs)	deliveryType: "pickup-point" + hubId.
ZR Express — legacy Procolis	No desk list published	TypeLivraison = 1. The picker offers a generic commune-level "ZR Express agency" and ZR chooses the actual desk on dispatch.
Maystro	Synced from API (pickup points per commune)	Only delivery_type: 2. The desk list is synced, but the chosen desk is not forwarded today.
Noest	Synced from API	stop_desk: 1 + station_code (e.g. 16A, where 16 is the wilaya). Refused with « لا توجد نقطة استلام (Stop Desk) متاحة في ولاية … » if no station is found.

When a desk send is refused

A "no desk in this wilaya" refusal often comes from DZBuild's own synced knowledge, before the courier is ever called. Three ways out:

• Click Actualiser on the courier's tile to refresh its desk data, then re-send.
• Switch courier. The send-to-delivery modal greys out couriers with no desk for that customer and appends « لا يوجد مكتب » to their name.
• Change the order to home delivery.

Stop Desk vs Pickup from Store

These are easy to confuse:

	Stop Desk	Pickup from Store
Where the customer collects	The courier's office	Your own address
Cost to the customer	The courier's desk fee	Free
Sent to a courier?	Yes, it's a normal shipment	No — pickup orders are marked and never sent to a delivery company
Plan	Free (addon optional)	Unlimited
Managed at	/dashboard/shipping + the Stop Desk Selector addon	/dashboard/pickup-points

Pickup from Store adds a third option to the checkout toggle: home, desk, or pickup from store. It is also unavailable on the digital theme.

Tips

• Always set both home and desk rates per wilaya. Customers compare the two — pricing the desk a bit lower than home delivery nudges adoption.
• If the addon is on but a wilaya has no named desks for your courier, the commune-level fallback keeps checkout from breaking.
• For Yalidine, encourage customers to pick a specific desk. DZBuild will fall back to another desk in the commune or the wilaya if they don't, but the parcel then lands wherever that fallback points.
• Pair Stop Desk with COD: customers are usually more comfortable paying cash at a courier office than at home with a stranger.