SuiteTalk (Web Services) Platform Guide - NetSuite

Web Services OperationsupsertList265by their external ID and their record type. If a record of the specified type with a matchingexternal ID exists in the system, it is updated. If it does not exist, a new record is created.Because external ID is mandatory for this operation, upsertList is supported only for recordsthat support the external ID field. For a list of these records, see NetSuite Record Types thatSupport External ID. Also, this operation prohibits the passing of internal ID values.Limitations on upsertList• Although records of a particular type may be used in multiple integration scenarios,each record instance can only have a single external ID value. In order to maintain dataintegrity, only a single integrated application can set and update external ID values foreach record type. External ID values for all records of a particular type must all comefrom the same external application.• UpsertList cannot complete updates during an initialize / initializeList operation,when a record is transformed into a record of another type. In this case, upsertListonly adds and does not update records.• Updates through the upsertList operation are also subject to the same limitations asupdates through the updateList operation. For details of these limitations, seeupdateList.RequestThe UpsertListRequest type is used for the request. It contains the following fields.Element Name XSD Type Notesrecord[] Record Contains an array of record objects. The record type is an abstracttype so an instance of a type that extends record must be used—such as Customer or Event.Note: An asynchronous equivalent is available for this operation, asyncUpsertList. Forinformation about asynchronous request processing, see Synchronous andAsynchronous Request Processing.ResponseThe UpsertListResponse type is used for the response. It contains the following fields.Element Name XSD Type Notesresponse[] WriteResponse Contains an array of WriteResponse objects, each of whichcontains details on the status of that upsert operation and areference to the created or updated record.FaultsThis operation can throw one of the following faults. See SOAP Fault Status Codes for moreinformation on faults.SuiteTalk Platform Guide