Este caso de uso demuestra cómo automatizar el monitoreo de inventario en Finnegans GO mediante Guest Code y BPROC Scheduler. La solución permite detectar productos con stock crítico y generar automáticamente pedidos de compra, transformando un proceso manual en una operación inteligente y proactiva.
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
Ir a Guest Code y completar los campos obligatorios:
-
Nombre: revisionStockYPedidoDeCompra
-
Endpoint: Recordar que el código debe ser único y, una vez guardado, no podrá editarse.
-
Descripción: Script que se dispara mediante un BProc de tipo Scheduler.
Verifica productos con bajo stock en depósito y genera automáticamente un Pedido de Compra para reponerlos.
2. Parámetros recibidos desde el BProc
Ir a BProc y crear un proceso de tipo: Scheduler. Completar los campos obligatorios.
El script recibe parámetros configurados desde el BProc. Ejemplo: PARAMWEBREPORT_MonedaID=PES
Configuración de conexión con Guest Code
Para conectar el BProc con el Guest Code:
-
Seleccionar el tipo: API
-
Copiar la URL correspondiente del Guest Code.
-
Configurar la frecuencia de ejecución desde la programación del Scheduler.
-
En caso de haber definido parámetros en la solapa General, asignar sus valores correspondientes.
Funcionamiento del Script
Su objetivo es monitorear el stock disponible y generar automáticamente pedidos de compra cuando detecta faltantes.
1. Preparación de Parámetros
El script comienza capturando los parámetros enviados desde el BProc (por ejemplo, moneda o depósito) y define las reglas de negocio:
-
Umbral de stock mínimo permitido.
-
Cantidad máxima de productos por pedido.
En este caso:
- Stock mínimo: 30 unidades.
2. Consulta de Stock en Tiempo Real
Se utiliza la función get_reporte para consultar la api del reporte: resumenStockPorDeposito
Desde allí se obtiene información actualizada sobre:
-
Productos disponibles.
-
Cantidad de stock.
-
Situación actual del depósito.
3. Análisis de Faltantes
El script recorre los productos obtenidos y compara el: Stock Disponible < Umbral configurado
Reglas:
- Si el stock es menor a 30 → el producto se considera crítico.
4. Construcción del Pedido de Compra
Con los productos seleccionados, el script arma la estructura de datos que Finnegans GO necesita para crear la transacción.
Incluye:
-
Empresa y sucursal.
-
Código de transacción.
-
Workflow.
-
Dimensiones contables y de distribución.
-
Productos y cantidades.
-
Moneda recibida por parámetro.
La cantidad a reponer se calcula utilizando:
-
La sugerencia del reporte.
-
O un mínimo de 1 unidad.
5. Creación de la Entidad
Finalmente, el script ejecuta: crear_entidad, para generar el Pedido de Compra.
Si la operación es exitosa
Devuelve un JSON con:
-
ID del Pedido de Compra generado.
-
Productos incluidos.
-
Cantidades solicitadas.
Si ocurre un error
Captura la excepción (ApiException) y devuelve:
-
Detalle técnico del error.
-
Información útil para debugging y corrección.
Resumen del Flujo
Entrada: Recibe parámetros desde el BProc
Proceso 1: Consulta el reporte de stock
Proceso 2: Detecta productos con stock bajo
Proceso 3: Construye el Pedido de Compra
Salida: Genera la entidad en Finnegans GO
