Fouten
Veelvoorkomende Listano Control MCP-fouten en herstelbegeleiding.
Listano Control MCP-tools kunnen fouten retourneren door authenticatie, rechten, validatie, gereedheidscontroles of mislukte backend-verzoeken.
Het veiligste herstelpatroon is:
- de fout inspecteren
whoamiaanroepen als rechten onduidelijk zijnget-offeringaanroepen als de huidige conceptstatus onduidelijk is- alleen de specifieke ongeldige of ontbrekende data herstellen
check-offering-publish-readinessopnieuw aanroepen vóór publicatie
Rechtenfouten
Een rechtenfout betekent dat de geauthenticeerde integratie niet de vereiste scope heeft.
| Bewerking | Vereiste scope |
|---|---|
| weergeven/lezen/controleren | catalog:read |
| aanmaken/bijwerken/vertalen/verwijderen | catalog:write |
| publiceren/stopzetten | catalog:publish |
Herstel:
- roep
whoamiaan - bevestig toegewezen scopes
- vraag om de ontbrekende scope te worden toegewezen
Niet-gevonden fouten
Een aanbod kan niet worden gevonden wanneer:
- de
offeringIdonjuist is - het aanbod bij een ander bedrijf hoort
- de integratie is geauthenticeerd voor een ander bedrijf
Herstel:
- roep
list-offeringsaan met een titel, SKU of andere bekende identifier - bevestig het geselecteerde aanbod vóór het muteren
Validatiefouten
Validatiefouten betekenen doorgaans dat de invoervorm of veldwaarde ongeldig is.
Veelvoorkomende oorzaken:
| Oorzaak | Oplossing |
|---|---|
category_id zonder category_label | Geef beide velden op. |
| Ongeldige taalcode | Gebruik get-supported-languages. |
| Hoofdtaal opgenomen in vertalingen | Verwijder de hoofdtaal uit de vertaalpayload. |
| Ongeldige eenheidscode | Gebruik een geldige 3-teken eenheidscode. |
Attribuut heeft unit maar niet-numerieke waarde | Gebruik een numerieke waarde. |
Attribuut heeft valueLabel maar niet-stringwaarde | Gebruik een stringwaarde. |
Poging om kind of language te wijzigen | Verwijder het concept en maak een nieuw aanbod aan. |
Publicatiegereedheidsfouten
check-offering-publish-readiness retourneert:
{
offeringId: string
publishable: boolean
errors: unknown[]
}Wanneer publishable false is, roep publish-offering niet aan.
Veelvoorkomende gereedheidsproblemen:
- ontbrekende titel, beschrijving of maateenheid in de hoofdtaal
- ontbrekende vertalingen voor ondersteunde niet-hoofdtalen
- ontbrekende vertaalde categorielabels
- ontbrekende attribuutvertalingen
- ongeldige attribuutwaarde/eenheidcombinatie
- ontbrekende vertaalde attribuutbeschrijvingen of waardelabels
Herstel:
- herstel de geretourneerde fouten
- roep
check-offering-publish-readinessopnieuw aan - publiceer alleen wanneer
publishabletrueis
Levenscyclus conceptfouten
Als kind of language onjuist is, probeer het dan niet te patchen.
Deze velden zijn onveranderlijk. Het juiste herstel is het verwijderen van het concept met discard-offering-draft en het aanmaken van een nieuw aanbod.
Als een aanbod al een gepubliceerde huidige versie heeft, verwijdert het verwijderen van het concept de live versie niet.
Publicatiefouten
publish-offering kan mislukken als het concept onvolledig of ongeldig is.
Herstel:
- roep
check-offering-publish-readinessaan - herstel de geretourneerde fouten
- probeer alleen te publiceren nadat gereedheid is geslaagd
Backend-verzoekfouten
Een tool kan een verzoekfout retourneren wanneer het backend-verzoek mislukt voordat een geldige respons is ontvangen.
Herstel:
- probeer dezelfde alleen-lezen bewerking opnieuw indien van toepassing
- vermijd het herhalen van mutatieaanroepen tenzij de huidige staat is gecontroleerd met
get-offering - rapporteer het foutbericht als de fout aanhoudt