Passa al contenuto principale

Etsy

Disponibile

Questa integrazione è disponibile in Frihet. Configurala in Settings → Integrazioni → Etsy.

Connetti il tuo negozio Etsy a Frihet per importare automaticamente ordini, prodotti e dati degli acquirenti. Etsy è il marketplace leader per prodotti artigianali, vintage e creativi, con oltre 90 milioni di acquirenti attivi. Con questa integrazione, ogni vendita nel tuo negozio Etsy viene registrata come entrata in Frihet, le commissioni di Etsy vengono contabilizzate come spese e le vendite internazionali vengono gestite con conversione automatica di valuta.

A cosa serve?​

  • Importare ordini — Ogni vendita su Etsy si converte automaticamente in un'entrata registrata in Frihet con tutti i dettagli dell'ordine
  • Commissioni e fee come spese — Le commissioni di inserzione, transazione e elaborazione di Etsy vengono registrate automaticamente come spese
  • Catalogo sincronizzato — I tuoi prodotti Etsy si riflettono nel catalogo di Frihet
  • Multivaluta — Le vendite internazionali vengono importate con la loro valuta originale e il tasso di cambio
  • Clienti importati — Gli acquirenti di Etsy vengono aggiunti come clienti in Frihet con i loro dati di spedizione

Requisiti​

  • Account venditore attivo su Etsy
  • Piano Frihet Pro o Business
  • Chiave API di Etsy (si ottiene dal Etsy Developer Portal)

Come connettere​

Passaggio 1: Creare un'applicazione su Etsy​

  1. Vai al Etsy Developer Portal
  2. Accedi con il tuo account venditore
  3. Clicca su Create a New App
  4. Inserisci il nome ("Frihet ERP") e la descrizione
  5. Una volta approvata l'applicazione, copia la Chiave API (Keystring)

Passaggio 2: Configurare in Frihet​

  1. In Frihet, vai su Settings → Integrazioni
  2. Cerca Etsy e clicca sulla card
  3. Incolla la tua Chiave API nel campo corrispondente
  4. Clicca su Connetti con Etsy per autorizzare l'accesso tramite OAuth
  5. Accetta i permessi richiesti nella finestra di Etsy
  6. Clicca su Salva

Passaggio 3: Importazione iniziale​

  1. Una volta connesso, clicca su Importa ordini per recuperare lo storico delle vendite
  2. Seleziona l'intervallo di date che desideri importare
  3. Controlla gli ordini importati e verifica che i dati siano corretti

Dati sincronizzati​

DatoDirezioneDettagli
OrdiniEtsy → FrihetID, importo, data, prodotti, indirizzo di spedizione
ProdottiEtsy → FrihetNome, prezzo, quantità, varianti
ClientiEtsy → FrihetNome dell'acquirente, email (se disponibile), indirizzo
CommissioniEtsy → FrihetListing fees, transaction fees, payment processing fees come spese
ValutaEtsy → FrihetValuta originale della vendita con tasso di cambio
Stato dell'ordineEtsy → FrihetPagato, spedito, completato, rimborsato

Casi d'uso​

Artigiano con vendite internazionali​

Vendi gioielli artigianali su Etsy ad acquirenti di tutto il mondo. Ogni vendita viene importata in Frihet con la valuta originale (USD, GBP, EUR) e il tasso di cambio effettivo. Le commissioni di Etsy vengono registrate automaticamente come spese, fornendoti una chiara visione del margine reale di ogni vendita. Alla fine del trimestre, hai tutti i dati per la tua dichiarazione fiscale.

Venditore di prodotti vintage​

Gestisci un ampio catalogo di prodotti vintage su Etsy. Ogni vendita aggiorna il tuo catalogo in Frihet e registra l'entrata. Puoi generare report di redditività per prodotto e vedere quali categorie di prodotti hanno un margine migliore una volta dedotte le commissioni di Etsy.

Creatore digitale con download​

Vendi modelli, illustrazioni o risorse digitali su Etsy. Le vendite vengono importate automaticamente senza intervento manuale. Poiché non ci sono costi di spedizione per i prodotti digitali, puoi monitorare con precisione il margine netto: prezzo di vendita meno commissioni di Etsy.

Risoluzione dei problemi​

Errore di connessione​

  • Verifica che la Chiave API sia corretta e che l'applicazione sia attiva nell'Etsy Developer Portal
  • Controlla che l'autorizzazione OAuth non sia scaduta — riconnetti da Settings se necessario
  • Assicurati che il tuo account Etsy sia in buono stato (non sospeso o limitato)

Ordini non importati​

  • Conferma di avere vendite nell'intervallo di date selezionato
  • Vengono importati solo gli ordini con pagamento completato — quelli in sospeso vengono esclusi
  • Se hai molti ordini, l'importazione potrebbe richiedere alcuni minuti — attendi che si completi

Commissioni non registrate​

  • Le commissioni vengono importate come spese separate, associate all'ordine corrispondente
  • Verifica che l'importazione delle commissioni sia attivata nella configurazione dell'integrazione
  • Le commissioni pubblicitarie di Etsy (Etsy Ads) vengono importate separatamente

Valuta errata​

  • Frihet utilizza la valuta della transazione originale su Etsy
  • Se la tua contabilità è in EUR e la vendita è stata in USD, Frihet applica il tasso di cambio del giorno della transazione
  • Puoi regolare manualmente il tasso di cambio dal dettaglio della spesa/entrata

Passi successivi​