Consolidado de cajas del día
GET /api/cash-reports/daily
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Genera el consolidado de todas las cajas abiertas en una fecha (una fila por caja con saldo inicial, ingresos, egresos, teórico, arqueo y diferencia, más los totales por medio de pago). Cada fila coincide con el Cierre de caja de esa caja.
Quién puede usarlo: solo usuarios de tipo administrador (type = admin). Con el token de un vendedor responde 403. Un vendedor recibe 403 aunque tenga permiso de reportes (el consolidado incluye las cajas de todos).
Formato de respuesta: archivo (PDF, XML, ZIP, Excel o texto), no JSON. PDF A4 (application/pdf) o Excel (application/vnd.openxmlformats-officedocument.spreadsheetml.sheet).
Parámetros de la URL (query):
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
date |
YYYY-MM-DD | No | Fecha de apertura de las cajas. Por defecto, hoy. |
establishment_id |
integer | No | Solo las cajas de ese establecimiento. |
format |
string | No | pdf (por defecto) o excel. |
action |
string | No | Solo PDF: preview (por defecto) o download. |
Errores:
403si el usuario no es administrador.422si la fecha no tiene el formatoYYYY-MM-DD, el establecimiento no existe o el formato no es válido.401sin token o con un token inválido.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
date |
query | sí | 2026-11-07 |
Fecha YYYY-MM-DD. |
establishment_id |
query | no | 1 |
Establecimiento. |
format |
query | no | pdf |
pdf o excel. |
action |
query | no | download |
preview o download. |
Respuestas
200 — PDF
%PDF-1.7
%âãÏÓ
... (contenido binario del PDF) ...
%%EOF
200 — Excel
PK ... (contenido binario del libro Excel) ...
403 — No administrador
{
"success": false,
"message": "Solo un administrador puede generar el consolidado de cajas del día."
}
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.