Skip to main content

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') that works with any linked courier.
  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​

ReasonImpact
Cheaper for the customerDesk fees are usually lower than home delivery
Lower courier fee for youMany couriers charge less for desk pickups
Fewer no-showsThe customer commits when they walk into the office
Faster deliveryGoes straight to the desk without failed home-delivery attempts

Built-in delivery type​

Out of the box, DZBuild supports delivery_type = 'desk' on every checkout when your linked courier offers stop desks. The customer sees a Home / Desk toggle, and the order carries delivery_type = 'desk' plus a desk reference (text or ID) into the courier API.

For Yalidine, a valid stopdesk_id is required when shipping a desk parcel — DZBuild raises an error before sending so a desk shipment never gets silently downgraded to home.

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 (from the addon manifest):

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

Localized addon copy​

The addon's display name and description in Arabic and French are taken straight from the addon manifest:

العربية​

  • 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 carries the desk identifier (stopdesk_id for couriers that need it).
  5. If the wilaya has no desks for that courier, the addon falls back to the commune so the customer can still finish checkout.

Enabling Stop Desk​

  1. Link a courier in /dashboard/shipping (Yalidine, EcoTrack, ZR Express, Maystro, Noest all support desks).
  2. Make sure the desk-rate column is set per wilaya — DZBuild can sync it from the provider for Yalidine / EcoTrack / ZR Express, or you set it manually.
  3. (Optional) Enable the 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​

CourierDesk list sourceNotes
YalidineSynced from APILargest desk network. stopdesk_id is required for desk shipments.
EcoTrack familySynced from API per courierEach courier has its own desk list.
ZR Express (legacy + new)Synced from APIBoth APIs expose the desk list.
MaystroSynced from APIDesks are passed by ID alongside is_stopdesk.
NoestSynced from APICommunicated by commune ID for the desk's wilaya.

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 desks for your courier, the fallback (commune-based desk) keeps checkout from breaking.
  • For Yalidine, never let the customer submit a desk order without picking a desk — the addon enforces this, and the courier API enforces it too.
  • Pair Stop Desk with COD: customers are usually more comfortable paying cash at a courier office than at home with a stranger.