[IMP] localization/spain

Updated the Spain localization page

taskid-3736761

closes odoo/documentation#7892

X-original-commit: b2bad17b19
Signed-off-by: Audrey Vandromme (auva) <auva@odoo.com>
Signed-off-by: Tom Aarab (toaa) <toaa@odoo.com>

content/applications/finance/fiscal_localizations/spain.rst

@@ -2,34 +2,164 @@
 Spain
 =====
 
-Spanish chart of accounts
-=========================
+Configuration
+=============
 
-Several Spanish charts of accounts are available by default in Odoo:
+Install the 🇪🇸 **Spanish** :doc:`fiscal localization package <../fiscal_localizations>` to get all
+the default accounting features of the Spanish localization.
 
-- PGCE PYMEs 2008
-- PGCE Completo 2008
-- PGCE Entitades
+Three **Spanish** localizations exist, each with its own pre-configured **PGCE** charts of accounts:
 
-To choose the one you want, go to :menuselection:`Accounting --> Configuration --> Settings`,
-then select a package in the :guilabel:`Fiscal localization` section.
+- Spain - SMEs (2008);
+- Spain - Complete (2008);
+- Spain - Non-profit entities (2008).
 
-.. tip::
-    When you create a new Odoo Online database, the PGCE PYMEs 2008 is installed by default.
+To select the one to use, go to :menuselection:`Accounting --> Configuration --> Settings` and
+select a package in the :guilabel:`Fiscal Localization` section.
 
 .. warning::
    You can only change the accounting package as long as you have not created any accounting entry.
 
-Spanish accounting reports
-==========================
+Chart of accounts
+=================
 
-If the Spanish accounting localization is installed, you have access to accounting reports specific
-to Spain:
+You can reach the **Chart of Accounts** by going to :menuselection:`Accounting --> Configuration -->
+Accounting: Chart of Accounts`.
 
-- Balance Sheet
-- Tax Report (Modelo 111)
-- Tax Report (Modelo 115)
-- Tax Report (Modelo 303)
-- Tax Report (Modelo 347)
-- Tax Report (Modelo 349)
-- Tax Report (Modelo 390)
+.. tip::
+    When you create a new Odoo Online database, **Spain - SMEs (2008)** is installed by default.
+
+Taxes
+=====
+
+Default Spain-specific taxes are created automatically when the
+:guilabel:`Spanish - Accounting (PGCE 2008) (l10n_es)` module is installed, and tax reports are
+available when installing the module :guilabel:`Spain - Accounting (PGCE 2008) (l10n_es_reports)`.
+Each tax impacts the Spain-specific **tax reports (Modelo)**, available by going to
+:menuselection:`Accounting --> Reporting --> Statements Reports: Tax Report`.
+
+Reports
+=======
+
+Here is the list of Spanish-specific statement reports available:
+
+- Balance Sheet;
+- Profit & Loss;
+- EC Sales List;
+- Tax Report (Modelo 111);
+- Tax Report (Modelo 115);
+- Tax Report (Modelo 303);
+- Tax Report (Modelo 347);
+- Tax Report (Modelo 349);
+- Tax Report (Modelo 390).
+
+You can access Spain-specific tax reports by clicking on the **book** icon when on a report and
+selecting its Spain-specific version: :guilabel:`(ES)`.
+
+.. image:: spain/modelo-reports.png
+   :alt: Spain-specific tax reports.
+
+TicketBAI
+=========
+
+`Ticket BAI <https://www.gipuzkoa.eus/es/web/ogasuna/ticketbai>`_ or **TBAI** is an e-Invoicing
+system used by the Basque government and its three provincial councils (Álava, Biscay, and
+Gipuzkoa).
+
+Odoo supports the **TicketBAI (TBAI)** electronic invoicing format for all three regions of the
+**Basque Country**. To enable **TicketBAI**, set your company's :guilabel:`Country` and
+:guilabel:`Tax ID` under :menuselection:`Settings --> General Settings` in the :guilabel:`Companies`
+section.
+
+Then, :ref:`install <general/install>` the module :guilabel:`Spain -TicketBAI (l10n_es_edi_TBAI)`,
+go to :menuselection:`Accounting --> Configuration --> Settings`, and select a **region** in the
+:guilabel:`Spain Localization` section's :guilabel:`Tax Agency for TBAI` field.
+
+Once a region is selected, click :guilabel:`Manage certificates (SII/TicketBAI)`, then click
+:guilabel:`New`, upload the certificate, and enter the password provided by the tax agency.
+
+.. warning::
+   If you are testing certificates, enable :guilabel:`Test Mode` in the
+   :guilabel:`Spain Localization` section, which can be found under :guilabel:`Accounting` in
+   the **Settings** app.
+
+Use case
+--------
+
+Once an invoice has been :doc:`created <../../finance/accounting/customer_invoices>` and confirmed,
+a TicketBAI **banner** appears at the top.
+
+.. image:: spain/ticketbai-invoice.png
+   :alt: TicketBAI banner at the top of the invoice once sent.
+
+Odoo sends invoices through TicketBAI automatically every **24 hours**. However, you can click
+:guilabel:`Process now` to send the invoice immediately.
+
+When the invoice is **sent**, the status of the field :guilabel:`Electronic Invoice` changes to
+:guilabel:`Sent`, and the XML file can be found in the **chatter**. Under the
+:guilabel:`EDI Documents` tab, you can see the traceability of other generated documents related to
+the invoice (e.g., if the invoice should also be sent through the **SII**, it will appear here).
+
+.. note::
+   The TBAI **QR code** is displayed on the invoice PDF.
+
+   .. image:: spain/qr-code.png
+      :alt: QR code of the TicketBAI on the invoice.
+
+FACe
+====
+
+`FACe <https://face.gob.es/en>`_ is the e-Invoicing platform used by the public administrations in
+Spain to send electronic invoices.
+
+Before configuring the :abbr:`FACe (General Entrance for Electronic Invoices)` system,
+:ref:`install <general/install>` the :guilabel:`Spain - Facturae EDI (l10n_es_edi_facturae)` module
+and other **Facturae EDI**-related modules.
+
+To enable FACe, go to :menuselection:`Settings --> General Settings`, click
+:guilabel:`Update Info` in the :guilabel:`Companies` section, then click :guilabel:`Update Info` and
+set the :guilabel:`Country` and :guilabel:`Tax ID` of your company. Next, add the
+:guilabel:`Facturae signature certificate` by clicking :guilabel:`Add a line`, uploading the
+certificate provided by the tax agency, and entering the provided password.
+
+Use case
+--------
+
+Once you have :doc:`created <../../finance/accounting/customer_invoices>` an invoice and confirmed
+it, click :guilabel:`Send & Print`. Make sure :guilabel:`Generate Facturae edi file` is enabled, and
+click :guilabel:`Send & Print` again. Once the invoice is sent, the generated XML file is available
+in the **chatter**.
+
+.. warning::
+   The file is **NOT** automatically sent. You have to send it yourself manually.
+
+.. tip::
+   You can send **FACe** XML files in batch through `the governmental portal <https://www.facturae.gob.es/formato/Paginas/descarga-aplicacion-escritorio.aspx>`_.
+
+Administrative centers
+----------------------
+
+In order for **FACe** to work with **administrative centers**, the invoice *must* include specific
+data about the centers.
+
+.. note::
+   Make sure to have the :guilabel:`Spain - Facturae EDI - Administrative Centers Patch
+   (l10n_es_edi_facturae_adm_centers)` module :ref:`installed <general/install>`.
+
+To add **administrative centers**, create a new **contact** to add to the **partner** company.
+Select :guilabel:`FACe Center` as the **type**, assign one or more **role(s)** to that contact, and
+:guilabel:`Save`. The **three** roles usually required are:
+
+- Órgano gestor: :guilabel:`Receptor` (Receiver);
+- Unidad tramitadora: :guilabel:`Pagador` (Payer);
+- Oficina contable: :guilabel:`Fiscal` (Fiscal).
+
+.. image:: spain/administrative-center.png
+   :alt: Administrative center contact form for public entities.
+
+.. tip::
+   - If administrative centers need different :guilabel:`Codes` per role, you *must* create
+     different centers for each role.
+   - When an electronic invoice is created using a partner with **administrative centers**, *all*
+     administrative centers are included in the invoice.
+   - You can add one contact with multiple roles or multiple contacts with a different role each.