Erreurs
Erreurs courantes de Listano Control MCP et conseils de récupération.
Les outils Listano Control MCP peuvent retourner des erreurs liées à l'authentification, aux permissions, à la validation, aux vérifications de préparation à la publication ou à des échecs de fetch du backend.
Le schéma de récupération le plus sûr est :
- inspecter l'erreur
- appeler
whoamisi les permissions ne sont pas claires - appeler
get-offeringsi l'état actuel du brouillon n'est pas clair - corriger uniquement les données invalides ou manquantes spécifiques
- appeler à nouveau
check-offering-publish-readinessavant de publier
Erreurs de permissions
Une erreur de permissions signifie que l'intégration authentifiée ne dispose pas du scope requis.
| Opération | Scope requis |
|---|---|
| lister/lire/vérifier | catalog:read |
| créer/mettre à jour/traduire/supprimer | catalog:write |
| publier/retirer | catalog:publish |
Récupération :
- appelez
whoami - confirmez les scopes accordés
- demandez que le scope manquant soit accordé
Erreurs de type « non trouvé »
Une offre peut ne pas être trouvée lorsque :
- l'
offeringIdest incorrect - l'offre appartient à une autre entreprise
- l'intégration est authentifiée pour une autre entreprise
Récupération :
- appelez
list-offeringsavec un titre, SKU ou autre identifiant connu - confirmez l'offre sélectionnée avant de la modifier
Erreurs de validation
Les erreurs de validation signifient généralement que la forme de l'entrée ou la valeur d'un champ est invalide.
Causes fréquentes :
| Cause | Solution |
|---|---|
category_id sans category_label | Fournir les deux champs. |
| Code de langue invalide | Utiliser get-supported-languages. |
| Langue principale incluse dans les traductions | Retirer la langue principale du payload de traduction. |
| Code d'unité invalide | Utiliser un code d'unité valide à 3 caractères. |
Attribut avec unit mais valeur non numérique | Utiliser une valeur numérique. |
Attribut avec valueLabel mais valeur non-string | Utiliser une valeur string. |
Tentative de modification de kind ou language | Supprimer le brouillon et créer une nouvelle offre. |
Erreurs de préparation à la publication
check-offering-publish-readiness retourne :
{
offeringId: string
publishable: boolean
errors: unknown[]
}Lorsque publishable est false, ne pas appeler publish-offering.
Problèmes de préparation fréquents :
- titre, description ou unité de mesure manquants dans la langue principale
- traductions manquantes pour les langues non principales prises en charge
- étiquettes de catégorie traduites manquantes
- traductions d'attributs manquantes
- combinaison invalide valeur/unité de l'attribut
- descriptions d'attributs traduites ou étiquettes de valeur manquantes
Récupération :
- corriger les erreurs retournées
- appeler à nouveau
check-offering-publish-readiness - publier uniquement lorsque
publishableesttrue
Erreurs de cycle de vie du brouillon
Si kind ou language est incorrect, ne pas tenter de le corriger via un patch.
Ces champs sont immuables. La récupération correcte consiste à supprimer le brouillon avec discard-offering-draft et créer une nouvelle offre.
Si une offre a déjà une version actuelle publiée, supprimer le brouillon ne retire pas la version active.
Erreurs de publication
publish-offering peut échouer si le brouillon est incomplet ou invalide.
Récupération :
- appeler
check-offering-publish-readiness - corriger les erreurs retournées
- tenter de publier uniquement après que la préparation ait réussi
Échecs de fetch du backend
Un outil peut retourner un échec de fetch lorsque la requête backend échoue avant qu'une réponse valide ne soit reçue.
Récupération :
- réessayer la même opération de lecture seule si approprié
- éviter de répéter les appels de modification à moins d'avoir vérifié l'état actuel avec
get-offering - signaler le message d'erreur si l'échec persiste