Managing orders can feel daunting at first: the workflow looks complex, statuses follow one another, and the right action often depends on context — sales channel, supply mode, and whether you manage orders at the line level.
To make it simple, we’ve published a new step-by-step guide that maps out the complete order lifecycle, from the moment an order reaches you all the way to financial settlement.
What’s inside
The guide is organized by concrete use case, each with a clear goal, key notes and gotchas, request/payload examples, and direct links to the relevant API reference:
- Retrieve and track your orders — list, filter and poll efficiently (no webhooks).
- Validate / accept an order — where seller validation is required, and how.
- Shipping address & delivery modes — when the address is available, and the delivery grid.
- Ship an order — multiline, multi-parcel and large-parcel cases.
- Make a commercial gesture — compensate a customer without cancelling the order.
- Handle cancellations — full, partial, and customer-initiated requests.
- Manage discussions — open threads, attach files, reply, prioritize.
- Generate and submit an invoice — single upload or bulk from your ERP.
- Retrieve your financial data — reconcile sales, commissions, refunds and payment states.
Who it’s for
Developers, integrators and project managers connecting to the Octopia Seller API — whether you’re building your first integration or refining an existing one.
👉 Read the guide: https://developer.octopia-io.net/api-reference/orders-management/managing-orders-end-to-end/