Referencia APITerminal Batch Closes

Cerrar lote de terminal

Cierra el lote abierto actual de una terminal POS. Recurrente marca el lote como `closed`, calcula sus totales y deja la terminal lista para abrir un nuevo lote automáticamente con el próximo pago. Este endpoint es útil para integraciones que controlan el POS desde un sistema externo y necesitan cerrar lote sin operar la pantalla de la terminal. Envía `Idempotency-Key` para reintentos seguros: si tu sistema pierde la respuesta después de cerrar el lote, repetir el mismo request con la misma clave devuelve la respuesta original en vez de intentar cerrar otro lote.

Authentication

X-SECRET-KEYstring
Tu clave secreta de API

Headers

Idempotency-KeystringOptional

Clave de idempotencia para reintentos seguros de operaciones críticas, especialmente las que mueven dinero o cambian estado operativo. Reintentar con la misma clave y el mismo cuerpo devuelve la respuesta original (header Idempotency-Replayed: true); reusarla con parámetros distintos devuelve 409.

Request

This endpoint expects an object.
terminal_idstringRequired
ID de la terminal POS cuyo lote abierto quieres cerrar

Response

Lote cerrado exitosamente
idstring
ID del lote cerrado
statusenum
Estado del lote
terminal_idstring
ID de la terminal POS
transaction_countinteger
Cantidad de transacciones exitosas incluidas en el lote
total_in_centsinteger
Total agregado del lote en centavos
total_currencyenum
Moneda principal del lote
totals_by_currencymap from strings to integers
Totales del lote agrupados por moneda
opened_atdatetime

Fecha y hora en que se abrió el lote

closed_atdatetime or null

Fecha y hora en que se cerró el lote

Errors

404
Not Found Error
422
Unprocessable Entity Error