odoo-forge-bundle 0.1.0

package/payload/skills/odoo18-docs/references/docs/applications/finance/fiscal_localizations/spain.md

@@ -0,0 +1,201 @@
+---
+title: "Spain"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/fiscal_localizations/spain.html"
+---
+
+=====
+# Spain
+
+# Configuration
+
+Install the 🇪🇸 **Spanish** :doc:`fiscal localization package <../fiscal_localizations>` to get all
+the default accounting features of the Spanish localization.
+
+Three **Spanish** localizations exist, each with its own pre-configured **PGCE** charts of accounts:
+
+- Spain - SMEs (2008);
+- Spain - Complete (2008);
+- Spain - Non-profit entities (2008).
+
+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.
+
+.. seealso::
+   - :doc:`Documentation on e-invoicing’s legality and compliance in Spain
+     <../accounting/customer_invoices/electronic_invoicing/spain>`
+   - :doc:`Documentation on e-invoicing’s legality and compliance in the Basque Country
+     <../accounting/customer_invoices/electronic_invoicing/basque_country>`
+
+# Chart of accounts
+
+You can reach the **Chart of Accounts** by going to :menuselection:`Accounting --> Configuration -->
+Accounting: Chart of Accounts`.
+
+> **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 130);
+- 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.
+
+## Modelo 130
+
+### Change the percentage
+
+If you wish to change the percentage computation of the box :guilabel:`[04]` under the :guilabel:`I`
+section and/or of the box :guilabel:`[09]` under the :guilabel:`II` section:
+
+#. Activate the :ref:`developer mode <developer-mode>`, go to :menuselection:`Accounting -->
+   Reporting --> Tax Report`, and select the report :guilabel:`Tax report (Modelo 130)`.
+#. Click the :icon:`fa-cogs` (:guilabel:`cogs`) icon to the right of :guilabel:`Report: Tax Report
+   (Mod 130) (ES)`.
+#. Click the box you wish to change, and in the pop-up window, click on the :guilabel:`percentage`
+   line. In the new pop-up window, change the value in the :guilabel:`Formula` field to the
+   percentage you wish to apply.
+   Repeat this action if you wish to modify the other box as well.
+
+### Report agriculture activity
+
+If you wish to have any amount input in the :guilabel:`II` section (from boxes :guilabel:`[08]` to
+:guilabel:`[11]`), you must change the **industry** of the corresponding contact to
+:guilabel:`Agriculture`:
+
+#. Go to the contact form (:menuselection:`Accounting --> Customers --> Customers`
+   or :menuselection:`Accounting --> Vendors --> Vendors`, for example), and select a contact.
+#. In the :guilabel:`Sales & Purchase` tab, set the :guilabel:`Industry` field to
+   :guilabel:`Agriculture`.
+
+Repeat this operation for all contacts related to the **agriculture** industry.
+
+# 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 configure FACe, follow these steps:
+
+#. Go to :menuselection:`Accounting --> Configuration --> Certificates`.
+#. Click :guilabel:`New` to create a new certificate.
+#. Complete the fields, including uploading the file of the :guilabel:`Certificate` provided by the
+   tax agency and the provided :guilabel:`Certificate Password`.
+
+> **note**:
+>    If using the Invoicing app instead of Accounting, go to :menuselection:`Invoicing -->
+   Configuration --> Certificates`.
+
+## 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.

package/payload/skills/odoo18-docs/references/docs/applications/finance/fiscal_localizations/switzerland.md

@@ -0,0 +1,144 @@
+---
+title: "Switzerland"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/fiscal_localizations/switzerland.html"
+---
+
+===========
+# Switzerland
+
+# ISR (In-payment Slip with Reference number)
+
+The ISRs are payment slips used in Switzerland. You can print them
+directly from Odoo. On the customer invoices, there is a new button
+called *Print ISR*.
+
+.. image:: switzerland/switzerland00.png
+    :align: center
+
+> **tip**:
+>     The button *Print ISR* only appears there is well a bank account
+    defined on the invoice. You can use CH6309000000250097798 as bank
+    account number and 010391391 as CHF ISR reference.
+
+.. image:: switzerland/switzerland01.png
+    :align: center
+
+Then you open a pdf with the ISR.
+
+.. image:: switzerland/switzerland02.png
+    :align: center
+
+There exists two layouts for ISR: one with, and one without the bank
+coordinates. To choose which one to use, there is an option to print the
+bank information on the ISR. To activate it, go in
+:menuselection:`Accounting --> Configuration --> Settings --> Customer Invoices`
+and enable **Print bank on ISR**:
+
+.. image:: switzerland/switzerland03.png
+    :align: center
+
+## ISR reference on invoices
+
+To ease the reconciliation process, you can add your ISR reference as **Payment Reference** on your
+invoices.
+
+To do so, you need to configure the Journal you usually use to issue invoices. Go to
+:menuselection:`Accounting --> Configuration --> Journals`, open the Journal you want to modify (By
+default, the Journal is named *Customer Invoices*), click en *Edit*, and open the *Advanced
+Settings* tab. In the **Communication Standard** field, select *Switzerland*, and click on *Save*.
+
+.. image:: switzerland/switzerland-isr-reference.png
+   :align: center
+   :alt: Configure your Journal to display your ISR as payment reference on your invoices in Odoo
+
+# Currency Rate Live Update
+
+You can update automatically your currencies rates based on the Federal
+Tax Administration from Switzerland. For this, go in
+:menuselection:`Accounting --> Settings`, activate the multi-currencies setting and choose the service
+you want.
+
+.. image:: switzerland/switzerland04.png
+    :align: center
+
+# Updated VAT for January 2018
+
+Starting from the 1st January 2018, new reduced VAT rates will be
+applied in Switzerland. The normal 8.0% rate will switch to 7.7% and the
+specific rate for the hotel sector will switch from 3.8% to 3.7%.
+
+## How to update your taxes in Odoo Enterprise (Odoo Online or On-premise)?
+
+If you have the V11.1 version, all the work is already been done, you
+don't have to do anything.
+
+If you have started on an earlier version, you first have to update the
+module "Switzerland - Accounting Reports". For this, you go in
+:menuselection:`Apps --> remove the filter "Apps" --> search for "Switzerland - Accounting Reports" --> open the module --> click on "upgrade"`.
+
+.. image:: switzerland/switzerland05.png
+    :align: center
+
+Once it has been done, you can work on creating new taxes for the
+updated rates.
+
+> **tip**:
+>     **Do not suppress or modify the existing taxes** (8.0% and 3.8%).
+    You want to keep them since you may have to use both rates for a short
+    period of time. Instead, remember to archive them once you have encoded
+    all your 2017 transactions.
+
+The creation of such taxes should be done in the following manner:
+
+-  **Purchase taxes**: copy the origin tax, change its name, label on
+   invoice, rate and tax group (effective from v10 only)
+
+-  **Sale taxes**: copy the origin tax, change its name, label on
+   invoice, rate and tax group (effective from v10 only). Since the
+   vat report now shows the details for old and new rates, you
+   should also set the tags accordingly to
+
+   -  For 7.7% taxes: Switzerland VAT Form: grid 302 base, Switzerland
+      VAT Form: grid 302 tax
+
+   -  For 3.7% taxes: Switzerland VAT Form: grid 342 base, Switzerland
+      VAT Form: grid 342 tax
+
+You'll find below, as examples, the correct configuration for all taxes
+included in Odoo by default
+
++-------------------------------------------------+------------+------------------------+--------------------------------------+-----------------+---------------------------------------------------------------------------+
+| **Tax Name**                                    | **Rate**   | **Label on Invoice**   | **Tax Group (effective from V10)**   | **Tax Scope**   | **Tag**                                                                   |
++=================================================+============+========================+======================================+=================+===========================================================================+
+| TVA 7.7% sur achat B&S (TN)                     | 7.7%       | 7.7% achat             | TVA 7.7%                             | Purchases       | Switzerland VAT Form: grid 400                                            |
++-------------------------------------------------+------------+------------------------+--------------------------------------+-----------------+---------------------------------------------------------------------------+
+| TVA 7.7% sur achat B&S (Incl. TN)               | 7.7%       | 7.7% achat Incl.       | TVA 7.7%                             | Purchases       | Switzerland VAT Form: grid 400                                            |
++-------------------------------------------------+------------+------------------------+--------------------------------------+-----------------+---------------------------------------------------------------------------+
+| TVA 7.7% sur invest. et autres ch. (TN)         | 7.7%       | 7.7% invest.           | TVA 7.7%                             | Purchases       | Switzerland VAT Form: grid 405                                            |
++-------------------------------------------------+------------+------------------------+--------------------------------------+-----------------+---------------------------------------------------------------------------+
+| TVA 7.7% sur invest. et autres ch. (Incl. TN)   | 7.7%       | 7.7% invest. Incl.     | TVA 7.7%                             | Purchases       | Switzerland VAT Form: grid 405                                            |
++-------------------------------------------------+------------+------------------------+--------------------------------------+-----------------+---------------------------------------------------------------------------+
+| TVA 3.7% sur achat B&S (TS)                     | 3.7%       | 3.7% achat             | TVA 3.7%                             | Purchases       | Switzerland VAT Form: grid 400                                            |
++-------------------------------------------------+------------+------------------------+--------------------------------------+-----------------+---------------------------------------------------------------------------+
+| TVA 3.7% sur achat B&S (Incl. TS)               | 3.7%       | 3.7% achat Incl.       | TVA 3.7%                             | Purchases       | Switzerland VAT Form: grid 400                                            |
++-------------------------------------------------+------------+------------------------+--------------------------------------+-----------------+---------------------------------------------------------------------------+
+| TVA 3.7% sur invest. et autres ch. (TS)         | 3.7%       | 3.7% invest            | TVA 3.7%                             | Purchases       | Switzerland VAT Form: grid 405                                            |
++-------------------------------------------------+------------+------------------------+--------------------------------------+-----------------+---------------------------------------------------------------------------+
+| TVA 3.7% sur invest. et autres ch. (Incl. TS)   | 3.7%       | 3.7% invest Incl.      | TVA 3.7%                             | Purchases       | Switzerland VAT Form: grid 405                                            |
++-------------------------------------------------+------------+------------------------+--------------------------------------+-----------------+---------------------------------------------------------------------------+
+| TVA due a 7.7% (TN)                             | 7.7%       | 7.7%                   | TVA 7.7%                             | Sales           | Switzerland VAT Form: grid 302 base, Switzerland VAT Form: grid 302 tax   |
++-------------------------------------------------+------------+------------------------+--------------------------------------+-----------------+---------------------------------------------------------------------------+
+| TVA due à 7.7% (Incl. TN)                       | 7.7%       | 7.7% Incl.             | TVA 7.7%                             | Sales           | Switzerland VAT Form: grid 302 base, Switzerland VAT Form: grid 302 tax   |
++-------------------------------------------------+------------+------------------------+--------------------------------------+-----------------+---------------------------------------------------------------------------+
+| TVA due à 3.7% (TS)                             | 3.7%       | 3.7%                   | TVA 3.7%                             | Sales           | Switzerland VAT Form: grid 342 base, Switzerland VAT Form: grid 342 tax   |
++-------------------------------------------------+------------+------------------------+--------------------------------------+-----------------+---------------------------------------------------------------------------+
+| TVA due a 3.7% (Incl. TS)                       | 3.7%       | 3.7% Incl.             | TVA 3.7%                             | Sales           | Switzerland VAT Form: grid 342 base, Switzerland VAT Form: grid 342 tax   |
++-------------------------------------------------+------------+------------------------+--------------------------------------+-----------------+---------------------------------------------------------------------------+
+
+If you have questions or remarks, please contact our support using
+odoo.com/help.
+
+> **tip**:
+>     Don't forget to update your fiscal positions. If you have a version
+    11.1 (or higher), there is nothing to do. Otherwise, you will also
+    have to update your fiscal positions accordingly.

package/payload/skills/odoo18-docs/references/docs/applications/finance/fiscal_localizations/thailand.md

@@ -0,0 +1,158 @@
+---
+title: "Thailand"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/fiscal_localizations/thailand.html"
+---
+
+========
+# Thailand
+
+# Configuration
+
+:ref:`Install <general/install>` the :guilabel:`🇹🇭 Thailand` localization package to get all the
+features of the Thai localization:
+
+.. list-table::
+   :header-rows: 1
+
+   * - Name
+     - Technical name
+     - Description
+   * - :guilabel:`Thailand - Accounting`
+     - `l10n_th`
+     - Default :ref:`fiscal localization package <fiscal_localizations/packages>`
+   * - :guilabel:`Thailand - Accounting Reports`
+     - `l10n_th_reports`
+     - Country-specific accounting reports
+
+.. image:: thailand/modules.png
+   :alt: Thailand localization modules
+
+# Chart of accounts and taxes
+
+Odoo's fiscal localization package for Thailand includes the following taxes:
+
+- VAT 7%
+- VAT-exempted
+- Withholding tax
+- Withholding income tax
+
+# Tax report
+
+Odoo allows users to generate Excel files to submit their VAT to the **Revenue Department** of
+Thailand.
+
+## Sales and purchase tax report
+
+To generate a sales and purchase tax report, go to :menuselection:`Accounting --> Reporting --> Tax
+Report`. Select a specific time or time range on the tax report, and click
+:guilabel:`VAT-202-01 (xlsx)` for purchase tax and :guilabel:`VAT-202-02 (xlsx)` for sales tax.
+
+.. image:: thailand/tax-report.png
+   :alt: Thai purchase and sales taxes reports
+
+## Withholding PND tax report
+
+PND report data displays the summarized amounts of the applicable **withholding corporate income
+tax returns (domestic)** from vendor bills under the :guilabel:`PND53 (TH)` and
+:guilabel:`PND3 (TH)` tax reports. It is installed by default with the Thai localization.
+
+.. image:: thailand/pnd-report.png
+   :alt: PND tax reports
+
+> **note**:
+>    Withholding corporate income tax returns (domestic) is the tax used in case the company has
+   withheld the tax from “**Personal (PND3)**” or “**Corporate (PND53)**” services provided such as
+   rental, hiring, transportation, insurance, management fee, consulting, etc.
+
+The PND tax report allows users to generate a CSV file for bills to upload on the
+[RDprep for Thailand e-Filling application ](https://efiling.rd.go.th/rd-cms/).
+
+To generate a PND CSV file, go to :menuselection:`Accounting --> Reporting --> Tax Report`, select a
+specific time or time range on the tax report, and click :guilabel:`PND3` or :guilabel:`PND53`.
+
+This generates the :file:`Tax Report PND3.csv` and :file:`Tax Report PND53.csv` files that lists all
+the vendor bill lines with the applicable withholding tax.
+
+.. image:: thailand/pnd3-pnd53.png
+   :alt: PND3 and PND53 CSV files
+
+> **warning**:
+>    Odoo cannot generate the PND or PDF report or **withholding tax certificate** directly. The
+   generated :file:`Tax Report PND3.csv` and :file:`Tax Report PND53.csv` files must be exported
+   to an external tool to convert them into a **withholding PND** report or a **PDF** file.
+
+# Tax invoice
+
+The **tax invoice PDF** report can be generated from Odoo through the **Invoicing** module. Users
+have the  option to print PDF reports for normal invoices and tax invoices. To print out
+**tax invoices**, users can click on :guilabel:`Print Invoices` in Odoo. Regular invoices can be
+printed as **commercial invoices** by clicking on :menuselection:`Cog button (⚙️) --> Print -->
+Commercial Invoice`.
+
+.. image:: thailand/tax-invoice.png
+   :alt: Commercial invoice printing
+
+## Headquarter/Branch number settings
+
+You can inform a company's **Headquarters** and **Branch number** in the **Contacts** app. Once
+in the app, open the **contact form** of the company and under the :guilabel:`Sales & Purchase` tab:
+
+- If the contact is identified as a branch, input the **Branch number** in the
+  :guilabel:`Company ID` field.
+- If the contact is a **Headquarters**, leave the :guilabel:`Company ID` field **blank**.
+
+.. image:: thailand/contact.png
+   :alt: Company Headquarter/Branch number
+
+> **tip**:
+>    This information is used in the **tax invoice** PDF report and PND **tax report** export.
+
+# PromptPay QR code on invoices
+
+The **PromptPay QR code** is a QR code that can be added to invoices to allow customers to pay their
+bills using the PromptPay-supported bank mobile application. The QR code is generated based on the
+**invoice amount** and one of the following **merchant information**:
+
+- Ewallet ID
+- Merchant Tax ID
+- Mobile Number
+
+## Activate QR codes
+
+Go to :menuselection:`Accounting --> Configuration --> Settings`. Under the :guilabel:`Customer
+Payments` section, activate the :guilabel:`QR Codes` feature.
+
+## PromptPay QR bank account configuration
+
+Go to :menuselection:`Contacts --> Configuration --> Bank Accounts` and select the bank account for
+which you want to activate PromptPay QR. Set the :guilabel:`Proxy Type` and fill in the
+:guilabel:`Proxy Value` field depending on the chosen type.
+
+> **important**:
+>    - The account holder's city is mandatory.
+   - The :guilabel:`Include Reference` checkbox doesn't work for PromptPay QR codes.
+
+.. image:: thailand/qr-promptpay-bank.png
+   :alt: PromptPay bank account configuration
+
+.. seealso::
+   :doc:`../accounting/bank`
+
+## Bank journal configuration
+
+Go to :menuselection:`Accounting --> Configuration --> Journals`, open the bank journal, then fill
+in the :guilabel:`Account Number` and :guilabel:`Bank` under the :guilabel:`Journal Entries` tab.
+
+.. image:: thailand/qr-bank-journal.png
+   :alt: Bank Account's journal configuration
+
+## Issue invoices with PromptPay QR code
+
+When creating a new invoice, open the :guilabel:`Other Info` tab and set the :guilabel:`Payment
+QR-code` option to :guilabel:`EMV Merchant-Presented QR-code`.
+
+.. image:: thailand/qr-code-invoice-emv.png
+   :alt: Select EMV Merchant-Presented QR-code option
+
+Ensure that the :guilabel:`Recipient Bank` is the one you configured, as Odoo uses this field to
+generate the PromptPay QR code.