Sincronizzazione Etsy per PrestaShop — Documentazione
Installa e configura Sincronizzazione Etsy: connessione OAuth a Etsy, esportazione prodotti, sincronizzazione stock, importazione ordini e cron.
Sincronizzazione Etsy collega il tuo negozio PrestaShop al tuo shop Etsy: esporta i tuoi prodotti come inserzioni, mantiene lo stock sincronizzato e importa automaticamente i tuoi ordini Etsy in PrestaShop. Questa guida copre l’installazione, la connessione a Etsy, le impostazioni e il funzionamento quotidiano.
Compatibile con PrestaShop 8.0 a 9.x, multi-negozio. Il modulo usa l’API ufficiale Etsy Open v3 e una connessione OAuth 2.0 (con PKCE): non inserisci mai la tua password Etsy in PrestaShop.
Prerequisiti
- Un negozio PrestaShop 8 o 9 funzionante, con accesso al back office.
- Uno shop Etsy attivo.
- Un’applicazione registrata sul portale sviluppatori di Etsy (gratuita) — vedi il passaggio successivo.
- Un cron del server (o un servizio di cron esterno) per automatizzare la sincronizzazione dello stock e l’importazione degli ordini.
Installazione
- Nel back office di PrestaShop, vai su Moduli > Gestore dei moduli.
- Fai clic su Carica un modulo e trascina il file
dfetsy.zip. - Una volta installato, fai clic su Configura. Arrivi alla pagina di amministrazione del modulo, organizzata in schede: Connessione, Prodotti, Ordini, Impostazioni, Cron, Log.
Crea la tua applicazione Etsy
Il modulo si connette a Etsy tramite la tua applicazione sviluppatore. La procedura è gratuita e richiede pochi minuti.
- Vai sul portale sviluppatori di Etsy (etsy.com/developers) e crea una nuova applicazione.
- Etsy ti fornisce una chiave API chiamata keystring (è il tuo Client ID).
- Nella configurazione della tua applicazione Etsy, dichiara l’URL di reindirizzamento (Callback URL) esattamente come mostrato nella scheda Connessione del modulo.
L’URL di reindirizzamento deve essere copiato in modo identico. Qualsiasi differenza (http/https, presenza o assenza di uno slash finale) farà fallire la connessione OAuth.
Connessione a Etsy
Nella scheda Connessione:
- Incolla la tua keystring nel campo apposito e fai clic su Salva.
- Fai clic su Connetti il mio shop Etsy. Si apre una scheda Etsy che ti chiede di autorizzare l’applicazione.
- Dopo l’autorizzazione vieni reindirizzato a una pagina di conferma. Torna al back office e ricarica la pagina: il banner deve mostrare Connesso con il nome e l’ID del tuo shop.
- Usa il pulsante Prova la connessione per verificare che tutto funzioni.
Il token di accesso viene rinnovato automaticamente dal modulo. Il pulsante Disconnetti rimuove i token e l’associazione allo shop.
Impostazioni
La scheda Impostazioni raggruppa il comportamento di sincronizzazione e gli attributi Etsy predefiniti.
Sincronizzazione
- Invia lo stock PS a Etsy: ogni variazione di quantità viene messa in coda e inviata al successivo passaggio del cron.
- Aggiorna l’inserzione a ogni salvataggio del prodotto: riesporta automaticamente l’inserzione quando modifichi un prodotto collegato.
- Importa gli ordini Etsy: attiva l’importazione automatica degli ordini pagati.
- Invia le immagini del prodotto: allega le immagini del prodotto all’inserzione durante l’esportazione.
- Sincronizza i prezzi: invia il prezzo PrestaShop a Etsy.
- Ricarico prezzo Etsy (%): applica una percentuale al prezzo esportato per assorbire le commissioni Etsy, senza toccare il tuo prezzo PrestaShop.
- Lingua di esportazione: lingua usata per il titolo e la descrizione delle inserzioni.
Attributi Etsy predefiniti
- Chi lo ha realizzato / Quando: valori obbligatori di Etsy (who_made / when_made) applicati alle nuove inserzioni.
- Taxonomy ID: categoria Etsy predefinita delle inserzioni (consulta la Seller Taxonomy di Etsy).
- Profilo di spedizione e Politica di reso: elenchi caricati automaticamente dal tuo shop Etsy una volta connesso.
- Stato dell’inserzione all’esportazione: Bozza (consigliato — rivedi prima di pubblicare) o Attivo (pubblicazione immediata, si applicano le commissioni di inserzione di Etsy).
Importazione degli ordini
- Stato dell’ordine: stato PrestaShop assegnato agli ordini importati.
- Corriere: corriere associato per impostazione predefinita.
- Invia le email PrestaShop all’importazione: disattivato per impostazione predefinita, perché Etsy notifica già l’acquirente. Lascialo disattivato nella maggior parte dei casi.
Esportare prodotti su Etsy
Nella scheda Prodotti, cerca un articolo per nome, referenza o ID.
- Esporta su Etsy crea un’inserzione con titolo, descrizione, tag, immagini e prezzo del prodotto. L’inserzione viene creata come bozza (o attiva a seconda delle impostazioni), poi viene inviato l’inventario (SKU, prezzo, quantità).
- Aggiorna reinvia le informazioni a un’inserzione già collegata.
- Collega (listing ID) associa manualmente un prodotto PrestaShop a un’inserzione Etsy esistente, inserendo l’ID dell’inserzione.
- Scollega rimuove l’associazione (l’inserzione Etsy non viene eliminata).
Nella versione 1.0, un prodotto viene esportato come referenza unica: vengono usati la quantità totale e il prezzo base. I prodotti con combinazioni sono quindi gestiti come un unico SKU. Le variazioni native di Etsy sono previste per una versione successiva.
Sincronizzazione dello stock
Quando la quantità di un prodotto collegato cambia in PrestaShop, un lavoro di sincronizzazione viene aggiunto a una coda deduplicata. Nessuna chiamata a Etsy viene effettuata durante la navigazione: la coda è elaborata dal cron, il che evita qualsiasi rallentamento del front e del back office. Puoi anche avviare l’elaborazione manualmente dalla scheda Cron.
Importazione degli ordini
Gli ordini Etsy pagati vengono importati come ordini PrestaShop:
- Viene creato un cliente ospite (o riutilizzato se ne esiste già uno per quell’email).
- L’indirizzo di spedizione Etsy viene riportato. Se il paese non viene riconosciuto, l’ordine viene ignorato e un messaggio appare nei log.
- L’importo pagato viene applicato al centesimo: il totale dell’ordine PrestaShop corrisponde all’importo pagato su Etsy.
- La nota lasciata dall’acquirente viene allegata come messaggio nel thread di assistenza dell’ordine.
- La deduplicazione per ID ordine Etsy (receipt) evita qualsiasi doppia importazione.
Un ordine Etsy per un’inserzione non collegata a un prodotto PrestaShop viene ignorato (un avviso viene scritto nei log). Assicurati che i prodotti che vendi su Etsy siano correttamente collegati sul lato PrestaShop.
Configurare il cron
La scheda Cron mostra un URL protetto da un token. Chiamalo ogni 5-15 minuti per elaborare la coda (stock e prodotti) e importare i nuovi ordini.
*/10 * * * * curl -s "https://il-tuo-negozio/index.php?fc=module&module=dfetsy&controller=cron&token=IL_TUO_TOKEN" > /dev/nullIl pulsante Esegui la coda ora consente di avviare un’elaborazione manuale per testare.
Senza un passaggio regolare del cron per diverse settimane, il token di aggiornamento di Etsy può scadere. È sufficiente riconnettersi dalla scheda Connessione per rigenerarlo.
Log e diagnostica
La scheda Log mostra il registro degli eventi (esportazione, stock, importazione, errori). Se una sincronizzazione va male, consultalo per primo: ogni errore Etsy è registrato con il suo messaggio. Le voci più vecchie di 30 giorni vengono eliminate automaticamente.
Limitazioni della versione 1.0
- Un prodotto = un’inserzione a referenza unica (nessuna variazione nativa di Etsy).
- Un solo shop Etsy (uno shop connesso alla volta).
- Il tracciamento della spedizione non viene ancora restituito a Etsy.
- La ripartizione dettagliata delle spese di spedizione per riga non viene ricostruita (il totale pagato su Etsy fa fede).
Domande frequenti
Le mie inserzioni vengono pubblicate automaticamente?
Per impostazione predefinita no: vengono create come bozza così puoi rivederle prima di pubblicarle su Etsy. Puoi scegliere lo stato «Attivo» nelle impostazioni per pubblicare immediatamente.
Come evito la vendita in eccesso tra i due canali?
Attiva la sincronizzazione dello stock e un cron regolare: ogni vendita o variazione di quantità in PrestaShop aggiorna la quantità Etsy al successivo passaggio del cron.
Dove trovo il codice sorgente?
Il codice completo è incluso nello ZIP, non cifrato (PSR-4, autoloader SPL), per audit o personalizzazione.