Bproc - Microservicio "Send to deals"

App Builder Bproc
1

Bproc “Send to deals”

Ahora podes configurar tus Bproc de Maestro y Transacción para enviar la información correspondiente hacia los Documentos de Deals.

Este instructivo te guiará paso a paso en la configuración de un nuevo Bproc que se integrará con un microservicio para enviar parámetros a documentos de deals

Su objetivo es poder obtener información de ERP e integrar con lo que requiera o llevarlo a sistemas de terceros.

Pasos a seguir:

  1. Ingresamos a Configuración → Diseño del espacio de trabajo → Bproc

    629×628 35.8 KB

  2. Seleccionar el Tipo de Bproc:

343×362 11.3 KB

Determina si el Bproc se aplicará a una transacción específica o a un maestro de datos.

  • Transacción: Si deseas enviar datos referente los cambios en un proceso específico.
  • Maestro: Si deseas enviar datos referente a los cambios en un conjunto de datos de referencia.
  1. Nos posicionamos en la pestaña “Configuración” y en este caso, seleccionamos en categoría de documento “Pedidos de venta”:

1189×562 22.7 KB

  1. En la sección Modo seleccionamos “Webhook” y Teniendo en cuenta que quieras conectar con ERP y deals con esta misma URL, pegamos el URL del microservicio que comunicara dicho Bproc con DEALS:

https://go-prod.finneg.com/api/1/erp-send-to-deals/send

  1. En los eventos seleccionamos las opciones deseadas:

Teniendo en cuenta que se activa cuando:

Crear: se crea un nuevo registro.

Actualizar: un registro existente es modificado.

Eliminar: un registro es eliminado.

Anulación: un registro es anulado.

Permite Reprocesado: si activas esta opción el bproc puede ser reprocesado manualmente desde el monitor.

  1. Siempre que queramos crear un bproc que envie informacion a deals, necesitamos que se creen tres parámetros:

Ejemplo de configuración de nuestro endpoint:

“param_endpointDeals” → endpoint de publicación del documento configurado en Deals.
“param_codeIdDeals” → CodeId del método POST configurado en Deals.
“param_endpointERP” → Nombre de API de ERP.

704×600 62.4 KB

  1. Listo, ya tenemos nuestro bproc configurado correctamente.

Caso de Uso

“Creación de Documento en Deals y Comunicación con BProc “Pedido de Compra”

Esta funcionalidad permite utilizar los datos de los pedidos nuevos, actualizaciones y eliminaciones dentro del sistema, y dispara dicha información hacia un documento de Deals. Esto facilita compartir los movimientos generados en las transacciones de pedido de venta con aplicaciones externas, asegurando la sincronización y actualización de los datos en otros sistemas.

Flujo Principal

Paso 1: Creación del Documento

  1. Ingresar a Deals.
  2. Navegar a Catálogo de Documentos.
  3. Seleccionar la opción Nuevo.
  4. Configurar el documento para que reciba los métodos POST y GET.
  5. Guardar la configuración.

1600×454 32.3 KB

Paso 2: Creación del Método de Publicación (POST)

  1. Ingresar a Deals → Publicaciones.
  2. Seleccionar Nuevo para agregar un método de publicación.
  3. Ingresar un nombre de método.
  4. Seleccionar Tipo de Origen: Código de Método.
  5. Agregar un Código ID.
  6. En Acceso, seleccionar “Directo”.
  7. En URL, ingresar un texto identificador.
  8. Guardar la configuración.

image
image849×422 16.5 KB

Paso 3: Creación del BProc de Transacción “Pedido de Venta”

  1. Ingresamos a Configuración → Diseño del espacio de trabajo → Bproc

    629×628 35.8 KB

  2. Ingresamos a “Nuevo” y completamos los datos correspondientes:

    424×364 15.4 KB

  3. Nos dirigimos a “Configuracion”

    630×704 35.8 KB

Pasos para Configurar un BProc hacia Deals

  1. Configuración de Categorías de Documento
  • Ingresar a la configuración del BProc.
  • En la sección Categorías de Documento, seleccionar la transacción deseada, en este caso, “Pedidos de Compra”.
  1. Configuración del Modo y URL
  • En la opción Modo, seleccionar Webhook.
  • En el campo URL, ingresar el microservicio que comunicará con Deals.
  1. Selección de Eventos
  • Marcar las casillas correspondientes a los eventos:
    • Crear
    • Actualizar
    • Permite Reprocesado
  1. Configuración de Parámetros
  • Agregar los siguientes parámetros con su respectiva configuración:
  • Primer Parámetro:
    • Nombre: param_endpointDeals
    • Descripción: API para Publicar Deals
    • Valor por defecto: Ingresar la URL generada en el documento de Deals.

Para buscar este dato: nos dirigimos a Deals → Catálogo de documentos y estando en esta pantalla, seleccionamos el nuestro.

1600×436 32.6 KB

  • Segundo Parámetro:
    • Nombre: param_endpointERP
    • Descripción: API para descargar de ERP

Valor por defecto: Ingresar la API correspondiente a la transacción, en este caso “pedidoCompra”.

Para seleccionar la api de la transacción deseada, dirigirse a “Diccionario de APIS”

  • Tercer Parámetro:
    • Nombre: param_codeIdDeals
    • Descripción: Código del método de publicación
    • Valor por defecto: Buscar e ingresar el Código ID del método de publicación asociado al documento en Deals.

Para la búsqueda del valor asociado al ID del documento dirigirse a Deals → Publicaciones → Publicaciones propias → y seleccionamos nuestro documento de método de publicación creado.

1095×530 18.6 KB

  1. Guardado y Finalización
  • Una vez completada la configuración, guardar los cambios.
  • Al ejecutar eventos en Pedidos de Compra, estos impactarán en el documento de publicaciones asociado en Deals.

Con estos pasos, se asegura que los movimientos en Pedidos de Compra sean correctamente conectados y sincronizados con Deals.

Como visualizamos los eventos en deals?

Ingresamos a Deals → Publicaciones → Publicaciones propias → en nuestro documento seleccionamos los tres puntos y “Ver en monitor”.

image