Vietnam¶

Modules¶

The following modules are installed automatically with the Vietnamese localization:

Société¶

To use all the features of this fiscal localization, the following fields are required on the company record:

• Nom

• Address, including the City, State, Zip Code, and Country.

  • In the Street field, enter the street name, number, and any additional address information.

  • In the Street 2 field, enter the neighborhood.

• Tax ID: tax identification number.

E-invoicing with SInvoice¶

SInvoice is an e-invoice service platform provided by Viettel, one of the biggest e-invoice service providers in Vietnam. Odoo supports integration with SInvoice to submit invoices generated in Odoo.

Configuration¶

SInvoice platform¶

To send electronic invoices to SInvoice, the following must be created on SInvoice:

• SInvoice account

• Invoice template

• Invoice symbol

• Invoice issuance notice

SInvoice registration¶

To create an account, go to SInvoice and register for the desired plan. Fill in the form that opens to be contacted by SInvoice to create an account.

Once you have an account, log into SInvoice using your Username and Password.

Invoice template creation¶

1. On the left side of the overview page, in the Release management menu, click Create business information.

2. In the Update key information step, fill in the following fields and other optional information if needed: Unit name, Address, Contact person, Type of representative documents.

3. Click Update.

4. In the Look up digital certificate step, click Add new to add a digital certificate.

5. Select the Branch/Enterprise and the Type of digital certificate, then fill in the required fields for each type:

   • Supplier: CloudCA

   • Signer ID: CloudCA

   • Digital Certificate: CloudCA

   • How to download file: HSM

   • File Upload: HSM, USB-TOKEN

6. Click Generate key pair to generate encryption keys for authentication, and Save.

7. In the Manage invoice templates step, add a new Invoice template.

8. Select the Invoice type and fill in the Invoice template code, Invoice template name, and other optional information if needed.

9. Click Update.

Invoice symbol creation¶

On the left side of the main screen, in the Release management menu, click Invoice symbol and follow these steps:

1. Click Add new and select the Invoice template.

2. Set the Status to Active to activate the symbol and fill in the Invoice symbol.

3. Enable Stop automatic sending to tax authorities and Default for built-in API based on preference.

4. Cliquez sur Enregistrer.

Invoice issuance notice¶

On the left side of the main screen, in the Release management menu, click Create issuance notice and follow these steps:

1. Click Add new, select the Name of the business unit to issue an e-invoice and the Tax agency name. Based on the business unit and tax agency selected, the Tax code, Address, Phone number, and Separator used are automatically filled and uneditable.

2. Click Select the invoice type for issuance, and then select and fill in the following information :

   • Invoice type: The invoice type on which to declare an issuance notice.

   • Invoice template: Select from the list of templates available based on the invoice type.

   • Symbol: Select from the list of symbols available based on the invoice type.

   • Quantity: Total number of invoices to issue for the selected type. Based on the type and template selected, this field is filled in automatically. It can be changed if needed.

   • Start date of use: The date from which the invoice template, range, and quantity are used for the issuance notice.

3. Click Save and select more invoice types if necessary by repeating the steps above. Click Save to finish drafting the notice.

4. Click Send to tax authorities for approval. Once approved, the notice’s Status is changed to Active.

Odoo database¶

Link Odoo to SInvoice¶

To connect Odoo with SInvoice, go to Accounting ‣ Configuration ‣ Settings. In the Vietnamese Integration section, fill in your SInvoice Username and Password. Add a Default symbol to generate a prefix for the invoice number managed in SInvoice if needed.

Modèle de facture¶

To create SInvoice templates, go to Accounting ‣ Configuration ‣ Templates. Click New and add a Template code and a Template Invoice Type. The Template code is the initial sequence of digits in the name assigned by SInvoice. For example, if the invoice template is 1/001 - Hóa đơn GTGT - ND123, the Template code is 1/001. The SInvoice templates in Odoo must match the ones in SInvoice.

To add Invoice Symbols, click Add a new line.

Sending invoices to SInvoice¶

Invoices can be sent to SInvoice once they have been confirmed. To do so, follow the invoice sending steps. In the Send popup, enable Send to SInvoice and click Send & Print.

Once the invoice has been successfully submitted to SInvoice, the SInvoice Status field in the SInvoice tab of the invoice is updated to Sent. The SInvoice Number, Issue Date, Secret Code and eInvoice Number fields are also updated. The same information is available on SInvoice.

Replacement or adjustment invoices¶

A replacement invoice is issued to correct an invoice that has yet to be tax declared, whereas an adjustment invoice is issued to correct one that has already been tax declared. Follow these steps to issue a replacement or adjustment invoice:

1. Open the invoice and click Credit Note.

2. In the Credit Note popup, fill in the following fields:

   • Reason displayed on Credit Note

   • Adjustment type

   • Agreement Name

   • Agreement Date

   • Journal

   • Reversal date

3. Click Reverse and Create Invoice to issue a replacement invoice, or Reverse to issue an adjustment invoice.

The SInvoice Status in the SInvoice invoice tab is updated to Replaced for a replacement invoice or Adjusted for an adjustment invoice.

Invoice cancellation¶

If an invoice needs to be canceled, open the invoice and click Request Cancel. In the Invoice Cancellation popup, enter the cancellation Reason, Agreement Name, and Agreement Date, and click Request Cancellation.

The SInvoice Status in the SInvoice invoice tab is updated to Canceled.

QR banking codes¶

Vietnamese QR banking is a payment service platform that allows customers to make instant domestic payments to individuals and merchants in Vietnamese dong via online and mobile banking.

Configuration¶

To activate QR banking codes, go to Accounting ‣ Configuration ‣ Settings and enable QR Codes in the Customer Payments section.

Compte bancaire¶

To activate QR banking for a bank account, go to Contacts ‣ Configuration ‣ Bank Accounts and select the bank account. Fill in the Bank Identifier Code, Proxy Type (based on the information used to identify the Merchant Account, such as the card number and bank account numbers), and Proxy Value fields.

Enable Include Reference to include the invoice number in the QR code.

Generating QR codes on invoices¶

When creating a new invoice, open the Other Info tab and select EMV Merchant-Presented QR-code in the Payment QR-code field.