Empieza por el contrato operativo
Define el disparador, registro de origen, destino, mapeo, tiempo esperado y responsable. En inventario, decide qué sistema controla la cantidad disponible. En pedidos, define cuándo son elegibles, cómo se gestionan cancelaciones y qué identificador une los registros.
Separa transporte y reglas de negocio
Obtener datos, validarlos y aplicar una regla comercial son responsabilidades distintas. Separarlas facilita revisar excepciones y evita confundir una caída de API con una condición de negocio rechazada.
Diseña para duplicados y eventos perdidos
Shopify indica que no garantiza el orden de los webhooks, recomienda deduplicar mediante su ID y aconseja conciliaciones periódicas porque pueden perderse entregas. Por eso el flujo debe guardar identificadores, procesar de forma idempotente y revisar la fuente periódicamente.
Haz visible el fallo
Registra entrada, resultado, fecha y estado de reintento. Reintenta fallos transitorios con límites y backoff; envía errores permanentes de validación a revisión. Una respuesta HTTP satisfactoria no siempre implica que la operación de negocio haya terminado bien.
Checklist
1. Nombra la fuente de verdad. 2. Define identificadores estables. 3. Valida antes de escribir. 4. Haz idempotentes los reintentos. 5. Añade alertas y responsables. 6. Concilia origen y destino. 7. Prueba la recuperación.