Passa al contenuto principale

Shopify

Disponibile

Questa integrazione è attiva e pronta all'uso in tutti i piani Pro.

Collega il tuo negozio Shopify a Frihet. Gli ordini vengono importati automaticamente e generano fatture.

A cosa serve?​

Con Shopify integrato:

  • Importa ordini — Importa ordini da Shopify come fatture in Frihet (prefisso SHOP-)
  • Importa prodotti — Porta il tuo catalogo Shopify in Frihet
  • Deduplicazione automatica — Gli ordini già importati non vengono duplicati
  • Dati del cliente — Email, indirizzo e telefono si sincronizzano automaticamente
  • Pagamenti automatici — Se Shopify ha elaborato il pagamento, Frihet contrassegna la fattura come pagata

Requisiti​

  • Negozio Shopify attivo — Con prodotti elencati
  • Accesso amministratore — Per autorizzare l'app
  • Frihet Pro o superiore

Collega Shopify​

Passaggio 1: Apri Frihet​

  1. Vai a Impostazioni → Integrazioni
  2. Cerca Shopify
  3. Clicca su Collega

Passaggio 2: Autorizza su Shopify​

  1. Inserisci il nome del tuo negozio (es: mitienda o mitienda.myshopify.com)
  2. Clicca su Collega a Shopify
  3. Verrai reindirizzato alla pagina di autorizzazione di Shopify
  4. Accedi con il tuo account Shopify se non lo hai già fatto
  5. Vedrai i permessi di cui Frihet ha bisogno:
    • Leggi ordini
    • Leggi clienti
    • Leggi prodotti
  6. Clicca su Installa app
  7. Tornerai automaticamente a Frihet con la connessione attivata

Passaggio 3: Configura la sincronizzazione​

In Frihet, dopo l'autorizzazione:

  1. Scegli cosa sincronizzare:

    • ✅ Nuovi ordini — Automatico
    • ✅ Crea fatture automatiche — Automatico
    • ⚪ Sincronizza clienti — Opzionale
    • ⚪ Sincronizza prodotti — Opzionale
    • ⚪ Aggiorna inventario — Opzionale

  2. Salva modifiche

Prima sincronizzazione​

La prima volta:

  1. Frihet importa i tuoi ultimi 100 ordini (i più recenti)
  2. Crea clienti (se non esistono)
  3. Crea fatture per ogni ordine
  4. Questo richiede 2-5 minuti a seconda della quantità

Torna a Fatturazione → Fatture tra 5 minuti e vedrai i tuoi ordini Shopify come fatture.

Come funziona la sincronizzazione​

Nuovo ordine su Shopify​

1. Il cliente acquista nel tuo negozio Shopify
   ↓
2. Shopify elabora l'ordine
   ↓
3. Frihet rileva il nuovo ordine (ogni 15 minuti)
   ↓
4. Sincronizza automaticamente con Frihet:
   - Cliente (se è nuovo, lo crea)
   - Prodotti
   - Fattura con stato "Pagata" (se ha pagato su Shopify)
   ↓
5. Appare nel tuo elenco Frihet

Dati sincronizzati​

DatoDa Shopify a Frihet
ID ordineNumero di fattura
ProdottiRighe della fattura
Prezzo ShopifyPrezzo unitario
QuantitàQuantità
ClienteNome, email, indirizzo di spedizione
Data ordineData della fattura
PagamentoMetodo (carta, PayPal, ecc.)
SpedizioneInclusa come riga se applicabile
ImposteCalcolate in base alla giurisdizione

Stati dell'ordine​

Shopify → Frihet​

Stato ShopifyStato Frihet
In sospesoIn sospeso
ConfermatoIn sospeso
CompletatoPagata ✅
AnnullatoAnnullata
RestituitoParzialmente rimborsato

Esempio pratico​

Il cliente acquista nel tuo negozio Shopify​

Ordine #1009 su Shopify
Cliente: María García
Email: maria@example.com
Indirizzo: Via Principale 42, Madrid 28001

Prodotti:
- 1x Maglietta blu S = €25,00
- 2x Occhiali da sole = €40,00 cad. = €80,00

Subtotale: €105,00
Spedizione: €5,95
Imposte: €23,19 (21%)
Totale pagato: €134,14

Metodo di pagamento: Carta di credito

Automaticamente in Frihet​

Fattura #1009
Data: 10 feb 2025
Cliente: María García

Righe:
- 1x Maglietta blu S = €25,00
- 2x Occhiali da sole = €80,00
- Spedizione = €5,95

Subtotale: €110,95
IVA (21%): €23,29 (se configurato in Frihet)
Totale: €134,24

Stato: Pagata ✅ (Shopify ha elaborato il pagamento)

Creato automaticamente. Senza fare nulla.

Configurazioni avanzate​

Mappatura dei prodotti​

Per impostazione predefinita, Frihet importa i prodotti come descrizione di riga. Puoi:

  1. Vai a Impostazioni → Shopify
  2. Attiva "Sincronizza catalogo prodotti"
  3. Frihet crea prodotti nel tuo catalogo
  4. Ordini futuri useranno questi prodotti (con aggiornamento di prezzo)

Utile se vuoi riutilizzare i prodotti nei preventivi.

Includere/escludere ordini specifici​

Puoi dire a Frihet:

  • "Non sincronizzare ordini annullati" — Esclude automaticamente
  • "Sincronizza solo dopo il 1 gennaio" — Solo ordini recenti
  • "Escludi cliente specifico" — Non creare fatture per quel cliente

Configura in Impostazioni → Integrazioni → Shopify → Filtri avanzati

Imposte e commissioni​

Shopify può includere:

  • Tasse (imposte) — Si sincronizzano come riga separata
  • Tariffe app — Puoi escluderle dalla fattura
  • Sconti — Si deducono in una riga separata

In Frihet puoi regolare cosa includere nella fattura finale.

Sincronizzazione dei clienti​

Se attivi "Sincronizza clienti":

  • Ogni nuovo cliente su Shopify viene importato in Frihet
  • Email, telefono, indirizzo si sincronizzano
  • Se il cliente esiste già, le sue informazioni vengono aggiornate

Utile per avere una vista unificata dei tuoi clienti.

Pagina dei prodotti​

Con "Sincronizza prodotti" attivo:

  1. Frihet importa il tuo catalogo Shopify

  2. Vedi tutti i prodotti con:

    • Nome
    • Prezzo
    • SKU
    • Descrizione

  3. Puoi usarli in nuove fatture manuali (non solo ordini)

Se modifichi il prezzo su Shopify, si aggiorna automaticamente.

Prova l'integrazione​

Test ordine​

  1. Vai al tuo negozio Shopify
  2. Effettua un ordine di prova (come cliente)
  3. In Frihet, attendi fino a 15 minuti
  4. Vai a Fatturazione → Fatture
  5. Dovresti vedere la fattura creata

Se non appare:

  • Verifica che Shopify sia collegato ✅
  • L'ordine su Shopify deve avere lo stato "Completato"
  • Ricarica Frihet (F5)
  • Controlla Impostazioni → Integrazioni → Log di Shopify

Rimborsi e annullamenti​

Il cliente annulla l'ordine su Shopify​

  1. Modifichi lo stato in "Annullato" su Shopify
  2. Frihet lo rileva alla prossima sincronizzazione
  3. La fattura viene contrassegnata come "Annullata"

Elabori il rimborso su Shopify​

Se rimborsi parzialmente:

  1. Shopify registra il rimborso
  2. Frihet lo rileva
  3. Puoi creare una nota di credito automaticamente in Frihet
  4. O crearla manualmente se lo preferisci

Limitazioni​

  • Shopify → Frihet (sincronizzazione unidirezionale)

    • Le modifiche in Frihet non si sincronizzano con Shopify
    • Se modifichi una fattura in Frihet, Shopify non si aggiorna

  • Non sincronizza bozze di ordini — Solo ordini completati

  • Nessun accesso alle fatture Shopify — Se Shopify ha generato la fattura, Frihet non può vederla

  • Inventario — Solo lettura, nessun aggiornamento automatico

Risoluzione dei problemi​

"Non vedo i miei ordini Shopify"​

  • Attendi fino a 15 minuti per la prima sincronizzazione
  • Gli ordini devono essere nello stato "Completato" o "In elaborazione"
  • Ricarica Frihet (F5 o Cmd+Shift+R)
  • Verifica che Shopify sia collegato in Impostazioni

"Fatture duplicate"​

  • Può succedere se hai sincronizzato due volte
  • Elimina le duplicate da Fatturazione (seleziona più elementi e "Elimina")
  • Poi disconnetti e riconnetti

"¿Disconnettere elimina le mie fatture?"​

No. Le fatture già create in Frihet rimangono. Disconnettere solo:

  • Ferma nuove sincronizzazioni
  • Nuovi ordini da Shopify non vengono sincronizzati

Per disconnettere:

  1. Impostazioni → Integrazioni → Shopify
  2. Disconnetti
  3. Conferma

"¿Posso collegare più negozi Shopify?"​

Attualmente, Frihet supporta un negozio Shopify per account. Se ne hai più di uno:

  • Opzione 1: Crea account Frihet separati (uno per negozio)
  • Opzione 2: Contatta il supporto per consultare opzioni avanzate

Prossimi passi​

Precedente: WooCommerce