diff --git a/content/applications/finance/accounting/fiscal_localizations/localizations.rst b/content/applications/finance/accounting/fiscal_localizations/localizations.rst index 27f8f0c4c..07601d079 100644 --- a/content/applications/finance/accounting/fiscal_localizations/localizations.rst +++ b/content/applications/finance/accounting/fiscal_localizations/localizations.rst @@ -19,6 +19,7 @@ Localizations localizations/indonesia localizations/italy localizations/italy_IT + localizations/kenya localizations/luxembourg localizations/mexico localizations/netherlands diff --git a/content/applications/finance/accounting/fiscal_localizations/localizations/kenya.rst b/content/applications/finance/accounting/fiscal_localizations/localizations/kenya.rst new file mode 100644 index 000000000..b74e600e9 --- /dev/null +++ b/content/applications/finance/accounting/fiscal_localizations/localizations/kenya.rst @@ -0,0 +1,120 @@ +===== +Kenya +===== + +.. _localization/kenya/configuration: + +Configuration +============= + +:ref:`Install ` the following modules to get all the features of the Kenyan +localization: + +.. list-table:: + :header-rows: 1 + + * - Name + - Technical name + - Description + * - :guilabel:`Kenyan - Accounting` + - `l10n_ke` + - Installing this module grants you access to the list of accounts used in the local GAAP and + the list of common taxes (VAT, etc.). + * - :guilabel:`Kenyan - Accounting Reports` + - `l10n_ke_reports` + - Installing this module grants you access to improved accounting reports for Kenya, such as + Profit and Loss and Balance Sheets. + +You also have to install the **Kenya Tremol Device EDI Integration** package to be able to report +your taxes to the **Kenya Revenue Authority (KRA)** using the Tremol G03 Control Unit: + +.. list-table:: + :header-rows: 1 + + * - Name + - Technical name + - Description + * - :guilabel:`Kenya Tremol Device EDI Integration` + - `l10n_ke_edi_tremol` + - Installing this module integrates with the Kenyan G03 Tremol control unit device to report + taxes to KRA through TIMS. + +.. image:: kenya/modules.png + :align: center + :alt: The three modules for the Kenya Fiscal Localization Package on Odoo + +Kenyan TIMS integration +======================= + +The Kenya Revenue Authority (KRA) has decided to go digital for tax collection through the **Tax +Invoice Management System (TIMS)**. As of December 1st, 2022, all VAT-registered persons should +comply with TIMS. The goal is to reduce VAT fraud, increase tax revenue, and increase VAT compliance +through standardization, validation, and transmission of invoices to KRA on a real-time or near +real-time basis. + +All VAT-registered taxpayers should use a **compliant tax register**. Odoo decided to develop the +integration of the **Tremol G03 Control Unit (type C)**, which can be run locally through USB. This +device validates invoices to ensure financial documents meet the new regulations and send the +validated tax invoices directly to KRA. Installing a proxy server that provides a gateway between +users and the internet is required. + +Installing the proxy server on a Windows device +----------------------------------------------- + +Go to `odoo.com/download `_, fill out the required information +and click :guilabel:`Download`. + +.. image:: kenya/download.png + :align: center + :alt: Install the Proxy Server on a Windows device + +Once it is loaded on your computer, a wizard opens. You have to read and agree with the terms of the +agreement. On the next page, select the :guilabel:`type of install: Odoo IoT`. Then, click +:guilabel:`Next` and :guilabel:`Install`. Once completed, click :guilabel:`Next`. Check the +:guilabel:`Start Odoo` box to be redirected to Odoo automatically, and then click :guilabel:`Finish`. + +A new page opens, confirming your :doc:`IoT Box <../../../../productivity/iot/config/connect>` is up +and running. Connect your physical device **Tremol G03 Control Unit (type C)** to your laptop via +USB. In the :guilabel:`IoT Device` section, check that your Tremol G03 Control Unit (type C) +appears, confirming the connection between the device and your computer. + +.. image:: kenya/iot-box.png + :align: center + :alt: Your IoT box is up and running + +.. note:: + If the device is not detected, try to plug it in again or click on the :guilabel:`Restart` button + in the top right corner. + +.. seealso:: + :doc:`Connect an IoT box to your database <../../../../productivity/iot/config/connect>` + +Sending the data to KRA using the Tremol G03 Control Unit +--------------------------------------------------------- + +As a pre-requisite, check out that the :ref:`Kenyan Accounting modules +` are installed on your database. Then, go to +:menuselection:`Accounting --> Configuration --> Settings --> Kenya TIMS Integration section`, and +check that the :guilabel:`control Unit Proxy Address` matches the address of the IoT box. + +To send data to KRA, create a new invoice by going to :menuselection:`Accounting Dashboard --> +Customer Invoice card` and clicking :guilabel:`New Invoice`. Upon confirmation of a new invoice, the +:guilabel:`Send invoice to Fiscal Device` button appears. Clicking on it sends the invoice details +to the device and from the device to the government. The :guilabel:`CU Invoice Number` field is now +completed in your invoice, confirming the information has been sent. + +The :guilabel:`Tremol G03 Fiscal Device` tab contains fields that are automatically completed once +the invoice is sent to the government: + +- :guilabel:`CU QR Code`: Url from the KRA portal which reflects a QR code. +- :guilabel:`CU Serial Number`: reflects the serial number of the device. +- :guilabel:`CU Signing Date and Time`: The date and time when the invoice has been sent to KRA. + +If you click on :guilabel:`Send and Print`, a .pdf of the invoice is generated. The +:guilabel:`Kenyan Fiscal Device Info` is mentioned on the document. + +.. note:: + To verify KRA has received the invoice information, take the :guilabel:`CU Invoice Number` and + and enter it in the :guilabel:`Invoice Number Checker` section on + `Kenya Revenue Authority website `_. Click + :guilabel:`Validate` and find the invoice details. diff --git a/content/applications/finance/accounting/fiscal_localizations/localizations/kenya/download.png b/content/applications/finance/accounting/fiscal_localizations/localizations/kenya/download.png new file mode 100644 index 000000000..8e9c17f95 Binary files /dev/null and b/content/applications/finance/accounting/fiscal_localizations/localizations/kenya/download.png differ diff --git a/content/applications/finance/accounting/fiscal_localizations/localizations/kenya/iot-box.png b/content/applications/finance/accounting/fiscal_localizations/localizations/kenya/iot-box.png new file mode 100644 index 000000000..768f7926f Binary files /dev/null and b/content/applications/finance/accounting/fiscal_localizations/localizations/kenya/iot-box.png differ diff --git a/content/applications/finance/accounting/fiscal_localizations/localizations/kenya/modules.png b/content/applications/finance/accounting/fiscal_localizations/localizations/kenya/modules.png new file mode 100644 index 000000000..e744df2de Binary files /dev/null and b/content/applications/finance/accounting/fiscal_localizations/localizations/kenya/modules.png differ