Este instructivo explica cómo configurar Deals para que una empresa envíe información a otra empresa del mismo espacio de trabajo, cubriendo la configuración del Integration Server en la empresa receptora, el CFU en el maestro de la empresa emisora y el Bproc de envío.
15 min
¿Para qué sirve?
La integración entre empresas en Deals permite que una empresa emisora publique documentos directamente en el Deals de otra empresa receptora, sin intervención manual. La empresa receptora expone un método de publicación a través del Integration Server (de forma pública o privada); la empresa emisora lo consume desde un Bproc configurado para ese fin. El flujo completo ocurre dentro del mismo espacio de trabajo de Finnegans.
Antes de empezar
Empresa receptora (B):
- Tener el documento creado en el Catálogo de Documentos con su SCHEMA definido.
- Tener configurado un método de publicación con Acceso Directo para ese documento.
- Tener configurada la descarga asociada.
Empresa emisora (A):
- Tener acceso a la configuración de Maestros (Clientes o Proveedores) para agregar un CFU.
- Tener permisos para crear y editar Bprocs.
- Contar con la URL y, si aplica, el token del método publicado por la empresa receptora en el Integration Server.
Modo de uso
El flujo se configura en dos partes: primero en la empresa receptora y luego en la empresa emisora.
Parte 1 — Empresa receptora: Integration Server
Menú → Deals → Integration Server
El Integration Server es la sección de Deals donde la empresa receptora expone sus métodos de publicación para que otras empresas puedan consumirlos. Existen dos tipos de exposición: pública y privada.
Método Público
Un método público es accesible por cualquier empresa del espacio de trabajo sin necesidad de credenciales adicionales.
Pasos para crear un método público:
- Ir a Menú → Deals → Integration Server.
- Hacer clic en Nuevo.
- Completar los campos:
| Campo | Descripción |
|---|---|
| Documento | Documento de Deals al que pertenece el método de publicación a exponer. |
| Método de publicación | Método de Acceso Directo ya configurado para el documento seleccionado. |
| Tipo | Seleccionar Público. |
- Guardar. El sistema genera la URL de acceso público del método.
Compartir la URL generada con la empresa emisora. No se requiere token.
Método Privado
Un método privado restringe el acceso mediante un token de autenticación. Solo la empresa que posea el token puede publicar en él.
Pasos para crear un método privado:
- Ir a Menú → Deals → Integration Server.
- Hacer clic en Nuevo.
- Completar los campos:
| Campo | Descripción |
|---|---|
| Documento | Documento de Deals al que pertenece el método a exponer. |
| Método de publicación | Método de Acceso Directo ya configurado para el documento seleccionado. |
| Tipo | Seleccionar Privado. |
- Guardar. El sistema genera la URL y un Token de autenticación.
Compartir tanto la URL como el Token con la empresa emisora. Sin el token, la empresa emisora no podrá publicar en el método.
No verificado: el documento fuente no detalla si el token tiene fecha de vencimiento ni si puede regenerarse desde la interfaz. Confirmar con el equipo de producto antes de publicar este dato.
Parte 2 — Empresa emisora: CFU y Bproc
CFU en el Maestro de Clientes o Proveedores
Para que el Bproc pueda identificar dinámicamente a qué empresa destino enviar la información según el cliente o proveedor involucrado, se configura un Campo de Formulario Único (CFU) en el Maestro correspondiente.
Configuración → Maestros → Clientes (o Proveedores) → Editar formulario
Pasos:
- Abrir el Maestro de Clientes o Proveedores en modo edición de formulario.
- Agregar un nuevo CFU con los siguientes valores:
| Campo del CFU | Valor recomendado |
|---|---|
| Nombre interno | Código identificador del campo (ej. codigoDeals). Sin espacios. |
| Tipo | Texto. |
| Etiqueta visible | Nombre descriptivo para el usuario (ej. “Código Deals”). |
- Guardar el formulario.
- En cada registro de cliente o proveedor que corresponda a una empresa destino en Deals, completar el CFU con el valor del identificador de la empresa destino.
El valor que se ingresa en el CFU es el que se referencia luego en el parámetro param_codeidDeals del Bproc para determinar a qué empresa enviar cada publicación.
Bproc de envío inter-empresa
El Bproc de envío inter-empresa sigue la misma estructura que el microservicio Send to Deals (ver [Deals — Integración Bproc: Send to Deals]). La diferencia está en el formato del valor del parámetro param_codeidDeals, que varía según el tipo de método expuesto por la empresa receptora.
Formato del parámetro param_codeidDeals
| Tipo de método en Integration Server | Formato del valor |
|---|---|
| Público | Solo el ID de publicación — Ej: POST 1872 |
| Privado | Prefijo con espacio de trabajo + ID — Ej: <EDT_PEREZ>POST 1872 |
El prefijo <EDT_PEREZ> corresponde al identificador del espacio de trabajo (EDT) de la empresa receptora. Este valor lo provee la empresa receptora junto con la URL y el token.
El CFU configurado en el maestro se referencia en el Bproc para que el valor de param_codeidDeals se resuelva dinámicamente según el cliente o proveedor del registro que dispara el envío.
Parte 3 — Empresa receptora: recepción
Una vez que la empresa emisora envía la información a través del Bproc:
- La publicación llega al método configurado en el Integration Server de la empresa receptora.
- Deals procesa el contenido recibido según la descarga asociada al documento.
- Los resultados quedan registrados en el Monitor de Deals de la empresa receptora, con el estado del procesamiento (éxito, error, observaciones).
La empresa receptora no necesita realizar ninguna acción adicional para recibir la información; el procesamiento es automático una vez que el método está configurado y activo.
Qué hace y qué no hace
- Sí: permite que una empresa envíe datos a otra empresa del mismo espacio de trabajo de forma automática mediante Bproc, sin intervención manual en la empresa receptora.
- Sí: el método privado protege la recepción mediante token; solo la empresa autorizada puede publicar.
- Sí: el CFU en el maestro permite resolver dinámicamente el destino de cada envío según el cliente o proveedor involucrado, sin hardcodear el identificador en el Bproc.
- No: la integración entre empresas no está disponible entre espacios de trabajo distintos; emisora y receptora deben pertenecer al mismo EDT.
- No: el Integration Server no reemplaza la configuración del método de publicación en Deals; solo lo expone. El método de Acceso Directo debe existir previamente en el Catálogo de Documentos de la empresa receptora.
- No verificado: vencimiento y regeneración del token de métodos privados — consultar con el equipo de producto.