Saltar al contenido
Facturador

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_id inexistente produce error 500 y 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.