Primera consulta gratuita de 15 minutos directamente con nuestros expertos.
La Admin API es la interfaz a través de la cual Shopware 6 se gestiona desde fuera: con ella se pueden leer y escribir productos, stock, pedidos, clientes y configuraciones. Es la vía estándar para conectar la tienda con ERP, PIM, CRM y middleware, también en las tiendas online de España que trabajan con su propio sistema de gestión.
Todo lo que puede hacer en la administración de Shopware 6 también puede hacerlo a través de la Admin API: crear productos, modificar stock, leer pedidos, actualizar clientes o lanzar cambios de estado. La propia administración no es más que un cliente de esta API; cada acción en el backend es una llamada a la API.
Por eso la Admin API es la vía estándar para integrar sistemas de terceros. ERP, PIM, sistemas de gestión de almacén, CRM y middleware se comunican con Shopware a través de esta interfaz, normalmente en segundo plano y sin interacción de usuarios. Está basada en REST, devuelve JSON y da acceso a todas las entidades de la Data Abstraction Layer.
Shopware 6 ofrece dos interfaces que a menudo se confunden:
/api/.sw-access-key, endpoints bajo /store-api/.Regla práctica: lo que hace un empleado en la administración corresponde a la Admin API; lo que hace un cliente en la tienda corresponde a la Store API. Ambas son APIs REST; Shopware no ofrece GraphQL de forma nativa. Las diferencias en detalle se explican en nuestro artículo sobre GraphQL y las APIs REST en Shopware.
El acceso se realiza mediante OAuth 2.0. Para integraciones de sistemas, cree en Configuración → Sistema → Integraciones una integración con su propio rol y obtendrá un ID de clave de acceso y una clave de seguridad. Con ellos solicita un token:
POST /api/oauth/token
{
"grant_type": "client_credentials",
"client_id": "SU_ID_DE_CLAVE_DE_ACCESO",
"client_secret": "SU_CLAVE_DE_SEGURIDAD"
}
El token es válido durante diez minutos y se envía en la cabecera Authorization: Bearer. Para herramientas que actúan en nombre de un usuario existe además el tipo de grant password con refresh token. Asigne a cada integración solo los permisos que necesita el proceso; con los roles ACL el acceso puede limitarse hasta entidades y operaciones concretas. Encontrará más información sobre el protocolo en la entrada OAuth.
GET /api/product, POST /api/product, PATCH /api/product/{id}, DELETE /api/product/{id}, y lo mismo para pedidos, clientes, categorías, medios y el resto de entidades.POST /api/search/product con filtros, ordenación, paginación, agregaciones y asociaciones. Así puede cargar, por ejemplo, todos los pedidos de un día con sus líneas en una sola llamada.POST /api/_action/sync escribe muchos registros de varias entidades en una sola petición. Es la vía correcta para sincronizar stock y precios de miles de artículos./api/_action/order/{id}/state/…), generación de documentos, envío de emails, lanzamiento de la indexación./api/_info/ devuelve la versión, las entidades disponibles y el esquema OpenAPI; la interfaz Swagger en /api/_info/swagger.html documenta todos los endpoints.En una integración típica con un ERP, la Admin API se encarga de estos flujos de datos:
En lugar de consultar periódicamente, puede hacer que Shopware le avise: los webhooks notifican pedidos nuevos o productos modificados, y la integración carga solo lo que ha cambiado. Qué sistemas pueden conectarse así lo muestra nuestra visión general de integraciones con ERP y CRM, y un ejemplo concreto es la guía sobre Xentral y Shopware 6. Para comercios en España, el mismo principio se aplica a otros ERP habituales en el mercado, siempre que ofrezcan una API o un conector.
updatedAt o con webhooks transmite solo las diferencias en lugar de todo el inventario.indexing-behavior: use-queue-indexing la indexación puede trasladarse a la cola.La Admin API es la columna vertebral de cualquier integración con Shopware. Quien entiende su lógica, con OAuth 2.0, búsqueda con criterios, Sync API y State Machine, puede conectar ERP, PIM y CRM de forma fiable. Para integraciones a medida y plugins que amplían la Admin API con endpoints propios, solution25 apoya a los comercios en España con el desarrollo de plugins para Shopware.