RErecurrente
terminalBatchCloses

Cerrar lote de terminal

Changed on

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.

post/terminal_batch_closes

Request

Headers

Idempotency-Keystring

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 body

terminal_idstring required

ID de la terminal POS cuyo lote abierto quieres cerrar

Response

Lote cerrado exitosamente

idstring

ID del lote cerrado

status'open' | 'closed' | 'settled'

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_currency'GTQ' | 'USD'

Moneda principal del lote

totals_by_currencyobject

Totales del lote agrupados por moneda

opened_atstring date-time

Fecha y hora en que se abrió el lote

closed_atstring date-time nullable

Fecha y hora en que se cerró el lote

Changes

  • 33bad9197d59Revision changes
    • breaking

      added to the response property oneOf list for the response status

    • breaking

      added to the response property oneOf list for the response status

    • breaking

      the / response's property type changed from object to array for status

    • breaking

      the / response's property type changed from object to array for status

  • 3d76463f9fd8Revision changes
    • warning

      deleted the header request parameter X-SECRET-KEY

    • info

      the endpoint scheme security secretKey was added to the API