Una tienda puede empezar gestionando diez productos directamente desde WooCommerce. El problema aparece cuando la empresa también tiene punto físico, varias bodegas, facturación electrónica, vendedores, distribuidores o un ERP donde ya controla precios e inventario.

En ese escenario, integrar WooCommerce con ERP no significa simplemente “mandar el pedido al otro sistema”. Una integración profesional necesita decidir quién controla cada dato, cuándo se actualiza, cómo se identifica cada producto y qué ocurre si WooCommerce vende mientras el ERP está fuera de servicio.

WooCommerce dispone actualmente de una REST API integrada con la API REST de WordPress, capaz de leer y modificar recursos como productos, pedidos, clientes y cupones. También permite crear webhooks que notifican eventos a sistemas externos.

El reto no es únicamente conectar dos APIs. Es evitar que después nadie sepa cuál de los dos sistemas tiene el stock correcto.

Antes de integrar: define la fuente de verdad

Uno de los conceptos más importantes es el sistema maestro o fuente de verdad.

Cada dato debería tener una autoridad claramente definida.

Dato	Sistema maestro posible
Productos	ERP/PIM o WooCommerce
SKU	ERP
Precio	ERP o ecommerce
Stock	ERP/WMS
Pedido online	WooCommerce
Pago	Pasarela
Factura fiscal	ERP/software de facturación
Cliente	CRM/ERP según proceso
Envío	ERP/WMS/logística

Esta tabla es orientativa. No existe una arquitectura universal.

El problema aparece cuando ERP y WooCommerce modifican simultáneamente precio o stock sin una regla de prioridad. Una integración bidireccional no debería significar “todos escriben en todo”.

API vs. webhook vs. plugin vs. middleware

Antes de diseñar el flujo conviene diferenciar las herramientas disponibles.

Método	Ventaja	Limitación
Plugin/conector	Implementación rápida	Dependencia del proveedor
REST API	Mucha flexibilidad	Requiere implementación técnica
Webhook	Reacciona a eventos	Necesita receptor confiable
Middleware	Centraliza reglas y transformaciones	Añade otra capa
Desarrollo propio	Máximo control	Mayor mantenimiento

WooCommerce permite crear API keys con permisos de lectura, escritura o lectura/escritura. Aplicando mínimo privilegio, una integración que solo consulta productos no debería recibir permiso para alterar pedidos.

Un webhook funciona de otra manera: WooCommerce avisa que ocurrió un evento, por ejemplo pedido creado o producto actualizado. Puede configurarse con un secreto para que el receptor compruebe la autenticidad del mensaje mediante una firma HMAC-SHA256.

En resumen:

API: un sistema consulta o modifica información.

Webhook: un sistema avisa que ocurrió algo.

Normalmente se complementan.

WooCommerce ya gestiona inventario: ¿por qué conectar un ERP?

WooCommerce puede controlar cantidades, estados de stock, backorders y umbrales de inventario. Cada SKU debe ser único dentro de la tienda, y las variaciones pueden tener SKU, precio y stock propios.

Para un ecommerce pequeño con una única bodega puede ser suficiente.

Un ERP o WMS empieza a tener más sentido cuando existen:

• Tiendas físicas.
• POS.
• Marketplaces.
• Compras y proveedores.
• Varias bodegas.
• Distribución.
• Mayoristas.
• Producción.
• Facturación centralizada.
• Diferentes vendedores o canales.

No recomendamos un ERP simplemente porque “suena más empresarial”. La complejidad debe responder a una necesidad real.

Integración unidireccional vs. bidireccional

Unidireccional

ERP
→ precios
→ stock
→ WooCommerce

El ERP es la autoridad.

Bidireccional

ERP
→ stock
→ WooCommerce

WooCommerce
→ pedidos
→ ERP

Esto es bidireccional, aunque stock solo se modifique desde el ERP y pedidos nazcan únicamente en WooCommerce.

Ese suele ser un diseño mucho más sano que permitir modificaciones sin control desde ambos lados.

Integrar WooCommerce con ERP: 9 claves esenciales

1. Define qué sistema será maestro de cada dato

Problema que resuelve: conflictos entre sistemas.

Información involucrada: productos, SKU, precios, inventario, clientes, pedidos, pagos, facturas y envíos.

Antes de desarrollar debemos crear una matriz de responsabilidad.

Ejemplo:

ERP controla stock
→ WooCommerce recibe disponibilidad.

WooCommerce crea pedido online
→ ERP recibe el pedido.

Pasarela confirma pago
→ el proceso comercial decide cuándo preparar o facturar.

Riesgo

Que el ERP indique 14 unidades y WooCommerce 17 porque ambos modificaron inventario independientemente.

Qué comprobar

Quién puede crear, modificar y eliminar cada dato.

Cuándo requiere desarrollo personalizado

Cuando el ERP y WooCommerce utilizan modelos distintos o existen reglas por bodega, canal, cliente o lista de precios.

2. Normaliza SKU, variantes e identificadores antes de sincronizar

Problema que resuelve: productos duplicados o actualizaciones sobre el registro equivocado.

WooCommerce define el SKU como un identificador único de producto o variación. Para integraciones es mucho más estable utilizarlo que depender únicamente del nombre comercial.

“Camiseta negra” puede cambiar a “Camiseta básica negra”.

Un SKU estable puede seguir identificando la misma referencia.

También debemos revisar:

• SKU vacíos.
• SKU duplicados.
• Variaciones.
• IDs externos.
• Unidades.
• Códigos de barras.
• Productos padre/hijo.

En WooCommerce una variación puede administrar stock de forma independiente. Actualizar solamente el producto padre no significa que automáticamente cada talla o color quede correcto.

Identificadores útiles

SKU → producto.

Order ID → pedido WooCommerce.

Transaction ID → transacción.

External ID → registro equivalente en ERP.

Invoice ID → factura.

No todos son necesarios en todos los proyectos.

3. Diseña correctamente la sincronización de inventario

Problema que resuelve: vender unidades que realmente no están disponibles.

Inventario físico y disponibilidad ecommerce no siempre son lo mismo.

Ejemplo:

Stock físico: 10
Reservado: 3
Disponible para ecommerce: 7

Publicar “10 disponibles” podría permitir ventas que la empresa ya no puede atender.

WooCommerce puede administrar cantidades, estados, backorders y stock retenido para pedidos sin pagar.

La integración debe decidir qué cantidad recibe:

• Stock físico.
• Stock disponible.
• Stock después de reservas.
• Stock agregado de varias bodegas.
• Stock exclusivamente de una bodega ecommerce.

Multialmacén

WooCommerce Core no debería presentarse como un WMS empresarial completo. Cuando hay varias bodegas puede ser necesario que ERP/WMS calcule disponibilidad y entregue a WooCommerce únicamente el valor que debe venderse online.

Qué comprobar

Haz una prueba con compra, cancelación, devolución y reposición.

Cuándo requiere desarrollo

Cuando existen reservas, múltiples bodegas, stocks mínimos, distribuidores o asignación por ubicación.

4. Envía los pedidos al ERP únicamente cuando corresponda

Problema que resuelve: procesar pedidos antes de tiempo.

WooCommerce utiliza estados para representar el ciclo de una orden, incluyendo Pending payment, Processing, On hold, Completed, Cancelled, Failed y Refunded, además de Draft en determinados flujos.

El ERP puede tener estados totalmente diferentes.

Por eso necesitamos un mapeo.

Ejemplo conceptual:

WooCommerce processing
→ ERP “pedido confirmado”.

Pero no es una regla universal.

Algunas empresas crean el pedido ERP apenas llega la orden. Otras esperan confirmación del pago. Algunas necesitan reservar stock inmediatamente y facturar después.

Debemos definir cuándo:

• Crear pedido.
• Reservar inventario.
• Preparar despacho.
• Facturar.
• Cancelar.
• Liberar stock.

Riesgo

Facturar automáticamente órdenes fallidas porque “pedido creado” se interpretó como “venta pagada”.

5. Separa claramente pedido, pago y factura

Esta es probablemente una de las distinciones más importantes.

Pedido

Registro de aquello que el cliente pidió comprar.

Pago

Transacción financiera asociada.

Factura

Documento fiscal/comercial emitido conforme a la normativa aplicable.

No son equivalentes.

Pedido WooCommerce
↓
Pasarela
↓
¿Pago aprobado?

Sí → continuar según reglas.

No → mantener pendiente/fallido/cancelar según proceso.

Ejemplo

El cliente inicia checkout.

WooCommerce crea una orden.

La pasarela rechaza la tarjeta.

Existe pedido, pero no necesariamente debería generarse una factura fiscal definitiva.

También debemos contemplar:

• Pago pendiente.
• Pago aprobado.
• Pago fallido.
• Reembolso parcial.
• Reembolso total.
• Cancelación.

No construyas reglas fiscales tomando únicamente un estado ambiguo de WooCommerce.

6. Integra facturación electrónica conforme al sistema utilizado en Colombia

Problema que resuelve: confundir un PDF visual con facturación electrónica fiscal.

La DIAN reconoce actualmente tres formas generales de operar:

1. Servicio gratuito de facturación de la DIAN.
2. Software desarrollado por el propio facturador.
3. Proveedor tecnológico habilitado.

Una integración típica podría ser:

WooCommerce
→ ERP/software de facturación
→ documento electrónico
→ proceso DIAN

Pero el flujo exacto depende del proveedor, ERP, software, obligaciones del contribuyente y modalidad de operación.

Instalar un plugin que genera un PDF con apariencia de factura no significa automáticamente haber implementado facturación electrónica válida ante la DIAN.

Generar PDF	Facturación electrónica
Documento visual	Proceso fiscal/electrónico
Puede hacerlo WooCommerce o un plugin	Requiere sistema de facturación adecuado
Puede servir como comprobante	Debe cumplir requisitos aplicables
No prueba validación DIAN	Interactúa con el sistema electrónico correspondiente

Esta explicación es técnica, no asesoría tributaria.

7. Utiliza API y webhooks sin generar duplicados

Problema que resuelve: dos pedidos o dos facturas por un mismo evento.

WooCommerce puede enviar webhooks sobre pedidos, productos, clientes y otros recursos. También guarda logs de entregas para facilitar diagnóstico.

Una integración profesional debe ser idempotente.

En lenguaje sencillo:

Si el mismo mensaje es procesado dos veces, el sistema debería reconocer que ya existe y evitar crear otro pedido o factura.

Podemos validar mediante:

• Order ID.
• External ID.
• Transaction ID.
• Invoice ID.

Seguridad

Los webhooks permiten configurar un secreto para validar el mensaje. WooCommerce genera una firma HMAC-SHA256 que el sistema receptor puede verificar.

Las REST API keys también deben respetar mínimo privilegio.

Nunca publiques en JavaScript:

• Consumer Secret.
• Token de ERP.
• Credenciales.
• API keys privadas.

8. Diseña errores, reintentos y conciliación

Problema que resuelve: perder información cuando un sistema falla.

Pregunta fundamental:

¿Qué ocurre si WooCommerce vende y el ERP está caído?

Una integración robusta no debería simplemente descartar el pedido.

Puede necesitar:

Evento
→ cola
→ intento de envío
→ error
→ registro
→ reintento
→ alerta

Después necesitamos conciliación.

Ejemplo:

WooCommerce: 1.250 pedidos
ERP: 1.249

Existe una diferencia.

Otro:

ERP: 25 unidades
WooCommerce: 27

Existe un desajuste.

La conciliación compara ambos lados para encontrar inconsistencias que los flujos automáticos no corrigieron.

No todas las empresas necesitan hacerlo diariamente. La frecuencia depende de volumen y criticidad.

9. Prueba todos los escenarios antes de producción

Problema que resuelve: descubrir errores con pedidos reales.

No basta con probar “un pedido que funciona”.

Prueba al menos:

• Pedido pagado.
• Pago pendiente.
• Pago fallido.
• Cancelación.
• Reembolso.
• Producto simple.
• Variación.
• Cupón.
• Cambio de stock.
• Cambio de precio.
• SKU inexistente.
• ERP sin conexión.
• API lenta.
• Evento repetido.
• Devolución.

Y monitoriza:

• Pedidos enviados.
• Errores.
• Reintentos.
• Pedidos sin equivalente.
• Diferencias de stock.
• Webhooks fallidos.
• Pedidos sin factura cuando corresponda.

Una integración crítica no debería pasar directamente del computador del desarrollador a producción.

Utiliza staging, datos controlados y un plan de reversión.

Flujo conceptual de pedido WooCommerce → ERP

Cliente
↓
WooCommerce
↓
Pasarela de pago
↓
Pedido confirmado según regla comercial
↓
Webhook/API
↓
Integración / middleware
↓
ERP
↓
Inventario
↓
Facturación
↓
Logística
↓
Estado vuelve a WooCommerce

Es un flujo orientativo. Puede variar dependiendo de pasarela, ERP, facturación y logística.

Flujo de stock ERP → WooCommerce

ERP / WMS
↓
Stock disponible
↓
API o middleware
↓
SKU / variación
↓
WooCommerce
↓
Cliente ve disponibilidad

Una regla fundamental:

No actualices un producto solamente porque su nombre se parece al del ERP.

Necesitamos un identificador estable.

¿Quién debería controlar el inventario?

Depende de dónde ocurre realmente la operación.

WooCommerce puede ser suficiente cuando:

• Solo existe ecommerce.
• Catálogo sencillo.
• Una bodega.
• Pocos canales.
• No hay ERP.

ERP/WMS puede ser más apropiado cuando:

• Existe tienda física.
• Hay POS.
• Marketplaces.
• Varias bodegas.
• Mayoristas.
• Importaciones.
• Compras a proveedores.

No existe la regla “el ERP siempre debe controlar stock”.

Sincronización por evento, programada o híbrida

Por evento

Webhook al cambiar algo.

Útil para eventos críticos que necesitan reaccionar rápidamente.

Programada

Sincronización cada cierto intervalo.

Puede funcionar bien para catálogos grandes o información que no exige actualización inmediata.

Híbrida

Evento para pedidos + conciliación programada.

En operaciones complejas suele ser una combinación práctica.

No llamemos “tiempo real” a una sincronización que corre cada cinco minutos.

Plugin vs. desarrollo personalizado

Plugin	Desarrollo personalizado
Implementación rápida	Mayor flexibilidad
Menor inversión inicial	Mayor inversión inicial
Depende del proveedor	Control de lógica
Alcance predeterminado	Adaptado al negocio
Actualizaciones externas	Mantenimiento propio

Un plugin puede ser la mejor decisión cuando existe un conector oficial, está mantenido y soporta exactamente el proceso.

No tiene sentido desarrollar desde cero únicamente para poder decir que el proyecto es “a medida”.

¿Cuándo utilizar middleware?

Middleware es una capa intermedia entre WooCommerce y el ERP.

Puede:

• Recibir datos.
• Transformarlos.
• Mapear campos.
• Reintentar.
• Registrar logs.
• Conectar varios canales.

Ejemplo:

WooCommerce llama al middleware.

El middleware convierte el pedido al formato esperado por ERP.

ERP responde.

El middleware guarda la equivalencia entre Order ID y External ID.

Es especialmente útil cuando el ecommerce y ERP tienen estructuras muy diferentes o cuando además debemos conectar marketplace, POS o logística.

HPOS: un requisito que no deberíamos ignorar en 2026

WooCommerce utiliza High-Performance Order Storage (HPOS) como arquitectura recomendada de pedidos y está activada por defecto en nuevas instalaciones desde WooCommerce 8.2. Utiliza tablas dedicadas para órdenes y APIs CRUD de WooCommerce.

Esto importa porque conectores antiguos pueden asumir que los pedidos siempre viven directamente en wp_posts y wp_postmeta.

Antes de instalar o desarrollar una integración:

verifica compatibilidad con HPOS.

Cuando existe una API oficial de pedidos, debemos preferirla frente a depender de detalles internos de almacenamiento.

Seguridad de una integración WooCommerce–ERP

Una integración empresarial debería considerar:

• HTTPS.
• API keys individuales.
• Mínimo privilegio.
• Secretos fuera del frontend.
• Rotación de credenciales.
• Logs sin credenciales.
• Validación de entradas.
• Webhook secret.
• Backups.
• Staging.

WooCommerce permite API keys con lectura, escritura o ambas, vinculadas a un usuario de WordPress.

Si una integración solo consulta stock, no necesita acceso innecesario para modificar pedidos.

Datos personales

Una sincronización puede transferir:

• Nombre.
• Email.
• Teléfono.
• Dirección.
• Datos del pedido.

La arquitectura debe revisar acceso, finalidad, seguridad, retención y proveedores participantes.

En Colombia, además, deben considerarse las obligaciones de protección de datos personales aplicables al negocio. Esto requiere análisis jurídico independiente cuando corresponda.

Devoluciones y reembolsos

La integración no termina en “pedido pagado”.

También debe contemplar:

• Cancelación.
• Devolución.
• Reembolso total.
• Reembolso parcial.
• Reposición de inventario.
• Nota crédito cuando corresponda.

Reembolsar dinero no implica automáticamente que una unidad vuelva a stock.

El producto podría no haber regresado físicamente, llegar dañado o estar sujeto a inspección.

Facturación electrónica: el plugin no es toda la integración

La DIAN permite operar mediante software gratuito, desarrollo propio o proveedor tecnológico habilitado.

Por ello, antes de contratar un “plugin WooCommerce DIAN”, debemos responder:

• ¿Quién es el facturador?
• ¿Qué sistema genera el documento electrónico?
• ¿Quién lo transmite?
• ¿Cómo se consulta su estado?
• ¿Cómo se manejan notas crédito?
• ¿Qué ocurre con anulaciones o devoluciones?
• ¿Cómo se relaciona factura con pedido?

Un PDF bonito nunca debería ser la única respuesta.

¿Cómo saber si tu ERP puede integrarse?

• Dispone de API.
• Existe documentación técnica.
• Permite consultar productos.
• Expone inventario.
• Permite crear pedidos.
• Gestiona clientes.
• Expone facturación cuando corresponda.
• Tiene autenticación segura.
• Cuenta con ambiente de pruebas.
• Documenta límites de uso.
• Permite webhooks o mecanismo equivalente.
• Tiene soporte técnico.

Si no existe API pueden evaluarse CSV, SFTP, archivos, middleware o acceso controlado a otras interfaces, pero normalmente aumentan las limitaciones y complejidad.

Errores frecuentes al integrar WooCommerce con ERP

Los problemas que más debemos evitar son:

• No definir sistema maestro.
• Utilizar SKU duplicados.
• Identificar productos únicamente por nombre.
• Sincronizar stock físico en vez del disponible.
• Permitir que dos sistemas modifiquen precios.
• Facturar cualquier pedido creado.
• Confundir pedido con pago.
• No mapear estados.
• Depender únicamente del webhook.
• No manejar eventos repetidos.
• Crear facturas duplicadas.
• No guardar errores.
• Reintentar indefinidamente.
• No conciliar datos.
• Ignorar devoluciones.
• Utilizar conectores incompatibles con HPOS.
• Exponer API keys.
• Probar directamente en producción.
• No documentar la integración.

Una integración puede funcionar durante meses y fallar precisamente en el único escenario que nunca se probó: un pago aprobado mientras el ERP estuvo desconectado.

Checklist antes de comenzar una integración

• ERP definido.
• API disponible.
• Documentación revisada.
• Sistema maestro por dato definido.
• SKU normalizados.
• Variaciones identificadas.
• Concepto de stock definido.
• Fuente de precios definida.
• Estados de pedido mapeados.
• Estados de pago mapeados.
• Facturación definida.
• Devoluciones contempladas.
• API keys con mínimo privilegio.
• Webhooks definidos.
• Idempotencia prevista.
• Errores y reintentos diseñados.
• Logs disponibles.
• Conciliación diseñada.
• Compatibilidad HPOS revisada.
• Ambiente de pruebas.
• Responsable técnico definido.

¿Cuándo vale la pena integrar WooCommerce con ERP?

Tiene más sentido cuando:

• Se copian pedidos manualmente.
• Stock se actualiza a mano.
• Hay varios canales.
• Existen varias bodegas.
• Facturación requiere reproceso.
• El catálogo cambia constantemente.
• Hay diferencias frecuentes de inventario.
• El volumen está creciendo.

Puede ser prematuro cuando existe una tienda pequeña, pocos pedidos, inventario simple y ningún ERP.

Automatizar un proceso sencillo puede costar más que ejecutarlo manualmente. La tecnología debe resolver un problema, no crearlo con traje corporativo.

Una tienda profesional debe integrarse con la operación real

Actualmente Codwelt desarrolla tiendas con WordPress y WooCommerce, gestión de productos, inventario, carrito, checkout, medios de pago, diseño responsive, SEO, Analytics y Search Console. También publica que puede evaluar integraciones con facturación, CRM, ERP o transportadoras cuando cada proyecto lo requiere.

Cada integración debe revisarse de forma independiente porque puede requerir API, licencia, plugin, middleware o desarrollo personalizado.

Una buena infraestructura web también necesita hosting, SSL, seguridad y rendimiento. Esos componentes forman parte de los servicios publicados de diseño de páginas web profesionales de Codwelt.

Para proyectos ecommerce, puedes revisar también el servicio de diseño de tiendas virtuales.

Codwelt también dispone de Codi como plataforma empresarial conectable mediante API y webhooks, pero actualmente su documentación aclara que no sustituye inicialmente toda la contabilidad fiscal y puede integrarse con proveedores contables o de facturación electrónica. Por eso no debemos presentarlo como sustituto universal del ERP de inventarios de cualquier ecommerce.

Preguntas frecuentes

Conclusión

Para integrar WooCommerce con ERP de forma profesional debemos resolver nueve cuestiones:

1. Definir el sistema maestro.
2. Normalizar identificadores y SKU.
3. Diseñar correctamente inventario.
4. Mapear pedidos y estados.
5. Separar pedido, pago y factura.
6. Integrar la facturación electrónica adecuada.
7. Diseñar API, webhooks e idempotencia.
8. Gestionar errores, reintentos y conciliación.
9. Probar y monitorizar antes de producción.

Una buena integración no es la que mueve más datos. Es la que mantiene inventario, pedidos, pagos y facturación coherentes incluso cuando alguno de los sistemas falla.

El resultado que buscamos no es simplemente “WooCommerce conectado”. Queremos que el ecommerce funcione como parte de la operación real de la empresa.

Fuentes

• WooCommerce — REST API Documentation. WooCommerce REST API
• WooCommerce Developer Documentation — REST API. WooCommerce Developer REST API
• WooCommerce — Webhooks Documentation. WooCommerce Webhooks
• WooCommerce Developer Documentation — Webhooks and HMAC verification. Working with WooCommerce webhooks
• WooCommerce — Product Editor settings, inventory and SKU. WooCommerce Product Editor settings
• WooCommerce — Product inventory settings. WooCommerce inventory settings
• WooCommerce — Variable products and variation-level inventory. WooCommerce Variable Products
• WooCommerce — Order Statuses. WooCommerce Order Statuses
• WooCommerce — High-Performance Order Storage. WooCommerce HPOS
• DIAN — Cómo puedes facturar electrónicamente. Sistema de Facturación Electrónica DIAN
• DIAN — Ser Facturador Electrónico. Requisitos para facturar electrónicamente
• Codwelt — Diseño de tiendas virtuales y ecommerce. Diseño de tiendas virtuales Codwelt
• Codwelt — Tiendas virtuales en Bogotá e integraciones. Tiendas virtuales en Bogotá
• Codwelt — Diseño de páginas web profesionales. Diseño de páginas web profesionales
• Codwelt — Codi ERP + CRM. Codi ERP + CRM