Endpoints / Proformas
Obtener proforma
Obtiene el detalle completo de una proforma por su identificador, dentro de la empresa del usuario autenticado, incluyendo emisor, receptor, detalle de items, totales y documento PDF.
/proformas/:idCaso de Uso
Se usa cuando la aplicación necesita cargar el contenido completo de una proforma para su visualización, revisión, impresión o previsualización. Al usarlo, el usuario obtiene la estructura completa de la proforma con todos sus datos resueltos.
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 de la proforma.
Body
No aplica.
Reglas de negocio
Solo un usuario con rol jefe o empleado puede consultar proformas.
Solo permite consultar proformas de la empresa del usuario autenticado.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
La respuesta incluye la estructura completa del documento: emisor, receptor, detalle de items, totales y documento PDF.
Este endpoint no modifica el estado ni el stock de la proforma.
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 existe una proforma con el id indicado dentro de la empresa del usuario autenticado.
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 está inactivo y no puede usar el sistema.
El usuario autenticado no tiene un rol permitido para consultar proformas.
Notas de uso
Este endpoint no recibe query params ni body.
Solo devuelve proformas que pertenecen a la empresa del usuario autenticado.
La respuesta usa la misma estructura completa que POST /proformas.
detalle[].dprfmatipoitem se deriva del campo dprfmaesinventariable de cada item.
El documento PDF se devuelve con su nombre y URL pública.