NetSuite error codes — causes and fixes

In this section

• DUP_RECORD — DUP_RECORD means NetSuite blocked a save or import because a record duplicates an existing one. Causes on entities, items and CSV imports, and the fix. CA-reviewed.
• INSUFFICIENT_PERMISSION — INSUFFICIENT_PERMISSION in SuiteScript means the executing role lacks the permission or level for that record or operation. Causes and the fix, CA-reviewed.
• INVALID_KEY_OR_REF — INVALID_KEY_OR_REF means a value you set on a field is invalid there - inactive, wrong subsidiary, or wrong record type. The causes and the fix, CA-reviewed.
• Missing a required argument: id — "Missing a required argument: id" on record.load means the id option was missing or undefined. Causes and the exact fix, CA-reviewed.
• RCRD_DSNT_EXIST — RCRD_DSNT_EXIST means NetSuite can't find the record you asked for. The causes — wrong internal ID, wrong record type, wrong account — and the fix, CA-reviewed.
• RCRD_HAS_BEEN_CHANGED — RCRD_HAS_BEEN_CHANGED means a record changed since you loaded it, so NetSuite blocked the save to protect newer data. Why it happens and the fix. CA-reviewed.
• SSS_MISSING_REQD_ARGUMENT — SSS_MISSING_REQD_ARGUMENT in SuiteScript 2.x means a required argument is missing or undefined. Here are the causes and the exact fix, reviewed by a CA.
• SSS_TIME_LIMIT_EXCEEDED — SSS_TIME_LIMIT_EXCEEDED means a SuiteScript ran past its allowed execution time. Why it happens, and how to move the work to an asynchronous script - CA-reviewed.
• SSS_USAGE_LIMIT_EXCEEDED — SSS_USAGE_LIMIT_EXCEEDED means a SuiteScript hit its governance unit limit. The causes and the exact fix — cheaper APIs, yielding, Map/Reduce — CA-reviewed.
• USER_ERROR — USER_ERROR is a NetSuite error a script or workflow throws on purpose to stop an action. What triggers it, how to find the rule, and how to fix it. CA-reviewed.