Integraciones API en ecommerce: ERP, logística y pasarelas de pago

Una tienda online no funciona de forma aislada. Detrás de cada pedido que se procesa correctamente hay una red de sistemas conectados: el ERP que gestiona el inventario, el operador logístico que prepara el envío, la pasarela de pago que procesa la transacción, el CRM que registra la interacción con el cliente, y la herramienta de email marketing que envía la confirmación. Las integraciones API son el tejido conectivo que hace que todo esto funcione de forma fluida y automática.

En 2026 ese tejido conectivo se ha vuelto más exigente por dos motivos que no son técnicos sino de calendario. El primero es regulatorio: el Real Decreto-ley 15/2025 aplazó la entrada en vigor de VeriFactu, que ahora obliga a las sociedades desde el 1 de enero de 2027 y al resto de obligados, autónomos incluidos, desde el 1 de julio de 2027, mientras que los fabricantes de software de facturación debían tener soluciones adaptadas desde el 29 de julio de 2025. El segundo es de plataformas: la API REST de administración de Shopify es oficialmente legacy desde el 1 de octubre de 2024, y lo que hace unos años era una integración estable hoy es una cuenta atrás.

Dicho de otro modo: una integración no es un proyecto que se entrega y se olvida, es una pieza con mantenimiento. Este artículo repasa qué tipos de integración existen, cómo se eligen las arquitecturas, qué ha cambiado en las APIs de las plataformas y cuánto cuesta realmente mantener todo eso funcionando.

¿Qué es una integración API en el contexto ecommerce?

Una API (Application Programming Interface) es un contrato que define cómo dos sistemas de software pueden comunicarse entre sí. En ecommerce, las integraciones API permiten que tu tienda online intercambie datos automáticamente con otros sistemas sin intervención manual.

Por ejemplo, cuando un cliente completa un pedido en tu tienda PrestaShop:

1. La pasarela de pago (Stripe, Redsys, PayPal) confirma el cobro vía API.
2. Tu tienda envía los datos del pedido al ERP (SAP, Holded, A3) vía API para actualizar inventario y contabilidad.
3. El ERP notifica al sistema de logística (Correos, SEUR, Packlink) vía API para generar la etiqueta de envío.
4. El sistema de email marketing (Mailchimp, Klaviyo) recibe el evento de compra vía API para iniciar el flujo post-venta.
5. El CRM (SuiteCRM, HubSpot) registra la actividad del cliente vía API.

Todo esto ocurre en segundos y sin que nadie tenga que copiar datos manualmente de un sistema a otro.

REST, GraphQL y webhooks: tres formas de hablar

Conviene distinguirlas porque condicionan el diseño. Una API REST expone recursos (pedidos, productos, clientes) y se consulta por URL: es simple, cacheable y muy predecible, pero obliga a pedir varias veces para componer una vista completa. GraphQL permite pedir exactamente los campos que hacen falta en una sola llamada, lo que reduce drásticamente el número de peticiones en catálogos grandes, a cambio de un modelo de costes por complejidad de consulta que hay que entender antes de abusar de él. Y los webhooks invierten la dirección: en lugar de preguntar cada pocos minutos si hay novedades, el sistema remoto avisa cuando algo pasa.

La combinación habitual en un ecommerce sano es: webhooks para los eventos (pedido creado, pago confirmado, envío entregado), REST o GraphQL para las consultas puntuales, y un proceso programado de reconciliación que, una o dos veces al día, compara totales y detecta lo que se perdió. Esa tercera pieza es la que casi nunca se presupuesta y la que evita descuadres de stock al cabo de unos meses. Si trabajas con PrestaShop, la nueva Admin API de PrestaShop 9 es un buen ejemplo de este cambio de modelo; en automatización pura, lo explicamos al hablar de cómo conectar APIs REST y bases de datos con n8n.

Tipos de integraciones API en ecommerce

1. Integraciones con ERP y gestión

Esta es probablemente la integración más crítica para cualquier ecommerce con volumen. Sincronizar la tienda con el ERP permite:

• Stock en tiempo real: el inventario se actualiza automáticamente en la tienda cuando se registra una entrada o salida en el almacén.
• Sincronización de pedidos: cada pedido online se registra automáticamente en el ERP, evitando la entrada manual y sus errores asociados.
• Catálogo centralizado: productos, precios y descripciones se gestionan desde el ERP y se sincronizan con la tienda.
• Facturación automática: las facturas se generan directamente en el sistema contable.

Las arquitecturas más comunes para esta integración incluyen sincronización en tiempo real (webhooks), sincronización periódica (cron jobs cada X minutos), y middleware intermediario (herramientas como Alumio, Celigo o desarrollos custom).

2. Integraciones logísticas

La logística es una de las áreas donde las integraciones API aportan mayor valor operativo:

• Generación automática de etiquetas: cuando un pedido está listo para enviar, el sistema genera la etiqueta del transportista automáticamente.
• Tracking integrado: el cliente recibe actualizaciones del estado de su envío directamente desde tu tienda o por email.
• Multi-transportista: la lógica de negocio selecciona automáticamente el transportista más adecuado según peso, destino, urgencia y coste.
• Gestión de devoluciones: el proceso de RMA se conecta con el transportista para generar etiquetas de devolución.

3. Integraciones con pasarelas de pago

Las pasarelas de pago modernas ofrecen APIs sofisticadas que van más allá del cobro simple:

• Tokenización: almacenar datos de tarjeta de forma segura para compras recurrentes o con un clic.
• Suscripciones: gestión de pagos recurrentes para modelos de suscripción.
• Split payments: dividir un pago entre múltiples destinatarios (modelo marketplace).
• Conciliación automática: sincronizar transacciones con el sistema contable.
• Prevención de fraude: sistemas de scoring y verificación basados en IA integrados vía API.

4. Integraciones con marketplaces

Vender en marketplaces (Amazon, eBay, Miravia, Fnac) requiere mantener sincronizados catálogos, stock, precios y pedidos entre tu tienda y cada marketplace. Las integraciones API, a menudo gestionadas a través de hubs como ChannelEngine, Lengow o desarrollos propios, permiten gestionar esta multicanalidad sin multiplicar el trabajo operativo.

5. Integraciones con herramientas de marketing

El marketing digital moderno se nutre de datos en tiempo real:

• Email marketing: eventos de compra, abandono de carrito, navegación por productos, todo enviado vía API para activar automatizaciones.
• Analytics: integración con Google Analytics 4, server-side tracking vía API para datos más precisos sin depender de cookies.
• Personalización: plataformas de personalización y recomendaciones que reciben datos de comportamiento vía API.
• Publicidad: conversiones API (Meta CAPI, Google Enhanced Conversions) para optimización de campañas sin cookies de terceros.

6. Integraciones de suscripciones y pagos recurrentes

El modelo de suscripción añade una capa que la integración de pago puntual no tiene: ciclos de renovación, reintentos de cobro fallido, cambios de plan a mitad de periodo, prorrateos y cancelaciones. Todo eso genera eventos que el ERP y el CRM necesitan recibir en orden, y un cobro fallido mal gestionado es una baja que no tenía por qué producirse. Lo tratamos a fondo en el artículo sobre suscripciones y pagos recurrentes en ecommerce.

A esto se suma un cambio normativo europeo que afecta a cualquiera que cobre por transferencia: el Reglamento de Pagos Instantáneos obliga a los proveedores de pago de la zona euro a poder recibir transferencias inmediatas desde el 9 de enero de 2025 y a enviarlas desde el 9 de octubre de 2025, con el mismo precio que una transferencia ordinaria, y desde esa misma fecha a ofrecer la verificación del beneficiario (comprobar que el nombre coincide con el número de cuenta antes de ejecutar el pago). Para un ecommerce B2B que cobra por transferencia, eso cambia los tiempos de conciliación: el dinero llega en segundos, y el sistema tiene que estar preparado para liberar el pedido igual de rápido.

7. Integración con facturación: VeriFactu cambia el calendario

Es la integración que más proyectos va a mover en España en los próximos meses. VeriFactu exige que los sistemas de facturación garanticen integridad, conservación, accesibilidad, legibilidad, trazabilidad e inalterabilidad de los registros, con registros encadenados que permitan seguir la pista de cada factura y sin posibilidad de modificar o borrar sin dejar rastro. Hay dos modos de cumplir: remitir automáticamente los registros a la AEAT (modo VERI*FACTU) o conservarlos internamente con requisitos reforzados.

Lo que esto significa para una tienda online es concreto: si tu ecommerce emite facturas —directamente o a través del ERP—, ese flujo entra en el alcance. Y si la facturación la hace el ERP, la integración tienda-ERP pasa a ser parte de un circuito con requisitos legales, no solo operativos. Conviene revisarlo con tiempo, porque el cuello de botella no suele ser el desarrollo sino la coordinación con el proveedor del software contable. Si estás además valorando mover ese ERP, lo analizamos en la guía de migración de ERP de on-premise a la nube.

Arquitecturas de integración: ¿cómo conectar todo?

Punto a punto (P2P)

Cada sistema se conecta directamente con cada otro sistema. Es la opción más simple para pocas integraciones (2-3 sistemas) pero escala muy mal: con N sistemas, necesitas N×(N-1)/2 conexiones. Para una tienda con ERP, logística, CRM, email marketing y 2 marketplaces ya estamos hablando de 15 conexiones individuales que mantener.

Middleware / Integration Platform (iPaaS)

Un hub central gestiona todas las comunicaciones entre sistemas. Las plataformas iPaaS (Integration Platform as a Service) como Alumio, Celigo, Make (antes Integromat) o n8n actúan como orquestadores: cada sistema solo se conecta al middleware, y este gestiona las transformaciones de datos y la lógica de enrutamiento.

Ventajas: mantenimiento centralizado, transformaciones de datos consistentes, monitorización unificada, menor acoplamiento entre sistemas.

Event-Driven Architecture (EDA)

Para escenarios de alto volumen, una arquitectura basada en eventos con message brokers (RabbitMQ, Apache Kafka) permite desacoplar completamente los sistemas. Los eventos (pedido creado, stock actualizado, envío completado) se publican en colas y cada sistema suscrito los consume a su ritmo, sin bloqueos ni dependencias directas.

Cómo elegir entre las tres

No hay una respuesta universal, pero sí un orden de preguntas. ¿Cuántos sistemas hay que conectar? Con dos o tres, punto a punto es más barato de construir y de entender. ¿Cuántos eventos por minuto en hora punta? Si el pico de una campaña multiplica por diez el tráfico y las integraciones son síncronas, el día de la campaña se cae la tienda, no el ERP. ¿Quién va a mantenerlo? Un iPaaS traslada parte del mantenimiento al proveedor, pero añade una cuota mensual y una dependencia; un desarrollo propio con n8n autoalojado abarata la licencia y encarece la operación.

La regla práctica que aplicamos: empezar por lo simple y cambiar cuando duela de verdad, no cuando se prevea que dolerá. La migración de punto a punto a un hub es perfectamente abordable si las integraciones estaban bien aisladas; lo caro es haberlas escrito dentro del código de la tienda, mezcladas con la lógica de negocio. Hay casos prácticos de ambos modelos en nuestros artículos sobre la integración de Magento con Odoo, sobre cómo automatizar WooCommerce con n8n y sobre la sincronización entre CRM y ERP.

Buenas prácticas en integraciones API ecommerce

1. Gestión de errores robusta

Las integraciones fallan. APIs que no responden, datos mal formados, timeouts, límites de rate excedidos. Tu integración debe contemplar reintentos con backoff exponencial, colas de mensajes fallidos (dead letter queues), alertas automáticas al equipo técnico, y un dashboard de monitorización que muestre el estado de cada integración en tiempo real.

2. Idempotencia

Diseña tus integraciones para que repetir una operación no cause efectos duplicados. Si un pedido se envía dos veces al ERP por un error de red, el sistema debe detectar que ya existe y no crear un duplicado. Utiliza identificadores únicos y verificaciones de existencia en cada operación.

3. Versionado de APIs

Las APIs evolucionan. Un cambio en la API de tu transportista o pasarela de pago no debería tumbar tu tienda. Implementa abstracciones que aíslen tu código de negocio de los detalles de cada API concreta, facilitando la adaptación a nuevas versiones.

4. Seguridad

Las integraciones API manejan datos sensibles (pedidos, datos de clientes, información financiera). Asegúrate de usar siempre HTTPS, tokens de autenticación rotativos (OAuth 2.0 cuando sea posible), principio de mínimo privilegio en los permisos de API, y cifrado de datos sensibles en tránsito y en reposo.

5. Documentación y testing

Documenta cada integración: endpoints utilizados, transformaciones de datos, flujos de error, y dependencias. Implementa tests automatizados que verifiquen que cada integración funciona correctamente tras cada despliegue.

6. Observabilidad: enterarte antes que el cliente

La diferencia entre una integración profesional y una casera no está en el código feliz, está en qué pasa a las tres de la madrugada de un sábado. Como mínimo hacen falta tres cosas: un registro estructurado de cada llamada con su identificador de correlación, para poder reconstruir el recorrido completo de un pedido entre sistemas; métricas de volumen y latencia por integración, para detectar que algo se ha degradado antes de que falle; y alertas con umbral, no por cada error aislado sino cuando la tasa de fallo supera lo normal. Sin eso, el primer aviso lo da el cliente que no recibe su pedido.

7. Límites de rate y contratos de plataforma

Cada API impone un límite de peticiones, y en campaña es precisamente cuando se alcanza. Hay dos consecuencias de diseño: conviene agrupar operaciones en lotes siempre que la API lo permita, y conviene que las sincronizaciones masivas corran fuera de las horas de venta. También conviene leer el contrato: las plataformas retiran versiones de su API con preaviso, y una integración sin dueño es una avería programada. En el caso de Shopify, por ejemplo, cada versión estable se publica trimestralmente y se mantiene al menos doce meses, lo que deja alrededor de nueve meses de solape para migrar; cuando una versión deja de estar soportada, las peticiones pasan a atenderse con la más antigua que siga viva, con los cambios de comportamiento que eso implica.

El estado de las APIs de las plataformas en 2026

Shopify: GraphQL o nada

Es el cambio más relevante de los últimos años. La API REST de administración de Shopify es legacy desde el 1 de octubre de 2024 y la recomendación oficial es construir todas las apps e integraciones con la Admin API de GraphQL. En la práctica eso implica reescribir el acceso a datos de cualquier integración antigua y revisar las dependencias de terceros. Si estás valorando desarrollar sobre la plataforma, lo tratamos en los artículos sobre el stack para desarrollar una app de Shopify y sobre cómo publicarla en la App Store.

WooCommerce: dos APIs que no son la misma

Aquí la confusión más común es mezclar la API REST de administración (wc/v3, autenticada con claves y pensada para integraciones de back office) con la Store API (wc/store/v1, pública, sin claves, basada en la sesión del cliente y en nonces para las escrituras), que existe para construir carrito, checkout y catálogo de cara al usuario y que, por diseño, no da acceso a datos sensibles ni a pedidos de otros clientes. Usar la segunda donde tocaba la primera es una fuente habitual tanto de agujeros de seguridad como de integraciones que no pueden hacer lo que se les pide.

PrestaShop: del webservice clásico a la Admin API

PrestaShop 9 introduce una Admin API sobre API Platform con autenticación por OAuth 2.0, que convive con el antiguo webservice. Para integraciones nuevas es el camino, y lo detallamos en el artículo sobre la Admin API de PrestaShop 9. Si tu tienda sigue en la rama 1.7, la decisión de integrar y la de actualizar están ligadas y conviene tomarlas juntas.

Y una capa nueva: las integraciones para agentes de IA

En paralelo a todo lo anterior ha aparecido una capa de integración pensada para que modelos de lenguaje consulten y operen sistemas de negocio de forma controlada. Lo explicamos en el artículo sobre el protocolo MCP. No sustituye a nada de lo descrito aquí —por debajo sigue habiendo las mismas APIs— pero cambia quién hace la llamada, y eso tiene consecuencias de permisos y de auditoría que conviene pensar antes y no después.

Cuánto cuesta y cuánto tarda una integración

La pregunta llega siempre, y la respuesta honesta empieza por separar tres partidas que se confunden: la construcción, la puesta en marcha y el mantenimiento.

Construcción. Una integración de un solo sentido y con una API bien documentada —enviar pedidos a un ERP conocido, por ejemplo— se desarrolla en días. Una bidireccional con mapeo de catálogo, variantes, impuestos y descuentos se mide en semanas. Lo que dispara el coste no es el número de endpoints, es la cantidad de reglas de negocio implícitas que nadie ha escrito: qué pasa con un pedido parcialmente servido, cómo se tratan las devoluciones parciales, qué prevalece si el precio del ERP y el de la tienda difieren.

Puesta en marcha. Aquí es donde se pierden los plazos. La carga inicial de catálogo e histórico, la limpieza de datos y la fase de doble funcionamiento —en la que el proceso manual sigue vivo mientras se verifica el automático— suelen ocupar tanto como el desarrollo. Recortar esta fase es la causa más frecuente de los descuadres que aparecen el segundo mes.

Mantenimiento. Es la partida que casi nunca se presupuesta y la que nunca desaparece: cambios de versión de API, certificados que caducan, campos nuevos, límites que se endurecen. Como referencia de planificación, conviene contar con una revisión trimestral por integración y con una ventana de migración al año por cada plataforma externa con versionado agresivo. Una auditoría técnica anual suele detectar las integraciones que han quedado sin dueño antes de que fallen.

Cinco errores que tumban una integración

1. Escribir la integración dentro del código de la tienda. Mezclada con la lógica de negocio y sin capa de abstracción, cualquier cambio en la API externa obliga a tocar el núcleo, y cualquier actualización de la plataforma pone en riesgo la integración.

2. Sincronizar todo cada pocos minutos por si acaso. Es la receta para alcanzar el límite de peticiones en campaña. Lo que cambia poco —el catálogo— se sincroniza por lotes; lo que importa en el momento —el stock de los productos activos, los pedidos— va por eventos.

3. Confiar en que el evento llega siempre. Los webhooks se pierden. Sin un proceso de reconciliación que compare periódicamente ambos lados, la diferencia se acumula en silencio durante meses.

4. Guardar credenciales en el código o en la base de datos de la tienda. Una tienda comprometida no debería implicar un ERP comprometido. Lo tratamos en el artículo sobre seguridad de APIs empresariales y en la guía de seguridad informática para pymes; si el cliente exige garantías formales, el marco es el de la certificación ISO 27001.

5. No documentar el mapeo de datos. Seis meses después, nadie recuerda por qué el campo de referencia del ERP se corta a 18 caracteres. Y ese tipo de decisión, mal reinterpretada, genera duplicados.

Preguntas frecuentes

¿Webhooks o consultas periódicas?

Las dos cosas. Webhooks para reaccionar rápido a lo que importa y un proceso periódico de reconciliación para detectar lo que se perdió. Con solo lo primero acabas con descuadres; con solo lo segundo, con retrasos y con un consumo de peticiones innecesario.

¿Un iPaaS o un desarrollo a medida?

Un iPaaS compensa cuando hay muchos sistemas, flujos relativamente estándar y poco equipo técnico interno. El desarrollo a medida compensa cuando la lógica de negocio es particular —y en ecommerce con ERP industrial suele serlo— o cuando el volumen hace que la cuota mensual deje de ser trivial. Una solución intermedia frecuente es un orquestador autoalojado con nodos a medida.

¿Qué pasa si cambio de plataforma de ecommerce?

Si las integraciones estaban aisladas detrás de una capa propia, se reescribe esa capa y el resto se conserva. Si estaban escritas dentro de la tienda, se rehacen todas. Es uno de los factores de coste que más se subestima al comparar plataformas.

¿Las integraciones afectan al rendimiento de la tienda?

Sí, si son síncronas. Una llamada al ERP dentro del proceso de compra convierte la caída del ERP en una caída del checkout. Todo lo que no sea imprescindible para confirmar el pedido debe ir en segundo plano. Está relacionado con lo que contamos sobre optimización del checkout y sobre las Core Web Vitals en 2026.

¿Cómo sé si una integración está fallando?

Si la respuesta es que te lo dice un cliente, no hay observabilidad. Lo mínimo es un panel con el estado de cada integración, el número de operaciones pendientes en la cola de fallidos y una alerta cuando la tasa de error sube. Montar ese panel sobre los datos que ya generan los sistemas es un proyecto pequeño, y es el que más disgustos evita: puede apoyarse en el mismo enfoque que describimos para el business intelligence en pymes.

¿Hay que hacer algo con VeriFactu si vendo solo online?

Si emites factura, sí: el sistema que la emite debe cumplir los requisitos, lo haga la tienda o el ERP. Las fechas son el 1 de enero de 2027 para sociedades y el 1 de julio de 2027 para el resto de obligados, y la conversación con el proveedor del software de facturación conviene tenerla mucho antes.

Conclusión: las integraciones como ventaja competitiva

En 2026, las integraciones API no son un nice-to-have sino un requisito fundamental para cualquier ecommerce que quiera operar de forma eficiente. Una arquitectura de integración bien diseñada reduce errores manuales, acelera operaciones, mejora la experiencia del cliente y libera tiempo del equipo para tareas de mayor valor.