GET https://api.fire.rest/api/v1/fire/external/stores/550e8400-e29b-41d4-a716-446655440000/orders?size=20
x-api-key: <tu_api_key>
{
"orders": [
{
"id": "7e2b8c10-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
"orderCode": "OC-1024",
"storeId": "550e8400-e29b-41d4-a716-446655440000",
"status": "COMPLETED",
"paymentStatus": "SUCCEEDED",
"channel": "APP",
"businessDayDate": "2026-07-01",
"createdAt": "2026-07-01T14:03:00Z",
"updatedAt": "2026-07-01T14:20:00Z"
}
],
"pagination": { "page": 1, "size": 20, "total": 1, "totalPages": 1 }
}
API
Listar órdenes de tienda
Lista las órdenes de una tienda específica. Igual que Listar órdenes, acotado a una tienda por path.
GET
/
api
/
v1
/
fire
/
external
/
stores
/
{storeId}
/
orders
GET https://api.fire.rest/api/v1/fire/external/stores/550e8400-e29b-41d4-a716-446655440000/orders?size=20
x-api-key: <tu_api_key>
{
"orders": [
{
"id": "7e2b8c10-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
"orderCode": "OC-1024",
"storeId": "550e8400-e29b-41d4-a716-446655440000",
"status": "COMPLETED",
"paymentStatus": "SUCCEEDED",
"channel": "APP",
"businessDayDate": "2026-07-01",
"createdAt": "2026-07-01T14:03:00Z",
"updatedAt": "2026-07-01T14:20:00Z"
}
],
"pagination": { "page": 1, "size": 20, "total": 1, "totalPages": 1 }
}
La variante anidada de Listar órdenes: la tienda se identifica por
el path param
{storeId} en lugar de un filtro de query. El resto de los query params — paginación,
filtros y projection de campos — se comportan igual.
El guard de tenant garantiza que un storeId de otro account/vendor devuelva una lista vacía —
nunca órdenes de otro tenant.
Autenticación
string
requerido
Tu API key de Fire con scope
orders:read. La key debe ser vendor-scoped — las keys sin
vendorId se rechazan con 403.Path params
string
requerido
UUID de la tienda (
stores.id).Query params
El account y el vendor se derivan de tu API key (vendor-scoped) — no se envían por query.
string
Projection — ver Projection de campos.
string
OPEN, COMPLETED, FORCE_CLOSED, CANCELLED.string
PENDING, SUCCEEDED, FAILED.string
Día de negocio exacto,
YYYY-MM-DD.string
Inicio del rango,
YYYY-MM-DD.string
Fin del rango,
YYYY-MM-DD.string
predeterminado:"business_day"
business_day o created_at.string
predeterminado:"+00:00"
Offset de timezone para el modo
created_at.string
Código de canal.
string
Código de servicio de fulfillment.
string
Código de método de pago.
string
Match parcial sobre order code.
string
UUID exacto, o external order id / order code parcial.
integer
predeterminado:"1"
Número de página (base 1).
integer
predeterminado:"20"
Tamaño de página (1–100).
Petición
GET https://api.fire.rest/api/v1/fire/external/stores/550e8400-e29b-41d4-a716-446655440000/orders?size=20
x-api-key: <tu_api_key>
Respuesta
Mismo shape que Listar órdenes:{ orders, pagination }.
Para ver cómo viene el cobro de cada orden, proyectá settlement — ver
Progreso del cobro.
{
"orders": [
{
"id": "7e2b8c10-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
"orderCode": "OC-1024",
"storeId": "550e8400-e29b-41d4-a716-446655440000",
"status": "COMPLETED",
"paymentStatus": "SUCCEEDED",
"channel": "APP",
"businessDayDate": "2026-07-01",
"createdAt": "2026-07-01T14:03:00Z",
"updatedAt": "2026-07-01T14:20:00Z"
}
],
"pagination": { "page": 1, "size": 20, "total": 1, "totalPages": 1 }
}
Relacionado
Listar órdenes
Lista todas las órdenes de tu account y vendor.
Obtener tienda
Lee la tienda a la que pertenece este listado.