Skip to main content

Shipping

DZBuild handles the shape of Algerian shipping out of the box: 58 wilayas, home delivery vs desk pickup, courier-specific desks, weight surcharges, and a free-shipping toggle. This page walks through the shipping settings, the courier integrations, and the Custom Product Shipping addon for per-product overrides.

Video​

Setting your rates​

Open Dashboard → Shipping at /dashboard/shipping. You'll see:

  • A free-shipping toggle (whole store).
  • A free-shipping threshold (orders above X DZD ship free).
  • A per-wilaya table with home and desk prices.
  • A courier-link section.

Per-wilaya pricing​

Each of the 58 wilayas has a row with two columns: home delivery and stop desk. Type the price in DZD; click out of the field to save (saves are auto-persisted).

Most merchants:

  • Charge a uniform price across most wilayas.
  • Bump up southern wilayas (Tamanrasset, Adrar, Illizi, Tindouf) where couriers add a deep-south surcharge.
  • Charge ~200 DZD less for desk pickup than for home delivery.

Free shipping above a threshold​

Tick Free shipping above X and type a threshold (e.g. 5000). Orders above that merchandise total ship free, regardless of wilaya. This is one of the highest-leverage cart-size boosters — it nudges customers to add a second item.

Free shipping (whole store)​

Tick the all-on toggle to make every order ship free. Use sparingly — usually for a launch campaign or a 24-hour promo.

Home delivery vs Stop Desk​

Algerian couriers offer two delivery types:

  • Home delivery — courier brings the parcel to the customer's door. Higher price.
  • Stop desk — customer picks up from a courier's office. Cheaper, faster, fewer no-shows.

You can offer both and let the customer choose at checkout. To enable a structured desk picker (with desk name, address, phone), install Stop Desk Selector.

Linking a courier​

Open the courier section on /dashboard/shipping (or the linked-couriers panel). DZBuild integrates directly with these services so you can send orders from one screen and get tracking back automatically:

CourierSlugNotes
YalidineyalidineMost-used courier in Algeria.
EcoTrackecotrackPowers many sub-tenant couriers (custom-mapped).
ZR Express (new API)zr-express-newLatest API; recommended over the legacy ZR Express.
Maystro DeliverymaystroNational coverage.
Noest ExpressnoestNational coverage.
YalitecyalitecProvider integration available.
ProcolisprocolisProvider integration available.

To link a courier:

  1. Sign up directly with the courier and get your API credentials (each courier issues these from their own dashboard).
  2. Click the courier's tile on /dashboard/shipping (or open the linked-couriers panel).
  3. Paste your API ID and token (field names depend on the courier — Yalidine uses ID + Token, others use a single Bearer key).
  4. Save. DZBuild runs an API status check; you should see a green badge if the credentials are valid.

After linking, every order detail page gets a Send to courier button — see Orders.

A separate per-courier page in the docs covers each integration's specifics. Start with the Couriers overview.

Default courier​

If you have several couriers linked, mark one as default in the linked-couriers panel. New orders preselect this courier in the dropdown — you can still pick another per-order.

Per-product shipping (Custom Product Shipping addon)​

When you have a heavy item (a bicycle, a fridge) that doesn't fit your standard rate, the Custom Product Shipping addon lets you set per-product shipping rules:

  • Flat rate per product (overrides the store rate when this product is in the cart).
  • Per-wilaya pricing for the product.
  • Free shipping on a specific product.
  • Highest-price-wins for mixed carts (so the heavier item dictates).

Activate from /dashboard/addons (requires the Pro plan). See the Custom Product Shipping doc for the full setup.

Delivery labels​

Every shipped order has a printable PDF delivery label (the courier label). It shows: customer name, phone, address, item list, total + COD amount, courier tracking number, your store logo. For per-product label customisation (rename items, hide variants, add custom text), install Custom Delivery Label.

What customers see at checkout​

  1. Customer enters wilaya + city in the checkout form.
  2. Storefront shows: Shipping to {wilaya}: {home_price} DZD or a desk picker.
  3. Total updates live as they pick home / desk.
  4. On submit, the order carries shipping_method, shipping_price, and shipping_address for the courier hand-off.

Frequently asked​

Q: A customer says delivery to their wilaya is wrong — why? A: Open /dashboard/shipping, find that wilaya's row, check the home / desk numbers. The number there is what the storefront shows.

Q: Can I have different rates for different couriers? A: Yes — pick a default courier per-order, and that courier's rate applies. For tighter per-product control, use Custom Product Shipping.

Q: Free shipping above X DZD — does it apply to home + desk? A: Yes, both. The total against the threshold is the merchandise total (excluding shipping itself).

Tips​

  • Update southern wilaya rates regularly — couriers raise these without much notice.
  • Set the free-shipping threshold ~30% above your average order. It nudges 1-item buyers to add a second.
  • Keep desk prices ~200 DZD below home prices. Customers will pick desk when the gap is visible.
  • Test the API status check after linking a courier — green is your green light to send orders.
  • Don't link a courier you haven't signed up with. API credentials must come from the courier's own dashboard, not a guess.
  • Use Custom Product Shipping for heavy items — store rates always undercharge for fridges and TVs.

What's next​