This guide explains how to connect MISA meInvoice to HexaSync Automation Engine for one company on MISA meInvoice (in Vietnamese). HexaSync reads the company’s invoice templates (template number, invoice symbol) from meInvoice, including both published and unpublished templates. The guide applies when you connect for the first time or need to re-authorize a Connector App that is in use.
Before you start
- A Beehexa account to sign in to HexaSync Automation Engine. If you do not have one yet, sign up on the same page.
- The company’s tax code, exactly as it appears in MISA meInvoice, including the branch suffix if there is one (for example
0123456789-001). - A meInvoice sign-in account (email or phone number) and its password. This account needs permission to view invoices in meInvoice.
Note:
- If you want to try it first, use a test company on
testapp.meinvoice.vnand select the Test environment.- The Production environment is your company’s real data on app.meinvoice.vn.
- In HexaSync, the Connector App is the app that connects to MISA meInvoice. You do not need to request an AppID from MISA, because HexaSync connects with the integration AppID that MISA issued to HexaSync.
Part 1: Authorize the MISA meInvoice connection on HexaSync
Step 1: Sign in to HexaSync
- Sign in to HexaSync Automation Engine with your Beehexa account.
Step 2: Start the MISA meInvoice connection
- Open the MISA meInvoice connection setup page on HexaSync.
- On the Check connection details screen, select Connect in the MISA meInvoice row.
Step 3: Enter the meInvoice sign-in details and authorize
- Under Environment, select Production for a real company on app.meinvoice.vn, or Test for a test company on testapp.meinvoice.vn.
- Fill in Tax Code, Email or Phone Number (the email or phone number you use to sign in to meInvoice) and Password, then select Continue.
- HexaSync signs in to meInvoice to check the details and stores them encrypted. If an error is shown, see Part 4.
- Wait for the message that the authorization succeeded: MISA meInvoice has the status Connected. Select Create MISA meInvoice Connector.
Step 4: Name the MISA meInvoice Connector App
- On the Enter Connector App Name screen, HexaSync suggests a Connector App name based on the company name from meInvoice, for example [BEEHEXA CORP] MISA meInvoice Connector. If the company name cannot be retrieved, the suggested name uses the tax code. You can edit the name if needed.
- Check the text in the Description field, then select Continue.
- Creating the Connector App takes a few minutes. Stay on the page during this time.
Step 5: Finish creating the MISA meInvoice Connector App
After it is created, the system takes you to the MISA meInvoice Connector App you just created. The Connector App has one task, [MeInvoice] Invoice Templates, which gets the company’s invoice template numbers and invoice symbols. You can find the Connector App again in Connector Apps.
Next, check the connection and the data as described in Part 3.
Part 2: Re-authorize the MISA meInvoice connection
You need to re-authorize when the password of the meInvoice account has changed, when the account was locked and then unlocked, or when the Invoice Templates task reports a sign-in error.
Note: Update the connection row that is in use. Do not create a new Connector App or connection to fix an access error.
Step 1: Open Settings of the Connector App
- Open Connector Apps and select the matching MISA meInvoice Connector App. Select Settings > Integration Apps & Credentials.
Step 2: Select Re-authorize
- Find the MISA meInvoice row and select Re-authorize.
Step 3: Enter the details again
- Select the correct Environment, enter the same tax code, the account and the new password, then select Continue.
- For the same tax code, HexaSync updates the old connection and does not create a new one. Check again as described in Part 3.
Part 3: Check the connection and data
Check the connection details
Open the Connector App and go to Settings > Integration Apps & Credentials:
- MISA meInvoice: status Connected.
- HexaSync: the Connector was created successfully.
Check the data
- The [MeInvoice] Invoice Templates task pulls invoice templates for the first time as soon as the Connector App starts, then runs every hour. Check that the template numbers and invoice symbols of the current year match meInvoice.
- Each template shows whether it is published or unpublished, and whether it is still in use or has been discontinued.
Part 4: Common errors and how to fix them
| Message | How to fix it |
|---|---|
| meInvoice Rejected The Sign-In: there is no company with this tax code | Check the tax code (including a branch suffix such as -001) and the Environment, then select Fix my details and try again. |
| meInvoice Rejected The Sign-In: the account does not belong to this company | The sign-in account is not a user of the company with the tax code you entered. Check the tax code again, or ask the meInvoice administrator to add the account to that company. |
| meInvoice Rejected The Sign-In: wrong email, phone number or password | Try signing in to meInvoice directly with those details, then select Fix my details and try again to enter them again. |
| meInvoice Rejected The Sign-In: meInvoice refused the connection from HexaSync | This is not an error on your side. Send a screenshot to support@beehexa.com. |
| The name already exists | The Connector App name is already in use. Choose a different name. |
| Connector App Quota Reached | Your account has used all the Connector Apps it is allowed. Contact support@beehexa.com to raise the limit. |
| The Invoice Templates task reports a meInvoice sign-in error | When the password of the meInvoice account has changed or the account is locked, re-authorize as described in Part 2. |
For other cases, send the information listed in Part 6 to support@beehexa.com.
Part 5: Protect your information and stop the connection
Enter the meInvoice password directly on the HexaSync authorization screen. Do not put the password in group chats, regular email or error screenshots.
To stop the connection:
- Ask Beehexa to turn off the schedule and disconnect in HexaSync.
- Change the password of the meInvoice account that was used to connect.
Note: Turning off the schedule is not the same as revoking access. Stopping the connection does not automatically delete data that has already been pulled into HexaSync.
Part 6: Information to send Beehexa when you need support
- The tax code, the environment (Production or Test), the Connector App name and the connection type: MISA meInvoice.
- The step you are on, when the error happened, the error message and the Technical details section if there is one.
- Recent changes to the account or its permissions in meInvoice.
Screenshots must hide the password and sensitive data. Contact the Beehexa contact who supports your business, or support@beehexa.com.
See also: the Beehexa Privacy Policy and the Beehexa Support Policy.
Part 7: Frequently asked questions
Does HexaSync write or change data on MISA meInvoice?
No. The MISA meInvoice Connector App only reads your company’s invoice template numbers and invoice symbols, including published and unpublished templates. HexaSync does not create, edit or issue invoices on meInvoice.
How do I connect MISA meInvoice on HexaSync?
The process has five steps: sign in to HexaSync, open the setup page and select Connect, enter the tax code and meInvoice account, name the Connector App, then open the Connector App to check it.
Do I need to request an AppID from MISA?
No. HexaSync uses the integration AppID that MISA issued to HexaSync. You only need the tax code and a meInvoice sign-in account.
Can one meInvoice account be used for several companies?
Yes. If the account is a user of several companies or branches, connect each tax code separately. Each tax code is one connection.
How often is the data updated?
Invoice templates are pulled for the first time as soon as the Connector App starts, then updated every hour.