odoo-forge-bundle 0.1.0

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

@@ -0,0 +1,184 @@
+---
+title: "Philippines"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/fiscal_localizations/philippines.html"
+---
+
+===========
+# Philippines
+
+# Configuration
+
+:ref:`Install <general/install>` the :guilabel:`🇵🇭 Philippines` :ref:`fiscal localization package
+<fiscal_localizations/packages>` to get all the default accounting features of the Philippine
+localization, such as a chart of accounts, taxes, and reports. These provide a base template to get
+started with using Philippine accounting.
+
+> **note**:
+>   - When creating a new database and selecting the `Philippines` as a country, the fiscal
+    localization module **Philippines - Accounting** is automatically installed.
+  - If the module is installed in an existing company, the **chart of accounts** and **taxes** will
+    *not* be replaced if there are already posted journal entries.
+
+## Chart of accounts and taxes
+
+A minimum configuration default chart of accounts is installed, and the following types of taxes are
+installed and linked to the relevant account:
+
+- Sales and Purchase VAT 12%
+- Sales and Purchase VAT Exempt
+- Sales and Purchase VAT Zero-Rated
+- Sales and Purchase Withholding
+
+For the withholding taxes (:menuselection:`Accounting --> Configuration --> Taxes`), there is an
+additional :guilabel:`Philippines ATC` field under the :guilabel:`Philippines` tab.
+
+.. image:: philippines/philippines-atc-code.png
+  :alt: Philippines ATC code field set on taxes.
+
+> **note**:
+>   Taxes' ATC codes are used for the :ref:`BIR 2307 <localizations/philippines/report-BIR1207>`,
+  :ref:`SAWT and QAP reports <localizations/philippines/report-QAP-SAWT>`. If a tax is created
+  manually, its ATC code must be added.
+
+## Contacts
+
+When a company or an individual (not belonging to a company) contact is located in the Philippines,
+fill in the :guilabel:`Tax ID` field with their `Taxpayer Identification Number (TIN)`.
+
+For individuals not belonging to a company, identify them by using the following additional fields:
+
+- :guilabel:`First Name`
+- :guilabel:`Middle Name`
+- :guilabel:`Last Name`
+
+> **note**:
+>   For both :guilabel:`Company` and :guilabel:`Individual`, the TIN should follow the
+  `NNN-NNN-NNN-NNNNN` format. The branch code should follow the last digits of the TIN, or else it
+  can be left as `00000`.
+
+# Reports
+
+.. _localizations/philippines/report-BIR1207:
+
+## BIR 2307 report
+
+**BIR 2307** reports, also known as [Certificate of Creditable Tax Withheld at Source
+](https://www.bir.gov.ph/bir-forms?tab=Certificates&idTag=BIR2307&datasetCode=3381&label=2307&type=TAB%20LINK),
+can be generated for purchase orders and vendor payments with the applicable withholding taxes.
+
+To generate a BIR 2307 report, select one or multiple vendor bills from the list view, and click
+:menuselection:`Action --> Download BIR 2307 XLS`.
+
+.. image:: philippines/philippines-multi-bill.png
+  :alt: Multiple vendor bills selected with action to "Download BIR 2307 XLS".
+
+> **tip**:
+>   The same action can be performed on a vendor bill from the form view.
+
+In the pop-up that opens, review the selection and click :guilabel:`Generate`.
+
+.. image:: philippines/philippines-generate.png
+  :alt: Pop up menu to generate BIR 2307 XLS file.
+
+This generates the `Form_2307.xls` file that lists all the vendor bill lines with the applicable
+withholding tax.
+
+The process above can also be used for a *single* vendor :doc:`payment <../accounting/payments>` if
+it is linked to one or more :doc:`vendor bills <../accounting/payments>` with applied withholding
+taxes.
+
+> **note**:
+>   - If no withholding tax is applied, then the XLS file will not generate records for those vendor
+    bill lines.
+  - When grouping payments for multiple bills, Odoo splits the payments based on the contact. From
+    a payment, clicking :menuselection:`Action --> Download BIR 2307 XLS` generates a report that
+    only includes vendor bills related to that contact.
+
+> **important**:
+>   Odoo cannot generate the BIR 2307 PDF report or DAT files directly. The generated
+  :file:`Form_2307.xls` file can be exported to an *external* tool to convert it to BIR DAT or PDF
+  format.
+
+## SLSP report
+
+To access the :abbr:`SLSP (Summary List of Sales and Purchases)` report, go to
+:menuselection:`Accounting --> Reporting --> Summary List of Sales and Purchases`.
+
+Click the buttons at the top to display the desired report:
+
+- | :guilabel:`Sales` for the :abbr:`SLS (Summary List of Sales)` report.
+  | All customer invoices with the associated sales taxes applied are shown in this report.
+- | :guilabel:`Purchases` for the :abbr:`SLP (Summary List of Purchases)` report.
+  | All vendor bills with the associated purchase taxes applied are shown in this report.
+
+.. image:: philippines/slsp.png
+  :alt: SLSP Report
+
+By default, both reports exclude journal entries containing partners without a TIN number set and
+those with importation taxes set. To view or hide them, click :guilabel:`Options:` and select the
+required filter:
+
+- :guilabel:`Including Partners Without TIN`
+- :guilabel:`Including Importations`
+
+To export the :abbr:`SLSP (Summary List of Sales and Purchases)` report, click :guilabel:`Export
+SLSP`.
+
+> **important**:
+>   Odoo cannot generate the DAT files directly. The :guilabel:`Export SLSP` and :guilabel:`XLSX`
+  buttons are used to export an XLSX file, which can be processed using an *external* tool to
+  convert it to the DAT format.
+
+## 2550Q tax report
+
+The tax report report is accessible by navigating to :menuselection:`Accounting --> Reporting -->
+Statement Reports --> Tax Report --> 2550Q(PH)`. The form is based on the latest *2550Q
+(Quarterly Value-Added Tax Return)* Jan. 2023 version.
+
+.. image:: philippines/2550Q.png
+  :alt: 2550Q Tax Report
+
+> **tip**:
+>   Most lines in the tax report are automatically computed based on the taxes. For more accurate
+  reporting and filing of the tax report, manual journal entries can also be mapped to the tax
+  report through preconfigured **Tax Grids** for each tax report line.
+
+> **important**:
+>   Odoo cannot generate the 2550Q BIR formatted PDF report directly. It should be used as a
+  reference when externally filing the form manually or online.
+
+.. _localizations/philippines/report-QAP-SAWT:
+
+## QAP & SAWT reports
+
+To access the :abbr:`QAP (Quarterly Alphalist of Payees)` and :abbr:`SAWT (Summary Alphalist of
+Withholding Tax)` reports, go to :menuselection:`Accounting --> Reporting --> Tax Return`, click
+the :icon:`fa-book` :guilabel:`Report:` button, and select :guilabel:`SAWT & QAP (PH)`.
+
+Click the buttons at the top to display the desired report:
+
+- | :guilabel:`SAWT` for the :abbr:`SAWT (Summary Alphalist of Withholding Tax)` report.
+  | All customer invoices with the associated sales witholding taxes applied are shown in this
+   report.
+- | :guilabel:`QAP` for the :abbr:`QAP (Quarterly Alphalist of Payees)` report.
+  | All vendor bills with the associated purchase witholding taxes applied are shown in this report.
+
+.. image:: philippines/philippines-sawt.png
+  :alt: SAWT & QAP Report
+
+To export the :abbr:`SAWT (Summary Alphalist of Withholding Tax)` and :abbr:`QAP (Quarterly
+Alphalist of Payees)` reports in XLSX format, click :guilabel:`Export SAWT & QAP`.
+
+> **important**:
+>   Odoo cannot generate the DAT files directly. The :guilabel:`Export SAWT & QAP` and
+  :guilabel:`XLSX` buttons are used to export an XLSX file, which can be processed using an
+  *external* tool to convert it to the DAT format.
+
+# Check printing
+
+The Philippine check print layout follows the latest :abbr:`PCHC (Philippine Clearing House
+Corporation)` standardized format. To enable check printing, go to :menuselection:`Accounting -->
+Configuration --> Settings`, enable :guilabel:`Checks` and set the :guilabel:`Check Layout` to
+`Print Check - PH`.
+
+Checks are printed using the :doc:`standard workflow <../accounting/payments/pay_checks>`.

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

@@ -0,0 +1,165 @@
+---
+title: "Romania"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/fiscal_localizations/romania.html"
+---
+
+=======
+# Romania
+
+# Configuration
+
+:ref:`Install <general/install>` the following modules to get all the features of the Romanian
+localization.
+
+.. list-table::
+   :header-rows: 1
+
+   * - Name
+     - Technical name
+     - Description
+   * - :guilabel:`Romania - Accounting`
+     - `l10n_ro`
+     - Default :ref:`fiscal localization package <fiscal_localizations/packages>`.
+   * - :guilabel:`Romanian SAF-T Export`
+     - `l10n_ro_saft`
+     - Module to generate the **D.406 declaration** in the SAF-T format.
+
+.. image:: romania/romania-modules.png
+   :alt: Modules for the Romanian localization
+
+.. seealso::
+   :doc:`Documentation on e-invoicing’s legality and compliance in Romania
+   <../accounting/customer_invoices/electronic_invoicing/romania>`
+
+# D.406 declaration
+
+Starting January 1, 2023, companies registered for tax purposes in Romania must report their
+accounting data to the Romanian Tax Agency monthly or quarterly in the D.406 declaration.
+
+Odoo provides all you need to export the data of this declaration in the SAF-T XML format, which you
+can validate and sign using the software provided by the Romanian Tax Agency.
+
+> **note**:
+>    Currently, Odoo only supports the generation of the monthly/quarterly D.406 declaration
+   (containing journal entries, invoices, vendor bills, and payments). The yearly declaration
+   (including assets) and the on-demand declaration (including inventory) are not yet supported.
+
+## Configuration
+
+### Company
+
+- Under :guilabel:`Settings --> General Settings`, in the **Companies** section, click
+  :guilabel:`Update Info` and fill in the company's :guilabel:`Country`, :guilabel:`City`, and
+  :guilabel:`Telephone Number`.
+- Provide your company's :abbr:`CUI (Codul Unic de Inregistrare)` number or :abbr:`CIF (*Codul de
+  identificare fiscală*)` number (for foreign companies) in the :guilabel:`Company ID` field,
+  without the `RO` prefix (e.g., `18547290`).
+- If your company is **registered** for VAT in Romania, fill in the :guilabel:`Tax ID` field number,
+  including the `RO` prefix (e.g., `RO18547290`). If the company is **not** registered for
+  VAT in Romania, you **must not** fill in the :guilabel:`Tax ID` field.
+- Open the **Contacts** app and search for your company. Open your company's profile, and in the
+  :guilabel:`Accounting` tab, click :guilabel:`Add a line` and add your **bank account number** if
+  not informed already. Make sure the profile is set as :guilabel:`Company` above the **name**.
+
+  - You must have at least one **contact person** linked to your company in the **Contacts** app.
+    If no **contact person** is linked, create a new one by clicking :guilabel:`New`, set it
+    as :guilabel:`Individual`, and select your company in the :guilabel:`Company name` field.
+
+### Chart of accounts
+
+To generate a file receivable by the Romanian Tax Agency, the chart of accounts must not deviate
+from an official chart of accounts, such as:
+
+- the chart of accounts for commercial companies (*PlanConturiBalSocCom*), which is installed
+  by default when creating a company with the Romanian localization or;
+- the chart of accounts for companies following [IFRS ](https://www.ifrs.org/) (*PlanConturiIFRS*).
+
+Under :guilabel:`Settings --> Accounting`, in the **Romanian localization** section, set the
+:guilabel:`Tax Accounting Basis` to reflect the accounting regulations and Chart of Accounts used
+by the company.
+
+.. seealso::
+   :doc:`../accounting/get_started/chart_of_accounts`
+
+### Customer and supplier
+
+Fill in the :guilabel:`Country`, :guilabel:`City`, and :guilabel:`Zip Code` of each partner that
+appears in your invoices, vendor bills, or payments through the **Contacts** app.
+
+For partners that are companies, you must fill in the VAT number (including the country  prefix) in
+the :guilabel:`Tax ID` field. If the partner is a company based in Romania, you may instead fill in
+the CUI number (without the 'RO' prefix) in the :guilabel:`Company ID` field.
+
+### Tax
+
+You must indicate the :guilabel:`Romanian SAF-T Tax Type` (3-digit number) and :guilabel:`Romanian
+SAF-T Tax Code` (6-digit number) on each of the taxes you use. This is already done for the taxes
+that exist by default in Odoo. To do so, go to :menuselection:`Accounting --> Configuration -->
+Taxes`, select the tax you wish to modify, click the :guilabel:`Advanced Options` tab, and fill in
+the **tax type** and **tax code** fields.
+
+> **note**:
+>    The **tax type** and **tax code** are codes defined by the Romanian Tax Agency for the **D.406
+   declaration**. These can be found in the Excel spreadsheet published as guidance for completing
+   the declaration, which you can find on the [website of the Romanian Tax Agency ](https://www.anaf.ro/anaf/internet/ANAF/despre_anaf/strategii_anaf/proiecte_digitalizare/saf_t/).
+
+.. seealso::
+   :doc:`../accounting/taxes`
+
+### Product
+
+For some types of goods transactions, the :guilabel:`Intrastat Code` (Cod NC) must be configured
+on the product, as it is required by Romanian law:
+
+- import / export transactions;
+- acquisitions / supplies of food products subjected to reduced VAT rate;
+- intra-community movements subjected to intrastat reporting;
+- acquisitions / supplies subjected to local reversed VAT charge (depending on Cod NC); and
+- transactions with excisable products for which excise duties are determined based on the Cod NC.
+
+If the Intrastat Code is not specified on a non-service product, the default code '0' will be used.
+
+To configure the :guilabel:`Intrastat Codes`, go to
+:menuselection:`Accounting --> Customers --> Products`, select a product, and in the
+:guilabel:`Accounting` tab, set a :guilabel:`Commodity Code`.
+
+.. seealso::
+   :doc:`../accounting/reporting/intrastat`
+
+### Vendor bill
+
+You must check the :guilabel:`Is self-invoice (RO)?` checkbox in the :guilabel:`Other Info` tab for
+any vendor bill that is a self-invoice (i.e. a vendor bill that you issued yourself in the absence
+of an invoice document received from a supplier).
+
+## Generating the declaration
+
+### Exporting your data
+
+To export the XML for the D.406 declaration, go to :menuselection:`Accounting --> Reports -->
+General Ledger` and click on :guilabel:`SAF-T`.
+
+.. image:: romania/romania-saft-button.png
+   :align: center
+   :alt: Click on the 'SAF-T' button to export the D.406 XML declaration.
+
+You can then validate and sign the XML file using the Romanian Tax Agency's validation software,
+*DUKIntegrator*.
+
+### Signing the report
+
+Download and install the *DUKIntegrator* validation software found on the [website of the Romanian
+Tax Agency ](https://www.anaf.ro/anaf/internet/ANAF/despre_anaf/strategii_anaf/proiecte_digitalizare/saf_t/).
+
+Once you have generated the XML, open 'DUKIntegrator' and select the file you have just generated.
+
+Click on :guilabel:`Validare + creare PDF` to create an **unsigned** PDF containing your report, or
+:guilabel:`Validare + creare PDF semnat` to create a **signed** PDF containing your report.
+
+.. image:: romania/romania-dukintegrator.png
+   :align: center
+   :alt: The DUKIntegrator validation software.
+
+If the *DUKIntegrator* validator detects errors or inconsistencies in your data, it generates a file
+that explains the errors. In this case, you need to correct those inconsistencies in your data
+before you can submit the report to the Romanian Tax Agency.

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

@@ -0,0 +1,136 @@
+---
+title: "Saudi Arabia"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/fiscal_localizations/saudi_arabia.html"
+---
+
+============
+# Saudi Arabia
+
+# Configuration
+
+:ref:`Install <general/install>` the following modules to get all the features of the Saudi Arabian
+localization:
+
+.. list-table::
+   :header-rows: 1
+   :stub-columns: 1
+
+   * - Name
+     - Technical name
+     - Description
+   * - Saudi Arabia - Accounting
+     - `l10n_sa`
+     - Default :ref:`fiscal localization package <fiscal_localizations/packages>`
+   * - Saudi Arabia - E-invoicing
+     - `l10n_sa_edi`
+     - ZATCA e-invoices implementation
+   * - Saudi Arabia - Point of Sale
+     - `l10n_sa_pos`
+     - Point of Sale compliance
+
+# ZATCA e-invoices
+
+The ZATCA e-invoicing system is designed to streamline and digitize the invoicing process for
+businesses operating in Saudi Arabia.
+
+.. seealso::
+   [ZATCA e-invoicing page ](https://zatca.gov.sa/en/E-Invoicing/Pages/default.aspx)
+
+## Company information
+
+Go to :menuselection:`Settings --> General Settings --> Companies`, click :guilabel:`Update info`,
+and ensure the following company information is complete and up-to-date.
+
+- The full :guilabel:`Company Name`.
+- All relevant :guilabel:`Address` fields, including the :guilabel:`Building Number` and
+  :guilabel:`Plot Identification` (four digits each).
+- Select an enterprise :guilabel:`Identification Scheme`. It is recommended to use the
+  :guilabel:`Commercial Registration Number`.
+- Enter the :guilabel:`Identification Number` for the selected :guilabel:`Identification Scheme`.
+- The :guilabel:`VAT` number.
+- Ensure the :guilabel:`Currency` is set to :guilabel:`SAR`.
+
+> **note**:
+>    It is also necessary to fill out similar information for partner companies.
+
+## Simulation mode
+
+> **important**:
+>    It is strongly recommended to thoroughly test all invoicing workflows using the Fatoora
+   **simulation** portal first, as **any** invoice submitted to the regular Fatoora portal will be
+   accounted for, which could lead to fines and penalties.
+
+### Fatoora simulation portal
+
+Log in on the [Fatoora portal ](https://fatoora.zatca.gov.sa/) using the company's ZATCA
+credentials. Then, click the :guilabel:`Fatoora Simulation Portal` button to switch to the
+simulation portal.
+
+.. seealso::
+   [ZACTA Fatoora portal user manual version 3 (May 2023) ](https://zatca.gov.sa/en/E-Invoicing/Introduction/Guidelines/Documents/Fatoora_Portal_User_Manual_English.pdf)
+
+.. _saudi-arabia/api-mode:
+
+### ZATCA API integration
+
+On Odoo, go to :menuselection:`Accounting --> Configuration --> Settings`. Under :guilabel:`ZATCA
+API Integration`, select the :guilabel:`Simulation (Pre-Production)` :guilabel:`API mode` and click
+:guilabel:`Save`.
+
+.. _saudi-arabia/journals:
+
+### Sales journals
+
+Each sales journal on Odoo needs to be configured. To do so, go to :menuselection:`Accounting -->
+Configuration --> Journals`, open any sales journal (e.g., Customer Invoices), and go to the
+:guilabel:`ZATCA` tab. Once there, enter any :guilabel:`Serial Number` to identify the journal.
+
+> **note**:
+>    The same serial number can be used for all of the company's sales journals.
+
+Next, click :guilabel:`Onboard Journal`. In the dialog box, providing an :abbr:`OTP (one-time
+password)` code is required. To retrieve it, open the [Fatoora simulation portal
+](https://fatoora.zatca.gov.sa/), click :guilabel:`Onboard New Solution Unit/Device`, choose the
+number of OTP codes to generate (one per journal to configure), and click :guilabel:`Generate OTP
+Code`. Copy an OTP code, it into the dialog box on Odoo, and click :guilabel:`Request`.
+
+> **note**:
+>    OTP codes expire after one hour.
+
+> **tip**:
+>    If any issue occurs during onboarding, click :guilabel:`Regenerate CSR` to start again.
+
+### Testing
+
+When confirming an invoice, there is now an option to process the invoice, sending it directly the
+Fatoora simulation portal. Odoo displays the portal's response after each submission. Only rejected
+invoices can be reset to draft and edited on Odoo. Furthermore, at the end of each day, Odoo sends
+all unprocessed invoices to the portal.
+
+> **tip**:
+>    - Testing all invoicing workflows, preferably with real invoices and for a reasonable amount of
+     time, is recommended.
+   - Compare the invoices received statistics page on the Fatoora simulation portal with the list of
+     invoices on Odoo to ensure both align.
+
+### Taxes
+
+When using a **0% tax** in a customer invoice, it is necessary to specify the reason behind such a
+rate. To configure taxes, go to :menuselection:`Accounting --> Configuration --> Settings -->
+Taxes`, and open the tax to edit. Under the :guilabel:`Advanced Options`, select an
+:guilabel:`Exemption Reason Code` and click :guilabel:`Save`.
+
+When using **retention** or **withholding an amount** in a customer invoice, the tax used to retain
+the amount needs to be specified.
+
+## Production mode
+
+When ready for production, change the :ref:`API mode <saudi-arabia/api-mode>` to
+:guilabel:`Production` and click :guilabel:`Save`.
+
+> **warning**:
+>    Setting the :guilabel:`API mode` to :guilabel:`Production` is **irreversible**.
+
+The sales journals initially linked to the simulation portal now needs to be linked to the regular
+portal. To do so, :ref:`onboard the journals <saudi-arabia/journals>` again, ensuring to use the
+regular [Fatoora portal ](https://fatoora.zatca.gov.sa/) this time.

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

@@ -0,0 +1,66 @@
+---
+title: "Singapore"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/fiscal_localizations/singapore.html"
+---
+
+=========
+# Singapore
+
+# Add PayNow QR codes to invoices
+
+PayNow is a payment service platform that allows customers to make instant domestic payments to
+individuals and merchants in Singapore dollars via online and mobile banking.
+
+## Activate QR codes
+
+Go to :menuselection:`Accounting --> Configuration --> Settings`. Under the :guilabel:`Customer
+Payments` section, activate the :guilabel:`QR Codes` feature.
+
+## PayNow bank account configuration
+
+Go to :menuselection:`Contacts --> Configuration --> Bank Accounts` and select the bank account for
+which you want to activate PayNow. Set the :guilabel:`Proxy Type` and fill in the :guilabel:`Proxy
+Value` field depending on the type you chose.
+
+> **important**:
+>    - The account holder's country must be set to `Singapore` on its contact form.
+   - The account holder's city is mandatory.
+   - You could also include the invoice number in the QR code by checking the :guilabel:`Include
+     Reference` checkbox.
+
+.. image:: singapore/sg-paynow-bank-setting.png
+   :alt: PayNow bank account configuration
+
+.. seealso::
+   :doc:`../accounting/bank`
+
+## Bank journal configuration
+
+Go to :menuselection:`Accounting --> Configuration --> Journals`, open the bank journal, then fill
+out the :guilabel:`Account Number` and :guilabel:`Bank` under the :guilabel:`Journal Entries` tab.
+
+.. image:: singapore/sg-bank-account-journal-setting.png
+   :alt: Bank Account's journal configuration
+
+## Issue invoices with PayNow QR codes
+
+When creating a new invoice, open the :guilabel:`Other Info` tab and set the :guilabel:`Payment
+QR-code` option to *EMV Merchant-Presented QR-code*.
+
+.. image:: singapore/sg-qr-code-invoice-setting.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 PayNow QR code.
+
+.. _singapore/employment-hero:
+
+# Employment Hero payroll
+
+If your business is already up and running with :doc:`Employment Hero <employment_hero>`, you can
+use our connector as an alternative payroll solution.
+
+> **important**:
+>    To :ref:`configure the Employment Hero API <employment_hero/configuration>` for **Singapore**,
+   use the following value as :guilabel:`Payroll URL`: `https://apisg.yourpayroll.io/`.
+