Endpoints / Proformas
Enviar proforma
Envía una proforma existente por correo electrónico o WhatsApp al cliente, sin crear un nuevo documento.
/proformas/:id/sendCaso de Uso
Se usa cuando la aplicación necesita reenviar una proforma al cliente por un canal específico desde el frontend, ya sea por correo electrónico o WhatsApp. Al usarlo, el usuario obtiene un mensaje de confirmación del envío.
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 a enviar.
Body
channelstringobligatorioCanal de envío; acepta email o whatsapp.
Reglas de negocio
Solo un usuario con rol jefe o empleado puede enviar proformas.
Solo permite enviar proformas de la empresa del usuario autenticado.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
channel solo acepta los valores email o whatsapp.
No se puede enviar una proforma en estado anulada.
Para el canal email: debe existir correo emisor configurado y correo de destino del cliente.
Para el canal whatsapp: debe existir el token WHATSAPP_APICONSULT_TOKEN configurado.
Debe existir una instancia de API de WhatsApp configurada para la empresa.
Este endpoint realiza el envío de forma inmediata; no inserta una tarea en cola.
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 o fue enviado vacío.
channel no fue enviado o tiene un valor distinto de email o whatsapp.
La proforma está en estado anulada y no puede enviarse.
El canal seleccionado no está habilitado para la empresa del usuario autenticado.
No se ha configurado el token global de WhatsApp en el entorno del servidor.
No existe una proforma con el id indicado dentro de la empresa del usuario autenticado.
No se encontró el correo del emisor o del cliente para realizar el envío por email.
No existe una instancia de API de WhatsApp registrada para la empresa.
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 enviar proformas.
Notas de uso
Este endpoint no recibe query params.
El envío es inmediato; no se encola ni se persiste una nueva tarea de envío.
Usa email o whatsapp exactamente en minúsculas como valor de channel.
Para el envío por email, el cliente debe tener un correo electrónico registrado.
Para el envío por WhatsApp, el cliente debe tener un número de teléfono registrado.