Documentazione
Hub per sviluppatoriStato dell'APISupporto
Inizia a digitare per cercare...

Note sulla versione di SP-API

Nuove funzionalità, aggiornamenti software e changelog dell'API per i partner di vendita.

Per le versioni precedenti al 19 gennaio 2022, consulta Annunci sul Repo GitHub dell'API per i partner di vendita.

27 febbraio 2025

Modifiche alla documentazione

Aggiornamento dei metadati del prodotto SP-API

26 febbraio 2025

Modifiche alle API

API di magazzinaggio e distribuzione Amazon v2024-05-09

  • Sono state aggiunte le seguenti operazioni all'API Amazon Warehousing and Distribution (AWD) v2024-05-09:

    • createInbound: Crea una bozza di ordine AWD in entrata con un elenco di pacchi per la spedizione in entrata. L'operazione crea una spedizione per ordine.
    • getInbound: Recupera un ordine AWD in entrata.
    • updateInbound: Aggiorna un ordine AWD in entrata in DRAFT stato e non ancora confermato. Usare questa operazione per aggiornare packagesToInbound, originAddress, e preferences attributi.
    • cancelInbound: Annulla un ordine AWD Inbound e la spedizione associata.
    • confirmInbound: Conferma un ordine AWD in entrata in DRAFT stato.
    • getInboundShipmentLabels: recupera le etichette dei pacchi per un numero di spedizione specificato. Si tratta di un'operazione asincrona. Se lo stato dell'etichetta è GENERATED, quindi l'URL dell'etichetta è disponibile.
    • updateInboundShipmentTransportDetails: aggiorna i dettagli di trasporto per una spedizione AWD.
    • checkInboundEligibility: Determina se i pacchetti specificati sono idonei per un ordine AWD in entrata.

  • È stato aggiunto un tutorial che mostra come creare un ordine in entrata per la spedizione in AWD. Per ulteriori informazioni, consulta Tutorial: Crea un ordine in entrata per la spedizione ad AWD.

API dei feed v2021-06-30
Adempimento in uscita v2020-07-01
  • Aggiunto deliveryWindow al getPackageTrackingDetails risposta. Questa proprietà offre ai venditori una finestra temporale che descrive quando è prevista la consegna di un pacco.
API Report v2021-06-30

  • Aggiunti due nuovi Rapporti di analisi:

    • Rapporto sulle prestazioni del catalogo di ricerca: fornisce metriche sul coinvolgimento della ricerca come impressioni, clic, aggiunte al carrello e acquisti per un intervallo di date specificato.
    • Rapporto sulle prestazioni delle query di ricerca: fornisce le prestazioni complessive delle query, ad esempio impressioni, clic, aggiunte al carrello e acquisti per un determinato ASIN e un intervallo di date specificato.
API per veicoli v2024-11-01
  • È stata aggiunta l'API Vehicles v2024-11-01, che puoi utilizzare per recuperare informazioni sui veicoli, inclusi i loro identificatori univoci. È possibile utilizzare queste informazioni e API per le inserzioni per fornire l'elenco dei veicoli con cui gli ASIN elencati sono compatibili.

Modifiche alla documentazione

  • È stato aggiunto un argomento che elenca i ruoli richiesti per ogni operazione SP-API, tipo di feed, tipo di notifica e tipo di rapporto. È possibile utilizzare queste informazioni per selezionare i ruoli al momento della registrazione come sviluppatore. Per informazioni dettagliate, consulta Mappature dei ruoli.

Avvisi di obsolescenza

Le risorse SP-API obsolete non sono più in fase di sviluppo attivo. Le chiamate a risorse SP-API obsolete avranno esito negativo a partire dalla data di rimozione. Per un elenco completo delle obsolete SP-API, fate riferimento a Pianificazione dell'obsolescenza di SP-API.

Feed

La data di rimozione dei seguenti valori dei tipi di feed è cambiata dal 31 marzo 2025 al 30 giugno 2025.

  • POST_FLAT_FILE_BOOKLOADER_DATA
  • POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA
  • POST_FLAT_FILE_INVLOADER_DATA
  • POST_FLAT_FILE_LISTINGS_DATA
  • POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA
  • POST_INVENTORY_AVAILABILITY_DATA
  • POST_PRODUCT_DATA
  • POST_PRODUCT_IMAGE_DATA
  • POST_PRODUCT_OVERRIDES_DATA
  • POST_PRODUCT_PRICING_DATA
  • POST_PRODUCT_RELATIONSHIP_DATA
  • POST_UIEE_BOOKLOADER_DATA

Per ulteriori informazioni, fare riferimento a Migrazione dei flussi di lavoro dei feed dei prodotti.

29 gennaio 2025

Modifiche alle API

API di magazzinaggio e distribuzione Amazon v2024-05-09
  • Aggiunto il parametro di risposta opzionale replenishmentQuantity al listInventory operazione. Puoi utilizzare questo parametro per esaminare le informazioni sulla quantità delle unità in transito da Amazon Warehousing and Distribution (AWD) a una struttura Fulfillment by Amazon (FBA).
Chiosco dati v2023-11-15
  • Il set di dati Vendor Analytics ora include metriche come sellableInTransitInventory, unsellableInTransitInventory, mostRecentSubmitted, netOrderedGMS, e netShipmentGMS. Puoi utilizzare queste metriche per monitorare la disponibilità dell'inventario, identificare i problemi di evasione degli ordini e comprendere le tue prestazioni di vendita.
API in entrata per l'evasione degli ordini v2024-03-20
  • La risposta del listPackingOptions l'operazione descrive ora i metodi di imballaggio e i pesi delle confezioni accettabili in supportedConfigurations proprietà. Questa proprietà sostituisce la supportedShippingConfigurations proprietà.
API Assegnazione dei prezzi ai prodotti v2022-05-01
  • Aggiunto sampleLocation alla risposta del getCompetitiveSummary funzionamento e richiesta del getFeaturedOfferExpectedPriceBatch operazione. Puoi utilizzare questa metrica per restituire informazioni sulla posizione per le offerte in evidenza e per recuperare il prezzo previsto dell'offerta (FOEP) per una funzionalità specifica per località.
API Report v2021-06-30

Modifiche alla documentazione

Avvisi di obsolescenza

Le risorse SP-API obsolete non sono più in fase di sviluppo attivo. Le chiamate a risorse SP-API obsolete avranno esito negativo a partire dalla data di rimozione. Per un elenco completo delle obsolete SP-API, fate riferimento a Pianificazione dell'obsolescenza di SP-API.

  • La data di rimozione per select API degli elementi del catalogo v0 le operazioni sono cambiate dall'11 dicembre 2024 al 31 marzo 2025. Le operazioni interessate sono:
    • listCatalogItems
    • getCatalogItem

18 dicembre 2024

Modifiche alle API

API di magazzinaggio e distribuzione Amazon v2024-05-09
  • È stata aggiunta la proprietà di scadenza al listInventory e getInboundShipment risposte. Puoi utilizzare questa proprietà per ottenere la data di scadenza di un articolo deperibile nella tua spedizione. Per ulteriori informazioni, consulta Tieni traccia di una spedizione in entrata con i dettagli dello SKU previsto e ricevuto.
  • Aggiunto il prepDetails proprietà al listInventory e getInboundShipment risposte. È possibile utilizzare questa proprietà per ottenere i dettagli sulla preparazione di un articolo, tra cui il proprietario della preparazione, la categoria, le istruzioni e il proprietario dell'etichetta.

API Data Kiosk v2023-11-15

API Articoli delle offerte v2021-08-01

  • Aggiunto il searchListingsItems operazione. Puoi utilizzare questa operazione per restituire informazioni per più elementi delle inserzioni in base a filtri, che includono ID delle inserzioni, problemi, stato e data di creazione.

API di rifornimento v2022-11-07

  • Aggiunto REVENUE_BY_DELIVERIES, SUBSCRIBER_RETENTION, REVENUE_PENETRATION_BY_SELLER_FUNDING, e SHARE_OF_COUPON_SUBSCRIPTIONS metriche per getSellingPartnerMetrics risposta all'operazione. Queste metriche descrivono le fonti di reddito e le prestazioni degli abbonamenti.
  • Aggiunto il SHARE_OF_COUPON_SUBSCRIPTIONS metrica rispetto al listOfferMetrics risposta all'operazione. Questa metrica descrive le prestazioni di acquisizione dei coupon.

API per venditori v1

API di trasferimento v2024-06-01

Questa API è disponibile nella regione UE.

API Spedizione con gestione logistica diretta del fornitore v2021-12-28

  • Aggiunto il createContainerLabel operazione. È possibile utilizzare questa operazione per creare un'etichetta per un contenitore (pallet).

API per le spedizioni dei fornitori v1

  • Le GetShipmentLabels il funzionamento dell'API Vendor Shipments v1 ora supporta la capacità di recuperare le etichette dei piccoli pacchi per i fornitori.

Espansione del Seller Central Marketplace in Irlanda (IE)

Il 10 dicembre 2024, Seller Central ha lanciato il supporto per il Marketplace in Irlanda (IE). Per ulteriori informazioni, consulta il URL di SP-API Seller Central, Endpoint SP-API, e ID del marketplace argomenti nella documentazione SP-API.

Supporto di provider di terze parti per sviluppatori SP-API nel Regno Unito e nell'UE

I venditori nel Regno Unito e nell'UE possono ora autorizzare un fornitore terzo (TPP) ad accedere all'account e ai servizi di pagamento del titolare del conto utilizzando il UN PASSO e PISELLO ruoli.

Per ulteriori informazioni, fare riferimento a Registrazione di fornitori terzi e Domande frequenti sui fornitori di terze parti.

Modifiche alla documentazione

Avvisi di obsolescenza

Le risorse SP-API obsolete non sono più in fase di sviluppo attivo. Le chiamate a risorse SP-API obsolete avranno esito negativo a partire dalla data di rimozione. Per un elenco completo delle obsolete SP-API, fate riferimento a Pianificazione dell'obsolescenza di SP-API.

  • La data di rimozione per select API degli elementi del catalogo v0 le operazioni sono cambiate dall'11 dicembre 2024 al 28 gennaio 2025. Le operazioni interessate sono:

    • listCatalogItems
    • getCatalogItem

  • La data di rimozione del Notifiche valore di tipo LISTINGS_ITEM_ISSUES_CHANGE (versione 1.0 del payload) è cambiato dall'11 dicembre 2024 al 26 marzo 2025.

14 novembre 2024

Modifiche alle API

Spedizione facile v2022-03-23

12 novembre 2024

Modifiche alle API

API Assegnazione dei prezzi ai prodotti v2022-05-01
  • Aggiunto WasPrice al getCompetitiveSummary operazione (nel referencePrices elenco nella risposta all'operazione). WasPrice è il prezzo medio di 90 giorni pagato dai clienti per il prodotto su Amazon. Puoi utilizzare questo valore per impostare promozioni e sconti in base al prezzo tipico nella pagina dei dettagli del prodotto.

11 novembre 2024

Modifiche alle API

API di trasferimento v2024-06-01
  • È stato aggiornato il limite di tariffa per initiatePayout operazione da 0,5 a 0,017 e aggiornata la frequenza di burst da 30 a 2.

6 novembre 2024

Modifiche alle API

API Finances V0
  • Aggiunto il TransactionNumber parametro al AdjustmentItem oggetto. È possibile utilizzare questo parametro per identificare a cosa è correlata la regolazione. Ad esempio, i clienti di Amazon Shipping possono utilizzarlo per ottenere un numero di fattura che possono utilizzare per identificare una fattura Amazon Shipping.
API di evasione ordini in uscita v2020-07-01
  • È stato aggiunto quanto segue al Guida ai casi d'uso dell'API Fulfillment Outbound v2020-07-01:
    • items ora ha limiti di quantità (massimo 100 articoli con un massimo di 250 unità per ordine).
    • shippingSpeedCategory ora ha accordi sui livelli di servizio relativi ai metodi di spedizione che variano in base al marketplace.
    • DeliveryPreferences ora ha la preferenza di consegna predefinita impostata per lasciare il pacco incustodito davanti alla porta principale per gli ordini idonei.
API Merchant Fulfillment v0
  • Aggiornato il getEligibleShippingServices e createShipment operazioni che includeranno nuovi tassi di limitazione aumentati.
API Assegnazione dei prezzi ai prodotti v2022-05-01
  • È stato aggiunto il supporto del marketplace giapponese (JP) per getFeaturedOfferExpectedPriceBatch operazione. Ora puoi recuperare il Featured Offer Expected Price (FOEP) per tutti i marketplace.

Modifiche alla documentazione

Avvisi di obsolescenza

Le risorse SP-API obsolete non sono più in fase di sviluppo attivo. Le chiamate a risorse SP-API obsolete avranno esito negativo a partire dalla data di rimozione. Per ulteriori informazioni sulle date di obsolescenza delle SP-API, fate riferimento a Pianificazione dell'obsolescenza di SP-API.

API

Per ulteriori informazioni, fare riferimento a Migrazione dei flussi di lavoro Fulfillment Inbound.

Feed
  • POST_PRODUCT_DATA
  • POST_INVENTORY_AVAILABILITY_DATA
  • POST_PRODUCT_OVERRIDES_DATA
  • POST_PRODUCT_PRICING_DATA
  • POST_PRODUCT_IMAGE_DATA
  • POST_PRODUCT_RELATIONSHIP_DATA
  • POST_FLAT_FILE_INVLOADER_DATA
  • POST_FLAT_FILE_BOOKLOADER_DATA
  • POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA
  • POST_FLAT_FILE_LISTINGS_DATA
  • POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA
  • POST_UIEE_BOOKLOADER_DATA

Per ulteriori informazioni, fare riferimento a Migrazione dei flussi di lavoro dei feed dei prodotti.

Notifiche
  • LISTING_ITEM_ISSUES_CHANGE payload versione 1.0

14 ottobre 2024

Modifiche alle API

API in entrata per l'evasione degli ordini v2024-03-20
API Notifiche v1
  • Aggiunto il TRANSACTION_UPDATE notifica che viene inviata ogni volta che viene registrata una nuova transazione sull'account del venditore.

Modifiche alla documentazione

25 settembre 2024

Modifiche alle API

API Data Kiosk v2023-11-15
  • Aggiunto GroupByAttributes al analytics_vendorAnalytics_2024_09_30 schema. Questi attributi descrivono in dettaglio il luogo in cui vengono spediti gli articoli:
    • shipToCountryCode
    • shipToCity
    • shipToStateOrProvince
API di inventario FBA v1
  • Aggiornato il GetInventorySummariesResponse per includere un nuovo Stores matrice. Stores contiene un elenco di negozi iscritti al venditore per l'articolo di inventario interessato.
API Notifiche v1
API Pagamenti v0
  • Aggiunto l'opzionale storeName campo a listFinancialEvents risposta. Questo campo fornisce l'archivio in cui è avvenuta la transazione ed è contenuto nei seguenti oggetti:
    • ShipmentEvent
    • PayWithAmazonEvent
    • ServiceFeeEvent
    • RemovalShipmentEvent
API finanziaria v2024-06-19
  • Nuovo API finanziaria v2024-06-19 fornisce informazioni finanziarie rilevanti per l'attività del venditore. Puoi utilizzare questa API per ottenere eventi finanziari per un ordine o un intervallo di date specificato senza dover attendere la chiusura di un periodo contabile.
API per fatture v2024-06-19
API Ordini v0
  • Aggiunto il AmazonPrograms attribuire al getOrderItems risposta. Questo attributo contiene l'elenco dei programmi associati a un elemento, ad esempio Iscriviti e risparmia.

Modifiche alla documentazione

Avvisi di obsolescenza

Le risorse SP-API obsolete non sono più in fase di sviluppo attivo. Le chiamate a risorse SP-API obsolete avranno esito negativo a partire dalla data di rimozione. Per ulteriori informazioni sulle date di obsolescenza delle SP-API, fate riferimento a Pianificazione dell'obsolescenza di SP-API.

API

Per ulteriori informazioni, fare riferimento a Migrazione dei flussi di lavoro Fulfillment Inbound.

Feed
  • POST_PRODUCT_DATA
  • POST_INVENTORY_AVAILABILITY_DATA
  • POST_PRODUCT_OVERRIDES_DATA
  • POST_PRODUCT_PRICING_DATA
  • POST_PRODUCT_IMAGE_DATA
  • POST_PRODUCT_RELATIONSHIP_DATA
  • POST_FLAT_FILE_INVLOADER_DATA
  • POST_FLAT_FILE_BOOKLOADER_DATA
  • POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA
  • POST_FLAT_FILE_LISTINGS_DATA
  • POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA
  • POST_UIEE_BOOKLOADER_DATA

Per ulteriori informazioni, fare riferimento a Migrazione dei flussi di lavoro dei feed dei prodotti.

Notifiche
  • LISTING_ITEM_ISSUES_CHANGE payload versione 1.0

11 settembre 2024

Modifiche alle API

API EasyShip v2022-03-23
API di evasione ordini in uscita v2020-07-01
  • Aggiunto un campo opzionale, deliveryInformation, al GetFulfillmentOrder risposta. Puoi usarlo per ottenere il deliveryDocumentList, che può contenere una foto o una firma per una spedizione in uscita con gestione multicanale consegnata. Puoi usare dropOffLocation per sapere dove è stato consegnato il pacco di spedizione.
API Articoli delle offerte v2021-08-01
API Ordini v0
  • Sono state aggiunte nuove proprietà opzionali dei dettagli di verifica al regulatedInfo operazioni. I venditori possono utilizzare questi dettagli per verificare gli ordini contenenti prescrizioni.
  • Le Guida agli ordini regolamentati include un nuovo tutorial su come fornire ulteriori dettagli sulla verifica di un ordine che contiene informazioni regolamentate.
API Assegnazione dei prezzi ai prodotti v2022-05-01
  • Aggiornato il getFeaturedOfferExpectedPriceBatch non richiedere più offerIdentifier nel FeaturedOfferExpectedPriceResponseBody. Il offerIdentifier il parametro è ora opzionale per deserializzare correttamente getFeaturedOfferExpectedPriceBatch risposte di errore, come FeaturedOfferExpectedPriceResponseBody non fornisce offerIdentifier nella risposta in caso di errori.

Avvisi di obsolescenza

Le risorse SP-API obsolete non sono più in fase di sviluppo attivo. Le chiamate a risorse SP-API obsolete avranno esito negativo a partire dalla data di rimozione. Per ulteriori informazioni sulle date di obsolescenza delle SP-API, fate riferimento a Pianificazione dell'obsolescenza di SP-API.

19 agosto 2024

Modifiche alle API

API di magazzinaggio e distribuzione Amazon v2024-05-09
  • Aggiunto il parametro di risposta opzionale totalInboundQuantity al listInventory operazione. Puoi utilizzare questo parametro per tracciare l'inventario in transito verso Amazon Warehousing and Distribution.
  • Aggiunto un nuovo parametro di richiesta opzionale skuQuantities al getInboundShipment operazione. Puoi utilizzare questo parametro per riconciliare e confrontare l'inventario previsto e ricevuto per ogni SKU di una spedizione.

Ora puoi usare API di magazzinaggio e distribuzione di Amazon a:

  • Tieni traccia dell'inventario in transito verso Amazon Warehousing and Distribution per migliorare la visualizzazione end-to-end dell'inventario.
  • Riconcilia e confronta l'inventario previsto e ricevuto per ogni SKU di una spedizione.

14 agosto 2024

Modifiche alle API

API di idoneità in entrata FBA v1
  • Aggiunto un nuovo valore enumerato di inidoneità in entrata, FBA_INB_0342 nel getItemEligibilityPreview operazione. Questo valore fornisce ulteriori informazioni sul motivo per cui un'offerta non può utilizzare determinati codici a barre del produttore.
API per venditori v1
  • Aggiunto il getAccount operazione per recuperare informazioni sugli account del venditore.
API per gli ordini dei fornitori v1

Modifiche alla documentazione

Avvisi di obsolescenza

Le risorse SP-API obsolete non sono più in fase di sviluppo attivo. Le chiamate a risorse SP-API obsolete avranno esito negativo a partire dalla data di rimozione. Per ulteriori informazioni sulle date di obsolescenza delle SP-API, fate riferimento a tabella delle deprezzazioni.

Le seguenti operazioni nel API degli elementi del catalogo v0 sono stati obsoleti il 30 settembre 2022 e verrà rimosso il 25 settembre 2024:

  • listCatalogItems
  • getCatalogItem

31 luglio 2022

Modifiche alle API

API di evasione ordini in uscita v2020-07-01

  • Aggiunto il queryStartDate parametro al getFeatureInventory operazione. È possibile utilizzare questo parametro per selezionare l'inventario che è stato aggiornato a partire da una data specificata.

  • Le Guida ai casi d'uso dell'API Fulfillment Outbound v2020-07-01 fornisce istruzioni su come superare il queryStartDate parametro per il recupero di un elenco di articoli di inventario idonei per una funzionalità di evasione ordini specificata.

Modifiche alla documentazione

Il blog Selling Partner API verrà rimosso il 31 luglio 2024. Per una guida tecnica sulle API di Selling Partner, consulta la Sito di documentazione SP-API. Per una guida supplementare sulle API dei partner di vendita, consulta Università per sviluppatori.

Avvisi di obsolescenza

Le risorse SP-API obsolete non sono più in fase di sviluppo attivo. Le chiamate a risorse SP-API obsolete avranno esito negativo a partire dalla data di rimozione. Per ulteriori informazioni sulle date di obsolescenza delle SP-API, fate riferimento a tabella delle deprezzazioni.

Le seguenti operazioni nel API degli elementi del catalogo v0 sono stati obsoleti il 30 settembre 2022 e verrà rimosso il 25 settembre 2024:

  • listCatalogItems
  • getCatalogItem

8 luglio 2024

Modifiche alle API

API Merchant Fulfillment v0
  • Aggiunto il Benefits oggetto, che contiene un elenco dei vantaggi Amazon inclusi ed esclusi da un'offerta di servizio di spedizione. Ogni vantaggio escluso ha un elenco di codici di motivo per cui è stato escluso. I vantaggi rappresentano i servizi forniti da Amazon (ad esempio, CLAIMS_PROTECTED per la Garanzia dalla A alla Z) quando i venditori acquistano la spedizione tramite Amazon. I venditori ottengono informazioni dettagliate su cosa comporta l'acquisto di un'etichetta tramite Amazon.

28 giugno 2024

Modifiche alle API

27 giugno 2022

Modifiche alle API

API in entrata per l'evasione degli ordini v2024-03-20

##### API di evasione ordini in uscita v2020-07-01

- Aggiunto il queryStartDate parametro al getFeatureInventory operazione. I venditori possono utilizzare questo parametro per selezionare l'inventario che è stato aggiornato a partire da una data specificata.
- Il Guida ai casi d'uso dell'API Fulfillment Outbound v2020-07-01 fornisce istruzioni su come superare il queryStartDate parametro per il recupero di un elenco di articoli di inventario idonei per una funzionalità di evasione ordini specificata.

##### API Merchant Fulfillment v0

- Aggiunto il Benefits oggetto, che contiene un elenco dei vantaggi Amazon inclusi ed esclusi da un'offerta di servizio di spedizione. Ogni vantaggio escluso ha un elenco di codici di motivo per cui è stato escluso. I vantaggi rappresentano i servizi forniti da Amazon (ad esempio, CLAIMS_PROTECTED per la Garanzia dalla A alla Z) quando i venditori acquistano la spedizione tramite Amazon. I venditori ottengono informazioni dettagliate su cosa comporta l'acquisto di un'etichetta tramite Amazon.

API di trasferimento v2024-06-01

Modifiche alla documentazione

Avvisi di obsolescenza

Le risorse SP-API obsolete non sono più in fase di sviluppo attivo. Le chiamate a risorse SP-API obsolete avranno esito negativo a partire dalla data di rimozione. Per ulteriori informazioni sulle date di obsolescenza delle SP-API, fate riferimento a tabella delle deprezzazioni.

19 giugno 2024

Modifiche alle API

API di magazzinaggio e distribuzione Amazon v2024-05-09
API Data Kiosk v2023-11-05
  • Le API Data Kiosk v2023-11-05 è ora in disponibilità generale.
  • Il nuovo Esempio di soluzione Data Kiosk fornisce tutte le risorse necessarie per implementare un'applicazione SP-API completamente funzionale che automatizzi la creazione e il recupero dei documenti Data Kiosk.
  • Il nuovo Guida al flusso di lavoro di Data Kiosk offre approfondimenti sulle best practice, risponde alle domande più comuni sull'utilizzo delle API e delinea i flussi di lavoro ottimali.
  • Il nuovo Set di dati di Vendor Analytics fornisce i dati dei fornitori su più domini. Puoi aggregare i dati su qualsiasi livello di granularità (ASIN/brand/produzione/data) e accedere a più di 100 metriche relative a vendite, traffico, inventario, previsioni, redditività e nuove metriche geografiche di vendita.
API di inventario FBA v1
API di evasione ordini in uscita v2020-07-01
  • Aggiunto il nuovo deliveryOffers operazione. I venditori possono utilizzare questa operazione per visualizzare le offerte di consegna standard MCF (Multicannel Fulfillment) nelle pagine di pre-checkout. Questa operazione è disponibile solo nel marketplace degli Stati Uniti (USA).
  • Aggiunto il campo opzionale lockerDetails al getFulfillmentOrder risposta. I venditori possono includere le informazioni necessarie per accedere alle scatole di consegna degli armadietti. Questo campo è disponibile solo nel marketplace giapponese (JP).
  • Aggiunto il campo opzionale deliveryPreferences al createFulfillmentOrder richiesta. I venditori possono includere le preferenze di spedizione applicate all'indirizzo di destinazione. Questo campo è disponibile solo nel marketplace giapponese (JP).
  • Sviluppatori che creano o gestiscono applicazioni che si integrano con API di inventario FBA v1 e API di evasione ordini in uscita v2020-07-01 può utilizzare i due ambienti sandbox dinamici per testare le integrazioni del codice tra i domini API FBA e Fulfillment Outbound. Queste sandbox simulano l'evasione degli ordini e i movimenti dell'inventario imitando le risposte di produzione di Amazon. Per ulteriori informazioni, consulta il Guida sandbox dinamica in uscita all'evasione degli ordini.
API Assegnazione dei prezzi ai prodotti v2022-05-01
  • Le getFeaturedOfferExpectedPriceBatch l'operazione è ora disponibile in tutti i marketplace ad eccezione del Giappone (JP). I venditori possono utilizzare questa operazione per ottenere i dati relativi al prezzo previsto dell'offerta (FOEP) in evidenza per un massimo di 40 SKU.
API di rifornimento v2022-11-07
  • Aggiunte le metriche LOST_REVENUE_DUE_TO_OOS, SUBSCRIBER_NON_SUBSCRIBER_AVERAGE_REORDERS, e COUPONS_REVENUE_PENETRATION al getSellingPartnerMetrics risposta all'operazione. Queste metriche descrivono le fonti di entrate e le entrate perse.
  • Aggiunte le metriche LOST_REVENUE_DUE_TO_OOS e COUPONS_REVENUE_PENETRATION al listOfferMetrics risposta all'operazione. Queste metriche descrivono le fonti di entrate e le entrate perse.

Avvisi di obsolescenza

Le risorse SP-API obsolete non sono più in fase di sviluppo attivo. Le chiamate a risorse SP-API obsolete avranno esito negativo a partire dalla data di rimozione. Per ulteriori informazioni sulle date di obsolescenza delle SP-API, fate riferimento a Tabella delle deprecazioni.

4 giugno 2024

Modifiche alle API

API in entrata per l'evasione degli ordini v2024-03-20
  • Nuova funzionalità: Visualizza e seleziona una delle finestre di consegna disponibili affinché una spedizione arrivi presso una struttura Amazon
  • Nuova funzionalità: Stampa etichette per singoli articoli
  • Seleziona Partnered Carrier come opzione per le vostre spedizioni a carico inferiore a un camion (LTL)
  • Aggiornare il nome dei piani e delle spedizioni in entrata
  • Aggiorna la quantità di unità di uno SKU dopo la conferma della spedizione
  • Aggiungi tre nuove operazioni obbligatorie: confirmDeliveryWindowOptions, generateDeliveryWindowOptions, e listDeliveryWindowOptions

Avvisi di obsolescenza

Le risorse SP-API obsolete non sono più in fase di sviluppo attivo. Le chiamate a risorse SP-API obsolete avranno esito negativo a partire dalla data di rimozione. Per ulteriori informazioni sulle date di obsolescenza delle SP-API, fate riferimento a Tabella delle deprecazioni.

Le seguenti operazioni in API in entrata per l'evasione degli ordini v0 non sono più obsoleti:

22 maggio 2024

Modifiche alle API

API Assegnazione dei prezzi ai prodotti v2022-05-01
API Articoli in catalogo v2022-04-01
  • Aggiunto un nuovo includedData opzione del parametro di interrogazione chiamata classifications, che sostituisce il obsoleto MWS GetProductCategoriesForSKU e GetProductCategoriesForASINoperazioni. I venditori e i venditori possono utilizzare classifications per sfogliare gli alberi di classificazione assegnati a un ASIN.
API dei feed v2021-06-30

Avvisi di obsolescenza

Le risorse SP-API obsolete non sono più in fase di sviluppo attivo. Le chiamate a risorse SP-API obsolete avranno esito negativo a partire dalla data di rimozione. Per ulteriori informazioni sulle date di obsolescenza delle SP-API, fate riferimento a Tabella delle deprecazioni.

24 aprile 2024

Modifiche alle API

API Ordini v0

  • Aggiunto il CompanyName attribuire al API per gli ordini v0 API.

  • È stato aggiornato il limite di tariffa per getOrder, getOrderAddress, e getOrderBuyerInfo operazioni da .0167 a .5 e aumentato il burst da 20 a 30.

  • Aggiornato il IsBuyerRequestedCancel, IsGift e NumberOfItems tipi di oggetti da boolean/intero a stringa.

  • Aggiornato il getOrders operazione per restituire il AutomatedCarrier e AutomatedShipMethod attributi.

API Easy Ship v2022-03-23
  • È stata aggiornata la licenza dalla Amazon Software License alla Apache License 2.0.
  • È stato aggiunto il codice HTTP 413 all'elenco delle possibili risposte di ciascuna operazione.

Segnala le modifiche allo schema

Aggiunto il lastUpdatedDate campo per i seguenti report sui fornitori:

Espansione del Vendor Central Marketplace in Irlanda (IE)

Il 23 aprile 2024, Vendor Central ha lanciato il supporto per Ireland (IE) Marketplace. Per ulteriori informazioni, consulta il URL di SP-API Vendor Central, Endpoint SP-API, e ID del Marketplace argomenti nella documentazione SP-API.

Modifiche alla documentazione

  • Le Guida ai casi d'uso di Orders API v0 include nuovi dettagli sull'età degli ordini. Gli ordini risalenti a più di due anni non verranno restituiti nella risposta API. I marketplace di JP, AU e SG sono un'eccezione. In questi marketplace, l'API Orders v0 supporta gli ordini dal 2016 a oggi.

Avvisi di obsolescenza

Le risorse SP-API obsolete non riceveranno più supporto tecnico. Le chiamate a risorse SP-API obsolete avranno esito negativo a partire dalla data di rimozione. Per informazioni più dettagliate sulle date di obsolescenza delle SP-API, fate riferimento a Tabella delle deprecazioni.

API
  • API Spedizione in entrata di gestione logistica v0 (alcune operazioni)
    • createInboundShipmentPlan
    • updateInboundShipment
    • createInboundShipment
    • getPreorderInfo
    • confirmPreorder
    • getTransportDetails
    • putTransportDetails
    • voidTransport
    • estimateTransport
    • confirmTransport
    • getShipments
    • getShipmentItemsByShipmentId
    • getShipmentItems
Feed
  • POST_PRODUCT_DATA
  • POST_INVENTORY_AVAILABILITY_DATA
  • POST_PRODUCT_OVERRIDES_DATA
  • POST_PRODUCT_PRICING_DATA
  • POST_PRODUCT_IMAGE_DATA
  • POST_PRODUCT_RELATIONSHIP_DATA
  • POST_FLAT_FILE_INVLOADER_DATA
  • POST_FLAT_FILE_LISTINGS_DATA
  • POST_FLAT_FILE_BOOKLOADER_DATA
  • POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA
  • POST_FLAT_FILE_LISTINGS_DATA
  • POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA
  • POST_UIEE_BOOKLOADER_DATA
Notifiche
  • LISTING_ITEM_ISSUES_CHANGE payload versione 1.0

1 aprile 2024

Modifiche alle API

Adempimento in entrata v2024-03-20
  • Accesso anticipato alla nuova API Fulfillment Inbound v2024-03-20, che supporta la creazione di spedizioni in entrata FBA e consente di scegliere tra diverse opzioni di servizio di collocamento in entrata, tra le altre funzionalità.

Avvisi di obsolescenza

Le risorse SP-API che annunciano l'obsolescenza non saranno più supportate dopo la data di deprecazione. Le chiamate alle risorse obsolete avranno esito negativo a partire dalla data di rimozione. Per informazioni più dettagliate sulle date di obsolescenza delle SP-API, consultate Tabella delle deprecazioni.

API
  • API Spedizione in entrata di gestione logistica v0 (alcune operazioni)
    • createInboundShipmentPlan
    • updateInboundShipment
    • createInboundShipment
    • getPreorderInfo
    • confirmPreorder
    • getTransportDetails
    • putTransportDetails
    • voidTransport
    • estimateTransport
    • confirmTransport
    • getShipments
    • getShipmentItemsByShipmentId
    • getShipmentItems

20 marzo 2024

Modifiche alle API

API Spedizione v2
API Merchant Fulfillment v0
  • Aggiunti gli attributi Dangerous Goods LiquidVolume, IsHazmat, e DangerousGoodsDetails all'oggetto Item.
API Report v2021-06-30
API Notifiche v1
  • Aggiornato FEED_PROCESSING_FINISHED e REPORT_PROCESSING_FINISHED per includere il supporto per i fornitori. Entrambe le notifiche includono una nuova accountId proprietà, che identifica il partner di vendita per conto del quale è stato inviato il feed o la segnalazione. Questa modifica si applica a tutti i marketplace.
Adempimento in uscita v2020-07-01

Modifiche alla documentazione

Avvisi di obsolescenza

Le risorse SP-API obsolete non sono più in fase di sviluppo attivo. Le chiamate a risorse SP-API obsolete avranno esito negativo a partire dalla data di rimozione. Per informazioni più dettagliate sulle date di obsolescenza delle SP-API, fate riferimento a Tabella delle deprecazioni.

API
  • API Autorizzazione v1 (tutte le operazioni)
  • API Prodotti piccoli e leggeri di Logistica di Amazon v1 (tutte le operazioni)
  • API Spedizione in entrata di gestione logistica v0 (alcune operazioni)
    • getInboundGuidance
Feed
  • POST_PRODUCT_DATA
  • POST_INVENTORY_AVAILABILITY_DATA
  • POST_PRODUCT_OVERRIDES_DATA
  • POST_PRODUCT_PRICING_DATA
  • POST_PRODUCT_IMAGE_DATA
  • POST_PRODUCT_RELATIONSHIP_DATA
  • POST_FLAT_FILE_INVLOADER_DATA
  • POST_FLAT_FILE_LISTINGS_DATA
  • POST_FLAT_FILE_BOOKLOADER_DATA
  • POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA
  • POST_FLAT_FILE_LISTINGS_DATA
  • POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA
  • POST_UIEE_BOOKLOADER_DATA
  • POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN
  • POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN
  • RFQ_UPLOAD_FEED
Report
  • GET_PRODUCT_EXCHANGE_DATA
  • GET_FBA_UNO_INVENTORY_DATA
Notifiche
  • MFN_ORDER_STATUS_CHANGE
  • LISTING_ITEM_ISSUES_CHANGE payload versione 1.0

21 febbraio 2024

Modifiche alle API

API Report v2021-06-30
  • Aggiunto un nuovo valore per il tipo di report Report sui dati dell'utente finale fornisce dati personali sui clienti, tra cui informazioni di contatto, Glance View e Orderdata per i clienti che hanno scelto di condividere questi dati con il venditore al momento di completare una transazione nei marketplace DE, FR, IT, ES, NL, PL, SE e BE (EU-8).
Application Management API
  • Ha promosso l'API di gestione delle applicazioni v2023-11-30 dalla beta pubblica alla produzione. Questa API consente di ruotare in modo programmatico le credenziali di accesso con Amazon (LWA) (segreti del cliente).

Aggiornamenti della documentazione

  • Sono stati aggiunti sei nuovi tutorial sul codice che descrivono in dettaglio come eseguire varie attività come visualizzare in anteprima gli ordini, creare ordini e annullare gli ordini. Li trovi nella Esempi di codice sezione.

Avvisi di obsolescenza

Le risorse SP-API che annunciano l'obsolescenza non saranno più supportate dopo la data di deprecazione. Le chiamate alle risorse obsolete avranno esito negativo a partire dalla data di rimozione. Per informazioni più dettagliate sulle date di obsolescenza delle SP-API, consultate Tabella delle deprecazioni.

Feed
  • POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN
  • POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN
  • RFQ_UPLOAD_FEED
Report
  • GET_PRODUCT_EXCHANGE_DATA
  • GET_FBA_UNO_INVENTORY_DATA
Notifiche
  • MFN_ORDER_STATUS_CHANGE

31 gennaio 2024

Modifiche alle API

API Articoli delle offerte v2021-08-01
  • È stata aggiunta una nuova modalità di convalida per le operazioni putListingsItem e patchListingsItem. Usa il parametro della query mode=VALIDATION_PREVIEW per convalidare un articolo dell'offerta senza mantenere i dati nel catalogo. Questa funzionalità consente di visualizzare in anteprima gli errori delle offerte in un ambiente di produzione, senza crearle.
API Spedizione in entrata di gestione logistica v0
  • È stato aggiunto il valore ShipsInProductPackaging per l'enumerazione PrepInstruction. PrepInstructionList viene restituito nella risposta per le chiamate a prepInstructions.
API Ordini v0
  • Sono stati aggiunti gli oggetti ExtendedFields e AddressExtendedFields. Sono disponibili solo per gli indirizzi di spedizione del Brasile e vengono restituiti nelle risposte che contengono campi estesi.

Avvisi di obsolescenza

Le risorse SP-API che annunciano l'obsolescenza non saranno più supportate dopo la data di deprecazione. Le chiamate alle risorse obsolete avranno esito negativo a partire dalla data di rimozione. Per informazioni più dettagliate sulle date di obsolescenza delle SP-API, consultate Tabella delle deprecazioni.

API
  • API Autorizzazione v1 (tutte le operazioni)
  • API Prodotti piccoli e leggeri di Logistica di Amazon v1 (tutte le operazioni)

Feed

  • POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN
  • POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN
  • RFQ_UPLOAD_FEED

Report

  • GET_FBA_UNO_INVENTORY_DATA
  • GET_PRODUCT_EXCHANGE_DATA

13 dicembre 2023

Modifiche alle API

Beta pubblica dell'API Gestione delle applicazioni v2023-11-30
  • La nuova API Gestione delle applicazioni consente di ruotare le credenziali Accedi con Amazon (segreti client) a livello di programmazione. È disponibile in versione beta pubblica.
API Spedizione v2
  • È stato introdotto il supporto per la spedizione di merci pericolose nei marketplace degli Stati Uniti e del Regno Unito.
API Articoli delle offerte v2021-08-01
  • È stato aggiunto il supporto per il marketplace dell'India
  • Sono stati aggiunti due nuovi campi all'oggetto Issue: Enforcements e Categories
API Definizioni dei tipi di prodotto v2020-09-01
  • Il tipo di operazione searchDefinitionsProductTypes è stato aggiornato in stringa
API Notifiche v1

Aggiornamenti della documentazione

La Guida ai casi d'uso dell'API Ordini di gestione logistica diretta per i fornitori v1 è stata aggiornata per includere una sezione relativa alla trasmissione dei dati dei clienti con gestione logistica diretta. Per le spedizioni gestite tramite le operazioni getOrder e getOrders, i fornitori non ricevono determinati dati dei clienti, come nome, indirizzo o numero di telefono. Per i fornitori che utilizzano solo l'etichetta Amazon, alcuni campi verranno sostituiti con il valore fittizio XXXXX.

La Guida ai casi d'uso delle API Acquisti al dettaglio presso i fornitori v1 è stata aggiornata per includere informazioni sull'utilizzo delle operazioni SubmitShipments e GetShipmentDetails.

GET_FBA_FULFILLMENT_LONGTERM_STORAGE_FEE_CHARGES_DATA ora include nomi di colonna aggiornati. È stata aggiunta una nota che indica come generare correttamente il report. Tale nota è disponibile nel report delle modifiche alla tariffa di stoccaggio a lungo termine della pagina Valori del tipo di report sulla Logistica di Amazon.

Il report sulle fatture in blocco di Logistica di Amazon (FBA_BULK_INVOICE) condivide le fatture di un venditore entro l'intervallo di date specificato. Queste fatture includono gli ordini dei clienti evasi dal venditore.

Avvisi di obsolescenza

Le risorse SP-API che annunciano l'obsolescenza non saranno più supportate dopo la data di deprecazione. Le chiamate alle risorse obsolete avranno esito negativo a partire dalla data di rimozione. Per informazioni più dettagliate sulle date di obsolescenza delle SP-API, consultate Tabella delle deprecazioni.

API
  • API Autorizzazione v1 (tutte le operazioni)
  • API Prodotti piccoli e leggeri di Logistica di Amazon v1 (tutte le operazioni)
  • API Spedizione in entrata di gestione logistica v0 (alcune operazioni)
    • getInboundGuidance
  • API Gestito dal venditore v0 (alcune operazioni)
    • getEligibleShipmentServicesOld
    • cancelShipmentOld
    • getAdditionalSellerInputsOld
Feed
  • POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN
  • POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN
  • RFQ_UPLOAD_FEED
Report
  • GET_FBA_UNO_INVENTORY_DATA
  • GET_PRODUCT_EXCHANGE_DATA
Notifiche
  • ORDER_STATUS_CHANGE

8 novembre 2023

Modifiche alle API

API Origini di approvvigionamento v2020-07-01
  • La nuova API Origini di approvvigionamento configura e aggiorna le informazioni sulle origini di approvvigionamento dei venditori, come negozi e magazzini.
API Assegnazione dei prezzi ai prodotti v2022-05-01
  • Il Regno Unito è ora un mercato valido.
  • getFeaturedOfferExpectedPriceBatch(FOEP) è stato esteso a Amazon.co.uk.
  • ASIN_NOT_ELIGIBLE è ora un valore per resultStatus.
  • La nuova operazione competitiveSummary restituisce la risposta riassuntiva della concorrenza che include le opzioni di acquisto in evidenza per l'ASIN e la combinazione marketplaceId .
API Definizioni dei tipi di prodotto v2020-09-01
  • Aggiornato per tre nuovi parametri (itemName, locale e searchlocale) e un nuovo tipo di prodotto displayName
API Pagamenti v0
  • ListFinancialEvent aggiornato e le operazioni ListFinancialEventGroups comunicano in modo più chiaro le risposte e l'ambito previsti. La risposta per ChangeRefundTransactions è stata modificata da oggetto ad array.
API Spedizione di gestione logistica diretta per i fornitori v2021-12-28 e v1
  • Il campo weight aggiornato è ora obbligatorio. Questa modifica genererà un errore durante la chiamata a shipmentconfirmations in modo che i fornitori non debbano attendere un errore durante lo stato della transazione.

Aggiornamenti della documentazione

  • La nuova Guida all'integrazione dell'inventario multisede (MLI) fornisce consulenza ai partner di vendita sulle API e sulle operazioni obbligatorie per l'integrazione con l'inventario multisede, che consente ai venditori con più sedi di fornire ad Amazon dati a livello di ciascuna sede relativi al loro inventario e le loro effettive capacità di gestione logistica.
  • La Guida alla creazione di flussi di lavoro di gestione delle offerte aggiornata ora include i passaggi per recuperare una raccomandazione utilizzando itemName o keywords nel flusso di lavoro Elenca un articolo che non esiste già nel catalogo Amazon.

Avvisi di obsolescenza

Le risorse SP-API che annunciano l'obsolescenza non saranno più supportate dopo la data di deprecazione. Le chiamate alle risorse obsolete avranno esito negativo a partire dalla data di rimozione. Per informazioni più dettagliate sulle date di obsolescenza delle SP-API, consultate Tabella delle deprecazioni.

API
  • API Autorizzazione v1 (tutte le operazioni)
  • API Prodotti piccoli e leggeri di Logistica di Amazon v1 (tutte le operazioni)
  • API Spedizione in entrata di gestione logistica v0 (alcune operazioni)
    • getInboundGuidance
  • API Gestito dal venditore v0 (alcune operazioni)
    • getEligibleShipmentServicesOld
    • cancelShipmentOld
    • getAdditionalSellerInputsOld
Report
  • GET_FBA_UNO_INVENTORY_DATA
  • GET_PRODUCT_EXCHANGE_DATA
Notifiche
  • ORDER_STATUS_CHANGE

11 ottobre 2023

Modifiche alle API

API Articoli delle offerte 2021-08-01
  • Elemento dati ItemProcurement aggiornato modificato da oggetto ad array.
API Ordini v0
  • Un elenco di articoli associati è stato aggiunto alla risposta per l'operazione getOrderItems.
API Assegnazione dei prezzi ai prodotti v0
  • L'attributo listingPrice nella risposta getItemOffers è stato rinominato per aiutare gli sviluppatori a evitare errori nell'estensione del codice per casi d'uso business-to-business. I sottocampi Landedprice e Shipping non sono più obbligatori, ma facoltativi.

Avvisi di obsolescenza

Le risorse SP-API che annunciano l'obsolescenza non saranno più supportate dopo la data di deprecazione. Le chiamate alle risorse obsolete avranno esito negativo a partire dalla data di rimozione. Per informazioni più dettagliate sulle date di obsolescenza delle SP-API, consultate Tabella delle deprecazioni.

API
  • API Autorizzazione v1 (tutte le operazioni)
  • API Prodotti piccoli e leggeri di Logistica di Amazon v1 (tutte le operazioni)
  • API Feed v2020-09-04 (tutte le operazioni)
  • API Spedizione in entrata di gestione logistica v0 (alcune operazioni)
    • getInboundGuidance
  • API Gestito dal venditore v0 (alcune operazioni)
    • getEligibleShipmentServicesOld
    • cancelShipmentOld
    • getAdditionalSellerInputsOld
  • Reports API v2020-09-04 (tutte le operazioni)
Report
  • GET_FBA_UNO_INVENTORY_DATA
  • GET_PRODUCT_EXCHANGE_DATA
Notifiche
  • ORDER_STATUS_CHANGE

20 settembre 2023

Modifiche alle API

API Ordini v0
  • La descrizione dell'operazione BuyerCompanyName nell'API Ordini v0 è stata aggiornata per specificare il nome dell'azienda e l'indirizzo di destinazione.

Aggiornamenti della documentazione

Avvisi di obsolescenza

Le risorse SP-API che annunciano l'obsolescenza non saranno più supportate dopo la data di deprecazione. Le chiamate alle risorse obsolete avranno esito negativo a partire dalla data di rimozione. Per informazioni più dettagliate sulle date di obsolescenza delle SP-API, consultate Tabella delle deprecazioni.

API
  • API Autorizzazione v1 (tutte le operazioni)
  • API Prodotti piccoli e leggeri di Logistica di Amazon v1 (tutte le operazioni)
  • API Feed v2020-09-04 (tutte le operazioni)
  • API Spedizione in entrata di gestione logistica v0 (alcune operazioni)
    • getInboundGuidance
  • API Gestito dal venditore v0 (alcune operazioni)
    • getEligibleShipmentServicesOld
    • cancelShipmentOld
    • getAdditionalSellerInputsOld
  • Reports API v2020-09-04 (tutte le operazioni)
Report
  • GET_FBA_UNO_INVENTORY_DATA
  • GET_PRODUCT_EXCHANGE_DATA

16 agosto 2023

Modifiche alle API

API Ordini v0
  • La proprietà ShipmentServiceLevelCategory della definizione dell'ordine è stata aggiornata per includere il valore Priority. Questo valore è disponibile nel nuovo modello di spedizione per i marketplace di Francia, Spagna, Germania, Polonia, Paesi Bassi, Svezia e Belgio al fine di supportare gli ordini Prime gestiti dal venditore. Se la tua integrazione utilizza i nuovi modelli di spedizione per queste regioni, potrebbe essere necessario aggiornarla per accettare il valore Priority per ShipmentServiceLevelCategory.
API Articoli in catalogo v2022-04-01
  • L'attributo generic_keyword è un dato proprietario specifico del venditore e non verrà più restituito dall'API Articoli in catalogo. I partner di vendita possono utilizzare l'API Articoli delle offerte per visualizzare i valori inviati.

Aggiornamenti della documentazione

Avvisi di obsolescenza

Abbiamo modificato la data di rimozione per le seguenti API:

Le chiamate a queste API avranno una frequenza di accelerazione ridotta dal 16 agosto 2023 al 18 ottobre 2023 e avranno esito negativo il 18 ottobre 2023.

Per informazioni più dettagliate sulle date di obsolescenza di SP-API, consulta la Tabella delle obsolescenze.

21 giugno 2023

Modifiche alle API

API Rifornimento
  • La nuova API Rifornimento v2022-11-07 restituisce il programma di rifornimento di un partner di vendita (abbonati e risparmia) le metriche e le informazioni sulle offerte. Questa API è disponibile nei seguenti marketplace: Stati Uniti d'America, Canada, Brasile, Messico, Regno Unito, Germania, Spagna, Italia, Francia, Paesi Bassi, Emirati Arabi Uniti, India, Giappone e Australia.
API Report
  • Un nuovo report MARKETPLACE_ASIN_PAGE_VIEW_METRICS fornisce informazioni sulle metriche di visualizzazione delle pagine ASIN (visualizzazione panoramica) per i marketplace DE, FR, IT, ES, NL, PL, SE e BE (EU-8), con dati disponibili fino agli ultimi sette giorni.
Analisi rapida per la vendita al dettaglio
API Articoli delle offerte
API Notifiche
  • Una nuova notifica LISTINGS_ITEM_MFN_QUANTITY_CHANGE viene inviata ogni volta che viene modificata la quantità disponibile di un articolo in offerta.
  • Una nuova notifica ORDER_CHANGE viene inviata ogni volta che c'è una modifica importante nell'ordine. Le modifiche importanti includono le modifiche allo stato dell'ordine e le cancellazioni richieste dall'acquirente. Questa notifica sostituisce ORDER_STATUS_CHANGE.
  • La notifica B2B_ANY_OFFER_CHANGED è stata aggiornata per includere il prezzo dello sconto sulla quantità (QD) nella sezione Offer, con nuovi attributi tra cui più livelli di quantità, tipo di sconto e prezzo. Ora puoi utilizzare questa notifica per creare soluzioni di rideterminazione dei prezzi QD, che eliminano la necessità di utilizzare le API di determinazione dei prezzi per questo scopo.
Analisi rapida per la vendita al dettaglio
  • Una nuova notifica ITEM_SALES_EVENT_CHANGE viene inviata cinque minuti dopo l'inizio di ogni ora. Questa notifica condivide i dati di vendita a livello di ASIN e include i dati relativi all'ora precedente, nonché eventuali dati ritardati risalenti fino a 24 ore prima. Gli ASIN sono inclusi quando effettuano ordini o cancellazioni durante una determinata ora. Ogni notifica può includere più ASIN e un partner di vendita può aspettarsi di ricevere più notifiche ogni ora.
  • Una nuova notifica ITEM_INVENTORY_EVENT_CHANGE viene inviata cinque minuti dopo l'inizio di ogni ora. Questa notifica condivide i dati dell'inventario a livello di ASIN e include i dati relativi all'ora precedente, nonché eventuali dati ritardati risalenti fino a 24 ore prima. Gli ASIN sono inclusi se il numero di unità disponibili per l'acquisto da parte dei clienti è cambiato. Ogni notifica può includere più ASIN e un partner di vendita può aspettarsi di ricevere più notifiche ogni ora.
  • Una nuova notifica DETAIL_PAGE_TRAFFIC_EVENT viene inviata cinque minuti dopo l'inizio di ogni ora. Questa notifica condivide i dati sul traffico a livello di ASIN e include i dati relativi all'ora precedente, nonché eventuali dati ritardati risalenti fino a 24 ore prima. Sono inclusi gli ASIN con visualizzazioni. Ogni notifica può includere più ASIN e un partner di vendita può aspettarsi di ricevere più notifiche ogni ora.

Aggiornamenti della documentazione

Avvisi di obsolescenza

Le risorse SP-API che verranno dichiarate obsolete non saranno più supportate dopo la data di deprecazione. Le chiamate a risorse obsolete avranno esito negativo a partire dalla data di scadenza.

Per informazioni più dettagliate sulle date di obsolescenza di SP-API, consulta la Tabella delle obsolescenze.

17 maggio 2023

Modifiche alle API

Spedizione con gestione logistica diretta del fornitore v2021-12-28
  • È stato aggiornato l'ambiente sandbox dinamico per includere l'operazione createShippingLabels.
Ordini V0
  • Scadenza del flusso di lavoro delle approvazioni degli ordini generici. Attributi ItemApprovalTypes e ItemApprovalStatus rimossi.

Aggiornamenti della documentazione

Avvisi di obsolescenza

19 aprile 2023

Modifiche alle API

API Spedizione in uscita di gestione logistica
  • È stata aggiornata la proprietà di city nell'attributo address da necessario a facoltativo.
API Inventario di Logistica di Amazon
  • È stato aggiornato il campo sellerSku per includere e analizzare le virgole.

Aggiornamenti della documentazione

Meta schema di definizione del tipo di prodotto
  • Il meta-schema di definizione del tipo di prodotto Amazon (v1) è stato aggiornato per includere le seguenti parole chiave: $lifecycle, replacedBy, replaces, enumDeprecated e enumReplacement.
Aggiornamenti della guida C#

Avvisi di obsolescenza

29 marzo 2023

Modifiche alle API

API Inventario di Logistica di Amazon
  • Aggiorna nextToken per scadere dopo 30 secondi.
Orders API
  • È stata aggiunta l'operazione confirmShipment.
API Spedizione in uscita di gestione logistica
  • È stato aggiornato l'attributo address che include la città.
  • È stato aggiornato per utilizzare un ambiente sandbox dinamico per i test anziché uno statico. Include una nuova operazione solo in modalità sandbox.

Aggiornamenti della documentazione

Avvisi di obsolescenza

22 febbraio 2023

Modifiche alle API

API Gestito dal venditore
  • Sono state aggiornate le risposte simulate dell'ambiente sandbox statico per visualizzare i nomi di determinati metodi di spedizione UPS nazionale (Stati Uniti) su SP-API.
API Ordini V0
  • Sono stati aggiunti i seguenti attributi delle preferenze di spedizione a getOrderAddress per supportare gli ordini dei clienti Amazon Business:
    • PreferredDeliveryTime
    • BusinessHours
    • OtherAttributes
    • AddressInstructions

Questi attributi contengono informazioni su come e quando viene consegnato un pacco.

Vendor Direct Fulfillment Orders API
  • L'attributo customedURL di buyerCustomizedInfo, restituito dalle operazioni getOrder e getOrders, è ora un URL codificato in Base 64 che utilizza il set di caratteri UTF-8.
API Approvvigionamento al dettaglio presso i fornitori
  • È stata aggiornata per passare six-month-past-in-date come parametro di query.

Aggiornamenti della documentazione

Avvisi di obsolescenza

25 gennaio 2023

Modifiche alle API

Product Pricing API
  • La nuova operazione getFeaturedOfferExpectedPriceBatch recupera le risposte a un massimo di 40 richieste relative al prezzo previsto dell'offerta (FOEP).
Vendor Direct Fulfillment Orders API
  • Il nuovo attributo buyerCustomizedInfo, contenente le informazioni sull'acquirente per i prodotti che il fornitore ha configurato come personalizzabili, specificando i tipi di personalizzazione o configurazioni insieme ai tipi e agli intervalli per il prodotto.
Orders API
  • Il nuovo attributo serialNumber restituisce un elenco di numeri di serie per i prodotti elettronici spediti ai clienti. Restituito solo per ordini di Logistica di Amazon.
Finances API
  • Nuovo tipo di evento finanziario: CapacityReservationBillingEventList consente di recuperare i dettagli relativi a un addebito della fatturazione di Capacity Reservation.

Aggiornamenti della documentazione

Avvisi di obsolescenza

6 dicembre 2022

Modifiche alle API

API Articoli in catalogo

L'API Articoli in catalogo v2022-04-01 è stata aggiornata per includere diversi attributi aggiuntivi nel riepilogo per portare tale API alla parità con la sezione Articoli in catalogo di Marketplace Web Service:

Inoltre, sono stati aggiunti i seguenti attributi a ItemSummaryByMarketplace:

  • adultProduct
  • autographed
  • memorabilia
  • releaseDate
  • tradeInEligible

9 novembre 2022

Modifiche alle API

API Report

  • Il nuovo report sulle imposte GST per venditori B2B GET_GST_MTR_B2B_CUSTOM fornisce informazioni dettagliate su vendite, rimborsi e annullamenti dalle fatture Amazon Business emesse entro un intervallo di date specificato. Disponibile solo nel marketplace indiano.

  • Il nuovo report sulle imposte GST per venditori B2C GET_GST_MTR_B2C_CUSTOM fornisce informazioni dettagliate su vendite, rimborsi e annullamenti delle fatture ai consumatori emesse entro un intervallo di date specificato. Disponibile solo nel marketplace indiano.

  • Il nuovo report sul trasferimento delle scorte del venditore GST GET_GST_STR_ADHOC fornisce dettagli sui movimenti dell'inventario dai centri logistici Amazon (rimozioni dal centro logistico o trasferimenti da un centro logistico a un altro). Il report contiene i dettagli a livello di transazione necessari per la contabilità e la dichiarazione dei redditi GST. Disponibile solo nel marketplace indiano.

Aggiornamenti della documentazione

19 ottobre 2022

Modifiche alle API

API Notifiche

È stata aggiornata per la nuova notifica FBA_INVENTORY_AVAILABILITY_CHANGES che viene inviata ogni volta che si verifica una modifica delle quantità di inventario di Logistica di Amazon. Questa notifica include un'istantanea dell'inventario di Logistica di Amazon in tutti i marketplace idonei in una particolare regione.

API Report

  • GET_SALES_AND_TRAFFIC_REPORT aggiornato, che ora include i dati B2B relativi al traffico proveniente dai clienti Amazon Business. A partire dal 28/08/2022 le metriche di conversione B2B sono state modificate per utilizzare i nuovi dati sul traffico B2B. I dati precedenti al 28/08/2022 sono impostati a zero per evitare confusione.

  • Il nuovo report GET_FBA_SNS_FORECAST_DATA sulle previsioni di Iscriviti e risparmia fornisce una previsione delle vendite per otto settimane basata sugli abbonamenti esistenti e sulla cronologia delle vendite.

  • Il nuovo report GET_FBA_SNS_PERFORMANCE_DATA sulle prestazioni di Iscriviti e risparmia fornisce una visualizzazione finale per quattro settimane degli articoli spediti, della percentuale di ordini persi per esaurimento delle scorte, del prezzo medio di vendita dopo lo sconto e dello sconto medio per ogni SKU.

Aggiornamenti della documentazione

21 settembre 2022

Modifiche alle API

API Spedizione con gestione logistica diretta del fornitore v2021-12-28
  • È stato aggiornato per la nuova operazione sincrona createShippingLabels che crea etichette di spedizione per un ordine di acquisto e restituisce le etichette. Nota che al momento l'operazione createShippingLabels non supporta l'ambiente sandbox.
  • È stata aggiornata per la produzione e il supporto dell'ambiente sandbox dinamico per tutte le operazioni equivalenti di Spedizione con gestione logistica diretta del fornitore V1.
API Token v2021-03-01
  • È stata aggiornata per le seguenti operazioni limitate per supportare l'API Spedizione con gestione logistica diretta del fornitore v2021-12-28:
    • createShippingLabels
    • getPackingSlip
    • getCustomerInvoice
    • getShippingLabel
API Report v2021-06-30

Aggiornamenti della documentazione

10 agosto 2022

Modifiche alle API

API Ordini V0
  • Miglioramenti all'API Ordini per supportare le spedizioni Easy Ship.
API Servizi V1
  • È stata aggiornata per la nuova operazione getRangeSlotCapacity che fornisce slot di capacità in un formato simile ai record di disponibilità.
  • È stata aggiornata per la nuova operazione getFixedSlotCapacity che prevede slot a capacità fissa.

18 maggio 2022

Modifiche alle API

API Articoli in catalogo
  • La nuova versione dell'API Articoli in catalogo 2022-04-01 migliora l'esperienza dell'API e risponde al feedback degli sviluppatori con le seguenti modifiche:
    • Sono state aggiunte ricerche basate su identificatori all'operazione searchCatalogItems, abilitando richieste simili a batch con un massimo di 20 identificatori per richiesta (ASIN, UPC, EAN, ecc.)
    • È stato aggiunto il set di dati dimensions, che fornisce le dimensioni normalizzate dell'articolo e del pacco
    • Sono stati aggiunti i nomi visualizzati per la categoria di prodotto, la sottocategoria di prodotto e la classificazione di navigazione
    • Attributi identificativi estesi ai riepiloghi degli articoli (classificazione degli articoli, quantità di pacchi, numero di parti, gruppo di visualizzazione del sito Web)
    • Sono state aggiunte le classificazioni di navigazione e i gruppi di visualizzazione dei siti Web alle classifiche delle vendite
    • Le operazioni searchCatalogItems e getCatalogItem sono state allineate per utilizzare gli stessi set di dati, tra cui attributes
    • variations è stato sostituito con relationships per consentire la rappresentazione di più tipi di relazione, come le gerarchie dei pacchi
    • Sono stati aggiunti i dettagli del tema della variante (nome ai dettagli delle relazioni)
API Notifiche
  • È stato aggiunto un parametro processingDirective che consente di passare informazioni aggiuntive all'abbonamento per controllare l'elaborazione delle notifiche. Questo parametro viene utilizzato dalla notifica ANY_OFFER_CHANGED.
  • È stata aggiornata la notifica ANY_OFFER_CHANGED per supportare il filtraggio delle notifiche solo su determinati marketplaceIds e limitando le notifiche a una ogni cinque o dieci minuti.
Orders API
  • È stato aggiornato per includere il supporto per il programma getOrderRegulatedInfo che gestisce gli ordini regolamentati nel Regno Unito. Gli ordini regolamentati sono un insieme limitato di ordini che soddisfano prodotti che richiedono una prescrizione (medicinali per animali domestici, lenti a contatto e occhiali soggetti a prescrizione medica). Sono state aggiunte due nuove operazioni: updateVerificationStatus e {{2}}.
  • Il nuovo attributo IsAccessPointOrder supporta l'identificazione degli ordini della Rete logistica del venditore (gestiti dal venditore) che sono stati spediti agli hub degli access point (AP).
Product Fees API
  • È stato aggiornato per la nuova operazione getMyFeesEstimates che recupera le stime delle commissioni dei prodotti per un elenco di prodotti e marketplace.
Product Pricing API
  • È stato aggiornato per le nuove operazioni getItemOffersBatch e getListingOffersBatch che recuperano i prezzi dei prodotti e le informazioni sulle offerte in un elenco di prodotti.
API Report

13 aprile 2022

Modifiche alle API

Easy Ship API
  • La nuova API Easy Ship aiuta a creare applicazioni che consentono ai venditori di gestire e spedire gli ordini Amazon Easy Ship.
FBA Inventory API
API Notifiche
  • Una nuova notifica PRICING_HEALTH viene inviata ogni volta che un'offerta del venditore non è idonea a essere inserita nelle Offerte in evidenza (offerta Buy Box) a causa di un prezzo non competitivo.
  • La nuova proprietà di FulfillmentChannel nella notifica ORDER_STATUS_CHANGE consente di filtrare le notifiche di modifica dello stato dell'ordine a seconda che l'ordine sia gestito da Amazon (Rete logistica di Amazon) o dal venditore (Rete logistica del venditore).
API Gestione logistica diretta del venditore

Aggiornamenti della documentazione

23 marzo 2022

Modifiche alle API

Orders API
  • Il nuovo parametro buyerRequestedCancel indica se un acquirente ha richiesto l'annullamento dell'ordine e il motivo dell'annullamento.
API Report

Nuovi Report analitici sulla vendita al dettaglio dei venditori

  • Il nuovo Report aziendale sulle vendite e sul traffico aiuta a gestire meglio le analisi fornendo metriche chiave sulle prestazioni di vendita, come le vendite di prodotti ordinati, i ricavi, le unità ordinate e il numero dei reclami, nonché metriche sul traffico delle pagine, come le visualizzazioni di pagina e la percentuale Buy Box nell'intero catalogo di articoli del venditore aggregata per data e ASIN. Questo report richiede il ruolo di API per i partner di vendita di Brand Analytics, ora disponibile per tutti i venditori.

Nuovi Report sulle prestazioni

  • Il nuovo Report sulle prestazioni dei coupon aiuta a ottimizzare le promozioni e ad adattare le strategie pubblicitarie. Il report include dettagli a livello di campagna (video totali, riscatti) e dettagli a livello di coupon (data di inizio/fine, video, riscatti e informazioni sul budget). Disponibile per i fornitori che dispongono del ruolo di API per i partner di vendita di Brand Analytics.

Nuovi Report di analisi della vendita al dettaglio dei fornitori

  • Un nuovo Report sulle vendite dei fornitori ti aiuta a gestire meglio l'inventario fornendo le principali metriche di vendita al dettaglio, come le entrate e le unità ordinate/spedite. I dati vengono riportati a livello aggregato nel catalogo di articoli di un fornitore e a livello di ASIN in tutti DAY, WEEK, MONTH, QUARTER, e YEAR periodi di rendicontazione. Disponibile per i fornitori che ricoprono il ruolo di Brand Analytics dell'API per i partner di vendita.
  • Un nuovo Report sul traffico dei fornitori ti aiuta a gestire meglio il tuo inventario fornendo metriche chiave sul traffico al dettaglio, come le visualizzazioni delle pagine di dettaglio. I dati vengono riportati a livello aggregato nel catalogo di articoli di un fornitore e a livello di ASIN in tutti DAY, WEEK, MONTH, QUARTER, e periodi di rendicontazione YEAR. Disponibile per i fornitori che ricoprono il ruolo dell'API per i partner di vendita per Brand Analytics.
  • Il nuovo Report sulla previsione dei fornitori aiuta a gestire meglio l'inventario fornendo previsioni sulla domanda media, P70, P80 e P90 dei clienti. Il sistema produce previsioni per un ASIN a vari livelli P, noti anche come livelli di attendibilità. Se stai impostando un livello P di previsione pari a 0,80 ("P80"), significa che c'è una probabilità dell'80% che la domanda dei clienti non superi le unità settimanali previste. I dati vengono riportati a livello di ASIN per la data di generazione della previsione settimanale più recente. Disponibile per i fornitori che dispongono del ruolo di API per i partner di vendita di Brand Analytics.
  • Il nuovo Report sullo stato dell'inventario dei fornitori 2.0 aiuta a gestire meglio l'inventario fornendo parametri di inventario e di integrità operativa, come le unità vendibili disponibili e il tasso di conferma del fornitore. I dati vengono segnalati a livello aggregato nel catalogo di articoli di un fornitore e a livello di ASIN per periodi di rendicontazione settimanali, mensili, trimestrali e annuali. Disponibile per i fornitori che dispongono del ruolo di API per i partner di vendita di Brand Analytics.

Aggiornamento della documentazione per i report sui dati delle fatture

  • Il Report sui dati delle fatture IVA in file di testo e il Report sui dati delle fatture IVA in formato XML sono ora disponibili nella documentazione. Questi report sono destinati ai venditori iscritti al servizio di calcolo dell'IVA di Amazon e che scelgono di caricare le proprie fatture.

Aggiornamenti della documentazione

  • La nuova pagina Hub di migrazione aggrega tutte le scadenze, le date di obsolescenza pianificata e le risorse relative alla migrazione da Amazon MWS all'API per i partner di vendita in un'unica pagina di riferimento.

  • Il nuovo sito del Blog API per i partner di vendita include articoli di Amazon Solutions Architects ed esperti di API che trattano una vasta gamma di argomenti, tra cui storie di clienti, migrazione, best practice, suggerimenti, trucchi e molto altro.

19 gennaio 2022

Modifiche alle API

Spedizione in entrata di gestione logistica

  • Nuovo codice di errore PRODUCTASSURANCE_SAFETYDOCUMENTATION restituito per prodotti non conformi che non dispongono della documentazione di conformità alla sicurezza. Questo codice di errore viene restituito per le seguenti operazioni:
    • CreateInboundShipmentPlan
    • CreateInboundShipment
    • UpdateInboundShipment
    • PreviewItemEligibility

Scopri di più su questa modifica su Seller Central.

Orders API

  • Nuovo attributo buyerTaxInformation per il marketplace turco. Questo attributo include le informazioni fiscali aziendali quando l'acquirente è un'azienda.

API Notifiche

  • Una nuova notifica Modifica dello stato dell'ordine viene inviata ogni volta che si verifica un cambiamento nello stato della disponibilità dell'ordine.

API Report

  • Il nuovo Report sullo stato di integrità della gestione dell'inventario di Logistica di Amazon aiuta a gestire meglio il tuo inventario fornendo una panoramica consolidata delle vendite (7, 30, 60 e 90 giorni), dello stato delle spedizioni (in elaborazione, ricevute e spedite), delle tariffe stimate di stoccaggio e stoccaggio a lungo termine e delle unità vecchie e in eccesso. Questo report include le metriche relative alle vendite, alle entrate, alle tariffe stimate e alle azioni consigliate.
  • Il nuovo Report sul trasferimento di azioni su richiesta fornisce informazioni a livello di transazione come il valore e il numero della fattura, l'aliquota fiscale e i numeri di identificazione delle imposte su beni e servizi (GSTIN) per le transazioni di movimento interstatale.

Aggiornamenti della documentazione

Guida alla migrazione da Amazon MWS all'API per i partner di vendita

Updated 13 days ago

Questa pagina ti è stata utile?