[ADD] localization: philippines-l10n_ph

From PR #5179, commit f3179bd
and commit 7e92b08

Author: “ralo-odoo”

content/applications/finance/fiscal_localizations/philippines.rst

@@ -5,112 +5,116 @@ Philippines
 Introduction
 ============
 
-**l10n_ph** module adds accounting localization features for the Philippines such as Chart of Accounts, Taxes, 
-and the BIR 2307 report.
-These provide a base template to get started with using Philippine accounting.
+The **l10n_ph** module adds :doc:`accounting localization <../fiscal_localizations>` features for
+the Philippines such as a chart of accounts, taxes, and the BIR 2307 report. These provide a base
+template to get started with using Philippine accounting.
 
 Configuration
 =============
 
 Module installation
 -------------------
 
-:ref:`Install <general/install>` the following module to get all the features of the Philippine
+:ref:`Install <general/install>` the **l10n_ph** module to get all the features of the Philippine
 localization:
 
 .. image:: philippines/philippines-module.png
-   :align: center
-   :alt: Philippines fiscal localisation module
+   :alt: Philippines fiscal localisation module.
 
 .. note::
-   - When creating a new database and `Philippines` is selected as a country, the fiscal localization module :guilabel:`Philippines - Accounting` is automatically installed.
-   - If installing the module in a existing database, the Chart of Accounts and Taxes will *not* be replaced if there is changes.
-   - The BIR 2307 report will be installed but the witholding taxes may need to be manually created.
+   - When creating a new database and `Philippines` is selected as a country, the fiscal
+     localization module :guilabel:`Philippines - Accounting` is automatically installed.
+   - If installing the module in an existing company, the Chart of Accounts and Taxes will *not* be
+     replaced if there are already posted journal entries.
+   - The BIR 2307 report will be installed but the withholding taxes may need to be manually
+     created.
 
 Chart of accounts & taxes
 -------------------------
-A minimum configuration default chart of accounts is installed and following types of taxes is installed and also linked to the relevant account:
 
-- VAT 12%.
-- VAT Exempt.
-- Withholding taxes.
+A minimum configuration default chart of accounts is installed and the following types of taxes are
+installed and also linked to the relevant account:
 
-For the Witholding taxes, there is an additional field under :menuselection:`Philippines --> Philippines ATC`:
+- VAT 12%
+- VAT Exempt
+- Withholding taxes
+
+For the withholding taxes, there is an additional :guilabel:`Philippines ATC` field under the
+:guilabel:`Philippines` tab.
 
 .. image:: philippines/philippines-atc-code.png
-   :align: center
    :alt: Philippines ATC code field set on taxes.
 
-This is the ATC code for that tax when it is exported in the BIR 2307 file. 
-This will need to be filled in manually if the taxes are manually created.
+This is the ATC code for that tax when it is exported in the BIR 2307 file and will need to be
+filled in manually if the taxes are manually created.
 
 Contacts
 --------
-In the :guilabel:`Contacts`, if it is set as a :guilabel:`Company` and the :guilabel:`Country` is `Philippines`, 
-fill in the :guilabel:`Tax ID` field with the `Taxpayer Identification Number (TIN)`:
+
+If a contact record is set as a :guilabel:`Company` and the :guilabel:`Country` is `Philippines`,
+fill in the :guilabel:`Tax ID` field with the `Taxpayer Identification Number (TIN)`.
 
 .. image:: philippines/philippines-contact-company.png
-   :align: center
-   :alt: Company type contact.
+   :alt: Company type contact with Tax ID field.
 
-In the :guilabel:`Contacts`, if it is set as a :guilabel:`Individual`, the :guilabel:`Country` is `Philippines` and it does not belong to any company, fill in the :guilabel:`Tax ID` field with the `Taxpayer Identification Number (TIN)`.
-There is additional fields for:
+If a contact record is set as a :guilabel:`Individual`, the :guilabel:`Country` is `Philippines` and
+it does not belong to any company, fill in the :guilabel:`Tax ID` field with the `Taxpayer
+Identification Number (TIN)`.
+There are additional fields for:
 
 - :guilabel:`First Name`
 - :guilabel:`Middle Name`
 - :guilabel:`Last Name`
 
 .. image:: philippines/philippines-contact-individual.png
-   :align: center
-   :alt: Individual type contact.
+   :alt: Individual type contact with First, Middle, and Last Name fields.
 
 .. note::
-   For both :guilabel:`Company` and :guilabel:`Individual`, the TIN would follow the format `NNN-NNN-NNN-NNNNN`
-   The branch code would follow the last digits of the TIN number or else it can be left as `00000`.
-
-Workflows
-=========
+   For both :guilabel:`Company` and :guilabel:`Individual`, the TIN would follow the format
+   `NNN-NNN-NNN-NNNNN`. The branch code should follow the last digits of the TIN or else it can be
+   left as `00000`.
 
 BIR 2307 Report
----------------
+===============
+
 **BIR 2307** report data also known as *Certificate of Creditable Tax Withheld at Source*
 can be generated for purchase orders and vendor payments with the applicable withholding taxes.
 
-The file can be generated from :menuselection:`Vendor Bills --> Action -->Download BIR 2307 XLS`:
+The file can be generated from :menuselection:`Vendor Bills --> Action --> Download BIR 2307 XLS`.
 
 .. image:: philippines/philippines-bill.png
-   :align: center
-   :alt: Vendor Bill with witholding tax and "download BIR 2307 XLS action
+   :alt: Vendor bill with withholding tax and "download BIR 2307 XLS action.
 
-The same action can be performed on multiple Vendor Bills:
+The same action can be performed on multiple vendor bills.
 
 .. image:: philippines/philippines-multi-bill.png
-   :align: center
-   :alt: Multiple Vendor Bill selected with action to "Download BIR 2307 XLS"
+   :alt: Multiple vendor bills selected with action to "Download BIR 2307 XLS".
 
-A pop-up will appear to review the selection and then click on :guilabel:`Generate`:
+A pop-up will appear to review the selection, and then click on :guilabel:`Generate`.
 
 .. image:: philippines/philippines-generate.png
-   :align: center
-   :alt: Pop up menu to generate BIR 2307 XLS file
-   
-This will generate the `Form_2307.xls` file that lists all the vendor bill lines with the applicable withholding tax.
+   :alt: Pop up menu to generate BIR 2307 XLS file.
+
+This will generate the `Form_2307.xls` file that lists all the vendor bill lines with the applicable
+withholding tax.
 
 .. note::
-   If there is no witholding tax applied then the XLS file will not generate records for those vendor bill lines.
+   If there is no withholding tax applied then the XLS file will not generate records for those
+   vendor bill lines.
 
-The same process above can be done for a *single* vendor :doc:`payment <../accounting/payments>` as well if they were linked to 
-one or more :doc:`vendor bills <../accounting/payments/multiple>` with applied withholding taxes.
+The same process above can be done for a *single* vendor :doc:`payment <../accounting/payments>` as
+well if they were linked to one or more :doc:`vendor bills <../accounting/payments/multiple>` with
+applied withholding taxes.
 
 .. image:: philippines/philippines-payment.png
-   :align: center
    :alt: Action to Download BIR 2307 XLS from payment
-   
+
 .. note::
    When grouping payment for multiple bills, Odoo will split the payments based on the contact.
-   When :menuselection:`Payment --> Action --> Download BIR 2307 XLS` 
-   the report will only be for those vendor bills for the single contact only.
+   When :menuselection:`Payment --> Action --> Download BIR 2307 XLS` the report will only be for
+   those vendor bills for the single contact only.
 
 .. important::
    Odoo cannot generate the BIR 2307 PDF report or `DAT` files directly.
-   The generated `Form_2307.xls` file can be exported to an *external* tool to convert it to BIR `DAT` format or PDF.
+   The generated `Form_2307.xls` file can be exported to an *external* tool to convert it to BIR
+   `DAT` format or PDF.