Completing the Initial ZoneLiquidity Setup

ZoneLiquidity requires a one-time setup, completed by a NetSuite Administrator, that connects your account to Zone's AI forecasting model. Once the API Secret is saved, your finance team can create cash forecasts without repeating this step.

Note: Clicking on the images within this guide will enlarge them for better viewing.

💡 Preference Tip: If you prefer a guided experience, watch the video above. For text instructions and explanation, refer to the article below.

Overview

ZoneLiquidity sits within ZoneReconcile and is accessed via the ZoneLiquidity menu in NetSuite. Before anyone in your organisation can generate a forecast, a NetSuite Administrator must configure the API Secret in the ZoneLiquidity Setup assistant.

Once the API Secret is saved, the Administrator can stop there and hand off — another user with the Administrator, ZoneLiquidity, or ZoneLiquidity SAML role can continue through the rest of the wizard from General Preferences onward. See Creating a New Cash Forecast in ZoneLiquidity for those steps.

Important: Complete this setup once per NetSuite account. 

Prerequisites

• Your organisation holds an active ZoneReconcile license with ZoneLiquidity enabled.
• ZoneLiquidity is installed and deployed to your NetSuite account (ZoneReconcile 5.28.0 or later).
• You are logged in to NetSuite with the Administrator role.
• At least 1 subsidiary with associated bank accounts is configured in NetSuite.
• Historical transaction data exists for the subsidiaries and bank accounts you intend to forecast. The system looks back 365 days from the forecast creation date to train the AI model. For best results, aim for at least 6–12 months of reasonably complete payment history before running a forecast.

Who can complete this setup

Only a user logged in to NetSuite with the Administrator role can configure the API Secret. This step writes credentials to your NetSuite account and is restricted to Administrators.

Important: If you are not a NetSuite Administrator, you cannot save the API Secret. Contact your NetSuite Administrator to complete this step. Once the API Secret is saved, you can build forecasts under the ZoneLiquidity or ZoneLiquidity SAML role.

If you are not a NetSuite Administrator

Until a NetSuite Administrator saves the API Secret, any user who opens a ZoneLiquidity page sees a prompt to enter their Administrator's email address.

1. Enter your NetSuite Administrator's email address.
2. Click Request Access.
3. You will get a confirmation message that the setup link has been sent to your Administrator.

Your Administrator receives an email asking them to complete the ZoneLiquidity setup. Once they save the API Secret, you can access ZoneLiquidity.

If you receive an email from a colleague

When a user enters your email address in the ZoneLiquidity prompt, you receive an email asking you to complete the ZoneLiquidity setup. 

1. Log in to NetSuite with the Administrator role.
2. Click on the link in the email to be taken to ZoneLiquidity Setup.  
3. Continue from Step 2 below.

Step 1: Open the ZoneLiquidity Setup wizard

Navigate to Setup > ZoneLiquidity > ZoneLiquidity Setup. 

(In Zone Control Center, click Setup > Liquidity Setup.)

Step 2: Accept the Terms and Conditions

On first launch, the ZoneLiquidity Terms and Conditions modal appears. During the Customer Preview period (until December 31, 2026), this modal also includes the Customer Preview Notice.

1. Review the ZoneLiquidity Terms and Conditions and the Customer Preview Notice using the links in the modal.
2. Select the I Agree checkbox.
3. Click Continue.

Important: By selecting I Agree, you confirm that you have authority to bind your company to these terms. You also acknowledge that ZoneLiquidity uses artificial intelligence, is a pre-GA Customer Preview offering, and is a forecasting and decision-support tool only, not financial advice.

Step 3: Configure the API key

This step establishes the secure connection to the ZoneLiquidity backend and is the only step restricted to Administrators.

Non-Administrators will see a prompt asking for the Administrator's email. 

1. Click Request API Key.

The system automatically connects to Zone’s Treasury service, sets up the account in your region, and securely stores the credentials—no manual API keys required. Once done, the wizard displays a success state and you are taken to the next step.

Step 4: Continue or hand off

With the API Secret saved, the initial setup is complete. Either continue through the wizard yourself, or hand off to a colleague with the ZoneLiquidity or ZoneLiquidity SAML role.

Follow Creating a New Cash Forecast in ZoneLiquidity for the remaining steps: General Preferences, Destination Rules, and Review and Execute.

Important: Before handing off, confirm that the colleagues who will be creating forecasts have been assigned the ZoneLiquidity or ZoneLiquidity Role (SAML Single Sign On) NetSuite role. Users without one of these roles, or the Administrator role, cannot open the ZoneLiquidity menu or access the forecast wizard.

Administrator follow-up tasks

Some validation and tuning tasks remain Administrator-only after handoff.

Assign ZoneLiquidity roles to finance team members

Finance team members who need to access ZoneLiquidity must be assigned one of the following NetSuite roles by a NetSuite Administrator:

• ZoneLiquidity — standard role for users who will create and review forecasts.
• ZoneLiquidity Role (SAML Single Sign On) — equivalent to the ZoneLiquidity role, for users who authenticate through SAML single sign-on.

Users without one of these roles, or the Administrator role, cannot open the ZoneLiquidity menu or generate forecasts.

Check a forecast's status on the ZoneLiquidity Forecast Definition record

The ZoneLiquidity Forecast Definition record is accessible only through the Administrator role, so users on a ZoneLiquidity role may ask you to check it on their behalf.

1. Type ZoneLiquidity Forecast Definition in the global search.
2. Open the most recent record and confirm the Status field reads Completed.
3. Note the Sync Count field, which shows the number of transactions sent to the AI model.

Increase processing capacity

To speed up forecast submission, increase the number of processors on the ZR Transaction Sync MR script deployment under Concurrency Limit. Review the impact on other scheduled processing before changing this setting.

Next steps

Setup is complete. Users with the Administrator, ZoneLiquidity, or ZoneLiquidity SAML role can now create forecasts without repeating the API Secret step. See Creating a New Cash Forecast in ZoneLiquidity.