SOAP Web Services Governance Overview

NetSuite uses mechanisms to optimize and control SOAP web services usage on its application and database servers. These mechanisms provide the following benefits:

• Requests are monitored and controlled to prevent excessive impact on the user experience.

• Heavy SOAP web services usage by some users does not affect other users.

NetSuite SOAP web services governance includes:

• Record limiting (see Understanding Record Limiting)

• Request limiting (see Understanding Request Limiting)

Note:

For information about the maximum number of sessions, see Session Limits.

Important:

For information about the new web services and RESTlet concurrency governance, see Web Services and RESTlet Concurrency Governance.

Understanding Record Limiting

The following limits apply:

• The number of records in a list operation.

• The number of records in a page of search results. Search results are set by the pageSize field of the searchPreferences complex type. A minimum and maximum exists for this parameter.

Limits differ for synchronous and asynchronous operations.

Synchronous Operations

Operation or parameter (on a per request basis)	Minimum Record Count	Maximum Record Count
addList	—	200
deleteList	—	200
getList	—	1000
getItemAvailability	—	10000
updateList	—	100
upsertList	—	100
pageSize parameter of searchPreferences complex type, when used in synchronous searches	5	1000

Asynchronous Operations

Operation or parameter (on a per request basis)	Minimum Record Count	Record Count
asyncAddList	—	400
asyncGetList	—	2000
asyncUpdateList	—	200
asyncUpsertList	—	200
asyncDeleteList	—	400
pageSize parameter of searchPreferences complex type, when used in asynchronous searches	5	2000

Note:

For details on asynchronous processing, see Asynchronous Request Processing.

Understanding Request Limiting

Request limits refer to the size of your SOAP request. The maximum allowed size for a SOAP request is 100MB.

Understanding Governance Errors

The following faults are thrown because of other governance violations.

• ExceededRecordCountFault – thrown if a request exceeds the allowed record count.

• ExceededRequestLimitFault – thrown if the allowed number of concurrent requests is exceeded.

• ExceededRequestSizeFault – thrown if a request exceeds 100M.

For more information about exceptions, refer to SOAP Web Services Error Handling and Error Codes.

For information about concurrency governance, see Web Services and RESTlet Concurrency Governance.

Related Topics

• SuiteTalk SOAP Web Services Platform Overview
• SOAP Web Services Overview
• NetSuite WSDL and XSD Structure
• NetSuite WSDL Versioning
• SOAP Web Services Performance Optimization
• Web Services and RESTlet Concurrency Governance
• Glossary

General Notices