---
title: "Cerrar lote de terminal"
method: POST
path: "/terminal_batch_closes"
tags: ["terminalBatchCloses"]
---

# Cerrar lote de terminal

`POST /terminal_batch_closes`

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.

## Headers

- `X-SECRET-KEY` string, required
- `Idempotency-Key` string

## Request body

- object
  - `terminal_id` string, required — ID de la terminal POS cuyo lote abierto quieres cerrar

## Response `200`

Lote cerrado exitosamente

- TerminalBatch
  - `id` string — ID del lote cerrado
  - `status` 'open' | 'closed' | 'settled' — Estado del lote
  - `terminal_id` string — ID de la terminal POS
  - `transaction_count` integer — Cantidad de transacciones exitosas incluidas en el lote
  - `total_in_cents` integer — Total agregado del lote en centavos
  - `total_currency` 'GTQ' | 'USD' — Moneda principal del lote
  - `totals_by_currency` object — Totales del lote agrupados por moneda
  - `opened_at` string, date-time — Fecha y hora en que se abrió el lote
  - `closed_at` string, date-time, nullable — Fecha y hora en que se cerró el lote

## Other responses

- `404` — Terminal no encontrada o no asociada a tu cuenta
- `422` — La terminal no tiene un lote abierto para cerrar

---

[API](https://skmtc.dev/recurrente/apis/referencia-api.md) · [All operations](https://skmtc.dev/recurrente/apis/referencia-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recurrente/referencia-api/revisions/da12dce50f30/schema)