March 2022 SP-API Release Announcement

Introducing our new Selling Partner API Blog

Oggi lanciamo il nuovo sito del blog dell'API per i partner di vendita all'indirizzo https://developer-docs.amazon.com/sp-api-blog/docs. Il blog offre articoli di Amazon Solution Architect ed esperti di API che illustrano una serie di argomenti relativi all'API per i partner di vendita. Ci auguriamo che tu dia un'occhiata e che apprezzi il nuovo contenuto!

Pagina Migration Hub

Gli sviluppatori che eseguono la migrazione da Amazon Marketplace Web Service (Amazon MWS) all'API per i partner di vendita (SP-API) possono ora utilizzare la nuova pagina Migration Hub come riferimento per le date importanti per la migrazione e come centro risorse per tutti gli aspetti relativi alla migrazione.

Questa pagina è una pagina di risorse completa che puoi aggiungere ai segnalibri e visitare quando necessario. Eventuali aggiornamenti futuri alle date o ai dettagli della migrazione verranno comunque annunciati qui e verrà aggiornata anche la pagina Migration Hub.

Modelli nel repository GitHub

Sebbene il sito della documentazione per SP-API sia stato spostato da GitHub, ti informiamo che i modelli Swagger dell'API saranno disponibili sia nel repository GitHub Selling-Partner-API-models attuale sia nel sito della documentazione per SP-API.

Non c'è differenza nei modelli tra i due siti. Il repository GitHub Selling-Partner-API-models verrà mantenuto per garantire che coloro che clonano o copiano il repository tramite fork possano continuare a farlo senza interruzioni.

Aggiornamento dei ruoli

Il ruolo Brand Analytics è ora disponibile sia per gli sviluppatori privati che pubblici. Questo ruolo ti consente di accedere ai dati sulle vendite e sulla performance per aiutarti a gestire il tuo business di vendita sul marketplace Amazon o tramite il canale Amazon Retail. Ciò include Business Reports, Retail Analytics Reports e Brand Analytics Reports, disponibile tramite Reports API.

Versioni dell'API

Orders API e Orders section (Amazon MWS)

  • Il nuovo attributo BuyerRequestedCancel per l'operazione getOrders fornisce ai partner di vendita visibilità sul momento in cui gli acquirenti richiedono l'annullamento dopo che l'ordine è uscito dallo stato In sospeso.

Orders section (Amazon MWS)

  • L'attributo IsIBA è stato precedentemente reso disponibile in Orders API per SP-API. Questo aggiornamento estende lo stesso attributo alla sezione Ordini in Amazon MWS. L'attributo IsIBA indica quando un articolo all'interno dell'ordine è stato acquistato e rivenduto da Amazon Business EU SARL.

Reports API

  • Nuovo Sales and Traffic Business Report aiuta a fornire dati sulle prestazioni di vendita e sul traffico delle pagine del venditore per aiutarlo a gestire la propria attività e ottenere informazioni dettagliate. Questo report fornisce dati precedentemente disponibili solo nel sito Seller Central Business Reports e offre un accesso più rapido e semplice ai dati aziendali, alla data e all'ASIN
    granularità, pianificazione della consegna automatica dei report e informazioni aziendali più approfondite per aiutare i venditori a ottimizzare la propria attività.

  • Nuovo Coupons Performance Report aiuta i fornitori a ottimizzare le promozioni e ad adattare le strategie pubblicitarie.

  • Nuovo Vendor Inventory Health Report fornisce dati sull'inventario e metriche dello stato operativo, come le unità disponibili vendibili e la percentuale di conferma del fornitore.

  • Nuovo Vendor Forecasting Report mostra ai fornitori previsioni settimanali della domanda dei clienti medie, P70, P80 e P90.

  • Nuovo Vendor Traffic Report mostra ai fornitori le metriche principali sul traffico, come le visualizzazioni delle pagine dei dettagli.

  • Nuovo Vendor Sales Report mostra ai fornitori le metriche principali delle vendite al dettaglio come unità ordinate/spedite e ricavi corrispondenti.

Abbiamo anche aggiornato i valori per il tipo di report per includere due tipi di report attualmente disponibili con Reports API.

Deprecazioni di report

Man mano che vengono rese disponibili nuove versioni dei report, è necessario eliminare le versioni precedenti di alcuni report perché la versione più recente sostituisce la funzionalità della versione precedente.

I report seguenti verranno deprecati e non saranno disponibili a partire dal 27 giugno 2022.

  • GET_VENDOR_SALES_DIAGNOSTIC_REPORT
  • GET_VENDOR_DEMAND_FORECAST_REPORT
  • GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING
  • GET_FBA_FULFILLMENT_INVENTORY_HEALTH_DATA
  • GET_EXCESS_INVENTORY_DATA
  • GET_FBA_INVENTORY_AGED_DATA

Per ognuno di questi report è disponibile una nuova versione o un report sostitutivo. Esegui la migrazione alla versione nuova o sostitutiva di ogni report obsoleto per evitare interruzioni del servizio entro il 27 giugno 2022.

Report deprecatoReport sostitutivo
GET_VENDOR_SALES_DIAGNOSTIC_REPORTGET_VENDOR_SALES_REPORT and GET_VENDOR_TRAFFIC_REPORT
GET_VENDOR_DEMAND_FORECAST_REPORTGET_VENDOR_FORECASTING_REPORT
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNINGGET_VENDOR_INVENTORY_REPORT
GET_FBA_FULFILLMENT_INVENTORY_HEALTH_DATAGET_FBA_INVENTORY_PLANNING_DATA
GET_EXCESS_INVENTORY_DATAGET_FBA_INVENTORY_PLANNING_DATA
GET_FBA_INVENTORY_AGED_DATAGET_FBA_INVENTORY_PLANNING_DATA

Deprecazione di API

A titolo di promemoria, ti ricordiamo che la deprecazione per Reports API v2020-09-04 e Feeds API v2020-09-04 è stata annunciata in occasione del rilascio delle versioni 2021-06-30 nel luglio 2021.

Queste due API verranno ritirate il 31 luglio 2022 e le eventuali chiamate a partire dal 1 agosto 2022 avranno esito negativo. Effettua la migrazione a Reports API v2021-06-30 e Feeds API v2021-06-30 per evitare interruzioni
del servizio.

Cordiali saluti,

Il team dell'API per i partner di vendita