diff --git a/content/applications/finance/fiscal_localizations/spain.rst b/content/applications/finance/fiscal_localizations/spain.rst index 98674525e..056907cca 100644 --- a/content/applications/finance/fiscal_localizations/spain.rst +++ b/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 `_ 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 ` 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 `_ 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 ` 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 `_. + +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 `. + +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. diff --git a/content/applications/finance/fiscal_localizations/spain/administrative-center.png b/content/applications/finance/fiscal_localizations/spain/administrative-center.png new file mode 100644 index 000000000..2a59d289d Binary files /dev/null and b/content/applications/finance/fiscal_localizations/spain/administrative-center.png differ diff --git a/content/applications/finance/fiscal_localizations/spain/facturae-checkbox.png b/content/applications/finance/fiscal_localizations/spain/facturae-checkbox.png new file mode 100644 index 000000000..895a7d56c Binary files /dev/null and b/content/applications/finance/fiscal_localizations/spain/facturae-checkbox.png differ diff --git a/content/applications/finance/fiscal_localizations/spain/modelo-reports.png b/content/applications/finance/fiscal_localizations/spain/modelo-reports.png new file mode 100644 index 000000000..7073b4f1d Binary files /dev/null and b/content/applications/finance/fiscal_localizations/spain/modelo-reports.png differ diff --git a/content/applications/finance/fiscal_localizations/spain/qr-code.png b/content/applications/finance/fiscal_localizations/spain/qr-code.png new file mode 100644 index 000000000..ff78141d7 Binary files /dev/null and b/content/applications/finance/fiscal_localizations/spain/qr-code.png differ diff --git a/content/applications/finance/fiscal_localizations/spain/ticketbai-invoice.png b/content/applications/finance/fiscal_localizations/spain/ticketbai-invoice.png new file mode 100644 index 000000000..d7b4fa2c5 Binary files /dev/null and b/content/applications/finance/fiscal_localizations/spain/ticketbai-invoice.png differ