> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopware 6

> Deja que tu asistente responda preguntas sobre productos y pedidos de tu tienda Shopware 6.

Deja que tu asistente responda preguntas sobre productos y pedidos de tu tienda Shopware 6. Alguien llama y pregunta: «¿Mi pedido 10023 ya está en camino?». El asistente lee el estado del pedido, del pago y del envío en cuanto sabe quién llama. También lee productos con su precio y su stock. Funciona con Shopware 6.4 o posterior y nunca modifica el estado, el pago ni el envío de un pedido. Lo único que escribe es un comentario interno opcional para tu equipo (desactivado por defecto).

## Conectar tu tienda

1. En Shopware, abre **Ajustes → Sistema → Integraciones** y elige **Añadir integración**. Ponle un nombre como «Asistente telefónico» y copia el **ID de la clave de acceso** (empieza por `SWIA`) y la **clave de acceso secreta**. Shopware muestra la clave secreta una sola vez.
2. Dale a la integración un rol con acceso de visualización en el editor de roles de Shopware en **Pedidos**, **Catálogos → Productos**, **Catálogos → Categorías** y **Ajustes → Monedas**. Añade la visualización de la configuración del sistema si quieres que el asistente conozca el nombre de tu tienda. El acceso de escritura a pedido solo hace falta para las [notas de solicitud](#solicitudes-para-tu-equipo).
3. Abre **Agent Tools → Marketplace → Shopware 6**. Introduce la dirección de la tienda, el ID de la clave de acceso y la clave de acceso secreta. Usa una clave de integración, no una contraseña de administrador ni una clave de canal de venta (`SWSC…`).
4. Elige **Agregar**. El inicio de sesión y el acceso de lectura se comprueban antes de guardar la conexión. Después asigna la conexión a tu asistente.

La dirección de la tienda es su dirección HTTPS pública, por ejemplo `https://shop.example.com`. Si pegas la dirección de administración, el asistente quita `/admin`.

## Qué puede hacer el asistente

Activado por defecto:

* Buscar productos activos por nombre y leer precio, stock y si el producto tiene variantes.
* Listar tus categorías de productos para acotar una búsqueda.
* Leer el estado de un pedido, incluidos el pago y el envío, una vez verificada la persona que llama.
* Encontrar los pedidos recientes de quien llama por correo electrónico o por su número de teléfono.

Opcional, se elige en **Editar**:

* Dejar a tu equipo una solicitud de cancelación en un pedido.
* Dejar a tu equipo una solicitud de devolución o cambio en un pedido.

El asistente nunca lee en voz alta números de seguimiento, direcciones ni datos de otros clientes.

## Privacidad de los pedidos

El asistente solo da los detalles de un pedido a la persona a la que pertenece. Necesita una de estas dos pruebas:

* **El número de teléfono.** El número desde el que llama la persona coincide con el teléfono del pedido (dirección de facturación o de entrega). El asistente necesita además el número de pedido.
* **Un segundo dato.** El número de pedido más el correo electrónico del pedido o el código postal de entrega.

Si un dato no coincide, la respuesta es siempre la misma: ningún registro coincide con esos datos. El asistente nunca dice si un pedido existe. Tras tres intentos fallidos en una conversación, deja de comprobar. El número de pedido por sí solo nunca basta.

Si varios clientes usan un mismo número, el número no identifica a quien llama. El asistente pide entonces el número de pedido y el correo electrónico o el código postal de entrega, aunque quien llama dé el número de pedido. Si quien llama oculta su número o no hay número de teléfono (chat web), el asistente pide el segundo dato.

## Estado del pedido, del pago y del envío

El asistente dice cada estado con palabras:

| Parte | Lo que oye quien llama |
| - | - |
| Pedido | recibido, en curso, completado, cancelado |
| Pago | aún sin pagar, pago en curso, pagado, pagado en parte, pago autorizado, pago fallido, recordatorio de pago enviado, reembolsado, reembolsado en parte, pago cancelado, pago aún sin confirmar |
| Envío | aún sin enviar, enviado, enviado en parte, devuelto, devuelto en parte, envío cancelado |

También indica la fecha del pedido, los productos con sus cantidades, el total y el método de envío. Del seguimiento solo dice si existe un número de seguimiento. No lee el número.

## Solicitudes para tu equipo

Las solicitudes de cancelación y de devolución o cambio están desactivadas por defecto. Cuando las activas, el asistente repite el número de pedido y el motivo, espera un sí claro y añade un bloque al **comentario interno** del pedido:

```text theme={null}
CANCELLATION REQUEST (Tu marca)
Reason: Ordered twice by mistake
Identity check: caller phone number matched the order
Callback number: +49 151 2345678
Ref: 3fa91c07
```

No cambia nada más: el estado del pedido sigue igual, no se hace ningún reembolso y no se crea ninguna etiqueta. El asistente pide a Shopware que no ejecute flujos para este cambio, de modo que el cliente no recibe ningún correo. Tu equipo lee el comentario en el pedido y decide.

* Una solicitud de cancelación es posible mientras el pedido esté abierto o en curso y no enviado.
* Una solicitud de devolución o cambio es posible en pedidos completados o enviados.
* Una segunda solicitud del mismo tipo para el mismo pedido no crea una segunda nota.

El rol de la integración necesita acceso de escritura a pedido. El asistente comprueba al conectar que existe el campo del comentario interno. Si tu tienda aún no tiene pedidos, la comprobación no puede ver el campo; conecta de nuevo después del primer pedido.

La nota está escrita en inglés para que tu equipo la lea de forma uniforme. El nombre que aparece es el de tu marca.

## Reconocer a quien llama

En las llamadas telefónicas, el asistente puede saludar por el nombre y conocer el último pedido antes de que la persona diga nada. Shopware guarda los números de teléfono tal como se escribieron. Por eso el asistente busca las últimas seis cifras del número de quien llama y después compara los números con exactitud. Un número guardado con espacios en medio de esas cifras, como `0151 123 45678`, no se encuentra así. La persona puede dar igualmente el número de pedido junto con el correo electrónico o el código postal de entrega.

## Ajustes

El formulario de conexión tiene dos ajustes opcionales:

* **ID del canal de venta:** limita las respuestas sobre productos a los visibles en ese canal de venta. Déjalo vacío para todos los productos activos.
* **Zona horaria de la tienda:** define la zona horaria de las fechas de los pedidos. Vacío significa Europe/Berlin.

Para cambiar más adelante un ajuste, la dirección o las claves, edita la conexión en **Automatizaciones → Conexiones** o elimina la herramienta y vuelve a conectarla.

## Probar con seguridad

Prueba con un producto de prueba y tu propio número de teléfono. Una llamada de prueba lee tu tienda real. Si activaste las notas de solicitud, una prueba escribe una nota real en un pedido real: usa un pedido de prueba y borra la nota después.

## Canales

En las llamadas telefónicas, el asistente conoce el número de quien llama. En canales sin número de teléfono, como el chat web, siempre pide el número de pedido más el correo electrónico o el código postal de entrega.

## Automatizaciones

Conecta **Shopware 6** en **Automatizaciones → Conexiones**, o importa su conexión de Agent Tools. Cada herramienta está disponible como acción. Una automatización iniciada por una llamada o una conversación de texto (SMS, WhatsApp) conoce el número de la otra persona por esa propia llamada. Las demás ejecuciones (webhook, programación) no tienen a nadie que llame: **Estado del pedido** necesita allí por eso el correo electrónico o el código postal de entrega, y **Últimos pedidos de quien llama** responde que el número no está disponible.

## API, MCP, CLI & SDK

`POST /api/v1/tools/integrations/shopware6` · MCP `connect_integration` · CLI `famulor connect-integration shopware6`.

`client.api.connectIntegration` requiere `famulor-sdk` 0.2.12 o posterior. Actualiza la CLI con `npm install --global famulor` antes de usar `connect-integration`.

```bash theme={null}
famulor connect-integration shopware6 --fields "{\"shop_url\":\"https://shop.example.com\",\"access_key_id\":\"SWIA...\",\"secret_access_key\":\"$SHOPWARE_SECRET\"}"
```

```typescript theme={null}
import { Famulor } from 'famulor-sdk';

const client = new Famulor({ apiKey: process.env.FAMULOR_API_KEY });
const { data: tool } = await client.api.connectIntegration({
  path: { provider: 'shopware6' },
  body: {
    fields: {
      shop_url: 'https://shop.example.com',
      access_key_id: 'SWIA...',
      secret_access_key: process.env.SHOPWARE_SECRET,
    },
  },
});
console.log(tool.id);
```

## Solución de problemas

* **La dirección no lleva a la API de administración de Shopware 6:** la tienda es anterior a la 6.4 o la dirección no es correcta. Usa la dirección pública de la tienda, sin `/api`.
* **El rol de la integración no lo permite:** abre la integración en Shopware y añade el acceso de lectura que falta. El mensaje no nombra ninguna entidad; revisa producto, categoría, pedido, dirección del pedido, envío del pedido, transacción del pedido y moneda.
* **Shopware rechazó el ID de la clave de acceso o la clave secreta:** crea una integración nueva e introduce su par de claves. Una clave de canal de venta no funciona.
* **Demasiados inicios de sesión:** Shopware limita los inicios de sesión por integración. Espera unos minutos. El asistente reutiliza su inicio de sesión durante unos nueve minutos.
* **La tienda responde con una página web:** un cortafuegos o un plugin de seguridad bloquea las solicitudes a la API. Permite las solicitudes a `/api/` para la integración.

[Documentación de la API de administración de Shopware](https://developer.shopware.com/docs/concepts/api/admin-api.html)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.