Invalid Location for Subsidiary

Error Message

NetSuite Warning: Warning received from NetSuite for record record: (Error Received during NetSuite Update

Code: INVALID_SUB

Type: ERROR

Message: The subsidiary restrictions on this record are incompatible with those defined for location: 00 YourLocation.

Subsidiary access on this record must be a subset of those permitted by the location.

Sync Process

Any

Cause

The default Subsidiary is invalid for the default location set in NetSuite Connector Preferences, or the combination of the defaults and a Subsidiary or Location set on the Customer Account or Zuora Product Rate Plan Charge is invalid.

Resolution

Subsidiary, Location, Class and Department must be reconciled with NetSuite and configured properly within NetSuite Connector Preferences and their respective custom fields within Zuora.

Account Sync Failure

The following sections until Refund error due to invalid account reference provide information on Account Sync Failure.

Unknown subsidiary type

Error Message

NetSuite Warning: A warning was received from NetSuite for the record: (Error Received during NetSuite Update)

Code: USER_ERROR

Type: ERROR

Message: Please enter value(s) for: Subsidiary.

Sync Process

Any

Cause

The error occurred because no specific "subsidiary" type was selected during the update process in NetSuite.

Resolution

Ensure to select the "subsidiary" type when encountering issues related to subsidiaries. Alternatively, if the issue involves a missing department selection, choose the appropriate department. This proactive approach ensures accurate record creation in NetSuite.

Incorrect configuration of account subsidiary

Error message

No Subsidiary cross-reference match found for value xxx. Please correct any discrepancies between Zuora and NetSuite and try again

Sync Process

REST Zuora Invoice Sync to Netsuite

Cause

This Netsuite error occurs when there is a format mismatch while configuring the account subsidiary.

Resolution

Ensure that the account subsidiary configured in Zuora matches the format below:

Parent Subsidiary Name: Child Subsidiary Name

Enter a unique customer ID for this record

Error Message

A customer record with this ID already exists. You must enter a unique customer ID for each record you create.

Code: UNIQUE_CUST_ID_REQD

Type: ERROR

Message: Enter a unique customer ID for this record

Sync Process

Any

Cause

This error occurs when you try to enter a customer ID that was already used for an existing record.

Resolution

Enter a unique customer ID for each record every time you create one. Check your Netsuite record for duplicates and ensure the account does not contain a different NetSuite Internal ID from the NetSuite Integration ID.

Comment Limit Exceeded

Error Message

The field comments contained more than the maximum number (999) of characters allowed

Code: EXCEEDED_MAX_FIELD_LENGTH

Type: ERROR

Message: Reduce the length of the comments to below 999 characters

Sync Process

Account

Cause

The error occurred because your comment exceeded the maximum character limit.

Resolution

Ensure that the comment you enter does not exceed the maximum limit of 999 characters on the Zuora Account.Comment.

Refund error due to invalid account reference

Error Message

Code: INVALID_KEY_OR_REF

Type: ERROR

Message: Invalid account reference key 996 for currency 2.

Sync Process

Any

Cause

The error occurred due to a mismatch between the account ID and the currency ID.

Resolution

Ensure that the account supports the specified currency.

To verify and correct the account currency settings in NetSuite, perform the following actions:

1. Navigate to Lists > Accounting > Accounts in NetSuite.

2. Locate the account associated with the given ID(for example, 996) and check if the account is active or not.

3. Ensure the account is configured for the correct currency(ID 2).

4. If the currency is incorrect, adjust it accordingly.

In this scenario, the account(ID 996) should be correctly associated with the currency that is being used (currency ID 2).

Enabling multi-threading without Concurrent Sessions enabled in NetSuite

Error Message

Error executing Netsuite operation: Only one request may be made against a session at a time.

Sync Process

Any

Cause

The Integration user (Web Services User) does not have the field 'Concurrent Web Service User' set to TRUE on it's Employee record.

Resolution

Please review the steps for configuring a NetSuite Web Services User for use with NetSuite Connector in Create a NetSuite Connector User.

You Do Not Have Permissions to Set a Value

Error Message

NetSuite Warning: Warning received from NetSuite for record record: (Error Received during NetSuite Update

Code: INSUFFICIENT_PERMISSION

Type: ERROR

Message: You do not have permissions to set a value for element field_name due to one of the following reasons: 1) The field is read-only; 2) An associated feature is disabled; 3) The field is available either when a record is created or updated, but not in both cases.) null

Sync Process

Any

Cause

1. General: The most common cause is that the field name referenced is not configured to be displayed on the preferred form for the given NetSuite object.

2. General: The default role for the NetSuite user configured in NetSuite Connector does not have a preferred form that displays the field referenced in the error message.

3. General: The default role for the NetSuite user configured in NetSuite Connector does not have permissions to edit certain custom Zuora fields.

4. Initialization, field name taxSchedule: In the NetSuite Connector Sync Preferences, a Default NetSuite Tax Schedule value was entered but the client’s NetSuite account is not configured to use Tax Schedules (Advanced Taxes are disabled). To confirm this, in NetSuite navigate to Setup > Company > Enable Features > Accounting tab > Advanced Features.

5. Initialization, field name taxitem: In the NetSuite Connector Sync Preferences, a Default Tax Code value was entered but the client’s NetSuite account is not configured correctly. To confirm this, in NetSuite navigate to Setup > Accounting > Set Up Taxes > United States (if multiple currencies) and look for the Per-Line Taxes on Transactions setting. This should be disabled (unchecked).

6. Zuora Invoice, field name taxitem: The client has NetSuite International Edition but NetSuite Connector is not configured accordingly.

7. Zuora Invoice, field name deferrevrec: This error is caused by one of the following:

   • The associated NetSuite Item is not configured with a Deferred Revenue Account.

   • A Revenue Recognition Template is configured in Zuora for an Inventory type item. Inventory items cannot be amortized. Remove the Revenue Recognition related values on the Zuora Product Rate Plan Charge.

   • The Delay Rev. Rec. or Revenue Recognition Schedule field is not configured to be displayed on the preferred Invoice form or Credit Memo form (for negative Zuora invoices) in NetSuite.

8. Customer, field name autoname: If Zuora is the Customer Master, there is a discrepancy between the NetSuite Connector Customer Account mapping preference and the configuration within NetSuite, which is preventing the sync from populating the Zuora Customer Account Number/Name to the NetSuite Customer ID field when creating/updating the record.

9. Customer, field name subsidiary: In NetSuite OneWorld editions using subsidiaries, if the Consolidated Payments feature is enabled NetSuite does not allow a subsidiary to be explicitly set for new child customer records. The subsidiary is inherited from the parent customer record.

Resolution

1. Edit the preferred form in NetSuite for the given object and ensure the field in question is set to be displayed on the appropriate screen. Note the preferred form can be set "globally" or for a specific role (see next item). See Configure NetSuite Forms for more information.

2. Verify the default role for the NetSuite user by logging into NetSuite as that user, clicking the dropdown by the user name in the upper right corner, and choosing View All Roles. Then verify that role's preferred form is one that is configured to display the field referenced in the error message.

3. Some key custom fields come preconfigured in the NetSuite Connector bundle with the edit permission restricted to the Administrator role. If you wish to use a different or custom role for the NetSuite Connector integration user, be sure to modify the access permissions accordingly to allow the different role to be able to modify the field values. The custom field access permissions can be found within NetSuite under Setup > Customization > Entity/Item/Transaction Body/Transaction Column Fields > edit field > Access tab.

4. Remove the "Default NetSuite Tax Schedule" value in the Integrations Manager's Sync Preferences.

5. Disable the Per-Line Taxes on Translations NetSuite setting.

6. Within NetSuite Connector, set the Advanced Setting Use Standard Invoice Sync to "Yes - NetSuite Int'l Edition". This will suppress the syncing of tax-related fields for Zuora transactions.

7. For this case, use one of the following methods to resolve the error:

   • If the associated NetSuite Item is not configured with a Deferred Revenue Account, if the Charge has already been synced, edit the Item record directly in NetSuite to select the Deferred Revenue Account. (The Deferred Revenue Template field is optional.)

   • If the Delay Rev. Rec. or Revenue Recognition Schedule field is not configured to be displayed on the preferred Invoice form or Credit Memo form (for negative Zuora invoices) in NetSuite, edit the Preferred Invoice form or Credit Memo form in NetSuite and ensure that the Delay Rev. Rec. field is set to be displayed in the Columns section.

8. Modify the NetSuite Connector preferences and/or NetSuite configuration to align with how you want the Customer ID mapping behavior to work. If Zuora is the Customer Master and you choose to use a value from the source record for the Customer Account Number Mapping, if Auto-Generated Numbers are enabled for Customers in NetSuite, be sure to enable Allow Override in NetSuite. Additionally if you want to sync both new and modified records, you must also enable Update in NetSuite (go to Setup > Company > Auto-Generated Numbers). See Configure sync preferences for more information.

9. Disable the Consolidated Payments feature within NetSuite: Setup > Company > Enable Features > Accounting tab > Advanced Features section. Consolidated payments are not supported by NetSuite Connector because it prevents the reconciliation of NetSuite payments to specific Zuora invoices.

Process is Already Running

Error Message

Process is Already Running

Sync Process

Initializing

Cause

The sync is already running. Only one instance of the sync may run at a given time. You may see this warning message if a previous sync is still running when the next sync is scheduled to run or if the manual Run Now button was clicked multiple times in close succession.

Resolution

Wait for the current sync to complete and then run the sync again or wait for the next scheduled sync. Records already in progress will continue to sync as normal.

Invalid NetSuite Password

Error Message

Error executing Netsuite Command: Unable to lookup web services domain.

Sync Process

Initializing, Any

Cause

Invalid NetSuite password configured in Integration Setup.

Resolution

Modify the Integration Preferences > Connection Information and re-enter your NetSuite password.

Invalid NetSuite Email Address or Account Number

Error Message

Error executing Netsuite Command: Error executing Netsuite operation. You have entered an invalid email address or account number

OR

Error executing Netsuite Command: Unable to lookup web services domain.

Sync Process

Initializing, Any

Cause

Invalid NetSuite user name or account number configured in Integration Setup.

Resolution

Modify the Integration Preferences > Connection Information and re-enter your NetSuite credentials.

Unknown Failure Invalid Type: Export

Error Message

First document failure: [FAIL] Unknown failure invalid type: Export

Sync Process

Any

Cause

Data source permission is not enabled for the Zuora tenant.

Resolution

Enable data source permission for the Zuora tenant.

Unable to Log into Zuora

Error Message

First document failure: Unable to login

OR

Invalid login. User name and password do not match.

Sync Process

Any

Cause

1. Unable to log into Zuora.

2. The Zuora application or web service is temporarily unavailable.

Resolution

1. Modify the Integration Preferences > Connection Information, re-enter your Zuora credentials, and try logging in again. Make sure the Zuora Web Service Site matches a correct endpoint:

   • https://www.zuora.com/apps for the US Production

   • https://apisandbox.zuora.com/apps for the US API Sandbox

   • https://eu.zuora.com/apps for the EU Production

   • https://sandbox.eu.zuora.com/apps for the EU Sandbox

2. Try to log into Zuora application UI.

Process Terminating: Some Documents Reached An Exception

Error Message

Process terminating -- some documents reached an exception which is set to halt all documents: There were warnings during the sync. Please review the Process Log for details.

Sync Process

Any

Cause

This is a summary error notification, not the actual error message needed for troubleshooting.

Resolution

Look for other error messages earlier in the Process or Document logs that contain a specific error message.