Registrar caja cerrada de restaurante (versión anterior)
POST /api/cash/restaurant
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Registra de una vez una caja ya cerrada con las ventas de un turno de restaurante, identificadas por su external_id. La caja queda a nombre del usuario autenticado, marcada como caja de restaurante; el ingreso se calcula como la suma de los totales de las ventas enviadas.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success.
Cuerpo (JSON):
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
beginningBalance |
numeric | Sí | Saldo inicial. |
dateOpening |
date | Sí | Fecha de apertura YYYY-MM-DD. |
timeOpening |
string | Sí | Hora de apertura HH:MM:SS. |
referenceNumber |
string | No | Referencia de la caja. |
internalsId |
array | Sí | Ventas del turno: [{external_id, type}]. type = NOTA para nota de venta; cualquier otro valor (BOLETA, FACTURA, vacío) = comprobante. |
Reglas:
- Los campos van en camelCase.
- No se validan: un
external_idinexistente produce error500y la caja puede quedar creada parcialmente. - El cierre no usa el arqueo ni los pagos reales: para turnos nuevos usa Aperturar caja y Cerrar caja.
Cuerpo
Content-Type: application/json
{
"beginningBalance": 100.0,
"dateOpening": "2026-11-07",
"timeOpening": "08:00:00",
"referenceNumber": "TURNO-MAÑANA",
"internalsId": [
{
"external_id": "9f8b7c6d-5e4f-4a3b-2c1d-0e9f8a7b6c5d",
"type": "NOTA"
},
{
"external_id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"type": "BOLETA"
}
]
}
Respuestas
200 — Registrada
{
"success": true,
"message": "Caja creada con éxito"
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.