# NetSuite Extraction Error Reference

The errors in this guide are specific to NetSuite integrations. Refer to the [Common SaaS extraction error reference](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/common-saas-extraction-error-reference) for errors common to all SaaS integrations.

These errors will surface in the integration’s [Extraction Logs](https://help.qlik.com/en-US/stitch/replication/extractions/integration-extraction-logs).

* [Permission Violation: The restrictions on your role deny you access to this record.](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#insufficient-record-permissions-record-type)
* [Permission Violation: The subsidiary restrictions on your role prevent you from seeing this record.](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#subsidiary-not-allowed)
* [SuiteTalk concurrent request limit exceeded. Request blocked.](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#concurrent-request-limit)
* [The account you are trying to access is currently unavailable while we undergo our regularly scheduled maintenance.](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#netsuite-maintenance)
* [You do not have permission to access SOAP web services feature.](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#insufficient-soap-permission)
* [You do not have permission to access this type of transaction.](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#insufficient-transaction-permission)
* [You have not enabled SOAP web services feature for your account.](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#soap-not-enabled)
* [Your IP address {\[IP_ADDRESS\]} does not match any of the ipaddress rules specified for this account.](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#ip-address-not-whitelisted)

### Insufficient NetSuite user permissions for record type

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

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

| **Applicable to** | NetSuite v1 integrations |
| --- | --- |
| **Level** | Critical<br><br>the Remove icon<br><br>Data can't be replicated and intervention is required. Stitch will continue to re-try extraction based on the integration's schedule, but replication will not be successful until the issue is resolved. |
| **Category** | User permissions |
| **Potential cause(s)** | This error can have two causes:<br><br><ol> <li>The NetSuite user authorizing the integration doesn’t have the permissions required to access this record type, OR</li> <li>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.</li></ol> |
| **Suggested action(s)** | To resolve this issue:<br><br><ol> <li> <p>Verify that your NetSuite account has access to the feature the table relates to. For example: Accounting Periods.</p> <p>If your account doesn’t have access to the feature, de-select the table in Stitch to allow replication for other tables to proceed.</p> </li> <li> <p>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.</p> <p>Refer to the <a href="https://help.qlik.com/en-US/stitch/integrations/saas/netsuite-suitetalk/#create-configure-stitch-role">NetSuite setup guide</a> for instructions and info about the permissions Stitch requires.</p> </li></ol> |

[Back to NetSuite error list](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#)  
[Back to top](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#)

### Subsidiary-level permissions are unsupported

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

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

| **Applicable to** | NetSuite v1 integrations |
| --- | --- |
| **Level** | Critical<br><br>the Remove icon<br><br>Data can't be replicated and intervention is required. Stitch will continue to re-try extraction based on the integration's schedule, but replication will not be successful until the issue is resolved. |
| **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](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#)  
[Back to top](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#)

### Concurrent API sessions not allowed

```
SuiteTalk concurrent request limit exceeded. Request blocked.
```

`SuiteTalk concurrent request limit exceeded. Request blocked.`SuiteTalk concurrent request limit exceeded. Request blocked.

| **Applicable to** | NetSuite v1 integrations |
| --- | --- |
| **Level** | Critical<br><br>the Remove icon<br><br>Data can't be replicated and intervention is required. Stitch will continue to re-try extraction based on the integration's schedule, but replication will not be successful until the issue is resolved. |
| **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](https://help.qlik.com/en-US/stitch/integrations/saas/netsuite-suitetalk/#create-configure-stitch-role) to ensure replication isn’t delayed by this NetSuite limitation. |

[Back to NetSuite error list](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#)  
[Back to top](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#)

### NetSuite account maintenance

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

`The account you are trying to access is currently unavailable while we undergo our regularly scheduled 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<br><br>the Warning 2 icon<br><br>Data has been replicated, but something may require your attention. |
| **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](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#)  
[Back to top](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#)

### Insufficient SOAP web services permissions

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

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

| **Applicable to** | NetSuite v1 integrations |
| --- | --- |
| **Level** | Critical<br><br>the Remove icon<br><br>Data can't be replicated and intervention is required. Stitch will continue to re-try extraction based on the integration's schedule, but replication will not be successful until the issue is resolved. |
| **Category** | [User permissions](https://help.qlik.com/en-US/stitch/integrations/saas/netsuite-suitetalk/#configure-permissions-save-stitch-role) |
| **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](https://help.qlik.com/en-US/stitch/integrations/saas/netsuite-suitetalk/#configure-permissions-save-stitch-role). |

[Back to NetSuite error list](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#)  
[Back to top](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#)

### Insufficient transaction type permissions

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

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

| **Applicable to** | NetSuite v1 integrations |
| --- | --- |
| **Level** | Critical<br><br>the Remove icon<br><br>Data can't be replicated and intervention is required. Stitch will continue to re-try extraction based on the integration's schedule, but replication will not be successful until the issue is resolved. |
| **Category** | [User permissions](https://help.qlik.com/en-US/stitch/integrations/saas/netsuite-suitetalk/#configure-permissions-save-stitch-role) |
| **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](https://help.qlik.com/en-US/stitch/integrations/saas/netsuite-suitetalk/#configure-permissions-save-stitch-role) for a list of permissions. |

[Back to NetSuite error list](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#)  
[Back to top](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#)

### Web Services hasn't been enabled

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

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

| **Applicable to** | NetSuite v1 integrations |
| --- | --- |
| **Level** | Critical<br><br>the Remove icon<br><br>Data can't be replicated and intervention is required. Stitch will continue to re-try extraction based on the integration's schedule, but replication will not be successful until the issue is resolved. |
| **Category** | [Incorrect setup](https://help.qlik.com/en-US/stitch/integrations/saas/netsuite-suitetalk/#enable-web-services) |
| **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](https://help.qlik.com/en-US/stitch/integrations/saas/netsuite-suitetalk/#enable-web-services). |

[Back to NetSuite error list](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#)  
[Back to top](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#)

### Stitch's IP addresses aren't whitelisted

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

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

| **Applicable to** | NetSuite v1 integrations |
| --- | --- |
| **Level** | Critical<br><br>the Remove icon<br><br>Data can't be replicated and intervention is required. Stitch will continue to re-try extraction based on the integration's schedule, but replication will not be successful until the issue is resolved. |
| **Category** | [Incorrect setup](https://help.qlik.com/en-US/stitch/integrations/saas/netsuite-suitetalk/#whitelist-stitch-ips) |
| **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](https://help.qlik.com/en-US/stitch/integrations/saas/netsuite-suitetalk/#whitelist-stitch-ips). |

[Back to NetSuite error list](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#)  
[Back to top](https://help.qlik.com/en-US/stitch/troubleshooting/integrations/netsuite-suitetalk-extraction-error-reference#)