Skip to main content
POST
API de partner. Este endpoint está pensado para integradores de plataforma. Los clientes estándar de Fire no tienen acceso directo — contactá a tu account manager si necesitás esta integración.
Registra el cierre de un turno y hace que Fire lo compare contra lo que dice que debería haber en el cajón. La diferencia (SHORTAGE, OVERAGE o MATCH) la calcula Fire.
v1 sigue viva, sin fecha de baja. Si tu integración ya la consume, no tenés que hacer nada. v2 se migra cuando quieras y sin deploy coordinado.

​
Qué cambia

Una sola cosa, y no es un campo nuevo: cambia quién hace la cuenta. discrepancy es la misma resta en las dos versiones: declaredCash − systemCash. Bajo v2 el fondo está a los dos lados, así que la diferencia significa exactamente lo mismo y una fila v1 y una v2 se comparan sin convertir nada.
El paso que no se detecta solo. Si apuntás a v2 y seguís restándole el fondo a declaredCash, el request entra sin ningún error y todos los cierres salen con un faltante del tamaño del fondo — todos los días, con el cajero apareciendo como deudor de plata que nunca sacó. Fire no puede distinguir un conteo neto de uno bruto: sólo vos sabés cuál mandaste.Antes de migrar, verificá contra un día de prueba que la discrepancy que devuelve Fire es la misma que calculás vos.

​
Autenticación y tenencia

​
string
requerido
Tu API key de Fire, con scope cash-management:write.Tiene que ser vendor-scoped: traer account y vendor. Si le falta alguno, la respuesta es 403.
Acá la key es el tenant. El storeId se busca dentro del scope de tu key; si la tienda es de otra cuenta o de otro vendor, la respuesta es 404 sin revelar si existe.Eso es una diferencia real con v1, que acepta cualquier storeId válido. Si hoy posteás a v1 con una key compartida entre cuentas, esa key no entra a v2 y hay que pedir una propia.

​
Un cierre por turno

Dos reglas, y conviene entender las dos antes de integrar:
​
string
requerido
El identificador del turno en tu POS. Es la clave de idempotencia: reenviar el mismo cierre devuelve 409 en vez de duplicarlo.Único por tienda para siempre, no por día. No lleva la fecha adentro, así que un contador que se reinicia cada día (T01-1, T01-2, …) choca con el cierre de ayer. Si tu id de turno se reinicia, prefijalo con el día operativo: T01-20260901-1.Un turno que maneja dos monedas manda dos POST con el mismo sessionExternalId y distinta currency: la clave incluye la moneda, así que las dos entran.
Y la otra, que es la que sorprende: un turno se cierra una sola vez, sin importar con qué id. Si mandás un segundo cierre para el mismo día, tienda, operador, moneda y shiftStart con un sessionExternalId distinto, la respuesta es 409. Generar un id nuevo en cada envío no es un reintento: es un cierre nuevo, y Fire lo trata como tal.

​
Body de la petición

​
string
requerido
UUID de la tienda. Tiene que pertenecer al scope de tu API key.
​
string
requerido
Código ISO 4217 de 3 caracteres (USD, BRL, ARS, CLP, COP, VES).
​
number
requerido
La plata contada en el cajón, en bruto — con el fondo adentro. Decimal con hasta 2 decimales, no negativo.Este es el campo que cambia de significado respecto de v1. Leé la advertencia de arriba.
​
number
requerido
El fondo con el que se abrió la caja para ese turno, en esa moneda. Decimal con hasta 2 decimales, no negativo. Mandalo siempre, aunque sea 0.
​
string
requerido
Inicio del turno, ISO 8601 con offset (2026-09-01T13:00:00-05:00). Fire usa la ventana para atribuir las ventas del turno.
​
string
requerido
Fin del turno, mismo formato. Tiene que ser posterior a shiftStart.
​
string
requerido
Causa categórica de la diferencia. Una de: WRONG_CHANGE_GIVEN, COUNTING_ERROR, INCOMPLETE_CUSTOMER_PAYMENT, MINOR_UNIDENTIFIED_DIFFERENCE, THEFT_SUSPECTED, UNRECORDED_PAYMENT, OTHER.Requerida incluso cuando el cierre cuadra. Cuando hay sobrante, el único valor aceptado es OTHER — cualquier otro vuelve 400: un sobrante no se explica por un error de conteo del cliente.
​
array
La plata que salió del cajón durante el turno. Hasta 100 entradas. Se restan de lo esperado; el detalle queda guardado para auditoría.
​
string
Día operativo en YYYY-MM-DD. Por defecto, el día operativo actual de la tienda. Usalo para registrar un cierre de un día pasado — Fire marca el resultado con details.post_close: true si el día ya está cerrado.
​
string
El cajero del turno. Opcional: omitilo cuando el cierre es de toda la tienda.Con cajero, Fire cuenta sólo las ventas de esa persona — y rechaza a un operador que no tuvo ninguna transacción y aun así declara plata de ventas.
​
string
Nombre del cajero, para mostrar en las pantallas de cuadre.
​
string
La caja física del turno. Permite agrupar los cierres de una misma caja en el reporte.
​
string
Texto libre, hasta 2000 caracteres.
​
string
UUID de un token de autorización, cuando el cierre necesitó firma de un supervisor.

​
Campos de la respuesta

Los mismos que v1, más estos:
​
number
2 para las filas que entraron por este endpoint. Las de v1 traen 1. La UI de Fire ramifica por este campo para mostrar las dos de forma comparable.
​
number
El fondo, como lo mandaste.
​
number
La suma de withdrawals[]. El detalle de cada uno vive en details.withdrawals.
​
string
Eco del request. null en las filas de v1.
​
string | null
Eco del request.
​
number
Lo que Fire calculó que debería haber en el cajón: openingBalance + ventas en efectivo − withdrawalsTotal.
​
number
declaredCash − systemCash. Negativo es faltante, positivo es sobrante.

​
Errores

​
Migrar desde v1

  1. Cambiar la URL: /api/v1/adapters/xmart/cash-management/reconciliations → /api/v2/external/cash-management/reconciliations. Si tu key no es vendor-scoped, pedí una nueva.
  2. Dejar de restarle el fondo a declaredCash. Enviar la plata contada tal cual.
  3. Enviar siempre openingBalance —aunque sea 0— y el par shiftStart / shiftEnd.
  4. Enviar siempre sessionExternalId, único por tienda para siempre.
  5. Si hacés retiros durante el turno, declararlos en withdrawals[].
  6. Verificar contra un día de prueba que la discrepancy que devuelve Fire es la misma que calculás vos.
No hay GET en v2. El listado de v1 ya devuelve todas las filas del día, sin importar con qué versión entraron — es donde vas a ver un cierre v1 y uno v2 uno al lado del otro.