VNI Portal setup

LSP integrates with VN-Invoice software using APIs to create Vietnamese eInvoices. For successful integration, you must configure these options in the VNI portal before invoice output messages are generated in the LSP.

Note: This table is for high-level guidance only. You can refer to the official VNI documentation for the details.
Option Notes
System > Business Information This is the company information.
System > System parameter management > Technical team Use this option to configure sign server information such as log in details and sign server link address. You can also use this option to enable automatic signing of eInvoices. If automatic signing using SignServer is set to có or YES, invoices sent by LSP will be automatically created and digitally signed in VNIs. If set to Không or NO, invoices has to be manually signed in the VNI Portal under Management Invoice.

Invoices in Vietnam are only considered valid if signed.

System > System parameter management > Professional group > Invoice configuration payments Specify the ERP payment methods.
System > System parameter management > Professional group > Tax rate configuration Specify the tax rate descriptions. Only these tax rates are allowed on invoices.
Category > Money Management Specify the currency codes to be used in the invoices.
Category > Unit management Specify the unit of measure
Register to use > Manage Invoice Templates Use this option to specify different invoice templates used by the company. You can use any template, but you must register it with the Vietnam tax authority before using it in the invoice. We recommend that you use different templates for different types of invoices. You can also show your company logo and other information. Save the Ampersand and Denominator details in the Invoice Template Maintenance in Settings.
Note: The json sent to VNI does not include the template name. But it is used by the portal to format the invoice data into the preferred format.
Receipt > Manage invoice extension field Use this option to create additional invoice header or invoice line fields. Currently, LSP supports the following invoice line information in the output message:
  • PurchaseOrder
  • PurchaseOrderDate
  • ShipmentNumber
  • CustomerItem

Additional fields in the invoice must be registered with the Vietnamese tax authority before they are displayed in the printable version of the invoice.

LSP supports invoicetypes = Invoices only. For credit and debit note transactions, these will still be generated in the ERP but the user has to go to VN-Invoice portal to create a manual adjustment invoice.