# Sincronizzazione Etsy per PrestaShop — Documentazione > 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.… - Pagina: - Lingua: it - Aggiornato il: 2026-07-06 - Altre lingue: [fr](https://www.datafirefly.com/documentation/sync-etsy-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/sync-etsy-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/sync-etsy-prestashop/index.md), [de](https://www.datafirefly.com/de/documentation/sync-etsy-prestashop/index.md), [pl](https://www.datafirefly.com/pl/documentation/sync-etsy-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/sync-etsy-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/sync-etsy-prestashop/index.md) - Indice: 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 1. Nel back office di PrestaShop, vai su **Moduli > Gestore dei moduli**. 2. Fai clic su **Carica un modulo** e trascina il file `dfetsy.zip`. 3. 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. 1. Vai sul portale sviluppatori di Etsy (etsy.com/developers) e crea una nuova applicazione. 2. Etsy ti fornisce una chiave API chiamata **keystring** (è il tuo Client ID). 3. 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**: 1. Incolla la tua **keystring** nel campo apposito e fai clic su **Salva**. 2. Fai clic su **Connetti il mio shop Etsy**. Si apre una scheda Etsy che ti chiede di autorizzare l'applicazione. 3. 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. 4. 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/null ``` Il 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.