Virheet
Yleisimmät Listano Control MCP -virheet ja niiden korjausohjeet.
Listano Control MCP -työkalut voivat palauttaa virheitä autentikoinnista, käyttöoikeuksista, validoinnista, valmiustarkistuksista tai taustajärjestelmän hakuvirheistä.
Turvallisin korjausmalli on:
- tarkasta virhe
- kutsu
whoami, jos käyttöoikeudet ovat epäselviä - kutsu
get-offering, jos nykyinen luonnoksen tila on epäselvä - korjaa vain tietty virheellinen tai puuttuva data
- kutsu
check-offering-publish-readinessuudelleen ennen julkaisemista
Käyttöoikeusvirheet
Käyttöoikeusvirhe tarkoittaa, että autentikoidulla integraatiolla ei ole vaadittua scopea.
| Toiminto | Vaadittu scope |
|---|---|
| listaus/luku/tarkistus | catalog:read |
| luominen/päivittäminen/kääntäminen/hylkääminen | catalog:write |
| julkaiseminen/lopettaminen | catalog:publish |
Korjaus:
- kutsu
whoami - vahvista myönnetyt scopet
- pyydä puuttuvan scopen myöntämistä
Ei löydy -virheet
Tarjousta ei välttämättä löydy, kun:
offeringIdon väärä- tarjous kuuluu toiselle yritykselle
- integraatio on autentikoitu eri yritykselle
Korjaus:
- kutsu
list-offeringsotsikolla, SKU:lla tai muulla tunnetulla tunnisteella - vahvista valittu tarjous ennen sen muuttamista
Validointivirheet
Validointivirheet tarkoittavat yleensä, että syötteen muoto tai kentän arvo on virheellinen.
Yleisiä syitä:
| Syy | Korjaus |
|---|---|
category_id ilman category_label-kenttää | Anna molemmat kentät. |
| Virheellinen kielikoodi | Käytä get-supported-languages-komentoa. |
| Pääkieli sisällytetty käännöksiin | Poista pääkieli käännöspaketista. |
| Virheellinen yksikkökoodi | Käytä kelvollista 3-merkkistä yksikkökoodia. |
Attribuutilla on unit mutta ei-numeerinen arvo | Käytä numeerista arvoa. |
Attribuutilla on valueLabel mutta ei-merkkijono arvo | Käytä merkkijono arvoa. |
Yritys muuttaa kind- tai language-kenttää | Hylkää luonnos ja luo uusi tarjous. |
Julkaisuvalmiuden virheet
check-offering-publish-readiness palauttaa:
{
offeringId: string
publishable: boolean
errors: unknown[]
}Kun publishable on false, älä kutsu publish-offering-komentoa.
Yleisiä valmiusongelmia:
- puuttuva pääkielinen otsikko, kuvaus tai mittayksikkö
- puuttuvat käännökset tuetuille muille kielille kuin pääkielelle
- puuttuvat käännetyt kategorioiden nimet
- puuttuvat attribuuttikäännökset
- virheellinen attribuutin arvo/yksikkö-yhdistelmä
- puuttuvat käännetyt attribuuttikuvaukset tai arvojen nimet
Korjaus:
- korjaa palautetut virheet
- kutsu
check-offering-publish-readinessuudelleen - julkaise vain, kun
publishableontrue
Luonnoksen elinkaarivirheet
Jos kind tai language on väärä, älä yritä korjata sitä.
Nämä kentät ovat muuttumattomia. Oikea korjauskeino on hylätä luonnos discard-offering-draft-komennolla ja luoda uusi tarjous.
Jos tarjouksella on jo julkaistu nykyinen versio, luonnoksen hylkääminen ei poista live-versiota.
Julkaisuvirheet
publish-offering voi epäonnistua, jos luonnos on puutteellinen tai virheellinen.
Korjaus:
- kutsu
check-offering-publish-readiness - korjaa palautetut virheet
- yritä julkaisemista vasta, kun valmius on hyväksytty
Taustajärjestelmän hakuvirheet
Työkalu voi palauttaa hakuvirheen, kun taustajärjestelmän pyyntö epäonnistuu ennen kuin kelvollinen vastaus on palautettu.
Korjaus:
- yritä samaa vain luku -toimintoa uudelleen tarvittaessa
- vältä mutaatiokutsujen toistamista, ellei nykyistä tilaa ole tarkistettu
get-offering-komennolla - raportoi virheilmoitus, jos virhe jatkuu