Order extras reference
Enums and constants you will encounter when reading orders, returns and integrations.
বাংলায়: Order টাইপ, সোর্স, রিটার্ন স্ট্যাটাস এবং পারমিশন সম্পর্কে বিস্তারিত তথ্য এখানে আছে। প্রতিটি order একটি টাইপ এবং একটি সোর্স আছে — টাইপ হলো original, exchange, বা partial_return, এবং সোর্স হলো Website, Call, Offline, ইত্যাদি। রিটার্ন cases এর তিনটি স্ট্যাটাস আছে: in_transit, received, cancelled।
Where to find it: Order details, order activity, return modals, and reports.
Order type
Every order has a type that determines its relationship to other orders.
| Type | Meaning |
|---|---|
| original | A standalone order created manually, from your storefront, or from a connected channel (Shopify, website). |
| exchange | An order created to replace items in an original order. It is linked to a parent order. Its display ID is #parent-ID-E1, #parent-ID-E2, and so on. |
| partial_return | An order created to track a partial return. The customer is returning only some items from the original order. Its display ID follows the same scheme as exchanges (#parent-ID-R1). |
An exchange or partial return always has a parent order. Both types start in Confirmed status.
Order source
Every order records where it came from.
| Source | Meaning |
|---|---|
| Website | Created from your storefront (omnikyo domain, custom domain, or landing page). |
| Messenger | The order was created from a customer message that you turned into an order. |
| The order came via Instagram messaging or an Instagram link. | |
| The order came via WhatsApp messaging. | |
| Call | You created the order after a phone call with the customer. |
| Offline | You created the order manually in Omnikyo (the default for hand-made orders). |
Orders from Shopify appear as Website in Omnikyo. Orders from your connected Laravel or PHP website also appear as Website.
Return case status
A return case (created when a customer returns some or all items) moves through these statuses.
| Status | Meaning | Next step |
|---|---|---|
| in_transit | You recorded the return and the items are on their way back. | Wait for them to arrive, or sync with the courier. |
| received | The items have arrived; you verified or restocked them. The return case is closed and cannot change. | No further action. |
| cancelled | The return was cancelled (the customer kept the items, or the parcel was lost by the courier). The case is closed. | No further action. |
A return case starts as in_transit when you create it. Only the received and cancelled states are final.
Partial return order status
Orders with type partial_return follow the standard order status lifecycle (New → Confirmed → Preparing → Dispatched → Delivered, etc.) but they typically stay in Confirmed status only. They are not usually dispatched — they exist to track the returned items.
When you mark the return as received, the parent order moves to Return Pending if it has not already. The partial return order is archived.
Permissions
Order creation, editing and return processing are controlled by permissions.
| Permission | What it allows |
|---|---|
| orders.view | See all orders and their details. |
| orders.create | Create a new order manually, and create exchanges or partial returns. |
| orders.edit | Edit an order after creation (customer, items, payment). Requires orders.create too. |
| orders.delete | Delete an order. (Cannot undo.) |
| orders.status.update | Change an order's status. |
| orders.returns_view | See the Returns tab and view return cases. |
| orders.returns_process | Create return cases, process returns, and receive returned items. |
| orders.dispatch_view | See courier details (Pathao/Steadfast status, tracking codes). |
| orders.dispatch_edit | Send orders to couriers, sync status, add/edit tracking codes. |
A user with none of these permissions sees no orders. The owner (business creator) has all permissions by default. Other users' permissions are managed via team roles in Settings.
Other ways people ask this
- order type kia
- where order came from
- return case status meaning
- partial return kia
- exchange order kia
- order source types
- অর্ডার কোথা থেকে এসেছে
- রিটার্ন কেস স্ট্যাটাস
- পারমিশন কি লাগবে
- order import fields
- order type reference
Status transition rules
Orders move through statuses in a defined sequence. Not every transition is allowed.
| From | To |
|---|---|
| New | Confirmed, Hold, Cancelled |
| Confirmed | New, Preparing, Hold, Cancelled |
| Hold | New, Confirmed, Cancelled |
| Preparing | Confirmed, Hold, Cancelled, Dispatched |
| Dispatched | Delivered, Return Pending |
| Delivered | Return Pending |
| Return Pending | Returned |
| Cancelled | New |
| Returned | (no further transitions) |
Exchange and partial return orders start in Confirmed and may move through the same sequence. However, in practice, they often stay Confirmed until the task (exchange processing or return receipt) is complete.
Related pages
- Where orders come from — what each order source means
- Order statuses and the lifecycle — the full status flow and what each status does
- Create an exchange order — how exchange orders are made
- Record a partial return — how partial returns work
Related guides
Checked against the product on 2026-10-02.