Hub per sviluppatoriStato dell'APISupporto

Domande frequenti sulle API delle inserzioni

Frequently asked questions about Listings APIs.

Perché gli articoli vengono visualizzati come soggetti a restrizioni o non possono essere aggiunti?

Seleziona per espandere la risposta.

Gli articoli vengono visualizzati come soggetti a restrizioni se non hai accesso al tipo di prodotto. Se risconti problemi di accesso, richiedi assistenza al tuo vendor manager o tramite Contattaci e assicurati di specificare che il tuo problema è una richiesta API.

Posso modificare il prezzo di costo tramite API?

Seleziona per espandere la risposta.

Gli aumenti di prezzo degli articoli esistenti non sono possibili tramite API. È inoltre necessario verificare le significative riduzioni dei prezzi. In questo caso, contatta il tuo vendor manager o apri un Contattaci caso. Quindi, carica le modifiche ai costi tramite Items > Edit Item Costs.

I valori originali inviati dal fornitore non sono più accettati. Come possiamo effettuare un invio con esito positivo?

Seleziona per espandere la risposta.

In alcuni casi limite, lo schema può essere cambiato rendendo non validi i valori originali inviati da un fornitore. In tal caso, chiedi al fornitore di aprire un caso con il team del Supporto Amazon.

Come faccio ad aggiornare i contenuti A+ premium?

Seleziona per espandere la risposta.

I contenuti A+ premium non sono supportati.

Perché le mie modifiche non sono presenti nella pagina prodotto anche se sembra che siano andate a buon fine?

Seleziona per espandere la risposta.

Le API offrono un metodo alternativo per inviare i dati del catalogo ad Amazon. Il processo downstream e le regole che disciplinano i dati del catalogo sono gli stessi a prescindere dal metodo di invio. In alcuni casi, soprattutto quando è già presente un'offerta per un prodotto, le informazioni inviate da un fornitore potrebbero non avere priorità.

Perché non sono presenti informazioni di riepilogo nella risposta Get dell'API Articoli delle offerte?

Seleziona per espandere la risposta.

La visualizzazione di riepilogo è una sintesi dell'ASIN per il quale stai creando un'offerta. Se la visualizzazione di riepilogo non è popolata, significa che l'invio non è andato a buon fine e non corrisponde a un ASIN. Assicurati di verificare lo schema e il formato del tipo di prodotto e riprova. Se il problema persiste, apri un caso con il Supporto per sviluppatori.

Ho inviato la mia offerta senza alcun problema, ma non la vedo pubblicata.

Seleziona per espandere la risposta.

L'offerta potrebbe aver riscontrato un problema dopo l'invio (un problema asincrono). Per visualizzare tali problemi, usa l'operazione getListingsItem.

Cosa significa il messaggio di errore "Non corrisponde alle tue categorie di prodotto"?

Seleziona per espandere la risposta.

Se ricevi il messaggio "Non corrisponde alle tue categorie di prodotto", l'ASIN è configurato in una categoria di prodotto alla quale il fornitore non ha accesso. Invia un caso in Contattaci tramite Vendor Central segnalando messaggio, ASIN e tipo di prodotto corretto. Apri un caso con il Supporto per sviluppatori se hai bisogno di assistenza tecnica o se indicato nella guida di risoluzione dei problemi.

Cosa significa il messaggio di errore "Non supportato: i seguenti prodotti non possono essere aggiunti"?

Seleziona per espandere la risposta.

Se ricevi il messaggio "Non supportato: i seguenti prodotti non possono essere aggiunti", invia un caso in Contattaci tramite Vendor Central segnalando messaggio e ASIN/ID esterni interessati. Apri un caso con il Supporto per sviluppatori se hai bisogno di assistenza tecnica o se indicato nella guida di risoluzione dei problemi.

Schemi di prodotto

Come faccio a determinare i requisiti di inserzione per pubblicare un nuovo prodotto su Amazon?

Seleziona per espandere la risposta.

Per identificare i requisiti di offerta appropriati, devi prima selezionare il tipo di prodotto corretto. Ciò consentirà ad Amazon di fornire in anticipo tutti i requisiti necessari per le inserzioni. I passaggi seguenti descrivono il processo:

  1. Usa il searchDefinitionsProductTypes operazione per ottenere un elenco dei tipi di prodotto applicabili per i tuoi partner di vendita. Se disponi del titolo di un prodotto, puoi ottenere una raccomandazione altamente affidabile per il tipo di prodotto superando il itemName parametro. Con itemName parametro, puoi combinare il titolo e la descrizione del prodotto per ottenere suggerimenti più granulari sui tipi di prodotto. Puoi anche usare keywords per cercare tra i tipi di prodotto o passare un parametro vuoto per restituire l'intero elenco dei tipi di prodotto disponibili. Per ulteriori informazioni, consulta la Guida ai casi d'uso dell'API v2020-09-01 per le definizioni dei tipi di prodotto.

  2. Dopo aver conosciuto il tipo di prodotto, chiama il getDefinitionsProductType operazione con requirements parametro per recuperare i requisiti per creare una nuova inserzione.

Quando lo schema JSON del tipo di prodotto cambia, la versione dello schema verrà aggiornata?

Seleziona per espandere la risposta.

Sì. La versione dello schema si aggiorna sempre all'ultima versione della definizione del tipo di prodotto Amazon.

Esistono diversi modi per identificare le modifiche tra due versioni dello schema:

Con quale frequenza cambiano i requisiti del catalogo Amazon?

Seleziona per espandere la risposta.

In base ai segnali di ricerca e acquisto dei clienti, Amazon esamina regolarmente gli attributi dei prodotti e pianifica gli aggiornamenti necessari per l'ultima settimana di ogni mese. A volte, Amazon apporta alcuni aggiornamenti prima del rilascio previsto per rispondere al feedback dei clienti e risolvere eventuali difetti o lacune. La maggior parte delle modifiche sono minori e non influiscono sul comportamento dei clienti. Prima di aggiornare qualsiasi attributo per l'invio dell'inserzione, utilizza API per le definizioni dei tipi di prodotto per ottenere lo schema JSON più recente.

Come si usa il $lifecycle attributo nei metadati di definizione del tipo di prodotto nel flusso di lavoro?

Seleziona per espandere la risposta.

Usa il $lifecycle attributo per trovare dettagli sui contenuti obsoleti e sulle azioni da intraprendere. I contenuti obsoleti sono contenuti ancora tecnicamente validi ma che verranno rimossi in futuro. Ad esempio, enumDeprecated elemento del $lifecycle l'attributo elenca i valori di enumerazione obsoleti che dovresti sostituire con i valori più recenti.

Invii di inserzioni

Quali sono i diversi modi per elencare gli articoli in modo programmatico su Amazon?

Seleziona per espandere la risposta.

Puoi pubblicare articoli su Amazon nei seguenti modi:

Per ulteriori informazioni, fare riferimento alla Guida ai flussi di lavoro per la gestione degli elenchi di edifici.

Qual è la differenza tra l'API Catalog Items v2022-04-01 e l'API Listings Items v2021-08-01?

Seleziona per espandere la risposta.

Le API degli elementi del catalogo v2022-04-01 fornisce informazioni a livello di ASIN, che vengono riconciliate tra le varie offerte e l'articolo. Il API per gli articoli per le inserzioni v2021-08-01 fornisce informazioni sull'offerta specifica inviata da un partner di vendita.

I dati restituiti dall'API Catalog Items v2022-04-01 possono differire in base al marketplace?

Seleziona per espandere la risposta.

Sì. La API degli elementi del catalogo v2022-04-01 restituisce i dati associati a un ASIN. Un ASIN rappresenta lo stesso articolo fisico in tutti i marketplace, con poche eccezioni. Tuttavia, i dati per ciascun ASIN variano a seconda del marketplace perché i Paesi hanno requisiti di dati diversi e specifici per quel marketplace.

Inoltre, poiché la maggior parte degli attributi è testo localizzato, il testo può variare a seconda del marketplace o delle impostazioni locali, anche quando il testo descrive lo stesso prodotto. Usa il marketplaceIds filtro nel Definizioni dei tipi di prodotto API v2020-09-01 operazioni per ottenere i requisiti specifici del marketplace per creare o aggiornare i prodotti.

È possibile creare un prodotto su Amazon senza un ASIN o un identificativo del prodotto (UPC, GTIN o EAN) con l'API Listings Items v2021-08-01?

Seleziona per espandere la risposta.

Sì. Se non disponi di un identificativo del prodotto, puoi creare un prodotto con un'esenzione GTIN. Per l'esenzione, devi inviare una richiesta di esenzione manuale tramite il tuo account Seller Central. Per ulteriori informazioni, consulta Seller Central. Dopo aver ricevuto l'approvazione, puoi creare l'invio di offerte tramite API per gli articoli per le inserzioni v2021-08-01. È necessario fornire GENERIC come nome del marchio e imposta il supplier_declared_has_product_identifier_exemption attribuire a true.

Se chiamo patchListingsItem dopo aver chiamato JSON_LISTINGS_FEED, l'aggiornamento del feed JSON sovrascrive la chiamata alla patch??

Seleziona per espandere la risposta.

No. Amazon uses submission timestamps to ensure that updates happen in the correct order.

When you upload a JSON_LISTINGS_FEED with inventory updates, Amazon records the feed submission time as the timestamp for all updates within the feed. If you then initiate an inventory update through the patchListingsItem operation, the system assigns the request submission time as the timestamp for that inventory update. In this scenario, if the patchListingsItem operation gets processed first, then it overrides the data provided in the JSON_LISTINGS_FEED.

Posso inviare un JSON_LISTINGS_FEED con più marketplace?

Seleziona per espandere la risposta.

No. Il JSON_LISTINGS_FEED e API per gli articoli per le inserzioni v2021-08-01 supporta un unico marketplace per feed.

Chi ha la precedenza più alta per sovrascrivere le informazioni sulla pagina dei dettagli del prodotto su Amazon?

Seleziona per espandere la risposta.

I titolari dei marchi hanno la massima precedenza per aggiornare i dati nella pagina dei dettagli del prodotto su Amazon. Se Amazon utilizza i propri dati nella pagina dei dettagli del prodotto, i titolari dei marchi possono sostituirli inviando un ticket all'assistenza di Seller Central.

Come posso convalidare i dati delle mie offerte prima di effettuare una chiamata di produzione?

Seleziona per espandere la risposta.

Before you submit a listing, verify that the attributes of the listing adhere to the JSON schema for the product type. For information about JSON schema validation utilities, refer to Amazon Product Type Definitions Meta-Schema (v1).
After you validate the JSON, you can preview errors before you create or update a listing by using VALIDATION_PREVIEW mode. This mode provides a test environment that checks the values that you provide in the payload for validation errors. VALIDATION_PREVIEW mode synchronously performs the same checks that are done on production submissions, but without persisting to your catalog.

Quando scopro se ci sono problemi con le mie inserzioni?

Seleziona per espandere la risposta.

Amazon esegue più convalide sulle inserzioni inviate dai partner di vendita. Alcune di queste convalide vengono restituite in modo sincrono in risposta agli invii. Se carichi i dati delle inserzioni con API per gli articoli per le inserzioni v2021-08-01 e lo stato dell'invio è ACCEPTED, quindi l'invio ha superato le convalide sincrone. Amazon invia l'invio a valle per creare o aggiornare lo SKU. Esistono diversi processi a valle che vengono poi eseguiti per creare o aggiornare un articolo nel catalogo Amazon. Ognuno di questi processi a valle può generare problemi che vengono restituiti in modo asincrono. Ad esempio, se l'invio di un'offerta contiene dati in conflitto con un altro articolo nel catalogo Amazon. Per creare o aggiornare correttamente gli articoli nel catalogo Amazon, devi gestire i problemi segnalati in modo sincrono e asincrono. Per ulteriori informazioni sui problemi relativi alle inserzioni, consulta Gestione dei problemi relativi agli articoli delle inserzioni e Risoluzione dei problemi relativi all'API di Listings Items.

Come posso confermare la creazione del mio prodotto nel catalogo Amazon?

Seleziona per espandere la risposta.

Amazon invia un LISTINGS_ITEM_STATUS_CHANGE notifica quando lo stato di un elemento dell'inserzione cambia. Una notifica viene pubblicata quando cambia l'acquistabilità di un articolo in offerta o quando viene creata o eliminata un articolo in offerta. Per ricevere una notifica quando viene creata un'inserzione, iscriviti al LISTINGS_ITEM_STATUS_CHANGE notifica. La ListingsItemStatus l'attributo restituito nel payload contiene lo stato corrente associato all'elemento dell'inserzione interessato. Se non è presente alcun valore, lo stato dello stato non è applicabile all'elemento dell'inserzione. Ad esempio, se DISCOVERABLE non è presente, Amazon Retail non può cercare l'articolo dell'inserzione.

Perché c'è un notevole ritardo tra il momento in cui le modifiche a un elemento dell'inserzione si riflettono nel getListingItem risultati dell'operazione rispetto a quando LISTINGS_ITEM_ISSUES_CHANGE e LISTINGS_ITEM_STATUS_CHANGE le notifiche vengono ricevute nella coda SQS?

Seleziona per espandere la risposta.

There can be a delay because the Amazon backend updates every 15 minutes. As a result, every update might be delayed by 0-15 minutes depending on when the update occurred in that window.
For example, a 15-20 minute delay for the LISTINGS_ITEM_ISSUES_CHANGE and LISTINGS_ITEM_STATUS_CHANGE notifications is normal. Our data sources can be up to 15 minutes behind because the data sources rely on many upstream processes to send updates for notifications.

Al contrario, getListingItem L'operazione interroga direttamente lo stato attuale, motivo per cui i risultati sono disponibili più velocemente (entro 1-5 minuti). Per ridurre al minimo gli errori di limitazione, Amazon consiglia di utilizzare le notifiche push per ricevere aggiornamenti in tempo reale sulle modifiche di stato e sui problemi relativi alle offerte.

Dopo aver inviato un prodotto, perché ricevo un errore per gli attributi mancanti che non fanno parte dello schema JSON del tipo di prodotto?

Seleziona per espandere la risposta.

Durante tutta la fase del processo di invio di un'offerta, Amazon valuta l'offerta. Se l'offerta si discosta dal tipo di prodotto selezionato, il tipo di prodotto dell'inserzione passerà al tipo di prodotto consigliato da Amazon. Ciò fa sì che gli attributi del nuovo tipo di prodotto vengano visualizzati come mancanti. Trasmettiamo informazioni su un tipo di prodotto modificato tramite un avviso sull'elenco.

Amazon consiglia di utilizzare searchDefinitionsProductTypes operazione per recuperare un elenco di tutti i tipi di prodotto applicabili. Per recuperare una raccomandazione ad alta affidabilità per il tipo di prodotto corretto con questa operazione, usa itemName parametro.

Cosa devo fare se raggiungo il limite di tariffa con JSON_LISTINGS_FEED?

Seleziona per espandere la risposta.

Con il JSON_LISTINGS_FEED, puoi inviare fino a 10.000 SKU in una singola richiesta ogni 5 minuti. Per evitare problemi di limitazione, invece di inviare feed di piccole dimensioni, invia un feed di grandi dimensioni. Il caricamento di più feed di piccole dimensioni ogni pochi secondi è inefficiente e può comportare un arretrato. Ciò può bloccare l'elaborazione di altri feed e costringerti a cancellare alcuni dei feed inviati in precedenza. Invece di inviare gli stessi dati, invia solo informazioni aggiornate per ridurre il numero di chiamate. Per informazioni su come ottimizzare l'invio dei feed, consulta Le migliori pratiche per l'API dei feed.

Perché l'aggiornamento della mia immagine è stato applicato a livello globale?

Seleziona per espandere la risposta.

Gli attributi dell'immagine forniti da API per gli articoli per le inserzioni v2021-08-01 le operazioni mappano le immagini agli ASIN a livello globale in cui l'ASIN esiste, anche se specifichi marketplace_id selettore. Questo comportamento è coerente con altre esperienze, ad esempio Aggiungi un prodotto all'interno di Seller Central.


Questa pagina ti è stata utile?