Error: Passed Nil Into T.must

Issue

The following error appears in the API inspector when syncing to NetSuite objects that include sublists:

Passed nil into T.must

Environment

• Destination: NetSuite

Resolution

To troubleshoot this issue:

1. Check the NetSuite object structure and sublist fields:

   i. Ensure that the JSON for any sublist or line-item field is formatted as a JSON array.

   ii. Use the NetSuite Schema Browser to confirm the correct object, sublist, and field names for the records you want to sync.

   iii. For transaction records, check the relevant line object in the Schema Browser to verify the expected sublist structure.

2. Verify field casing and identifiers:

   i. Confirm that the sync's field name matches the NetSuite schema exactly. NetSuite field names are case-sensitive.

   ii. For custom fields, use the NetSuite script ID rather than the display label.

   iii. Confirm the field exists on the target sublist and that the integration user has permission to read and write to it.

3. Check for recently added or renamed fields:

   i. If you recently added, renamed, or modified a field or sublist and the sync may still be using outdated metadata, contact the Fivetran support team for a metadata refresh.

   ii. After the refresh, rerun the sync and confirm the field resolves correctly.

   iv. If the issue persists, share a sync URL with your current configuration with our support team.

Cause

This issue occurs when the sync can't resolve a NetSuite sublist field. Common causes include:

• The field doesn't exist on the target sublist.
• The field name is misspelled.
• The field casing doesn't match NetSuite exactly.
• A custom field is referenced by the display name instead of the script ID.
• The sync has stale metadata after a NetSuite change.

For NetSuite field and sublist definitions, refer to the NetSuite Schema Browser.