Integración de sistemas por API: conecta ERP, CRM, tienda y SAT

Integrar sistemas por API significa conectar tu ERP, tu CRM, tu tienda en línea, tus pasarelas de pago, tus paqueterías y tu facturación ante el SAT para que intercambien información de forma automática, sin que nadie recapture datos. La clave no está solo en “conectar”, sino en diseñar la integración para que soporte fallas: con reintentos, idempotencia, colas, monitoreo y seguridad. Una integración que funciona el día de la demo y pierde pedidos cuando un servicio se cae no es una integración, es un problema aplazado.

Si en tu empresa alguien copia pedidos de Shopify al sistema administrativo, descarga el estado de cuenta para conciliar pagos a mano o arma las guías de envío una por una, este artículo es para ti.

¿Qué es una API, un webhook y un middleware?

Tres conceptos que conviene tener claros antes de hablar de arquitectura:

• API (interfaz de programación de aplicaciones): es la puerta documentada por la que un sistema permite que otro lea o escriba información. Define qué se puede pedir, en qué formato (normalmente JSON sobre HTTPS) y con qué credenciales. Ejemplo: “dame los pedidos pagados desde las 10:00”.
• Webhook: es un aviso que un sistema envía a otro en cuanto ocurre un evento. En lugar de preguntar cada cinco minutos si hubo un pago, la pasarela te avisa cuando el pago se aprueba.
• Middleware: es una capa intermedia que recibe, transforma y reparte la información entre sistemas. Traduce formatos, aplica reglas de negocio y concentra el manejo de errores en un solo lugar.

Una definición útil: una integración es un contrato entre sistemas. Cada lado se compromete a enviar ciertos datos con cierto formato y a responder de cierta manera. Cuando ese contrato no está escrito, la integración se rompe en cuanto alguien cambia un campo.

¿Qué integraciones son más comunes en empresas mexicanas?

Integración	Qué fluye	Mecanismo habitual	Punto delicado
ERP ↔ tienda en línea (Shopify, WooCommerce, a la medida)	Productos, precios, existencias, pedidos	API REST + webhooks	Sobreventa por inventario desfasado
ERP ↔ CRM	Clientes, cotizaciones, oportunidades, saldos	API REST, sincronización programada	Duplicados y “fuente de verdad” de cada dato
Pasarelas de pago (Stripe, Mercado Pago, Openpay)	Cargos, reembolsos, contracargos	Webhooks firmados + consulta por API	Confirmar el pago antes de surtir
Paqueterías	Cotización, guías, rastreo	API REST de cada paquetería o agregador	Formatos y estados distintos por proveedor
PAC para CFDI 4.0	Timbrado, cancelación, complementos de pago	API del PAC (SOAP o REST)	Validaciones fiscales y reintentos sin doble timbrado
SAT descarga masiva	XML emitidos y recibidos	Servicio web del SAT con e.firma	Límites de solicitudes y conciliación
Bancos	Movimientos, estados de cuenta, dispersiones	API bancaria, archivos programados o SFTP	Conciliación por referencia y montos
WhatsApp Business	Notificaciones, confirmaciones, atención	API oficial + webhooks	Plantillas aprobadas y ventana de 24 horas

Sobre el SAT conviene una precisión: tu ERP no timbra directamente con el SAT. Arma el CFDI, lo firma con el certificado de sello digital y lo envía a un PAC, que valida y timbra. Lo detallamos en nuestro servicio de facturación electrónica y automatización SAT, y si lo que necesitas es traer los XML que ya existen, en cómo automatizar la descarga masiva de XML del SAT.

Para el caso específico de tienda en línea y ERP, ya escribimos sobre los beneficios de integrar ERP y eCommerce; aquí nos enfocamos en cómo se construye la integración para que aguante.

Patrones de integración: cuál elegir

Punto a punto

Cada sistema se conecta directamente con el otro. Es rápido de construir y suficiente cuando solo tienes dos o tres sistemas. El problema aparece al crecer: con cinco sistemas puedes terminar con diez conexiones distintas, cada una con su propio manejo de errores, y un cambio en el ERP obliga a tocarlas todas.

Middleware o iPaaS

Un componente central recibe la información y la reparte. Puede ser una plataforma de integración comercial (iPaaS), una herramienta de automatización como n8n, o un servicio propio construido a la medida. Concentra transformaciones, reglas y bitácoras en un solo lugar. Las plataformas comerciales aceleran integraciones estándar; uno propio conviene cuando las reglas de negocio son específicas o el volumen hace caro pagar por transacción.

Colas y eventos

Los sistemas publican eventos (“pedido pagado”, “factura timbrada”, “guía generada”) en una cola o bus de mensajes, y cada sistema interesado los consume a su ritmo. Si el ERP está en mantenimiento, los eventos esperan en la cola en lugar de perderse. Es el patrón más robusto para volúmenes altos o procesos críticos, con herramientas como Redis, RabbitMQ o los servicios de colas de AWS, Google Cloud o Azure.

Patrón	Ventaja principal	Limitación	Recomendado para
Punto a punto	Simple y rápido	Se vuelve inmanejable al crecer	2 a 3 sistemas, bajo volumen
Middleware / iPaaS	Control centralizado	Un componente más que operar	4 o más sistemas, reglas de negocio
Colas y eventos	Tolerancia a fallas y picos	Mayor complejidad inicial	Volumen alto, procesos críticos

En la práctica, muchos proyectos combinan los tres: middleware como centro, colas para los flujos críticos y alguna conexión directa donde no vale la pena más.

Idempotencia: el concepto que separa una integración seria de una frágil

Idempotencia significa que procesar el mismo mensaje dos veces produce el mismo resultado que procesarlo una vez. Suena académico hasta que te pasa esto: la pasarela envía el webhook de pago, tu servidor lo procesa pero tarda en responder, la pasarela asume que falló y lo reenvía. Sin idempotencia, ese cliente recibe dos pedidos, dos guías y, peor aún, dos facturas timbradas.

Cómo se resuelve:

• Cada mensaje lleva un identificador único (el ID del evento o una llave de idempotencia).
• Antes de procesar, el sistema revisa si ese identificador ya se procesó.
• En facturación, se guarda la relación entre el pedido y el UUID del CFDI, y se consulta al PAC antes de reintentar un timbrado.

Es una regla de diseño, no un parche. Se define desde el primer día.

Reintentos, colas de error y monitoreo

Todos los sistemas fallan en algún momento: el PAC tiene mantenimiento, la API de la paquetería responde lento, el token expiró. Lo que importa es qué hace tu integración cuando eso pasa.

1. Reintentos con espera progresiva (exponential backoff): reintentar a los pocos segundos, luego al minuto, luego a los cinco, en lugar de saturar al otro sistema.
2. Cola de mensajes fallidos (dead letter queue): lo que no se pudo procesar después de varios intentos no se descarta; queda en una bandeja para revisión, con el error exacto.
3. Bitácora por transacción: qué llegó, cuándo, qué se respondió. Cuando un cliente diga “pagué y no me llegó la factura”, se debe poder rastrear en minutos.
4. Monitoreo y alertas: tableros con mensajes procesados, errores y latencia, y alertas por correo, Slack o WhatsApp cuando algo se sale de lo normal.
5. Conciliación periódica: un proceso nocturno que compara, por ejemplo, pedidos pagados contra facturas emitidas y reporta diferencias.

La observabilidad (logs estructurados, métricas y trazas) no es un lujo de empresas grandes. Es lo que te permite dormir tranquilo con procesos automáticos corriendo de noche.

Seguridad en integraciones por API

Una integración conecta tus sistemas más sensibles: datos fiscales, clientes, pagos. La seguridad mínima incluye:

• Autenticación adecuada: OAuth 2.0 cuando el proveedor lo ofrece, o tokens de API con permisos limitados a lo necesario. Nunca usuario y contraseña de un administrador.
• Secretos fuera del código: llaves, tokens y certificados de sello digital en un gestor de secretos o variables de entorno cifradas, no en el repositorio.
• Verificación de webhooks: validar la firma que envía la pasarela o el proveedor para asegurar que el aviso es legítimo.
• HTTPS siempre y, cuando aplica, listas de IP permitidas.
• Rotación de credenciales y revocación inmediata cuando alguien sale del equipo o cambia de proveedor.
• Registro de accesos para auditoría, algo especialmente relevante cuando manejas datos personales bajo la ley mexicana de protección de datos.

¿Qué pasa con los sistemas que no tienen API?

Es más común de lo que parece: sistemas de escritorio, ERP antiguos, bases en Access o FoxPro. Las opciones, de menor a mayor robustez:

• Intercambio de archivos programado (CSV, XML o TXT por SFTP o carpeta compartida). Funciona, pero requiere validaciones estrictas.
• Lectura y escritura directa en la base de datos. Rápido, pero frágil si el fabricante cambia la estructura y riesgoso si se escribe sin respetar las reglas del sistema.
• Construir una API propia sobre el sistema existente, que encapsule las reglas y sea la única puerta de entrada.

Si el sistema está muy limitado, la integración suele ser el primer paso hacia algo mayor. Lo explicamos en cómo modernizar un sistema legado sin detener tu operación.

Cómo se planea un proyecto de integración

1. Mapa de sistemas y flujos: qué sistemas existen, qué dato nace en cuál y hacia dónde viaja.
2. Fuente de verdad por dato: el precio vive en el ERP, el contacto comercial en el CRM, el estatus de envío en la paquetería. Sin esta definición aparecen datos que se sobrescriben entre sí.
3. Revisión técnica de cada API: documentación, límites de llamadas, ambiente de pruebas (sandbox), soporte de webhooks.
4. Contratos de datos: campos, formatos, catálogos (claves de producto SAT, unidades, regímenes fiscales) y equivalencias entre sistemas.
5. Construcción con pruebas automatizadas que simulen respuestas exitosas, errores y duplicados.
6. Salida gradual: primero en paralelo o con un subconjunto de operaciones, después al 100%.

Este proceso sigue la misma lógica que cualquier desarrollo a la medida; si quieres ver las etapas completas, revisa cómo se desarrolla un software a la medida. Y si además quieres que una IA tome decisiones sobre esos flujos integrados, por ejemplo clasificar pedidos o responder a clientes, revisa cómo automatizar procesos con IA.

Cómo te ayuda Tecsolt

En Tecsolt diseñamos y construimos integraciones entre ERP, CRM, tiendas en Shopify o WooCommerce, pasarelas como Stripe, Mercado Pago y Openpay, paqueterías, bancos, WhatsApp Business y PAC para CFDI 4.0. Empezamos con el mapa de sistemas y la fuente de verdad de cada dato, y entregamos integraciones con idempotencia, reintentos, bitácora y monitoreo, documentadas y con el código a nombre de tu empresa. Si tus sistemas no tienen API, te proponemos la ruta más segura para crearla. Puedes conocer nuestro servicio de software y ERP a la medida o agendar una reunión para revisar tus flujos.

Preguntas frecuentes

¿Qué es una integración de sistemas por API?

Es una conexión automática entre dos o más programas para que intercambien información sin recaptura. Un sistema envía o solicita datos a otro mediante su API, que es una interfaz documentada con reglas de acceso, formatos y respuestas. Así, una venta en tu tienda puede llegar sola al ERP y generar su factura.

¿Cuál es la diferencia entre una API y un webhook?

Con una API tu sistema pregunta cuando necesita algo, por ejemplo consultar el estatus de un pedido. Con un webhook es el otro sistema el que te avisa en cuanto ocurre un evento, como un pago aprobado. Lo normal es combinar ambos: webhooks para enterarte rápido y consultas por API para confirmar y completar la información.

¿Se puede conectar un ERP con el SAT para facturar automáticamente?

Sí, pero no directamente con el SAT. El ERP arma el CFDI 4.0 y lo envía a un PAC (Proveedor Autorizado de Certificación) mediante su API; el PAC lo valida, lo timbra y devuelve el XML con el folio fiscal. Después el sistema puede generar el PDF, enviarlo al cliente y guardar ambos archivos.

¿Qué pasa si una integración falla o el otro sistema está caído?

Una integración bien diseñada no pierde datos cuando eso ocurre. Los mensajes se guardan en una cola, se reintentan con espera progresiva y, si siguen fallando, pasan a una bandeja de errores donde alguien los revisa. Además, el monitoreo genera una alerta para que el problema se atienda antes de que lo note el cliente.

¿Cuánto cuesta integrar sistemas por API en México?

Depende de cuántos sistemas se conectan, la calidad de sus APIs y el volumen de operaciones. Una integración punto a punto sencilla tiene una complejidad baja y suele resolverse en algunas semanas; una plataforma de integración con varios sistemas, colas y monitoreo es de complejidad alta y se construye por fases. El costo exacto se define en una cotización tras revisar cada API en una reunión de descubrimiento.

¿Qué hago si mi sistema actual no tiene API?

Hay alternativas: leer y escribir directamente en su base de datos con cuidado, intercambiar archivos programados por SFTP o construir una API propia encima del sistema. Si el sistema es muy antiguo, a veces la integración es el primer paso de un plan de modernización por módulos.

• #integración de sistemas
• #api
• #webhooks
• #integración erp
• #cfdi 4.0
• #middleware