Collegare Holded con WooCommerce è il passo che trasforma il tuo negozio da un semplice carrello in un vero sistema amministrativo: ogni ordine pagato passa, senza intervento manuale, a diventare una fattura corretta all’interno del tuo account Holded. In questa guida pratica ci concentriamo sull’atto concreto della connessione —generare la API key, installare il plugin, mappare la fatturazione ed emettere la prima fattura— così da lasciare il processo funzionante in un solo pomeriggio e senza brutte sorprese contabili a fine mese.
Collegare Holded con WooCommerce: cosa ti serve prima di iniziare
Prima di toccare qualsiasi impostazione, conviene preparare il terreno. La maggior parte dei problemi non nasce dal plugin, ma da dati fiscali incompleti o da una API key generata male. Se controlli questa lista, la connessione si completerà al primo tentativo:
- Un account Holded attivo con permessi di amministratore (i piani con fatturazione elettronica sono l’ideale).
- WooCommerce aggiornato e con i dati fiscali della tua azienda compilati (NIF, indirizzo e ragione sociale).
- Almeno una serie di fatturazione definita in Holded, diversa dalle tue fatture manuali o da altri canali.
- Il plugin EHERO Woo Holded per la fatturazione, che trasferisce automaticamente ogni ordine a Holded.
- Le imposte del tuo negozio (IVA generale, ridotta, surcharge di equivalenza se applicabile) configurate correttamente in WooCommerce.
Questa parte è complementare alla nostra guida generale per integrare Holded con WooCommerce: qui non parliamo di strategia, ma della procedura tecnica di collegamento passo dopo passo.
Genera la API key in Holded
La API key è la credenziale che autorizza il tuo negozio a creare fatture a tuo nome. Entra nel pannello ufficiale di Holded, apri il menu del tuo account e vai su Configurazione > Sviluppatori (a seconda del piano appare come «API» o «Integrazioni»). Clicca per creare una nuova chiave, assegnale un nome riconoscibile —per esempio «WooCommerce negozio»— e copiala in un luogo sicuro.
Tieni presente un dettaglio fondamentale: Holded mostra la chiave completa una sola volta. Se chiudi la finestra senza copiarla, dovrai revocarla e generarne un’altra. Conservala nel tuo gestore di password, mai in un’email o in una nota condivisa.
Installa il plugin EHERO Woo Holded
Carica il file ZIP del plugin da Plugin > Aggiungi nuovo > Carica plugin nel tuo WordPress e attivalo. Vedrai una nuova sezione di impostazioni dove incollerai la API key appena generata. Al salvataggio, il plugin esegue una chiamata di validazione verso Holded: se la credenziale è corretta, riceverai una conferma in verde. Questo è il momento in cui colleghi davvero il tuo negozio a Holded a livello di credenziali.
Come collegare Holded con WooCommerce passo dopo passo
Con la chiave validata, il resto è una questione di definire il comportamento. Per lasciare la connessione ordinata, segui questa sequenza nelle impostazioni del plugin:
- Incolla la API key e salva per verificare la connessione.
- Scegli la serie di fatturazione che userà il negozio (idealmente una serie dedicata al canale online).
- Definisci il trigger: emettere la fattura quando l’ordine passa a «In lavorazione» o a «Completato».
- Decidi se il numero di fattura viene assegnato da Holded o viene ereditato dall’ordine.
- Attiva, se necessario, l’invio automatico del PDF al cliente.
Mappa la fatturazione: serie, imposte e dati fiscali
La mappatura è la parte che fa la differenza tra una fattura corretta e una che il tuo commercialista rifiuterà. Assicurati che i tipi di IVA di WooCommerce coincidano con quelli definiti in Holded; se nel negozio hai un 21 % e in Holded quell’imposta non esiste con lo stesso valore, la fattura verrà creata con importi non allineati. Controlla anche la mappatura dei contatti: il plugin cerca il cliente tramite NIF o email e, se non lo trova, lo crea. Questo evita duplicati nel tuo database contatti di Holded.
Per le attività soggette alla normativa antifrode, questo collegamento è la base su cui poi costruire un TPV per WooCommerce con VeriFactu. EHERO Woo Holded è compatibile con VeriFactu, quindi le fatture che genera rispettano i requisiti di tracciabilità richiesti.
Emetti la tua prima fattura di prova
Non affidare la prima emissione a un ordine reale. Crea un ordine di prova con un prodotto di importo basso, segnalo come pagato e osserva cosa succede. Se tutto è mappato correttamente, in pochi secondi apparirà la fattura in Holded con la serie, l’imposta e il contatto corretti. Controlla tre cose: che il numero di serie sia quello previsto, che il totale coincida con l’ordine e che il cliente sia stato creato o collegato senza duplicati. Quando quell’ordine di prova risulta pulito, hai già terminato la connessione e puoi passare in produzione con tranquillità.
Errori tipici di connessione e come risolverli
Anche se collegare entrambe le piattaforme è un processo breve, ci sono tre errori che concentrano quasi tutte le richieste di supporto. Eccoli e così si risolvono.
API key non valida o senza permessi
Se al salvataggio ricevi un errore di credenziale, controlla di non aver copiato spazi bianchi all’inizio o alla fine della chiave. Il secondo motivo più comune è una chiave con permessi limitati: alcuni piani di Holded generano chiavi di sola lettura che non possono creare fatture. Genera una nuova chiave con permessi di scrittura e valida di nuovo.
Errori di serie di fatturazione
Quando la fattura non viene emessa e il registro menziona la «serie», quasi sempre manca la selezione di una serie valida oppure questa è stata eliminata in Holded. Crea una serie esclusiva per il canale online, separala da quella che usi per le fatture manuali e selezionala di nuovo nel plugin. Così eviti salti di numerazione che poi complicano la chiusura trimestrale.
| Aspetto | Fatturazione manuale | Connessione con EHERO Woo Holded |
|---|---|---|
| Tempo per ordine | 3-5 minuti copiando i dati | Automatico, zero minuti |
| Rischio di errore | Alto (importi, NIF, serie) | Basso, dati ereditati dall’ordine |
| Numerazione di serie | Manuale, con salti frequenti | Consecutiva e controllata |
| Compatibilità VeriFactu | Dipende dal metodo | Sì, integrata |
Domande frequenti
Ho bisogno di competenze tecniche per fare questa connessione?
No. Il processo si riduce a generare una API key, installare il plugin e incollare la chiave. Tutta la mappatura si fa da una schermata di impostazioni, senza toccare codice o database.
Il plugin sincronizza anche lo stock tra Holded e il negozio?
No. EHERO Woo Holded si concentra sulla fatturazione: trasforma ogni ordine in una fattura dentro Holded. La gestione dello stock è un flusso diverso e non fa parte di questa connessione.
Posso usare funzioni di IA nella fatturazione?
Qualsiasi funzione assistita da IA funziona in modalità BYOK, cioè con la tua chiave del fornitore. Tu controlli la chiave e il costo; il plugin non include consumi di terze parti per conto proprio.
Cosa succede se cambio la API key in seguito?
Basta incollare la nuova chiave nelle impostazioni e salvare affinché il plugin la validi di nuovo. Se revochi la precedente in Holded, fallo subito dopo aver confermato che la nuova connessione risponde correttamente.
Conclusione
Collegare Holded con WooCommerce è più rapido di quanto sembri quando prepari la API key, definisci una serie dedicata e validi con un ordine di prova prima di passare in produzione. Con queste quattro attenzioni —credenziale corretta, imposte allineate, serie dedicata e prova reale— lascerai la fatturazione funzionare in modo automatico e conforme a VeriFactu. Fai il passo con il plugin di fatturazione Holded per WooCommerce di EHERO e trasforma ogni ordine in una fattura senza dover più copiare un dato a mano.