DataFirefly Amazon Connector: collegare PrestaShop ad Amazon Seller Central
Installazione, connessione SP-API, marketplace, associazione categorie, pubblicazione, prezzi, stock, ordini, spedizioni, fatture, annullamenti, rimborsi e risoluzione dei problemi.
Panoramica
Il modulo collega il tuo negozio PrestaShop al tuo account venditore Amazon tramite l’API ufficiale Selling Partner API (SP-API). Pubblica i tuoi prodotti sui marketplace scelti, invia stock e prezzi, importa gli ordini Amazon in PrestaShop, conferma le spedizioni, invia le tue fatture e legge i rimborsi e lo stock FBA.
Compatibilità: da PrestaShop 1.7.8 a 9.x, con lo stesso ZIP per tutte le versioni. Multinegozio, multilingua, regioni Amazon Europa, Nord America ed Estremo Oriente. Interfaccia in 8 lingue: francese, inglese, spagnolo, tedesco, italiano, olandese, polacco e portoghese.
Novità della versione 2.0.0: procedura guidata di connessione, dashboard di sincronizzazione, editor visuale delle mappature con gli attributi obbligatori di Amazon, coda con spiegazione e soluzione di ogni errore, prezzo minimo e massimo per prodotto e per marketplace, modalità IVA per marketplace, rimborso da PrestaShop, anonimizzazione dei dati dell’acquirente e compatibilità con PrestaShop 1.7.8.
La 2.0.0 corregge anche alcuni difetti della 1.2.1: aggiornamenti di stock non messi in coda e impostazioni prodotto non salvate su MySQL in modalità strict, ordini rifiutati per un paese disattivato nel negozio o per la Spagna, importazione impossibile tramite il cron da riga di comando, marca disattivata che bloccava l’inserzione. L’aggiornamento dalla 1.2.1 conserva tutti i tuoi dati.
Installazione
- In Moduli > Gestione moduli, fai clic su Carica un modulo e invia il file ZIP. Sono richieste le estensioni PHP cURL e OpenSSL.
- Il modulo crea le sue tabelle, la scheda Connettore Amazon nel menu Vendi, un corriere «Amazon» riservato agli ordini importati (mai proposto ai tuoi clienti) e gli stati ordine Amazon.
- Apri la scheda: la dashboard mostra i passaggi iniziali, in ordine.
Per passare dalla 1.2.1 alla 2.0.0, invia il nuovo ZIP. Impostazioni, credenziali, marketplace, mappature, inserzioni, ordini e log vengono conservati, e i secret vengono crittografati di nuovo con il nuovo algoritmo. Dopo un aggiornamento l’anonimizzazione dei dati dell’acquirente resta disattivata: nulla di ciò che è già stato importato viene modificato finché non la attivi.
Preparare il tuo account Amazon
Il modulo si connette con la tua applicazione privata SP-API. Ti serve un account Seller Central professionale.
- In Seller Central, apri App e servizi > Sviluppa app e registrati come sviluppatore privato, se non l’hai già fatto.
- Crea un’applicazione e richiedi i ruoli necessari per le funzioni che userai: Product Listing e Pricing per il catalogo, Inventory and Order Tracking per gli ordini, Direct-to-Consumer Shipping (Restricted) per l’indirizzo di consegna, Amazon Fulfillment per lo stock FBA, Finance and Accounting per i rimborsi, Tax Invoicing per le fatture.
- Autorizza l’applicazione sul tuo account per ottenere un refresh token, e annota l’ID client LWA e il secret client LWA.
- Recupera il tuo ID venditore (Merchant Token) in Impostazioni > Info account.
L’API Orders v2026-01-01 usata dal modulo non richiede un Restricted Data Token: l’accesso all’indirizzo di consegna dipende dal ruolo Direct-to-Consumer Shipping della tua applicazione. Senza questo ruolo, gli ordini vengono importati con un indirizzo sostitutivo, segnalato sull’ordine.
Connessione
La scheda Connessione guida la configurazione in quattro passaggi: la regione, le credenziali Login with Amazon, l’ID venditore, poi il test. Il test richiede un token di accesso ad Amazon e legge i marketplace del tuo account; poi selezioni i negozi Amazon da attivare.
Il secret client e il refresh token sono crittografati nel database (AES-256-GCM) e non vengono mai più mostrati: lascia i campi vuoti per mantenere i valori salvati. Il pulsante Disconnetti cancella le credenziali e interrompe la sincronizzazione.

Marketplace e regole di prezzo
La scheda Marketplace mostra un riquadro per ogni negozio Amazon. Per ciascuno, imposta:
- l’attivazione e la lingua dell’inserzione (titolo, descrizione, punti elenco);
- la maggiorazione in percentuale, l’importo fisso e l’arrotondamento (nessuno, x,99, x,90, numero intero successivo);
- il prezzo minimo del marketplace: nessun prezzo viene pubblicato al di sotto;
- i prezzi IVA inclusa o esclusa, e la sincronizzazione dei prezzi, da disattivare se usi un repricer Amazon;
- la modalità IVA: IVA secondo le regole del negozio, oppure nessuna imposta quando è Amazon a riscuotere l’IVA. Questa scelta dipende dal tuo regime fiscale: valutala con il tuo commercialista.
Ogni riquadro indica anche il numero di inserzioni online e in errore e gli ordini recenti di quel marketplace.

Mappature: categorie e tipi di prodotto
Una mappatura serve solo per creare nuove schede prodotto su Amazon. Un prodotto venduto su un ASIN esistente, o collegato tramite il suo EAN, ha bisogno solo di un’offerta.
Nella scheda Mappatura, associa una categoria PrestaShop a un tipo di prodotto Amazon. Un prodotto usa la mappatura della sua categoria predefinita o, in mancanza, quella della categoria padre più vicina. Il pulsante di ricerca interroga Amazon per parole chiave e propone i tipi di prodotto corrispondenti.

Una volta scelto il tipo, Carica gli attributi obbligatori legge lo schema del tipo di prodotto presso Amazon. Per ogni attributo obbligatorio l’editor indica se è compilato automaticamente dal modulo (titolo, marca, EAN, prezzo…), associato da te o ancora mancante, con un contatore «coperti». Per ogni attributo mancante, scegli una fonte:
- una caratteristica PrestaShop;
- un attributo di combinazione (taglia, colore, materiale…);
- un valore fisso.
Il tema di variazione (ad esempio SIZE_NAME/COLOR_NAME) raggruppa le combinazioni in una famiglia padre-figlio; se è vuoto, ogni combinazione viene pubblicata come prodotto indipendente. Gli attributi avanzati (JSON) restano disponibili per i casi particolari, con le variabili {marketplace_id}, {language_tag}, {currency}, {reference}, {ean13}, {mpn} e {brand}.

Pubblicare i prodotti
Dalla scheda prodotto
La scheda Moduli della pagina prodotto contiene il blocco Amazon:
- Vendi su Amazon attiva il prodotto.
- Modalità di pubblicazione: automatica, offerta su un prodotto esistente (ASIN o EAN) o creazione della scheda completa.
- Evasione: da te (FBM) o da Amazon (FBA).
- ASIN, tipo di prodotto, condizione e prezzo Amazon fisso sostituiscono i valori predefiniti per questo prodotto.
- Prezzo minimo e prezzo massimo del prodotto: delimitano il prezzo calcolato e vengono inviati ad Amazon come limiti di prezzo del venditore.
- Marketplace: deseleziona un paese per rimuovere il prodotto da quel marketplace.
La tabella «Cosa verrà inviato ad Amazon» mostra, per combinazione e per paese, il prezzo, il prezzo scontato e le sue date, i limiti di prezzo, il prezzo Business e la quantità. Un prezzo riportato a un limite viene segnalato. Le inserzioni già online compaiono con il loro stato e il loro ASIN.

Verifica con Amazon fa convalidare l’inserzione da Amazon senza pubblicare nulla. Ogni errore viene spiegato in modo chiaro con la correzione da applicare, ad esempio un EAN non registrato presso GS1 o un attributo obbligatorio mancante. Invia ora, Aggiungi alla prossima sincronizzazione e Aggiorna stato completano il blocco. Un’inserzione già online viene aggiornata con una modifica parziale: gli attributi inseriti in Seller Central e non gestiti dal modulo non vengono cancellati.

In blocco
La scheda Prodotti elenca il catalogo con, per ogni prodotto, la modalità FBM o FBA, lo stato per marketplace, lo stock del negozio e lo stock FBA. Filtra per nome, riferimento, EAN, SKU, ASIN, categoria o stato, seleziona alcuni prodotti o tutti i prodotti che corrispondono al filtro, poi applica un’azione di gruppo: attiva e pubblica, pubblica di nuovo, invia prezzi, invia quantità, disattiva (quantità 0) o elimina da Amazon.

Inserzioni già presenti su Amazon
Collega le inserzioni Amazon esistenti richiede ad Amazon il report delle tue inserzioni. Alle esecuzioni successive del cron, ogni SKU viene collegato al prodotto PrestaShop che ha lo stesso SKU, lo stesso riferimento o lo stesso EAN. Gli SKU non trovati sono elencati nel log.
SKU Amazon
Lo SKU viene creato alla prima pubblicazione secondo l’impostazione scelta: riferimento, EAN13 o modello (per impostazione predefinita PS{id_product}-{id_product_attribute}). Uno SKU già creato non cambia mai, anche se il riferimento cambia, e due combinazioni non possono ricevere lo stesso SKU.
Prezzi
Il prezzo viene calcolato dal modulo, lato server, in questo ordine: prezzo del gruppo prezzi scelto, conversione nella valuta del marketplace, maggiorazione e importo fisso, arrotondamento, poi limiti. Il prezzo minimo applicato è il più alto tra il prezzo minimo del prodotto, il prezzo minimo del marketplace e il prezzo di acquisto aumentato del margine minimo; il tetto è il prezzo massimo del prodotto. Un prezzo pari a zero o negativo non viene mai pubblicato, e un minimo superiore al massimo viene rifiutato con un messaggio.
Opzioni della sezione Prezzi delle impostazioni:
- Gruppo prezzi: i prezzi di questo gruppo clienti sono la base dei prezzi Amazon.
- Applica gli sconti del negozio: prezzi specifici e regole di catalogo inclusi nel prezzo Amazon.
- Invia gli sconti del negozio come prezzi scontati Amazon: il prezzo normale resta il prezzo di riferimento e lo sconto diventa un prezzo scontato con date. Uno sconto creato, modificato o eliminato in PrestaShop aggiorna Amazon; in caso di eliminazione, il prezzo scontato viene rimosso da Amazon.
- Margine minimo sul prezzo di acquisto: nessun prezzo viene pubblicato sotto il prezzo di acquisto aumentato di questo margine, e questo minimo viene inviato ad Amazon per la determinazione automatica dei prezzi.
- Prezzi Amazon Business: il prezzo di un gruppo clienti diventa il prezzo Business, e i suoi sconti per quantità diventano livelli (5 al massimo). Riservato ai venditori registrati ad Amazon Business.

Stock e FBA
Ogni movimento di stock in PrestaShop mette il prodotto in coda di invio, per ogni marketplace in cui l’inserzione è online. Impostazioni: scorta di sicurezza (unità non offerte su Amazon), quantità massima, tempo di lavorazione, quantità 0 per i prodotti disattivati e risincronizzazione completa giornaliera. Una quantità negativa viene inviata come 0.
I prodotti in FBA non ricevono quantità da PrestaShop. Leggi lo stock FBA recupera ogni ora la quantità disponibile nei magazzini Amazon, mostrata nell’elenco dei prodotti e nella scheda prodotto; Copia lo stock FBA in PrestaShop la applica allo stock del negozio per i prodotti in FBA.
Attività cron
La sincronizzazione viene eseguita da un’attività cron, idealmente ogni 5-15 minuti. La sezione Attività cron delle impostazioni mostra l’URL protetto da token e il comando da riga di comando:
php /percorso/di/modules/dfamazonconnector/cron.php --shop=1
Due esecuzioni non si sovrappongono mai: un blocco impedisce l’avvio di una seconda esecuzione finché la prima è in corso. A ogni esecuzione, il modulo importa gli ordini, conferma le spedizioni, invia fatture, annullamenti e rimborsi, legge i rimborsi e lo stock FBA, anonimizza i dati dell’acquirente arrivati a scadenza, poi invia le inserzioni, gli stock e i prezzi in attesa sotto forma di feed raggruppati. Quando Amazon limita il numero di chiamate, il modulo attende e riprova, entro una durata limitata per esecuzione. Il pulsante Nuovo token invalida il vecchio URL.

Dashboard
La dashboard presenta le inserzioni attive e in errore, gli ordini Amazon degli ultimi 14 giorni in FBM e in FBA, le attività in attesa, gli errori più frequenti delle inserzioni con la relativa soluzione, lo stato di salute di ogni marketplace e la cronologia delle ultime sincronizzazioni, con il numero di chiamate limitate da Amazon e di errori. Un banner segnala un cron fermo da più di un’ora.

Coda ed errori
La scheda Coda ed errori conta le attività per tipo (inserzioni, prezzi, stock, fatture, annullamenti, rimborsi) e per stato. Gli errori sono raggruppati per causa: ogni gruppo fornisce la spiegazione, la soluzione da applicare e un link alla schermata interessata. Riprova o elimina le attività in blocco, e consulta gli ultimi feed e report inviati ad Amazon.

Ordini
Gli ordini vengono letti con l’API Orders v2026-01-01 a partire dalla data di inizio scelta. Un ordine in attesa di pagamento viene memorizzato senza essere creato; viene importato appena Amazon lo passa allo stato da spedire. L’importazione è idempotente: un blocco per ordine Amazon e il numero d’ordine salvato come identificativo della transazione impediscono qualsiasi ordine doppio, anche se girano due cron o se un’esecuzione si interrompe a metà.
Ogni ordine importato crea o riutilizza un cliente ospite (uno per acquirente, o un unico cliente per tutti gli ordini Amazon), senza newsletter né offerte dei partner, un indirizzo di consegna e un ordine PrestaShop con il corriere Amazon, i prezzi e le spese di spedizione Amazon e, come opzione, la data di acquisto Amazon. Gli ordini verso un paese disattivato nel tuo negozio vengono importati senza riattivare quel paese. La fattura viene numerata da PrestaShop secondo la tua numerazione abituale e non viene mai rinumerata.
Gli ordini FBA vengono importati una volta spediti da Amazon, con lo stato dedicato. Con l’opzione «Gli ordini FBA non modificano lo stock del negozio», la quantità viene restituita allo stock dopo la creazione: non viene mai scalata due volte.

La scheda Ordini elenca gli ordini Amazon con i filtri «Da spedire», «Richieste di annullamento», «Errori di importazione», «FBA» e «Rimborsati». Un ordine non importato mostra la causa e la soluzione (SKU sconosciuto, valuta non installata, paese non configurato…) e un pulsante Riprova.

Spedizioni, fatture, annullamenti e rimborsi
Il blocco Amazon della pagina dell’ordine raggruppa tutte le azioni sull’ordine.
- Spedizione: quando l’ordine passa a uno degli stati scelti nelle impostazioni, il modulo invia ad Amazon il codice del corriere, il numero di tracking e la data di spedizione. Amazon richiede un numero di tracking: senza di esso non viene inviato nulla e il blocco te lo segnala. La tabella di associazione dei corrieri abbina ogni corriere PrestaShop a un codice Amazon; cambia il corriere dell’ordine prima della spedizione perché venga inviato il codice corretto. Il pulsante Conferma la spedizione ora evita di attendere il cron.
- Fattura: se usi il servizio di calcolo dell’IVA di Amazon con il caricamento delle tue fatture, la fattura PDF di PrestaShop viene inviata dopo la conferma di spedizione. Il suo stato (inviata, in attesa, rifiutata) compare sull’ordine. Amazon rifiuta l’invio se in Seller Central è attiva la generazione automatica delle sue fatture.
- Rimborso: rimborsa tutto l’ordine o una parte, articolo per articolo, con un motivo dell’elenco Amazon. L’importo non può superare quanto pagato. Amazon rimborsa l’acquirente, poi il rimborso viene riletto e annotato sull’ordine.

Quando un acquirente chiede l’annullamento di un ordine non spedito, nell’elenco e sull’ordine compare un avviso rosso, con il motivo. Non spedire: annulla su Amazon dal blocco, oppure attiva Annulla su Amazon quando l’ordine viene annullato in PrestaShop. Un annullamento richiesto dall’acquirente viene inviato con il motivo BuyerCanceled. Al contrario, un ordine annullato lato Amazon passa allo stato di annullamento scelto, senza e-mail al cliente.

Con Leggi i rimborsi Amazon, i rimborsi effettuati in Seller Central vengono letti tramite l’API Finances e annotati sull’ordine PrestaShop. Quando tutte le unità sono rimborsate, l’ordine passa allo stato scelto.
Dati dell’acquirente
La sezione Dati dell’acquirente delle impostazioni applica le regole di Amazon sui dati personali:
- Anonimizza i dati dell’acquirente dopo (giorni): il nome, la via, il codice postale, il telefono e l’e-mail dell’acquirente vengono sostituiti dopo questo numero di giorni dalla spedizione (30 per impostazione predefinita in una nuova installazione). Il paese, la città, la società, gli importi e le fatture vengono conservati. La politica di protezione dei dati di Amazon chiede di non conservare questi dati per più di 30 giorni dopo la consegna, salvo obbligo di legge. Scarica prima le tue fatture se devi rigenerarle.
- Blocca le e-mail del negozio agli acquirenti Amazon: conferme, fatture, cambi di stato ed e-mail di marketing di PrestaShop non vengono inviati agli acquirenti Amazon. Amazon gestisce la comunicazione con l’acquirente; i tuoi avvisi d’ordine continuano ad arrivare.
- Conserva i log (giorni): i log non contengono mai dati personali degli acquirenti né credenziali.

Avvisi e log
L’e-mail di avviso giornaliera viene inviata ai destinatari scelti, solo se c’è un’azione da svolgere: richieste di annullamento, ordini non confermati, ordini non importati, fatture rifiutate, inserzioni in errore, feed rifiutati, cron fermo. La scheda Log conserva ogni operazione con il suo dettaglio tecnico, filtrabile per livello e per canale.
Permessi dei dipendenti
Il modulo rispetta i permessi del profilo del dipendente sulla scheda Connettore Amazon. Un profilo in sola lettura consulta tutto ma non può modificare le impostazioni o le credenziali, né inviare un annullamento, un rimborso o una pubblicazione; l’interfaccia lo segnala.
Risoluzione dei problemi
Il test di connessione non riesce
Verifica la regione, l’ID client LWA, il secret e il refresh token. Un refresh token corrisponde a un’applicazione e a un account: rigeneralo dopo ogni modifica dei ruoli dell’applicazione.
Un’inserzione è in errore
Apri Coda ed errori o la scheda prodotto: ogni errore Amazon vi è spiegato con la soluzione. Il codice 90220 segnala un attributo obbligatorio mancante, da completare nella mappatura; il codice 90188 un EAN non riconosciuto. Usa Verifica con Amazon per convalidare la correzione prima dell’invio.
Un ordine non viene importato
La causa è mostrata nella scheda Ordini. Il caso più frequente è uno SKU Amazon che non corrisponde a nessun prodotto: collega le inserzioni esistenti o correggi il riferimento, poi fai clic su Riprova. Verifica anche che la valuta del marketplace sia installata in PrestaShop.
Lo stock o i prezzi non si aggiornano
Controlla l’ultima sincronizzazione nella dashboard e le attività in attesa. Gli aggiornamenti partono all’esecuzione successiva del cron e Amazon li elabora in pochi minuti. Per forzare un invio completo, usa Reinvia tutte le quantità.
Limiti
- Il modulo è stato testato con un simulatore fedele alla documentazione SP-API: fai una prima prova su alcuni prodotti prima di pubblicare tutto il catalogo. Il modulo non garantisce né vendite né conformità alle politiche di Amazon: resti responsabile delle tue inserzioni, della tua IVA e della protezione dei dati sul tuo hosting.
- Gli attributi richiesti variano in base al tipo di prodotto e al marketplace: la copertura mostrata dipende dall’ultimo caricamento dello schema.
- Un ordine spedito in più colli non viene confermato riga per riga: tutte le righe vengono confermate insieme.
- Il cron resta necessario; il modulo non usa le notifiche di Amazon.