Conectar WooCommerce: recibir pedidos y enviar fulfillment
Cree una clave de REST API en WooCommerce, pegue la URL de la tienda, la Consumer key y el Consumer secret en Integration, pruebe, mapee y active.
El conector de WooCommerce trae pedidos de su tienda WooCommerce a OMS y devuelve el fulfillment a WooCommerce. También puede enviar productos e inventario, para que los listados y el stock se mantengan sincronizados en ambos lados. Una conexión por tienda: cada tienda tiene su propia Consumer key y Consumer secret.
Requisitos previos#
- Una tienda WooCommerce en WordPress, con acceso de administrador a los ajustes de WooCommerce.
- Permiso para crear claves de REST API en esa tienda (WooCommerce → Ajustes → Avanzado → REST API).
- La URL de su tienda usa https y los enlaces permanentes no están en modo Simple: la REST API no funciona con enlaces permanentes simples.
Obtener credenciales#
- En el panel de su tienda, vaya a WooCommerce → Ajustes → Avanzado → REST API → Añadir clave.
- Seleccione el usuario de la clave, ponga los permisos en Lectura/Escritura (Read/Write) y genere la clave. Se necesita Lectura/Escritura porque el conector no solo trae pedidos, también devuelve fulfillment, productos e inventario.
- Copie la Consumer key. Empieza con ck_.
- En la misma página, copie el Consumer secret. Empieza con cs_ y se muestra una sola vez: guarde ambos valores en un lugar seguro de inmediato.
Completar en Integration#
- Abra Integration → Marketplace → WooCommerce → Nueva conexión.
- URL de la tienda (Store URL), obligatoria: la URL completa de la tienda, incluido https, p. ej. https://www.example.com. Escriba la dirección de la tienda, no la del panel de administración.
- Consumer key, obligatoria: pegue la Consumer key copiada de WooCommerce → Ajustes → Avanzado → REST API (empieza con ck_).
- Consumer secret, obligatorio: pegue el Consumer secret de la misma página (empieza con cs_). Se cifra en reposo y nunca se muestra.
Probar la conexión#
Haga clic en Probar la conexión. La prueba tiene dos niveles: conectividad (la URL de la tienda responde y la Consumer key y el Consumer secret se aceptan) y vista previa a nivel de documento (trae un pedido real y muestra campos de la plataforma → pedido estándar lado a lado). Si la tienda aún no tiene pedidos, haga primero un pedido de prueba en WooCommerce: la vista previa necesita un documento real. Si la prueba falla, anote el error y revise la FAQ antes de cambiar otra cosa.
Mapping / elegir plantilla#
Elija la plantilla estándar de WooCommerce. Mapea número de pedido, SKU de línea, cantidades, dirección de envío y estado de fulfillment. Revise la vista previa con un pedido real antes de activar, sobre todo que cada SKU de WooCommerce esté vinculado a un producto de OMS y que la dirección caiga en el campo correcto.
Activar#
Tras activar, Integration trae pedidos nuevos según la frecuencia definida y devuelve el fulfillment con números de rastreo a WooCommerce. El envío de productos e inventario mantiene listados y stock sincronizados. Vigile los primeros pedidos en Runs / Logs antes de dejarlo sin supervisión.
Preguntas frecuentes#
La prueba falla con 401
La Consumer key o el Consumer secret no coinciden con la tienda, o la clave se creó con permisos de solo lectura. Una copia incorrecta o incompleta se rechaza, y una clave de solo lectura no puede devolver fulfillment, productos ni inventario, así que las escrituras también se rechazan.
Vaya a WooCommerce → Ajustes → Avanzado → REST API, cree una clave nueva con permisos de Lectura/Escritura (Read/Write), copie la nueva Consumer key y el Consumer secret tal cual en Integration y pruebe de nuevo. Al regenerar la clave, los valores antiguos dejan de funcionar, así que actualice la conexión en el mismo paso.
La ruta de la REST API no responde
Los enlaces permanentes de WordPress están en modo Simple. En ese modo las páginas de la tienda siguen abriendo, pero las rutas de la REST API de WooCommerce no funcionan, así que Integration no puede llegar a la API para traer pedidos ni devolver nada.
En WordPress, abra Ajustes → Enlaces permanentes, elija cualquier estructura que no sea Simple, guarde el cambio y vuelva a probar la conexión en Integration.
La URL de la tienda es incorrecta y la prueba no conecta
La URL de la tienda en Integration no apunta a la tienda: lo más frecuente es que falte https://, o que se haya pegado la dirección del panel en lugar de la de la tienda, así que la prueba habla con el lugar equivocado y nunca llega a WooCommerce.
Corrija el campo de URL de la tienda con la dirección completa de la tienda, incluido https, p. ej. https://www.example.com: la dirección que abren los clientes, no la del panel, y pruebe de nuevo.
Conectado pero no llegan pedidos nuevos
La conexión está bien: la tienda simplemente no tiene pedidos nuevos en el rango de extracción, así que aún no hay nada que importar.
Haga un pedido de prueba en su tienda WooCommerce, verifique que su hora esté dentro del rango de extracción, ejecute una extracción manual y confirme que el pedido aparece en la vista previa o en Runs / Logs.