Usa la integración viable más simple
Un conector estándar es preferible si cubre entidades, mapeos, frecuencia y excepciones. El middleware se justifica cuando varios sistemas controlan campos distintos, divergen las reglas, hace falta orquestación o la recuperación es específica.
Define contratos en cada frontera
Documenta payloads, identificadores, versión, autenticación, valores y errores. OpenAPI describe contratos HTTP, pero un esquema no define la propiedad del dato ni la recuperación. Registra contratos técnicos y operativos.
Diseña para fallos distribuidos
Una actualización puede funcionar en un sistema y fallar en otro. Usa operaciones idempotentes, estado duradero, reintentos controlados y, cuando una escritura deba generar un evento, patrones como transactional outbox. Trata los duplicados como esperables.
Protege credenciales y datos
Usa privilegio mínimo, secretos gestionados, verificación de firmas y acceso auditable. Valida payloads antes de procesar. No expongas credenciales en navegador o logs.
Opera, no solo despliegues
Monitoriza volumen, latencia, rechazos, colas de retry y diferencias de conciliación. Mantén runbooks para expiración de tokens, rate limits, cambios de esquema, caídas y replay. Versiona mapeos.