Italiano
Questo modulo consente di importare i file XML della fattura elettronica versione 1.2
ricevuti attraverso il Sistema di Interscambio (SdI).
English
This module allows to import Electronic Bill XML files version 1.2
received through the Exchange System (ES).
auto_awesome What this module does
AI-generated from the code · Odoo 16.0Import Italian electronic invoices (Fattura Elettronica XML) received from the SdI, creating supplier bills automatically or linking them to existing bills, with checks that the bill matches the XML.
This module lets you bring Italian electronic supplier invoices (XML files) into Odoo. You upload or receive the XML file and Odoo reads it, showing the supplier, number of documents, dates and total amounts. From there you can create a draft supplier bill with lines, taxes and payment terms taken from the XML, or link the file to a bill you already entered.
Where it appears: - A new "Incoming E-bill Files" menu under the Italian e-invoice payables menu lists all received XML files with their status (registered or not) and any parsing or validation errors. - On a supplier bill you see extra fields: the linked XML file, the amounts and reference from the XML, the e-invoice date, and a warning message if the bill does not match the XML. - A wizard "Import Electronic Bill" lets you choose how detailed the created bill lines should be (minimum, tax rate, or maximum). - A wizard "Link to existing supplier bills" lets you attach an XML file to an existing bill.
Business rules and automatic behaviours: - When you try to post a bill that came from an XML file, Odoo blocks it if the untaxed amount, tax amount, total, vendor reference, payment reference, invoice date or withholding tax do not match the XML, unless you tick "Force E-Invoice Validation". - The XML file itself shows a validation error if any of its linked bills have mismatches. - If the XML contains only negative lines, the bill is turned into a refund and the signs are flipped. - Partner settings control the detail level and decimal digits used when importing lines, and a default product can be set for lines where no product is found. - Company settings let you choose products and accounts for welfare fund data, discounts/surcharges and rounding, and whether the bill registration date defaults to the invoice date or the received date. - The module also stores line-level details from the XML (description, quantity, unit price, discounts, other data) for reference.
Depends on
Required by other modules
Menus it adds
Models and fields (13)
- res.company · extends an existing modelarrotondamenti_tax_id, in_invoice_registration_date (Vendor invoice registration default date), cassa_previdenziale_product_id, sconto_maggiorazione_product_id, arrotondamenti_attivi_account_id, arrotondamenti_passivi_account_id
- res.partner · extends an existing modele_invoice_detail_level (E-bills Detail Level), e_invoice_default_product_id (E-bill Default Product), e_invoice_price_decimal_digits (E-bills prices decimal digits), e_invoice_discount_decimal_digits (E-bills discounts decimal digits), e_invoice_quantity_decimal_digits (E-bills quantities decimal digits)
- account.move · extends an existing modelinconsistencies (Import Inconsistencies), e_invoice_line_ids (Lines Detail), e_invoice_reference (E-invoice vendor reference), e_invoice_amount_tax (E-Invoice Tax Amount), e_invoice_amount_total (E-Invoice Total Amount), e_invoice_date_invoice (E-invoice date), e_invoice_received_date (E-Bill Received Date), e_invoice_amount_untaxed (E-Invoice Untaxed Amount), e_invoice_force_validation (Force E-Invoice Validation), e_invoice_validation_error, fatturapa_attachment_in_id, e_invoice_validation_message
- einvoice.line · new modelqty (Quantity), uom (Unit of measure), name (Description), tax_kind (Nature), admin_ref (Administration Reference), wt_amount (Tax Withholding), invoice_id, tax_amount (VAT Rate), unit_price, line_number, total_price, service_type (Sale Provision Type), other_data_ids (Other Administrative Data), cod_article_ids, period_end_date, period_start_date, discount_rise_price_ids
- account.move.line · extends an existing modelfatturapa_attachment_in_id
- discount.rise.price · extends an existing modele_invoice_line_id
- res.config.settings · extends an existing modelarrotondamenti_tax_id, in_invoice_registration_date, cassa_previdenziale_product_id, sconto_maggiorazione_product_id, arrotondamenti_attivi_account_id, arrotondamenti_passivi_account_id
- fatturapa.article.code · new modelname (Code Type), code_val (Code Value), e_invoice_line_id
- wizard.link.to.invoice · new modelline_ids, attachment_id
- fatturapa.attachment.in · new modelregistered, invoices_date (Invoices date), in_invoice_ids (In Bills), invoices_total (Bills Total), inconsistencies, invoices_number (Bills Number), is_self_invoice (Contains self invoices), xml_supplier_id (Supplier), price_decimal_digits (Prices decimal digits), linked_invoice_id_xml, discount_decimal_digits (Discounts decimal digits), e_invoice_parsing_error, e_invoice_received_date (E-Bill Received Date), quantity_decimal_digits (Quantities decimal digits), e_invoice_validation_error, e_invoice_validation_message
- wizard.import.fatturapa · new modelprice_decimal_digits (Prices decimal digits), e_invoice_detail_level (E-bills Detail Level), discount_decimal_digits (Discounts decimal digits), quantity_decimal_digits (Quantities decimal digits)
- einvoice.line.other.data · new modelname (Data Type), num_ref (Number Reference), date_ref (Date Reference), text_ref (Text Reference), e_invoice_line_id
- wizard.link.to.invoice.line · new modelwizard_id, invoice_id, e_invoice_nbr (Bill number in XML), e_invoice_descr (E-bill description)
Text generated by AI (DeepSeek) from reading the Odoo 16.0 code on GitHub; it may contain mistakes, so check the code before deciding. The module is very large and only part of the code was read. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 3 confirmed, 6 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.0Installation
Source · Odoo 16.0Italiano
Questo modulo richiede asn1crypto
English
This module requires asn1crypto
Configuration
Source · Odoo 16.0Italiano
Consultare anche il file README del modulo l10n_it_fatturapa.
Per ciascun fornitore è possibile impostare il "Livello dettaglio e-fatture":
> - Livello minimo: la fattura fornitore viene creata senza righe, che > dovranno essere create dall'utente in base a quanto indicato nella > fattura elettronica > - Livello massimo: le righe della fattura fornitore verranno generate > a partire da tutte quelle presenti nella fattura elettronica
Nella scheda fornitore è inoltre possibile impostare il "Prodotto predefinito per e-fattura": verrà usato, durante la generazione delle fatture fornitore, quando non sono disponibili altri prodotti adeguati. Il conto e l'imposta della riga fattura verranno impostati in base a quelli configurati nel prodotto.
Tutti i codici prodotto usati dai fornitori possono essere impostati nella relativa scheda, in
Magazzino → Prodotti
Se il fornitore specifica un codice noto nell'XML, questo verrà usato dal sistema per recuperare il prodotto corretto da usare nella riga fattura, impostando il conto e l'imposta collegati.
English
See also the README file of l10n_it_fatturapa module.
For every supplier, it is possible to set the 'E-bills Detail Level':
> - Minimum level: Bill is created with no lines; User will have to > create them, according to what specified in the electronic bill > - Maximum level: Every line contained in electronic bill will create a > line in bill
Moreover, in supplier form you can set the 'E-bill Default Product': this product will be used, during generation of bills, when no other possible product is found. Tax and account of bill line will be set according to what configured in the product.
Every product code used by suppliers can be set, in product form, in
Inventory → Products
If supplier specifies a known code in XML, the system will use it to retrieve the correct product to be used in bill line, setting the related tax and account.
Usage
Source · Odoo 16.0Italiano
> - Andare in Contabilità → Acquisti → Fattura elettronica > - Caricare un file XML > - Visualizzare il contenuto della fattura facendo clic su "Mostra > anteprima" > - Eseguire la procedura guidata "Importa e-fattura" per creare una > fattura in bozza oppure "Collega a fattura esistente" per collegare > il file XML a una fattura già (automaticamente) creata
Nell'elenco file delle fatture elettroniche in ingresso saranno presenti, in modo predefinito, quelli da registrare. Sono i file che devono ancora essere collegati a una o più fatture fornitore.
English
> - Go to Accounting → Purchases → Electronic Bill > - Upload XML file > - View bill content clicking on 'Show preview' > - Run 'Import e-bill' wizard to create a draft bill or run 'Link to > existing bill' to link the XML file to an already (automatically) > created bill
In the incoming electronic bill files list you will see, by default, files to be registered. These are files not yet linked to one or more bills.
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.