Orders
Overview
The Orders feature manages the complete order lifecycle — from the moment a customer places an order through fulfillment, shipping, and delivery. It also handles cancellations, returns, refunds, and draft orders. Vendors can fulfill orders in full or split them into partial shipments, track packages, generate PDF invoices, and recover revenue from abandoned checkouts.
How It Works
Order Statuses
| Status | Description |
|---|---|
| Unfulfilled | Order placed, items not yet shipped |
| Partially Fulfilled | Some items shipped, others pending |
| Fulfilled | All items shipped |
| Cancelled | Order cancelled by vendor |
| Returned | Customer initiated a return |
| Archived | Order archived for record-keeping |
Draft Orders
Draft orders let vendors create orders manually on behalf of customers — useful for phone orders, custom quotes, or B2B transactions. A draft order can be converted to a real order once payment is collected.
Abandoned Checkout Recovery
When a customer adds items to their cart but does not complete checkout, Siyahfy tracks this as an abandoned checkout. Vendors can configure automated email or WhatsApp recovery messages to bring customers back.
Key API Endpoints
Order Management
Fulfillment
Cancellation, Returns & Refunds
Payments & Invoices
Draft Orders
Abandoned Checkouts
Database Tables
| Table | Purpose |
|---|---|
orders | Main order data — items, customer, totals, status, fulfillment, cancel/return details |
draft_orders | Draft orders before conversion to real orders |
abandon_checkouts | Abandoned checkout sessions with cart data and customer info |
product_inventory | Updated during fulfillment, cancellation, and returns for stock changes |
inventory_items | New inventory system updated during order events |