Metadata-Version: 2.1
Name: odoo-addon-l10n_it_edi_extension
Version: 18.0.1.5.0.2
Requires-Python: >=3.10
Requires-Dist: codicefiscale
Requires-Dist: odoo-addon-partner_firstname==18.0.*
Requires-Dist: odoo==18.0.*
Requires-Dist: openupgradelib
Summary: E-invoice base feature
Home-page: https://github.com/OCA/l10n-italy
License: AGPL-3
Author: Giuseppe Borruso, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 18.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Development Status :: 4 - Beta
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

==================================
Italy - E-invoicing - Base Feature
==================================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:a5b2942fd2c449b0d0431b3f15122c8379f3a85eac047014c7d609788692a0a8
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
    :target: https://odoo-community.org/page/development-status
    :alt: Beta
.. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fl10n--italy-lightgray.png?logo=github
    :target: https://github.com/OCA/l10n-italy/tree/18.0/l10n_it_edi_extension
    :alt: OCA/l10n-italy
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/l10n-italy-18-0/l10n-italy-18-0-l10n_it_edi_extension
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/l10n-italy&target_branch=18.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

**Italiano**

Questo modulo estende le funzionalità standard della fatturazione
elettronica italiana di Odoo, introducendo strumenti utili come
l'anteprima XML ed il calcolo dei codici fiscali e miglioramenti
nell'importazione e nell'esportazione delle fatture XML.

Le funzionalità principali incluse sono:

1. Anteprima e Download del file XML:

   - Aggiunge un pulsante ("Preview") direttamente nel form della
     fattura, sia per fatture inviate che ricevute.
   - Dalla stessa finestra della fattura, è possibile scaricare il file
     XML generato.

2. Valorizza i seguenti campi/nodi della fattura elettronica esportata:

   - ``<RiferimentoAmministrazione>`` (sia sulla riga o nell'azienda):
     identificativo utilizzato per uso amministrativo/gestionale
     interno. È un campo libero che può essere utilizzato per inserire
     riferimenti specifici richiesti dalla Pubblica Amministrazione o
     altri riferimenti utili per la gestione amministrativa.
   - ``<StabileOrganizzazione>``: rappresenta i dati della sede
     operativa stabile del cedente/prestatore in Italia se diversa dalla
     sede legale. Da impostare in odoo nell'azienda, tab "Informazioni
     Generali"
   - ``<Causale>``: in questo caso non c'è un campo apposito, ma
     trascrive i "Termini e condizioni" della fattura
   - ``<Art73>``: indica se il documento è stato emesso secondo modalità
     e termini stabiliti con decreto ministeriale ai sensi dell'articolo
     73 del DPR 633/72. Da impostare in odoo nell'azienda o direttamente
     in fattura.
   - ``<AltriDatiGestionali>`` (2.2.1.16): dati gestionali aggiuntivi
     che possono essere inseriti manualmente su ogni riga fattura ed
     esportati nel file XML FatturaPA. Ogni voce include:

     - ``<TipoDato>``: tipo di dato (max 10 caratteri, obbligatorio)
     - ``<RiferimentoTesto>``: riferimento testuale (max 60 caratteri)
     - ``<RiferimentoNumero>``: riferimento numerico (fino a 8 decimali)
     - ``<RiferimentoData>``: riferimento data
     - Per aggiungere questi dati, aprire la riga fattura e compilare la
       sezione "Altri Dati Gestionali".

   - ``<IndirizzoResa>``: rappresenta l'indirizzo di consegna della
     merce.

3. Miglioramenti nell'import delle fatture XML:

   - Aggiunge un'opzione per creare i contatti presenti in una fattura
     elettronica se non esistono in anagrafica tra cui:

     - ``<CessionarioCommittente>`` e ``<CedentePrestatore>`` invece di
       scrivere solamente i dettagli nel chatter.

   - Creazione di altri contatti presenti in una fattura elettronica se
     non esistono in anagrafica tra cui:

     - ``<RappresentanteFiscale>``

   - Nome e cognome vengono assegnati ai nuovi contatti in base ai nodi
     ``<Nome>`` e ``<Cognome>`` della fattura elettronica.

   - Gestione delle Fatture Elettroniche Multiple:

     - Supporto per la suddivisione automatica di file XML contenenti
       più fatture
     - Ogni ``<FatturaElettronicaBody>`` viene convertito in una fattura
       separata mantenendo l'header originale

   - Aggiunge la possibilità di scegliere tra 3 modalità di
     importazione:

     - senza righe
     - una riga per ogni aliquota
     - tutte le righe (default)

   - Importazione dei ``<DatiRiepilogo>``:

     - ``<AliquotaIVA>``
     - ``<Natura>``: Indica il motivo per cui un'operazione non prevede
       l'IVA
     - ``<SpeseAccessorie>``: es. trasporto, imballaggio
     - ``<Arrotondamento>``
     - ``<ImponibileImporto>``
     - ``<Imposta>``
     - ``<EsigibilitaIVA>``: Indica quando l'IVA diventa esigibile
       (immediata, differita o scissione dei pagamenti)
     - ``<RiferimentoNormativo>``: Obbligatorio quando si usa il campo
       ``<Natura>``

   - Importazione dei ``<DatiGeneraliDocumento>``:

     - ``<Arrotondamento>``
     - ``<Art73>``: indica se il documento è stato emesso secondo
       modalità e termini stabiliti con decreto ministeriale ai sensi
       dell'articolo 73 del DPR 633/72
     - ``<DatiSAL>`` e ``<RiferimentoFase>``: utilizzati per indicare lo
       stato di avanzamento dei lavori in caso di fatturazione
       dilazionata/progressiva (contratti di appalto, servizi
       continuativi o lavori in corso d'opera)

   - Importazione dei dati della fattura principale
     (``<NumeroFatturaPrincipale>`` e ``<DataFatturaPrincipale>``)

   - Scrittura nel chatter dei nodi di ``<DatiGenerali><DatiTrasporto>``
     e ``<DatiVeicoli>``

   - Gestione avanzata dei Dati delle Righe Fattura:

     - Creazione dei codici articolo in fase di importazione. Questi
       codici servono per identificare univocamente i prodotti/servizi
       secondo diversi standard di codifica. Nel file XML, questi codici
       sono nel nodo ``<CodiceArticolo>`` che può contenere:

       - ``<CodiceTipo>``: identifica il tipo di codifica utilizzata
       - ``<CodiceValore>``: il valore effettivo del codice

     - Registrazione dello sconto o maggiorazione, nodo
       ``<ScontoMaggiorazione>``, nelle righe di dettaglio della
       fattura.
     - Importazione dei dati del nodo ``<AltriDatiGestionali>``
       (informazioni supplementari che non trovano posto negli altri
       campi standard della fattura elettronica) che può contenere:

       - ``<TipoDato>``: identifica il tipo di informazione aggiuntiva
         che si sta inserendo
       - ``<RiferimentoTesto>``: contiene un valore testuale
         dell'informazione aggiuntiva
       - ``<RiferimentoNumero>``: contiene un valore numerico
         dell'informazione aggiuntiva
       - ``<RiferimentoData>``: contiene un valore data
         dell'informazione aggiuntiva

     - Importazione dei nodi:

       - ``<NumeroLinea>``: numero progressivo della riga all'interno
         della fattura
       - ``<TipoCessionePrestazione>``: indica la tipologia della
         cessione o prestazione e può contenere valori come:

         - "SC" (Sconto)
         - "PR" (Premio)
         - "AB" (Abbuono)
         - "AC" (Spesa accessoria)

       - ``<DataInizioPeriodo>`` e ``<DataFinePeriodo>``: indicano il
         periodo di riferimento di una prestazione e sono utili per
         servizi continuativi o prestazioni che si estendono su un
         periodo di tempo
       - ``<RiferimentoAmministrazione>``: identificativo utilizzato per
         uso amministrativo/gestionale interno. È un campo libero che
         può essere utilizzato per inserire riferimenti specifici
         richiesti dalla Pubblica Amministrazione o altri riferimenti
         utili per la gestione amministrativa.

   - Convalida della fattura importata: se i seguenti importi sono
     diversi da quelli presenti nel file XML, nella fattura viene
     visualizzato un messaggio:

     - importo totale imponibile
     - IVA totale
     - IVA inclusa

   - I dati del partner possono essere aggiornati per corrispondere a
     quelli nella fattura elettronica.

4. Aggiunge di un wizard per calcolare i codici fiscali

<https://www.fatturapa.gov.it>

**English**

This module extends Odoo's standard Italian electronic invoicing
functionality, introducing useful tools such as XML preview and fiscal
code calculation and improvements in importing and exporting XML
invoices.

The main features included are:

1. XML File Preview and Download:

   - Adds a button ("Preview") directly in the invoice form, both for
     exported and imported invoices.
   - From the same invoice form, you can download the generated XML
     file.

2. Adds fields in XML invoice export:

   - ``<RiferimentoAmministrazione>`` (both on line or on company):
     identifier used for internal administrative/management purposes.
     It's a free field that can be used to insert specific references
     required by Public Administration or other useful references for
     administrative management.
   - ``<StabileOrganizzazione>``: represents the data of the
     seller/provider's permanent establishment in Italy if different
     from the registered office
   - ``<Causale>``: in this case there is no specific field, but it
     transcribes the "Terms and conditions" of the invoice.
   - ``<Art73>``: indicates if the document was issued according to
     methods and terms established by ministerial decree pursuant to
     article 73 of DPR 633/72
   - ``<AltriDatiGestionali>`` (2.2.1.16): additional management data
     that can be manually entered on each invoice line and exported to
     the FatturaPA XML file. Each entry includes:

     - ``<TipoDato>``: data type (max 10 characters, required)
     - ``<RiferimentoTesto>``: text reference (max 60 characters)
     - ``<RiferimentoNumero>``: numeric reference (up to 8 decimal
       places)
     - ``<RiferimentoData>``: date reference
     - To add this data, open the invoice line and fill in the "Other
       Management Data" section.

   - ``<IndirizzoResa>``: represents the shipping address of the goods.

3. Improvements in XML invoice import:

   - Adds an option to create contacts present in an electronic invoice
     if they don't exist in the address book, including:

     - ``<CessionarioCommittente>`` and ``<CedentePrestatore>`` instead
       of just writing the details in the chatter.

   - Creation of other contacts present in an electronic invoice if they
     don't exist in the address book, including:

     - ``<RappresentanteFiscale>``

   - Name and surname are set in the new contacts based on the
     ``<Nome>`` and ``<Cognome>`` nodes of the E-Bill.

   - Multiple Electronic Invoice Management:

     - Support for automatic splitting of XML files containing multiple
       invoices
     - Each ``<FatturaElettronicaBody>`` is converted into a separate
       invoice maintaining the original header

   - Adds the ability to choose between 3 import modes:

     - without lines
     - one line for each VAT rate
     - all lines (default)

   - Import of ``<DatiRiepilogo>``:

     - ``<AliquotaIVA>``
     - ``<Natura>``: Indicates the reason why an operation does not
       include VAT
     - ``<SpeseAccessorie>``: e.g., transport, packaging
     - ``<Arrotondamento>``
     - ``<ImponibileImporto>``
     - ``<Imposta>``
     - ``<EsigibilitaIVA>``: Indicates when VAT becomes payable
       (immediate, deferred, or split payment)
     - ``<RiferimentoNormativo>``: Required when using the ``<Natura>``
       field

   - Import of ``<DatiGeneraliDocumento>``:

     - ``<Arrotondamento>``
     - ``<Art73>``: indicates if the document was issued according to
       methods and terms established by ministerial decree pursuant to
       article 73 of DPR 633/72
     - ``<DatiSAL>`` and ``<RiferimentoFase>``: used to indicate the
       progress status of work in case of deferred/progressive invoicing
       (procurement contracts, continuous services, or work in progress)

   - Import of main invoice data (``<NumeroFatturaPrincipale>`` and
     ``<DataFatturaPrincipale>``)

   - Writing in chatter of ``<DatiGenerali><DatiTrasporto>`` and
     ``<DatiVeicoli>`` nodes

   - Advanced management of Invoice Line Data:

     - Creation of article codes during import. These codes are used to
       uniquely identify products/services according to different coding
       standards. In the XML file, these codes are in the
       ``<CodiceArticolo>`` node which can contain:

       - ``<CodiceTipo>``: identifies the type of coding used
       - ``<CodiceValore>``: the actual code value

     - Recording of discounts or surcharges, ``<ScontoMaggiorazione>``,
       in the invoice detail lines.
     - Import of ``<AltriDatiGestionali>`` node data (supplementary
       information that doesn't fit in other standard electronic invoice
       fields) which can contain:

       - ``<TipoDato>``: identifies the type of additional information
         being entered
       - ``<RiferimentoTesto>``: contains a textual value of the
         additional information
       - ``<RiferimentoNumero>``: contains a numerical value of the
         additional information
       - ``<RiferimentoData>``: contains a date value of the additional
         information

     - Import of nodes:

       - ``<NumeroLinea>``: progressive line number within the invoice
       - ``<TipoCessionePrestazione>``: indicates the type of transfer
         or service and can contain values such as:

         - "SC" (Discount)
         - "PR" (Prize)
         - "AB" (Allowance)
         - "AC" (Ancillary expense)

       - ``<DataInizioPeriodo>`` and ``<DataFinePeriodo>``: indicate the
         reference period of a service and are useful for continuous
         services or services that extend over a period of time
       - ``<RiferimentoAmministrazione>``: identifier used for internal
         administrative/management purposes. It's a free field that can
         be used to insert specific references required by Public
         Administration or other useful references for administrative
         management.

   - Validation of imported bill: if the following amounts are different
     than the amount in the XML a message is shown in the bill:

     - total taxable amount
     - total VAT
     - total including VAT

   - Partner's data can be updated to match the data in the e-bill

4. Adds a wizard to calculate fiscal codes

<https://www.fatturapa.gov.it>

**Table of contents**

.. contents::
   :local:

Configuration
=============

**Italiano**

Le uniche configurazioni disponibili sono:

- Livello di dettaglio importazione e-fatture: in Fatturazione (o
  Contabilità per EE) > Configurazione > Impostazioni > Fatturazione
  Elettronica Italiana, valorizzare "Livello di dettaglio importazione
  e-fatture" per importare le fatture elettroniche senza righe, con una
  riga per ogni aliquota, oppure con tutte le righe (default). Questa
  configurazione può essere sovrascritta dal campo "Livello di dettaglio
  importazione e-fatture" in ogni fornitore.
- Crea il partner se non esiste durante l'importazione: in Fatturazione
  (o Contabilità per EE) > Configurazione > Impostazioni > Fatturazione
  Elettronica Italiana, spuntare l'opzione se si vuole attivare la
  funzionalità per i dati dei nodi:

  - ``<CessionarioCommittente>``
  - ``<CedentePrestatore>``
  - ``<RappresentanteFiscale>``

- Prodotto predefinito fatture elettroniche fornitore: è possibile
  impostare un prodotto nel campo apposito del fornitore, nella scheda
  "Fatturazione", sezione "Fatture cliente". Durante l'importazione di
  livello "Massimo": questo prodotto sarà impostato nelle righe della
  fattura importata se nessun altro prodotto viene trovato. Durante
  l'importazione di livello "Aliquota fiscale": questo prodotto sarà
  impostato nelle righe della fattura importata.

Non sono necessarie altre configurazioni specifiche per
l10n_it_edi_extension: una volta installato, le sue funzionalità sono
attive e si integrano automaticamente nell'interfaccia esistente.

Tuttavia, è fondamentale capire che questo modulo è un'estensione e si
basa su altri moduli preesistenti e sulla configurazione generale di
Odoo per la localizzazione italiana e la fatturazione elettronica.
Quindi, affinché le funzionalità di questo modulo siano utilizzabili, è
necessario che siano installati e configurati i moduli dipendenti:

- ``account``: Il modulo base della contabilità di Odoo deve essere
  installato e configurato (piano dei conti, tasse, giornali contabili,
  ecc.).
- ``l10n_it_edi``: Il modulo principale per la fatturazione elettronica
  italiana deve essere installato e correttamente configurato. Questo
  include:

  - Configurazione dei dati aziendali (partita IVA, codice fiscale,
    regime fiscale, ecc.).
  - Configurazione dei registri contabili per l'emissione delle fatture
    elettroniche (indicando il formato FatturaPA/Elettronica).
  - Configurazione delle sequenze dedicate per la numerazione delle
    fatture elettroniche.
  - Eventuale configurazione delle credenziali SDI se si utilizza
    l'invio diretto tramite Odoo (se supportato dalla configurazione
    generale).

Nel partner è possibile abilitare il campo "Non aggiornare il contatto
dai dettagli della fattura elettronica" così i dati del partner non
saranno modificati in base a quanto presente in una delle loro fatture
durante l'importazione.

**English**

The only available configurations are:

- E-invoice import detail level: in Invoicing (or Accounting for EE) >
  Configuration > Settings > Italian Electronic Invoicing, set
  "E-invoice import detail level" to import electronic invoices without
  lines, with one line per tax rate, or with all lines (default). This
  configuration can be overridden by the "E-invoice import detail level"
  field in each supplier.
- Create partner if not existing during import: in Invoicing (or
  Accounting for EE) > Configuration > Settings > Italian Electronic
  Invoicing, check this option if you want to enable the functionality
  for the following node data:

  - ``<CessionarioCommittente>``
  - ``<CedentePrestatore>``
  - ``<RappresentanteFiscale>``

- E-bills default product: You can set a product in the supplier's field
  in the "Invoicing" tab, "Customer Invoices" section. During "Maximum"
  level imports: this product will be set in the imported invoice lines
  if no other product is found. During "Tax Rate" level imports: this
  product will be set in the imported invoice lines.

No other specific configurations are required for l10n_it_edi_extension:
once installed, its features are active and automatically integrate into
the existing interface.

However, it's essential to understand that this module is an extension
and relies on other pre-existing modules and Odoo's general
configuration for Italian localization and electronic invoicing.
Therefore, for this module's features to be usable, the dependent
modules must be installed and configured:

- ``account``: Odoo's basic accounting module must be installed and
  configured (chart of accounts, taxes, journals, etc.).
- ``l10n_it_edi``: The main module for Italian electronic invoicing must
  be installed and properly configured. This includes:

  - Company data configuration (VAT number, fiscal code, tax regime,
    etc.).
  - Configuration of accounting journals for issuing electronic invoices
    (indicating FatturaPA/Electronic format).
  - Configuration of dedicated sequences for electronic invoice
    numbering.
  - Optional SDI credentials configuration if direct sending through
    Odoo is used (if supported by general configuration).

In the partner, you can enable "Do not update the contact from
Electronic Invoice Details" so that the partner's data are not modified
with what is found in one of their imported e-bill.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/l10n-italy/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/l10n-italy/issues/new?body=module:%20l10n_it_edi_extension%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
-------

* Giuseppe Borruso

Contributors
------------

- Giuseppe Borruso - Dinamiche Aziendali srl
  <gborruso@dinamicheaziendali.it>
- `Aion Tech <https://aiontech.company/>`__:

  - Simone Rubino <simone.rubino@aion-tech.it>

- Simone Rubino <simone.rubino88@gmail.com>
- Nextev Srl <odoo@nextev.it>

Maintainers
-----------

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.

This module is part of the `OCA/l10n-italy <https://github.com/OCA/l10n-italy/tree/18.0/l10n_it_edi_extension>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
