Orders

Orders are the heart of your business. DZBuild tracks every order as a state machine with full audit history.

🎬 Video

The state machine

pending → confirmed → processing → shipped → delivered
                ↓                       ↓
            cancelled               cancelled / returned

Statuses

Status	Description
pending	Customer placed the order; you haven't reviewed it yet
confirmed	You've called/verified — stock is decremented
processing	Being packed / prepared
shipped	Handed to the courier; tracking number issued
delivered	Customer received it
cancelled	Cancelled before delivery — stock restored if it had been decremented
returned	Returned after delivery — stock restored, refund logged

Stock effects

• Stock is decremented when the order moves to confirmed, not at pending. This protects you from fake/spam orders.
• Cancelling from confirmed/processing/shipped automatically restores stock.
• Returning from delivered also restores stock.

The order detail page

Click any order to see:

• Items — what was ordered, with variants, prices, totals.
• Customer — name, phone, address, all previous orders from this customer.
• Shipping — wilaya/city, courier, tracking number, delivery method (home / desk).
• Payment — method, amount, transaction reference.
• Timeline — every status change with timestamp + actor.
• Notes — internal notes (not visible to customer).

The call-confirm workflow

Most Algerian merchants run a call-confirm flow:

1. Order arrives as pending.
2. You call the customer to confirm the order is real and they want it.
3. Mark as confirmed if real → stock decrements, ready to ship.
4. Mark as cancelled if fake/customer cancelled → no stock used.

For a dedicated CRM-style page with sub-statuses (no answer, busy, postponed, fake, duplicate, customer cancelled, …), call-attempt tracking, and per-order timeline, install the Advanced Orders add-on.

Filters

Filter	Use
Status	Find all pending orders to call
Date range	Daily/weekly reports
Wilaya	Plan courier handovers by region
Courier	Reconcile with courier reports
Payment	COD vs CIB vs EDAHABIA
Sub-status (with Advanced Orders)	"no answer" callback queue

Bulk actions

Select multiple orders to:

• Mark as confirmed/cancelled in batch
• Generate delivery labels (PDF)
• Export to CSV
• Hand over to a courier (calls the courier API for each)

Notifications

When a new order arrives:

• Dashboard bell with sound (if you've enabled it)
• Email to store owner
• PWA push if installed
• Webhook if registered — see Webhooks

Frequently asked

Q: An order is stuck in shipped — the courier delivered it but the status didn't change. A: Some couriers don't push delivery confirmations. Mark it manually as delivered from the order detail page.

Q: A customer wants to add an item to a placed order. A: Cancel the original (stock restores) and place a new one. Or edit the existing order's items if your plan supports it (Pro only).

Q: How do I bulk delete fake orders? A: Filter by status pending and date < today. Bulk-select → Cancel. Stock isn't touched since they were never confirmed.