diff --git a/content/applications/finance/fiscal_localizations/vietnam.rst b/content/applications/finance/fiscal_localizations/vietnam.rst index 76f4f24ed4..0499f23b94 100644 --- a/content/applications/finance/fiscal_localizations/vietnam.rst +++ b/content/applications/finance/fiscal_localizations/vietnam.rst @@ -2,6 +2,214 @@ Vietnam ======= +Configuration +============= + +Modules installation +-------------------- + +:ref:`Install ` the following modules to get the latest features of the Vietnam +localization: + +.. list-table:: + :header-rows: 1 + + * - Name + - Technical name + - Description + * - :guilabel:`Vientam - Accounting` + - `l10n_vn` + - The base module to manage chart of accounting and localization for Vietnam. + * - :guilabel:`Vietnam - E-invoicing` + - `l10n_vn_edi_viettel` + - This module includes the features required for integation with S-Invoice. + * - :guilabel:`Vietnam - Accounting Reports` + - `l10n_vn_reports` + - This module includes the accounting reports applicable for Vietnam fiscal localization. + +.. image:: vietnam/modules.png + :alt: Vietnam localization modules + +.. note:: +When `Vietnam` is selected for a company's :guilabel:`Fiscal Localization`, Odoo automatically +installs certain modules. + + +Configure your company +---------------------- + +To configure the company information, go to the :menuselection:`Contacts` app and search the name +given to your company. + +#. Select the :guilabel:`Company` option at the top of the page. Then, configure the following fields: + + - :guilabel:`Name` + - :guilabel:`Address`: add :guilabel:`City`, :guilabel:`State`, :guilabel:`Zip Code`, + :guilabel:`Country` + + - | In the :guilabel:`Street` field, enter the street name, number, and any additional address + information. + - In the :guilabel:`Street 2` field, enter the neighborhood. + + - :guilabel:`Tax ID`: The tax identificaiton number + + .. image:: vietnam/contact-configuration.png + :alt: Company configuration + +#. Upload a company logo and :guilabel:`Save` the contact. + + +E-invoice using S-Invoice integration +===================================== + +.. _S-Invoice: https://www.sinvoice.vn/ + +S-Invoice_ is an e-invoice service provided by Viettel, one of the biggest E-invoice service provider in Vietnam. + +.. important:: + - | :guilabel:`Vietnam - E-invoicing module` must be installed in order to submit invoices to + :guilabel:`S-Invoice`. + +Set-up +------ + +Configuration on S-invoice +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Account on **S-Invoice** portal is needed to proceed with the integration. + +#. Go to S-Invoice_ and :guilable:`Log in` on the portal + + .. note:: + To create an account, contact :guilabel:`S-Invoice` directly on the portal. + +#. Create e-invoice issuance notice and payment. + +Configuration on Odoo +~~~~~~~~~~~~~~~~~~~~~ + +To connect Odoo database with S-invoice, :guilabel:`credentials` and :guilabel:`template invoice` needs to be +set first. + +#. Go to :menuselection:`Accounting --> Configuration --> Settings`. + +#. Under :guilabel:`Vietnamese Integration`, connect Odoo database with S-invoice account using :guilabel:`user name` + and :guilabel:`password`. Set a default symbol if needed. + + .. image:: vietnam/sinvoice-configuration-accounting.png + :alt: S-Invoice Configuration Accounting + +#. Add :guilabel:`S-Invoice Templates` by going to :menuselection:`Accounting --> Configuration --> Templates`. + +#. Click :guilabel:`New` to create a new template and add :guilabel:`Template code` and :guilabel:`Template Invoice Type`. + + .. image:: vietnam/sinvoice-configuration-template.png + :alt: S-Invoice Configuration Templates + +#. Add :guilabel:`Ivnoice Symbols` by selection. New symbol is available for creation directly or under + :menuselection:`Accounting --> Configuration --> Symbol`. + + .. image:: vietnam/sinvoice-configuration-symbol.png + :alt: S-Invoice Configuration Symbol + + .. important:: + Make sure that the :guilabel:`Address` and :guilabel:`Tax ID` of the company contact and the customer's contact is + filled in properly. + +Workflow +-------- + +Create an invoice +~~~~~~~~~~~~~~~~~ + +#. Go to :menuselection:`Accounting --> Customers --> Invoice` and :guilabel:`Click New` to create a new invoice. + +#. Navigate to tab “S-invoice” to fill in Invoice Symbol in case the default Symbol was not set up in the General Settings. + + .. image:: vietnam/sinvoice-invoice-symbol.png + :alt: S-Invoice Invoice Symbol + +#. Post the invoice by clicking :guilabel:`Confirm`. + +#. Click :guilabel:`Send & Print` and choose :guilabel:`Send to S-invoice`. Then click :guilabel:`Send`. + + .. image:: vietnam/sinvoice-invoice-confirm.png + :alt: S-Invoice Invoice Confirm + +#. Upon successful completion of issuing an e-invoice, :guilabel:`SInvoice` tab of the invoice is updated including + :guilabel:`SInvoice Status`, :guilabel:`SInvoice Number` and the :guilabel:`Secret Code`. + + .. image:: vietnam/sinvoice-invoice-sent.png + :alt: S-Invoice Invoice Sent + + .. note:: + The same e-invoice issued can be checked on the :guilabel:`S-Invoice`` portal by logging in. + +Issue a replacement invoice +*************************** + +Replacement invoice refers to a reversal of the previous invoice and re-issuance of the invoice potentially from a misinput of +an information that has **not been tax declared yet**. + +#. Go to :menuselection:`Accounting --> Customers --> Invoice` and navigate and open the invoice to be replaced. + +#. Click :guilabel:`Credit Note` button + + .. image:: vietnam/sinvoice-rep-invoice.png + :alt: S-Invoice Credit Note + +#. Fill in the adjustement information indicated below and click :guilabel:`Reverse and Create Invoice`. + + .. image:: vietnam/sinvoice-rep-invoice-reverse-create.png + :alt: S-Invoice Reverse and Create + + .. note:: + The :guilabel:`status` of the original invoice replaced will be updated to :guilabel:`"Replaced"`. + +#. Upon successful completion of issuing an e-invoice, :guilabel:`SInvoice` tab of the invoice is updated + +Issue an adjustment invoice +*************************** + +Adjustment invoice refers to a reversal of the previous invoice and re-issuance of the invoice potentially from a misinput of +an information that has **already been tax declared**. + +#. Go to :menuselection:`Accounting --> Customers --> Invoice` and navigate and open the invoice to be replaced. + +#. Click :guilabel:`Credit Note` button. + + .. image:: vietnam/sinvoice-rep-invoice.png + :alt: S-Invoice Credit Note + +#. Fill in the adjustement information indicated below and click :guilabel:`Reverse`. + + .. image:: vietnam/sinvoice-rep-invoice-reverse.png + :alt: S-Invoice Reverse + + .. note:: + The :guilabel:`status` of the original invoice replaced will be updated to :guilabel:`"Adjusted"`. + +#. Upon successful completion of issuing an e-invoice, :guilabel:`SInvoice` tab of the invoice is updated. + + +Cancel an Invoice +***************** + +#. Go to :menuselection:`Accounting --> Customers --> Invoice` and navigate and open the invoice to be replaced. + +#. Click :guilabel:`Request Cancel`. + + .. image:: vietnam/sinvoice-invoice-request-cancel.png + :alt: S-Invoice Request Cancel + + +#. Fill in the adjustement information indicated below and click :guilabel:`Request Cancellation`. + + .. image:: vietnam/sinvoice-invoice-cancel.png + :alt: S-Invoice Request Cancellation + + + Add Vietnamese QR banking codes to invoices =========================================== diff --git a/content/applications/finance/fiscal_localizations/vietnam/contact-configuration.png b/content/applications/finance/fiscal_localizations/vietnam/contact-configuration.png new file mode 100644 index 0000000000..4eacddbe01 Binary files /dev/null and b/content/applications/finance/fiscal_localizations/vietnam/contact-configuration.png differ diff --git a/content/applications/finance/fiscal_localizations/vietnam/modules.png b/content/applications/finance/fiscal_localizations/vietnam/modules.png new file mode 100644 index 0000000000..f3e974c4da Binary files /dev/null and b/content/applications/finance/fiscal_localizations/vietnam/modules.png differ diff --git a/content/applications/finance/fiscal_localizations/vietnam/sinvoice-configuration-accounting.png b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-configuration-accounting.png new file mode 100644 index 0000000000..9eb25613e6 Binary files /dev/null and b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-configuration-accounting.png differ diff --git a/content/applications/finance/fiscal_localizations/vietnam/sinvoice-configuration-symbol.png b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-configuration-symbol.png new file mode 100644 index 0000000000..db7bef6db0 Binary files /dev/null and b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-configuration-symbol.png differ diff --git a/content/applications/finance/fiscal_localizations/vietnam/sinvoice-configuration-template.png b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-configuration-template.png new file mode 100644 index 0000000000..fe8210a727 Binary files /dev/null and b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-configuration-template.png differ diff --git a/content/applications/finance/fiscal_localizations/vietnam/sinvoice-invoice-cancel.png b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-invoice-cancel.png new file mode 100644 index 0000000000..966c5b0097 Binary files /dev/null and b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-invoice-cancel.png differ diff --git a/content/applications/finance/fiscal_localizations/vietnam/sinvoice-invoice-confirm.png b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-invoice-confirm.png new file mode 100644 index 0000000000..804ba006b3 Binary files /dev/null and b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-invoice-confirm.png differ diff --git a/content/applications/finance/fiscal_localizations/vietnam/sinvoice-invoice-request-cancel.png b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-invoice-request-cancel.png new file mode 100644 index 0000000000..654cfdfcf5 Binary files /dev/null and b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-invoice-request-cancel.png differ diff --git a/content/applications/finance/fiscal_localizations/vietnam/sinvoice-invoice-sent.png b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-invoice-sent.png new file mode 100644 index 0000000000..3ecef34894 Binary files /dev/null and b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-invoice-sent.png differ diff --git a/content/applications/finance/fiscal_localizations/vietnam/sinvoice-invoice-symbol.png b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-invoice-symbol.png new file mode 100644 index 0000000000..578131332b Binary files /dev/null and b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-invoice-symbol.png differ diff --git a/content/applications/finance/fiscal_localizations/vietnam/sinvoice-rep-invoice-reverse-create.png b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-rep-invoice-reverse-create.png new file mode 100644 index 0000000000..b9ef458f14 Binary files /dev/null and b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-rep-invoice-reverse-create.png differ diff --git a/content/applications/finance/fiscal_localizations/vietnam/sinvoice-rep-invoice-reverse.png b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-rep-invoice-reverse.png new file mode 100644 index 0000000000..c008f3aa01 Binary files /dev/null and b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-rep-invoice-reverse.png differ diff --git a/content/applications/finance/fiscal_localizations/vietnam/sinvoice-rep-invoice.png b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-rep-invoice.png new file mode 100644 index 0000000000..e0030ae58c Binary files /dev/null and b/content/applications/finance/fiscal_localizations/vietnam/sinvoice-rep-invoice.png differ diff --git a/content/applications/finance/fiscal_localizations/vietnam/vn-bank-account-journal-setting.png b/content/applications/finance/fiscal_localizations/vietnam/vn-bank-account-journal-setting.png index 8906294679..2704efc734 100644 Binary files a/content/applications/finance/fiscal_localizations/vietnam/vn-bank-account-journal-setting.png and b/content/applications/finance/fiscal_localizations/vietnam/vn-bank-account-journal-setting.png differ diff --git a/content/applications/finance/fiscal_localizations/vietnam/vn-paynow-bank-setting.png b/content/applications/finance/fiscal_localizations/vietnam/vn-paynow-bank-setting.png index f5007e21a5..f7b39464ba 100644 Binary files a/content/applications/finance/fiscal_localizations/vietnam/vn-paynow-bank-setting.png and b/content/applications/finance/fiscal_localizations/vietnam/vn-paynow-bank-setting.png differ diff --git a/content/applications/finance/fiscal_localizations/vietnam/vn-qr-code-invoice-setting.png b/content/applications/finance/fiscal_localizations/vietnam/vn-qr-code-invoice-setting.png index 6df1d58385..3da675e093 100644 Binary files a/content/applications/finance/fiscal_localizations/vietnam/vn-qr-code-invoice-setting.png and b/content/applications/finance/fiscal_localizations/vietnam/vn-qr-code-invoice-setting.png differ