DataFirefly Amazon Connector: collegare PrestaShop ad Amazon Seller Central

Installazione

Installa il modulo da Moduli > Gestione moduli > Carica un modulo inviando il file ZIP. È richiesta l’estensione PHP cURL.

All’installazione il modulo crea le sue tabelle, una scheda Amazon Connector nel menu Vendi, un corriere «Amazon» riservato agli ordini importati (il cliente non lo vede mai) e due stati d’ordine: «Amazon: in attesa di spedizione» e «Amazon FBA: spedito».

Preparare l’account Amazon

Il modulo si collega al tuo account venditore con la tua applicazione privata Selling Partner API. Serve un account Seller Central professionale.

1. In Seller Central apri App e servizi > Sviluppa app e registrati come sviluppatore privato, se non l’hai già fatto.
2. Crea un’applicazione e richiedi i ruoli necessari alle funzioni che userai: Product Listing e Pricing per il catalogo, Inventory and Order Tracking per gli ordini, Direct-to-Consumer Shipping (Restricted) per ricevere indirizzo di consegna ed e-mail dell’acquirente, Amazon Fulfillment per lo stock FBA, Finance and Accounting per i rimborsi, Tax Invoicing per l’invio delle fatture.
3. Autorizza l’applicazione sul tuo account per ottenere un refresh token e annota ID client LWA e secret client.
4. Copia il tuo Merchant Token da Impostazioni > Info account.

Connessione e marketplace

In Amazon Connector > Impostazioni scegli la regione (Europa, Nord America o Estremo Oriente), inserisci client LWA, secret, refresh token e Merchant Token, poi salva. I segreti sono cifrati nel database; lascia i campi vuoti per mantenere i valori salvati.

Nella dashboard clicca su Prova la connessione. I marketplace del tuo account compaiono nella scheda Marketplace, disattivati per impostazione predefinita. Per ognuno imposta:

• l’attivazione;
• la lingua dei contenuti inviati (titolo, descrizione);
• i prezzi IVA inclusa o esclusa, secondo il paese;
• la sincronizzazione dei prezzi, da disattivare se usi un repricer Amazon;
• la maggiorazione percentuale, l’importo fisso e l’arrotondamento (nessuno, x,99, x,90, intero).

Attività cron

La sincronizzazione funziona tramite un’attività cron, idealmente ogni 5-15 minuti. La dashboard mostra l’URL protetto da token e il comando da riga di comando:

php /percorso/di/modules/dfamazonconnector/cron.php --shop=1

A ogni esecuzione il modulo importa gli ordini, conferma le spedizioni, invia fatture e annullamenti, legge rimborsi e stock FBA, poi invia inserzioni, stock e prezzi in attesa sotto forma di feed raggruppati. Un avviso rosso compare nel modulo se l’attività non è stata eseguita da più di un’ora. Il pulsante Nuovo token invalida il vecchio URL.

Associazione delle categorie

L’associazione serve solo a creare nuove schede su Amazon. Un prodotto venduto su un ASIN esistente, o collegato tramite EAN, ha bisogno solo di un’offerta.

Nella scheda Associazione categorie scegli una categoria PrestaShop e un tipo di prodotto Amazon (ricerca per parole chiave integrata). Un prodotto usa l’associazione della sua categoria predefinita o, in mancanza, quella del genitore più vicino.

• Browse node: il nodo di navigazione Amazon, facoltativo secondo il tipo di prodotto.
• Tema di variazione: per esempio SIZE_NAME/COLOR_NAME. Se indicato, le combinazioni vengono raggruppate in famiglia padre-figlio; se vuoto, ogni combinazione viene pubblicata come prodotto indipendente.
• Attributi delle combinazioni e Caratteristiche: associano un attributo Amazon a un gruppo di attributi o a una caratteristica PrestaShop.
• Attributi fissi: valori inviati così come sono, nel formato Listings Items. Variabili disponibili: {marketplace_id}, {language_tag}, {currency}, {reference}, {ean13}, {mpn}, {brand}.

Il pulsante Attributi obbligatori legge lo schema del tipo di prodotto da Amazon ed elenca gli attributi che il modulo non compila da solo. Per ciascuno scegli una fonte (valore fisso, caratteristica, attributo di combinazione) e poi Applica: i campi JSON vengono compilati automaticamente.

Pubblicare i prodotti

Dalla scheda prodotto

La scheda Moduli della pagina prodotto contiene un 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.
• Attributi aggiuntivi: JSON unito dopo gli attributi fissi della categoria; un valore null rimuove un attributo.
• Marketplace: deseleziona un paese per rimuovere il prodotto da quel marketplace.

La tabella «Cosa verrà inviato ad Amazon» mostra, per combinazione e paese, prezzo, prezzo scontato con le date, prezzo minimo, prezzo Business e quantità. Sono disponibili quattro azioni: Verifica con Amazon (convalida senza pubblicare, errori mostrati attributo per attributo), Invia ora, Aggiungi alla prossima sincronizzazione e Aggiorna stato.

In blocco

La scheda Prodotti elenca il catalogo con lo stato di ogni prodotto per paese (attivo, in corso, inattivo, errore). Filtra per nome, categoria o stato, seleziona i prodotti o l’opzione «Tutti i prodotti che corrispondono al filtro», poi applica un’azione: attiva e pubblica, pubblica di nuovo, invia prezzi, invia quantità, disattiva (quantità 0) o elimina da Amazon.

Inserzioni già presenti su Amazon

Il pulsante Collega le inserzioni Amazon esistenti della dashboard richiede ad Amazon il report delle tue inserzioni. Alla successiva esecuzione del cron, ogni SKU viene collegato al prodotto PrestaShop con lo stesso SKU, riferimento o EAN. Gli SKU non trovati sono elencati nel registro.

SKU Amazon

Lo SKU viene creato alla prima pubblicazione secondo l’impostazione scelta: riferimento, EAN13 o modello (predefinito PS{id_product}-{id_product_attribute}). Uno SKU esistente non cambia mai, anche se cambia il riferimento.

Prezzi

Il prezzo viene calcolato nella valuta del marketplace con il gruppo prezzi scelto, poi si applicano maggiorazione, importo fisso e arrotondamento del paese. Opzioni della scheda Impostazioni:

• 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 le date dello sconto PrestaShop. Uno sconto creato, modificato o eliminato aggiorna subito Amazon; le promozioni con date e le regole di catalogo vengono ricontrollate ogni notte.
• Margine minimo sul prezzo di acquisto: invia un prezzo minimo (prezzo di acquisto convertito più il margine, IVA del paese inclusa) sotto il quale un repricer non può vendere.
• Prezzi Amazon Business: il prezzo del gruppo clienti scelto diventa il prezzo Business e i suoi sconti per quantità diventano livelli (massimo 5). Solo per venditori registrati ad Amazon Business.

Gli aggiornamenti di prezzo riguardano solo le offerte gestite dal modulo: un’offerta creata a mano in Seller Central per un altro pubblico viene mantenuta.

Stock e FBA

Ogni movimento di stock in PrestaShop mette lo SKU in coda di invio. Impostazioni disponibili: scorta di sicurezza (unità non offerte su Amazon), quantità massima, tempo di lavorazione, quantità 0 per i prodotti disattivati e risincronizzazione completa ogni notte dopo le 3.

I prodotti FBA non ricevono quantità da PrestaShop. L’opzione Leggi lo stock FBA recupera ogni ora la quantità disponibile nei magazzini Amazon, visibile nella scheda prodotto; Copia lo stock FBA in PrestaShop la applica allo stock del negozio dei prodotti FBA.

Ordini

Gli ordini vengono letti con l’API Orders v2026-01-01 a partire dalla data di inizio configurata. Un ordine in attesa di pagamento viene memorizzato senza essere creato; viene importato appena Amazon lo rende spedibile.

Ogni ordine importato crea o riutilizza un cliente ospite (uno per acquirente o un cliente unico, a scelta), un indirizzo «Amazon + numero d’ordine» e un ordine PrestaShop con il corriere Amazon, prezzi e spese di spedizione Amazon, il numero d’ordine Amazon come ID transazione e, facoltativamente, la data di acquisto Amazon. Lo stock viene scalato come per una vendita del negozio.

Gli ordini FBA vengono importati una volta spediti, con lo stato «Amazon FBA: spedito». L’opzione «Gli ordini FBA non modificano lo stock del negozio» rimette in stock le quantità dopo la creazione.

La scheda Ordini elenca tutti gli ordini Amazon con i filtri «Da spedire», «Richieste di annullamento», «Rimborsati» e «Non importati». Un ordine non importato (SKU sconosciuto, valuta o paese non configurati) mostra la causa e un pulsante Riprova.

Spedizioni

Scegli nelle impostazioni gli stati che confermano la spedizione (per esempio Spedito). Quando un ordine Amazon passa a uno di questi stati, il modulo invia ad Amazon il codice corriere, il numero di tracking e la data di spedizione. Se il tracking non è ancora stato inserito, attende fino a un’ora prima di confermare senza tracking.

La tabella di associazione dei corrieri collega ogni corriere PrestaShop a un codice corriere Amazon. Gli ordini importati usano il corriere Amazon: cambia il corriere dell’ordine prima della spedizione per inviare il codice corretto. Il blocco Amazon della pagina ordine offre anche il pulsante Conferma la spedizione ora.

Fatture

Se sei iscritto al servizio di calcolo IVA di Amazon con l’opzione di caricare le tue fatture, attiva Carica le fatture PrestaShop su Amazon. Dopo la conferma di spedizione, la fattura PDF dell’ordine viene inviata con numero, totale e importo IVA. Lo stato (inviata, in attesa, rifiutata) compare nell’elenco e nella pagina ordine.

Annullamenti

Quando un acquirente chiede l’annullamento di un ordine non spedito, l’ordine viene evidenziato in rosso nell’elenco e nella sua pagina, con il motivo indicato dall’acquirente. Non spedire: annulla l’ordine dal blocco Amazon scegliendo il motivo, oppure attiva Annulla su Amazon quando l’ordine viene annullato in PrestaShop. Un annullamento chiesto dall’acquirente parte con il motivo BuyerCanceled e non pesa sul tuo tasso di annullamento.

Al contrario, un ordine annullato su Amazon passa in PrestaShop allo stato di annullamento scelto, senza e-mail al cliente.

Rimborsi

Con l’opzione Leggi i rimborsi Amazon, i rimborsi effettuati in Seller Central vengono letti tramite l’API Finances. Ciascuno viene annotato nella nota privata dell’ordine con data, articoli e importo netto. Quando tutte le unità sono rimborsate, l’ordine passa allo stato scelto (Rimborsato per impostazione predefinita). L’importo mostrato è l’importo netto addebitato sul tuo account Amazon, dopo le commissioni rimborsate.

Dashboard, avvisi e registro

La dashboard mostra inserzioni attive e in errore, ordini delle ultime 24 ore e degli ultimi 30 giorni, attività in attesa, ultima sincronizzazione, errori Amazon più frequenti raggruppati per codice e ultimi feed inviati.

L’e-mail di avviso giornaliera viene inviata dopo le 8 ai destinatari scelti, solo quando serve un intervento: richieste di annullamento, ordini non confermati più di 2 giorni dopo l’acquisto, ordini non importati, fatture rifiutate, inserzioni in errore, feed rifiutati, cron fermo. Il pulsante Invia un’e-mail di prova verifica la configurazione.

La scheda Log conserva ogni operazione (feed, ordini, spedizioni, rimborsi, FBA, errori) con i dettagli tecnici, filtrabile per livello e canale. La durata di conservazione si imposta nelle impostazioni.

Risoluzione dei problemi

La prova di connessione fallisce

Controlla regione, client LWA, secret e refresh token. Un refresh token appartiene a un’applicazione e a un account: rigeneralo dopo aver modificato i ruoli dell’applicazione.

Un’inserzione è in errore

Apri la scheda prodotto: gli errori Amazon compaiono sotto ogni inserzione. Il codice 90220 indica un attributo obbligatorio mancante, da completare nell’associazione di categoria o negli attributi aggiuntivi del prodotto. Usa Verifica con Amazon per convalidare la correzione prima dell’invio.

Un ordine non viene importato

Il motivo compare 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 clicca su Riprova. Verifica anche che valuta e paese di consegna siano attivi in PrestaShop.

Stock o prezzi non si aggiornano

Controlla l’ultima sincronizzazione nella dashboard e nel registro. Gli aggiornamenti partono alla successiva esecuzione del cron e Amazon li elabora in pochi minuti. Per forzare un invio completo usa Reinvia tutte le quantità.

Compatibilità

• PrestaShop 8.0 – 9.x, lo stesso ZIP copre entrambi i rami.
• Multinegozio e multilingua.
• Regioni Amazon Europa, Nord America ed Estremo Oriente.
• Architettura ModuleAdminController, senza dipendenze Composer.
• Interfaccia disponibile in francese, inglese, spagnolo, tedesco, italiano, olandese, polacco e portoghese.