[IMP] accounting/l10n_in: update india localization doc

Revise the India localization documentation to ensure it aligns with the updated
functionality in the master branch.

ref: https://github.com/odoo/odoo/pull/190265
This commit is contained in:
Earth Patel 2025-02-11 11:11:16 +05:30
parent 606b56ccda
commit cc8ee63d8e
18 changed files with 78 additions and 108 deletions

View File

@ -23,17 +23,12 @@ localization:
- `l10n_in_edi` - `l10n_in_edi`
- :ref:`Indian e-invoicing integration <india/e-invoicing>` - :ref:`Indian e-invoicing integration <india/e-invoicing>`
* - :guilabel:`Indian E-waybill` * - :guilabel:`Indian E-waybill`
- `l10n_in_edi_ewaybill` - `l10n_in_ewaybill`
- :ref:`Indian E-way bill integration <india/e-waybill>` - :ref:`Indian E-way bill integration <india/e-waybill>`
* - :guilabel:`Indian - Check GST Number Status`
- `l10n_in_gstin_status`
- :ref:`Indian Check GST Number Status <india/gstin_status>`
* - :guilabel:`Indian - GSTR India eFiling`
- `l10n_in_reports_gstr`
- :ref:`Indian GST Return filing <india/gstr>`
* - :guilabel:`Indian - Accounting Reports` * - :guilabel:`Indian - Accounting Reports`
- `l10n_in_reports` - `l10n_in_reports`
- :ref:`Indian tax reports <india/gstr_reports>` - Adds the :ref:`Indian GST Return filing <india/gstr>` and the :ref:`Indian
Tax reports <india/gstr_reports>`.
* - :guilabel:`Indian - Purchase Report(GST)` * - :guilabel:`Indian - Purchase Report(GST)`
- `l10n_in_purchase` - `l10n_in_purchase`
- Indian GST Purchase report - Indian GST Purchase report
@ -44,17 +39,48 @@ localization:
- `l10n_in_stock` - `l10n_in_stock`
- Indian GST Stock report - Indian GST Stock report
.. image:: india/india-modules.png .. _india/company:
:alt: Indian localization modules
.. _india/e-invoicing: Company
-------
To configure your company information, open the **Settings** app, scroll down to the
:guilabel:`Companies` section, click :guilabel:`Update Info`, and configure the following:
- :guilabel:`Company Name`
- :guilabel:`Address`, including the :guilabel:`Street`, :guilabel:`City`, :guilabel:`State`,
:guilabel:`ZIP`, and :guilabel:`Country`
- :guilabel:`PAN`: essential for determining the type of taxpayer.
- :guilabel:`GSTIN`: necessary for generating e-Invoices, E-waybills and filing GST returns.
.. _india/indian-configuration:
Indian Configuration Indian Configuration
==================== ====================
In :menuselection:`Settings --> Users & Companies --> Companies`, add your :guilabel:`PAN` and The **Indian Integration** section provides essential taxation and compliance features to simplify
:guilabel:`GSTIN`. The PAN is essential for determining the type of taxpayer, financial operations. To enable these features, navigate to :menuselection:`Accounting -->
while GSTIN is required for generating e-Invoices and E-waybills. Configuration --> Settings` and scroll down to the :guilabel:`Indian Integration` section.
.. image:: india/indian-integration.png
:alt: Indian Integration Section
- :guilabel:`TDS/TCS`: Activate this to enable :ref:`TDS/TCS <india/tds-tcs-threshold>`
functionality along with account-based TDS/TCS section suggestions.
- :guilabel:`Registered Under GST`: Select this if your business is registered under GST to access
GST-related features, including e-invoice, e-waybill, GST e-filing, fetch vendor e-invoiced
document and check GST number status.
- :guilabel:`E-Invoicing`: Connects with :abbr:`NIC (National Informatics Center)` to submit
:ref:`invoices <india/e-invoicing>` automatically upon posting.
- :guilabel:`E-Way bill`: Connects with :abbr:`NIC (National Informatics Center)` to submit
:ref:`e-waybill <india/e-waybill>` on posting.
- :guilabel:`GST E-Filing & Matching`: Enable the feature to facilitate :ref:`GST return filing
<india/gstr>` and connect with the GST portal to submit GSTR-1 and retrieve GSTR-2B.
- :guilabel:`Check GST Number Status`: Enable to verify :ref:`GSTIN Status <india/gstin_status>`.
- :guilabel:`Fetch Vendor E-Invoiced Document`: Helps in creating draft vendor bills using
e-invoice data submitted by vendors on GST portal.
.. _india/e-invoicing:
e-Invoice system e-Invoice system
================ ================
@ -98,44 +124,29 @@ You must register on the :abbr:`NIC (National Informatics Centre)` e-Invoice por
Configuration in Odoo Configuration in Odoo
~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~
To enable the e-Invoice service in Odoo, go to :menuselection:`Accounting --> Configuration --> To enable the e-Invoice service in Odoo, :ref:`activate <india/indian-configuration>` the
Settings --> Indian Electronic Invoicing`, and enter the :guilabel:`Username` and :guilabel:`E-Invoicing` feature and enter the :guilabel:`Username` and :guilabel:`Password`
:guilabel:`Password` previously set for the API. previously set for the API.
.. image:: india/e-invoice-setup.png
:alt: Setup e-invoice service
.. _india/e-invoicing-journals:
Journals
********
To automatically send e-Invoices to the NIC e-Invoice portal, you must first configure your *sales*
journal by going to :menuselection:`Accounting --> Configuration --> Journals`, opening your *sales*
journal, and in the :guilabel:`Advanced Settings` tab, under :guilabel:`Electronic Data
Interchange`, enable :guilabel:`E-Invoice (IN)` and save.
.. _india/e-invoicing-workflow: .. _india/e-invoicing-workflow:
Workflow Workflow
-------- --------
.. _india/invoice-validation: .. _india/generate-e-invoice:
Invoice validation Generate e-Invoice
~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~
Once an invoice is validated, a confirmation message is displayed at the top. Odoo automatically Once an invoice is confirmed, click the :guilabel:`Send` button to open the wizard. Select
uploads the JSON-signed file of validated invoices to the NIC e-Invoice portal after some time. If :guilabel:`E-Invoicing`, then click the :guilabel:`Generate` button. Odoo will upload the
you want to process the invoice immediately, click :guilabel:`Process now`. JSON-signed file of the invoice to the NIC e-Invoice portal.
.. image:: india/e-invoice-process.png .. image:: india/generate-e-invoice.png
:alt: Indian e-invoicing confirmation message :alt: Generate e-Invoice
.. note:: .. note::
- You can find the JSON-signed file in the attached files in the chatter. - You can find the JSON-signed file and check the e-Invoicing status in the chatter.
- You can check the document's :abbr:`EDI (electronic data interchange)` status under the
:guilabel:`EDI Document` tab or the :guilabel:`Electronic invoicing` field of the invoice.
.. _india/invoice-pdf-report: .. _india/invoice-pdf-report:
@ -143,9 +154,8 @@ Invoice PDF report
~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~
Once an invoice is validated and submitted, the invoice PDF report can be printed. The report Once an invoice is validated and submitted, the invoice PDF report can be printed. The report
includes the :abbr:`IRN (Invoice Reference Number)`, :guilabel:`Ack. No` (acknowledgment number) and includes the :abbr:`IRN (Invoice Reference Number)`, :guilabel:`Acknowledgement` (number and date)
:guilabel:`Ack. Date` (acknowledgment date), and QR code. These certify that the invoice is a valid and QR code. These certify that the invoice is a valid fiscal document.
fiscal document.
.. image:: india/invoice-report.png .. image:: india/invoice-report.png
:alt: IRN and QR code :alt: IRN and QR code
@ -155,24 +165,12 @@ fiscal document.
e-Invoice cancellation e-Invoice cancellation
~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~
If you want to cancel an e-Invoice, go to the :guilabel:`Other info` tab of the invoice and fill out To cancel an e-Invoice, click the :guilabel:`Request Cancel` button on the related invoice. In the
the :guilabel:`Cancel reason` and :guilabel:`Cancel remarks` fields. Then, click :guilabel:`Request :guilabel:`Cancel E-Invoice` window, fill out the :guilabel:`Cancel Reason` and :guilabel:`Cancel
EDI cancellation`. The status of the :guilabel:`Electronic invoicing` field changes to :guilabel:`To Remarks`.
Cancel`.
.. important::
Doing so cancels both the :ref:`e-Invoice <india/e-invoicing>` and the :ref:`E-Way bill
<india/e-waybill>`.
.. image:: india/e-invoice-cancellation.png
:alt: cancel reason and remarks
.. note:: .. note::
- If you want to abort the cancellation before processing the invoice, then click :guilabel:`Call - You can find the e-Invoicing status in the chatter.
Off EDI Cancellation`.
- Once you request to cancel the e-Invoice, Odoo automatically submits the JSON-signed file to
the NIC e-Invoice portal. You can click :guilabel:`Process now` if you want to process the
invoice immediately.
.. _india/e-invoice-negative-lines: .. _india/e-invoice-negative-lines:
@ -279,44 +277,24 @@ You must register on the :abbr:`NIC (National Informatics Centre)` E-Way bill po
Configuration in Odoo Configuration in Odoo
~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~
To set up the E-Way bill service, go to :menuselection:`Accounting --> Configuration --> Settings To enable the E-Way bill service in Odoo, :ref:`activate <india/indian-configuration>` the
--> Indian Electronic WayBill --> Setup E-Way bill`, and enter your :guilabel:`Username` and :guilabel:`E-Way bill` feature and enter the :guilabel:`Username` and :guilabel:`Password`.
:guilabel:`Password`.
.. image:: india/e-waybill-configuration.png
:alt: E-way bill setup odoo
.. _india/e-waybill-workflow: .. _india/e-waybill-workflow:
Workflow Workflow
-------- --------
.. _india/e-waybill-send: .. _india/generate-e-waybill:
Send an E-Way bill Generate E-Way bill
~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~
To send an E-Way bill, confirm the customer invoice/vendor bill and click :guilabel:`Send E-Way To generate an E-Way bill, confirm the customer invoice/vendor bill and click :guilabel:`Create
bill`. e-Waybill`. Enter the necessary details and click :guilabel:`Generate e-Waybill` to proceed.
.. image:: india/e-waybill-send-button.png
:alt: Send E-waybill button on invoices
.. _india/invoice-validation-e-way:
Invoice validation
~~~~~~~~~~~~~~~~~~
Once an invoice/bill has been issued and sent via :guilabel:`Send E-Way bill`, a confirmation
message is displayed.
.. image:: india/e-waybill-process.png
:alt: Indian e-Way bill confirmation message
.. note:: .. note::
- You can find the JSON-signed file in the attached files in the chatter. - You can find the JSON-signed file in the attached files in the chatter.
- Odoo automatically uploads the JSON-signed file to the government portal after some time. Click
:guilabel:`Process now` if you want to process the invoice/bill immediately.
Invoice PDF report Invoice PDF report
~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~
@ -332,30 +310,23 @@ You can print the invoice PDF report once you have submitted the E-Way bill. The
E-Way bill cancellation E-Way bill cancellation
~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~
If you want to cancel an E-Way bill, go to the :guilabel:`E-Way bill` tab of the related To cancel an E-Way bill, click :guilabel:`e-Waybill` on the related invoice/bill, then
invoice/bill and fill out the :guilabel:`Cancel reason` and :guilabel:`Cancel remarks` fields. Then, :guilabel:`Cancel e-Waybill`. In the :guilabel:` Cancel Ewaybill` window, fill out the
click :guilabel:`Request EDI Cancellation`. :guilabel:`Cancel Reason` and :guilabel:`Cancel Remarks`.
.. important::
Doing so cancels both the :ref:`e-Invoice <india/e-invoicing>` (if applicable) and the
:ref:`E-Way bill <india/e-waybill>`.
.. image:: india/e-waybill-cancellation.png .. image:: india/e-waybill-cancellation.png
:alt: Cancel reason and remarks :alt: Cancel reason and remarks
.. note:: .. note::
- If you want to abort the cancellation before processing the invoice, click :guilabel:`Call Off
EDI Cancellation`.
- Once you request to cancel the E-Way bill, Odoo automatically submits the JSON-signed file to - Once you request to cancel the E-Way bill, Odoo automatically submits the JSON-signed file to
the government portal. You can click :guilabel:`Process Now` if you want to process the invoice the government portal. You can check the JSON file in the chatter.
immediately.
.. _india/gstin_status: .. _india/gstin_status:
Indian Check GSTIN Status Indian Check GSTIN Status
========================= =========================
The :guilabel:`Indian - Check GST Number Status` module allows you to verify the status of a The :guilabel:`Indian - Check GST Number Status` allows you to verify the status of a
:abbr:`GSTIN (Goods and Services Tax Identification Number)` directly from Odoo. :abbr:`GSTIN (Goods and Services Tax Identification Number)` directly from Odoo.
To verify the status of a contact's GST number, access the customer's/vendor's form and click To verify the status of a contact's GST number, access the customer's/vendor's form and click
@ -402,12 +373,10 @@ To file GST Returns in Odoo, you must first enable API access on the GST portal.
Indian GST Service In Odoo Indian GST Service In Odoo
-------------------------- --------------------------
Once you have enabled the :ref:`API access <india/gstr_api>` on the GST portal, you can set up the Once you have enabled the :ref:`API access <india/gstr_api>` on the GST portal, :ref:`activate
:guilabel:`Indian GST Service` in Odoo. <india/indian-configuration>` the :guilabel:`GST E-Filing & Matching Feature` to start using GST
Service. Then, in the :guilabel:`Registered Under GST` section, fill in the required :guilabel:`GST
Go to :menuselection:`Accounting --> Configuration --> Settings --> Indian GST Service` and enter Username`.
the :guilabel:`GST Username`. Click :guilabel:`Send OTP`, enter the code, and finally,
:guilabel:`Validate`.
.. image:: india/gst-setup.png .. image:: india/gst-setup.png
:alt: Please enter your GST portal Username as Username :alt: Please enter your GST portal Username as Username
@ -417,9 +386,9 @@ the :guilabel:`GST Username`. Click :guilabel:`Send OTP`, enter the code, and fi
File-in GST Return File-in GST Return
------------------ ------------------
When the :guilabel:`Indian GST Service` is configured, you can file your GST return. Go to When the :guilabel:`GST E-Filing & Matching Feature` is enabled, you can file your GST return. Go
:menuselection:`Accounting --> Reporting --> India --> GST Return periods` and create a new **GST to :menuselection:`Accounting --> Reporting --> India --> GST Return periods` and create a new
Return Period** if it does not exist. GST Return file-in is done in **three steps** in Odoo: **GST Return Period** if it does not exist. GST Return file-in is done in **three steps** in Odoo:
.. note:: .. note::
**Tax Return Periodicity** can be **Tax Return Periodicity** can be
@ -608,7 +577,8 @@ Configuration
------------- -------------
#. Navigate to :menuselection:`Accounting --> Configuration --> Settings` #. Navigate to :menuselection:`Accounting --> Configuration --> Settings`
#. In the :guilabel:`Indian Integration` section, enable the :guilabel:`TDS and TCS` feature. #. In the :guilabel:`Indian Integration` section, enable the :guilabel:`TDS` or :guilabel:`TCS`
feature as required.
#. Navigate to :menuselection:`Accounting --> Configuration --> Chart of Accounts`. #. Navigate to :menuselection:`Accounting --> Configuration --> Chart of Accounts`.
#. Click :guilabel:`View` on the desired account, and set the :guilabel:`TDS/TCS Section` field. #. Click :guilabel:`View` on the desired account, and set the :guilabel:`TDS/TCS Section` field.

Binary file not shown.

Before

Width:  |  Height:  |  Size: 7.0 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 8.2 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 6.7 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

After

Width:  |  Height:  |  Size: 2.0 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 7.0 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 18 KiB

After

Width:  |  Height:  |  Size: 7.6 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 6.7 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 5.7 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.0 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 32 KiB

After

Width:  |  Height:  |  Size: 13 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 21 KiB

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 31 KiB

After

Width:  |  Height:  |  Size: 24 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

After

Width:  |  Height:  |  Size: 9.0 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 25 KiB

After

Width:  |  Height:  |  Size: 21 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

After

Width:  |  Height:  |  Size: 5.1 KiB