Endpoints / Cajas
Listar cajas
Lista cajas de forma paginada dentro de la empresa del usuario autenticado.
/checkoutsCaso de Uso
Se usa cuando la aplicación necesita mostrar una tabla de cajas, buscar por identificador o nombre de sucursal, o filtrar por estado. Al usarlo, el usuario obtiene una página de cajas con datos de paginación y un resumen de la sucursal asociada a cada caja.
Autenticación
Requiere token JWT en el header `Authorization: Bearer <token>`.
Parámetros de ruta
Este endpoint no recibe parámetros de ruta.
Query params
pagestringobligatorioNúmero de página. Debe ser un entero positivo.
pageSizestringobligatorioCantidad de registros por página. Debe ser un entero positivo.
searchstring opcionalTexto opcional para buscar por cjidentificador o sunombre.
statusstring opcionalEstado de la caja. Solo acepta activo o inactivo.
Body
No aplica.
Reglas de negocio
Solo lista cajas de la empresa del usuario autenticado.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
El usuario autenticado debe tener rol administrador, jefe o empleado.
page es obligatorio y debe ser un entero positivo.
pageSize es obligatorio y debe ser un entero positivo.
search es opcional y se usa como texto para buscar por cjidentificador o sunombre.
status es opcional y solo acepta activo o inactivo.
Si no se envía status, se excluyen las cajas con estado eliminado.
Las cajas se ordenan por fecha de registro descendente.
Cada caja incluye un resumen de sucursal en la propiedad sucursal.
Errores esperados
No se envió un token JWT válido o el token no contiene información válida del usuario.
El parámetro search se envió más de una vez o con un formato no válido.
El parámetro status se envió más de una vez o con un formato no válido.
El parámetro status tiene un valor distinto de activo o inactivo.
El parámetro page no se envió o no es un número entero mayor o igual a 1.
El parámetro pageSize no se envió o no es un número entero mayor o igual a 1.
La empresa asociada al usuario autenticado no fue encontrada.
La empresa asociada al usuario autenticado está inactiva.
El usuario autenticado no fue encontrado dentro de su empresa.
El usuario autenticado no pertenece a la empresa indicada por su sesión.
El usuario autenticado intentó acceder a información de una empresa distinta a la suya.
El rol del usuario no tiene permiso para consultar cajas.
El usuario autenticado está inactivo y no puede usar el sistema.
Ocurrió un error interno al consultar el listado de cajas.
Notas de uso
Este endpoint no recibe parámetros de ruta ni body.
Los filtros se envían como query params: page, pageSize, search y status.
Envía siempre page y pageSize para evitar errores de validación.
Usa search para buscar por identificador de caja o nombre de sucursal.
Si no envías status, el listado devuelve cajas activas e inactivas, pero no eliminadas.
Si no hay coincidencias, items se devuelve como un arreglo vacío.