Registrar eventos de Masnet en Dynamics 365 con Logic Apps

Requisitos en Masnet

Antes de configurar el sistema receptor, prepare el destino en Masnet. Los pasos son los mismos para todos los sistemas.

1. Abra Empresa › Integraciones, vaya a la pestaña Destinos y seleccione Nuevo destino. Si la integración aún no tiene datos autorizados, Masnet le pedirá autorizarlos primero.
2. En Dirección del destino (https) escriba la URL pública del receptor. Debe ser https, puerto 443 u 8443 y un nombre DNS público: no se admiten usuario en la URL, fragmento, direcciones IP ni nombres internos. Se admite una cadena de consulta; Masnet trata la URL completa como una credencial.
3. En Formato elija JSON estándar (application/json) o CloudEvents estructurado (application/cloudevents+json). El contenido del evento es el mismo; consulte Webhooks.
4. Seleccione Crear destino. Masnet muestra el secreto de firma (whsec_…) una sola vez. Guárdelo de inmediato en el almacén de secretos del receptor; no podrá consultarlo después.
5. Seleccione Probar destino y luego Enviar prueba. La integración solo se activa con una prueba exitosa; después use Activar destino.

Recepción en Logic Apps

Configure el flujo de recepción como se describe en la guía de Azure Logic Apps y Power Automate: disparador de solicitud HTTP, URL con sig= en Dirección del destino (https) y verificación de la firma en una función antes de escribir en Dataverse.

Verificación y escritura

1. Después de la verificación, use un condicional sobre triggerOutputs()['headers']['masnet-event-type'] para elegir la rama por tipo de evento.
2. Para evitar duplicados, guarde webhook-id en una columna de la fila y consúltela antes de escribir; si ya existe, termine sin cambios. Si su tabla define una clave alternativa, la operación de *upsert* de Dataverse evita ese paso.
3. Para evitar retrocesos, guarde el sequence último aplicado por subject y descarte el evento si el recibido es menor o igual.
4. Escriba en Dataverse con la acción del conector o con la API web: POST [URI de la organización]/api/data/v9.2/<conjunto de entidades> crea una fila y responde 204 con la cabecera OData-EntityId.

Ejemplo de mapeo: contract.status_changed

Los nombres de tabla y columna siguientes son un ejemplo: corresponden a una tabla personalizada que su organización debe crear. Los campos de Masnet son los del evento com.masnet.contract.status_changed.v1, dentro de data.object.

Respuesta

Responda 200 o 202 desde el flujo después de verificar la firma. Si la escritura en Dataverse es lenta, separe la recepción del procesamiento con una cola para responder antes de 15 segundos.

Prueba con el evento de prueba

1. En Masnet, seleccione Probar destino y Enviar prueba.
2. Compruebe que la rama del evento de prueba (com.masnet.integration.test.v1) termina sin escribir en Dataverse.
3. Pruebe una escritura real después de activar el destino, con un contrato de un entorno de pruebas.

Operación: duplicados y orden

• Idempotencia. webhook-id identifica el evento y se conserva en los reintentos y los reenvíos. Registre los identificadores ya procesados y descarte los repetidos con una respuesta 2xx.
• Orden. Cada recurso (subject) lleva un sequence creciente. Descarte un evento cuyo sequence sea menor o igual al último que aplicó para ese subject. Los eventos de recursos distintos no tienen orden entre sí.
• Reintentos. Masnet reintenta cualquier respuesta distinta de 2xx durante un máximo de 72 horas; el calendario completo está en Webhooks.
• Rotación del secreto. Al rotar con superposición, el secreto anterior sigue vigente 24 horas y webhook-signature trae dos firmas v1,… separadas por un espacio. Acepte el evento si cualquiera coincide.

Diagnóstico

Masnet registra el código de respuesta de cada intento en el historial de entregas. Estos son los efectos de cada respuesta del receptor: