[REF][MOV] documentation apocalypse

Prior to this commit, the Odoo documentation was mainly split between
two repositories: odoo/odoo/doc and odoo/documentation-user. Some bits
of documentation were also hosted elsewhere (e.g., wiki, upgrade, ...).
This was causing several problems among which:
  - The theme, config, Makefile, and similar technical resources had to
    be duplicated. This resulted in inconsistent layout, features, and
    build environments from one documentation to another.
  - Some pages did not fit either documentation as they were relevant
    for both users and developers. Some were relevant to neither of the
    two (e.g., DB management).
  - Cross-doc references had to be absolute links and they broke often.
  - Merging large image files in the developer documentation would bloat
    the odoo/odoo repository. Some contributions had to be lightened to
    avoid merging too many images (e.g., Odoo development tutorials).
  - Long-time contributors to the user documentation were chilly about
    going through the merging process of the developer documentation
    because of the runbot, mergebot, `odoo-dev` repository, etc.
  - Some contributors would look for the developer documentation in the
    `odoo/documentation-user` repository.
  - Community issues about the user documentation were submitted on the
    `odoo/odoo` repository and vice-versa.

Merging all documentations in one repository will allow us to have one
place, one theme, one work process, and one set of tools (build
environment, ...) for all of the Odoo docs.

As this is a good opportunity to revamp the layout of the documentation,
a brand new theme replaces the old one. It features a new way to
navigate the documentation, centered on the idea of always letting the
reader know what is the context (enclosing section, child pages, page
structure ...) of the page they are reading. The previous theme would
quickly confuse readers as they navigated the documentation and followed
cross-application links.

The chance is also taken to get rid of all the technical dangling parts,
performance issues, and left-overs. Except for some page-specific JS
scripts, the Odoo theme Sphinx extension is re-written from scratch
based on the latest Sphinx release to benefit from the improvements and
ease future contributions.

task-2351938
task-2352371
task-2205684
task-2352544

Closes #945
This commit is contained in:
Antoine Vandevenne (anv)
2021-04-30 12:40:29 +02:00
committed by Antoine Vandevenne (anv)
parent eac5e9f865
commit e3fee2cf46
2471 changed files with 39885 additions and 60126 deletions
@@ -0,0 +1,126 @@
==========
Italy (IT)
==========
Questa guida spiegherà come utilizzare la fattura elettronica in Odoo e
come configurare correttamente i dati aziendali, i contatti e la
contabilità. Per testare la fattura elettronica i dati devono essere
reali e non inventati, altrimenti il sistema dellagenzia delle entrate
non riconoscerà linterscambio di informazioni.
Configurare le informazioni sulla tua Azienda
=============================================
Il passo successivo è la configurazione delle informazioni necessarie al
funzionamento della fatturazione elettronica. Si può accedere alla
schermata dallapplicazione Impostazioni: selezionare “Utenti e aziende”
e scegliere Aziende. Accedere quindi alle informazioni sulla Azienda per
cui si desidera configurare la fatturazione elettronica.
I dati necessari al funzionamento dello strumento di fatturazione
elettronica sono i seguenti:
- Server PEC. Le informazioni sul server utilizzato dal tuo indirizzo
di posta elettronica certificata sono fornite dal tuo fornitore o dal
Ministero. Lo stesso server deve essere configurato come server che
gestisce tutta la corrispondenza mail in Odoo, per saperne di più si
puo consultare la relativa
`guida <https://www.odoo.com/documentation/user/12.0/discuss/email_servers.html>`__.
- Indirizzo PEC dell Azienda, tale indirizzo deve essere lo stesso
registrato presso lAgenzia delle Entrate per lutilizzo dei servizi
di fatturazione elettronica.
- Indirizzo PEC dellAgenzia delle Entrate. La mail sarà fornito al
momento della registrazione della tua PEC presso lAgenzia delle
Entrate, ricorda che lAgenzia delle Entrate potrebbe cambiare questo
indirizzo in seguito, previa comunicazione.
- Partita IVA e Codice Fiscale. Per far si che la Fatturazione
Elettronica funzioni correttamente, questi cambi devono essere
compilati correttamente.
- Regime Fiscale. Il regime fiscale a cui è sottoposta lAzienda deve
essere selezionato scegliendo dalla lista precompilata fornita da
Odoo. Chiedi al commercialista qual’è il corretto regime fiscale!
- Numero di Iscrizione nel registro delle Imprese.
.. image:: media/italy_IT01.png
:align: center
1. Configurare le impostazioni per la Fatturazione Elettronica
--------------------------------------------------------------
- Numero di iscrizione nel registro Imprese tenuto presso la Camera di
Commercio.
- Rappresentate Fiscale. Questa opzione è dedicata ad aziende con sede
al di fuori del territorio nazionale ma conducenti attività
commerciali in Italia rilevanti ai fini dellIVA. È possibile
indicare in questo campo se lAzienda si avvale di un Rappresentate
Fiscale in Italia.
.. image:: media/italy_IT02.png
:align: center
1. Configurare il profilo dei clienti
-------------------------------------
Per un corretto utilizzo dellapplicazione, il profilo di clienti e
fornitori, nellapplicazione contatti, deve essere configurato con le
necessarie informazioni legali.
Selezionando il nome del cliente e accedendo quindi ai suoi dati, si
trovano i seguenti campi che devono essere compilati: Indirizzo PEC,
Codice Fiscale e Indice PA *che deve contere i 6-7 caratteri
contenuti nellindice PA e necessari per la comunicazione tramite
fattura elettronica*.
.. image:: media/italy_IT03.png
:align: center
Il processo di fatturazione
===========================
Si può procedere ad emettere una fattura seguendo le indicazioni
dellapplicazione. Il momento che determina il formale invio della
fattura è il momento in cui viene selezionata lopzione “Valida”. La
fattura viene quindi inviata: lo stato della sua consegna verrà
notificato allutente tramite pop-up sulla parte iniziale della
schermata della fattura.
.. image:: media/italy_IT04.png
:align: center
.. image:: media/italy_IT05.png
:align: center
I messaggi che possono apparire sono i seguenti:
1. Fattura invitata. In attesa di accettazione
2. Invio fallito. Puoi modificare la fattura ed inviarla di nuovo
3. La fattura è stata correttamente inviata ed accettata dal
destinatario.
I vari stadi di spedizione e recezione della fattura sono visibili anche
dallelenco delle Fatture nella forma di icone, accanto alla colonna
“Stato” dallapplicazione contabilità.
*Icona Rossa:* Invio fallito
*Icona Gialla:* Fattura invitata. In attesa di accettazione
*Icona Verde:* Fattura inviata e accettata dal destinatario
Per inviare la fattura tramite PEC e generare il file XML, basterà
cliccare su invia. Il documento verrà poi mostrato tra gli allegati.
.. image:: media/italy_IT06.png
:align: center