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.
- Permission Violation: The restrictions on your role deny you access to this record.
- Permission Violation: The subsidiary restrictions on your role prevent you from seeing this record.
- SuiteTalk concurrent request limit exceeded. Request blocked.
- The account you are trying to access is currently unavailable while we undergo our regularly scheduled maintenance.
- You do not have permission to access SOAP web services feature.
- You do not have permission to access this type of transaction.
- You have not enabled SOAP web services feature for your account.
- Your IP address {[IP_ADDRESS]} does not match any of the ipaddress rules specified for this account.
Insufficient NetSuite user permissions for record type
Applicable to |
NetSuite v1 integrations |
Level | Critical |
Category |
User permissions |
Potential cause(s) |
This error can have two causes:
|
Suggested action(s) |
To resolve this issue:
|
Back to NetSuite error list
Back to top
Subsidiary-level permissions are unsupported
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
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
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
Applicable to |
NetSuite v1 integrations |
Level | Critical |
Category |
User permissions |
Potential cause(s) |
The NetSuite user authorizing the integration doesn’t have the |
Suggested action(s) |
Grant the authorizing NetSuite user the |
Back to NetSuite error list
Back to top
Insufficient transaction type permissions
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
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
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.