Errori
Errori comuni di Listano Control MCP e indicazioni per il ripristino.
Gli strumenti di Listano Control MCP possono restituire errori da autenticazione, autorizzazioni, validazione, verifiche di preparazione alla pubblicazione o errori di fetch dal backend.
Il modello di ripristino più sicuro è:
- esaminare l'errore
- chiamare
whoamise le autorizzazioni non sono chiare - chiamare
get-offeringse lo stato attuale della bozza non è chiaro - correggere solo i dati non validi o mancanti specifici
- chiamare di nuovo
check-offering-publish-readinessprima di pubblicare
Errori di autorizzazione
Un errore di autorizzazione significa che l'integrazione autenticata non dispone dello scope richiesto.
| Operazione | Scope richiesto |
|---|---|
| elencare/leggere/verificare | catalog:read |
| creare/aggiornare/tradurre/scartare | catalog:write |
| pubblicare/ritirare | catalog:publish |
Ripristino:
- chiama
whoami - conferma gli scope concessi
- richiedi che venga concesso lo scope mancante
Errori di tipo "non trovato"
Un'offerta potrebbe non essere trovata quando:
- l'
offeringIdè errato - l'offerta appartiene a un'altra azienda
- l'integrazione è autenticata per un'azienda diversa
Ripristino:
- chiama
list-offeringscon un titolo, SKU o altro identificatore noto - conferma l'offerta selezionata prima di modificarla
Errori di validazione
Gli errori di validazione di solito significano che la forma dell'input o il valore di un campo non è valido.
Cause frequenti:
| Causa | Soluzione |
|---|---|
category_id senza category_label | Fornire entrambi i campi. |
| Codice lingua non valido | Usa get-supported-languages. |
| Lingua principale inclusa nelle traduzioni | Rimuovi la lingua principale dal payload di traduzione. |
| Codice unità non valido | Usa un codice unità valido di 3 caratteri. |
Attributo con unit ma valore non numerico | Usa un valore numerico. |
Attributo con valueLabel ma valore non stringa | Usa un valore stringa. |
Tentativo di modificare kind o language | Scarta la bozza e crea una nuova offerta. |
Errori di preparazione alla pubblicazione
check-offering-publish-readiness restituisce:
{
offeringId: string
publishable: boolean
errors: unknown[]
}Quando publishable è false, non chiamare publish-offering.
Problemi di preparazione frequenti:
- titolo, descrizione o unità di misura mancanti nella lingua principale
- traduzioni mancanti per le lingue non principali supportate
- etichette di categoria tradotte mancanti
- traduzioni degli attributi mancanti
- combinazione non valida di valore/unità dell'attributo
- descrizioni degli attributi tradotte o etichette di valore mancanti
Ripristino:
- correggi gli errori restituiti
- chiama di nuovo
check-offering-publish-readiness - pubblica solo quando
publishableètrue
Errori del ciclo di vita della bozza
Se kind o language è errato, non tentare di correggerlo tramite patch.
Questi campi sono immutabili. Il ripristino corretto è scartare la bozza con discard-offering-draft e creare una nuova offerta.
Se un'offerta ha già una versione corrente pubblicata, scartare la bozza non rimuove la versione attiva.
Errori di pubblicazione
publish-offering può fallire se la bozza è incompleta o non valida.
Ripristino:
- chiama
check-offering-publish-readiness - correggi gli errori restituiti
- prova a pubblicare solo dopo che la preparazione ha avuto esito positivo
Errori di fetch dal backend
Uno strumento può restituire un errore di fetch quando la richiesta al backend fallisce prima di ricevere una risposta valida.
Ripristino:
- riprova la stessa operazione di sola lettura se appropriato
- evita di ripetere le chiamate di modifica a meno che non abbia verificato lo stato attuale con
get-offering - segnala il messaggio di errore se il problema persiste