English en العربية ar Français fr

Creating Orders

Create an order, add recipient and items, and follow it all the way to delivery.

3 min read

Creating Orders

What this is & why it matters

An order is a sale: it ties your confirmed stock to a customer and a delivery address, and kicks off the fulfillment chain that ends with a driver at the customer’s door. Creating it correctly is what triggers stock deduction and locks in your commission and tax.

Step by step: create an order

  1. Go to Orders (/admin/orders) and click New Order.
  2. Add the Recipient name (required) and Recipient phone (required); optionally a phone country and Recipient email.
  3. Add Items (at least one). For each item choose the Product, optionally its Color / Size / Shape, the Quantity (1 to 99,999), and the Selling price.
  4. Set the delivery target: choose the Country (required) and Location (required), and optionally a free-text Delivery address (up to 500 characters).
  5. (Optional) Add order Notes (up to 1000 characters) and a Currency.
  6. Submit.

Field reference

Field Meaning Required? Rules
Recipient name Who receives the order Required Up to 255 chars
Recipient phone Contact for delivery Required Up to 50 chars
Recipient email Optional contact Optional Valid email
Items Lines being sold Required At least 1 line
Item product Which product Required One of your products
Item color/size/shape The variant Optional Existing option
Item quantity Units of that line Required 1 to 99,999
Item selling price Price per unit charged Required 0 or more
Country / Location Delivery destination Required Existing country & location
Delivery address Free-text address Optional Up to 500 chars
Notes Order notes Optional Up to 1000 chars

What happens next

When the order is created the system checks stock and deducts inventory using FIFO (first-in, first-out), and snapshots the commission and tax at that moment so later price/plan changes don’t alter this order.

Order lifecycle

  1. draft
  2. pending_review
  3. approved / rejected
  4. assigned_to_delivery
  5. assigned_to_driver
  6. out_for_delivery
  7. delivered / failed_delivery

Other states:

  • cancelled — allowed up until the order is assigned to a driver (i.e. through the assigned to delivery stage), not after it is with a driver or out for delivery.
  • returned — when all items have been returned (see Returns).

Every order has a shareable public tracking link / QR code so the customer can follow it.

Tips & common mistakes

  • You can only order confirmed stock. If an item shows insufficient stock, check its inventory request reached confirmed_by_storage.
  • Selling price is per unit, not per line — quantity multiplies it.
  • Cancel only through the “assigned to delivery” stage. You can cancel while the order is draft, pending_review, approved, or assigned_to_delivery — but not once it is assigned to a driver or out for delivery. After that, use a return instead.

Where to look

Screens: Orders at /admin/orders; public tracking at /track/{token}.