Resumen Analítico de Ventas vía Email

CORE
, , ,
1

Este caso de uso demuestra cómo automatizar el envío de reportes ejecutivos de ventas en Finnegans GO mediante Guest Code y BPROC Scheduler. La solución permite extraer información financiera de Análisis de Facturas de Venta, procesar los datos automáticamente y enviar un resumen analítico en formato HTML por email a los destinatarios definidos.

A lo largo de este documento se detallará la configuración, lógica funcional y funcionamiento completo de la automatización.

1.Crear el Guest Code

  • Nombre: enviarResumenFacturacionVenta

  • Descripción: Script activado por BProc que procesa facturas de venta en un rango de fechas y envía un resumen tabulado por email.

  • Parámetros Críticos:

    • PARAMWEBREPORT_FechaDesde: Inicio del rango.
    • PARAMWEBREPORT_FechaHasta: Fin del rango.
    • email: Dirección de correo que recibirá el reporte.

Lógica del Script (Paso a Paso)

El script transforma datos crudos del sistema en un reporte visual siguiendo estos pasos:

  1. Extracción de Datos: Invoca la función get_reporte apuntando a la api analisisFacturaVenta. Obtiene todas las facturas emitidas en el periodo solicitado.

  2. Cálculo Dinámico de Totales:

    • Identifica automáticamente cuáles campos son numéricos (precios, cantidades, impuestos).
    • Suma todos los valores fila por fila para generar un consolidado general.

  3. Generación de Plantilla HTML: Construye una tabla visual con estilos CSS, asignando colores (verde corporativo para cabeceras) y formato decimal (coma para decimales y punto para miles).

  4. Envío vía API de Mail: Utiliza las credenciales de entorno (access_token) para disparar el correo de forma segura a través del servidor de Finnegans GO.

2.Configuración del BProc Scheduler

Para programar el envío automático (ej. todos los lunes a las 9 AM):

  • Tipo de Proceso: API.
  • Endpoint: Pegar la URL del Guest Code creado.

Configuración de Parámetros

En la solapa de parámetros del BProc, configurar los valores de prueba o fijos:

image
image648×599 50 KB

image
image746×599 42.9 KB

Resumen del Flujo de Datos

  • Entrada: El Scheduler envía rango de fechas y correo.
  • Proceso 1: Limpieza de fechas y consulta de facturas. Lista de transacciones del periodo.
  • Proceso 2: Sumatoria de campos numéricos detectados. Objeto con totales (Neto, IVA, Total).
  • Proceso 3: Renderizado de tabla HTML. Cuerpo de correo profesional. Conexión con el servidor de correo. Email recibido por el destinatario.

image
image414×599 38 KB