Get started with Haravan on HexaSync

This guide explains how to connect a Haravan store to HexaSync so that HexaSync can access the store’s product and inventory data. This data is used to assess product data quality and to check the data before you connect another system.

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.
• A Haravan account with permission to install apps for the store you want to connect, usually the store owner or an admin account.
• Decide which Haravan store to connect. Each authorization connects one store only.

Part 1: Authorize the Haravan 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 Haravan connection

1. Open the Haravan connection setup page on HexaSync.
2. On the Check connection details screen, find Haravan and select Connect.

Step 3: Confirm the HexaSync app

1. On the Choose an app to connect to Haravan screen, HexaSync’s Haravan app is already selected. Keep this selection.
2. Select Continue. HexaSync provides the app details and handles the authorization with Haravan.

Step 4: Continue to Haravan

• On the You’re about to authorize HexaSync on Haravan screen, select Continue to Haravan to go to the Haravan sign-in page.

Step 5: Authorize the app in Haravan

1. Sign in with a Haravan account that has permission to install apps.
2. If the account manages several stores, select the store you want to connect.
3. Review the permissions HexaSync requests and confirm the authorization. Haravan sends you back to HexaSync.

Note:

• Each authorization connects one store only.
• Finish this step right away, in the same browser and tab where you started the connection. The authorization code that Haravan sends back can be used only once and is valid for a short time.

Step 6: Finish the HexaSync Connector

1. When you return to HexaSync, the system exchanges the Haravan authorization code for an access token and stores the encrypted credential. The Waiting For Credential Access screen may appear for a few seconds. This is normal; stay on the page and do not reload it.
2. After the authorization succeeds, HexaSync shows Authorization Complete and continues creating the Connector App.
3. When HexaSync shows Connection successful, the Connector App has been created.

HexaSync starts retrieving data from the connected store within 30 minutes after the Connector App is created. Verify the connection by following Part 3.

Part 2: Re-authorize the Haravan connection on HexaSync

If you already have a Connector and need to re-authorize the Haravan connection on HexaSync, follow these steps in order.

Step 1: Open Settings in the Haravan Connector

• Open Connector Apps and select the Haravan Connector for your store. Select Settings in the left menu.

Step 2: Select Re-authorize

• In Settings, find the Haravan credential and select Re-authorize.

Cannot use Re-authorize? Only the owner (the creator) of the Haravan credential can re-authorize. Contact the owner of the credential.

Step 3: Confirm the HexaSync app

• HexaSync shows the Choose an app to connect to Haravan screen with HexaSync’s Haravan app already selected. Select Continue.

Step 4: Authorize the app in Haravan

1. On the You’re about to authorize HexaSync on Haravan screen, select Continue to Haravan.
2. Sign in to Haravan and select the store that is linked to this Connector.
3. Confirm that you authorize HexaSync.

After Haravan sends you back, HexaSync links the new credential to the Connector and opens the Connector’s monitoring page (Connector Monitoring).

Part 3: Verify the connection

The connection is successful when HexaSync takes you back to the Connector App or the Connector settings page without an error message. If you connect before you have a Connector App, that is when HexaSync shows the Connection successful screen. Confirm it again in two places in HexaSync.

Check the credential

1. Open Connector Apps and select the Haravan Connector App you just created.
2. Go to Settings. The Haravan connection row shows a credential named like [Haravan] <Store Domain> Credential instead of the Authorize button.

Check the data

Run one Haravan data retrieval task manually. This is the part that actually calls Haravan, so it is the most accurate test: the task must finish without an authorization error.

1. Select Tasks in the left sidebar, then select a Haravan data retrieval task, for example the products task.
2. Open the Other Actions list and select Pull to retrieve data manually.
3. Wait for the run to finish, then open the result. The result has no authorization error and contains records retrieved from your store.
4. Compare the product and inventory data of a few SKUs with Haravan.

Note: If the task reports an authorization error or an access error, the credential is not working yet. Re-authorize by following Part 2 before you turn on the schedule. The Connector App only reads data from Haravan and does not create or update data on Haravan.

Part 4: Common errors and how to fix them

Each error screen below is listed with the exact English title shown on HexaSync, in the order it appears in the connection process. Most error screens have a Status line and a Detail from gateway or Technical details line. Capture these lines when you contact support.

For other cases, send a screenshot (with sensitive information hidden) to support@beehexa.com.

Error codes when the store connection cannot be completed

Applies to the message We Couldn’t Finish Connecting Your Haravan Store.

If the error repeats or appears with a different code, send the Technical details to support@beehexa.com.

Error codes when the credential cannot be verified

Applies to the message HexaSync Could Not Verify The Stored Credential.

Error codes when the credential cannot be linked to the Connector

Applies to the message HexaSync Could Not Link The Credential To Your Connector.

Part 5: Frequently asked questions

My Haravan account has several stores. How do I connect them?

Each authorization connects one store only, and each HexaSync Connector syncs one store only. When you sign in, Haravan asks which store you want to connect. To sync another store, create a new Connector and select that store in Step 5.

What if my Connector used to connect through a different app?

When you re-authorize, the Connector switches to HexaSync’s Haravan app automatically. Follow Part 2 and select the store that is linked to the Connector.

What if a colleague has already connected the store?

If another account has already connected the store on HexaSync, you get the FORBIDDEN code when you connect. Ask that person to share the credential with you with Editor access or higher, then try again. If nobody else has connected this store, contact support@beehexa.com.

Do I have to reconnect when the token expires?

Usually not. HexaSync keeps the access token valid for you. You only need to re-authorize when you remove the HexaSync app from the Haravan store, when a task reports an authorization error, or when HexaSync reports that Haravan does not accept the stored authorization details.

Why do I have to finish the authorization quickly and in the same browser?

The authorization code that Haravan sends back can be used only once and is valid for a short time only. The connection session details are also stored temporarily in the browser where you started. If you leave the page waiting for a long time, reload the return page or switch to another browser, the code can no longer be used and you have to connect again.

Is the Waiting For Credential Access screen an error?

No. Right after you connect, HexaSync needs a few seconds to finish setting up access to the new credential and checks again by itself. Stay on the page. If it is still not done after about half a minute, HexaSync shows the error HexaSync Could Not Verify The Stored Credential (see Part 4).

What if I cancel halfway through by mistake?

That is fine. If you cancel on HexaSync, HexaSync takes you back to the template installation page, the Connector page, or the credential management page, depending on where you started. If you cancel on the Haravan page, HexaSync may show the error We Could Not Find Your Installation Details; just select Back to installation. You can connect again at any time.

Does HexaSync write or change data on Haravan?

No. The Haravan Connector App only retrieves product and inventory data. It only reads data and does not create, write or change data on Haravan.