Endpoints / Proveedores
Obtener Proveedor
Obtiene el detalle de un proveedor por su identificador, dentro de la empresa del usuario autenticado, incluyendo sus relaciones de categoría y marca si existen.
/proveedores/:idCaso de Uso
Se usa cuando la aplicación necesita cargar los datos completos de un proveedor para una vista de detalle, un formulario de edición o una consulta puntual. Al usarlo, el usuario obtiene los datos del proveedor incluyendo su nombre, teléfono, correo y las relaciones resueltas de categoría y marca.
Autenticación
Requiere token JWT en el header `Authorization: Bearer <token>`. Permite acceso a usuarios con rol jefe o empleado. La empresa y el usuario autenticado deben estar activos.
Parámetros de ruta
idstringobligatorioIdentificador del proveedor.
Body
No aplica.
Reglas de negocio
Solo un usuario con rol jefe o empleado puede consultar proveedores.
Solo permite consultar proveedores de la empresa del usuario autenticado.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
Las relaciones categoria y marca pueden ser null si el proveedor no las tiene asignadas.
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.
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 una empresa distinta a la suya.
El rol del usuario no está permitido para acceder al módulo de proveedores.
El usuario autenticado no tiene un rol permitido para consultar proveedores.
El usuario autenticado está inactivo y no puede usar el sistema.
No existe un proveedor con el id indicado dentro de la empresa del usuario autenticado.
Notas de uso
Este endpoint no recibe query params ni body.
Solo devuelve proveedores que pertenecen a la empresa del usuario autenticado.
categoria y marca pueden devolverse como null si el proveedor no tiene esas relaciones asignadas.