[IMP] localizations: clarify, simplify and update the content

closes odoo/documentation#11423

X-original-commit: b58c84f8aa
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>

content/applications/finance/fiscal_localizations.rst

@@ -4,128 +4,163 @@
 Fiscal localizations
 ====================
 
+Fiscal localizations are country-specific modules that allow you to be compliant with a country's
+fiscal requirements. Most of these modules are related to the :ref:`Accounting
+<fiscal_localizations/accounting>` or :ref:`Payroll <fiscal_localizations/payroll>` app, but they
+can also be necessary for other apps such as Point of Sale, eCommerce, etc., depending on a
+country's fiscal requirements.
+
 .. _fiscal_localizations/packages:
 
-Fiscal localization packages
-============================
+Configuration
+=============
 
-**Fiscal Localization Packages** are country-specific modules that install pre-configured taxes,
-fiscal positions, chart of accounts, and legal statements on your database. Some additional
-features, such as the configuration of specific certificates, are also added to your Accounting app,
-following your fiscal administration requirements.
+Odoo should automatically install the required fiscal localization modules based on the company's
+country when the related app is installed. Refer to the :ref:`list of countries
+<fiscal_localizations/countries-list>` to view the currently supported countries and access their
+specific documentation.
 
 .. note::
-   Odoo continuously adds new localizations and improves the existing packages.
+   Each company in a multi-company environment can use different fiscal localization modules.
 
-Configuration
--------------
+.. _fiscal_localizations/accounting:
 
-Odoo automatically installs the appropriate package for your company, according to the country
-selected at the creation of the database.
+Accounting
+----------
 
-.. important::
-   As long as you haven't posted any entry, you can still select another package.
+Verify the right package of modules is installed by going to :menuselection:`Accounting -->
+Configuration --> Settings` and checking the :guilabel:`Package` field under the :guilabel:`Fiscal
+Localization` section. Select another one if necessary.
 
-To select a fiscal localization package for your company, go to :menuselection:`Accounting -->
-Configuration --> Settings --> Fiscal Localization`, select the appropriate package from the list
-and save.
+.. warning::
+   Selecting another package is only possible if no entry has been posted.
 
-.. image:: fiscal_localizations/package-selection.png
-   :alt: Select your country's fiscal localization package in Odoo Accounting.
+These packages require fine-tuning the chart of accounts, activating the taxes to be used,
+configuring the country-specific statements and certifications, and sometimes more.
 
-Use
----
+.. _fiscal_localizations/payroll:
 
-These packages require you to fine-tune your chart of accounts according to your needs, activate the
-taxes you use, and configure your country-specific statements and certifications.
+Payroll
+-------
 
-.. seealso::
-   - :doc:`accounting/get_started/chart_of_accounts`
-   - :doc:`accounting/taxes`
+Localization settings can be accessed by going to :menuselection:`Payroll --> Configuration -->
+Settings` and searching for the country's **Localization** section.
 
 .. _fiscal_localizations/countries-list:
 
-List of supported countries
-===========================
+List of countries
+=================
 
-Odoo Accounting can be used in many countries out of the box by installing the appropriate module.
-Here is a list of all :ref:`fiscal localization package <fiscal_localizations/packages>` that are
-available on Odoo.
+Fiscal localization modules are available for the countries listed below.
 
-- Algeria - Accounting
-- :doc:`Argentina - Accounting <fiscal_localizations/argentina>`
-- :doc:`Australian - Accounting <fiscal_localizations/australia>`
-- :doc:`Austria - Accounting <fiscal_localizations/austria>`
-- :doc:`Belgium - Accounting <fiscal_localizations/belgium>`
-- Bolivia - Accounting
-- :doc:`Brazilian - Accounting <fiscal_localizations/brazil>`
-- :doc:`Canada - Accounting <fiscal_localizations/canada>`
-- :doc:`Chile - Accounting <fiscal_localizations/chile>`
-- China - Accounting
-- :doc:`Colombia - Accounting <fiscal_localizations/colombia>`
-- Costa Rica - Accounting
-- Croatia - Accounting (RRIF 2012)
-- Czech - Accounting
-- Denmark - Accounting
-- Dominican Republic - Accounting
-- :doc:`Ecuadorian - Accounting <fiscal_localizations/ecuador>`
-- :doc:`Egypt - Accounting <fiscal_localizations/egypt>`
-- Ethiopia - Accounting
-- Finnish Localization
-- :doc:`France - Accounting <fiscal_localizations/france>`
-- Generic - Accounting
+.. note::
+   New countries are frequently added to this list and Odoo keeps expanding and improving existing
+   localizations and the related documentation.
+
+- Algeria
+- :doc:`Argentina <fiscal_localizations/argentina>`
+- :doc:`Australia <fiscal_localizations/australia>`
+- :doc:`Austria <fiscal_localizations/austria>`
+- Bangladesh
+- :doc:`Belgium <fiscal_localizations/belgium>`
+- Benin
+- Bolivia
+- :doc:`Brazil <fiscal_localizations/brazil>`
+- Burkina Faso
+- Bulgaria
+- Cameroon
+- :doc:`Canada <fiscal_localizations/canada>`
+- Central African Republic
+- Chad
+- :doc:`Chile <fiscal_localizations/chile>`
+- China
+- :doc:`Colombia <fiscal_localizations/colombia>`
+- Comoros
+- Congo
+- Costa Rica
+- Croatia
+- Cyprus
+- Czech Republic
+- Democratic Republic of the Congo
+- Denmark
+- Dominican Republic
+- :doc:`Ecuador <fiscal_localizations/ecuador>`
+- :doc:`Egypt <fiscal_localizations/egypt>`
+- Equatorial Guinea
+- Estonia
+- Ethiopia
+- Finland
+- :doc:`France <fiscal_localizations/france>`
+- Gabon
 - :doc:`Germany <fiscal_localizations/germany>`
+- Guinea
+- Greece
+- Guatemala
+- Guinea-Bissau
+- Honduras
+- :doc:`Hong Kong <fiscal_localizations/hong_kong>`
+- Hungary
+- :doc:`India <fiscal_localizations/india>`
+- :doc:`Indonesia <fiscal_localizations/indonesia>`
+- :doc:`Italy <fiscal_localizations/italy>`
+- Ivory Coast
+- Japan
+- Jordan
+- Kazakhstan
+- :doc:`Kenya <fiscal_localizations/kenya>`
+- Kuwait
+- Latvia
+- Lithuania
+- :doc:`Luxembourg <fiscal_localizations/luxembourg>`
+- Mali
+- Malta
+- Mauritius
+- :doc:`Malaysia <fiscal_localizations/malaysia>`
+- :doc:`Mexico <fiscal_localizations/mexico>`
+- Mongolia
+- Morocco
+- Mozambique
+- :doc:`Netherlands <fiscal_localizations/netherlands>`
+- :doc:`New Zealand <fiscal_localizations/new_zealand>`
+- Niger
+- Nigeria
+- Norway
+- Pakistan
+- Panama
+- :doc:`Peru <fiscal_localizations/peru>`
+- :doc:`Philippines <fiscal_localizations/philippines>`
+- Poland
+- Portugal
+- Qatar
+- :doc:`Romania <fiscal_localizations/romania>`
+- Rwanda
+- :doc:`Saudi Arabia <fiscal_localizations/saudi_arabia>`
+- Senegal
+- Serbia
+- :doc:`Singapore <fiscal_localizations/singapore>`
+- Slovakia
+- Slovenia
+- South Africa
+- :doc:`Spain <fiscal_localizations/spain>`
+- Sweden
+- :doc:`Switzerland <fiscal_localizations/switzerland>`
+- Taiwan
+- Tanzania
+- :doc:`Thailand <fiscal_localizations/thailand>`
+- Tunisia
+- Türkiye
+- Uganda
+- Ukraine
+- :doc:`United Arab Emirates <fiscal_localizations/united_arab_emirates>`
+- :doc:`United Kingdom <fiscal_localizations/united_kingdom>`
+- :doc:`United States of America <fiscal_localizations/united_states>`
+- :doc:`Uruguay <fiscal_localizations/uruguay>`
+- Venezuela
+- :doc:`Vietnam <fiscal_localizations/vietnam>`
+- Zambia
 
-  - Germany SKR03 - Accounting
-  - Germany SKR04 - Accounting
-
-- Greece - Accounting
-- Guatemala - Accounting
-- Honduras - Accounting
-- :doc:`Hong Kong - Accounting <fiscal_localizations/hong_kong>`
-- Hungarian - Accounting
-- :doc:`Indian - Accounting <fiscal_localizations/india>`
-- :doc:`Indonesian - Accounting <fiscal_localizations/indonesia>`
-- Ireland - Accounting
-- Israel - Accounting
-- :doc:`Italy - Accounting <fiscal_localizations/italy>`
-- Japan - Accounting
-- :doc:`Kenya - Accounting <fiscal_localizations/kenya>`
-- Lithuania - Accounting
-- :doc:`Luxembourg - Accounting <fiscal_localizations/luxembourg>`
-- :doc:`Malaysia - Accounting <fiscal_localizations/malaysia>`
-- Maroc - Accounting
-- :doc:`Mexico - Accounting <fiscal_localizations/mexico>`
-- Mongolia - Accounting
-- :doc:`Netherlands - Accounting <fiscal_localizations/netherlands>`
-- :doc:`New Zealand - Accounting <fiscal_localizations/new_zealand>`
-- Norway - Accounting
-- OHADA - Accounting
-- Pakistan - Accounting
-- Panama - Accounting
-- :doc:`Peru - Accounting <fiscal_localizations/peru>`
-- :doc:`Philippines - Accounting <fiscal_localizations/philippines>`
-- Poland - Accounting
-- Portugal - Accounting
-- :doc:`Romania - Accounting <fiscal_localizations/romania>`
-- :doc:`Saudi Arabia - Accounting <fiscal_localizations/saudi_arabia>`
-- :doc:`Singapore - Accounting <fiscal_localizations/singapore>`
-- Slovak - Accounting
-- Slovenian - Accounting
-- South Africa - Accounting
-- :doc:`Spain - Accounting (PGCE 2008) <fiscal_localizations/spain>`
-- Sweden - Accounting
-- :doc:`Switzerland - Accounting <fiscal_localizations/switzerland>`
-- Taiwan - Accounting
-- :doc:`Thailand - Accounting <fiscal_localizations/thailand>`
-- Turkey - Accounting
-- :doc:`United Arab Emirates - Accounting <fiscal_localizations/united_arab_emirates>`
-- :doc:`UK - Accounting <fiscal_localizations/united_kingdom>`
-- Ukraine - Accounting
-- :doc:`United States - Accounting <fiscal_localizations/united_states>`
-- :doc:`Uruguay - Accounting <fiscal_localizations/uruguay>`
-- Venezuela - Accounting
-- :doc:`Vietnam - Accounting <fiscal_localizations/vietnam>`
+.. seealso::
+   :doc:`Employment Hero Payroll documentation <fiscal_localizations/employment_hero>`
 
 .. toctree::
    :titlesonly:

content/applications/hr/payroll.rst

@@ -29,6 +29,8 @@ The accounting section of the configuration menu relates to three options:
   created from all the accounting entries from the same period. This disables the generation of
   single payments.
 
+.. _payroll-localizations:
+
 Localizations
 -------------