Guida WooBiller

1. Accedi all'area clienti del portale WooBiller e vai su Download Plugin.
2. Scarica l'ultima versione stable (file .zip).
3. Nell'amministrazione del tuo sito WordPress vai su Plugin → Aggiungi nuovo → Carica plugin.
4. Seleziona il file .zip, attendi il caricamento e clicca Installa → Attiva.

Requisiti minimi: WordPress 6.5+, WooCommerce 9.0+, PHP 8.2+.

Dopo l'attivazione del plugin:

1. Vai su WooBiller → Licenza nel menu admin di WordPress.
2. Copia la chiave dal portale (sezione Licenze) e incollala nel campo Chiave di licenza.
3. Clicca Attiva. Lo stato passa a "Attiva" e il plugin inizia a ricevere gli aggiornamenti automatici dal portale.

Una licenza include un numero massimo di siti (sites) attivabili in base al piano. Vedi i dettagli nella tua Area clienti → Licenze.

Da WooBiller 1.8.0 puoi collegarti a FIC con un click, senza creare una tua app OAuth su FIC.

1. In WordPress, vai su WooBiller → Credenziali.
2. Nella sezione Connetti a Fatture in Cloud (consigliato) clicca Connetti via WooBiller.
3. Sarai reindirizzato sul portale FIC: autorizza l'accesso del billing portal al tuo account.
4. Al ritorno sul tuo sito vedrai una notifica di conferma e il badge con il nome dell'azienda FIC collegata.

Se hai più aziende sul tuo account FIC, dopo la prima autorizzazione viene mostrato un selettore "Cambia azienda" per scegliere quella di fatturazione.

Il client_secret OAuth vive solo sul nostro server. Il refresh_token del tuo account FIC non lascia mai il portale. Quando un access_token sta per scadere il plugin lo richiede al portale via HMAC firmato.

Forzare un refresh o disconnettere

Sempre nella pagina Credenziali, sezione proxy:

• Forza refresh invalida l'access_token in cache e ne richiede uno nuovo. Utile dopo un errore "Connessione scaduta".
• Disconnetti revoca la connessione su entrambi i lati. Per riconnettere ripeti il flow "Connetti via WooBiller".

Le versioni precedenti del plugin chiedevano di creare una propria app OAuth su FIC e inserire client_id / client_secret manualmente. Questa modalità rimane funzionante per chi è già connesso, ma sarà rimossa in WooBiller 2.0.0. Migra alla nuova connessione proxy alla prima occasione.

WooBiller emette le fatture su FIC e produce in parallelo un PDF a partire da un template HTML. Sono inclusi due template built-in (classico e moderno) selezionabili da WooBiller → Template.

Per creare un template personalizzato:

1. Vai su WooBiller → Template → Nuovo.
2. Componi il layout usando i placeholder disponibili (es. {{order.total}}, {{customer.name}}, {{items}}).
3. Salva e impostalo come predefinito da WooBiller → Impostazioni.

L'anteprima live mostra il rendering con i dati dell'ultimo ordine fattura emesso.

WooBiller può emettere il documento (fattura, ricevuta, proforma) in automatico al verificarsi di un evento sull'ordine WooCommerce. I trigger disponibili sono:

• Pagamento completato (default): emette il documento appena l'ordine passa a stato "Completato" o "In lavorazione" a seconda dei metodi di pagamento.
• Cambio stato manuale: emetti solo quando l'admin imposta lo stato configurato.
• Spedizione: emette al passaggio dello stato a "Spedito" (richiede un plugin di tracking che setti quello stato).

Configurali da WooBiller → Trigger.

Cosa succede se la licenza scade?

Il plugin smette di ricevere aggiornamenti automatici e di emettere nuovi documenti. Le fatture già emesse restano consultabili. Puoi rinnovare dal pulsante Rinnova nella tua Area clienti → Licenze.

Come cambio l'azienda FIC collegata?

In WooBiller → Credenziali clicca Cambia azienda nella sezione proxy: viene mostrato il dropdown con le aziende disponibili sul tuo account FIC.

Cosa fare se ricevo "Connessione scaduta, riconnetti"?

Significa che il portale non riesce più a rinfrescare il tuo token FIC (in genere perché l'hai revocato manualmente dal pannello FIC). Vai su WooBiller → Credenziali e ripeti il flow Connetti via WooBiller.

Dove segnalo un bug o richiedo una feature?

Scrivici a supporto@woobiller.com indicando: versione del plugin, versione di WordPress e WooCommerce, e gli step per riprodurre.