Erori
Erori comune Listano Control MCP și ghidare pentru recuperare.
Instrumentele Listano Control MCP pot returna erori din autentificare, permisiuni, validare, verificări de pregătire pentru publicare sau eșecuri de fetch din backend.
Tiparul de recuperare cel mai sigur este:
- inspectează eroarea
- apelează
whoamidacă permisiunile sunt neclare - apelează
get-offeringdacă starea curentă a draft-ului este neclară - corectează doar datele invalide sau lipsă specifice
- apelează din nou
check-offering-publish-readinessînainte de publicare
Erori de permisiuni
O eroare de permisiuni înseamnă că integrarea autentificată nu are scope-ul necesar.
| Operațiune | Scope necesar |
|---|---|
| listare/citire/verificare | catalog:read |
| creare/actualizare/traducere/renunțare | catalog:write |
| publicare/retragere | catalog:publish |
Recuperare:
- apelează
whoami - confirmă scope-urile acordate
- solicită acordarea scope-ului lipsă
Erori de tip „negăsit"
O ofertă poate să nu fie găsită când:
offeringIdeste greșit- oferta aparține altei companii
- integrarea este autentificată pentru o altă companie
Recuperare:
- apelează
list-offeringscu un titlu, SKU sau alt identificator cunoscut - confirmă oferta selectată înainte de a o modifica
Erori de validare
Erorile de validare înseamnă de obicei că forma inputului sau valoarea câmpului este invalidă.
Cauze frecvente:
| Cauză | Remediere |
|---|---|
category_id fără category_label | Furnizează ambele câmpuri. |
| Cod de limbă invalid | Folosește get-supported-languages. |
| Limba principală inclusă în traduceri | Elimină limba principală din payload-ul de traducere. |
| Cod de unitate invalid | Folosește un cod de unitate valid de 3 caractere. |
Atribut cu unit dar valoare non-numerică | Folosește o valoare numerică. |
Atribut cu valueLabel dar valoare non-string | Folosește o valoare string. |
Tentativă de modificare a kind sau language | Renunță la draft și creează o ofertă nouă. |
Erori de pregătire pentru publicare
check-offering-publish-readiness returnează:
{
offeringId: string
publishable: boolean
errors: unknown[]
}Când publishable este false, nu apela publish-offering.
Probleme frecvente de pregătire:
- titlu, descriere sau unitate de măsură lipsă în limba principală
- traduceri lipsă pentru limbile non-principale suportate
- etichete de categorie traduse lipsă
- traduceri ale atributelor lipsă
- combinație invalidă de valoare/unitate a atributului
- descrieri traduse ale atributelor sau etichete de valoare lipsă
Recuperare:
- corectează erorile returnate
- apelează din nou
check-offering-publish-readiness - publică doar când
publishableestetrue
Erori de ciclu de viață al draft-ului
Dacă kind sau language este greșit, nu încerca să îl corectezi prin patch.
Aceste câmpuri sunt imuabile. Recuperarea corectă este să renunți la draft cu discard-offering-draft și să creezi o ofertă nouă.
Dacă o ofertă are deja o versiune curentă publicată, renunțarea la draft nu elimină versiunea activă.
Erori de publicare
publish-offering poate eșua dacă draft-ul este incomplet sau invalid.
Recuperare:
- apelează
check-offering-publish-readiness - corectează erorile returnate
- încearcă publicarea doar după ce pregătirea trece
Eșecuri de fetch din backend
Un instrument poate returna un eșec de fetch când cererea backend eșuează înainte de a primi un răspuns valid.
Recuperare:
- reîncearcă aceeași operație de citire dacă este adecvat
- evită repetarea apelurilor de modificare dacă nu ai verificat mai întâi starea curentă cu
get-offering - raportează mesajul de eroare dacă eșecul persistă