This guide explains how to connect a Nhanh.vn store to HexaSync so HexaSync can access the store data that the Nhanh.vn Metrics App needs. This data is used to assess the quality of product and inventory data, and to check the data before you connect to another system.
Before you start
- A Beehexa account. If you do not have one yet, sign up on the same page.
- A Nhanh.vn (in Vietnamese) account with the Store owner/Director role for the store you want to connect.
- Permission to install apps for the Nhanh.vn store. The store owner always has this permission; staff need to be given permission to install apps.
Part 1: Authorize the Nhanh.vn connection on HexaSync
Step 1: Sign in to HexaSync
Go to HexaSync Automation Engine and sign in with your Beehexa account.
Step 2: Start the Nhanh.vn connection
- Open the Nhanh.vn authorization page on HexaSync.
- On the Check connection details screen, select Connect.
Step 3: Confirm the HexaSync app
HexaSync shows the screen for using HexaSync’s built-in app, with [Nhanh.vn] HexaSync App selected. Select Continue.
Step 4: Authorize the app in Nhanh.vn
- HexaSync takes you to the Nhanh.vn page. If asked, sign in with the business administrator account and select the correct business to connect. Agreeing on a different business connects that business by mistake.
- Nhanh.vn shows the details of the app that is requesting access to the business. Read them again, then select Đồng ý (Agree).
- When the authorization succeeds, the screen shows The system is connected. Nothing left to authorize. and Nhanh.vn has the status Connected.
Note: If, after you select Đồng ý, the screen reports that the account has not been given Open API permission, see Nhanh.vn’s guide to signing in and authorizing (in Vietnamese), then go to Cài đặt Open API (Open API settings):
- Turn on the option that allows Open API connections and allow the Director account to authorize.
- Go back to HexaSync, continue the authorization process and select Đồng ý.
Step 5: Create the Nhanh.vn Connector App
- After the authorization succeeds, select Create Nhanh.vn Connector.
- When it is done, HexaSync shows the Connection successful screen.
- Open HexaSync Connector Apps to check the Connector App you just created.
After the Connector App is created, HexaSync gets data from the connected Nhanh.vn store within 30 minutes and notifies the administrator.
Part 2: Re-authorize the Nhanh.vn connection
If you already have a Connector App and need to re-authorize, follow these steps in order.
Step 1: Open Settings of the Connector App
Open the matching Connector App in Connector Apps and select Settings.
Step 2: Select Re-authorize
In Settings, find the Nhanh.vn credential and select Re-authorize. Only the owner of the credential can re-authorize.
Step 3: Confirm the app
Confirm that this is the Nhanh.vn Connector App you want to re-authorize.
Step 4: Authorize in Nhanh.vn
Sign in with the business administrator account, select the correct business, then select Đồng ý. Follow the instructions on the screen for the remaining steps, in the same way as the first authorization.
Part 3: Verify the connection
The connection is successful when HexaSync takes you back to the Connector App without an error message. Confirm it in two places.
Step 1: Check that the Credential appears
Open the Connector App and go to Settings. The Nhanh.vn Connection row shows a credential with a name like [Nhanh.vn] Business 12345 Credential, in place of the Authorize button.
Step 2: Test-run a Puller in the Connector App
A Puller is the part that actually calls Nhanh.vn, so test-running a Puller is the most accurate check. For example, pull the product list:
- Select Tasks in the left sidebar, then select the task
[Nhanh.vn] Products. - Open Other Actions and select Pull.
- Wait for the run to finish, then open the result. The result must have no authorization error and must contain product records from your business.
If the task reports an authorization error or an access error, the credential is not working yet. Re-authorize before you turn on the schedule.
Part 4: When an error occurs
Every error screen shows a status code (Status) and the error text. Write down both before you try again, because the support team will need this information.
| Message on screen | Cause |
|---|---|
| Another Nhanh.vn Authorization Is In Progress | Another authorization that uses the same app is waiting for a response from Nhanh.vn, possibly in another tab or another Connector App. Each app can have only one pending authorization at a time. |
| HexaSync Could Not Build Your Nhanh.vn Authorization Link | HexaSync could not create the authorization link with the selected app. |
| HexaSync Could Not Verify The Stored Credential | The credential was stored, but the follow-up check did not find usable access. |
What to check first
- Do it in one go. The Nhanh.vn authorization code can be used only once and expires after 10 minutes.
- One authorization at a time. Do not open two tabs that authorize the same Nhanh.vn app.
- The correct business. Check that you are selecting the correct business on Nhanh.vn.
- The correct Connection. If the Connector App has several Nhanh.vn Connections, check that you selected Authorize on the correct Connection.
- One-year validity. If a task suddenly reports an authorization error after about one year, the access has most likely expired. Re-authorize.
Frequently asked questions
Which data does HexaSync get from Nhanh.vn?
The Nhanh.vn Connector App only gets product and inventory data, within the API limits the store owner allows when authorizing.
Does HexaSync write or change data on Nhanh.vn?
No. After you authorize as described in this guide, HexaSync does not write or change data on Nhanh.vn automatically.
Who can authorize the Nhanh.vn connection with HexaSync?
The store owner or director always has permission to install apps. Staff need to be given permission to install apps for the Nhanh.vn store first.
Does the Nhanh.vn authorization expire?
Yes. The access is valid for about one year. If tasks suddenly report an authorization error after that time, re-authorize in Settings of the Connector App.