Skip to main content

Acumatica Data Source

Acumatica is a cloud-based ERP platform that manages your financial, operational, and business data. By connecting Acumatica, you can use that data directly in your views and dashboards, keeping everything up to date without manual exports or data preparation.

Nectari supports two ways to authenticate with Acumatica. Basic authentication uses a username and password and is the simplest setup, with no extra configuration in Acumatica. OAuth 2.0 uses a more secure, token-based connection and is recommended when your Acumatica environment supports it. Choose the method that matches your Acumatica environment.

Configure Basic Authentication

Use Basic authentication when connecting with a standard Acumatica username and password. This is the simplest way to connect and requires no additional setup in Acumatica.

FieldWhat to enter
Data Source DescriptionUnique name for this data source. Example: Acumatica Data Source.
TypeSelect Acumatica.
URLBase URL of your Acumatica site. Example: https://yourcompany.acumatica.com.
CompanyName of the Acumatica company you want to connect to.
Page SizeMaximum number of records returned per request. Default: 10000.
Operation timeoutMaximum time in seconds allowed for each request. Default: 60.
Extra connection string propertiesOptional. Additional connection string parameters required by your provider.
Authentication StrategySelect Basic.
User NameLogin account for authenticating with Acumatica.
PasswordPassword for this account.

Example setup

Acumatica data source configured with Basic authentication

Configure OAuth 2.0 Authentication

Use OAuth 2.0 when connecting through a registered application with delegated access. This method is more secure than Basic authentication and is recommended when your Acumatica environment supports it. Before filling in the fields below, register an application in Acumatica to obtain your Client ID and Client Secret.

FieldWhat to enter
Data Source DescriptionUnique name for this data source. Example: Acumatica Data Source.
TypeSelect Acumatica.
URLBase URL of your Acumatica site. Example: https://yourcompany.acumatica.com.
CompanyName of the Acumatica company you want to connect to.
Page SizeMaximum number of records returned per request. Default: 10000.
Operation timeoutMaximum time in seconds allowed for each request. Default: 60.
Extra connection string propertiesOptional. Additional connection string parameters required by your provider.
Authentication StrategySelect OAuth 2.0.
Client IDClient ID generated when you registered the application in Acumatica.
Client SecretClient secret generated with the client ID.
ScopeRequired scopes. Defaults: api and offline_access.
Callback URLAutomatically generated by Nectari. Copy this URL and paste it into your Acumatica application.

Get the Client ID and Client Secret

To connect using OAuth 2.0, you first need to register a connected application in Acumatica. This generates the Client ID and Client Secret required by Nectari.

  1. In Acumatica, select Integration. If not visible, click More Items.
  2. Under Preferences, select Connected Applications.
  3. Select the + icon to add a new record.
  4. In Client Name, enter OAuth or another unique name.
  5. In Flow, select Authorization Code.
  6. Click Save. The Client ID is generated automatically.
  7. Open the Secrets tab, then select Add Shared Secret.
  8. Enter a description for the secret.
  9. Copy the value shown in the Value field and store it securely. You will not be able to view it again after saving.
  10. Click Ok.

Add the Callback URL in Acumatica

Once you have your Client ID and Client Secret, register the Callback URL from Nectari in Acumatica to complete the OAuth 2.0 setup.

  1. In Acumatica, select Integration. If not visible, click More Items.
  2. Under Preferences, select Connected Applications.
  3. In Client ID, select the connected application you created earlier.
  4. Open the Redirect URIs tab.
  5. Select the + icon to add a row.
  6. In Nectari, copy the full Callback URL from the data source definition panel.
  7. Paste the URL into the new row in Acumatica.
  8. Click Save.

Example

Acumatica data source configured with OAuth 2.0