# Bproc - Microservicio "Send to deals"

**URL:** <https://bc.finneg.com/t/bproc-microservicio-send-to-deals/4506>\
**Category:** Deals\
**Tags:** cómo-se-hace\
**Created:** [13 Febrero, 2025 18:35 UTC](https://bc.finneg.com/t/bproc-microservicio-send-to-deals/4506 "2025-02-13T18:35:54Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![AcademiaFinnegans](https://bc.finneg.com/user_avatar/bc.finneg.com/academiafinnegans/32/23146_2.png) [@AcademiaFinnegans](https://bc.finneg.com/u/AcademiaFinnegans)\
**Post date:** [13 Febrero, 2025 18:35 UTC](https://bc.finneg.com/t/bproc-microservicio-send-to-deals/4506/1 "2025-02-13T18:35:54Z")

</div>

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

 ![](https://bc.finneg.com/uploads/default/original/2X/5/5ddfc28451cb9f2e6864db2b4d6e7ad1902e9913.png)

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

 ![](https://bc.finneg.com/uploads/default/original/2X/7/73980c13e32d7fadb7731b50e65eb8c9862c104e.png)

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`

 ![](https://bc.finneg.com/uploads/default/original/3X/a/c/acddc1a5fd553c21b62462e2428b809c8496e9c0.png)

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:

```auto
<espacio de trabajo>ID de publicación
(Ejemplo: <EDT_PEREZ>POST 1872)

```

Si se trata de un Documento Público:

```auto
ID de publicación
(Ejemplo: POST 1872)

```

 ![](https://bc.finneg.com/uploads/default/original/3X/a/1/a1d5c08c8d5f8e0b8bb2e4d14055392f63330fc8.png)

- 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

 ![](https://bc.finneg.com/uploads/default/original/3X/8/e/8ec1c1ebd3e78e60e40d49be1497e64a5d8178b1.png)

El resultado final será el siguiente:

 ![](https://bc.finneg.com/uploads/default/original/3X/3/c/3c0fb009d057e146e511d563e185fe661fa6c29d.png)

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”

 ![](https://bc.finneg.com/uploads/default/original/3X/4/9/496a775e5b6682f1d431f759de2ae2b23f5ca7f6.png)

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:

1. “param\_endpointDeals” → endpoint de publicación del documento configurado en Deals.

2. “param\_codeIdDeals” → CodeId del método POST configurado en Deals.

3. “param\_endpointERP” → Nombre de de la API del ERP, que se obtiene en el Diccionario de APIs

 ![](https://bc.finneg.com/uploads/default/original/3X/2/1/21765e34faacae3c46e310d53ae3dfb7f1f4d5bf.png)

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**

1. 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.

1. 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**

 ![](https://bc.finneg.com/uploads/default/original/3X/7/4/74c628317def87540000abe4ac85fdc26ebc01d4.png)

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`

 ![](https://bc.finneg.com/uploads/default/original/3X/b/6/b6b3adff12e42f24cf03fd9db63a4f91f2355d60.png)

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

- param\_codeIdDeals:

- param\_endpointERP

- param\_campoOrganizacion

Los parámetros quedarán configurados de la siguiente manera:

 ![](https://bc.finneg.com/uploads/default/original/3X/7/e/7ee5023d6055a8d817915f73cd3bbbcf0693d2bc.png)

1. 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  
 ![](https://bc.finneg.com/uploads/default/original/3X/9/a/9a3a6050785b123ae778e2a2cd2484ff611bb8f6.png)

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.

1. Posicionamiento en la Empresa Receptora:

2. Creación del Método de Descarga en Deals:

3. Selección del Documento y Método:

4. Activación del Webhook:

 ![](https://bc.finneg.com/uploads/default/original/3X/4/2/429651bcd6fe34df42dcaf607515a2bf209e2b1d.png)

1. Configuración de Orígenes Permitidos:

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.