SuiteTalk (Web Services) Platform Guide - NetSuite

Web Services Error Handling and Error CodesUnderstanding Web Services Warnings, Errors, and Faults272For a detailed list of all error messages and the associated codes, see Error Status Codes.FaultsFaults are exceptions that are of a more fundamental nature than errors. A key distinctionbetween errors and faults is that a fault prevents any operation within a request from beingprocessed whereas an error prevents only a single operation from succeeding on an individualrecord.For example, continuing from the case above, if the user’s session has timed out when makingthe request, neither update for either event record is processed and an invalidSessionFault isreturned in the response.soapenv:Server.userExceptioncom.netledger.dto.faults.InvalidSessionFault: Your connection hastimed out. Please log in again.INVALID_SESSIONYour connection has timed out. Please log in again.com.netledger.dto.faults.InvalidSessionFault: Your connection has timedout. Please log in again.SOAP uses the detail element to capture the error code through the code element and the errormessage through the message element. The faultcode and faultstring are automaticallypopulated by the server.Following is an example of a SOAP fault named InvalidCredentialsFault for an invalid e-mailaddress that is returned as part of the login operation.soapenv:Server.userExveptioncom.netledger.dto.faults.InvalidCredentialsFault: You have entered aninvalid e-mail address or account number. Please try again.INVALID_USERNAMEYou have entered an invalid e-mail address or account number.Please try again.SuiteTalk Platform Guide