Ahora podes configurar tus Bproc de Maestro, Viewer 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 del ERP e integrar con lo que requiera o llevarlo a sistemas de terceros.
Pasos a seguir
Ingresamos a Configuración → Diseño del espacio de trabajo → Bproc
Creamos un nuevo Bproc, ingresando:
- Nombre: Asignar un nombre representativo.
- Código: Ingresar un código identificador.
- Tipo: Seleccionar Viewer, Transacción o Maestro
- 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.
- Viewer: Si deseas enviar deseas enviar items o transacciones desde una view especifica
- Aplicación: Seleccionar la aplicación deseada.
- Descripción: Descripción de la funcionalidad del bproc
Existen dos configuraciones posibles para ejecutar el microservicio “Send to Deals”, Por un lado, al elegir tipo “Viewer” en el bproc, y por otro al elegir tipo “Maestro” o “Transaccion”
Configuración para bproc tipo “Viewer”
En el caso de elegir “Viewer”, es necesario configurar una actividad de tipo API para el correcto funcionamiento, ingresando en el campo URL el microservicio que enviará la información a deals:
https://go-prod.finneg.com/api/1/erp-send-to-deals/viewer
Posteriormente se deben configurar dos parámetros:
- Parámetro para la publicación en deals:
- Orden 0
- Nombre: paramcodeidDeals
- Tipo Widget: Widget Textbox
- Valor por defecto. Este campo contiene dos maneras de configurarse correctamente. Si se trata de un Documento Privado:
<espacio de trabajo>ID de publicación
(Ejemplo: <EDT_PEREZ>POST 1872)
Si se trata de un Documento Público:
ID de publicación
(Ejemplo: POST 1872)
- Parámetro de endpoint del documento
- Orden: 1
- Nombre: paramendpointdeals
- Tipo Widget: Widget Textbox
- Valor por defecto: URL que se encuentra en el documento de Deals como API para publicar
El resultado final será el siguiente:
Por último, se debe guardar la actividad y el bproc, el cual ya se visualizará en la view seleccionada. Al ejecutarlo, enviará la información de los ítems seleccionados a la publicación previamente definida en Deals.
Configuración para bproc tipo “Transacción” o “Maestro”
En el caso de elegir “Transación” o “Maestro” debemos dirigirnos a la pestaña “Configuración” y seleccionar un documento en “Categorias de documento”. En este caso, realizaremos el ejemplo con “Pedidos de Venta”
Dentro de “Modo” seleccionamos “Webhook”, e ingresamos la siguiente url del microservicio que enviará la información a Deals desde las transacciones o los maestros:
https://go-prod.finneg.com/api/1/erp-send-to-deals/send
Dentro de eventos seleccionamos los deseados, teniendo en cuenta que se activan al:
- Crear: Cuando se crea un nuevo registro
- Actualizar: Cuando se modifica un registro existente
- Eliminar: Cuando se elimina un registro
- Anular: Cuando se anula un registro
También existe la opción de “Permite Reprocesado”, que al activarla el bproc puede ser reprocesado manualmente desde el monitor
Por último, es necesario configurar tres parametros:
-
“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 de la API del ERP, que se obtiene en el Diccionario de APIs
Guardamos el bproc, el cual ya estará configurado correctamente para su uso y envío de información a Deals.
Integraciones entre empresas utilizando Deals
En esta sección se detallará la configuración necesaria para enviar información entre diferentes empresas en Finnegans utilizando Deals
Pasos a seguir
- Creación de métodos públicos y privados desde Integration Server
El primer paso es la creación de métodos de publicación y descarga desde Integration Server.
Acceda a Integration Server, ingrese a un documento o cree uno en caso de que no exista. Cree los siguientes métodos presionando el botón “+” en las pestañas correspondientes
-
Publicación: Complete los campos obligatorios, y seleccione Acceso → Directo. Guarde la publicación presionando el botón “Confirmar”
-
Descarga: Complete los campo obligatorios, especificamente Tipo de Salida → API Finnegans. Al seleccionar API Finnegans, se habilitará automáticamente un campo para completar una URL que corresponda a una API de Finnegans. Esta URL es crucial y debe ser asociada a una propiedad específica para su uso posterior. Guarde el método de descarga. presionando el botón “Confirmar”
Guarde el documento, que ya estará listo con sus respectivos métodos de publicación y descarga.
- Configuración del bproc para el envío de información
Con el documento público configurado, el siguiente paso es establecer un Bproc que orqueste el envío de la información.
Desde el menú, Diríjase a Configuración → Diseño de Espacio de trabajo → Bprocs, y cree un bproc de tipo Transacción
Luego, en la pestaña de Configuración, seleccione un documento donde desea que impacte el bproc. Para este ejemplo seleccionaremos Pedidos de venta. Complete Modo → Webhook y la siguiente URL:
https://go-qa.finneg.com/api/1/erp-send-to-deals/organization/send
Configure los eventos que dispararán la ejecución del bproc, en este caso Crear y Actualizar
Por último, configure los parámetros del bproc para que la comunicación se realice correctamente:
-
param_endpointDeals
- Descripción: Aquí se debe colocar la API para publicar de “Deals”
- Valor: URL de API para publicar en Deals del documento público. Ejemplo: api/1/deals-back/publicarUS2026
-
param_codeIdDeals:
- Descripción: Este parámetro contendrá el código del método de publicación que creó en “Integration Server” del documento público relacionado.
- Valor por defecto : [CódigoID del Método de Publicación]
-
param_endpointERP
- Descripción: En este parámetro se colocará el endpoint de la transacción para la cual se está generando el Bproc.
- Valor: [Endpoint de la API] - En este caso: PedidoVenta
-
param_campoOrganizacion
- Descripción: Aquí se especificará el campo donde se encuentra el código del proveedor o cliente bajo el cual está configurado el CFU (Código Finnegans Único). Para que la comunicación sea exitosa, este campo es crucial, ya que el microservicio lo utilizará para identificar la empresa destino.
- Valor: En este caso como se trata del maestro de clientes, se coloca Cliente
Los parámetros quedarán configurados de la siguiente manera:
- Consideraciones Importantes para la Comunicación
- CFU en Maestro Clientes/Proveedores:
- Para que la comunicación se realice de forma correcta, el cliente o proveedor al que se desea enviar información debe tener configurado el campo CFU en el Maestro Clientes/Proveedores.
- Si este campo no está presente, la comunicación no podrá llevarse a cabo.
- Este CFU identifica de manera única a la empresa destino para el microservicio que cuente con Deals.
Para configurar correctamente el CFU, se debe realizar lo siguiente:
-
Estando posicionados en el Maestro Clientes, vamos al cliente deseado, seleccionamos y en la pestaña “Datos comerciales”
-
Vamos a encontrar el campo en Deals - CFU, el cual lo debemos completar con el CFU correspondiente del cliente
Cómo asociamos el CFU al cliente que debemos enviar dicha información:
- Existencia de Documento Público:
- Debe existir un documento público creado y configurado con sus métodos de publicación y descarga para cada empresa que participe en la integración.
- Métodos de Publicación y Descarga:
- Cada empresa involucrada en la integración debe tener configurado su propio método de descarga.
Recepción de Información de Otra Empresa
Para recibir información de otra empresa, se debe configurar un método de descarga en la empresa receptora.
-
Posicionamiento en la Empresa Receptora:
- Asegúrese de estar posicionado en la empresa donde desea recibir la información (ej. “Empresa TEST”).
-
Creación del Método de Descarga en Deals:
- Navegue a la sección Deals → Descargas.
- Proceda a crear un nuevo método de descarga.
-
Selección del Documento y Método:
- Dentro de la selección del documento, elija el documento público y el método de descarga que creó anteriormente en el “Integration Server” (Paso 1.3).
-
Activación del Webhook:
- Active el Check de “activar webhook”.
-
Configuración de Orígenes Permitidos:
- Desplácese a la sección “Orígenes permitidos”.
- Seleccione el método de publicación que fue disponibilizado por el documento público de la empresa emisora. Esto permitirá que, al detectarse un Cliente/Proveedor con el CFU alojado, se envíe la información de la transacción deseada (en este caso, “Pedidos de Venta”) a su empresa.
Resumen de Recepción: Mediante la configuración de un Bproc de tipo transacción y la correcta identificación de un cliente con CFU y un método de descarga asociado, la información correspondiente a la transacción (ej. “Pedidos de Venta”) puede ser automáticamente recibida y visualizada en la sección “Mis Descargas” de la empresa emisora.