Applicable products: Netmarkets

💡Amazon - Come migrare il tuo canale Amazon a SP API

Nella primavera del 2025, Lengow sta passando dalla tecnologia Amazon attuale basata su file XSD alla nuova e migliorata Amazon Seller Partner API (SP API).
Leggi i vantaggi e il calendario previsto in questo articolo di notizie. 

Poiché Amazon dismetterà il connettore precedente alla fine di luglio 2025 (inizialmente il 30 giugno, posticipato da Amazon), tutti i venditori sono tenuti a migrare per continuare a vendere su Amazon.

In Lengow, questa migrazione sarà effettuata gradualmente, iniziando con i canali Amazon Listing Loader, seguiti dai canali Amazon classici e concludendo con i canali Amazon Flat File.
Sarai informato via email quando sarà il momento di migrare ogni tipo di canale.

Dovrai seguire questi passaggi per migrare ogni canale Amazon:

  1. Lengow duplicherà il tuo canale Amazon attivo e copierà la maggior parte della tua configurazione esistente.
    Questo nuovo canale creato, utilizzando Amazon SP API, viene inizialmente creato come bozza (non attivato). 
  2. Devi controllare e regolare le impostazioni (mappatura di categoria e attributi) del tuo nuovo canale Amazon. 
    Leggi le nostre istruzioni di seguito per ogni tipo di canale.
  3. Disattiva il canale precedente e attiva quello nuovo.
  4. Monitora i rapporti del canale e correggi gli eventuali errori.

Suggerimento: Se vuoi prima testare la migrazione con alcuni prodotti, segui questi passaggi:

  • Crea un segmento con i tuoi prodotti di prova, e usa questo segmento per il tuo nuovo canale Amazon SP API.
  • Configura il nuovo canale Amazon SP API.
  • Disattiva il canale Amazon precedente.
  • Attiva il nuovo canale Amazon per eseguire i tuoi test (finché uno dei due canali Amazon, vecchio o nuovo, è attivo, i tuoi ordini vengono recuperati da Lengow).

Sebbene la maggior parte delle impostazioni sia stata replicata automaticamente da Lengow, diversi attributi potrebbero essere stati aggiunti o avere un nuovo formato. Questi attributi devono quindi essere completati secondo i requisiti di Amazon.

Scarica da Amazon la lista completa degli attributi richiesti per tipo di prodotto
Nota: Gli attributi che erano già obbligatori potrebbero non essere specificati in questo file.

Troverai di seguito le azioni richieste per ogni tipo di canale Amazon:

Canale Amazon Listing Loader

Alla fine di marzo o all'inizio di aprile 2025, Lengow creerà progressivamente un nuovo canale Listing Loader per ciascuno attivo. 

La tua configurazione esistente è stata copiata sul nuovo canale Listing Loader. Tuttavia, devi adattare le impostazioni dei tuoi attributi ai seguenti cambiamenti:

Nome dell'attributo Cambiamenti con SP API
externally_assigned_product_
identifier.value
Questo attributo sostituisce l'attributo "product-id" precedente, ma non puoi più inserire l'ASIN qui.
Puoi fornire il codice EAN dei tuoi prodotti in questo attributo, ma ora è opzionale se fornisci il codice ASIN nell'attributo "merchant_suggested_asin..value".
Se fornisci il codice EAN, seleziona anche il valore "EAN" nell'attributo "externally_assigned_product_identifier.type".
merchant_suggested_asin..value Inserisci il codice ASIN (riferimento interno Amazon) dei tuoi prodotti se lo hai nel tuo catalogo.
Per tutti i prodotti, devi fornire o il ASIN qui o/e l'EAN in "externally_assigned_product_identifier.value".

Una volta che queste impostazioni sono state regolate, disattiva il vecchio canale Listing Loader e attiva questo nuovo.

Canale Amazon classico

🎓 Per beneficiare di consigli dettagliati dai nostri esperti di Amazon, guarda questo webinar: Amazon Classic Migration: Guida a una transizione fluida con Lengow
(Accedi al Centro assistenza per accedervi).

Nel maggio 2025, Lengow creerà progressivamente un nuovo canale Amazon classico fr ogni attivo.

La tua configurazione esistente è stata copiata sul nuovo canale Amazon. Tuttavia, devi adattare le tue impostazioni ai seguenti cambiamenti:

  • Mappatura delle categorie:

Poiché molte categorie sono state rimosse e sostituite da nuove nella versione SP API del canale Amazon, devi rivedere la tua mappatura delle categorie e completarla se necessario.

Clicca qui per l'elenco completo delle categorie rimosse
'Arts',
'AutoAccessory',
'AutoAccessory..PowersportsVehicle',
'Baby',
'Beauty..BeautyMisc',
'Books',
'Books..BooksMisc',
'CE',
'CameraPhoto',
'Coins',
'Collectibles',
'Computers',
'EUCompliance',
'EducationSupplies',
'EntertainmentCollectibles',
'FBA',
'FoodAndBeverages',
'FoodServiceAndJanSan',
'Furniture',
'GiftCard',
'Gourmet',
'Home',
'HomeImprovement',
'Industrial',
'Jewelry',
'LabSupplies',
'LargeAppliances',
'LightMotor',
'Lighting',
'Luggage',
'LuxuryBeauty',
'MechanicalFasteners',
'Miscellaneous',
'Miscellaneous..Event_Tickets',
'Miscellaneous..Gifts_and_Occasions',
'Motorcycles',
'Music',
'MusicalInstruments',
'Office',
'Outdoors',
'PowerTransmission',
'RawMaterials',
'Shoes',
'SoftwareVideoGames',
'SoftwareVideoGames..DownloadableSoftware',
'SoftwareVideoGames..DownloadableVideoGame',
'Sports',
'SportsMemorabilia',
'TiresAndWheels',
'Toys',
'ToysBaby',
'Video',
'Video..AbisDvd',
'WineAndAlcohol',
'Wireless'
  • Mappatura degli attributi:

Dimensioni e attributi di peso:
- item_weight..value
- item_package_dimensions..length.value
- item_package_dimensions..width.unit
etc.

Nome dell'attributo Cambiamenti con SP API

Attributi di variazione:
- variation_theme..name
- parentage_level..value
- color..value
- size..value
- style..value
etc.

Certi attributi utilizzati per impostare le variazioni, come "Shoes..VariationData..VariationTheme", erano presenti solo a livello di categoria.
La configurazione di tali attributi non poteva essere copiata sul nuovo canale SP API, poiché ora sono tra gli attributi comuni.
Eccezione: "material..value" e "pattern..value" sono disponibili a livello di categoria, poiché i valori validi variano per ogni categoria.
Assicurati che gli attributi richiesti per impostare le tue variazioni siano completati secondo le nostre istruzioni qui (inclusa la selezione del valore "Variant" per l'attributo "child_relationship_type").

externally_assigned_product_
identifier.value

Lengow ha copiato la configurazione di questo attributo quando è stato completato. Tuttavia, ora Amazon accetta solo 3 tipi di ID: EAN, GTIN e UPC.
Se ad esempio fornivi ASIN o ISBN in questo attributo, devi fornire un altro tipo di identificatore, poiché è un attributo obbligatorio.
Se fornisci il codice EAN qui, seleziona anche il valore "EAN" nell'attributo "externally_assigned_product_identifier.type".

Questi attributi sono ora obbligatori.
Le dimensioni e il peso dei vostri prodotti e del loro imballaggio devono essere forniti ad Amazon negli attributi corrispondenti. Leggi i dettagli in questo articolo.

batteries_required..value

Questo attributo è ora obbligatorio.
Seleziona "sì" se l'articolo richiede energia a batteria (o se l'articolo stesso è una batteria) o "no" se non lo fa. Si noti che anche una batteria ricaricabile interna è considerata una batteria.

supplier_declared_dg_hz_regulation..value

Questo attributo è ora obbligatorio.
Se il prodotto è un bene pericoloso, materiale pericoloso, sostanza o rifiuto soggetto a specifiche normative in materia di trasporto, stoccaggio e/o smaltimento, selezionare un elemento dall'elenco dei valori validi. Altrimenti, selezionare "Non applicabile".

Prezzo di listino:
list_price..value_with_tax
list_price..currency

Questi attributi sono ora obbligatori.
Il Prezzo di listino, o prezzo di riferimento, è il prezzo al dettaglio suggerito dal produttore. Deve essere fornita la valuta corrispondente.
Inserisci "0" se non hai un prezzo di listino.

Attributi delle date di promozione:
- purchasable_offer..discounted_price
..schedule..start_at
- purchasable_offer..discounted_price
..schedule..end_at

Se hai promozioni in corso, assicurati che le date di promozione siano impostate nel nuovo formato : aaaa-mm-gg
(esempio : 2025-05-24)
Il formato precedente includeva l'ora.

  • Anteprima:

Una volta che queste impostazioni sono state regolate, controlla l'Anteprima del tuo canale, per identificare possibili errori di formato. 

Variazioni

Con il nuovo canale Amazon SP API, i prodotti genitore devono ora includere valori per certi attributi (ad es. immagine principale, tipo di relazione, ecc.). Questo è un cambiamento rispetto alla versione precedente del canale, dove questi campi dovevano essere lasciati vuoti per i genitori.

Durante la migrazione, Lengow ha copiato i valori dai prodotti figlio ai prodotti genitore per soddisfare le nuove esigenze di Amazon. Questi valori non sono visibili nell'anteprima del canale, ma vengono inviati ad Amazon.

Nota: Quando crei nuove variazioni, segui le nostre linee guida aggiornate per riempire i valori richiesti per i prodotti genitore, poiché Lengow non li riempirà automaticamente dopo la migrazione.

Elenco degli attributi automaticamente popolati per i prodotti genitore attraverso la migrazione:
- "main_product_image_locator..media_location"
- "bullet_point.value_01"
- "child_parent_sku_relationship..child_relationship_type"
- "country_of_origin..value"
- "list_price..value_with_tax"
- "supplier_declared_dg_hz_regulation..value"

Quando sei pronto, disattiva il vecchio canale classico di Amazon e attiva questo nuovo.

  • Rapporti del canale:

Con questa nuova versione SP API, Amazon richiede nuovi attributi obbligatori in molte categorie.

È quindi importante controllare i rapporti del canale per gli errori, per verificare se i tuoi prodotti sono correttamente configurati.

Amazon Fla

Canale file

Nel giugno 2025, Lengow creerà progressivamente un nuovo canale Amazon classico per ogni canale Flat File attivo.
Nota: Abbigliamento e accessori sono ora pubblicati attraverso questo canale, proprio come qualsiasi altro tipo di prodotto.

La tua configurazione esistente è stata copiata sul nuovo canale Amazon. Tuttavia, devi adattare le tue impostazioni alle seguenti modifiche: 

  • Mappatura degli attributi:

Nome dell'attributo Modifiche con SP API

Attributi di variazione:
- variation_theme..name
- parentage_level..value
- color..value
- size..value
- style..value
etc.

Certi attributi utilizzati per impostare le variazioni, come "variation_theme", erano presenti solo a livello di categoria.
La configurazione di tali attributi non poteva essere copiata sul nuovo canale SP API, poiché ora sono tra gli attributi comuni.
Eccezione: "material..value" e "pattern..value" sono disponibili a livello di categoria, poiché i valori validi variano per ogni categoria.
Assicurati che gli attributi necessari per impostare le tue variazioni siano completati secondo le nostre istruzioni qui (inclusa la selezione del valore "Variant" per l'attributo "child_relationship_type").

condition_type

 

Questo attributo era presente solo a livello di categoria.
La configurazione di questo attributo non poteva essere copiata sul nuovo canale SP API, poiché ora è tra gli attributi comuni.

operation_type

 

Due valori accettati in maiuscolo: UPDATE e DELETE. In precedenza, c'erano tre valori accettati in minuscolo: update, partial-update e delete.
L'uso di valori in minuscolo è ora bloccante (ad es., imposto tramite una regola).

externally_assigned_product_
identifier.value

Lengow ha copiato la configurazione di questo attributo quando è stato completato. Tuttavia, ora Amazon accetta solo 3 tipi di ID: EAN, GTIN e UPC.
Se ad esempio fornivi ASIN o ISBN in questo attributo, devi fornire un altro tipo di identificatore, poiché è un attributo obbligatorio.
Se fornisci il codice EAN qui, seleziona anche il valore "EAN" nell'attributo "externally_assigned_product_identifier.type".

Attributi di dimensioni e peso:
- item_weight..value
- item_package_dimensions..length.value
- item_package_dimensions..width.unit
etc.

Questi attributi sono ora obbligatori.
Le dimensioni e il peso dei tuoi prodotti e del loro imballaggio devono essere forniti ad Amazon negli attributi corrispondenti. Leggi i dettagli in questo articolo.

batteries_required..value

Questo attributo è ora obbligatorio.
Seleziona "sì" se l'articolo richiede energia a batteria (o se l'articolo stesso è una batteria) o "no" se non lo fa. Nota che una batteria ricaricabile interna è considerata anche una batteria.

supplier_declared_dg_hz_regulation..value

Questo attributo è ora obbligatorio.
Se il prodotto è un bene pericoloso, materiale pericoloso, sostanza o rifiuto soggetto a specifiche normative riguardanti il trasporto, lo stoccaggio e

Questo articolo è stato tradotto automaticamente. In caso di dubbio, faccia riferimento alle versioni originali in inglese o in francese.

Articoli in questa sezione

Notizie, Servizi e Rapporti sugli incidenti
Scopri aggiornamenti, webinar e servizi di esperti per ottenere il massimo da Lengow.