Conectar WooCommerce con Odoo: qué preparar antes de sincronizar
Prepara versiones, SKU, variantes, almacenes y estados de pedido antes de elegir cómo conectar WooCommerce con Odoo. Incluye pruebas y recuperación.
Para conectar WooCommerce con Odoo necesitas una correspondencia entre productos, una regla de disponibilidad y un recorrido definido para los pedidos. Instalar un conector antes de acordar estas tres cosas puede trasladar al segundo sistema los problemas que ya existen en el primero.
Esta guía prepara la integración. La instalación depende del conector, la versión de Odoo y el alojamiento; no existe una secuencia de pantallas universal.
1. Identificar versión, alojamiento y acceso
Anota versiones de WooCommerce y Odoo, módulos instalados y dónde se aloja cada aplicación. Un conector debe ser compatible con ese entorno, no solo mostrar el nombre de ambas plataformas.
La documentación de Odoo 19 presenta la API externa JSON-2 y condiciona el acceso a la API externa a los planes Custom dentro de su oferta comercial. Comprueba las condiciones de tu instalación, edición y alojamiento antes de presupuestar una conexión. Una guía de otra versión puede describir otro protocolo.
Prepara un entorno de prueba y un usuario de integración con permisos limitados a las operaciones necesarias. Define quién conserva y rota sus credenciales y qué ocurre al cambiar el proveedor técnico.
2. Relacionar productos y variantes
Un identificador de producto de WooCommerce no es el identificador de Odoo. Hace falta guardar una correspondencia. El SKU puede ayudar si es único, estable y está presente en ambos sistemas; los registros vacíos o repetidos deben corregirse primero.
Cada variante vendible necesita su propia correspondencia. Una camiseta azul de talla M no debe actualizar las existencias de todas las tallas. Documenta también packs, unidades de medida, productos sin inventario y artículos descatalogados.
Prueba con una muestra: producto simple, producto con variantes, referencia duplicada y referencia inexistente. Los dos últimos casos deben terminar en revisión, no en una asociación aproximada por nombre.
3. Decidir qué stock publicar
Define qué almacenes abastecen la tienda y qué significa disponibilidad vendible para tu operación. Cantidad física, reservada y prevista pueden representar situaciones distintas. No asumas que el total del ERP es la cantidad que debería aparecer en la web.
Si hay ventas por otros canales, acuerda cómo se incorporan sus movimientos y cuánto retraso es aceptable. Una actualización periódica deja una ventana entre cambios; un evento también puede retrasarse o fallar. La venta simultánea exige una política explícita de reservas y excepciones.
La prueba debe incluir una venta fuera de WooCommerce, un pedido web, una cancelación y una reposición. Comprueba que la cantidad no se descuenta dos veces por dos automatismos diferentes.
4. Definir precios y datos editoriales
Acuerda quién controla precio base, descuentos, moneda y tarifas por cliente. Conserva en la tienda los campos editoriales que quieras gestionar allí, salvo que hayas decidido sincronizarlos expresamente.
La creación de productos no debería reemplazar fotografías o descripciones por datos vacíos del ERP. Escribe reglas para altas, cambios y descatalogaciones, y prueba qué sucede al editar un mismo campo en ambos sistemas.
5. Mapear el ciclo de un pedido
Un pedido pendiente de pago, uno pagado y uno completado no representan el mismo punto del proceso. Decide cuándo crear el registro de venta en Odoo y quién puede confirmar, preparar, enviar o cancelar después.
Incluye direcciones, descuentos, envío y referencias de pago en el mapeo. Compara totales y moneda con ejemplos controlados. La integración técnica debe seguir las reglas de facturación definidas por la empresa; crear un pedido no equivale a emitir una factura.
Para devoluciones parciales, indica qué líneas cambian, qué documento corresponde y quién autoriza la acción. No reduzcas todo el recorrido a copiar una etiqueta de estado.
6. Elegir conector o desarrollo propio
Un conector mantenido puede encajar si cubre la versión y los flujos necesarios, documenta sus límites y permite observar errores. Revisa soporte, compatibilidad con futuras actualizaciones y acceso a registros antes de adoptarlo.
La API a medida puede servir cuando hay transformaciones específicas, varios almacenes o destinos adicionales. También implica mantener autenticación, compatibilidad, despliegue y supervisión. Consulta la comparación de integración WooCommerce con ERP para evaluar el alcance y el mantenimiento.
7. Comprobar reintentos y reconciliación
Repite el envío de un pedido y comprueba que no se duplica. Simula que el ERP no responde, que un producto no tiene correspondencia y que una credencial deja de funcionar. Cada fallo necesita un estado reconocible y una acción de recuperación.
Los webhooks de WooCommerce pueden notificar cambios, pero la entrega debe comprobarse. Una reconciliación periódica compara referencias del origen con el destino y permite encontrar operaciones omitidas. Define alertas y responsables antes de ampliar el volumen.
Qué debería quedar documentado
- Catálogo: correspondencias de productos y variantes, incluidos casos rechazados.
- Inventario: almacenes, reservas y regla de disponibilidad.
- Pedidos: estados de origen y acciones de destino.
- Recuperación: reintentos, alertas y corrección manual.
- Validación: pruebas realizadas y diferencias pendientes.
Incluye también operaciones no soportadas y el recorrido manual para resolverlas. La documentación debe permitir que otra persona investigue un fallo sin reconstruir la integración desde cero.
Si necesitas preparar este alcance, revisamos la integración de WooCommerce con ERP, la conexión mediante API y la automatización de pedidos. Para otra plataforma, consulta la guía de WooCommerce con Holded.