Endpoints / Proformas
Obtener Proforma Pdf
Obtiene la referencia al documento PDF asociado a una proforma, incluyendo su nombre y URL pública.
/proformas/:id/pdfCaso de Uso
Se usa cuando la aplicación necesita descargar, abrir o compartir el archivo PDF de una proforma ya generada, sin necesidad de cargar la estructura completa de la proforma. Al usarlo, el usuario obtiene los datos mínimos de la proforma junto con la referencia de su documento PDF.
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 el PDF de una proforma.
Solo permite consultar proformas de la empresa del usuario autenticado.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
Si la proforma no existe, se devuelve error 404.
Si la proforma existe pero no tiene documento PDF disponible, se devuelve error 404.
Solo devuelve la referencia del documento, no la estructura completa 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 proforma existe, pero no tiene un documento PDF accesible.
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.
Usa este endpoint cuando solo necesites la referencia del PDF, no la estructura completa de la proforma.
El campo docurl contiene la URL pública completa del archivo PDF.