ITA - Fattura elettronica - Supporto Fatturhello
Italiano
Questo modulo consente di inviare e ricevere i file XML della fattura elettronica tramite Fatturhello (https://fatturhello.it).
La ricezione avviene periodicamente, tramite il CRON "Importazione e-fatture da Fatturhello". Ad ogni esecuzione tutte le fatture elettroniche successive a quella configurata (a meno di duplicati) verranno scaricate.
La documentazione delle API è https://documenter.getpostman.com/view/3340600/RWTiyLCz.
English
This module allows you to send and receive electronic invoice/bill XML files via Fatturhello (https://fatturhello.it).
The receipt happens periodically, with the CRON "Import E-Bills from Fatturhello". During each execution all the E-Bills subsequent the configured one (except for duplicates) will be downloaded.
The API documentation is https://documenter.getpostman.com/view/3340600/RWTiyLCz.
auto_awesome What this module does
AI-generated from the code · Odoo 16.0Send and receive Italian electronic invoices (fattura elettronica) through the Fatturhello service. Configure a Fatturhello channel, log in, upload e-invoices and automatically download incoming e-bills and their SdI status updates.
This module adds Fatturhello as a new channel type for Italian electronic invoicing. Users configure it on the SdI channel form, where a Fatturhello section shows the base URL, username and login token, plus a Login button that opens a small wizard asking for username and password.
Once logged in, the token and the company identifier are stored automatically, and a reminder activity is scheduled to renew the login after one year. Outgoing e-invoices uploaded through this channel get a Fatturhello protocol number and a new state 'Sent to Fatturhello' on the electronic invoice attachment and on the related journal entry.
Two scheduled jobs run hourly (disabled by default): one imports new incoming e-bills from Fatturhello, skipping those already downloaded, and the other fetches the SdI status updates of uploaded invoices, converting them into standard SdI notifications (delivery receipt, rejection notice, or a Fatturhello-specific notice). Invoices already rejected, validated or accepted are not updated again.
The module touches account.move, fatturapa.attachment.out, res.company and sdi.channel, and adds Fatturhello fields to the electronic invoice form and search views and to the company form.
Depends on
Models and fields (6)
- res.company · extends an existing modelfatturhello_identifier, fatturhello_last_downloaded_e_bill_identifer
- sdi.channel · new modelchannel_type, fatturhello_base_url, fatturhello_username, fatturhello_login_authtoken, fatturhello_login_authtoken_create_date
- account.move · extends an existing modelfatturapa_state
- fatturapa.attachment.out · extends an existing modelstate, fatturhello_protocol, fatturhello_last_processed_status_datetime (Last processed Fatturhello status)
- l10n_it_fatturapa_fatturhello.login · new modelpassword, username, channel_id
- l10n_it_fatturapa_fatturhello.connector · new model
Text generated by AI (DeepSeek) from reading the Odoo 16.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 1 confirmed, 8 with no information of 9 versions.
Sources · Odoo 16.0
Confirmed on 2026-11-03 in branch 16.0 of OCA/l10n-italy.
terminal Installation and usage
OCA documentation · Odoo 16.0Configuration
Source · Odoo 16.0Italiano
Nella lista dei canali SdI, scegliere o creare un nuovo canale di tipo "Fatturhello" ed effettuare il login.
In Impostazioni > Utenti e aziende > Aziende, selezionare un'azienda e nella scheda "E-fattura" impostare il canale SdI configurato nel campo "Canale SdI". Se alcune fatture di Fatturhello sono già presenti in Odoo, abilitare la modalità debug e valorizzare "Identificativo dell'ultima fattura scaricata". Se "Identificativo dell'ultima fattura scaricata" è vuoto, verranno scaricate tutte le fatture elettroniche presenti in Fatturhello.
Fatturhello
Per inviare in automatico a SdI le fatture caricate da Odoo, abilitare "Spedisci XML caricati".
English
In the list of the ES channels, choose or create a new channel of type "Fatturhello" and login.
In Settings > Users & Companies > Companies, select a company and in the tab "E-invoice", set the configured ES channel in the field "ES channel". If some Fatturhello electronic bills are already present in Odoo, enable Debug mode and fill "Last downloaded E-Bill identifier". If "Last downloaded E-Bill identifier" is empty, all the E-Bills in Fatturhello will be downloaded.
Fatturhello
In order to automatically send invoices uploaded from Odoo to the ES, enable "Spedisci XML caricati".
Usage
Source · Odoo 16.0Italiano
Per ricevere le fatture elettroniche, attivare il CRON "Importazione e-fatture da Fatturhello".
Per aggiornare lo stato delle fatture elettroniche inviate, attivare il CRON "Aggiornamento stato e-fatture caricate su Fatturhello".
Se una fattura rimane nello stato "Inviata a Fatturhello", vuol dire che Fatturhello non è configurato per inviarla automaticamente allo SdI. In questo caso:
- In Odoo: eliminare la fattura elettronica creata,
- In Fatturhello: abilitare l'invio automatico a SdI,
- In Odoo: ricreare la fattura elettronica e inviarla.
English
In order to receive the electronic bills, activate the "Import E-Bills from Fatturhello" CRON.
In order to update the status of sent electronic invoices, activate the "Update the status of E-Invoices uploaded to Fatturhello" CRON.
If an invoice remains in the "Sent to Fatturhello" status, it means that Fatturhello is not configured to automatically send it to the ES. In this case:
- In Odoo: Delete the created electronic invoice,
- In Fatturhello: Enable automatic sending to ES,
- In Odoo: Recreate the electronic invoice and send it.
No verified information in OCA: Installation.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.