> ## 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 5

> Laissez votre assistant répondre aux questions sur les produits et le statut des commandes de votre boutique Shopware 5.

Votre assistant lit les prix, les stocks et le statut des commandes de votre boutique Shopware 5. Il ne modifie jamais rien dans la boutique.

> [!WARNING]
>
> Shopware 5 ne reçoit plus de mises à jour de sécurité : le support de sécurité a pris fin le 31 juillet 2024 et la dernière version était la 5.7.20. Préparez votre passage à [Shopware 6](https://docs.famulor.io/fr/automations/shopware6.md). Cette connexion est destinée aux boutiques qui utilisent encore Shopware 5 dans l’intervalle.

## Connecter votre boutique

1. Vérifiez la version. La connexion nécessite Shopware 5.3.2 ou une version ultérieure et a été testée avec la 5.7. Votre boutique doit être accessible en HTTPS depuis Internet.
2. Dans le back-office Shopware, ouvrez **Settings → User administration** (en allemand **Einstellungen → Benutzerverwaltung**), modifiez un utilisateur du back-office et ouvrez **API access**. Activez l’accès API et copiez la clé API.
3. Donnez à cet utilisateur, par son rôle, uniquement des droits de lecture sur les articles et les commandes. L’assistant peut lire tout ce que cet utilisateur peut lire.
4. Dans Famulor, ouvrez **Agent Tools → Marketplace → Shopware 5**. Saisissez l’adresse de la boutique, par exemple `https://shop.example.com` (ajoutez le sous-dossier si la boutique en utilise un), le nom d’utilisateur API et la clé API. Laissez **Fuseau horaire de la boutique** vide pour utiliser `Europe/Berlin`.
5. Choisissez **Ajouter**. La connexion est vérifiée avant l’enregistrement. Associez-la ensuite à votre assistant.

Pour modifier plus tard l’adresse ou les identifiants, supprimez l’outil et reconnectez-le.

## Ce que l’assistant peut faire

Les deux outils sont activés par défaut. Désactivez-les sous **Modifier**.

* **Rechercher des produits :** trouve des produits par nom ou par numéro d’article et indique à l’appelant le prix TTC pour les clients standard, le stock et l’existence de variantes. Si aucun taux de TVA n’est enregistré pour un produit, l’assistant n’annonce pas de prix.
* **Statut de commande :** indique pour une commande le statut, le statut de paiement, le contenu, le total, le mode d’expédition et l’existence d’un numéro de suivi.

Les noms de statut proviennent des statuts de commande et de paiement de votre boutique. Un statut que vous avez créé vous-même est annoncé tel que vous l’avez nommé.

## Confidentialité des commandes

L’appelant indique le numéro de commande. L’assistant demande l’adresse e-mail de la commande ou le code postal de livraison et n’affiche la commande que si elle correspond.

Le numéro de commande seul ne suffit jamais. Une donnée erronée et un numéro de commande inconnu reçoivent la même réponse : personne ne peut savoir si une commande existe. Après trois tentatives erronées pour le même numéro de commande, l’assistant ne vérifie plus cette commande. L’assistant ne lit jamais à voix haute d’adresses, d’adresses e-mail, de numéros de téléphone, de commentaires ni de numéros de suivi.

## Ce qu’il ne fait pas

* Il ne modifie rien : ni commandes, ni statuts, ni notes, ni clients. Des droits de lecture suffisent pour l’utilisateur API.
* Il ne reconnaît pas l’appelant avant le début de la conversation.
* Il ne recherche pas une commande à partir du seul numéro de téléphone.
* Il ne lit pas les numéros de suivi. Il dit seulement s’il en existe un.
* Il ne prend pas en charge l’authentification Digest.

## Tester sans risque

La connexion ne fait que lire : un test ne peut donc rien modifier dans votre boutique. Testez avec l’une de vos commandes : donnez le numéro de commande et l’adresse e-mail de la commande. Vérifiez qu’un code postal erroné reçoit la même réponse qu’un numéro de commande inconnu.

## Canaux

Sur tous les canaux, l’assistant demande l’adresse e-mail ou le code postal de livraison.

## Automatisations

Connectez **Shopware 5** dans **Automatisations → Connexions**, ou importez sa connexion Agent Tools. Les deux outils sont disponibles comme actions. Une automatisation déclenchée par un appel ou une conversation par texte (SMS, WhatsApp) connaît le numéro de l’interlocuteur grâce à cet appel lui-même. Les autres exécutions (webhook, planification) n’ont pas d’appelant : **Statut de commande** y exige donc toujours l’adresse e-mail ou le code postal de livraison.

## API, MCP, CLI & SDK

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

`client.api.connectIntegration` nécessite `famulor-sdk` 0.2.12 ou une version ultérieure. Mettez à jour la CLI avec `npm install --global famulor` avant d’utiliser `connect-integration`.

```bash theme={null}
famulor connect-integration shopware5 --fields '{"shop_url":"https://shop.example.com","api_user":"api-assistant","api_key":"'"$SW5_KEY"'"}'
```

```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: 'shopware5' },
  body: { fields: { shop_url: 'https://shop.example.com', api_user: 'api-assistant', api_key: process.env.SW5_KEY } },
});
console.log(tool.id);
```

## Dépannage

* **« Cela ressemble à une boutique Shopware 6 » :** vous avez saisi l’adresse d’une boutique Shopware 6. Utilisez plutôt la connexion Shopware 6.
* **« Shopware a refusé l’utilisateur API ou la clé » :** vérifiez le nom d’utilisateur et copiez de nouveau la clé API. Assurez-vous que l’accès API est activé pour cet utilisateur.
* **« L’utilisateur API a besoin de droits de lecture sur les articles et les commandes » :** ouvrez le rôle de l’utilisateur API et autorisez la lecture des articles et des commandes.
* **« Cette adresse ne mène pas à l’API Shopware 5 » :** vérifiez l’adresse. Si la boutique est dans un sous-dossier, indiquez-le. N’ajoutez pas `/api`.
* **« La boutique a répondu par une page web au lieu de données » :** un pare-feu, un plugin de sécurité ou une page de maintenance bloque la requête. Autorisez les requêtes vers `/api` pour la connexion.
* **« Cette adresse redirige vers une autre adresse » :** la boutique redirige les visiteurs, par exemple de l’adresse sans www vers celle avec [www](http://www). Saisissez l’adresse réellement utilisée par la boutique.
* **« La boutique a refusé la requête API » :** un pare-feu ou un module de sécurité (par exemple mod\_security) bloque `/api`. Autorisez les requêtes vers `/api` pour la connexion.


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