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