Conectar Shopware 6 con n8n: pedidos, clientes y stock mediante la Admin API

n8n incluye un icono de node listo para usar para muchas herramientas populares, pero no para Shopware 6. Esto sorprende a primera vista, pero en la práctica no es un obstáculo: Shopware 6 ofrece con la Admin API una interfaz REST completa y bien documentada, a través de la cual puedes leer y escribir pedidos, datos de clientes y niveles de stock. En n8n, esto lo hace el HTTP Request Node genérico, combinado con una credencial OAuth2 para el flujo de Client Credentials de Shopware.

Este artículo te muestra el camino completo: desde la integración en la administración de Shopware, pasando por el inicio de sesión en n8n, hasta consultas concretas para pedidos, clientes y stock. Así mantienes el control total sobre cada solicitud individual, porque nada queda oculto detrás de una caja negra.

Por qué no existe un node nativo de Shopware

n8n mantiene nodes nativos para servicios con una base de usuarios especialmente amplia. Shopware 6 no forma parte de ellos por ahora, lo que en la práctica supone poca diferencia: según la documentación de n8n, el HTTP Request Node está pensado exactamente para este caso, es decir, para consultar datos de cualquier app o servicio con una API REST, incluso sin un node dedicado. Puede usarse tanto como paso regular de un workflow como herramienta para un agente de IA. Para Shopware, esto significa: con unos pocos HTTP Request Nodes construyes tu propia integración, adaptada exactamente a tus procesos, sin esperar a las funciones de un node ya hecho. Los detalles sobre la estructura y las opciones los encuentras en la documentación de n8n sobre el HTTP Request Node.

Configurar el acceso a la Admin API de Shopware

Antes de que n8n pueda consultar algo, necesitas en Shopware una integración con credenciales propias.

• Abre Ajustes > Sistema > Integraciones en la administración de Shopware y crea una nueva integración.
• Activa el interruptor Administrador, de lo contrario la integración no obtendrá permisos suficientes para accesos de escritura.
• Anota el Access Key ID y la Secret Access Key. El secreto solo se muestra una vez.
• Estos dos valores corresponden más adelante al Client ID y al Client Secret en tu credencial de n8n.

Según la documentación oficial, la propia Admin API cubre el acceso estructurado a objetos de negocio centrales como productos, pedidos, clientes y configuraciones, y está pensada exactamente para sincronización de datos, importaciones y comunicación entre sistemas. Un resumen lo ofrece la documentación de Shopware sobre la Admin API.

Guardar la credencial OAuth2 en n8n

Shopware autentica las integraciones mediante el flujo OAuth2 de Client Credentials: tu cliente envía el Access Key ID y la Secret Access Key al endpoint de token y recibe a cambio un token Bearer que, según la documentación, es válido durante diez minutos. Este mismo proceso lo reproduces en n8n con una credencial genérica de OAuth2 API, que seleccionas en el HTTP Request Node.

• Grant Type: Client Credentials
• Access Token URL: `https://tutienda.example/api/oauth/token`
• Client ID: tu Access Key ID
• Client Secret: tu Secret Access Key
• Authentication: según la configuración de Shopware, como Body o Header, en caso de duda prueba primero con Body

Con esta credencial, n8n obtiene automáticamente un nuevo token en cuanto el anterior ha caducado, así que no tienes que preocuparte manualmente por la validez de diez minutos. Qué tipos de autenticación genéricos admite en total el HTTP Request Node, entre ellos Basic Auth, Header Auth y OAuth2, lo describe la documentación de n8n sobre las credenciales de HTTP Request. El proceso exacto de la autenticación por parte de Shopware, incluidos ejemplos de solicitudes contra `/api/oauth/token`, lo encuentras en la guía de Shopware sobre autenticación y solicitudes a la API.

Consultar y procesar pedidos

Para los pedidos usas con mayor frecuencia los endpoints de búsqueda de la Admin API, por ejemplo `POST /api/search/order`. A diferencia de muchas API REST, aquí no envías los criterios de filtrado como parámetros de consulta, sino como un cuerpo JSON con una estructura Criteria.

• Filtra, por ejemplo, por estado del pedido o fecha de creación, para obtener solo pedidos nuevos o abiertos.
• Carga a la vez, mediante `associations`, clientes, posiciones y direcciones de envío, en lugar de consultarlos por separado para cada pedido.
• Controla el conjunto de resultados mediante `limit` y `page`, para que un workflow de n8n no falle por timeouts incluso con muchos pedidos.
• Un Schedule Trigger Node que se ejecuta cada 15 minutos, combinado con esta llamada HTTP Request, es totalmente suficiente para la mayoría de los escenarios de sincronización hacia un CRM o un sistema de gestión de inventario.

Para las empresas que no quieren mantener ellas mismas esta integración, NordFlux también construye este tipo de workflows de sincronización de pedidos como proyecto a precio fijo dentro de la consultoría de n8n.

Mantener sincronizados los datos de clientes

Consultas los datos de clientes de forma análoga mediante `POST /api/search/customer`. Aquí es especialmente útil el filtrado por dirección de correo electrónico o número de cliente, si quieres comprobar si un contacto de otro sistema ya existe en Shopware, antes de crearlo de nuevo mediante `POST /api/customer` o actualizarlo mediante `PATCH`. Asegúrate de distinguir de forma consistente en tus workflows de n8n entre crear y actualizar, por ejemplo con un node IF antes del acceso de escritura propiamente dicho, para no generar registros de clientes duplicados.

Conciliar el stock

Para el stock, lees y escribes el campo `stock` directamente en la entidad de producto mediante `PATCH /api/product/{id}`. Si quieres reflejar en Shopware cambios de stock procedentes de un sistema externo de gestión de inventario, basta con un simple HTTP Request Node con esta ruta. A la inversa, si un nuevo pedido de Shopware debe reducir el stock en un sistema externo, conviene más un disparador basado en eventos que una consulta constante.

Disparador en lugar de consulta constante: eventos de Shopware mediante webhook

Consultar la Admin API de forma regular funciona, pero resulta innecesariamente lento si quieres reaccionar de inmediato a eventos individuales como un nuevo pedido. Shopware ofrece para ello el Flow Builder en la administración: allí eliges un disparador como "Pedido creado", añades una acción de webhook e introduces como URL de destino la dirección de webhook de tu workflow de n8n. Los detalles de configuración están en la documentación de Shopware sobre acciones de webhook en el Flow Builder.

En el lado de n8n, lo recibes con el Webhook Node, que según la documentación admite los métodos HTTP GET, POST, PUT, PATCH, DELETE y HEAD, y distingue entre una URL de prueba para el desarrollo y una URL de producción tras activar el workflow. Así procesas nuevos pedidos, registros de clientes o cambios de estado en el momento en que ocurren, en lugar de darte cuenta de ellos solo en la siguiente consulta programada.

Preguntas frecuentes

¿Existe ya, mientras tanto, un node nativo de Shopware para n8n?

Por ahora no. n8n no cubre Shopware mediante un node propio, por lo que el HTTP Request Node genérico es la vía prevista. Esto no es una solución alternativa de segunda clase, sino el enfoque recomendado por el propio n8n para API REST sin node dedicado.

¿Cómo me conecto con n8n a la Admin API de Shopware?

Creas en Shopware, en Ajustes, Sistema, Integraciones, una integración con permisos de administrador y guardas el Access Key ID y la Secret Access Key como Client ID y Client Secret en una credencial genérica de OAuth2 API en n8n. Como Grant Type eliges Client Credentials, y como URL de token el endpoint `/api/oauth/token` de tu tienda.

¿Con qué frecuencia caduca el token de acceso, y tengo que preocuparme por ello?

Según la documentación de Shopware, el token es válido durante diez minutos. n8n lo renueva automáticamente en segundo plano mediante la credencial OAuth2, en cuanto se fuera a ejecutar una solicitud con un token caducado. Para ti, como creador del workflow, esto no cambia nada en el día a día.

¿Cómo obtengo los datos de pedidos en tiempo real en lugar de mediante consulta constante?

Mediante el Flow Builder de Shopware puedes enviar eventos como un nuevo pedido directamente a una URL de webhook, que un workflow de n8n recibe con el Webhook Node. Esto sustituye el polling regular por notificaciones reales e inmediatas, y al mismo tiempo reduce el número de llamadas a la API.

¿Puedo también escribir niveles de stock con la misma integración, no solo leerlos?

Sí. Con las mismas credenciales y un HTTP Request Node con el método PATCH, puedes actualizar directamente el campo `stock` en la entidad de producto. El requisito es que la integración en Shopware se haya creado con permisos de administrador, ya que los permisos de solo lectura no son suficientes para accesos de escritura.