SuiteTalk (Web Services) Platform Guide - NetSuite

Chapter 11 Web Services Error Handlingand Error CodesThis section provides information on the following:• The three exception types that are supported in the SuiteTalk: warnings, errors, andfaults. See Understanding Web Services Warnings, Errors, and Faults for an overview.• SOAP Faults that can be thrown for each SuiteTalk operation. See SOAP Faults forEach Operation.• SOAP Fault Status Codes• Error Status Codes• Warning Status CodesUnderstanding Web Services Warnings, Errors, andFaultsBased on the error code or fault that is received, the client can take the appropriate action.• Warnings: informational notifications requiring an action within the UI but requiringno response from a Web service call. Data may or may not be processed depending onpreference settings. For more information on preferences, see Setting Company-widePreferences.• Errors: exceptions returned on a record-by-record basis due to invalid or incompletedata. The service is processed as requested, however, only those records without errorsare updated.• Faults: a fundamental exception type that results in the entire request not beingprocessed.WarningsA warning is a notification sent to a user in order to prevent a subsequent error or to ensurebetter data quality. In the Netsuite UI, a warning is presented to the user through a dialog boxand generally requires an action from the user. Since there is no interaction of this nature in theWeb services model, the request must specify what to do in the case of a warning. The optionsare:• Ignore the warning and submit the record to the database• Heed the warning and abort the submission — treat as an errorSuiteTalk Platform Guide