Hub per sviluppatoriStato dell'APISupporto

Domande frequenti sugli errori di SP-API

Domande frequenti sugli errori SP-API.

Suggerimento

Per verificare lo stato corrente di tutte le API SP, fare riferimento alla Dashboard sullo stato delle API. Puoi accedere all'API Health Dashboard in qualsiasi momento selezionando Stato dell'API pulsante nell'angolo in alto a destra del sito di documentazione SP-API.

Errori comuni

Perché sto ricevendo un null valore enum?

Seleziona per espandere la risposta.

Stai utilizzando una versione del modello obsoleta. Aggiorna la versione del modello Swagger nella tua integrazione (ad esempio, rigenera le librerie client) e riprova.

Come posso evitare errori di limitazione?

Seleziona per espandere la risposta.

Nell'SP-API, algoritmo token bucket limita le tariffe di richiesta. Per informazioni su come evitare errori di limitazione, consulta Piani di utilizzo e limiti di tariffa nell'SP-API.

Operazioni in batch

Le seguenti operazioni batch sono disponibili per SP-API:

Per ulteriori informazioni, fare riferimento alla Annuncio del rilascio di SP-API a maggio 2022.

API Notifiche

Questa API invia notifiche invece di dover inviare più richieste ad altre API. Per ulteriori informazioni, consulta la Guida ai casi d'uso dell'API delle notifiche v1.

Limitatore tariffario

Per informazioni su come implementare un limitatore di velocità lato client, consulta Ottimizza i limiti di velocità per i carichi di lavoro delle applicazioni.

Perché ricevo un messaggio "In elaborazione" per la chiamata API Transazioni?

Seleziona per espandere la risposta.

Lo stato della transazione sarà supportato per le seguenti operazioni API:

  • Riconosci l'ordine
  • Invia conferme di spedizione
  • Invia aggiornamenti sullo stato della spedizione
  • Richiesta di etichetta di spedizione
  • Feed dell'inventario

Se lo stato della transazione non è cambiato da Processing a Failure o Success dopo 5 minuti, la transazione non è stata completata correttamente nel nostro sistema. Se lo stato della transazione ha esito positivo, lo stato cambia in Success. Se lo stato della transazione ha esito positivo, lo stato cambia in Failure e ha un codice di errore associato.

Non puoi usare questa API per Invoice messaggi in quanto non è possibile controllarli e lo stato sarà sempre Processing.

Per le richieste di etichette di spedizione, se la transazione non è riuscita con un codice di errore del terminale (ad esempio, Internal server error), devi contattare il team di supporto per gli sviluppatori dell'API di Selling Partner utilizzando il Contattaci modulo di indagine. Ciò accade a causa di vincoli operativi.

Perché ricevo un messaggio di errore per la chiamata operativa "Invia fatture"?

Seleziona per espandere la risposta.

I parametri operativi devono essere compilati correttamente. Considera questi punti quando compili i parametri per effettuare la chiamata API:

  • I numeri delle fatture devono essere univoci e non devono mai essere riutilizzati, nemmeno dopo un anno.
  • Se una fattura inviata dall'API non è andata a buon fine a causa di dati errati ma la fattura cartacea contiene i dati corretti, il fornitore deve aggiornarla tramite API con i dati corretti con lo stesso ID fattura.
  • Se la fattura contiene dati errati (sia cartacei che API), è necessario annullarla e inviarla con un nuovo ID.
  • Nessuna fattura con importo totale 0 deve essere inviato, in quanto ciò causerebbe il fallimento della fattura.
  • Per motivi di conformità fiscale, Amazon richiede l'inserimento dei dettagli dell'indirizzo completi. Ciò è particolarmente importante per il destinatario della fattura. Per questo segmento, il sistema di pagamento di Amazon richiede una corrispondenza esatta.
  • I termini di pagamento inviati in fattura devono corrispondere a quelli concordati con l'acquirente Amazon
  • L'identificativo del prodotto dell'articolo deve corrispondere a quello del prodotto dell'ordine inviato al fornitore nell'ordine di acquisto corrispondente. L'importo totale della fattura deve essere uguale alla somma totale degli articoli, delle spese e delle franchigie.
  • Il totale dell'importo dell'imposta per ogni livello di riga deve essere uguale al totale dell'importo dell'imposta a livello di intestazione.
  • La quantità totale della fattura deve corrispondere alla somma della quantità di tutti gli articoli. Ogni diverso addebito e indennità deve essere dettagliato a livello di intestazione.

Se uno di questi parametri manca o viene compilato in modo errato, la chiamata API recupererà dettagli errati. Assicurati di fornire le informazioni richieste al momento dell'invio dell'operazione.

Perché ricevo un errore SPDC300?

Seleziona per espandere la risposta.

Questo errore può essere causato dall'uso di determinati tag HTML, in particolare i tag di intestazione <h1><h2><h3><h4>. Rimuovi questi tag di intestazione e utilizza solo quelli forniti nell'editor di testo.

Questo errore può anche indicare che lo stato dell'account è passato a inattivo a causa della mancanza di attività. Puoi aggiornare i dati della tua carta di credito per riattivare l'account. La prossima volta che accedi a Seller Central, verrai reindirizzato alla pagina di aggiornamento della carta di credito. Il tuo account verrà ripristinato circa 48 ore dopo l'aggiornamento della carta di credito.

Perché ricevo un errore 500 quando faccio una richiesta per ottenere il token di accesso LWA in Postman?

Seleziona per espandere la risposta.

Se ricevi 500 Internal Server Error, controlla che Content-Type header è impostato su application/x-www-form-urlencoded e i parametri della richiesta vengono aggiunti al corpo e non come parametri di interrogazione.

Perché ricevo un errore 500 quando faccio una richiesta a un endpoint sandbox?

Seleziona per espandere la risposta.

La sandbox SP-API funziona come molti framework simulati, in quanto utilizza la corrispondenza dei modelli per restituire una risposta specificata quando sono presenti i parametri specificati. Uno sviluppatore riceve una risposta definita nell'oggettox-amazon-spds-sandbox-behaviors quando invia una richiesta che corrisponde ai parametri specificati.

Se la richiesta inviata all'endpoint sandbox non corrisponde ai valori dei parametri nell'oggetto x-amazon-spds-sandbox-behaviors, riceverai un messaggio "500 Internal Server Error" nella risposta. È necessario inviare la richiesta con i valori esatti specificati nel modello.

Se l'API richiede parametri non specificati nell'oggetto x-amazon-spds-sandbox-behaviors, la sandbox fornisce la risposta indipendentemente dai valori dei parametri nella richiesta, purché la richiesta sia valida.

Per saperne di più su come effettuare una chiamata sandbox all'API SP, vedi l'argomento Sandbox dell'API per i partner di vendita.

Perché ricevo un codice di errore MD1000?

Seleziona per espandere la risposta.

{{0}} è il processo di autorizzazione che altri venditori avvieranno per autorizzare la tua applicazione nell'Appstore.

Se includi version=beta parameter, il flusso di lavoro autorizza un'applicazione nello stato Bozze. Se non si include il parametro version=beta, il flusso di lavoro autorizzerà una versione pubblicata di quell'ID app sull'Appstore, altrimenti restituirà un codice di errore "MD1000".

Perché ricevo un codice di errore MD1000 all'avvio del flusso di lavoroOAuth?

Seleziona per espandere la risposta.

Se disponi di un'applicazione SP-API non pubblicata ma il flusso di lavoro OAuth fa riferimento al flusso di lavoro di produzione, viene restituito questo errore. Per risolvere il problema, verifica che l'applicazione sia nello stato di bozza. In tal caso, aggiungi il parametro version=beta all'autorizzazione URI OAuth URI di autorizzazione creata. Una volta pubblicata l'applicazione, questo parametro può essere rimosso.

Perché ricevo un codice di errore MD5100?

Seleziona per espandere la risposta.

L'errore MD5100 può essere causato dai seguenti problemi:

  • Errori nell'URL di autorizzazione OAuth.
  • Link di reindirizzamento mancanti nell'applicazione.
  • Frammenti nell'URL.

Prova queste soluzioni per risolvere un errore MD5100:

  • Verifica lo stato dell'applicazione:
  • Se l'applicazione è in stato di bozza, verifica che l'URL includa il parametro version=beta.
  • Se l'applicazione è pubblicata, verifica che l'URL non includa il parametro version=beta. Se il parametro version=beta è incluso nell'URL, viene avviato il processo OAuth per lo stato di bozza dell'applicazione anziché per lo stato pubblicato.
  • Verifica di aver seguito tutti i passaggi per l'Autorizzazione dell'API per i partner di vendita.
  • Verifica che la tua applicazione abbia un URI di accesso e un URI di reindirizzamento. È possibile aggiornare l'URI di accesso e l'URI di reindirizzamento modificando l'applicazione nel Portale per fornitori di soluzioni e aggiornando l'URI di accesso e i dettagli dell'URI di reindirizzamento.
  • Verifica che l'applicazione supporti il marketplace a cui lo sviluppatore è autorizzato. Nel Portale per fornitori di soluzioni, scegli Edit inserisci l'opzione per la tua candidatura e, nella sezione Prezzi, scegli i marketplace che l'applicazione deve supportare.

Se dopo aver esaminato questi dettagli il problema persiste, invia una richiesta di supporto.

Perché ricevo un codice di errore SPDC8143?

Seleziona per espandere la risposta.

Questo errore si verifica quando si tenta di autorizzare un'applicazione come utente secondario. Per evitare questo errore, contatta il proprietario dell'account e chiedigli di eseguire questa azione per te.

Perché viene ancora visualizzata la pagina di autorizzazione MWS anziché la pagina di consenso SP-API all'avvio del flusso di lavoro OAuth?

Seleziona per espandere la risposta.

Controlla se nella tua applicazione mancano l'URI di accesso e l'URI di reindirizzamento. Puoi aggiornare l'URI di accesso e l'URI di reindirizzamento modificando l'app. Passa a Appstore > Develop Apps e scegli Edit App per l'app che stai utilizzando per visualizzare il modulo di registrazione dell'app e aggiornare i dettagli dell'URI di accesso e dell'URI di reindirizzamento.

Perché ricevo un errore quando utilizzo uno SKU con caratteri speciali?

Seleziona per espandere la risposta.

Lo SKU che stai utilizzando potrebbe contenere caratteri speciali, come una barra rovesciate o oblique (\, /), che richiedono la codifica degli URL. Questo può essere fatto in modo programmatico in diverse lingue. Ecco un esempio in Java:

import java.net.URLEncoder; import java.nio.charset.StandardCharsets; import java.io.UnsupportedEncodingException*;* // Method to encode a SKU using the UTF-8 encoding scheme private static String encodeSKU(String sSKU) { try { return URLEncoder.encode(sSKU, StandardCharsets.UTF_8.toString()); } catch (UnsupportedEncodingException ex) { e*.*printStackTrace*();* } }

Per ulteriori informazioni, fare riferimento a Codifica URL.

Ho ricevuto un errore 400, cosa devo fare?

Seleziona per espandere la risposta.

Per ulteriori informazioni, fare riferimento a Risoluzione di 400 errori.

Hai bisogno di ulteriore aiuto?

Per ulteriore assistenza, contatta Supporto agli sviluppatori di API per i partner di vendita.


Questa pagina ti è stata utile?