Integración de procesos / 11
Recibir webhooks. Ejecutar operaciones empresariales de forma fiable.
Llega un evento y debe activar una acción en el siguiente sistema. Las entregas múltiples, los retrasos o una API de destino caída convierten esto en un proceso operativo. Desarrollamos ese proceso con eventos claros y efectos verificables.
La situación inicial
HTTP 200 por sí solo no demuestra que se haya ejecutado un proceso empresarial.
Una tienda envía un evento de pedido. El ERP está temporalmente inaccesible. Si todo el trabajo se realiza dentro de la solicitud webhook, un timeout puede generar nuevas entregas; si se confirma inmediatamente, el pedido puede perderse.
Separamos recepción verificada y procesamiento posterior. El emisor determina formato de firma y reglas de entrega. La integración define deduplicación, conservación y significado de una confirmación correcta.
Qué hace DataSource
Separar recepción, persistencia y acción de destino.
Proteger la entrada
Verificar la firma sobre los bytes originales de la solicitud según la documentación del emisor. Limitar tamaño, Content-Type y tipos de eventos admitidos.
Recibir de forma persistente
Guardar el evento en almacenamiento protegido acordado o en una queue. Devolver el código HTTP de éxito adecuado solo tras una recepción correcta.
Procesar
Utilizar ID únicos, diseñar efectos idempotentes y verificar respuestas del destino. Tratar por separado errores permanentes y permitir replay controlado.
Escenario técnico / Ejemplo ilustrativo
Confirmar recepción y seguir el procesamiento por separado.
Payload ilustrativo. eventId y orderId son identidades diferentes. Una entrega repetida no tiene por qué crear un nuevo pedido; el éxito del procesamiento es un estado propio.
Datos de ejemplo y reglas propuestas. Las interfaces y reglas empresariales concretas se verifican para su proyecto.
{
"eventId": "evt-1042",
"type": "order.approved",
"orderId": "ORD-8421",
"version": 3
}
verified → persisted → accepted
worker → effect checked → processedGestión de errores, seguridad y operación
Entrega duplicada y errores parciales.
Duplicados y caídas
Un ID de evento por sí solo no basta si el worker falla entre la acción de destino y la confirmación. El efecto empresarial también necesita protección frente a repetición o conciliación con el destino.
Orden
No todos los emisores garantizan el orden. Las versiones o el estado actual del destino evitan que un evento tardío restablezca un estado anterior.
Replay
Registrar de forma trazable estado de error, corrección y nueva ejecución. Los payloads pueden contener datos personales; almacenamiento y acceso se limitan conscientemente.
Preguntas operativas
Detalles importantes antes de implementar.
Webhooks · HMAC · Queue · Deduplicación · Replay · Estado operativo
¿Está garantizado Exactly-once?
Entre varios sistemas no es una garantía general. Diseñamos para entregas repetidas y un procesamiento cuyo efecto empresarial pueda conciliarse de forma segura.
¿Debemos guardar siempre el registro completo?
Solo los datos necesarios para procesamiento y referencias de error acordadas. Retención y acceso forman parte del modelo operativo.
¿Qué hacer si el emisor no proporciona ID de evento?
Puede obtenerse una clave fiable a partir de recurso, versión y tipo de evento. Un simple hash de payload no identifica automáticamente un evento empresarial único.
Para el análisis técnico
Empezar por su proceso concreto.
Aporte documentación del emisor sobre firmas, reintentos y eventos, payloads anonimizados y acciones de destino deseadas. Las entregas múltiples conocidas ayudan a definir la gestión de errores.
En la primera conversación aclaramos los accesos disponibles, las responsabilidades sobre los datos y un primer flujo delimitado. Después acordamos alcance, responsabilidades y condiciones.
Para empezar bastan ejemplos anonimizados. No envíe contraseñas, tokens ni datos personales de producción en la primera consulta.
Tareas relacionadas
La próxima conexión en contexto.
Integración REST API
La documentación está disponible y una solicitud de prueba funciona. Aun así, en el día a día faltan datos o aparecen registros duplicados. DataSource conecta su API REST con el proceso empresarial concreto y contempla también la ausencia de respuesta.
Sincronizar pedidos & estados
La tienda indica pagado, el ERP aún no conoce el pedido y el envío ya tiene un número de seguimiento. Conectamos estos pasos con estados definidos, referencias de pedido unívocas y una recuperación planificada.
Automatizar usuarios & permisos de acceso
Un nuevo empleado necesita accesos a varias aplicaciones. Un cambio de equipo modifica roles y una salida requiere revocarlos. Conectamos los datos de personal de referencia con un proceso controlado para estos cambios.
Referencias técnicas
Documentación oficial, revisada el 6 de octubre de 2026. La idoneidad depende de la instalación y versión concretas.