← Todos los artículos

Guías

Integraciones que aguantan producción

Conectar dos sistemas es fácil en un demo y brutal en producción. Este es mi mapa probado en campo de cobros, pagos e integración fiscal — empieza por los patrones que toda integración comparte y luego baja al área que de verdad necesitas.

La mayoría de los problemas de integración no son problemas de API, son problemas de acuerdo. En el momento en que dos sistemas pueden escribir el mismo campo, aparecen el drift, los cobros dobles y el inventario sobrevendido. Por eso cada guía aquí empieza en el mismo punto: define una sola fuente de verdad por dato y haz cada sync idempotente, para que un reintento no haga daño.

El segundo hilo que recorre todo es ser honesto sobre la entrega. Los webhooks son una optimización de velocidad, no una garantía — se pierden, se duplican y llegan desordenados. El patrón que de verdad funciona es webhooks para el camino rápido más una conciliación periódica que vuelve a afirmar la verdad. Esa columna vertebral no cambia, ya sea que conectes suscripciones de Stripe, una pasarela de pago mexicana o una factura CFDI.

Para que la profundidad siga siendo navegable, el cluster está dividido en tres áreas enfocadas — Stripe y cobros SaaS, pagos en México y LATAM, y facturación CFDI mexicana. Las guías de abajo son las transversales que sostienen a las tres; elige el área que coincida con lo que estás conectando.

Fundamentos y guías generales

Preguntas frecuentes

¿Cómo está organizada esta sección?
Tres sub-hubs enfocados: Stripe y cobros SaaS (suscripciones, cobro por uso, Connect, dunning, entitlements), pagos en México y LATAM (Mercado Pago, Conekta, OXXO/SPEI, stablecoins, rieles de agentes) y facturación CFDI mexicana (CFDI 4.0, Carta Porte, complementos, catálogos del SAT). Las guías de esta página son las transversales — webhooks, sync con ERP, agentes vs automatización — que aplican a las tres.
¿Webhooks o polling?
Webhooks cuando necesitas reaccionar casi en tiempo real y puedes alojar un endpoint; polling cuando la fuente no empuja eventos o no puedes recibir conexiones entrantes. En producción casi siempre corres ambos: webhooks por velocidad y un poll de conciliación para atrapar lo que se pierde.
¿Cómo mantengo dos sistemas en sync sin que peleen por los datos?
Elige un solo dueño por entidad (idealmente por campo). El dueño escribe; los demás solo leen. Luego haz cada escritura idempotente para que los reintentos y los eventos duplicados converjan en vez de corromper el estado.
¿Compro un conector o construyo middleware a medida?
Compra un conector (iPaaS) para flujos estándar y un stack común: es el camino más rápido. Construye middleware a medida cuando tienes lógica B2B, asignación personalizada, kits o un sistema propio que los conectores no modelan. Un híbrido suele ser el mejor punto final.