Volver al blog
Integración

Cómo integramos WooCommerce con ERP propio en Chile

El proceso técnico y de negocio detrás de conectar una tienda online con un sistema de gestión a medida, sin perder datos en el camino.

·Juan Jorquera

El e-commerce sin integración es e-commerce a medias. Cuando los pedidos online llegan a la bandeja de correo y alguien los pasa manualmente al sistema de gestión, se crea un cuello de botella que escala mal y genera errores.

Este artículo documenta el proceso que seguimos cuando integramos WooCommerce con un ERP desarrollado a medida para uno de nuestros clientes en el sector pet retail.

El problema de partida

La empresa operaba con un ERP propio que manejaba inventario, ventas en tienda física y logística. El e-commerce funcionaba en paralelo: los pedidos llegaban por correo, alguien los procesaba manualmente y luego actualizaba el stock en ambas plataformas.

El resultado: stock desactualizado, órdenes perdidas y un equipo operativo dedicando dos horas diarias a trabajo de traspaso manual.

Qué necesitábamos conectar

Antes de escribir una línea de código, mapeamos los flujos:

  1. Stock: El ERP es la fuente de verdad. WooCommerce debe reflejar el stock disponible en tiempo real.
  2. Órdenes: Cada pedido en WooCommerce debe crear automáticamente una orden en el ERP.
  3. Clientes: Sincronización unidireccional de clientes nuevos desde WooCommerce hacia el ERP.
  4. Precios: El ERP define los precios. WooCommerce los consume, no al revés.

La arquitectura que elegimos

Optamos por una capa de integración propia en lugar de usar un plugin de sincronización genérico. Las razones:

  • El ERP tenía una API REST propia (desarrollada por nosotros), lo que facilitaba el control total.
  • Los plugins genéricos no manejaban bien los casos borde de este cliente (bundles de productos, precios por canal).
  • Queríamos logging y monitoreo propios para detectar fallos antes de que el cliente los notara.

La arquitectura quedó así:

WooCommerce → Webhook → API Gateway → Cola de mensajes → ERP
ERP → Job programado (cada 15 min) → WooCommerce (stock + precios)

Manejo de errores y casos borde

La parte más compleja no fue la integración en el camino feliz, sino los casos borde:

  • ¿Qué pasa si el ERP está caído? Las órdenes de WooCommerce se encolan y se procesan cuando el ERP vuelve.
  • ¿Qué pasa si el stock llega a cero entre la consulta y el pago? Validación en el momento del checkout contra el ERP en tiempo real.
  • ¿Qué pasa con las devoluciones? Un webhook en WooCommerce dispara la actualización de stock en el ERP.

Cada escenario de error tiene logging estructurado y alertas por correo cuando supera un umbral.

Resultado

Tres meses después del go-live:

  • Cero traspasos manuales de órdenes: el equipo operativo recuperó esas dos horas diarias.
  • Stock desactualizado eliminado: los quiebres de stock online bajaron un 80%.
  • Visibilidad completa: un dashboard muestra el estado de cada orden y cualquier fallo de sincronización.

Lo que aprendimos

La integración técnica es la parte más rápida. El trabajo real está en el mapeo de flujos, en entender los casos borde y en convencer al equipo operativo de confiar en el proceso automático.

Sin esa confianza, el equipo sigue haciendo el traspaso manual "por las dudas" y la integración sirve de poco.

Preguntas frecuentes

Lo que la gente pregunta sobre este tema

¿Cuánto tarda integrar WooCommerce con un ERP en Chile?

Una integración estándar —stock, órdenes y clientes— tarda entre 4 y 8 semanas desde el mapeo de flujos hasta el go-live. El plazo depende principalmente de la calidad de la API del ERP y de cuántos casos borde tiene la operación. Si el ERP no tiene API, hay que construirla primero, lo que agrega 2 a 4 semanas.

¿Se puede integrar WooCommerce con cualquier ERP?

Con cualquier ERP que tenga una API REST o que permita acceso directo a la base de datos, sí. Con ERPs completamente cerrados (sin API y sin acceso a datos), la integración es técnicamente posible pero más costosa y frágil. En esos casos, la conversación de diagnóstico sirve para evaluar si conviene integrar o migrar.

¿Qué pasa si mi ERP no tiene API?

Si el ERP no tiene API, hay tres caminos: construir una capa API propia sobre la base de datos del ERP (lo más común cuando el ERP es propio o tiene acceso a BD), usar integración vía archivos o webhooks si el sistema lo permite, o migrar a un ERP que sí tenga API. Evaluamos el caso específico en la conversación de diagnóstico.

¿Cómo se sincroniza el stock en tiempo real entre WooCommerce y el ERP?

El ERP es la fuente de verdad del stock. Cada 10 a 15 minutos (o en tiempo real si el volumen lo justifica), un job programado actualiza WooCommerce con el stock disponible del ERP. En el momento del checkout, se hace una validación en tiempo real contra el ERP para evitar vender stock que ya no existe.

¿Qué pasa si la integración falla a mitad de un proceso?

Toda integración robusta tiene manejo de errores explícito. Las órdenes que no pueden procesarse se encolan y se reintentan automáticamente. Si el fallo persiste, se genera una alerta y un humano revisa. El logging estructurado permite ver exactamente qué pasó y cuándo, sin tener que investigar a ciegas.

Antes de contratar, revisa este checklist

15 preguntas para evaluar si el proyecto necesita apoyo externo o puede resolverse internamente. PDF, 2 páginas.

Sin spam. Solo el checklist. Podemos hablar después si quieres.

¿Prefieres conversar directo? Agenda 45 min sin costo