fatture.help for WooCommerce

Descripció

Il primo plugin di fatturazione elettronica per WooCommerce pensato per crescere insieme al tuo e-commerce, con un modello “Pay-as-you-grow” (paghi solo per quello che consumi man mano che il tuo business cresce). Nessun abbonamento fisso da centinaia di euro all’anno: il plugin si integra perfettamente nel checkout, offre un’esperienza d’acquisto fluida al cliente e gestisce in background tutto il noioso lavoro burocratico.

Perché scegliere fatture.help?
A differenza delle alternative sul mercato, non ti chiediamo di pagare canoni esorbitanti “a scatola chiusa” per sbloccare l’integrazione e-commerce. Il nostro è un modello flessibile e trasparente. Zero configurazioni complesse (niente API key da copiare, fai solo il login!), massima automazione.

Novità della Versione 2.0 (Il Salto Quantico):
* Firewall Fiscale per l’Imposta di Bollo (Ideale per Forfettari): Gestisci un e-commerce in regime forfettario o con articoli esenti? Il plugin calcola in tempo reale l’imponibile esente nel carrello e, SOLO se supera la soglia di legge di 77,47€, applica il bollo di 2€ (a carico cliente o venditore). Se l’ordine contiene IVA o è sotto soglia, il bollo viene soppresso. Zero errori formali, zero sanzioni.
* Architettura “Paranoia Mode”: Riscritto interamente con programmazione ad oggetti rigorosa. I dati fiscali sono blindati e l’interfaccia nel backend di WooCommerce è super-reattiva grazie al nuovo caricamento AJAX dello Storico SdI.

Funzionalità Principali:
* Generazione XML automatica e invio diretto al Sistema di Interscambio (SdI).
* Invio al cliente della copia di cortesia in PDF (anche per ricevute/DDT) tramite email.
* Storico degli stati SdI (Inviata, Scartata, Consegnata) visibile e consultabile via popup dinamico direttamente nella lista ordini.
* Magia VIES in Tempo Reale: Se il cliente inserisce una Partita IVA italiana valida, il plugin interroga istantaneamente il database europeo (VIES) e autocompila il nome dell’azienda.
* Nessun blocco per i clienti esteri (B2C o B2B), gestiti in piena conformità con la normativa.
* Il paradiso dei Commercialisti: Ogni Lunedì mattina, il sistema invia automaticamente due file ZIP (uno per le fatture attive, uno per le passive). Se il tuo commercialista ha più clienti che usano fatture.help, riceverà un UNICO ZIP centralizzato con tutte le fatture aggiornate di tutti i suoi clienti!
* Calcolo accurato della Cassa Previdenziale nel carrello (ideale per i professionisti).
* Piena compatibilità con le tabelle HPOS di WooCommerce.

Il Ciclo di Vita della Fattura (Sicurezza Anti-Errore)

Il plugin è progettato per salvarti dagli errori umani e non farti mai “bruciare” una numerazione fiscale.

  • 1. Il “Panic Buffer” (Il Minuto di Respiro): Quando imposti un ordine su “Completato”, il plugin attende 1 minuto prima di generare la fattura. Hai sbagliato a cliccare? Nessun problema: rimetti l’ordine su “In sospeso” entro 60 secondi e la fattura verrà annullata prima ancora di nascere.
  • 📝 2. La Finestra di Cortesia (24 Ore): Superato il minuto, il documento nasce come “Bozza”. Hai 24 ore di tempo per entrare nell’ordine su WooCommerce, correggere eventuali refusi nei dati del cliente e salvare. La bozza si aggiornerà automaticamente in background.
  • 🔒 3. Il Blocco Fiscale (Invio allo SdI): Scadute le 24 ore, la fattura parte per l’Agenzia delle Entrate. Da questo momento, WooCommerce blocca le modifiche all’ordine per garantirti la totale coerenza tra e-commerce e cassetto fiscale.
  • 4. Auto-Sblocco per Scarti SdI: Se lo SdI rifiuta la fattura (es. Codice Fiscale inesistente inserito dal cliente), il plugin riceve la notifica e sblocca l’ordine. Potrai inserire il dato corretto, salvare e la fattura ripartirà in automatico.

Costi (Modello Pay-as-you-grow)

Con fatture.help paghi solo in base al volume reale dei tuoi affari.

  • Primi 20 documenti: 100% Gratuiti. Ideale per testare il sistema o se hai appena aperto.
  • Fino a 100 documenti: 10€ + IVA / anno. Copre la maggior parte delle micro-imprese.
  • Dal 101° documento in poi: Solo 0,05€ + IVA per ogni documento aggiuntivo.

Un esempio di risparmio concreto:
Ipotizziamo un budget di 50€/anno (il costo base medio di altri gestionali sul mercato).
Con 50€ su fatture.help copri i primi 100 documenti (10€) e te ne restano 40 per acquistarne altri 800 (a 0,05€). In sintesi: con 50€ gestisci ben 900 documenti all’anno (tra Fatture, Note di Credito e DDT). Un volume impensabile con i piani base della concorrenza.

Forfettari, Nature IVA e Imposta di Bollo

Se sei un forfettario o vendi prodotti esenti, devi indicare a WooCommerce la “Natura” dell’esenzione. Vai in WooCommerce -> Impostazioni -> Imposte e inserisci il codice Natura tra parentesi quadre [Nx.x] all’inizio del nome dell’imposta, impostando l’aliquota allo 0%.

Esempio per l’Italia (Forfettario):
* Per l’Italia: Codice Nazione IT | Aliquota 0% | Nome Imposta: [N2.2] Esente Forfettario
* Per San Marino: Codice Nazione SM | Aliquota 0% | Nome Imposta: [N3.3] Non Imponibile San Marino (Sostituisci N3.3 con la tua natura specifica).
* Per il resto del mondo: Codice Nazione * | Aliquota 0% | Nome Imposta: [N3.2] Non Imponibile Estero

Imposta di Bollo Automatizzata:
Se sei in un regime che richiede la marca da bollo su fatture esenti superiori a 77,47€:
1. Vai su WooCommerce -> Impostazioni -> fatture.help.
2. Attiva la spunta “Applica bollo in fattura”.
3. Opzionale: Seleziona “Bollo a carico del venditore” se non vuoi addebitare i 2€ nel carrello del cliente.
Il plugin farà il resto, calcolando matematicamente quando applicarlo e quando no.

Cassa Previdenziale

Ideale per i professionisti che vendono servizi online. Nelle impostazioni “Imposte” di WooCommerce, crea una nuova aliquota dedicata alla tua cassa. Il nome dell’imposta deve contenere obbligatoriamente il tag [TCXX] (parentesi quadre incluse).

Esempio Pratico: L’Architetto che vende certificati APE online
(CASO A) Architetto in Regime Ordinario (IVA + Cassa):
L’Architetto deve addebitare il 4% di Inarcassa e il 22% di IVA.
1. Crea l’imposta Inarcassa: Aliquota 4% | Nome Imposta: [TC04] Inarcassa | Priorità 1.
2. Crea l’imposta IVA: Aliquota 22% | Nome Imposta: IVA | Priorità 2 | Spunta “Composto” (perché l’IVA si calcola anche sul valore della cassa).

(CASO B) Architetto in Regime Forfettario (Esenzione + Cassa + Bollo):
1. Crea l’imposta Inarcassa: Aliquota 4% | Nome Imposta: [TC04] Inarcassa | Priorità 1.
2. Crea l’imposta Esente: Aliquota 0% | Nome Imposta: [N2.2] Esente Forfettario | Priorità 2.
3. Attiva il Bollo Automatico nelle impostazioni di fatture.help.

Elenco Codici Casse Previdenziali:
* [TC01] Cassa nazionale previdenza e assistenza avvocati e procuratori legali
* [TC02] Cassa previdenza dottori commercialisti
* [TC03] Cassa previdenza e assistenza geometri
* [TC04] Cassa nazionale previdenza e assistenza ingegneri e architetti liberi professionisti
* [TC05] Cassa nazionale del notariato
* [TC06] Cassa nazionale previdenza e assistenza ragionieri e periti commerciali
* [TC07] Ente nazionale assistenza agenti e rappresentanti di commercio (ENASARCO)
* [TC08] Ente nazionale previdenza e assistenza consulenti del lavoro (ENPACL)
* [TC09] Ente nazionale previdenza e assistenza medici (ENPAM)
* [TC10] Ente nazionale previdenza e assistenza farmacisti (ENPAF)
* [TC11] Ente nazionale previdenza e assistenza veterinari (ENPAV)
* [TC12] Ente nazionale previdenza e assistenza impiegati dell’agricoltura (ENPAIA)
* [TC13] Fondo previdenza impiegati imprese di spedizione e agenzie marittime
* [TC14] Istituto nazionale previdenza giornalisti italiani (INPGI)
* [TC15] Opera nazionale assistenza orfani sanitari italiani (ONAOSI)
* [TC16] Cassa autonoma assistenza integrativa giornalisti italiani (CASAGIT)
* [TC17] Ente previdenza periti industriali e periti industriali laureati (EPPI)
* [TC18] Ente previdenza e assistenza pluricategoriale (EPAP)
* [TC19] Ente nazionale previdenza e assistenza biologi (ENPAB)
* [TC20] Ente nazionale previdenza e assistenza professione infermieristica (ENPAPI)
* [TC21] Ente nazionale previdenza e assistenza psicologi (ENPAP)
* [TC22] INPS

⚠️ DISCLAIMER: Configura l’aliquota %, la priorità e i codici Natura in base al tuo specifico regime fiscale. Verifica sempre la correttezza della fatturazione con il tuo Commercialista di fiducia.

Captures

  • Magia in azione: Calcolo dinamico dell’imposta di bollo nel carrello in tempo reale.
  • Sicurezza al Checkout: Validazione Partita IVA / VIES in tempo reale per IT.
  • Pannello di controllo totale: Gestisci prefissi, ricevute e regole del Bollo.
  • Integrazione nell’Ordine: Stato fattura “In attesa di pagamento”.
  • Integrazione nell’Ordine: Stato fattura “In coda” (Gestione automatica via CRON).
  • Integrazione nell’Ordine: Stato fattura “Provvisorio”.
  • Integrazione nell’Ordine: Esito finale con fattura “Consegnata” e metadati visibili.
  • Controllo a colpo d’occhio: Stato delle fatture direttamente nella lista Ordini di WooCommerce.
  • Precisione fiscale: Generazione infallibile dei documenti (PDF e XML) con i codici IVA corretti.
  • Massima trasparenza: Storico completo delle comunicazioni con il Sistema di Interscambio (SdI).

Instal·lació

  1. Scarica e installa il plugin nel tuo WordPress.
  2. Attiva il plugin.
  3. Vai su WooCommerce -> Impostazioni -> fatture.help e clicca su Login. Il plugin configurerà automaticamente i cookie di connessione.
  4. Non hai ancora un account? Registrati gratuitamente su fatture.help.
  5. Bonus: Imposta il Codice Destinatario 8MWMYY7 nel tuo cassetto fiscale per ricevere tutte le tue fatture d’acquisto (passive) direttamente sulla piattaforma fatture.help!

Ressenyes

Llegiu tota la 1 ressenya

Col·laboradors i desenvolupadors

«fatture.help for WooCommerce» és programari de codi obert. La següent gent ha col·laborat en aquesta extensió.

Col·laboradors

“fatture.help for WooCommerce” s’ha traduït a 1 configuració regional. Gràcies als traductors per les seves aportacions.

Traduïu «fatture.help for WooCommerce» a la vostra llengua.

Interessats en el desenvolupament?

Navegueu pel codi, baixeu-vos el repositori SVN, o subscriviu-vos al registre de desenvolupament per fisl de subscripció RSS.

Registre de canvis

2.0.4

  • 🛡️ Security & Control: Implementata la “Data di Inizio Fatturazione” automatica. Alla prima attivazione, il plugin registra la data corrente come “spartiacque”: tutti gli ordini antecedenti a questa data vengono rigorosamente ignorati dal motore di autogenerazione, prevenendo l’emissione involontaria di vecchie fatture (utile se migri da un altro gestionale). Resta salva la possibilità di accodarli manualmente tramite le Azioni di Gruppo di WooCommerce.
  • ⚡ Reliability: Introdotto un controllo di sicurezza “Self-Healing” sul Cron di sistema tramite wp_next_scheduled(). Questo garantisce che il task in background per la generazione delle fatture non venga mai perso, “dimenticato” o sovrascritto da altri processi del server, assicurando un flusso di invio ininterrotto.

2.0.3

  • Miglioramento: Automatismo avanzato per l’Imposta di Bollo. Mappatura completa delle Nature IVA per assistere il merchant ed evitare errori nella configurazione fiscale dei prodotti (il plugin ora esclude in automatico casistiche non soggette come N3.1 o N6.x, applicando i 2€ solo quando strettamente necessario).

2.0.2

  • Major Update: Completa internazionalizzazione del plugin (i18n). Ora fatture.help è 100% “Translation Ready” per supportare qualsiasi lingua.
  • Security: Refactoring profondo della sicurezza del codice. Implementato un escaping rigoroso (esc_html, esc_attr, wp_kses) su ogni singolo output e notifica di sistema per garantire standard qualitativi di livello enterprise.
  • Enhancement: Ottimizzazione dell’architettura e separazione netta tra logica PHP e markup HTML tramite l’utilizzo avanzato di funzioni sprintf.
  • Fix: Miglioramento generale della stabilità e risoluzione di bug minori (😉).
  • Props: Un ringraziamento speciale a Matteo per le sessioni di beta-testing estremo fino all’alba!

2.0.1

  • Fix: Modificata la label “Nome della società” in “Ragione sociale” nel checkout (grazie Matteo!).
  • Fix: Rimossi alcuni log di debug residui.

2.0.0

  • 🚀 MAJOR UPDATE: Il motore dell’Imposta di Bollo è stato completamente riscritto! Architettura “Paranoia Mode” per blindare la memoria ed evitare memory leak.
  • ✨ NUOVO: Firewall Fiscale e Calcolo Dinamico. Il Bollo (2€) appare e scompare in tempo reale nel carrello in base all’importo esente (soglia 77,47€) e alla nazione del cliente. Addio sanzioni per bolli applicati su fatture ivate o sotto soglia!
  • ✨ NUOVO: Bollo a carico del venditore. Assorbi tu il costo del bollo? Ora puoi nasconderlo al cliente finale con una semplice spunta nelle impostazioni, mantenendo l’XML perfetto per lo SdI.
  • 🛡️ SICUREZZA: Blindatura Storica degli Ordini. Il bollo ora viene salvato come riga prodotto fisica ([bollo]) nell’ordine WooCommerce. Coerenza fiscale garantita al 100%, anche se il prodotto originale viene eliminato dallo store.
  • ⚡ PERFORMANCE: Il modale dello Storico SdI nella vista “Lista Ordini” ora carica i log dinamicamente via AJAX, abbattendo drasticamente il peso del DOM e velocizzando il backend.
  • 🎨 UX/UI: Restyling del checkout. Messaggi di errore più umani e chiari per l’utente finale. Aggiornamento icone a FontAwesome 6.
  • 🔧 REFACTORING: Struttura del codice completamente modernizzata con programmazione ad oggetti rigorosa e gestione DTO nativa di WooCommerce. Gestione “Auto-healing” in caso di disallineamento al checkout.

1.2.0

  • Major Update: Riscrittura completa del motore del plugin per supportare nativamente le tabelle HPOS (High-Performance Order Storage) di WooCommerce 8+.
  • Feature: Nuovo Checkout Ultra-Semplificato. Addio a checkbox e campi ridondanti: ora servono solo “P.IVA/CF” e “PEC/SdI” per generare una fattura perfetta.
  • Feature: Magia VIES in Tempo Reale. Inserendo una P.IVA italiana valida, il plugin interroga il database europeo e autocompila il nome dell’Azienda nel checkout.
  • Feature: Supporto avanzato Multi-Vendor con architettura database dedicata (indici univoci composti).
  • Ottimizzazione: Riscritto da zero il motore Cron asincrono. Le vecchie query sono state sostituite con Prepared Statements super-veloci per azzerare i memory leak e i “Gateway Timeout” sui server.
  • Miglioramento: Validazione formale in tempo reale (algoritmo di Luhn) per Codice Fiscale, P.IVA e Codice Destinatario, sia nel checkout che nel backend.
  • Miglioramento: Gestione intelligente degli errori SdI. L’amministratore può ora correggere una P.IVA o una PEC errata direttamente dall’ordine e il plugin la rinvierà in automatico al giro successivo.
  • Sicurezza: Implementato sistema di Transient caching per alleggerire le chiamate API verso i server VIES e bloccato l’editing degli ordini con fattura già emessa.
  • Fix: Risolto il bug dei messaggi di errore (notices) duplicati o persistenti al checkout.