WooCommerce
Questa integrazione è attiva e pronta all'uso su tutti i piani Pro.
Collega il tuo negozio WooCommerce a Frihet. Gli ordini si sincronizzano automaticamente e generano fatture.
A cosa serve?
Con WooCommerce integrato:
- Sincronizzazione ordini — Nuovi ordini appaiono in Frihet automaticamente
- Fatture automatiche — Vengono create senza che tu debba fare nulla
- Dati cliente — Nome, email, indirizzo dell'ordine vengono importati
- Controllo dell'inventario — Prodotti sincronizzati tra entrambe le piattaforme (opzionale)
Requisiti
- WordPress con WooCommerce installato — Il tuo negozio online
- Accesso a WordPress — Utente admin o con permessi per i plugin
- Frihet Pro o superiore
Installa il plugin di connessione
Passo 1: Scarica il plugin
- In WordPress, vai su Plugin → Aggiungi nuovo
- Cerca "Frihet WooCommerce"
- Clicca su Installa
- Poi Attiva
Oppure scaricalo manualmente da: frihet.io/plugins/woocommerce
Passo 2: Autorizza la connessione
- In WordPress, vai su Impostazioni → Frihet WooCommerce
- Clicca su "Connetti con Frihet"
- Verrai reindirizzato a Frihet
- Autorizza l'accesso
- Reindirizza automaticamente a WordPress
Passo 3: Configura cosa sincronizzare
In Impostazioni → Frihet WooCommerce, scegli:
- ✅ Sincronizza ordini — Consigliato
- ✅ Crea fatture automatiche — Consigliato
- ⚪ Sincronizza clienti — Opzionale
- ⚪ Sincronizza inventario — Solo se ne hai bisogno
Salva le modifiche.
Come funziona la sincronizzazione
Nuovo ordine in WooCommerce
1. Il cliente acquista nel tuo negozio
↓
2. WooCommerce riceve l'ordine
↓
3. Il plugin rileva il cambiamento
↓
4. Invia dati a Frihet (in tempo reale)
↓
5. Frihet crea automaticamente:
- Cliente (se è nuovo)
- Fattura con i prodotti dell'ordine
↓
6. La fattura appare nel tuo elenco Frihet
Dati sincronizzati
| Dato | Da WooCommerce a Frihet |
|---|---|
| Numero d'ordine | Numero di fattura |
| Prodotti | Righe della fattura |
| Quantità | Quantità |
| Prezzo | Prezzo unitario |
| Cliente | Nome, email, indirizzo |
| Data ordine | Data della fattura |
| Stato dell'ordine | Stato del pagamento |
| IVA (se configurato) | IVA dettagliata |
Stati dell'ordine e della fattura
WooCommerce → Frihet
| Stato WooCommerce | Stato Frihet |
|---|---|
| In attesa di pagamento | In attesa |
| In elaborazione | In attesa |
| Completato | Pagata ✅ |
| Annullato | Annullata |
| Rimborso | Rimborso parziale |
Se il cliente contrassegna l'ordine come "Completato", la fattura viene contrassegnata come pagata automaticamente.
Esempio reale
Il cliente acquista nel tuo negozio
Ordine in WooCommerce:
Ordine #1234 - 10 feb 2025
- 2x Prodotto A @ €50 = €100
- 1x Prodotto B @ €30 = €30
Totale: €130 + €27,30 IVA (21%) = €157,30
Cliente: Juan García
Email: juan@example.com
In Frihet automaticamente
Fattura creata:
Fattura #1234
Data: 10 feb 2025
Cliente: Juan García
- 2x Prodotto A @ €50 = €100
- 1x Prodotto B @ €30 = €30
Subtotale: €130,00
IVA (21%): €27,30
Totale: €157,30
Stato: Pagata ✅
La fattura appare nel tuo elenco. Senza fare nulla.
Configurazioni avanzate
Mappatura delle categorie di prodotto
Se desideri che i prodotti di WooCommerce vengano creati come prodotti in Frihet:
- Vai su Impostazioni → Frihet WooCommerce
- Attiva "Sincronizza prodotti"
- Scegli se sincronizzare l'inventario (stock)
Ciò è utile se desideri riutilizzare questi prodotti in preventivi futuri.
Formato di fattura personalizzato
Per impostazione predefinita, Frihet usa il suo formato. Puoi personalizzare:
- In Frihet, vai su Impostazioni → Fatturazione
- Modifica il template della fattura
- I nuovi ordini di WooCommerce utilizzano quel template
Email al cliente
Quando viene creata una fattura da WooCommerce:
- ✅ WooCommerce invia email di conferma dell'ordine
- ✅ Frihet può inviare email di fattura (se lo attivi)
Entrambe le email andranno al cliente. Puoi disattivarne una in Impostazioni per evitare duplicati.
Testa l'integrazione
Test ordine
- Vai al tuo negozio WooCommerce
- Effettua un ordine di prova (come cliente)
- In Frihet, vai su Fatturazione → Fatture
- Dovresti vedere la fattura creata automaticamente negli ultimi 30 secondi
Se non appare:
- Aspetta 1 minuto (a volte ci vuole tempo)
- Verifica che WooCommerce → Frihet mostri "Connesso"
- Controlla i log degli errori in Impostazioni → Integrazioni → Log
Rimborsi e cancellazioni
Il cliente annulla l'ordine in WooCommerce
- Lo stato cambia in "Annullato"
- Frihet rileva il cambiamento
- La fattura viene contrassegnata come "Annullata"
Il cliente richiede un rimborso
Se elabori un rimborso in WooCommerce:
- Viene registrato nell'ordine
- Frihet crea automaticamente una nota di credito (se la attivi in Impostazioni)
- Oppure puoi creare manualmente la nota di credito in Frihet
Limitazioni
Frihet → WooCommerce:
- Non sincronizza fatture da Frihet a WooCommerce — Solo WooCommerce → Frihet
- Le modifiche in Frihet non influiscono su WooCommerce — Se modifichi il prezzo di una fattura in Frihet, WooCommerce non si aggiorna
- Nuovi prodotti in Frihet non vanno a WooCommerce — Vengono sincronizzati solo quelli esistenti
Risoluzione dei problemi
"Non vedo le fatture di WooCommerce in Frihet"
- Verifica che l'integrazione sia connessa ✅
- L'ordine deve essere nello stato "In elaborazione" o superiore
- Aspetta 1-2 minuti dopo aver creato l'ordine
- Ricarica Frihet (F5)
"Perché le email si duplicano?"
- WooCommerce invia l'email dell'ordine
- Frihet può anche inviare l'email della fattura
- Soluzione: Disattiva le email di Frihet per gli ordini di WooCommerce in Impostazioni → Email
"Il cliente non corrisponde tra WooCommerce e Frihet"
- WooCommerce ha creato un nuovo cliente in Frihet
- Se il cliente esisteva già, potrebbero essersi verificati dei duplicati
- Soluzione: Unisci i clienti manualmente in Frihet
"Posso disconnettere senza perdere le fatture?"
Sì. Le fatture già create rimangono in Frihet. La disconnessione solo:
- Interrompe nuove sincronizzazioni
- I nuovi ordini in WooCommerce non vengono più sincronizzati
Per disconnettere:
- Vai su Impostazioni → Integrazioni
- Cerca WooCommerce
- Clicca su Disconnetti
- Conferma
Frihet emette webhooks in eventi come invoice.created e invoice.paid. Usalo per sincronizzare il tuo negozio WooCommerce con sistemi esterni o per attivare automazioni quando vengono generate fatture dagli ordini.
Passi successivi
Precedente: Stripe Connect