Endpoints / Cajas
Obtener caja
Obtiene el detalle de una caja por su identificador funcional dentro de una sucursal específica.
/checkouts/:idCaso de Uso
Se usa cuando la aplicación necesita consultar una caja específica para mostrar su detalle, validar su estado o cargar sus datos en una pantalla de gestión. Al usarlo, el usuario obtiene la información de la caja junto con un resumen de la sucursal asociada.
Autenticación
Requiere token JWT en el header `Authorization: Bearer <token>`.
Parámetros de ruta
idstringobligatorioIdentificador funcional de la caja. Corresponde a cjidentificador, no a cjid.
Query params
cjsuidstringobligatorioIdentificador de la sucursal donde se busca la caja.
Body
No aplica.
Reglas de negocio
Solo permite consultar 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.
La búsqueda se realiza por empresa autenticada, cjsuid y cjidentificador.
El parámetro id de la ruta corresponde al campo cjidentificador, no al campo cjid.
El query param cjsuid es obligatorio para identificar la sucursal donde se busca la caja.
Un mismo cjidentificador puede repetirse en sucursales distintas.
Errores esperados
No se envió un token JWT válido o el token no contiene información válida del usuario.
No se envió el parámetro id en la ruta.
No se envió el query param obligatorio cjsuid.
No existe una caja con ese identificador dentro de la sucursal indicada y la empresa autenticada.
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 la caja por empresa, sucursal e identificador.
Notas de uso
Este endpoint no recibe body.
Envía cjsuid como query param obligatorio.
El id de la ruta debe ser el cjidentificador visible de la caja, por ejemplo "001".
Para conservar ceros iniciales, trata el identificador de caja como texto.
La respuesta incluye el objeto sucursal con datos básicos de la sucursal asociada.