Orders

Endpoints

GET    /v1/orders
GET    /v1/orders/:id
POST   /v1/orders
PATCH  /v1/orders/:id/status

Estados

Valores válidos de status (mismos que en la base de datos):

pending
canceled
ready
closed

Transiciones permitidas:

pending → ready | canceled
ready   → closed | canceled
closed  → (final)
canceled → (final)

Listar órdenes

GET /v1/orders?status=pending&limit=50&offset=0

Response:

{
  "data": [
    {
      "id": "ord_123",
      "number": 24445,
      "status": "pending",
      "total": 21100,
      "created_at": "2026-07-06T11:08:26.085497-03:00",
      "payment": {
        "id": "pay_123",
        "status": "pending"
      }
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total": 1
  }
}

Crear orden

POST /v1/orders
Idempotency-Key: partner-order-1001

Request:

{
  "external_id": "partner-order-1001",
  "is_take_away": true,
  "identifier": "Mesa 12",
  "items": [
    {
      "product_id": "prod_9f03",
      "quantity": 2,
      "comment": "Sin cebolla",
      "subselections": [
        {
          "item_id": "item_1",
          "quantity": 1
        }
      ]
    }
  ],
  "payment_method_id": "pm_123"
}