You are here: API Foundations > Error Handling > Errors

Errors

Errors are row-level failures that occurred when trying to do a batch call ; for example, trying to create 20 accounts, where 18 succeed but 2 have errors. With errors, whichever part succeeded will be processed, and one or more error codes will be returned indicating where the errors occurred.

The Error Object

The Error object provides three types of information, as described in this table.

Error Description
Code Identifies which error occurred. See ErrorCode, below, for a list of all possible errors.
Field Indicates which field had the failure, if any.
Message Provides more specific details on what the error was.

The ErrorCode Object

The ErrorCode object contains the text for errors. Note that the ErrorCode enumeration defined in the WSDL defines errors for both faults and errors. The following table lists the errors you might see while developing your application using the Zuora API.

Error Meaning
API_DISABLED The API has been disabled.
CANNOT_DELETE The specified item could not be deleted
CREDIT_CARD_PROCESSING_FAILURE There was a problem processing the credit card.
DUPLICATE_VALUE A duplicate value was found.
INVALID_FIELD An invalid field specified in the create, update, or query calls.
INVALID_ID An invalid ID was specified
INVALID_LOGIN The login credentials are invalid.
INVALID_SESSION The authentication session is invalid or has expired. You may need to log in again.
INVALID_TYPE An invalid object type was specified in the create, update, or query calls.
INVALID_VALUE An invalid value was specified.
INVALID_VERSION The version of the API doesn't match the capabilities you are trying to use.
MALFORMED_QUERY The query was not properly formed.
MAX_RECORDS_EXCEEDED Tthe maximum allowed number of records has been exceeded.
MISSING_REQUIRED_VALUE A value that is required has not been specified.
TRANSACTION_FAILED The transaction has failed.
UNKNOWN_ERROR An unknown error was encountered.

See Also

Error Handling

Faults

Copyright © 2008-2009 Zuora, Inc.