The errors in this guide are specific to NetSuite integrations. Refer to the Common SaaS extraction error reference for errors common to all SaaS integrations.

These errors will surface in the integration’s Extraction Logs.

Insufficient NetSuite user permissions for record type

Permission Violation: The restrictions on your role deny you access to this record.
Applicable to

NetSuite v1 integrations

Level Critical
Category

User permissions

Potential cause(s)

This error can have two causes:

  1. The NetSuite user authorizing the integration doesn’t have the permissions required to access this record type, OR
  2. The table in the error is related to a specific feature in NetSuite that your NetSuite account doesn’t have access to. For example: Accounting Periods.
Suggested action(s)

To resolve this issue:

  1. Verify that your NetSuite account has access to the feature the table relates to. For example: Accounting Periods.

    If your account doesn’t have access to the feature, de-select the table in Stitch to allow replication for other tables to proceed.

  2. If your account does have access to the feature, grant the authorizing NetSuite user the permissions required to access the record type related to the feature. For example: Accounting Periods.

    Refer to the NetSuite setup guide for instructions and info about the permissions Stitch requires.

Back to NetSuite error list
Back to top

Subsidiary-level permissions are unsupported

Permission Violation: The subsidiary restrictions on your role prevent you from seeing this record.
Applicable to

NetSuite v1 integrations

Level Critical
Category

User permissions

Potential cause(s)

Subsidiary-specific permissions aren’t compatible with Stitch’s NetSuite integration. The permissions granted to the NetSuite user authorizing the integration must be account-level permissions.

Suggested action(s)

Grant the authorizing NetSuite user account-level permissions.

Back to NetSuite error list
Back to top

Concurrent API sessions not allowed

SuiteTalk concurrent request limit exceeded. Request blocked.
Applicable to

NetSuite v1 integrations

Level Critical
Category

NetSuite limitation

Potential cause(s)

The NetSuite user authorizing the integration has multiple active API sessions.

Suggested action(s)

NetSuite allows a user to have one active API session at a time. If you have multiple NetSuite integrations - even if they’re outside of Stitch - we recommend creating a NetSuite user for each integration to ensure replication isn’t delayed by this NetSuite limitation.

Back to NetSuite error list
Back to top

NetSuite account maintenance

The account you are trying to access is currently unavailable while we undergo our regularly scheduled maintenance.
Applicable to

NetSuite v1 integrations

Level Warning
Category

NetSuite maintenance

Potential cause(s)

NetSuite is performing maintenance on your account, making it temporarily unavilable.

Suggested action(s)

No action is needed on your part. Replication will resume based on the integration’s schedule and succeed when NetSuite completes maintenance on your account.

Back to NetSuite error list
Back to top

Insufficient SOAP web services permissions

You do not have permission to access SOAP web services feature.
Applicable to

NetSuite v1 integrations

Level Critical
Category

User permissions

Potential cause(s)

The NetSuite user authorizing the integration doesn’t have the Web Services permission. This is required to allow Stitch to use the SuiteTalk API and extract data from NetSuite.

Suggested action(s)

Grant the authorizing NetSuite user the Web Services permission as outlined in the NetSuite setup guide.

Back to NetSuite error list
Back to top

Insufficient transaction type permissions

You do not have permission to access this type of transaction.
Applicable to

NetSuite v1 integrations

Level Critical
Category

User permissions

Potential cause(s)

The NetSuite user authorizing the integration doesn’t have the permission required to access this transaction type.

Suggested action(s)

Grant the authorizing NetSuite user the permission required to access the transaction type. Refer to the Object permissions tab in the NetSuite setup guide for a list of permissions.

Back to NetSuite error list
Back to top

Web Services hasn't been enabled

You have not enabled SOAP web services feature for your account.
Applicable to

NetSuite v1 integrations

Level Critical
Category

Incorrect setup

Potential cause(s)

The Web Services feature hasn’t been enabled for your NetSuite account. This is required to allow Stitch to use the SuiteTalk API and extract data from NetSuite.

Suggested action(s)

Enable the Web Services feature and token-based authentication as outlined in the NetSuite setup guide.

Back to NetSuite error list
Back to top

Stitch's IP addresses aren't whitelisted

Your IP address {[IP_ADDRESS]} does not match any of the ipaddress rules specified for this account.
Applicable to

NetSuite v1 integrations

Level Critical
Category

Incorrect setup

Potential cause(s)

Your NetSuite account enforces IP address rules and Stitch’s IP addresses haven’t been whitelisted in your NetSuite account.

Suggested action(s)

Add Stitch’s IP addresses to the Allowed IP addresses list for your NetSuite account as outlined in the NetSuite setup guide.

Back to NetSuite error list
Back to top


Questions? Feedback?

Did this article help? If you have questions or feedback, feel free to submit a pull request with your suggestions, open an issue on GitHub, or reach out to us.