Eventos de Vinculación y Desvinculación en Bproc
Este documento describe la funcionalidad de notificación de los eventos de vinculación y desvinculación en bprocs de tipo webhook.
¿Por qué lo hicimos?
El ciclo de vida operativo de un documento implica la vinculación y desvinculación de relaciones con otros documentos. Anteriormente, estos eventos no generaban notificaciones automáticas en el motor de BProc, lo que impedía que tus sistemas e integraciones externas reaccionaran inmediatamente. Con esta mejora, verás en tiempo real cualquier evento de vinculación realizado.
¿Cómo funciona?
El mecanismo evalúa los cambios de relación entre ítems y dispara un evento hacia la URL configurada en el BProc.
- Para que un evento se notifique, basta con que al menos uno de los BProcs aplicables al par de documentos (origen o destino) tenga habilitada la casilla correspondiente:
Requisitos Previos
Antes de comenzar con la configuración, asegúrate de contar con los siguientes elementos:
-
Permisos de Administrador / Usuario Configurador: Único rol con autorización para editar la configuración de un BProc.
-
BProc de Transacción Activo: El bproc debe ser de tipo Transacción, estar en estado Activo y tener configurado el modo de ejecución en Webhook.
-
Categoría de Documento Relacionada: Los tipos de documento participantes (origen y destino) deben estar contemplados dentro de las categorías configuradas en el BProc.
-
URL de Destino Habilitada: El servicio receptor externo debe contar con un endpoint HTTP POST activo para recibir el payload.
Configuración paso a paso
Seguí estos pasos para activar el envío automático de notificaciones:
-
Menú principal → Configuración → Diseño del espacio de trabajo → BProc.
-
Busca y selecciona el BProc de tipo Transacción sobre el cual deseas activar el monitoreo.
-
Verifica que el campo Modo esté seleccionado en Webhook.
-
Ubica las opciones de notificación:
-
Marca la casilla Vinculacion para notificar cuando se asocien ítems entre documentos.
-
Marca la casilla Desvinculacion para notificar cuando se disuelva un vínculo.
-
-
Haz clic en Guardar para aplicar la configuración.
NOTA: Las casillas Vinculacion y Desvinculacion solo son visibles y editables en BProcs de tipo Transacción en modo Webhook. No aparecerán en configuraciones de Maestros ni en modos Manuales o de Pregrabación.
[image]
Estructura
- Vinculación
{
"eventID": 18950,
"webhook": "vinculacion/desvinculacion",
"webhookType": "Documento",
"user": ,
"token": "",
"timeStamp": "Aug 24, 2026, 11:04:38 AM",
"object": {
"event": "vinculacion"
},
"params": {
"vinculaciones": \[
{
"origen": {
"type": "FACTVEN",
"category": "Factura de Venta",
"IdentificacionExterna": "FACTVEN - 609",
"OperacionItemID": 94267,
"IdentificacionExternaItem": "FACTVEN - 609 Item-2"
},
"destino": {
"type": "REMVTA",
"category": "Despacho",
"IdentificacionExterna": "123123123",
"OperacionItemID": 5266,
"IdentificacionExternaItem": null
},
"cantidad": 1
}
\]
},
- Desvinculación
{
"eventID": 18948,
"webhook": "vinculacion/desvinculacion",
"webhookType": "Documento",
"user": "",
"token": "",
"timeStamp": "Aug 24, 2026, 11:03:23 AM",
"object": {
"event": "desvinculacion"
},
"params": {
"vinculaciones": \[
{
"origen": {
"type": "FACTVEN",
"category": "Factura de Venta",
"IdentificacionExterna": "FACTVEN - 609",
"OperacionItemID": 94267,
"IdentificacionExternaItem": "FACTVEN - 609 Item-2"
},
"destino": {
"type": "REMVTA",
"category": "Despacho",
"IdentificacionExterna": "123123123",
"OperacionItemID": 5266,
"IdentificacionExternaItem": null
},
"cantidad": 1
}
\]
},