Orders

Endpoints

GET    /v2/orders
GET    /v2/orders/export
GET    /v2/orders/:id
GET    /v2/orders/by-external-id/:external_id
POST   /v2/orders
PATCH  /v2/orders/:id/status
POST   /v2/orders/:id/cancel

Crear orden externa

POST /v2/orders
Idempotency-Key: erp-order-1001

Request:

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

Exportar órdenes

GET /v2/orders/export?from=2026-07-01&to=2026-07-07

Permiso:

orders:export

Response:

{
  "data": {
    "exported_at": "2026-07-07T12:00:00.000Z",
    "from": "2026-07-01",
    "to": "2026-07-07",
    "total": 2,
    "orders": []
  }
}