Endpoints / Clientes
Obtener cliente
Obtiene el detalle de un cliente por su identificador dentro de la empresa del usuario autenticado.
/clients/:idCaso de Uso
Se usa cuando la aplicación necesita consultar la información completa de un cliente, por ejemplo para mostrar su detalle, usar sus datos comerciales o cargar un formulario de edición. Al usarlo, el usuario obtiene los datos registrados del cliente solicitado.
Autenticación
Requiere token JWT en el header `Authorization: Bearer <token>`.
Parámetros de ruta
idstringobligatorioIdentificador del cliente. Corresponde al campo clnteid.
Body
No aplica.
Reglas de negocio
Solo permite consultar clientes 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 jefe o empleado.
El cliente debe existir dentro de la empresa autenticada.
El identificador id corresponde al campo clnteid del cliente.
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.
El cliente no existe o no pertenece a 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 está permitido para acceder al módulo de clientes.
El usuario autenticado no tiene un rol permitido para consultar clientes.
El usuario autenticado está inactivo y no puede usar el sistema.
Notas de uso
Este endpoint no recibe body.
Envía el identificador interno del cliente en la ruta, reemplazando :id.
Usa este endpoint para consultar un solo cliente; para listados paginados usa GET /clients.
La respuesta incluye el estado actual del cliente en clnteestado.