SuiteTalk (Web Services) Platform Guide - NetSuite

Chapter 6Web Services ProcessingThis section describes how to process requests synchronously versus asynchronously. Alsoprovided are steps for monitoring your web services requests. See these topics:• Synchronous and Asynchronous Request Processing• Monitoring Web Services ProcessingSynchronous and Asynchronous Request ProcessingWeb services requests can be processed synchronously or asynchronously. In synchronousrequests, your client application sends a request to the SuiteTalk where it is processed and aresponse is returned. The client application handles the response as appropriate.In asynchronous requests, your client application sends a request to the SuiteTalk Platformwhere it is placed in a processing queue and handled asynchronously with other requests. Notethat all available jobs for each polling period will be processed contiguously. There is noenforced waiting period for a job that is available. Once a job is processed, a job ID is returnedin the Web services response. Your client application can then check on the status and result ofthe request by referencing the job ID.Note: Asynchronous request JobIDs are valid for 30 days.Asynchronous equivalents are available for the following operations:• addList: asyncAddList• updateList: asyncUpdateList• upsertList: asyncUpsertList• deleteList: asyncDeleteList• getList: asyncGetList• search: asyncSearch• initializeList: asyncInitializeListWhen submitting an asynchronous request, the request is similar to the equivalentsynchronous call. For example, the following code illustrates the asynchronous request of a listof customer records.RequestSuiteTalk Platform Guide