Issue e-invoice by integrating Viindoo with Viettel’s S-Invoice service

Nowadays, e-invoice has become a trend in digital transformation. E-invoices are integrated into enterprise management systems, accounting software, etc., helping to synchronize data, optimize usage time, and save printing, issuing, and storage costs for enterprises. For authority agencies, e-invoice plays an important role in managing trades transparently. To satisfy enterprises’ needs for managing e-invoices, Viindoo has integrated e-invoices into the Viindoo enterprise management system. Viindoo not only integrates e-invoices for VietNam enterprises but also supports e-invoice formats according to other countries’ standards with localization modules.

In this article, we will learn how to Integrate Viettel’s S-Invoice with Viindoo.

How to integrate with S-Invoice

Install the module

Enter Viindoo Apps, search for E-Invoice - Viettel S-Invoice on the search bar, and press Install.

E-Invoice - Viettel S-Invoice module

Declare the integration information

After installing the E-Invoice - Viettel S-Invoice module, to declare the E-invoice information, navigate to Accounting > Configuration > E-invoice.

The link to set up e-invoices

Follow the steps below to declare:

Step 1: E-Invoice services

Here, you will see two S-Invoice services supported by Viindoo.

Enable S-Invoice service

The declaration process for the 2 versions is similar, the only difference is the API URL provided for your enterprise by Viettel.

  • S-Invoice v1’s API URL: https://demo-sinvoice.viettel.vn:8443/;

  • S-Invoice v2’s API URL: https://api-vinvoice.viettel.vn/services/einvoiceapplication/api/.

In this article, we will declare for the S-Invoice API v2 version, you can do the same for the S-Invoice API v1.

Set up S-Invoice information

Note

  • The information you use to declare in the Viindoo system (e.g. user name, password, e-invoice’s serial, template, type, etc.), will be provided by the E-Invoice service provider.

  • The setting information in this article is only a reference for the test mode;

  • In the test mode, your enterprise’s Tax code is 0106026495-999.

Step 2: Declare the e-invoice’s Serial/Template/Type

Declare E-invoice types

On the E-invoice types view, press Create to create new e-invoice types to make them easier to use and declare.

E-invoice types
Declare e-invoice templates

On the E-invoice templates view, press Create to create new e-invoice templates that your enterprise registers with the tax authority.

E-invoice template
Declare e-invoice’s Serial

On the E-invoice Serial view, declare the exact serial that your enterprise has registered with the tax authority.

Set up S-invoice serial

Step 3: Settings on Customer Invoice Journal

Navigate to Accounting > Configuration > Journals, select the Customer Invoice journal. At the E-Invoice Integration tab, enter the needed information for issuing the e-invoice.

Setup e-invoice on a journal in Viindoo

In which:

  • E-Invoice Disabled: If checked, the invoices belonging to this journal won’t show the Issue E-Invoice feature;

  • Auto Issue: If checked, after a specific pre-set time, the confirmed customer invoices will be auto-transferred to the S-Invoice system to issue the e-invoices;

  • E-Invoice Item: This field will allow you to select the information to bring to the description field for the Product/service name on the e-invoice:

    • Invoice Line Description: The content of the Label field on the customer invoice will be sent to the e-invoice;

    • Product name: The product name on the Product field of the customer invoice will be sent to the e-invoice.

  • Disable Send E-Invoice PDF by email: When you click Send and Print on invoice view, the system automatically attached the default PDF standard invoice to the email that you send to your customer.

    • If checked: The default PDF standard invoice will always be attached to the email sent to the customer;

    • If not checked: The PDF will be updated following the downloaded and attached to the email sent to the customer.

  • E-Invoice Send Mail/Portal option: Select the invoice version to attach to the e-invoice issuing notification email sent to customers:

    • Displayed Version: The system will attach the Representation e-invoice version to the email.

    • Converted Version: The system will download and attach the Converted e-invoice version to the email.

  • E-invoice Item name new line replacement: When issuing the e-invoice, the product’s name and description will be displayed in the same line on the e-invoice. That’s why the character set here will mean “down a line” in the product description;

  • E-invoice Item name limit: The maximum Unicode characters of an item name.

  • E-invoice Serial: The serial that your enterprise registered with the tax authority declared in step 2;

  • E-Invoice Template: The number of invoice templates that your enterprise registered with the tax authority declared in step 2;

  • E-Invoice Type: This is the invoice type that your enterprise registered and declared in step 2.

Step 4: Declare, and set up the system’s General settings

Navigate to Settings > Accounting > E-Invoice Settings.

Viindoo E-Invoice settings

In which:

  • E-Invoice Service: Select the version that applied for the declared version in step 1;

  • Selectable fields:

    • Auto Issue;

    • Lock Legal Number;

    • Issue Earlier Invoice First;

    • Attach Invoice Converted Version;

    • Attach Invoice Repensentation Version.

Press Save to finish step 4.

Issue E-invoice

Navigate to Accounting > Customers > Invoices, on the invoices list, select an invoice to issue an e-invoice.

The link to Viindoo customer invoices list

For example, you are issuing an e-invoice for Thanh Cong Company, the invoice date is 24/02/2022 with a total is 11.000.000 VND.

Step 1: Confirm the draft invoice

Review the customer invoice information: Tax code, address, etc. and press Confirm.

Confirm a customer invoice in Viindoo

Step 2: Issue the e-invoice

On the Posted invoice, the E-Invoice Status is Not Issue, press Issue E-Invoice:

Issue E-Invoice for customers in Viindoo

When you see the Confirmation pop-up, press Ok to confirm.

Confirmation pop-up in Viindoo

Note

In this step, you won’t see the Sign E-invoice step. That action is still implicitly handled because the server signature is already integrated into the e-invoice account.

Step 3: Send the e-invoice to the registered Tax authority

Do this if your enterprise is applying the Invoice that has the Tax authority code that follows Circulars 78/2021/TT-BTC on 17/09/2021.

Note

This action will be done on the S-Invoice interface.

Step 4: Download E-Invoice

Press Download E-Invoice Display Version or Download E-Invoice Converted:

This action will help you save and view the invoice in Viindoo.

Download e-invoice pdf

Step 5: Reconciliation after payment

After the invoice is reconciled:

  • Customer invoice in Viindoo: In the Paid stage;

  • E-Invoice Status: Is Paid.

Update the payment state of Viindoo invoice

Step 6: Send E-Invoice to customers

Press Send & Print to send the invoice to the customer:

Right after pressing Send & Print, a pre-made invoice show up with the invoice code, and value and attaches the PDF and ZIP file. You can send the default template or edit the email and then press Send & Print to send the issue notification to the customer.

Send issue notification to the customer.

And just like that, you have finished sending the S-Invoice in Viindoo. In case the e-invoice needs to be edited or canceled, you can:

Cancel an issued e-invoice in Viindoo

In case the e-invoice is issued and you want to edit or cancel it, instead of accessing the e-invoice website, in the Viindoo system, follow the steps below:

Step 1: Cancel the issued e-invoice

On the issued e-invoice, press Cancel S-Invoice.

Cancel S-Invoice in Viindoo

When the pop-up appears, enter the following information:

  • Reference: The code/name of the canceling agreement between 2 parties;

  • Reason: Type the reason to cancel the e-invoice;

  • Cancellation Date: The date the e-invoice is canceled;

  • The minutes of invoice withdrawal (PDF): You can upload the related document.

Cancel an issued e-invoice in Viindoo

Press Confirm, the e-invoice status will be Issued but Cancelled, and the e-invoice state will be Posted.

Cancelled e-invoice status in Viindoo

To send the error notice to the tax authority, you need to access the S-Invoice system of Viettel.

Step 2: Cancel the e-invoice in the Viindoo system

You need to finish step 1 in order to continue and press Reset to Draft.

Cancel the e-invoice in Viindoo system

Now, the invoice will be changed to the Draft stage, press Cancel Entry to cancel.

Cancel invoices in Viindoo

After canceling the invoice:

  • The invoice will be changed to the Cancelled stage;

  • The E-Invoice Status will be Issued but Cancelled.

Successfully canceling the invoice.