From a1b17b9f317d6ba2883b490a6aabaa48a76bf8d9 Mon Sep 17 00:00:00 2001
From: Donatienne Pirlot <dopi@odoo.com>
Date: Mon, 26 Dec 2022 11:13:25 +0000
Subject: [PATCH] [ADD] accounting: localization page for uk

closes odoo/documentation#3519

X-original-commit: 05503749689f2c39ec589dfb862ae2e5d47cf906
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Pirlot Donatienne (dopi) <dopi@odoo.com>
---
 .../fiscal_localizations/localizations.rst    |   1 +
 .../localizations/united_kingdom.rst          | 117 ++++++++++++++++++
 .../localizations/united_kingdom/uk.png       | Bin 0 -> 11962 bytes
 3 files changed, 118 insertions(+)
 create mode 100644 content/applications/finance/accounting/fiscal_localizations/localizations/united_kingdom.rst
 create mode 100644 content/applications/finance/accounting/fiscal_localizations/localizations/united_kingdom/uk.png

diff --git a/content/applications/finance/accounting/fiscal_localizations/localizations.rst b/content/applications/finance/accounting/fiscal_localizations/localizations.rst
index 07601d079..53b456697 100644
--- a/content/applications/finance/accounting/fiscal_localizations/localizations.rst
+++ b/content/applications/finance/accounting/fiscal_localizations/localizations.rst
@@ -26,3 +26,4 @@ Localizations
    localizations/peru
    localizations/spain
    localizations/switzerland
+   localizations/united_kingdom
diff --git a/content/applications/finance/accounting/fiscal_localizations/localizations/united_kingdom.rst b/content/applications/finance/accounting/fiscal_localizations/localizations/united_kingdom.rst
new file mode 100644
index 000000000..0f67227b3
--- /dev/null
+++ b/content/applications/finance/accounting/fiscal_localizations/localizations/united_kingdom.rst
@@ -0,0 +1,117 @@
+==============
+United Kingdom
+==============
+
+Configuration
+=============
+
+:ref:`Install <general/install>` the :guilabel:`UK - Accounting` and the :guilabel:`UK - Accounting
+Reports` modules to get all the features of the UK localization.
+
+.. list-table::
+   :header-rows: 1
+
+   * - Name
+     - Technical name
+     - Description
+   * - :guilabel:`UK - Accounting`
+     - `l10n_uk`
+     -  - CT600-ready chart of accounts
+        - VAT100-ready tax structure
+        - Infologic UK counties listing
+   * - :guilabel:`UK - Accounting Reports`
+     - `l10n_uk_reports`
+     -  - Accounting reports for the UK
+        - Allows sending the tax report via the MTD-VAT API to HMRC.
+
+.. image:: united_kingdom/uk.png
+   :align: center
+   :alt: Odoo uk packages
+
+.. note::
+   - Only UK-based companies can submit reports to HMRC.
+   - Installing the module :guilabel:`UK - Accounting Reports` installs all two modules at once.
+
+.. seealso::
+   - `HM Revenue & Customs <https://www.gov.uk/government/organisations/hm-revenue-customs/>`_
+   - `Overview of Making Tax Digital
+     <https://www.gov.uk/government/publications/making-tax-digital/overview-of-making-tax-digital/>`_
+
+Chart of accounts
+=================
+
+The UK chart of accounts is included in the :guilabel:`UK - Accounting` module. Go to
+:menuselection:`Accounting --> Configuration --> Accounting: Chart of Accounts` to access it.
+
+Setup your :abbr:`CoA (chart of accounts)` by going to :menuselection:`Accounting --> Configuration
+--> Settings --> Accounting Import section` and choose to :guilabel:`Review Manually` or
+:guilabel:`Import (recommended)` your initial balances.
+
+Taxes
+=====
+
+As part of the localization module, UK taxes are created automatically with their related financial
+accounts and configuration.
+
+Go to :menuselection:`Accounting --> Configuration --> Settings --> Taxes` to update the
+:guilabel:`Default Taxes`, the :guilabel:`Tax Return Periodicity` or to :guilabel:`Configure your
+tax accounts`.
+
+To edit existing taxes or to :guilabel:`Create` a new tax, go to :menuselection:`Accounting -->
+Configuration --> Accounting: Taxes`.
+
+.. seealso::
+   - :doc:`taxes <../../taxation/taxes>`
+   - Tutorial: `Tax report and return
+     <https://www.odoo.com/slides/slide/tax-report-and-return-1719?fullscreen=1>`_.
+
+Making Tax Digital (MTD)
+------------------------
+
+In the UK, all VAT-registered businesses have to follow the MTD rules by using software to submit
+their VAT returns.
+
+The **UK - Accounting Reports** module enables you to comply with the `HM Revenue & Customs
+<https://www.gov.uk/government/organisations/hm-revenue-customs/>`_ requirements regarding
+`Making Tax Digital
+<https://www.gov.uk/government/publications/making-tax-digital/overview-of-making-tax-digital/>`_.
+
+.. important::
+   If your periodic submission is more than three months late, it is no longer possible to submit
+   it through Odoo, as Odoo only retrieves open bonds from the last three months. Your submission
+   has to be done manually by contacting HMRC.
+
+Register your company to HMRC before the first submission
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Go to :menuselection:`Accounting --> Reporting --> Tax report` and click on
+:guilabel:`Connect to HMRC`. Enter your company information on the HMRC platform. You only need to
+do it once.
+
+.. Note::
+   When entering your VAT number, do not add the GB country code. Only the 9 digits are required.
+
+Periodic submission to HMRC
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Import your obligations HMRC, filter on the period you want to submit, and send your tax report by
+clicking :guilabel:`Send to HMRC`.
+
+Periodic submission to HMRC for multi-company
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Only one company and one user can connect to HMRC simultaneously. If several UK-based companies are
+on the same database, the user who submits the HMRC report must follow these instructions before
+each submission:
+
+#. Log into the company for which the submission has to be done.
+#. Go to :guilabel:`General Settings`, and in the :guilabel:`Users` section, click
+   :guilabel:`Manage Users`. Select the user who will submit the VAT return.
+#. Go to the :guilabel:`UK HMRC Integration` tab and click :guilabel:`Reset Authentication
+   Credentials` or :guilabel:`Remove Authentication Credentials` button. Then click again to create
+   new credentials. It is now possible to submit the tax report for this company.
+#. Repeat the steps for other companies' HMRC submissions.
+
+.. note::
+   During this process, the :guilabel:`Connect to HMRC` button no longer appears for other UK-based
+   companies.
diff --git a/content/applications/finance/accounting/fiscal_localizations/localizations/united_kingdom/uk.png b/content/applications/finance/accounting/fiscal_localizations/localizations/united_kingdom/uk.png
new file mode 100644
index 0000000000000000000000000000000000000000..1945ef917fed1b881b4626b331753fc0582af4be
GIT binary patch
literal 11962
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
XMG~3y623xhA^^xrDt#;m8T<bawaqQ#

literal 0
HcmV?d00001