Orders API
Complete API reference for Orders endpoints.
Orders API
Introduction to the Fenicia Orders API — response envelope, authentication, pagination, common filters, and a map of the section
List Orders
Retrieve a paginated list of orders with filters by status, channel, dates, and more, plus the count endpoints by status group and individual status.
Search Orders
Search orders with free text combined with the same date, status, channel, and customer filters offered by the paginated order list.
Get an Order
Retrieve the full detail of an order, its valid state transitions, and its financial profit breakdown.
Create an Order
Create orders manually by sending the order envelope with its 10 required root fields, or import them in bulk with POST /orders/import
Update an Order
Update fields on an existing order, change customer data separately, or add a comment to its history
State Transitions
The complete state machine of an order (23 states) and the endpoints to accept, reject, cancel, and transition orders
Fulfillment and Shipping
Prepare orders for shipping, process fulfillment, and manage labels, tracking, and carriers both for a single order and in batch
Delivery and Shipping
Mark orders as delivered, confirm delivery, upload evidence and labels, attach shipping information, and manage a shipment's cost
Returns and Refunds
Full return lifecycle on an order — creation, approval, shipping, receiving, and refund, plus listings and counts
Attachments
Upload, list, download, and delete order attachments — invoices, CFDI, shipping labels, delivery evidence, and more
Abandoned Carts
List, search, count, and inspect abandoned carts, trigger recovery actions, and close them when they're no longer recoverable
Activity, Export, and Sync
Audit an order's history, export orders and overdue settlements to CSV, and trigger sync with connected channels
Error Catalog
Complete, verified catalog of Fenicia Orders API error codes, grouped by namespace, with HTTP status and when each one occurs