0% found this document useful (0 votes)

34 views396 pages

Suite Talk Web Services Platform Guide

The SuiteTalk SOAP Web Services Platform Guide provides comprehensive information on using Oracle's SuiteTalk SOAP web services, including setup, performance optimization, and governance. It outlines the licensing restrictions, responsibilities for safe use, and the documentation's pre-General Availability status. Additionally, it covers integration management, roles and permissions, and various technical considerations for developers working with SOAP web services.

Uploaded by

jayashree

We take content rights seriously. If you suspect this is your content, claim it here.

Available Formats

Download as PDF, TXT or read online on Scribd

0% found this document useful (0 votes)

34 views396 pages

Suite Talk Web Services Platform Guide

Uploaded by

jayashree

We take content rights seriously. If you suspect this is your content, claim it here.

Available Formats

Download as PDF, TXT or read online on Scribd

You are on page 1/ 396

SuiteTalk SOAP Web

Services Platform Guide

Version 2022 Release 2

November 9, 2022
Copyright © 2005, 2022, Oracle and/or its affiliates.

This software and related documentation are provided under a license agreement containing restrictions
on use and disclosure and are protected by intellectual property laws. Except as expressly permitted
in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast,
modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any
means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for
interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-
free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it
on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software,
any programs installed on the hardware, and/or documentation, delivered to U.S. Government end
users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation
and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and
adaptation of the programs, including any operating system, integrated software, any programs installed
on the hardware, and/or documentation, shall be subject to license terms and license restrictions
applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management
applications. It is not developed or intended for use in any inherently dangerous applications, including
applications that may create a risk of personal injury. If you use this software or hardware in dangerous
applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other
measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages
caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks
of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks
are used under license and are trademarks or registered trademarks of SPARC International, Inc.
AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of
Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content,
products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and
expressly disclaim all warranties of any kind with respect to third-party content, products, and services
unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and
its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use
of third-party content, products, or services, except as set forth in an applicable agreement between you
and Oracle.

If this document is in public or private pre-General Availability status:

This documentation is in pre-General Availability status and is intended for demonstration and preliminary
use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation
and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to
this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of
this documentation.

If this document is in private pre-General Availability status:

The information contained in this document is for informational sharing purposes only and should be
considered in your capacity as a customer advisory board member or pursuant to your pre-General
Availability trial agreement only. It is not a commitment to deliver any material, code, or functionality, and
should not be relied upon in making purchasing decisions. The development, release, and timing of any
features or functionality described in this document remains at the sole discretion of Oracle.

This document in any form, software or printed matter, contains proprietary information that is the
exclusive property of Oracle. Your access to and use of this confidential material is subject to the terms
and conditions of your Oracle Master Agreement, Oracle License and Services Agreement, Oracle
PartnerNetwork Agreement, Oracle distribution agreement, or other license agreement which has
been executed by you and Oracle and with which you agree to comply. This document and information
contained herein may not be disclosed, copied, reproduced, or distributed to anyone outside Oracle
without prior written consent of Oracle. This document is not part of your license agreement nor can it be
incorporated into any contractual agreement with Oracle or its subsidiaries or affiliates.

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website
at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc

Oracle customers that have purchased support have access to electronic support through My Oracle
Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://
www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

Sample Code

Oracle may provide sample code in SuiteAnswers, the Help Center, User Guides, or elsewhere through
help links. All such sample code is provided "as is” and “as available”, for use only with an authorized
NetSuite Service account, and is made available as a SuiteCloud Technology subject to the SuiteCloud
Terms of Service at www.netsuite.com/tos.

Oracle may modify or remove sample code at any time without notice.

No Excessive Use of the Service

As the Service is a multi-tenant service offering on shared databases, Customer may not use the Service
in excess of limits or thresholds that Oracle considers commercially reasonable for the Service. If Oracle
reasonably concludes that a Customer’s use is excessive and/or will cause immediate or ongoing
performance issues for one or more of Oracle’s other customers, Oracle may slow down or throttle
Customer’s excess use until such time that Customer’s use stays within reasonable limits. If Customer’s
particular usage pattern requires a higher limit or threshold, then the Customer should procure a
subscription to the Service that accommodates a higher limit and/or threshold that more effectively aligns
with the Customer’s actual usage pattern.

Beta Features

The information contained herein is subject to change without notice and is not warranted to be error-
free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it
on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs (including any operating system, integrated software,
any programs embedded, installed or activated on delivered hardware, and modifications of such
programs) and Oracle computer documentation or other Oracle data delivered to or accessed by
U.S. Government end users are "commercial computer software" or “commercial computer software
documentation” pursuant to the applicable Federal Acquisition Regulation and agency-specific
supplemental regulations. As such, the use, reproduction, duplication, release, display, disclosure,
modification, preparation of derivative works, and/or adaptation of i) Oracle programs (including any
operating system, integrated software, any programs embedded, installed or activated on delivered
hardware, and modifications of such programs), ii) Oracle computer documentation and/or iii) other
Oracle data, is subject to the rights and limitations specified in the license contained in the applicable
contract. The terms governing the U.S. Government’s use of Oracle cloud services are defined by the
applicable contract for such services. No other rights are granted to the U.S. Government.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks
of their respective owners.

Intel and Intel Inside are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks
are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD,
Epyc, and the AMD logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a
registered trademark of The Open Group.

Send Us Your Feedback

We'd like to hear your feedback on this document.

Answering the following questions will help us improve our help content:

■ Did you find the information you needed? If not, what was missing?
■ Did you find any errors?
■ Is the information clear?
■ Are the examples correct?
■ Do you need more examples?
■ What did you like most about this document?

Click here to send us your comments. If possible, please provide a page number or section title to identify
the content you're describing.

To report software issues, contact NetSuite Customer Support.

Table of Contents
SuiteTalk SOAP Web Services Platform Overview .......................................................................... 1
SOAP Web Services Overview ................................................................................................ 2
NetSuite WSDL and XSD Structure ......................................................................................... 2
NetSuite WSDL Versioning .................................................................................................. 10
NetSuite Versioning and WSDL Versioning Overview ........................................................... 11
Upgrading WSDL Versions .............................................................................................. 11
Support for Existing WSDL Versions ................................................................................. 13
SOAP Web Services Performance Optimization ....................................................................... 14
SOAP Web Services Governance Overview ............................................................................. 15
Web Services and RESTlet Concurrency Governance ................................................................ 16
Concurrency Governance Limits Based on Service Tiers and SuiteCloud Plus Licenses ............... 17
Concurrency Limit per Integration .................................................................................... 18
Concurrency Governance for Internal Applications .............................................................. 19
Effects of Authentication Method on Concurrency Governance .............................................. 20
Account Concurrency Monitoring Resources ...................................................................... 20
Errors Related to Concurrency Violations ........................................................................... 21
Recommended Actions ................................................................................................... 21
Retrying Failed Web Services Requests ............................................................................. 22
Sample Scenario ............................................................................................................ 22
Frequently Asked Questions ............................................................................................ 22
Glossary ........................................................................................................................... 24
SOAP Web Services Setup ....................................................................................................... 25
SOAP Web Services Quick Start ........................................................................................... 25
Enabling the SOAP Web Services Feature .......................................................................... 25
Setting the Show Internal IDs Preference .......................................................................... 26
Building an Application with Microsoft .NET ....................................................................... 26
Building an Application with Java using Apache Axis ............................................................ 28
Downloading Sample Applications .................................................................................... 30
Capturing SOAP ............................................................................................................ 30
SOAP Web Services Development Considerations ................................................................... 31
Development Considerations Overview ............................................................................. 31
NetSuite Features in SOAP Web Services ........................................................................... 32
SOAP Web Services Reliability Considerations ..................................................................... 32
Effects of Account Configuration in SOAP Web Services ....................................................... 34
Enumerations, Special Characters, and Character Encoding .................................................. 34
Image References in SOAP Web Services .......................................................................... 35
SOAP Web Services Preferences .............................................................................................. 36
Company-Wide Preferences ................................................................................................ 36
One-Time Preferences ........................................................................................................ 37
Request-Level Preferences .............................................................................................. 38
Sample Code ................................................................................................................ 41
Setting the Internal ID Preference ........................................................................................ 42
Caching Behavior in SOAP Web Services ............................................................................... 43
Integration Management ........................................................................................................ 44
Integration Record Overview ............................................................................................... 44
Adding an Integration Record ............................................................................................. 47
Creating an Integration Record ........................................................................................ 48
Auto-Installation of Integration Records ............................................................................ 48
Bundle Installation of Integration Records ......................................................................... 49
Application Details for Client Code ....................................................................................... 50
Sending an Application ID with User Credentials ................................................................ 50
Token-Based Authentication Details .................................................................................. 52
Blocking SOAP Web Services Requests .................................................................................. 61
SOAP Web Services Execution Log ....................................................................................... 61
Distributing Integration Records .......................................................................................... 62
Default Web Services Integrations Record ............................................................................. 64
Using Integration Records in Sandbox Accounts ..................................................................... 64
Token-based Authentication Credentials and Accounts ............................................................ 66
Using Integration Records in Conjunction With SSO Calls ......................................................... 66
Removing Integration Records ............................................................................................. 66
Tracking Changes to Integration Records .............................................................................. 67
Roles and Permissions in SOAP Web Services ............................................................................ 72
Role and Permission Considerations When Developing in SOAP Web Services .............................. 72
Assigning the SOAP Web Services Permission to a Role ........................................................... 73
Setting a Default Role for a SOAP Web Services User .............................................................. 74
Setting a Web Services Only Role for a User .......................................................................... 74
Customer Center, Vendor Center, and Partner Center Roles ..................................................... 75
Internal IDs Associated with Roles ........................................................................................ 76
Records, Fields, Forms, and Sublists in SOAP Web Services ........................................................... 77
Records in SOAP Web Services ............................................................................................ 77
Record Types ................................................................................................................ 77
Search Records ............................................................................................................. 78
Subrecords ................................................................................................................... 78
Using Internal IDs, External IDs, and References ................................................................ 78
External IDs Overview .................................................................................................... 85
Shared Internal and External IDs ..................................................................................... 87
Fields in SOAP Web Services ............................................................................................... 88
Datetime Fields ............................................................................................................. 89
CustomFieldList ............................................................................................................. 91
Custom Fields and Joined Searches .................................................................................. 93
User Defined Lists ......................................................................................................... 93
Enumerated Lists ........................................................................................................... 93
Field Lengths ................................................................................................................ 94
Field Level Errors ........................................................................................................... 94
Required Fields ............................................................................................................. 94
Fields and Operations .................................................................................................... 94
Default Field Values ....................................................................................................... 94
Forms in SOAP Web Services ............................................................................................... 95
Sublists in SOAP Web Services ............................................................................................. 96
Updating Sublists in SOAP Web Services ........................................................................... 97
Sublist Line Numbers ................................................................................................... 102
Deleting All Lines on a Sublist ........................................................................................ 103
Searching a Sublist ...................................................................................................... 103
SOAP Web Services Processing .............................................................................................. 105
Synchronous Versus Asynchronous Request Processing ......................................................... 105
Asynchronous Request Processing ..................................................................................... 105
Checking the Status of an Asynchronous Job .................................................................... 106
Checking for Detailed Results of an Asynchronous Job ....................................................... 107
Monitoring Asynchronous Jobs from the UI ...................................................................... 108
Synchronous Request Processing ....................................................................................... 109
Using the SOAP Web Services Usage Log ........................................................................ 109
Creating Integration Reports ......................................................................................... 110
Handling of Lengthy Requests ....................................................................................... 112
SOAP Web Services Security .................................................................................................. 114
Authentication for SOAP Web Services ................................................................................ 114
Structuring SOAP Requests to Include Authentication Details .............................................. 115
Using the Login Audit Trail ............................................................................................ 116
Authorization for SOAP Web Services .................................................................................. 117
Session Management for SOAP Web Services ....................................................................... 118
Encryption for SOAP Web Services ...................................................................................... 120
Custom Field Security ....................................................................................................... 121
Platform Features ................................................................................................................ 122
Enabling Web Services Concurrent Users with SuiteCloud Plus ................................................ 122
Operations and Their Internal ID Requirements .................................................................... 123
Using SOAP web services to Send Data from a CSV File .......................................................... 127
Searching for SOAP Web Services Log Information ................................................................ 128
SOAP Web Services Operations Search Type ........................................................................ 129
SOAP Web Services Record Processing Search Type .............................................................. 130
Types ................................................................................................................................. 131
Built-in Types .................................................................................................................. 131
Complex Types ................................................................................................................ 131
Custom Field Types .......................................................................................................... 137
Search Types ................................................................................................................... 140
Platform Enumerations ..................................................................................................... 150
SOAP Web Services Operations .............................................................................................. 156
SOAP Web Services Standard Operations ............................................................................ 156
SOAP Web Services List Operations .................................................................................... 158
SOAP Web Services Asynchronous Operations ...................................................................... 158
add ................................................................................................................................ 159
addList ........................................................................................................................... 163
attach / detach ................................................................................................................ 166
changeEmail ................................................................................................................... 170
changePassword .............................................................................................................. 172
checkAsyncStatus ............................................................................................................. 173
delete ............................................................................................................................ 173
deleteList ........................................................................................................................ 176
get ................................................................................................................................ 179
getAccountGovernanceInfo ............................................................................................... 182
getAll ............................................................................................................................. 183
getAsyncResult ................................................................................................................ 185
getBudgetExchangeRate ................................................................................................... 185
getConsolidatedExchangeRate ........................................................................................... 188
getCurrencyRate .............................................................................................................. 191
getCustomizationId .......................................................................................................... 194
getDataCenterUrls ........................................................................................................... 199
getDeleted ...................................................................................................................... 203
getIntegrationGovernanceInfo ........................................................................................... 206
getItemAvailability ............................................................................................................ 207
getList ............................................................................................................................ 210
getPostingTransactionSummary ......................................................................................... 213
getSavedSearch ............................................................................................................... 220
getSelectValue ................................................................................................................. 222
getServerTime ................................................................................................................. 228
initialize / initializeList ....................................................................................................... 229
mapSso .......................................................................................................................... 234
search ............................................................................................................................ 234
Basic Searches in SOAP Web Services ............................................................................. 235
Joined Searches in SOAP Web Services ............................................................................ 237
Advanced Searches in SOAP Web Services ....................................................................... 239
Joining Through Custom Fields ...................................................................................... 248
Setting Valid Search Values ........................................................................................... 252
Setting the anyof, mine, or myteam Filtering Values .......................................................... 252
Searching by lastModifiedDate ....................................................................................... 253
Understanding Sorting in Advanced Search ..................................................................... 254
Search-Related Sample Code ......................................................................................... 256
Searching for a Multi-select Custom Field ........................................................................ 267
Search Issues and Best Practices for SOAP Web Services and SuiteScript ............................... 268
searchMoreWithId ............................................................................................................ 269
ssoLogin ......................................................................................................................... 273
update ........................................................................................................................... 273
updateList ...................................................................................................................... 277
updateInviteeStatus .......................................................................................................... 281
updateInviteeStatusList ..................................................................................................... 283
upsert ............................................................................................................................ 285
upsertList ....................................................................................................................... 288
SOAP Web Services PHP Toolkit ............................................................................................. 293
PHP Toolkit Overview ....................................................................................................... 293
Downloading the PHP Toolkit ............................................................................................ 295
Configuring an Environment for the PHP Toolkit ................................................................... 295
Creating a SOAP Web Services PHP Project .......................................................................... 297
Creating and Submitting Records Using the PHP Toolkit ........................................................ 298
Logging SOAP Requests and Responses Using the PHP Toolkit ............................................... 299
Troubleshooting PHP and SOAP Web Services ...................................................................... 300
SOAP Web Services Error Handling and Error Codes ................................................................. 302
SOAP Web Services Warnings, Errors, and Faults .................................................................. 302
SOAP Faults for Each Operation ......................................................................................... 305
SOAP Fault Status Codes .................................................................................................. 307
Error Status Codes ........................................................................................................... 308
Warning Status Codes ...................................................................................................... 380
SOAP Web Services Frequently Asked Questions (FAQ) ............................................................... 381
SuiteTalk SOAP Web Services Platform Overview 1

SuiteTalk SOAP Web Services Platform

Overview
The SOAP web services platform provides programmatic access to your NetSuite data and business
processes through an XML-based application programming interface (API). Generally speaking, the SOAP
web services platform has the following characteristics:

■ SOAP encoded web services – the Platform uses SOAP-based web services with document style, or
Doc style, encoding.
Doc style encoding consists of message-oriented exchanges where an XML schema specified within
the SOAP message defines the structure of any messages sent between two applications. RPC
exchanges are NOT supported.
■ HTTPS Transport – currently the only transport supported is HTTPS as defined in the WSDL
document.

For a list of NetSuite records that are supported in SOAP web services development, see the help topic
SOAP Web Services Supported Records. To see code samples of all SOAP web services operations, see
SOAP Web Services Operations.

To maintain the highest security standards for connectivity, NetSuite periodically updates server
certificates and the trusted certificate store we use for https requests. We expect client applications
that integrate with NetSuite to use an up-to-date certificate store, to ensure that integrations do not
break because of certificates expiring or changing security standards. This issue typically does not affect
modern browsers because these clients are maintained to use the latest certificates.

Important: Although the following material pertains to the 2022.2 WSDL, NetSuite continues
to support endpoints released prior to 2022.2. For documentation about older endpoints that are
supported, see the help topic SOAP Web Services Archives.

In This Guide
This manual contains the following sections:

SOAP Web Services Setup — provides steps for getting your SOAP web services development
environment set up to create your first service. It also describes how to modify or set SOAP web
services preferences. This section also describes general concepts that pertains to SOAP web services
development.

SOAP Web Services Preferences — provides information on setting company-wide preferences, request
level preferences, search preferences, and setting the Internal ID preference.

Integration Management — provides information about managing external applications by using

integration records.

Roles and Permissions in SOAP Web Services — defines the concept of a role within NetSuite and the
necessity of providing a role ID during authentication. This section also describes how to assign a default
role to a SOAP web services user, as well as how to set a “Web Services Only” role for a user.

Records, Fields, Forms, and Sublists in SOAP Web Services — describes how to work with records, field,
and sublist objects in SOAP web services. This section also provides information on working with custom
forms.

SOAP Web Services Processing — describes how to process requests synchronously versus
asynchronously. Also provided are steps for monitoring your SOAP web services requests.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Overview 2

SOAP Web Services Security — describes all aspects of SOAP web services security and session
management.

Platform Features — describes the Web Services Concurrent License.

Types — describes the various types available in the SOAP web services platform.

SOAP Web Services Operations — describes each operation that can be performed through SOAP web
services and provides SOAP, C# and Java code samples.

SOAP Web Services PHP Toolkit — describes the tools that assist in the development of PHP applications
that interface to the SOAP web services platform.

SOAP Web Services Error Handling and Error Codes — provides tables of possible SOAP faults, fault status
codes and error status codes that can be thrown for a particular request.

SOAP Web Services Overview

SOAP web services are Extensible Markup Language (XML) applications mapped to programs, objects,
databases or complex business functions. They utilize a standardized XML messaging system to send
or receive requests to authorized parties over the internet. Businesses can implement SOAP web
services to provide standards based processes that can be utilized by other organizations or integrated
with business partner processes. Since the programming logic encapsulated by each Web service is
independent of any one platform or technology set, SOAP web services provide an independence and
flexibility for integration across and between businesses.

The following protocols are used to publish, expose or access SOAP web services:

■ WSDL (Web Services Description Language): a WSDL file exposes a Web service interface, interaction
patterns and protocol mapping. WSDL can be readily interpreted by other applications, systems and
platforms.
■ UDDI (Universal Description, Discovery and Integration): A Web Service can be categorized and
registered in a UDDI Registry so that applications can locate it and retrieve its WSDL. Currently
NetSuite does NOT provide a UDDI registry.
■ SOAP (Simple Object Access Protocol): A Web Service can use the SOAP messaging format to define an
envelope for SOAP web services communication via HTTP, HTTPs or other transport layers.

Using SOAP web services, you can integrate existing business functions within your organization to
NetSuite through the use of web services. SOAP web services can be invoked in real-time to perform
operations such as retrieving, adding, updating, and deleting data.

NetSuite WSDL and XSD Structure

SOAP web services use single WSDL file that describes all supported operations and messages. You can
access that file at the following link:

https://webservices.netsuite.com/wsdl/v2022_2_0/netsuite.wsdl

In this link, v2022_2_0 reflects the WSDL version.

NetSuite defines WSDL versioning, the location of schemas, namespaces, and the endpoint as follows:

WSDL: https://webservices.netsuite.com/wsdl/v2022_2_0/netsuite.wsdl

SuiteTalk SOAP Web Services Platform Guide

NetSuite WSDL and XSD Structure 3

<xsd:import namespace="urn:core_2022_2_0.platform.webservices.netsuite.com" schemaLocation="https://webservices.netsuit

e.com/xsd/platform/v2022_2_0/core.xsd"/>
<port name="NetSuitePort" binding="tns:NetSuiteBinding">
<soap:address location="https://webservices.netsuite.com/services/NetSuitePort_2022_2_0" />
</port>

Note: For more information on WSDL versioning, upgrading, and testing, see NetSuite WSDL
Versioning. For information on WSDLs that pre-date 2022.2, see the help topic SOAP Web Services
Archives.

The WSDL is composed of numerous NetSuite-specific types that are defined in related XSDs. Each XSD
URL has an alias that can be used as a reference to the corresponding XSD file. The following tables show
the organization of the XSD files.

Important: NetSuite hosts customer accounts in multiple data centers. For that reason, the
correct URL for SOAP web services access varies depending on the data center hosting the
account.

For details about dynamic discovery of URLs, see the help topic Dynamic Discovery of URLs for
SOAP Web Services and RESTlet Clients.

Your integration must incorporate logic that dynamically determines the correct URL. You should
use the getDataCenterUrls operation to dynamically discover the correct URL. You can also use
the DataCenterUrls REST Service to dynamically discover the correct domain URLs.

Messaging XSD Files

These files provide descriptions for the base SOAP web services functions used by all operations. For API
documentation on each operation, see SOAP Web Services Operations.

URL Schema Alias Notes

https://webservices.netsuite.com/xsd/ platformCommon This file also includes descriptions for the following
platform/v2022_2_0/common.xsd subrecords:

■ Address
■ InventoryDetail
■ LandedCost

https://webservices.netsuite.com/xsd/ platformCore Among other elements, this file includes

platform/v2022_2_0/core.xsd descriptions for the following complex types, which
are used for authentication:

■ Passport
■ SsoPassport
■ TokenPassport

https://webservices.netsuite.com/xsd/ platformFaults —
platform/v2022_2_0/faults.xsd

https://webservices.netsuite.com/xsd/ platformMsgs —
platform/v2022_2_0/messages.xsd

SuiteTalk SOAP Web Services Platform Guide

NetSuite WSDL and XSD Structure 4

Record Type Definitions

The following XSD files provide descriptions for each record type in NetSuite. For field reference
information on each record, see the help topic SuiteTalk SOAP Records Overview. For general information
on working with records in SOAP web services, see Records in SOAP Web Services.

URL Schema Alias Record Types

https://webservices.netsuite.com/xsd/lists/v2022_2_ actSched ContactCategory

0/scheduling.xsd CustomerCategory
SalesRole
PriceLevel
WinLossReason
Term
NoteType
PaymentMethod
CalendarEvent
CalendarEventSearch
CalendarEventSearchAdvanced
Task
TaskSearch
TaskSearchAdvanced
PhoneCall
PhoneCallSearch
PhoneCallSearchAdvanced
ProjectTask
Resource Allocation

https://webservices.netsuite.com/xsd/transactions/ demandPlanning ItemDemandPlan

v2022_2_0/demandPlanning.xsd ItemSupplyPlan

https://webservices.netsuite.com/xsd/documents/ docfileCab File

v2022_2_0/fileCabinet.xsd FileSearch
FileSearchAdvanced
Folder
FolderSearch
FolderSearchAdvanced

https://webservices.netsuite.com/xsd/general/ generalComm Note

v2022_2_0/communication.xsd NoteSearch
NoteSearchAdvanced
Message
MessageSearch
MessageSearchAdvanced

https://webservices.netsuite.com/xsd/lists/v2022_2_ listAcct Billing Schedule

0/accounting.xsd Bill of Materials (BOM)
BOM Revision
ContactCategory
CustomerCategory
SalesRole
PriceLevel
WinLossReason
Term
NoteType
PaymentMethod
LeadSource
Assembly Item (BOM Item)
DescriptionItem
DiscountItem
Download Item
GeneralToken
GiftCertificateItem
InventoryItem

SuiteTalk SOAP Web Services Platform Guide

NetSuite WSDL and XSD Structure 5

URL Schema Alias Record Types

ItemSearch
ItemSearchAdvanced
Kit/Package Item
Lot Numbered Assembly Item
Lot Numbered Inventory Item
MerchandiseHierarchyNode
MarkupItem
NonInventoryPurchaseItem
NonInventoryResaleItem
NonInventorySaleItem
OtherChargePurchaseItem
OtherChargeResaleItem
OtherChargeSaleItem
PaymentCard
PaymentCardToken
PaymentItem
SerializedAssemblyItem
Serialized Inventory Item
ServicePurchaseItem
ServiceResaleItem
ServiceSaleItem
SubtotalItem
Currency
ExpenseCategory
Account
AccountSearch
AccountSearchAdvanced
AccountingPeriod
Bin
BinSearch
BinSearchAdvanced
Classification
ClassificationSearch
ClassificationSearchAdvanced
Department
DepartmentSearch
DepartmentSearchAdvanced
Expense Category
Gift Certificate
FairValuePrice

https://webservices.netsuite.com/xsd/lists/v2022_2_ listAcct GiftCertificateSearch

0/accounting.xsd GiftCertificateSearchAdvanced
GlobalAccountMapping
Inventory Number
ItemAccountMapping
Location
LocationSearch
LocationSearchAdvanced
Nexus
Revenue Recognition Schedule
Revenue Recognition Template
Sales Tax ItemItemSearchAdvanced
ContactRole
Bin
SalesTaxItem
TaxAcct
TaxGroup
TaxType
Subsidiary
SubsidiarySearch
SubsidiarySearchAdvanced
UnitsType
PartnerCategory

SuiteTalk SOAP Web Services Platform Guide

NetSuite WSDL and XSD Structure 6

URL Schema Alias Record Types

VendorCategory

https://webservices.netsuite.com/xsd/lists/v2022_2_ listEmp Employee

0/employees.xsd EmployeeSearch
EmployeeSearchAdvanced
HCM Job

https://webservices.netsuite.com/xsd/lists/v2022_2_ listMkt Campaign

0/marketing.xsd CampaignSearch
CampaignSearchAdvanced
CampaignCategory
CampaignAudience
CampaignFamily
CampaignSearchEngine
CampaignChannel
CampaignOffer
CampaignResponse
CampaignVertical
CampaignSubscription
PromotionCode
PromotionCodeSearch
PromotionCodeSearchAdvanced

https://webservices.netsuite.com/xsd/lists/v2022_2_ listRel Billing Account

0/relationships.xsd Contact
ContactSearch
ContactSearchAdvanced
Customer
CustomerSearch
CustomerSearchAdvanced
CustomerStatus
CustomerSubsidiaryRelationship
Partner
PartnerSearch
PartnerSearchAdvanced
Vendor
VendorSearch
VendorSearchAdvanced
VendorSubsidiaryRelationship
EntityGroup
EntityGroupSearch
EntityGroupSearchAdvanced
Job
JobSearch
JobSearchAdvanced
JobType
JobStatus

https://webservices.netsuite.com/xsd/lists/v2022_2_ listScm ManufacturingCostTemplate

0/supplyChain.xsd ManufacturingOperationTask
ManufacturingRouting

https://webservices.netsuite.com/xsd/lists/v2022_2_ listSite SiteCategory

0/website.xsd SiteCategorySearch
SiteCategorySearchAdvanced

https://webservices.netsuite.com/xsd/lists/v2022_2_ listSupport SupportCase

0/support.xsd SupportCaseSearch
SupportCaseSearchAdvanced
SupportCaseStatus
SupportCaseType
SupportCaseOrigin
SupportCaseIssue
SupportCasePriority

SuiteTalk SOAP Web Services Platform Guide

NetSuite WSDL and XSD Structure 7

URL Schema Alias Record Types

Solution
SolutionSearch
SolutionSearchAdvanced
Topic
TopicSearch
TopicSearchAdvanced
Issue
IssueSearch
IssueSearchAdvanced

https://webservices.netsuite.com/xsd/setup/v2022_ setupCustom CustomRecord

2_0/customization.xsd CustomRecordSearch
CustomRecordSearchAdvanced
CustomList
CustomRecordType
EntityCustomField
CrmCustomField
OtherCustomField
ItemCustomField
TransactionBodyCustomField
TransactionColumnCustomField
ItemOptionCustomField
CustomRecordCustomField
CustomTransaction
CustomSegment

https://webservices.netsuite.com/xsd/transactions/ tranBank Check

v2022_2_0/bank.xsd Deposit

https://webservices.netsuite.com/xsd/transactions/ tranCust CashRefund

v2022_2_0/customers.xsd Charge
CustomerPayment
ReturnAuthorization
CreditMemo
CustomerRefund
CustomerDeposit
DepositApplication

https://webservices.netsuite.com/xsd/transactions/ tranInvt InventoryAdjustment

v2022_2_0/inventory.xsd InventoryCostRevaluation
AssemblyBuild
AssemblyUnbuild
WorkOrder
WorkOrderClose
WorkOrderIssue
WorkOrderCompletionOperation

https://webservices.netsuite.com/xsd/transactions/ tranEmp TimeBill

v2022_2_0/employees.xsd TimeBillSearch
TimeBillSearchAdvanced
ExpenseReport
TimeEntry
Timesheet
Paycheck

https://webservices.netsuite.com/xsd/transactions/ tranFin Budget

v2022_2_0/financial.xsd BudgetSearch
BudgetSearchAdvanced

https://webservices.netsuite.com/xsd/transactions/ tranGeneral JournalEntry

v2022_2_0/general.xsd InterCompanyJournalEntry
StatisticalJournalEntry
AdvIntercompanyJournalEntry

SuiteTalk SOAP Web Services Platform Guide

NetSuite WSDL and XSD Structure 8

URL Schema Alias Record Types

https://webservices.netsuite.com/xsd/transactions/ tranPurch VendorBill

v2022_2_0/purchases.xsd PurchaseOrder
ItemReceipt
VendorPayment
VendorCredit
Purchase/Requisition
InboundShipment

https://webservices.netsuite.com/xsd/transactions/ tranSales AccountingTransactionSearch

v2022_2_0/sales.xsd AccountingTransactionSearchAdvanced
Opportunity
OpportunitySearch
OpportunitySearchAdvanced
SalesOrder
TransactionSearch
TransactionSearchAdvanced
ItemFulfillment
Invoice
CashSale
Estimate

System Constants XSD Files

These files provide constant values for the corresponding types in the business records XSD files.

URL Schema Alias

https://webservices.netsuite.com/xsd/lists/v2022_2_0/schedulingTypes.xsd actSchedTyp

https://webservices.netsuite.com/xsd/transactions/v2022_2_0/demandPlanning.xsd demandPlanningTyp

https://webservices.netsuite.com/xsd/documents/v2022_2_0/fileCabinetTypes.xsd docFileCabTyp

https://webservices.netsuite.com/xsd/general/v2022_2_0/communicationTypes.xsd generalCommTyp

https://webservices.netsuite.com/xsd/transactions/v2022_2_0/inventoryTypes.xsd invtTyp

https://webservices.netsuite.com/xsd/lists/v2022_2_0/accountingTypes.xsd listAcctTyp

https://webservices.netsuite.com/xsd/lists/v2022_2_0/employeeTypes.xsd listEmpTyp

https://webservices.netsuite.com/xsd/lists/v2022_2_0/marketingTypes.xsd listMktTyp

https://webservices.netsuite.com/xsd/lists/v2022_2_0/relationshipTypes.xsd listRelTyp

https://webservices.netsuite.com/xsd/lists/v2022_2_0/supplyChainTypes.xsd listScmTyp

https://webservices.netsuite.com/xsd/lists/v2022_2_0/supportTypes.xsd listSupportTyp

https://webservices.netsuite.com/xsd/platform/v2022_2_0/coreTypes.xsd platformCoreTyp

https://webservices.netsuite.com/xsd/platform/v2022_2_0/faultTypes.xsd platformFaultsTyp

https://webservices.netsuite.com/xsd/setup/v2022_2_0/customizationTypes.xsd setupCustomTyp

https://webservices.netsuite.com/xsd/transactions/v2022_2_0/saleTypes.xsd tranSalesTyp

Example
For example, the addRequest message type has three levels of referencing.

SuiteTalk SOAP Web Services Platform Guide

NetSuite WSDL and XSD Structure 9

In the WSDL file, the addRequest message is defined as:

The element called platformMsgs:add is defined in the platformMsgs XSD file. In this case, the
platformMsgs alias refers to the xsd file at:

https://webservices.netsuite.com/xsd/platform/v2022_2_0/messages.xsd

In this file, the addRequest element is defined again as:

Again there is a reference that is not contained in this XSD file called platformCore:Record. The
platformCore alias refers to the XSD file at:

https://webservices.netsuite.com/xsd/platform/v2022_2_0/core.xsd

The abstract type Record is defined as:

<complexType name="Record" abstract="true">

SuiteTalk SOAP Web Services Platform Guide

NetSuite WSDL and XSD Structure 10

Note: In SOAP web services, Record is the base for all other NetSuite record types.

XML Samples of Supported Variations of a SOAP Request

Here you can see 3 variations of a SOAP request that are supported by NetSuite.

Variation A
In this variation namespace aliases are always used, as suggested by the official WSDL documentation.

<soapenv:Body>
<platformMsgs:initialize>
<platformMsgs:initializeRecord>
<platformCore:type>itemReceipt</platformCore:type>
<platformCore:rference type="purchaseOrder" internalId="123"/>
</platformMsgs:initializeRecord>
</platformMsgs:initialize>
</soapenv:Body>

Variation B
In this variation namespace aliases are used only when needed.

<soapenv:Body>
<platformMsgs:initialize xmlns:platformMsgs="urn:messages_2019_1.platform.webservices.netsuite.com">
<platformMsgs:initializeRecord xmlns:platformCore="urn:core_2019_1.platform.webservices.netsuite.com">
<platformCore:type>itemReceipt</platformCore:type>
<platformCore:reference type="purchaseOrder" internalId="123"/>
</platformMsgs:initializeRecord>
</platformMsgs:initialize>
</soapenv:Body>

Variation C
In this variation, the namespace aliases are used again only when necessary.

<soapenv:Body>
<initialize xmlns="urn:messages_2019_1.platform.webservices.netsuite.com">
<initializeRecord>
<urn1:type xmlns:urn1="urn:core_2019_1.platform.webservices.netsuite.com">itemReceipt</urn1:type>
<urn2:reference intelId="123" type="purchaseOrder" xmlns:urn2="urn:core_2019_1.platform.webservices.netsuite.com:"/>
</initializeRecord>
</initialize>
</soapenv:Body>

NetSuite WSDL Versioning

The following topics provide information on NetSuite WSDL versioning, upgrading to a new WSDL version,
and things to consider when your NetSuite account is upgraded. If you are new to SOAP web services
development, it is recommended that you read these topics in order:

■ NetSuite Versioning and WSDL Versioning Overview

■ Upgrading WSDL Versions

SuiteTalk SOAP Web Services Platform Guide

NetSuite WSDL Versioning 11

■ Support for Existing WSDL Versions

■ SOAP Web Services Archives

NetSuite Versioning and WSDL Versioning Overview

The naming convention for NetSuite versions and WSDL versions are the same. For example, for 2022.2,
there is an accompanying 2022_2 version of the WSDL, as shown in the following WSDL URL:

https://webservices.netsuite.com/wsdl/v2022_2_0/netsuite.wsdl

NetSuite WSDL versioning denotes:

■ the major version: v2022_2

■ the minor or patch version: _0

Generally speaking, the WSDL version that accompanies a NetSuite release incorporates much of the
new functionality offered in the NetSuite upgrade. For example, if new workflows or new records are
introduced in a NetSuite upgrade, the accompanying WSDL often includes new operations or records
to support the NetSuite enhancements. In some releases, a new WSDL also includes enhancements
to the SOAP web services platform itself. These enhancements are independent of NetSuite product
enhancements.

Be aware that when your NetSuite account is upgraded, you do not have to upgrade your WSDL to
the supporting NetSuite version. For example, you may still use 2021.1 of the WSDL in conjunction with
a NetSuite account that has been upgraded to 2022.2. For more information, see Upgrading WSDL
Versions.

With each new release of NetSuite (and new WSDL version), it is recommended that you read the relevant
portion of the Sneak Peeks and the Release Notes that come with the release. These documents list all of
the new functionality and any schema bug fixes offered in the latest WSDL.

Upgrading WSDL Versions

NetSuite customers typically upgrade their WSDL when a newer version includes functionality that
enables them to meet a particular business need. They will also upgrade their WSDL when the one they
are currently using is going to be retired by NetSuite (see Support for Existing WSDL Versions for details).
If you do plan to upgrade the WSDL you are using, NetSuite strongly recommends that you upgrade to
the latest available version to prolong the life cycle for your integrated application.

Important: You are not required to upgrade your WSDL when your NetSuite account is
upgraded. However, when your account is upgraded, you should re-test all existing integrations to
ensure they work against the latest version of NetSuite (see Testing After a NetSuite Upgrade for
details).

After upgrading your WSDL version, any API incompatibilities between the new and old versions will be
displayed in your development environment. You will be unable to proceed to unit testing until you have
fixed any IDE compilation errors. Consequently, most WSDL upgrade issues are usually addressed during
development.

Upgrading your WSDL version may require you to re-code parts of your integrated application to be
compatible with the latest version of the NetSuite product. Re-coding may be due to any of the following
reasons:

■ a new required field has been added to NetSuite

■ a field that was optional in previous versions of NetSuite becomes required in the latest version

SuiteTalk SOAP Web Services Platform Guide

NetSuite WSDL Versioning 12

■ a field that is referenced in your integration has been removed from NetSuite
■ the data type for a field has changed
■ the method signature changes for a SOAP web services operation that is used in your integration

Note: See Working with the Araxis Merge Diff File for information on how to use Araxis to see
the changes made from one WSDL version to the next. You can also get an idea of the types of
changes you must make by reading the release notes from the endpoint you are currently using
onwards to the last release of the WSDL.

Testing After a WSDL Upgrade

If you are upgrading your WSDL to make use of a particular NetSuite enhancement, it is recommended
that you use the UI to learn how the feature works. In most cases, NetSuite SOAP web services is the
programmatic equivalent of the NetSuite UI. Therefore, if you know how a feature works in the UI, your
learning curve for understanding how to leverage the feature in SOAP web services will be minimized.

Be aware that WSDL upgrades may take considerable planning and testing. Consequently, you may
decide to upgrade only when you know your version is going to be retired. (See Support for Existing
WSDL Versions for more information.)

Testing After a NetSuite Upgrade

NetSuite strives to maintain backward compatibility from one NetSuite version to the next. However, your
integration may rely on unique workflows that might break when your NetSuite account is upgraded.
Therefore, NetSuite recommends that you test all existing integrations in your Release Preview account
for the NetSuite upgrade and report any issues you may find to ensure a smooth upgrade of your
production account.

In your Release Preview account, you also must modify the WSDL references you are using in your
application to point to one of the following endpoints (based on the endpoint you are currently using):

Note: As of 2018.1, all customers access the UI for their Release Preview account from https://
system.netsuite.com. Initially, only users with an Administrator role have access to the Release
Preview account. For more information, see the help topic The Release Preview Account.

■ https://webservices.netsuite.com/wsdl/v2022_2_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2022_1_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2021_2_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2021_1_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2020_2_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2020_1_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2019_2_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2019_1_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2018_2_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2018_1_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2017_2_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2017_1_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2016_2_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2016_1_0/netsuite.wsdl

SuiteTalk SOAP Web Services Platform Guide

NetSuite WSDL Versioning 13

■ https://webservices.netsuite.com/wsdl/v2015_2_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2015_1_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2014_2_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2014_1_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2013_2_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2013_1_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2012_2_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2012_1_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2011_2_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2011_1_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2010_2_0/netsuite.wsdl
■ https://webservices.netsuite.com/wsdl/v2010_1_0/netsuite.wsdl

Note: If you are engaged with a partner for any of your SOAP web services integrations, it is
recommended that you contact them and inform them of when your Release Preview account will
be available. They can then set up a time with you and a test plan for the integration.

Working with the Araxis Merge Diff File

To help you see the differences between the latest WSDL and the version that preceded it, refer to
the Araxis diff file provided in the release notes for each release. When reviewing the diff file, start by
investigating the records you are currently using. For example, if your SOAP web services application
interacts with customer and vendor records, use the diff file to review any changes made to these
records. These changes may include added or removed fields or field (element) data type changes.

If you want to compare the latest WSDL with the version you are currently using, you can download Araxis
and compare your own version to any other version listed on the Developer Portal.

For more information on using the Araxis diff file to review NetSuite WSDL changes, see the help topic
Araxis Merge Diff File for the 2022.2 Endpoint in the 2022.2 Release Notes.

Support for Existing WSDL Versions

At any time, the six latest endpoints are supported. For example, with the 2022.2 endpoint generally
available, the following WSDL versions are supported:

■ 2022.2
■ 2022.1
■ 2021.2
■ 2021.1
■ 2020.2
■ 2020.1

If you use an older version, NetSuite recommends that you upgrade to the latest WSDL version.

NetSuite also makes the eight additional endpoint versions from the previous four years available without
support. This means that in addition to the fully supported endpoints listed above, the following eight
endpoints also remain available:

■ 2019.2

SuiteTalk SOAP Web Services Platform Guide

NetSuite WSDL Versioning 14

■ 2019.1
■ 2018.2
■ 2018.1
■ 2017.2
■ 2017.1
■ 2016.2
■ 2016.1

Important: Starting from NetSuite version 2019.1, endpoints that are 15 and more versions
older will be retired.

After your NetSuite implementation is upgraded to a newer version, retired endpoints are not available
anymore.

Consider the following information when you are planning to upgrade to a newer endpoint.

■ When your account is upgraded to a new version, support stops for the last endpoint on the list of
supported endpoints, and the last endpoint on the list of available endpoints is retired.
■ If you do not upgrade to a newer endpoint when your WSDL is retired, your integrations will cease to
work because the endpoint for that version will not be available.

SOAP Web Services Performance Optimization

Consider the following guidelines to optimize SOAP web services performance:

■ Use a Web Services Only form to minimize time to retrieve field values, included sourced fields and
formula fields. For more information, see Forms in SOAP Web Services.
■ Advanced Search allows reference to an existing saved search. For more information, see Reference
Existing Saved Searches.
■ Use context API to run minimal user event scripts for real time integration. For more information, see
the help topic Specifying SOAP Web Services Context.
■ Disable SuiteScript and workflow triggers for historical data imports. For more information, see
runServerSuiteScriptAndWorkflowTriggers.
■ Use list operations when possible. This approach works with multiple record types, for example,
addList Customer then Sales Order. The ideal list size is around 20 transactions, 50 entities or items,
and 100 custom records. For more information, see SOAP Web Services List Operations.
■ Use asynchronous operations whenever possible. For more information, see SOAP Web Services
Processing.
■ To benefit from increased concurrency, use token-based authentication. For SOAP web services that
use token-based authentication (TBA) and for RESTlets, there are no per-user limits for concurrent
requests, if the concurrency governance is enabled. For more information, see Web Services and
RESTlet Concurrency Governance. This topic also contains a decision chart to help you decide whether
you need more SuiteCloud Plus licenses to achieve optimal results.
■ Optimize system notes logging.
□ Disable System Notes for custom fields and for custom record types. (SOAP preference). For more
information, see disableSystemNotesForCustomFields.
□ Log System Notes on update only (general preference). For more information, see the help topic
Setting General Account Preferences.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Performance Optimization 15

■ You can use Application Performance Management (APM) to monitor and analyze SOAP web services
performance. For information, see the help topic Analyzing Web Services Performance.

SOAP Web Services Governance Overview

To optimize NetSuite application and database servers, the system employs certain mechanisms to
control the consumption of SOAP web services. These mechanisms ensure the following:

■ Requests are monitored and controlled to ensure that the user experience is not excessively impacted.
■ The burden of heavy SOAP web services users is not shared among all users.

NetSuite SOAP web services governance includes:

■ Record limiting (see Understanding Record Limiting)

■ Request limiting (see Understanding Request Limiting)

Note: For information on 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

Limits exist for the following:

■ The number of records that can be included in a list operation.

■ The number of records that can be included 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.

The limit varies depending on whether the operation is synchronous or asynchronous.

Synchronous Operations

Operation or parameter Minimum Record Count Maximum Record Count

(on a per request basis)

addList — 200

deleteList — 200

getList — 1000

getItemAvailability — 10000

updateList — 100

upsertList — 100

pageSize parameter of searchPreferences complex type, 5 1000

when used in synchronous searches

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Governance Overview 16

Asynchronous Operations

Operation or parameter Minimum Record Count Record Count

(on a per request basis)

asyncAddList — 400

asyncGetList — 2000

asyncUpdateList — 200

asyncUpsertList — 200

asyncDeleteList — 400

pageSize parameter of searchPreferences complex type, when 5 2000

used in asynchronous searches

Note: For details on asynchronous processing, see Asynchronous Request Processing.

Understanding Request Limiting

Request limiting pertains to the size of your SOAP request. The size of a request cannot exceed 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 on exceptions, refer to SOAP Web Services Error Handling and Error Codes.

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

Web Services and RESTlet Concurrency

Governance
NetSuite Integration Governance

In the past, concurrency for web services and RESTlets was governed separately per user and
authentication method. As of 2017.2, web services and RESTlet concurrency also began to be governed
per account. The account governance limit applies to the combined total of web services and RESTlet
requests.

For a visual overview of the governance model, see the Concurrency Governance Cheat Sheet PDF
file.

For a visual overview of the governance model introduced in June 2020, see the New Concurrency
Governance Cheat Sheet PDF file.

For more details, see each of the topics listed here:

SuiteTalk SOAP Web Services Platform Guide

Web Services and RESTlet Concurrency Governance 17

■ Concurrency Governance Limits Based on Service Tiers and SuiteCloud Plus Licenses
■ Concurrency Governance for Internal Applications
■ Effects of Authentication Method on Concurrency Governance
■ Account Concurrency Monitoring Resources
■ Errors Related to Concurrency Violations
■ Recommended Actions
■ Retrying Failed Web Services Requests
■ Sample Scenario
■ Frequently Asked Questions

Concurrency Governance Limits Based on Service Tiers

and SuiteCloud Plus Licenses
The governance limit for concurrent requests is based on the service tier and the number of SuiteCloud
Plus licenses available for your each production, sandbox, and release preview accounts. The base limit is
increased by 10 for each SuiteCloud Plus license.

The following table and example show the existing service tiers.

Service Tier Account Base Limit

Shared, 3 5

2 10

1, 1+ 15

0 20

For example, if you are on Service Tier 1 and you have five SuiteCloud Plus licenses, the limit for
concurrent requests in your production account is 65 (15+5*10). If you are on shared service with one
SuiteCloud Plus license, your account limit is 15 (5+10).

The following table and example show the service tiers that apply to new contracts as of June 2020.

Service Tier Account Base Limit

Standard 5

Premium 15

Enterprise 20

Ultimate 20

For example, if you are on Service Tier Ultimate and you have five SuiteCloud Plus licenses, the limit for
concurrent requests in your production account is 70 (20+5*10). If you are on the standard service tier
with one SuiteCloud Plus license, your account limit is 15 (5+10).

Important: For development and partner accounts, the base limit is always five, and the limit
does not scale with the number of SuiteCloud Plus licenses.

The account concurrency limit for your account is displayed on the Integration Governance page. You can
access this page at Setup > Integration > Integration Management > Integration Governance.

SuiteTalk SOAP Web Services Platform Guide

Web Services and RESTlet Concurrency Governance 18

For information about service tiers, see the help topic NetSuite Service Tiers.

For more information, see the help topic SuiteCloud Plus Settings.

To help you decide whether you need more SuiteCloud Plus licenses, see the following decision tree.

Concurrency Limit per Integration

Concurrency limit per integration allows you to allocate part of your account's concurrent requests limit to
specific integrations.

You can use concurrency limit per integration to ensure that:

SuiteTalk SOAP Web Services Platform Guide

Web Services and RESTlet Concurrency Governance 19

■ The specific integration to which this limit is allocated has the required bandwidth to function.
■ The specific integration to which this limit is allocated does not use a too big part of your limit,
blocking your other applications from working fluently.

To see and manage your available concurrency limit, go to Setup > Integration > Integration Management
> Integration Governance.

Under Concurrency Usage you can view the account concurrency limit and the unallocated concurrency
limit

Note: The minimum unallocated concurrency limit value is one.

Under Concurrency Limits per Integration, you can see a list with all integration records, their state and
the concurrency limit that has been allocated to them. If you are the owner of the integration, you can
also see the Application ID.

When allocating part of your account's concurrency limit to one application, you reduce the available
concurrency limit for other integrations, which do not have a specific limit.

Important: You should only use this feature if you have a good reason to do so. For example,
you may have an external application that you do not fully control, and which occasionally sends
a high number of concurrent requests. This sudden increase in concurrent requests can cause
issues to other integrations. With this feature, you can now limit the number of concurrent
requests allowed for this application to protect the functionality of the other integrations. It is a
best practice to have one account concurrency limit, without limits for each integration.

To manage the concurrency limit per integration, click the name of the integration to open the integration
record.

Here you can enter the value for the concurrency limit you want to allocate in the Concurrency Limit field.
In the MAX Concurrency Limit field, you can see the unallocated concurrency limit that is available to
allocate.

Note: The value of the MAX Concurrency Limit field is always one less than the total unallocated
concurrency limit of the account.

If your subscription for company Service Tier or the number of SuiteCloud Plus licenses expires, your
account concurrency limit will reset to the default value. If the account concurrency limit decreases by
that to a value lower than the sum of the allocated concurrency limit per integration, the administrator of
the account receives a notification per email. Also, the first user to access Integration Governance sees a
warning text on the top of the page.

Concurrency Governance for Internal Applications

Certain internal applications are excluded from the scope of concurrency governance. Requests from the
specified internal applications do not count towards your concurrency limit.

Additionally, requests from these applications are not included in the usage data displayed on the
APM web services performance dashboard, the APM Concurrency Monitor tool, and the Integration
Governance page. For information about these tools, see Account Concurrency Monitoring Resources.

Requests from these applications are not included in the usage data displayed on the Integration
Governance page. For information about ways to monitor your concurrency usage, see Account
Concurrency Monitoring Resources.

The following internal applications and SuiteApps are excluded from the scope of concurrency
governance:

SuiteTalk SOAP Web Services Platform Guide

Web Services and RESTlet Concurrency Governance 20

■ OpenAir
■ NSPOS – See the help topic NetSuite Point of Sale (NSPOS).
■ NetSuite for Outlook – See the help topic NetSuite for Outlook.

Important: The list of excluded internal applications is subject to change.

Effects of Authentication Method on Concurrency

Governance
For SOAP web services that use the login and logout operations or request-level credentials for
authentication, the existing governance limits per user are maintained. For web services that use token-
based authentication (TBA) and for RESTlets, there are no per-user limits for concurrent requests, if the
concurrency governance is enabled.

For details about different authentication types, see Authentication for SOAP Web Services.

Note: For sessions authenticated with Outbound Single Sign-on (SuiteSignOn), concurrency is
governed per user and additionally per account.

The new governance model may provide increased concurrency for web services integrations that use
TBA. This change also means more limits on RESTlet integrations, which are capped at the maximum
concurrency defined for an account.

If you exceed the limit for concurrent requests, an error is thrown.

Account Concurrency Monitoring Resources

To find information about your account concurrency limits and concurrent usage, check the following
resources.

Important: When your account is moved to a new data center built on Oracle Cloud
Infrastructure (OCI), usage logs will start to be collected on OCI only. After your account and your
logs are moved to OCI, inaccurate values will be displayed about concurrency usage for a period
of 30 days. The displayed values will not be calculated from data from the last 30 days, but from
data that is stored since the date of the move. Consequently, the data about concurrency usage
displayed in the Peak Concurrency, Rejected Requests, Total Requests, and Rejected Requests
Ratio fields at Setup > Integration > Integration Management > Integration Governance can be
inaccurate. Similarly, the APM web services performance dashboard can contain inaccurate data.
After 30 days, the correct concurrency usage data will be shown again. For more information
about account moves to OCI, see the help topic Account Move to OCI FAQ.

■ The Integration Governance page, available at Setup > Integration > Integration Management >
Integration Governance displays information about whether account concurrency governance is
enabled in your account, and also contains information about the account concurrency limit and the
number and ratio of total and rejected requests.
■ The SOAP Web Services Execution Log and SOAP Web Services Usage Log contain information about
the requests that were rejected due to a violation of concurrency governance limits. For information
about accessing the logs, see SOAP Web Services Execution Log and Using the SOAP Web Services
Usage Log.
■ The results of a SOAP web services operations search also contain information about web services
operations that are rejected due to concurrency violation. For more information, see SOAP Web
Services Operations Search Type.

SuiteTalk SOAP Web Services Platform Guide

Web Services and RESTlet Concurrency Governance 21

■ The Application Performance Management (APM) SuiteApp includes a web services performance
dashboard. You can use this dashboard to monitor SOAP web services record processing and the
status of SOAP web services operations, and to find out details about the operations that were
rejected. For more information, see the help topic Application Performance Management (APM). For
information about monitoring SOAP web services operations using APM, see the help topic Analyzing
Web Services Performance.
■ The Application Performance Management (APM) SuiteApp also includes a Concurrency Monitor tool.
You can use the Concurrency Monitor tool to monitor web services and RESTlet integrations with
respect to your account concurrency limits. This dashboard enables you to view and optimize the
scheduling of your integrations so that you can optimize the usage of your SuiteCloud plus licenses.
The dashboard also shows you your exceeded concurrency data to help you decide if you need to
add SuiteCloud Plus licenses to enhance your performance. For more information, see the help topic
Application Performance Management (APM). For more information about the Concurrency Monitor
tool, see the help topic Monitoring Web Services and RESTlet Concurrency.

Note: For information about viewing rejected RESTlet requests, see the help topic Viewing a List
of Script Execution Logs.

Errors Related to Concurrency Violations

RESTlet and web services requests that are rejected because they exceed the concurrency governance
limit result in one of the following server responses.

For RESTlet requests, the following errors occur:

■ HTTP error code: 400 Bad Request

■ SuiteScript error code: SSS_REQUEST_LIMIT_EXCEEDED

For web services requests, the following SOAP faults occur:

Authentication Type SOAP Fault Error Message

Request-level credentials ExceededRequestLimitFault WS_CONCUR_SESSION_DISALLWD

Login and logout operations

TBA ExceededConcurrentRequestLimitFault WS_REQUEST_BLOCKED

Recommended Actions
Analyze the frequency and level of concurrency peaks, and consider rescheduling requests to be outside
of regular peak times.

Review your client applications to ensure they can handle the error codes. The following sample is an
example of how you might handle the error codes programmatically.

int i = 0;
int maxAttempts = 5; // try it 5 times, then fail for good

while (i < maxAttempts)

{
response = doWSCall();
isSuccess = response.getIsSuccess();
errorMsg = response.getErrorMsg();

if (isSuccess == false && (errorMsg == WS_CONCUR_SESSION_DISALLWD || errorMsg == WS_REQUEST_BLOCKED))

{

SuiteTalk SOAP Web Services Platform Guide

Web Services and RESTlet Concurrency Governance 22

wait();
i++; // try again
}
else
{
break; // end the cycle
}
}

To ensure that the requests of non-concurrent users do not overlap, upgrade your client applications to
serialize your requests.

Also, by updating your SOAP web services integrations to use TBA, you can take advantage of a more
flexible concurrency.

Retrying Failed Web Services Requests

If your client application receives the WS_CONCUR_SESSION_DISALLWD response, or you do not receive
any response, you should retry sending the request after a certain period.

Consider the following best practices when implementing retry logic:

■ You should send the first retry attempt after a certain delay. If more attempts are needed, you should
increase the delay between attempts.
■ Avoid the creation of artificial concurrency peaks due to synchronized retry attempts from different
threads or applications. There is no specific recommended length of delay between retry attempts to
avoid synchronization.
■ If retry attempts are needed for interactive applications, you should execute requests asynchronously
so there is no need for repeated user action.

Sample Scenario
Consider Company ABC that is on a standard service tier with one SuiteCloud Plus license. User A is the
designated concurrent web services user. The company makes 10 web services requests concurrently.
User A uses request-level credentials to make web services requests. The company also has one RESTlet
that is reached concurrently five times. For RESTlet requests, token-based authentication (TBA) is used.
User B generates one web services request using request-level credentials. All of these requests occur in
parallel.

The account-level concurrency limit of this customer is 15 (5+10). If they generate 5 RESTlet requests
using TBA, 10 web services requests with request-level credentials from User A, and one web services
request with request-level credentials from User B, an error will be thrown for one of the requests.

This error occurs when they generate one request over their account-level limit. The first 15 requests
th
will succeed, and the 16 concurrent request will result in an error. The error can occur for any of the
requests. If Company ABC does not want to use a dedicated concurrent web services user, they can re-
implement their web services integrations to use TBA instead of request-level credentials. The company
still needs the SuiteCloud Plus license to get support for 15 web services concurrent requests.

Frequently Asked Questions

I currently do not govern my REST concurrency. What happens now?
If you exceed the limit for concurrent requests, an error will be thrown. You need to make sure that your
client applications will retry sending requests in the case of an error. This recommendation has always

SuiteTalk SOAP Web Services Platform Guide

Web Services and RESTlet Concurrency Governance 23

been considered a best practice, and the change in concurrency governance does not introduce any new
error codes.

Will my existing integrations break due to these changes?

If the concurrency limits are exceeded, your integration might encounter the error codes listed in Effects
of Authentication Method on Concurrency Governance. You must modify your integration to handle these
exceptions and you must add logic to retry the requests.

Will this affect my sandbox account governance?

Sandbox accounts match your production governance limit. Developer accounts always have a
governance limit of five.

Can I monitor my account’s concurrency usage level?

You can check your account limit on the Integration Governance page, at Setup > Integration >
Integration Governance.

I have multiple user accounts being used for concurrent SOAP web services based on
request–level authentication. None of them exceed one request at a time. I do not have
an SuiteCloud Plus license. Do I now need to buy one?
The total number of web services concurrent requests across all users will be governed by the account
level limit. If you exceed that limit, you might require additional SuiteCloud Plus licenses.

How does this impact the SuiteCloud Plus license?

Prior to version 2017.2, SuiteCloud Plus licenses helped increase the limit on maximum permitted
concurrent SOAP web services requests. This did not have any impact on RESTlets. Starting from version
2017.2, both SOAP and RESTlet requests can benefit from SuiteCloud Plus licenses. SOAP and RESTlet
requests both share the same pool for concurrency, which is set at account level. By purchasing one or
more SuiteCloud Plus licenses, this limit can be increased.

Is there any impact based on the authentication used for SOAP web services? (Request-
level or token-based authentication)
For the RESTlet API, there is no impact. All RESTlets are subjected to the account-level governance
limit. For SOAP web services, if you want to use request-level authentication, you need to designate a
concurrent web services user to enable multiple concurrency. If you switch to token-based authentication
(TBA), you do not have to designate anyone as concurrent user. You can run multiple SOAP requests as
permitted by the account-level governance limit.

We recommend that you use TBA. This eliminates the need to designate a concurrent web service user as
one token can be used in more concurrent requests up to the account limit.

How does the governance change affect the usage of the Concurrent Web Service User
option on the user record?
You can continue to use this option to run concurrent SOAP web service requests for designated users.
However, these requests will be counted against the account-level governance limit and there is no
guarantee or reservation for designated users.

Prior to version 2017.2, if you had one or more SuiteCloud Plus licenses, each designated concurrent web
service user is guaranteed 10 concurrent SOAP requests. With the change, if a designated user makes 10
concurrent SOAP web service requests, the number of requests that succeed or fail will depend on other
SOAP or REST requests that are being processed.

SuiteTalk SOAP Web Services Platform Guide

Web Services and RESTlet Concurrency Governance 24

We recommend that you use token-based authentication (TBA). This eliminates the need to designate a
concurrent web service user.

Glossary
You should be familiar with the following terms before implementing SOAP web services integration
technology.

■ Type – A type is an element defined in the XML Schema. See Types for more details.
■ Record Type – A NetSuite business record type, such as customer, event, or custom record, that has
an entry form in the user interface. See Records in SOAP Web Services for more details.
■ Search Record Type – A type that encapsulates the available search criteria for a specific NetSuite
business record type. See Records in SOAP Web Services for more details.
■ System – The NetSuite application.
■ Client – A company with a NetSuite account that is using SOAP web services.
■ Requester – The sender of a Web service request.
■ Write operations – A SOAP web services operation that changes data within a NetSuite account.
These include add, addList, update, updateList, delete, and deleteList operations. See SOAP Web
Services Operations SOAP Web Services Operations for information on each operation.
■ Read operations – A SOAP web services operation that retrieves data from a NetSuite account. These
include get, getList, getAll, search, searchNext and searchMore operations. See SOAP Web Services
Operations SOAP Web Services Operations for information on each operation.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Setup 25

SOAP Web Services Setup

These sections provide the basic information you need to get started with SOAP web services.

■ SOAP Web Services Quick Start – provides step-by-step instructions on how to set up your SOAP
web services environment and start building applications to interface with SOAP web services. Also
provides a path for Downloading Sample Applications provided by NetSuite.
■ SOAP Web Services Development Considerations – describes development considerations such as
account configurations and the enabling of NetSuite features to ensure your SOAP web services calls
execute successfully.
■ SOAP Web Services PHP Toolkit – provides setup information for those wanting to use the NetSuite
PHP toolkit to develop SOAP web services applications.

Before building a web services application to interface with SOAP web services, the NetSuite web services
feature must be enabled in your NetSuite account. See Enabling the SOAP Web Services Feature.

After you have enabled SOAP web services in your NetSuite account, you must set your SOAP web
services preferences. See SOAP Web Services Preferences.

SOAP Web Services Quick Start

This section provides details on using Microsoft .NET or Java to build an application that uses NetSuite
SOAP web services. This section provides steps for the following tasks:

■ Enabling the SOAP Web Services Feature

■ Setting the Show Internal IDs Preference
■ Building an Application with Microsoft .NET
■ Building an Application with Java using Apache Axis
■ Downloading Sample Applications
■ Capturing SOAP

Note the following:

■ Before developing your own SOAP web services applications, you should see the topic SOAP Web
Services Development Considerations.
■ For information on working with SOAP web services and PHP, see SOAP Web Services PHP Toolkit.
■ Although some customers have built SOAP web services applications using Perl, Perl is not officially
supported by NetSuite.

Enabling the SOAP Web Services Feature

The SOAP web services feature must be enabled prior to submitting SOAP web services requests.

To enable the SOAP web services feature:

1. As administrator, click Setup > Company > Enable Features.

2. Click the SuiteCloud subtab.
3. Check the SOAP Web Services box.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Quick Start 26

4. Click Save.

Note that after you have enabled SOAP web services in your NetSuite account, you should set your SOAP
web services preferences. See SOAP Web Services Preferences for more details.

Setting the Show Internal IDs Preference

NetSuite recommends that you set the Show Internal IDs preference when working with SOAP web
services or SuiteScript. Setting this preference lets you see the internal IDs for all fields, records, lists,
workflow actions, and custom forms in NetSuite. In SOAP web services (and in SuiteScript) you will
reference many of these IDs in your code.

Note: The Show Internal IDs field is only available when at least one of the following features is
enabled in your account: Client SuiteScript, Server SuiteScript, SuiteScript Server Pages, SuiteFlow,
or SOAP web services (on the SuiteCloud tab) or Advanced Site Customization or SuiteCommerce
Advanced (on the Web Presence tab). For more information, see the help topic Enabling Features.

To set the Show Internal IDs preference:

1. Go to Home > Set Preferences. The General subtab is displayed by default.

2. In the Defaults section, click Show Internal IDs.

When this preference is set:

■ You can view the internal ID for a field by clicking on that field's label to open the field level help popup
window. The internal ID is displayed in the lower right corner of this window.
■ You can view the internal ID for a record or a custom field in an Internal ID column that displays on a
list or search results page for that type of record or custom field.
■ You can view the internal IDs for workflow actions on the workflow context panel, workflow action
group window, and sublist action group window. You can also view internal IDs in workflow execution
logs.

Changes to this preference affect only the current user.

For more details, see the help topic Showing Record and Field IDs in Your Account.

Building an Application with Microsoft .NET

This section provides details on how to use the Microsoft .NET platform to build a SOAP web services
application. You can also see Downloading Sample Applications for a .NET sample currently available on
the NetSuite Developer Portal.

Important: When building an application with Microsoft .NET, NetSuite recommends that
you use Visual Studio .NET since it provides an integrated development environment to build
and debug your Web service applications. Alternatively, you can download and install the
Microsoft .NET Framework SDK. However, this only provides you with the SDK and does NOT
provide an integrated IDE.

All code samples in this section use the C# language, however these steps are similar for all other
languages supported by Microsoft .NET. These languages include Visual Basic, Visual J#, and C++.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Quick Start 27

To use Microsoft .NET with NetSuite SOAP web services:

1. Install the Microsoft .NET framework.

Install Microsoft .NET Framework 4.6, which includes the .NET framework SDK (RECOMMENDED), or
the Microsoft .NET Framework SDK version 1.1 (NOT recommended).
2. Use the .NET framework SDK to automatically generate the client proxy code
If using Microsoft .NET Framework (RECOMMENDED):
1. Start Microsoft .NET Framework 4.6.
2. Create a new project and choose a template, for example, Console Application.
3. After the project has been created, add a Web reference.
The Add Web Reference option may be available in the Project menu. If not, select Add
Service Reference, click the Advanced button, and click the Add Web Reference button.
4. In the Add Web Reference dialog, enter the SOAP WSDL URL and click the Go icon.
A URL for the latest SOAP WSDL is: https://webservices.netsuite.com/wsdl/v2022_2_0/
netsuite.wsdl

Note: Although the material in this guide pertains to the latest NetSuite WSDL, we
continue to support endpoints released prior to this version.

5. Visual Studio inspects the WSDL and displays a summary of the available operations. If
security warnings are displayed, click Yes as many times as necessary to continue this
process.
6. After the summary is displayed, click the Add Reference button to generate the classes.
When this process is complete, com.netsuite.webservices is listed under Web References
in the Solution Explorer.
7. To view all generated proxy classes, do one of the following:
■ Enable the Show All Files option in the Project menu
■ (If the above option is not available), right-click the com.netsuite.webservices listing in
the Solution Explorer and choose View in Object Browser.
If using only the Microsoft .NET Framework SDK (NOT recommended):
1. Locate the wsdl.exe file under the Microsoft .NET Framework SDK installation and add it to
your system path.
2. Open a command prompt, and type the following to generate the proxy classes:

wsdl /language:<language> <url>

Where <language> is your preferred language and <url> is the URL for the NetSuite WSDL.
For example, generate the proxy classes in C# as follows:

C:\project>wsdl /language:cs https://webservices.netsuite.com/wsdl/

v2017_1_0/netsuite.wsdl

A C# file called NetSuiteService.cs is generated.

3. Compile the source code for your proxy into a .NET Assembly using the .NET Framework C#
compiler or any other supported compiler.
4. Locate the csc.exe file under the Microsoft .NET Framework SDK installation and add it to
your system path.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Quick Start 28

csc.exe /out: NetSuiteService.dll /target:library

reference:system.xml.serialization.dll /
reference:system.web.services.dll
NetSuiteService.cs

3. Implement your application by writing your business logic using the generated .NET proxy classes.
Note that the following code snippets are shown in C#.
1. Allow the use of objects from the newly created namespace without having to qualify them.

using <namespace>.com.netsuite.webservices;

2. Instantiate the NetSuite service.

NetSuiteService service = new NetSuiteService();

3. Enable support for multiple cookie management.

service.CookieContainer = new CookieContainer();

4. Create a valid session by populating the Passport object.

//invoke the login operation

Passport passport = new Passport();
passport.account = "TSTDRV96";
passport.email = "[email protected]";
RecordRef role = new RecordRef();
role.internalId = "3";
passport.role = role;
passport.password = "<SOAP web services password>";
Status status = service.login( passport ).status;

5. Implement your business logic. For example, create a new customer in NetSuite.

Customer cust = new Customer();

cust.entityID( "XYZ Inc" );
WriteResponse response = service.add( cust );

6. Logout to invalidate the current session.

service.logout();

Building an Application with Java using Apache Axis

This section provides details on how to use the Apache Axis framework (versions 1.3 and 1.4) to build a
SOAP web services application.

Note: The Java sample application available on the Developer portal provides an in-depth look at
how to build an application using Apache Axis and NetSuite SOAP web services. See Downloading
Sample Applications for more information.

To use the Apache Axis framework with NetSuite SOAP web services:
1. Install Java JDK 8.
Download and install Java JDK 8. Ensure that the executables are available through the system path.
This is required because all inbound and outbound secure communication must use TLS 1.2 or TLS
1.3.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Quick Start 29

2. Install Apache Axis.

1. Download and install Apache Axis from http://ws.apache.org/axis/.

Important: The instructions work only for Axis version 1.4.

2. Download and install the Apache Axis patch for cookie management from NetSuite: http://
www.netsuite.com/portal/developers/resources/suitetalk-sample-applications.shtml
The NetSuite Web service implementation requires the client application to support
multiple cookies on one line, as is the standard for cookies. There is a bug in Apache Axis
that puts each cookie on its own line in the HTTP Headers. The patch version of the axis.jar
fixes this problem. After it is downloaded, replace the existing axis.jar file in the lib directory
of your Axis root directory with this version.
3. After it is installed, set an environment variable called AXIS_HOME to point to the Axis
installation directory.
3. Install Apache Ant (Optional).
Download and install Apache Ant, version 1.5 or higher, from http://ant.apache.org/. Apache Ant
is a Java-based build tool that facilitates automation of the build process, including generating the
proxy classes from the NetSuite WSDL.
See the build.xml file in the Java sample application for a complete Ant build script.
4. Configure Java to generate unreferenced types.
Set the all parameter in your axis-wsdl2java ant task to true. For example:

<axis-wsdl2java timeout="360000" output="${generated.src.dir}" verbose="true" url="${wsdl-1.3.url}" al

l="true" wrapArrays="true">

5. Use Apache Ant to automatically generate the client proxy code.

Using Apache Axis from the command line
Use the WSDL2Java utility to generate the proxy classes as follows:

java -cp <classpath> org.apache.axis.wsdl.WSDL2Java -a -w -O 360000 <url>

Where the <classpath> points to the appropriate Apache Axis JAR files and <url> is the URL for the
NetSuite WSDL.
For example, the following commands will set the class path and generate the proxy classes:

>set
CP=%AXIS_HOME%\lib\axis.jar;%AXIS_HOME%\lib\jaxrpc.jar;%
AXIS_HOME%\lib\commons-discovery.jar;%AXIS_HOME%\lib\wsdl4j.jar;
%AXIS_HOME%\lib\saaj.jar;>java -cp %CP% org.apache.axis.wsdl.WSDL2Java
https://webservices.netsuite.com/wsdl/v2017_1_0/netsuite.wsdl

Using the Apache Axis task in Apache Ant

Create a build target that uses the WSDL2Java Ant task as follows where the ${generated.src.dir}
variable is the directory where the source code is generated and the ${wsdl.url}variable points to
the NetSuite WSDL.

<target name="generate.interfaces" description="Generates client interfaces using Axis">

<echo>Generating client interfaces using Apache Axis</echo>
<axis-wsdl2java output="${generated.src.dir}" verbose="true" url="${wsdl.url}">
<mapping namespace="http://axis.apache.org/ns/interop" package="interop"></mapping>
</axis-wsdl2java>
</target>

6. Ensure that the Ant executables are available on the system path. Run the Ant task as follows:

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Quick Start 30

ant generate.interfaces

7. Implement your application by writing your business logic using the generated axis proxy classes.
1. Locate the NetSuite service.

NetSuiteServiceLocator service = new NetSuiteServiceLocator();

2. Enable support for multiple cookie management.

service.setMaintainSession( true );

3. Get the NetSuite port.

NetSuitePortType port = service.getNetSuitePort();

4. Create a valid session by populating the Passport object and then invoking the login
operation.

passport.setEmail( "[email protected]" );
passport.setPassword( "<SOAP web services password>" );
role.setid( "3" );
passport.setRole( role );
passport.setAccount( "TSTDRV96" );
Status status = port.login( passport ).getStatus();

5. Implement your business logic. For example, create a new customer in NetSuite.

Customer cust = new Customer();

cust.setEntityID( "XYZ Inc" );
WriteResponse response = port.add( cust );

6. Log out to invalidate the current session.

port.logout();

Downloading Sample Applications

SOAP web services developers can download sample applications from the NetSuite Developer Portal, at
http://www.netsuite.com/portal/developers/resources/suitetalk-sample-applications.shtml. CRM and ERP
sample applications are provided in both Java and .NET.

Capturing SOAP
When writing SOAP web services you will want to capture and analyze SOAP request and response
messages associated with an operation call. You can use such products as Actional Diagnostics or
SOAPScope. You can also review your SOAP requests and responses from the pages where they are
available in NetSuite. You can download these files from the Execution Log of each integration record, or
you can use the SOAP Web Services Usage Log, which shows the logs from all integration records. For
details on working with integration records, see Integration Management. For details on using the usage
log, see Using the SOAP Web Services Usage Log.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Development Considerations 31

SOAP Web Services Development Considerations

This section covers the following topics:

■ Development Considerations Overview

■ NetSuite Features in SOAP Web Services
■ SOAP Web Services Reliability Considerations
■ Effects of Account Configuration in SOAP Web Services
■ Enumerations, Special Characters, and Character Encoding
■ Image References in SOAP Web Services

Development Considerations Overview

Before you begin writing SOAP web services applications, you should be aware that SOAP web services
adhere to the same role-based permission structure enforced in the NetSuite UI. Because a SOAP web
services application needs a pair of sign-in credentials to login, its permission to various operations and
records is subjected to the role it uses, like it would when it is used for a browser session. For example, a
SOAP web services application that logs in with the Accountant role will receive the same permissions as it
will logging in to the browser interface using the same role.

Note: See Roles and Permissions in SOAP Web Services for additional details.

Another characteristic of SOAP web services is that its behavior is very similar to that of the NetSuite UI.
The workflow of a SOAP web services application and its underlying SOAP exchange with NetSuite tightly
mimics the browser interface. For example:

1. A successful login operation must be performed to obtain a session to perform any subsequent
operations. (See the documentation on SOAP web services Authentication for SOAP Web Services
for more details.)
2. Some add operations are done in a tandem, such as loading an existing sales order to gain the
context and then adding a new item fulfillment record. The loading of the sales order (using the
initialize API) is the first operation; adding the item fulfillment record is the second.
3. Restrictions and requirements on custom forms are honored in SOAP web services. Therefore,
a SOAP application's attempt to set a field that is hidden on a form results in a permission error.
Likewise, as in the UI, a SOAP application must set fields that are required on the form it is using.

The combination of permission adherence and similar behavioral patterns between SOAP web services
and the NetSuite UI provides a consistent and predictable platform for developers.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Development Considerations 32

Important: When you are unsure of how to achieve something with SOAP web services, try
observing how it is done in the UI, then replicate it programmatically.

Note: A SOAP web services application should use the response object to handle any errors, if
any, generated by a Web service operation.

Important: SOAP web services use the HTTP protocol, therefore service interruptions can
occur from time to time. If you receive an HTTP 503 error (Service Unavailable), try sending your
SOAP web services request later.

NetSuite Features in SOAP Web Services

The NetSuite UI lets you enable or disable certain features. When designing your SOAP web services,
it is important to know which features must be enabled in order for the service to execute properly. If
the service calls for a function that is NOT available because the associated feature is disabled, a SOAP
InsufficientPermissionFault occurs causing the entire service to fail. For example, in the NetSuite UI
you can enable or disable the Opportunities feature for CRM. If disabled, a web service call to add an
OpportunityItem will fail.

SOAP web services is itself a feature that must be enabled prior to submitting SOAP web services
requests. To enable the feature, see Enabling the SOAP Web Services Feature.

SOAP Web Services Reliability Considerations

You may encounter issues when a SOAP web services operation does not complete or the client does not
receive a response. This topic provides the most common causes of this issue and provides best practices
to help you avoid them.

Reasons for SOAP Web Services Operation Failures

■ Network connection errors at any point of the connection or minor network disruptions and
timeouts.Such disruptions can occur anytime. Note that if the server receives the request, the
processing of operations continues, even if a network disruption occurs later. In such a case, it is
possible that the client does not receive a response from the server, so it is not clear for the client
whether the operation completed successfully or failed.
■ Error in the NetSuite infrastructure. For example, an application server might crash.
■ Application server restart due to a hot-fix, system maintenance, or upgrade.
■ Client error. Due to such errors, the client might not receive a response from the server, and cannot
assess whether the operation succeeded or failed.
■ Exceeding a timeout:
□ Web services sessions automatically time out after 20 minutes of inactivity, requiring a login to
resume activity.
□ If a web services request takes more than 15 minutes to complete, it automatically times out.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Development Considerations 33

Important: List and search requests that take longer than 15 minutes to process are
terminated. For more information about handling long-running list and search operations, see
Handling of Lengthy Requests.

Recommended Actions
The following sections provide recommended actions for troubleshooting, and best practices for avoiding
issues with operation failures.

Client Implementation Considerations and Troubleshooting

■ For long-running SOAP web services operations, consider using asynchronous request processing.
For more information, see Synchronous Versus Asynchronous Request Processing. Note that the
asyncSearch operation can also time out, and this timeout does not necessarily correspond to the
general operation timeout.
■ Use the SOAP web services operations search to search for and analyze information about failing
SOAP web services requests and operations. For more information, see SOAP Web Services
Operations Search Type.
■ Check the SOAP web services usage log for information about the operation and the status of the
request. For more information, see Using the SOAP Web Services Usage Log.
■ When an afterSubmit script runs after a SOAP web services add or update request and the script fails,
the records are still created or updated in NetSuite. Using the internal ID of the record, available in
the SOAP response, you can avoid creating duplicate records. If the SOAP response indicates that
the records have been saved, you should not send the SOAP web services request again. For more
information, see SOAP Web Services Warnings, Errors, and Faults.

Synchronous Client Implementation

■ To prevent duplicate records and to make sure that all records are correctly added, use external IDs
and the upsert and upsertList operations to update records in NetSuite.

Note: External IDs originally serve to identify records in a third party system. If you cannot
use such an identification, generate a random but unique external ID, for example, a UUID,
which you can then use to create records in NetSuite.

■ You must implement your business logic in a way that your update operation is idempotent.
□ Idempotency is also necessary for working with sublists. When you work with sublists in SOAP web
services, the approach for updating sublist lines varies depending on whether you are working with
keyed sublists or non-keyed sublists. Keyed sublists allow you to set the replaceAll attribute to false,
to update only the specific lines you submit in your requests. For non-keyed sublists, the replaceAll
attribute is ignored, and you must interact with the sublist as a whole. For detailed information, see
Updating Sublists in SOAP Web Services.

Implementing a Retry Logic

You must implement a retry logic to resend SOAP web services requests that do not complete. Using a
retry mechanism is essential for the following reasons:

■ To make sure that requests that fail due to timeout issues are executed again.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Development Considerations 34

Note: If a request times out and you send a retry request, it is possible that the response
contains fewer records than the first response.

■ To make sure that requests rejected due to concurrency violations are executed again. For information
about concurrent sessions, see Web Services and RESTlet Concurrency Governance.
■ To make sure that you do not violate SOAP web services session management timeouts and limits. For
more information, see Session Management for SOAP Web Services.

See the sample retry code below for an example.

Sample Retry Code

int i = 0;
int maxAttempts = 5; // try it 5 times, then fail for good
while (i < maxAttempts)
{
response = doWSCall();
isSuccess = response.getIsSuccess();
errorMsg = response.getErrorMsg();
if (isSuccess == false && (errorMsg == WS_CONCUR_SESSION_DISALLWD || errorMsg == WS_REQUEST_BLOCKED))
{
wait();
i++; // try again
}
else
{
break; // end the cycle
}
}

Effects of Account Configuration in SOAP Web Services

Form customization in an account or enabling or disabling features may result in required fields being
added to various forms used on records. For each SOAP web services request, fields available for
the specified record are validated against the data being submitted, and errors are returned where
field validation fails. However, for get, add, addList and search requests, it is possible that the field
requirements change mid-request, resulting in errors for a subset of the request.

For example, suppose you want to submit 20 new customer records using the addList operation. Upon
submission, field validation passes for the request. However, after the first 15 customers are added, the
required fields may be changed within your NetSuite account, causing an error to be returned for the 5
remaining items.

Note: For more specific information on working with NetSuite records, fields, and forms in SOAP
web services, see Records, Fields, Forms, and Sublists in SOAP Web Services.

Enumerations, Special Characters, and Character Encoding

When enumerations contain either special characters (“(“) or reserved keywords (“private” or “public” for
example), both .NET and Axis may generate less usable code on the client side. To alleviate this problem,
all enumerated values in NetSuite SOAP web services are prefixed with an underscore “_”, except for
enumerated values from the platformCore, platformCoreTyp, platformFaults, platformFaultsTyp, and
platformMsgs XSDs. For example, without the “_”, .NET prepends an “@” symbol to the variable, as in
“@private”.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Development Considerations 35

Character Encoding
SOAP web services and the NetSuite UI support UTF-8 character encoding.

Image References in SOAP Web Services

To reference an image, the image must first be uploaded to the NetSuite File Cabinet, and then
referenced using the image name specified in the File Cabinet. For more information on working with
images (and other file types) in the File Cabinet, see the help topic File.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Preferences 36

SOAP Web Services Preferences

NetSuite preferences control how certain services are executed. Therefore, before using SOAP web
services with your NetSuite account, ensure that the appropriate preferences are enabled, as defined in
the following sections:

■ Company-Wide Preferences
■ One-Time Preferences
■ Setting the Internal ID Preference
■ Caching Behavior in SOAP Web Services

Company-Wide Preferences
In some cases, you may want to set company-wide preferences that affect all SOAP web services calls
made to your NetSuite account. Changes to these preferences are propagated to every user.
You can set these preferences at Setup > Integration > SOAP Web Services Preferences.
Some of these preferences can be overridden when you send individual SOAP web services requests. For
details, see One-Time Preferences. Be aware also that additional preferences are available at the request
level.

Note: The SOAP Web Services Preferences page also includes information whether the web
services and RESTlet concurrency governance is enabled for your account, and about the available
concurrency limit for your account. For information about web services and RESTlet concurrency
governance, see Web Services and RESTlet Concurrency Governance

The following preferences can be set on a company-wide basis:

■ Disable Mandatory Custom Field Validation

■ Run Server SuiteScript and Trigger Workflows
■ Require Approval During Auto-Installation of Integration
■ Search Page Size
■ Treat Warnings as Errors

Disable Mandatory Custom Field Validation

This preference affects the handling of custom fields that are configured in the UI to be mandatory. If
you set this preference to true, the fields are not treated as required during SOAP web services requests.
If the preference is set to false, the fields are required. In these cases, if you fail to provide the required
value, the system returns a USER_ERROR, with instructions to provide a value for the field.
When deciding whether to enable this preference, consider whether the data being provided comes from
a system that has equivalent fields to the custom field.
This preference can be overridden at the request level. For details, see
disableMandatoryCustomFieldValidation.

Run Server SuiteScript and Trigger Workflows

This preference setting is applied to the entire company. However, you can overwrite this preference in
each SOAP web services request. For details, see Request-Level Preferences.

SuiteTalk SOAP Web Services Platform Guide

Company-Wide Preferences 37

This preference enables server SuiteScripts and triggers workflows and is selected by default. If this
preference is not selected, all SuiteScript scripts and workflows are disabled.
If you disable this option, you do both of the following:

■ Disable server SuiteScripts that otherwise would have been triggered by SOAP web services requests.
■ Disable workflows that otherwise would have been triggered by SOAP web services requests.

If you are bringing historical data into NetSuite, consider disabling this option to increase speed of
operations and block executions of additional logic performed automatically by executed scripts and
workflows. If you are syncing live data or running a partner application (for example, Outlook Sync) it is
recommended that you use the default option, Server. In other words, you should consider enabling
server SuiteScript to ensure that your business logic runs for your integrated application. However, note
that doing so may have a negative performance impact.

Important: To ensure that your business logic is fully executed, always use the default option,
Server. Additionally, changing the default option can potentially break your working integration.
You are discouraged from doing so unless you are an advanced SOAP web services user.

Require Approval During Auto-Installation of Integration

Auto-installation is the automatic creation of an integration record in your NetSuite account. For example,
in some cases, a partner may provide you with an updated version of an application. This update may
include a new application ID created by using an integration record. The first time you send a request
using this application, a new integration record is created in your account.
The Require Approval during Auto-Installation of Integration preference affects whether this new
record is automatically enabled. If the preference is set to false, the State field on the new application is
automatically set to Enabled, and all requests are permitted. If the preference is set to true, the State field
on the new integration record is set to Waiting for Approval. In the latter case, you must manually edit the
record and set the State to Enabled. Until you do, all requests sent by that application are blocked.

Search Page Size

The Search Page Size preference determines the number of records returned in the results of a search.
This preference affects both synchronous and asynchronous searches. When you set this preference on a
company-wide basis, valid values are between 5 and 1,000. The default value is 1,000.
This preference can be overridden at the individual search level. When setting this preference for a
particular search, note that the maximum for an asynchronous search is greater than the maximum that
can be set at the company-wide level. For more details, see pageSize.

Treat Warnings as Errors

When this preference is enabled, warning messages generated by NetSuite are treated as errors that
cause an exception, resulting in rejection of the request. For more information on the difference between
errors and warnings, see SOAP Web Services Warnings, Errors, and Faults.
This preference can be overridden at the request level. For details, see warningAsError.

One-Time Preferences
If appropriate, you can set preferences at the request level. These settings override preferences that
might have been established for your NetSuite account as a whole.

SuiteTalk SOAP Web Services Platform Guide

One-Time Preferences 38

Note that some preferences exist only at the company-wide level and therefore cannot be overridden.
Conversely, some preferences exist only at the request level and therefore can be set only during a
specific request or search. That is, they have no company-wide equivalent.

The available request-level preferences are described in the Request-Level Preferences topic.

For details on company-wide preferences, see Company-Wide Preferences.

Request-Level Preferences
Certain SOAP web services preferences can be set at the request level. When you use this approach, the
request-level preferences override any company-wide preferences that might have been set.

Preferences available at the request level are part of the Preferences complex type. This type is defined
in the platform messages XSD file. You can also view the Preferences complex type on the SOAP Schema
Browser’s Preferences reference page.

Note that all of these preferences take boolean values.

The available preferences are:

■ disableMandatoryCustomFieldValidation
■ disableSystemNotesForCustomFields
■ ignoreReadOnlyFields
■ runServerSuiteScriptAndWorkflowTriggers
■ warningAsError
■ bodyFieldsOnly
■ pageSize
■ returnSearchColumns

Note: When setting a preference value, you must use camelCase style capitalization for the
preference type name. If you do not, the system does not return an error, but your settings are
ignored.

disableMandatoryCustomFieldValidation
This preference affects the handling of custom fields that are configured in the UI to be mandatory. If
you set this preference to true, the fields are not treated as required during SOAP web services requests.
If the preference is set to false, the fields are required. In these cases, if you fail to provide the required
value, the system returns a USER_ERROR, with instructions to provide a value for the field.

When deciding whether to enable this preference, consider whether the data being provided comes from
a system that has equivalent fields to the custom field.

This preference can also be set at the company-wide level. It displays in the UI as Disable Mandatory
Custom Field Validation. If you do not set this value at the request level, NetSuite uses the company-wide
preference.

disableSystemNotesForCustomFields
System notes are system-generated records that track changes to a record, including changes to specific
field values. This preference lets you disable the creation of system notes for changes to custom fields.
Depending on your integration, using this preference may increase performance.

SuiteTalk SOAP Web Services Platform Guide

One-Time Preferences 39

This preference is available at the request level only.

In NetSuite, logging system notes can also be controlled by checking the Log System Notes on
Update Only box under Setup > Company > Preferences > General Preferences. The SOAP web
services preference does not override the UI preference when the UI preference is set to true. This
means that if you set the Log System Notes on Update Only preference in the UI to true, while the
disableSystemNotesForCustomFields SOAP web services preference to false, only updates will be logged
for custom fields. For more information about the UI preference, see the help topic Setting General
Account Preferences.

Important: System notes are important for maintaining a complete audit trail. Therefore, if a
custom field contains sensitive information that is critical for audit purposes, you should carefully
consider whether or not to enable this preference. For more details about system notes, see the
help topic Auditing Data Changes using Searches.

ignoreReadOnlyFields
This preference affects the way the system behaves when you mistakenly submit a value for a read-only
field. If you set this preference to true, the system ignores these mistakes.

It is recommended that you set this preference to true in the following situations:

■ If you are getting a record, making a change to it, and then submitting it.
■ If you are initializing a record.

In these situations, if you set the preference to true, you do not have to take the time to remove values
for read-only fields. Otherwise, if values for these fields exist, the system returns an error reading
INSUFFICIENT_PERMISSION.

This preference is available at the request level only.

runServerSuiteScriptAndWorkflowTriggers
By using the runServerSuiteScriptAndTriggerWorkflows preference, you can control SuiteScript and
trigger workflows per request. If you do not include this preference in a request, the company preference
set on the SOAP Web Services Preferences page is used. If you include this preference in the request, it
overrides the company preference set in the UI.

The preference is set in the request in the following way:

The value of the preference is set corresponding to the value from the request. If the preference is
not included in the request, the UI preference is used. If the preference is included in the request, it
overwrites the company preference set in the UI. This preference can be set on the UI using the Run
SuiteScript and Workflow Triggers check box.

If you disable this option, you do both of the following:

■ Disable server SuiteScripts that otherwise would have been triggered by SOAP web services requests.
■ Disable workflows that otherwise would have been triggered by SOAP web services requests.

Also see Basic Search Behavior with User Event Scripts and Workflows about the effects of this
preference.

SuiteTalk SOAP Web Services Platform Guide

One-Time Preferences 40

workflows. If you are syncing live data or running a partner application (for example, Outlook Sync) it is
recommended that you use the default option, Server. In other words, you should consider enabling
server SuiteScript to ensure that your business logic runs for your integrated application. However, note
that doing so may have a negative performance impact.

Important: To ensure that your business logic is fully executed, always use the default option
to run SuiteScript and Server Triggers. Additionally, changing the default option can potentially
break your working integration. You are discouraged from doing so unless you are an advanced
SOAP web services user.

The Control SuiteScript and Workflow Triggers in Web Services Request permission is related to the
preference for disabling scripts and workflow triggers per request. This permission is a Setup type
permission. A user must have the Full level of this permission to set the new SOAP header preference for
disabling scripts and workflow triggers per request. If a user with insufficient permissions sends a request
with this preference set, the request fails with the following error:

<platformFaults:code>INSUFFICIENT_PERMISSION</platformFaults:code>
<platformFaults:message>You do not have permission to control SuiteScript and Workflow Triggers in Web Services Request.</platform
Faults:message>

The global preference applies to requests sent by users who do not have permission to set a request-level
preference.

warningAsError
When this preference is enabled, warning messages generated by NetSuite are treated as errors that
cause an exception, resulting in rejection of the request. For more information on the difference between
errors and warnings, see SOAP Web Services Warnings, Errors, and Faults.

This preference can also be set at the company-wide level. It displays in the UI as Treat Warnings as
Errors. If you do not set this value at the request level, NetSuite uses the company-wide preference.

bodyFieldsOnly
The bodyFieldsOnly preference is boolean. You use it to specify whether or not sublist values are returned
in search results. In other words, if you set this value to true, only body fields are returned. If you set it to
false, sublist values are also returned.

Leaving this preference set to its default value, which is true, can significantly improve performance. If the
preference is set to false, a basic search triggers user event scripts and workflows.

Note that in an advanced search, this preference is ignored.

Note: The bodyFieldsOnly request-level preference affects the way computed fields such as total
values and formulas on forms are processed. As a result, for example, if the values of custom fields
are calculated using formulas, the search might return incorrect results. If the calculated values of
formulas are incorrect or incorrect total values are returned, set the bodyFieldsOnly preference to
false to make sure the correct values are returned.

pageSize
The pageSize preference takes an integer. You use this preference to specify the number of records
returned on a single page of search results.

SuiteTalk SOAP Web Services Platform Guide

One-Time Preferences 41

When you set a value for pageSize, the following limits apply.

Search Type Minimum Maximum

Synchronous 5 1,000

Asynchronous 5 2,000

If you enter an invalid number, the system may return an error code reading
WS_INVALID_SEARCH_PAGE_SIZE.

If you do not set a value for this preference in your search, the system uses the value that has been set
for the entire system. For more details, see Search Page Size.

returnSearchColumns
The returnSearchColumns preference is relevant when you are using an advanced search to execute an
existing saved search. In these cases, you might want the search to return full records, as opposed to
columns. To accomplish this, you would set the preference to false.

The default value for the preference is true. Note that if you set this preference to true and you do not
specify search return columns, the system returns an error. Similarly, if you are not executing a saved
search and you set the preference to false, the system returns an error.

For more information on advanced searches, see Advanced Searches in SOAP Web Services.

Sample Code
The following examples show how to set request- and search-level preferences.

For details on each preference, see Request-Level Preferences.

Note: When setting a preference value, you must use camelCase style capitalization for the
preference type name. Although no errors are thrown if this is not used correctly, your settings will
be ignored.

C#
In the following example, a general search-level preference is set.

// Set up request-level preferences as a SOAP header

Preferences prefs = new Preferences();

_service.preferences = prefs;

// Set preference to specify that warnings should be treated as errors

prefs.warningAsErrorSpecified = true;
prefs.warningAsError = false;

In this example, search preferences are set.

// Set search preference and invoke search operation

_service.searchPreferences.pageSize = 20;
_service.searchPreferences.pageSizeSpecified = true;
SearchResult response = _service.search( custSearch );

SuiteTalk SOAP Web Services Platform Guide

One-Time Preferences 42

Java
In the following example, several request-level preferences are set.

private void setPreferences() throws SOAPException

{
stub = (NetSuiteBindingStub) _port;
stub.clearHeaders();
SOAPHeaderElement prefHeader =
new SOAPHeaderElement("urn:messages_2017_1.platform.webservices.netsuite.com", "preferences");
Preferences prefs = new Preferences();
prefs.setWarningAsError(new Boolean(false));
prefs.setUseConditionalDefaultsOnAdd(new Boolean(false));
prefs.setUseConditionalDefaultsOnUpdate(new Boolean(false));
prefs.setDisableMandatoryCustomFieldValidation(new Boolean(true));
prefs.setDisableSystemNotesForCustomFields(new Boolean(true));
prefs.setIgnoreReadOnlyFields(new Boolean(true));
prefHeader.setObjectValue(prefs);

stub.setHeader(prefHeader);
}

In the following example, seach-level preferences are set.

NetSuiteBindingStub stub = (NetSuiteBindingStub)aPort;

stub.clearHeaders();
SOAPHeaderElement searchPrefHeader = new
SOAPHeaderElement("urn:messages_2017_1.platform.webservices.netsuite.com","searchPreferences");
SearchPreferences searchPrefs = new SearchPreferences();
searchPrefs.setPageSize(new Integer(nPageSize));
searchPrefs.setBodyFieldsOnly(isBodyFieldsOnly);
searchPrefHeader.setObjectValue(searchPrefs);
stub.setHeader(searchPrefHeader);

SOAP Request
The following SOAP request shows several request-level preferences being set.

<soap:Header>
<platformMsgs:preferences>
<platformMsgs:warningAsError>true</platformMsgs:warningAsError>
<platformMsgs:useConditionalDefaultsOnAdd>true</platformMsgs:useConditionalDefaultsOnAdd>
<platformMsgs:useConditionalDefaultsOnUpdate>true</platformMsgs:useConditionalDefaultsOnUpdate>
<platformMsgs:disableMandatoryCustomFieldValidation>true</platformMsgs:disableMandatoryCustomFieldValidation>
<platformMsgs:disableSystemNotesForCustomFields>true </platformMsgs:disableSystemNotesForCustomFields>
</platformMsgs:preferences>
</soap:Header>

Setting the Internal ID Preference

You can configure NetSuite to display internal ID values in the UI. This behavior can be useful during
development of your SOAP web services integration. The display of internal IDs lets you verify that the
values submitted in SOAP web services requests match the intended records.

Note: The Show Internal IDs field is only available when at least one of the following features is
enabled in your account: Client SuiteScript, Server SuiteScript, SuiteScript Server Pages, SuiteFlow,
or Web Services (on the SuiteCloud tab) or Advanced Site Customization or SuiteCommerce
Advanced (on the Web Presence tab). For more information, see the help topic Enabling Features.

To display internal ID values:

SuiteTalk SOAP Web Services Platform Guide

Setting the Internal ID Preference 43

1. Go to Home > Set Preferences. The General subtab is displayed by default.

2. In the Defaults section, click Show Internal IDs.

When this preference is enabled, most list views include Internal ID as one of the columns. For example,
when you go to List > Relationships > Customers, the second column is Internal ID.

Changes to this preference affect only the current user.

Note: Another way to quickly determine the internal ID value for a record is through its URL.
For example, when viewing a specific record, its URL may be something like the following: https://
webservices.netsuite.com/app/common/entity/custjob.nl?id=272. In this example, the internal ID is
272.

Caching Behavior in SOAP Web Services

Preferences, customizations, and custom fields are cached by SOAP web services sessions, both in
CRUD and search operations. For example, if you enable or disable an accounting preference at Setup
> Accounting > Preferences > Accounting Preferences (Administrator), your current SOAP web services
session still retains the previous setting of the preference.

To make sure that your SOAP web services requests respect your updated preferences, customizations,
and changes in custom fields, you should wait 60 minutes for the session timeout. After the timeout, the
new SOAP web services session will respect the changes you made.

SuiteTalk SOAP Web Services Platform Guide

Integration Management 44

Integration Management
As of 2015.2, all external applications that send SOAP web services requests to your NetSuite account are
represented by one or more integration records. You can use integration records to manage applications,
view activity logs, and more.

An integration record can be used to represent any application that sends web services requests or calls
RESTlets. However, some capabilities of the integration record are limited in regard to RESTlet activity.
This section focuses on using the integration record in conjunction with SOAP web services activity.

For more details on managing SOAP web services activity by using integration records, see the following
topics:

■ Integration Record Overview

■ Adding an Integration Record
■ Application Details for Client Code
■ Sending an Application ID with User Credentials
■ Token-Based Authentication Details
■ Blocking SOAP Web Services Requests
■ SOAP Web Services Execution Log
■ Distributing Integration Records
■ Default Web Services Integrations Record
■ Using Integration Records in Sandbox Accounts
■ Token-based Authentication Credentials and Accounts
■ Using Integration Records in Conjunction With SSO Calls
■ Removing Integration Records
■ Tracking Changes to Integration Records

Integration Record Overview

The integration record enhances your ability to manage and monitor SOAP web services requests sent
to your NetSuite account. This capability is particularly useful if you have more than one application
that sends requests. For example, your sales department may use one application to send data about
new customers. Your HR department may use a different application to update employee records. Each
application can be represented by a separate integration record.

For more details, see the following sections:

■ Benefits of the Integration Record

■ Application IDs
■ Endpoint Requirements
■ Ownership of Integration Records

Benefits of the Integration Record

When you use integration records to represent all of your external applications, you can do any of the
following:

SuiteTalk SOAP Web Services Platform Guide

Integration Record Overview 45

■ View details about each application – Each integration record shows details such as the
application’s name and description.
■ Block an application – You can use an integration record to block SOAP web services requests that
come from the corresponding application. However, if you are using the 2015.1 or an earlier endpoint,
be aware that some requests may be handled by the Default Web Services Integrations record, which
has its own configuration options. For details, see Blocking SOAP Web Services Requests.
■ Select permitted authentication methods for an application – When you create an integration
record, you can permit the application to authenticate through user credentials, token-based
authentication, or both. Note that when a request authenticates through user credentials, the
request must also include an application ID, if you want the application’s requests to be tracked by
the appropriate integration record. (For details, see Application IDs.) Additionally, be aware that the
permitted authentication methods vary depending on which endpoint the request uses. For details,
see Endpoint Requirements.

Important: As of the 2020.2 SOAP web services endpoint, authentication through request-
level credentials is not supported. The Passport complex type is not supported. If you attempt
to authenticate through request-level credentials in SOAP web services 2020.2 and later
endpoints, the web services request is not processed, and an error message is returned.
You must ensure that SOAP web services integrations created with 2020.2 and later SOAP
web services endpoints use TBA. Authentication through user credentials continues to be
supported in integrations that use SOAP web services 2020.1 and earlier endpoints. For more
information, see the help topic Token-based Authentication and Web Services.

■ Distribute an integration record – You can bundle an integration record and make it available for
installation in other NetSuite accounts. You can also configure a record so that it can be automatically
installed in other accounts. For details, see Distributing Integration Records.
■ View an execution log specific to each application – When you create and use an integration
record for each application, that record’s SOAP Web Services Execution Log lets you view only those
requests sent by that application. If you are not using unique integration records for each application,
you can view all requests together by using the log at Setup > Integration > SOAP Web Services Usage
Log. Note that in the case of RESTlets, the execution log only contains data about RESTlets that use
token-based authentication.
■ View a list of all your applications – You can view a list of all your applications at Setup > Integration
> Manage Integrations.

Application IDs
Every integration record has a unique application ID. This ID, a 32-character universally unique identifier,
is generated when you create the record. The ID is displayed on the integration record in the Application
ID field. However, application ID values are displayed only in the NetSuite account where they were
created. So, if an integration record was created by a partner and distributed, that record’s application ID
is not visible to the partner’s customers when they view the installed record in their own accounts.

In some cases, your SOAP web services requests are required to include an application ID. However, if
your request uses token-based authentication, you must omit an application ID.

Use the following guidelines:

■ Requests that authenticate through user credentials are required to include an application ID, if the
request uses the 2015.2 endpoint or later. (For details, see Endpoint Requirements.) If the request
uses the 2015.1 endpoint or earlier, an application ID is optional.
■ Application IDs should not be included in outbound SSO calls, regardless of which endpoint is being
used.

SuiteTalk SOAP Web Services Platform Guide

Integration Record Overview 46

■ If a request uses token-based authentication, you must not include an application ID, regardless
of which endpoint you are using. If you include an application ID with a request that uses TBA, the
request fails.

Although application IDs are considered identifiers and not authentication credentials, application IDs
should nevertheless be considered confidential.

Important: Some customers may have application IDs that were provided to them by NetSuite
Customer Support prior to 2015.2. These older IDs must not be used with the 2015.2 or a later
WSDL. Older application IDs are permitted only in requests that use the 2015.1 WSDL or earlier.
These requests are logged as part of the Default Web Services Integrations record’s SOAP Web
Services Execution Log.

If older application IDs are included in requests that use the 2015.2 or a later WSDL, the requests
are denied.

You can identify an old application ID by its length. Old application IDs have a maximum of nine
digits. By contrast, new applications IDs are 32-character UUIDs.

Endpoint Requirements
You can use integration records in conjunction with any supported endpoint. However, different
requirements exist, depending on your endpoint.

2015.1 and Earlier

If you use the 2015.1 endpoint or earlier, be aware of the following:

■ You have the option of letting some or all of your requests be tracked by a single integration record
called Default Web Services Integrations. This record requires little maintenance, if any. The Default
record was automatically created when your account was upgraded to 2015.2 or subsequently,
when you enabled the Web Services feature. The behavior of this record is slightly different from the
behavior of integration records that you create. For details on this record, see Default Web Services
Integrations Record.
■ Token-based authentication is not supported. If you want a request to be tracked by a specific
integration record (other than the Default record), it must authenticate through user credentials and
include an application ID. For more details about application IDs, see Application IDs.

2015.2 and Later

If you upgrade to the 2015.2 or a later endpoint, all SOAP web services requests must be associated with
an integration record other than the default record. That is, each request must include, either explicitly or
implicitly, one of the following types of information:

■ The application ID that was generated when the integration record was created, in conjunction with
valid user credentials. For more details about application IDs, see Application IDs. If you use the login
or ssoLogin operation, the application ID can be sent one time per session. For details, see Using
Application ID with the Login and ssoLogin Operations.
■ Token-based authentication details. For details on updating your code to authenticate this way, see
Token-Based Authentication Details.

SuiteTalk SOAP Web Services Platform Guide

Integration Record Overview 47

Note: Only one SOAP web services operation does not require authentication, nor any
information identifying the application. It is the getDataCenterUrls.

2016.2 and Later

NetSuite 2016.2 includes two new permissions that make it possible for users other than administrators
to view and manage integration records.
The List type Integration Applications permission provides view access to the Integrations list page.
The Full level of the Setup type Integration Application permission provides the ability to view, edit, and
create integration records. This permission also provides access to the Integration field on the SOAP
Web Services Operations search.
For details about SOAP web services searches, Searching for SOAP Web Services Log Information.

Ownership of Integration Records

When you create an integration record, it is automatically available to you in your NetSuite account. Your
NetSuite account is considered to be the owner of the integration record, and the record is fully editible
by administrators in your account.
You can also install records in your account that were created elsewhere, as follows:

■ Installed records can be installed as part of a bundle.

■ In some cases, integration records can also be auto-installed. With this approach, a record is
automatically installed when a request is sent that references the record’s application ID. Auto-
installation is supported both for integration records that are configured to permit token-based
authentication and authentication through user credentials.

Important: As of 2019.1, when calling the Issue Token endpoint, an Integration record is
created and automatically installed in your account. The Require Approval during Auto-Installation
of Integration preference affects whether this new record is automatically enabled. You can
manage the preference at Setup > Integration > Integration Management > SOAP Web Services
Preferences. If the box for the Require Approval during Auto-Installation of Integration preference
is not checked (set to false) the State field on the new application is automatically set to Enabled,
and all requests are permitted. However, if the box is checked (set to true) the State field on the
new integration record is set to Waiting for Approval. In the latter case, you must manually edit
the record and set the State to Enabled. Until you set the state to Enabled, all requests sent by
that application are blocked.

Records that are installed through either of these methods are not fully editable, because they are
considered to be owned by a different NetSuite account. On such records, you can make changes to only
two fields: the Note field and the State field. All other fields on these records, including the permitted
authentication options and the Description field, can be changed only by an authorized user in the
account that owns the records. When the owner makes changes, they are pushed automatically to your
account. These changes are not reflected in the system notes that appear in your account.
For more information about creating integration records, see Creating an Integration Record. For more
details about distributing integration records, see Distributing Integration Records.

Adding an Integration Record

For details about adding an integration record to a NetSuite account, see the following topics:

SuiteTalk SOAP Web Services Platform Guide

Adding an Integration Record 48

■ Creating an Integration Record

■ Auto-Installation of Integration Records
■ Bundle Installation of Integration Records

Creating an Integration Record

You can add an integration record to your account by auto-installing the record, or by installing a bundle
that includes the record. However, sometimes you must create an integration record by filling out a form
in the UI. For example, if you have created an integration for your own use only, you should create an
integration record by filling out the Integration form at Setup > Integration > Manage Integrations > New.

If you are a partner, you may want to provide customers with an integration record that represents an
application that you have distributed. In these cases, you would create an integration record by using the
procedure described in this topic. Later, you would distribute the integration record to customers, either
through bundling or auto-installation. Whichever distribution method you choose, note that most of the
integration record’s fields will be read-only in the customer’s account. The exceptions are the State field
and the Note field. For help distribution an integration record, see Distributing Integration Records.

When you create an integration record, the system automatically generates an application ID.
Additionally, depending on configuration choices you make, the system may automatically generate a
consumer key and secret for the record.

Note: Only administrators can complete this setup.

To manually create an integration record, go to:

■ Create Integration Records for Applications to Use OAuth 2.0 to use OAuth 2.0 with your integration.
■ Create Integration Records for Applications to Use TBA to use TBA with your integration.

After the setup of the integration record, see the help topic Manage TBA Tokens in the NetSuite UI if you
use TBA, or Managing OAuth 2.0 Authorized Applications if you use OAuth 2.0.

Auto-Installation of Integration Records

Auto-installation is the automatic addition of an existing integration record to your NetSuite account
through the sending of a SOAP web services request. Users and administrators in your organization can
use this method to add partners’ integration records to your account.

Auto-installation can be used with integration records that are configured to authenticate through user
credentials, token-based authentication or OAuth 2.0.

Important: Whether using The Three-Step TBA Authorization Flow, calling The IssueToken
Endpoint, or using OAuth 2.0, an Integration record is automatically installed in your account. The
Require Approval during Auto-Installation of Integration preference affects whether this record
is automatically enabled. You can manage the preference at Setup > Integration > Integration
Management > SOAP Web Services Preferences. If the box for the Require Approval during Auto-
Installation of Integration preference is not checked (set to false) the State field on the application
is automatically set to Enabled, and all requests are permitted. However, if the box is checked (set
to true) the State field on the integration record is set to Waiting for Approval. In the latter case,
you must manually edit the record and set the State to Enabled. Until you set the state to Enabled,
all requests sent by that application are blocked.

For more details about auto-installation, see the following sections:

SuiteTalk SOAP Web Services Platform Guide

Adding an Integration Record 49

■ Understanding Auto-Installation
■ Configuring the Require-Approval Preference

Note: When a record is installed through auto-installation (or through bundling), the values of
many fields on the record are determined by the NetSuite account that owns the record. These
fields are read-only in the account where the record is installed. For details, see Ownership of
Integration Records.

Understanding Auto-Installation
Be aware that auto-installation can be triggered by any user with access to your NetSuite account, not
exclusively account administrators.

The most common use of auto-installation occurs when users download and run applications provided by
partners. For example, a partner may have begun distributing a newly created application that includes
the application ID of a new integration record. Alternatively, a partner may have upgraded an existing
application to use the 2015.2 or a later WSDL and include a new application ID.

It is also possible to auto-install an integration record from your sandbox to your production account. Or,
if an integration record was removed from a sandbox account during a sandbox refresh, you can restore
it by auto-installing it.

In all of these cases, after a request is sent that includes the application ID, the integration record is
automatically installed. However, SOAP web services requests from the application may or may not
be automatically permitted. This behavior varies depending on the configuration of a preference, as
described in Configuring the Require-Approval Preference.

Configuring the Require-Approval Preference

The configuration of the Require Approval during Auto-Installation of Integration preference
determines whether automatically installed integration records are enabled at the time they are installed.

This preference can be configured in either of the following ways:

■ False (default) – The State field on each newly installed record is automatically set to Enabled, and all
requests are permitted.
■ True – The State field is set to Waiting for Approval. In this case, all requests sent by that application
are blocked until you edit the record and set the State field to Enabled.

In other words, if you as an administrator want to review and manually approve each newly installed
integration, you should set this preference to true. By contrast, if you are confident that all newly installed
applications should be granted access, set this preference to false.

You can manage this preference at Setup > Integration > SOAP Web Services Preferences.

For more details about using the State field, see Blocking SOAP Web Services Requests.

Bundle Installation of Integration Records

One way to install an integration record is to install a bundle that includes that record. You can use this
method to add partners’ integration records to your account, or to install a record created in a sandbox
into a production account.

Be aware that, when you use this approach, the State field on the new record is initially set to Enabled.
This configuration means that SOAP web services requests from the application are permitted. (By

SuiteTalk SOAP Web Services Platform Guide

Adding an Integration Record 50

contrast, when you install an integration record by auto-installation, the value of the State field is
determined by how you have configured the Require Approval during Auto-Installation of Integration
preference.)

After the record is installed, you can edit the record and update the State field as needed. For more
details, see Blocking SOAP Web Services Requests.

For general help installing a bundle, see the help topic SuiteApp Installation and Update.

Application Details for Client Code

When you are using the integration record to track an application, each request must include data that
identifies the application. For that reason, after you create or install an integration record, you may have
to update the client code.

There are two ways to identify the application: by using the application ID, or by using token-based
authentication (TBA). Note that it is not permitted to send both types of data. For details, see the following
topics:

■ Sending an Application ID with User Credentials

■ Token-Based Authentication Details

Sending an Application ID with User Credentials

When you track an application by using the integration record, the application can authenticate in one of
two ways: by sending an application ID and user credentials, or by using token-based authentication. For
help with token-based authentication, see Token-Based Authentication Details. For details about sending
an application ID, see the following topics:

■ Requirements for Using an Application ID and User Credentials

■ Application ID Code Samples (Request-Level Credentials)
■ Using Application ID with the Login and ssoLogin Operations

Requirements for Using an Application ID and User Credentials

If you want your request to authenticate by using user credentials, and you want to track the application
by using a specific integration record, the following must be true:

■ An integration record for the application must exist at Setup > Integration > Manage Integrations. On
the integration record, the User Credentials option must be enabled. For help creating an integration
record, see Creating an Integration Record.
■ Your request must include, either explicitly or implicitly, the application ID that was generated when
the integration record was created. If the integration was created in your NetSuite account, you can
view the application ID on the integration record. If the integration record was created by a partner,
in most cases you will obtain an updated integration from the partner that includes the application ID.

SuiteTalk SOAP Web Services Platform Guide

Application Details for Client Code 51

With request-level credentials, the application ID must be included in the header of each request. For
the login or ssoLogin request, you have an additional option, as described in Using Application ID with
the Login and ssoLogin Operations.
The request must use a Passport object, not a TokenPassport. For examples of how to include
Passport data in a request, see Authentication for SOAP Web Services.

Note that you can use either request-level credentials or the login operation. You can use any supported
WSDL. NetSuite supports WSDLs for three years. For more details about WSDL support, see Support for
Existing WSDL Versions.

Important: As of the 2020.2 SOAP web services endpoint, authentication through request-
level credentials is not supported. The Passport complex type is not supported. If you attempt to
authenticate through request-level credentials in SOAP web services 2020.2 and later endpoints,
the web services request is not processed, and an error message is returned. You must ensure
that SOAP web services integrations created with 2020.2 and later SOAP web services endpoints
use TBA. Authentication through user credentials continues to be supported in integrations that
use SOAP web services 2020.1 and earlier endpoints. For more information, see the help topic
Token-based Authentication and Web Services.

Application ID Code Samples (Request-Level Credentials)

The following procedure shows one way of updating an application to include an application ID, which is a
field in the ApplicationInfo complex type. In the following C# code snippets, application ID is added to an
integration’s request-level credentials.

For Java code samples, download the Java sample applications from the SuiteTalk Sample Applications
site.

The ApplicationInfo complex type is defined in the Messages XSD.

To add an application ID to an integration:

1. Create an ApplicationInfo class member. For example:

namespace NetSuite
{

class SOAPApplication
{

public NetSuiteService _service;

private Preferences _prefs;
private SearchPreferences _searchPreferences;
private ApplicationInfo _appInfo;

2. Create an instance of ApplicationInfo. Set the applicationId value to the actual application ID of the
relevant integration record.

private void setApplicationInfo()

{

_appInfo = new ApplicationInfo();

_service.applicationInfo = _appInfo;
_appInfo.applicationId = "C4A2541D-16FB-4845-B8A2-8B8A34BDBB61";

3. Use your instance of ApplicationInfo to modify the SOAP header that will be generated.

SuiteTalk SOAP Web Services Platform Guide

Application Details for Client Code 52

public SuiteTalkCourse()
{
ServicePointManager.ServerCertificateValidationCallback += delegate { return true; };

_service = new DataCenterAwareNetSuiteService();

setPreferences();
setPassport();
setApplicationInfo();

The next time the application sends a request, the application ID is included in the header.

<soap:Header>
<applicationInfo xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<applicationId>A7EE88F2-9DAA-43A2-9940-29AAA0E2DA61</applicationId>
</applicationInfo>
<passport xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<email xmlns="urn:core_2017_1.platform.webservices.netsuite.com">[email protected]</email>
<password xmlns="urn:core_2017_1.platform.webservices.netsuite.com">**********</password>
<account xmlns="urn:core_2017_1.platform.webservices.netsuite.com">1013519</account>
<role internalId="3" xmlns="urn:core_2017_1.platform.webservices.netsuite.com"/>
</passport>
<preferences xmlns="urn:messages_2017_1.platform.webservices.netsuite.com"/>
</soap:Header>

Using Application ID with the Login and ssoLogin Operations

Important: As of the 2020.2 SOAP web services endpoint, authentication through request-
level credentials is not supported. The Passport complex type is not supported. If you attempt to
authenticate through request-level credentials in SOAP web services 2020.2 and later endpoints,
the web services request is not processed, and an error message is returned. You must ensure
that SOAP web services integrations created with 2020.2 and later SOAP web services endpoints
use TBA. Authentication through user credentials continues to be supported in integrations that
use SOAP web services 2020.1 and earlier endpoints. For more information, see the help topic
Token-based Authentication and Web Services.

Token-Based Authentication Details

For details about using token-based authentication (TBA) with SOAP web services, see the following
topics:

■ Requirements for Using Token-Based Authentication

■ Regenerating a Consumer Key and Secret
■ TokenPassport Complex Type
■ Updating a SOAP Web Services Integration to Send Token-Based Authentication Details
■ SOAP Web Services Governance for Token-Based Authentication
■ Token-Based Authentication Errors in SOAP Web Services

Requirements for Using Token-Based Authentication

To use token-based authentication (TBA) during a SOAP web services request, you must meet several
requirements, as described in the following sections:

SuiteTalk SOAP Web Services Platform Guide

Application Details for Client Code 53

■ General Setup Requirements

■ Additional SOAP Web Services Requirements

General Setup Requirements

Before you can use token-based authentication, you must complete several setup tasks. These tasks
include the following:

■ The Token-based Authentication feature must be enabled. For details, see the help topic Enable the
Token-based Authentication Feature.
■ You must have created a role that permits login by using token-based authentication. For details, see
the help topic Set Up Token-based Authentication Roles.
■ You must have assigned a user to a role that has permission to log in by using token-based
authentication. For details, see the help topic Assign Users to Token-based Authentication Roles.
■ An integration record for the application must exist at Setup > Integration > Manage Integrations. On
the integration record, the Token-based Authentication option must be enabled. For help creating an
integration record, see Creating an Integration Record.
■ You must have the consumer key and secret that were generated when the relevant integration
record’s Token-based Authentication option was enabled. If you do not have these credentials, you
can generate new ones, for applications created in your NetSuite account. Note that if the record
was distributed via bundling, the credentials were included in the bundle, and only the owner of the
application can regenerate them. For details, see Regenerating a Consumer Key and Secret.
■ You must have created a token and token secret for the user who will send the SOAP web services
request for this application. For details on this process, see the help topic Manage TBA Tokens in the
NetSuite UI.

Additional SOAP Web Services Requirements

For an application to use token-based authentication during a SOAP web services request, all of the
following must be true:

■ The request must be made by using the 2015.2 WSDL or later.

■ The request must use request-level credentials, not the login operation. For details on the difference,
see Authentication for SOAP Web Services.
■ The request must use a TokenPassport object, not a Passport object. For help updating an integration
to use a TokenPassport, see TokenPassport Complex Type and Updating a SOAP Web Services
Integration to Send Token-Based Authentication Details.

Regenerating a Consumer Key and Secret

If you no longer have the consumer key and secret for an integration record that was created in your
NetSuite account, you can regenerate them. Be aware that when you reset these credentials, the old ones
are invalidated.

At the same time, even after you reset the consumer key and secret, you can still use a token and token
secret that were created with the original consumer data. But they must be used with the new consumer
key and secret.

If the record was installed in your account through bundling, you cannot reset the credentials. The
credentials can be reset only by an authorized user in the NetSuite account where the record was
created.

SuiteTalk SOAP Web Services Platform Guide

Application Details for Client Code 54

Note: Only administrators can complete this procedure.

To regenerate a consumer key and secret:

1. Go to Setup > Integration > Manage Integrations.

2. Select the record for which you want to generate a new consumer key and secret.
The record opens in view mode.
3. Click the Edit button.
4. Click the Reset Credentials button.
The system displays a popup message asking if you are sure you want to reset the credentials.
5. Click OK.
The system resets the credentials. The record is again shown in view mode, with the new consumer
key and secret displayed.

Warning: For security reasons, the only time the consumer key and consumer secret values are
displayed is on the confirmation page. After you leave this page, these values cannot be retrieved
from the system. If you lose or forget these credentials, you must reset them to obtain new values.
Treat these values as you would a password. Never share these credentials with unauthorized
individuals, and never send them by email.

TokenPassport Complex Type

A SOAP web services request that uses token-based authentication must use the TokenPassport complex
type. By contrast, a request that authenticates in another way uses the SsoPassport type.

The TokenPassport references the TokenPassportSignature complex type, which is another important
element in the token-based authentication process. Both complex types are defined in the Core XSD file.

For more details about these complex types, see the following sections:

■ TokenPassport
■ TokenPassportSignature

TokenPassport
The TokenPassport complex type uses the following fields. All are required:

Field Description

account Your NetSuite account ID. You can find this number at Setup > Integration > SOAP Web Services
Preferences, in the Account ID field.

consumerKey The consumer key for the integration record. This string was created when you checked the Token-
based Authentication box on the integration record and saved it. This string is shown only one
time, when it is first generated. If you no longer have this string, you can reset the credentials, as
described in Regenerating a Consumer Key and Secret.

token This is a string identifier or an ID of a token that represents a unique combination of a user, a role,
and an integration record. This string can be generated in multiple ways. For details, see the help
topic Manage TBA Tokens in the NetSuite UI.

SuiteTalk SOAP Web Services Platform Guide

Application Details for Client Code 55

Field Description

nonce This field should hold a unique, randomly generated alphanumeric string of 6–64 characters.

timestamp This field should hold a current timestamp in Unix format.

signature The signature is a hashed value. You create this value by using all of the other values in the
TokenPassport, plus the appropriate token secret and consumer secret. Along with the actual
signature, you must identify the algorithm used to create the signature. For details, see
TokenPassportSignature.

Important: To prevent issues due to out of sync time, keep time on your servers synchronized
using Network Time Protocol (NTP).

TokenPassportSignature
You use the TokenPassportSignature complex type to identify the signature, which is a hashed value.
The TokenPassportSignature also includes an attribute labeled algorithm, which you use to identify the
algorithm used to create the signature.

At a high level, you create the signature by completing the following steps:

1. Create a base string. The base string is variable created from concatenating a series of values
specific to the request. Use an ampersand as a delimiter between values. The values should be
arranged in the following sequence:
■ NetSuite account ID
■ Consumer key
■ Token
■ Nonce (a unique, randomly generated alphanumeric string, with a minimum of six characters
and maximum of 64)
■ Timestamp
For example, suppose you have the following variables:
■ NetSuite account ID – 1234567
■ Consumer key – 71cc02b731f05895561ef0862d71553a3ac99498a947c3b7beaf4a1e4a29f7c4
■ Token – 89e08d9767c5ac85b374415725567d05b54ecf0960ad2470894a52f741020d82
■ Nonce – 6obMKq0tmY8ylVOdEkA1
■ Timestamp – 1439829974
In this case, the base string would be as follows.

1234567&71cc02b731f05895561e
f0862d71553a3ac99498a947c3b7beaf4a1e4a29f7c4&89e08d9767c5ac85b374415725567d05b54ecf0960ad2470894a52f741020d82&6obMKq0t
mY8ylVOdEkA1&1439829974

2. Create a key. The key is a string variable created by concatenating the appropriate consumer
secret and token secret. These two strings should be conctatenated by using an ampersand.
For example, suppose you have the following variables:
■ Consumer secret –
7278da58caf07f5c336301a601203d10a58e948efa280f0618e25fcee1ef2abd
■ Token secret – 060cd9ab3ffbbe1e3d3918e90165ffd37ab12acc76b4691046e2d29c7d7674c2
In this case, the key would be as follows:

SuiteTalk SOAP Web Services Platform Guide

Application Details for Client Code 56

7278da58caf07f5c336301a601203d10a58e948efa280f0618e25fcee1ef2abd&060cd9ab3ffbbe1e3d3918e90165ffd37ab12ac
c76b4691046e2d29c7d7674c2

3. Choose HMAC-SHA256 as the supported hash algorithm to create an RFC 2104-compliant

signature.

Warning: The end of support for the HMAC-SHA1 signature method targeted for 2021.2
has been postponed. However, the algorithm used by the HMAC-SHA1 signature method
is no longer considered secure. You should update your integrations to use the HMAC-
SHA256 signature method as soon as possible.

4. Use the base string, the key, and the algorithm to create the signature. The signature must be
encoded by Base64.

Note: For an example of how to represent the signature and algorithm in a SOAP request, see
Token-Based Authentication Details.

Updating a SOAP Web Services Integration to Send Token-

Based Authentication Details
The following procedure and Java code snippets show one way of updating an application to include
token-based authentication (TBA) details.

You use the TokenPassport and TokenPassportSignature complex types to send TBA details. These types
are defined in the Core XSD. See also TokenPassport Complex Type.

Note that this example uses request-level credentials. When using TBA, your SOAP request must be
structured this way. The login operation is not supported. For additional requirements, see Requirements
for Using Token-Based Authentication.

Note: If a request uses token-based authentication, your request must not include an
application ID. If you include an application ID with a request that uses TBA, the request fails.

To update a SOAP web services integration to send token-based authentication

details:

1. Add logic for creating an RFC 2104-compliant signature. For example, you could add a method that
has three arguments: a base string, a key, and an algorithm. Later, you could call this method by
passing values specific to your request. (For details on the data needed to create the correct base
string and key values, see TokenPassportSignature.)
This example does not require the use of a third-party library. However, the javax.crypto package is
used.

protected String computeShaHash(String baseString, String key, String algorithm) throws Exception {

byte[] bytes = key.getBytes();

SecretKeySpec mySigningKey = new SecretKeySpec(bytes, algorithm);

SuiteTalk SOAP Web Services Platform Guide

Application Details for Client Code 57

Mac messageAuthenticationCode = Mac.getInstance(algorithm);

messageAuthenticationCode.init(mySigningKey);

byte[] hash = messageAuthenticationCode.doFinal(baseString.getBytes());

String result = new String(java.util.Base64.getEncoder().encode(hash));

return result;
}

2. Using variables that reflect data specific to your request, add logic for calling the computeShaHash
method you created in step 1 to calculate a signature.

public String computeSignature(

String account,
String consumerKey,
String consumerSecret,
String token,
String tokenSecret,
String nonce,
Long timeStamp
) throws Exception {
String baseString = account + "&" + consumerKey + "&" + token + "&" + nonce + "&" + timeStamp;

String key = consumerSecret + '&' + tokenSecret;

String signature = computeShaHash(baseString, key, "HmacSHA256");

return signature;
}

3. Add logic for creating a TokenPassport SOAP header.

@Override
public void setTokenPassport(
String account,
String consumerKey,
String token,
String nonce,
Date timestamp,
String signatureAlgorithm,
String signature
) throws Exception
{
initPort();
if(m_tokenPassport == null)
{
m_tokenPassport = new TokenPassport();
((Stub) m_port).setHeader( m_sMessagesUrn, "tokenPassport", m_tokenPassport);
}
m_tokenPassport.setAccount(account);
m_tokenPassport.setConsumerKey(consumerKey);
m_tokenPassport.setToken(token);
m_tokenPassport.setNonce(nonce);
m_tokenPassport.setTimestamp(timestamp.getTime());
TokenPassportSignature signatureElement = new TokenPassportSignature();
signatureElement.setAlgorithm(signatureAlgorithm);
signatureElement.set_value(signature);
m_tokenPassport.setSignature(signatureElement);
}

4. To add your token-based authentication credentials to a request, add logic similar to the
following. Notice that in this example, the exact variables are defined. This example calls the
computeSignature method from step 3 to create the signature. It also sets the values in the fields
of the TokenPassport object created in step 4. These values are later visible in the SOAP request.
By contrast, the consumer secret and token secret are not explicitly part of the SOAP request. They
are represented only in the signature.

SuiteTalk SOAP Web Services Platform Guide

Application Details for Client Code 58

public void testGetServerTimeWithTBA() throws Exception

{
// Constants
String sCompId = "1234567";
String consumerKey = "71cc02b731f05895561ef0862d71553a3ac99498a947c3b7beaf4a1e4a29f7c4";
String consumerSecret = "7278da58caf07f5c336301a601203d10a58e948efa280f0618e25fcee1ef2abd";
String tokenId = "89e08d9767c5ac85b374415725567d05b54ecf0960ad2470894a52f741020d82";
String tokenSecret = "060cd9ab3ffbbe1e3d3918e90165ffd37ab12acc76b4691046e2d29c7d7674c2";
String algorithm = SignatureAlgorithm._HMAC_SHA256;

// Nonce and timeStamp must be unique for each request. Also, make sure that the nonce value you
// generate does not contain special characters.

String nonce = RandomStringUtils.randomAlphanumeric(20);

Long timeStamp = System.currentTimeMillis() / 1000L;

String signature = c.computeSignature(sCompId, consumerKey, consumerSecret, tokenId, tokenSecret, nonce, timeStamp);

// create and set TokenPassport SOAP Header

// notice - no secrets are included in this call
c.setTokenPassport(
sCompId,
consumerKey,
tokenId,
nonce,
new Date(timeStamp),
algorithm,
signature);

c.getPort().getServerTime();
}

The following example shows how the resulting SOAP request should appear.

<ns:tokenPassport soap:actor="http://schemas.xmlsoap.org/soap/actor/next" soap:mustUnderstand="0" xmlns:ns="urn:mes

sages_2017_1.platform.webservices.netsuite.com">
<ns:account>1234567</ns:account>
<ns:consumerKey>71cc02b731f05895561ef0862d71553a3ac99498a947c3b7beaf4a1e4a29f7c4</ns:consumerKey>
<ns:token>89e08d9767c5ac85b374415725567d05b54ecf0960ad2470894a52f741020d82</ns:token>
<ns:nonce>6obMKq0tmY8ylVOdEkA1</ns:nonce>
<ns:timestamp>1439829974</ns:timestamp>
<ns:signature algorithm="HMAC_SHA256">fzGxUBu6SZvGqv5hk8P4ou2DPthSxXtJ4zJIeCBQK5A=</ns:signature>
</ns:tokenPassport>

Note: For the signature algorithm value, you can use either a hyphen or an underscore.
(For example, HMAC-SHA256 or HMAC_SHA256). However, the underscore is only
acceptable in a SOAP web services request. SOAP web services integrations use the
NetSuite TokenPassport complex type. The underscore is used by the SignatureAlgorithm
enumeration, which is defined in the core types XSD.

Important: Only a hyphen is acceptable in the algorithm value for RESTlets and REST
web services. RESTlets and REST web services integrations use the OAuth protocol, which
requires the use of a hyphen, for example, HMAC-SHA256. For more information, see the
help topics RESTlet Authentication and Authentication and Session Management for REST
Web Services.

SOAP Web Services Governance for Token-Based

Authentication
When requests are sent by using token-based authentication, SOAP web services uses the following
governance guidelines according to the earlier concurrency governance model. If you have a SuiteCloud

SuiteTalk SOAP Web Services Platform Guide

Application Details for Client Code 59

Plus license and have been designated a concurrent web services user, you are permitted 10 concurrent
requests. Otherwise, you are permitted one request at a time.

If you exceed these limits, the system returns the ExceededConcurrentRequestLimitFault. The
corresponding error code is WS_REQUEST_BLOCKED.

According to the web services concurrency governance introduced in 2017.2, a single user using token-
based authentication can send parallel requests up to the account limit, and the earlier web services user
concurrency limits do not apply.

Important: You can benefit from this option if the web services and REST concurrency
governance is enabled in your account. To check whether the concurrency governance is enabled
in your account, see the Web Services and RESTlet Account Governance Field on the SOAP Web
Services Preferences page, at Setup > Integration > Integration Management > SOAP Web
Services Preferences.

Additionally, the account limit is lenient, and it is possible to temporarily exceed the limit.

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

Token-Based Authentication Errors in SOAP Web Services

Check the following sections for information about the most common issues that can occur when you use
token-based authentication with SOAP web services, and for information about troubleshooting these
issues.

Ambiguous Authentication Errors

When you use token-based authentication (TBA) in SOAP web services, an ambiguous authentication
error response is returned if you use another authentication mechanism together with the TBA header.

You receive this error if besides the TBA header, your request contains an Application ID, a passport
object with an email address and a password, or a valid JSESSIONID.

The error occurs in the following cases:

■ If a single SOAP web services request contains a combination of the Passport, TokenPassport and
SsoPassport complex types.
■ If a single SOAP web services request contains both the tokenPassport and the ApplicationInfo
complex types, and therefore contains the application ID in the SOAP header.

Other Invalid Login Errors

Apart from ambiguous authentication errors, the following authentication errors may occur.

Issues with Nonce and Invalid Timestamps

The nonce and timestamp values must be unique for each request. Reusing these values is not allowed. If
the nonce had already been used, or if the timestamp is different from the correct time, an error message
is returned.

Additionally, you must make sure that the nonce value you generate does not contain special characters.

SuiteTalk SOAP Web Services Platform Guide

Application Details for Client Code 60

Issues with Sending Multiple TokenPassports in a Single Request

Sending multiple TokenPassports in the same request is not allowed and results in an invalid login error.
The SOAP request must contain exactly one TokenPassport. A TokenPassport consists of a nonce, a
timestamp, and a TokenPassportSignature. Each TokenPassport can only be used once.

For information about how to construct a TokenPassport, including code samples, see Updating a SOAP
Web Services Integration to Send Token-Based Authentication Details.

Issues with Sending the Same TokenPassport in Multiple Requests

Sending the same TokenPassport in multiple requests is not allowed, and results in an invalid login error.
You must make sure that you generate a new TokenPassport, complete with a new nonce value and the
correct timestamp for every request. One TokenPassportSignature can only be used once, even if your
code contains retry logic to send a SOAP request again if a request fails.

For information about how to correctly construct a TokenPassportSignature, including code samples, see
Updating a SOAP Web Services Integration to Send Token-Based Authentication Details.

Troubleshooting Issues with Token-Based Authentication

See the following section for information about investigating authentication issues. For additional
information, also see Using the Login Audit Trail.

Logging SOAP Requests and Responses

In general, you should log the full content of all SOAP requests and responses while you develop your
SOAP web services integration. This way you can troubleshoot your code, find out whether you use
multiple authentication methods in the same request, and also find out if subsequent requests are
sending the same nonce and timestamp.

Note: Logging the full content of SOAP requests and responses is also useful because if a
request does not pass validation, it is not logged in the SOAP web services usage log. Additionally,
even when a request using token-based authentication is logged, the authentication details are
masked in the logs for security reason. This means that you cannot use the log for investigating
authentication issues.

When a Passport and a TokenPassport are sent in the same request, the following SOAP response is
returned:

<soapenv:Body>
<soapenv:Fault>
<faultcode>soapenv:Server.userException</faultcode>
<faultstring>Ambiguous authentication</faultstring>
<detail>
<ns1:hostname xmlns:ns1="http://xml.apache.org/axis/">f-partners-java001.svale.netsuite.com</ns1:hostname>
</detail>
</soapenv:Fault>
</soapenv:Body>

When a TokenPassport and the ApplicationInfo are sent in the same request, the following SOAP
response is returned:

<soapenv:Body>
<soapenv:Fault>

SuiteTalk SOAP Web Services Platform Guide

Application Details for Client Code 61

<faultcode>soapenv:Server.userException</faultcode>
<faultstring>Ambiguous authentication</faultstring>
<detail>
<platformFaults:invalidCredentialsFault xmlns:platformFaults="urn:faults_2017_1.platform.webservices.netsuite.com">
<platformFaults:code>USER_ERROR</platformFaults:code>
<platformFaults:message>Ambiguous authentication</platformFaults:message>
</platformFaults:invalidCredentialsFault>
<ns1:hostname xmlns:ns1="http://xml.apache.org/axis/">f-partners-java002.svale.netsuite.com</ns1:hostname>
</detail>
</soapenv:Fault>
</soapenv:Body>

Blocking SOAP Web Services Requests

You can use an integration record to block SOAP web services requests that come from the
corresponding application. However, when you use this method, you block only those requests that
include data that identifies that integration record. For example, if you block Integration Record A, in
essence you are blocking only those requests that include either Integration Record A’s application ID or
its token-based authentication details.

An application that is using the 2015.1 or an earlier endpoint is not required to send this data in requests.
Requests that omit this data are handled by the Default Web Services Integrations record, which can also
be blocked.

To block web services requests:

1. Do one or both of the following:

■ To block requests that are identified with a particular integration record, open that record
for editing. Set the State field to Blocked, and click Save. After you take this action, your
NetSuite account will not accept requests that use either the application ID or token-based
authentication details specific to this record. Note also that the system will block any RESTlet
calls made using the consumer key and secret associated with this record.
■ To block SOAP web services requests from all external applications that omit an application ID
or token-based authentication details, open the Default Web Services Integrations record for
editing. Set the State field to Blocked, and click Save.

SOAP Web Services Execution Log

Each integration record includes an Execution Log subtab. Under this subtab, you find the SOAP Web
Services Execution Log. This log lists SOAP web services calls that are uniquely identified with the
integration record you are currently viewing. That is, the log includes those requests that referenced one
of the following:

■ The integration record’s application ID.

■ The integration record’s consumer key.

For each request, the log includes details such as the following:

■ The date and time that the request was made.

■ The duration of the request.
■ Information about the requests that were rejected due to a violation of the concurrency governance.
■ The WSDL version used (under the heading API Version).

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Execution Log 62

■ The email address of the user who sent the request.

■ If applicable, the record type that was the subject of the request.
■ Links to the SOAP request and response.

The data shown is similar to the data shown in the SOAP Web Services Usage Log. However, one
difference is that the SOAP Web Services Execution Log shows the version of the WSDL that was used.
The Usage Log does not.

Another difference between the two logs is that the SOAP Web Services Usage Log is not specific to any
one integration record. For more details about the SOAP Web Services Usage Log, see Using the SOAP
Web Services Usage Log.

Note: In production environments, the data is accessible for 21 days. In sandbox environments,
the data is accessible for seven days.

Distributing Integration Records

In some cases, it may be necessary to distribute an integration record to other NetSuite accounts.
Similarly, if you created a record in your sandbox account, you might want to distribute it to your
production account. You can also do the reverse: install a record created in your production account into
your sandbox.

For all of these situations, you have the following options:

■ Distributing by Auto-Installation
■ Distributing by Bundling

Distributing by Auto-Installation
When certain conditions are met, a user can auto-install an integration record into a NetSuite account or
account by sending a SOAP web services request to the target account.

One advantage of distributing by auto-installation is that users have some control over the value of the
State field on newly installed records. The initial value of this field is set according to the configuration of
the Require Approval during Auto-Installation of Integration preference.

To distribute an integration record by using auto-installation:

1. After the record has been created, open the record for editing and verify that the User Credentials
box is checked. Additionally, make a note of the record’s application ID.
2. Update the code for the integration to include the application ID associated with the record.

SuiteTalk SOAP Web Services Platform Guide

Distributing Integration Records 63

3. Do one or both of the following, as needed:

■ Provide the updated integration or the application ID to the appropriate users. For example, if
you are distributing the integration to your customers, you might want to provide them with the
updated integration code and instruct them to send a request to the account or account where
the record should be installed. You may also want to instruct users to check the configuration of
the Require Approval during Auto-Installation of Integration preference. If this preference
is set to true, the new integration record will be blocked until it is manually enabled.
■ Send a request to the account or account where you want to install the record.
When the request is received, the record is automatically installed. If the State field is set to Waiting
for Approval, an account administrator must manually enable the integration before requests can
be accepted. That is, an administrator must open the record for editing and set the State field to
Enabled.

Consider the following when bundling an integration record:

■ You cannot rebundle an integration record that someone else has included in a bundle. Only the
owner of the integration record can bundle and distribute it.
■ When you update an integration record by choosing Replace Existing Object during the bundle
update, you cannot distribute the integration record anymore since it belongs to the bundle author.
■ You can rebundle an integration record when you do a bundle copy.

SuiteTalk SOAP Web Services Platform Guide

Distributing Integration Records 64

Note: Note that when you distribute an integration record by bundling, its State field is initially
set to Enabled in the target account. By contrast, if you distribute the record by auto-installation,
the initial value is determined by the configuration of the Require Approval during Auto-
Installation of Integration preference.

Note: If the integration record is installed in your account by bundling, you cannot reset the
credentials. The credentials can be reset only by an authorized user in the NetSuite account where
the record was created. For more information, see Regenerating a Consumer Key and Secret.

Default Web Services Integrations Record

The Default Web Services Integrations Records were permitted only for requests that used the 2015.1 or
previous endpoint. These endpoints are no longer available, so Default Web Services Integrations are no
longer permitted.

If you were using a Default Web Services Integrations Record, you must create a new Integration Record
to use, as described in Creating an Integration Record.

Note: For information about integration records in general, see Integration Record Overview.

Using Integration Records in Sandbox Accounts

An integration record you create in a sandbox account can be installed in your production account, either
through bundling or auto-installation. You can also install records in your sandbox that were created
elsewhere, either in your production account or in another NetSuite account.

For details, see Auto-Installation of Integration Records and Bundle Installation of Integration Records.

Important: If you create an integration record in a sandbox account and then install it in a
production account, you will not be the owner of the integration record in the production account.
This means that you cannot update every field of the integration record in the production
account. To have full control of the integration record in a production account, create the
integration record directly in the production account.

If an integration record is created in your sandbox account and later installed in your production account,
after a sandbox refresh, the integration record settings are copied from your production account to your
sandbox account. For details, see Sandbox Refresh Impact on Integration Records.

Recommended Development Process for Integration Records

1. Create an integration record in a sandbox account and test your integration.

2. After testing, create a new integration record in your production account, and use the settings that
you tested in your sandbox account.

When you update a specific integration record in another account, the behavior of the integration records
in different accounts can be different. For more details, see the following sections:

■ Common Fields Between Production and Sandbox Accounts

SuiteTalk SOAP Web Services Platform Guide

Using Integration Records in Sandbox Accounts 65

■ Sharing Integration Records Between Sandbox and Production Accounts

■ Sandbox Refresh Impact on Integration Records

Note: For details on using token-based authentication with integration records with production
and sandbox accounts, see Token-based Authentication Credentials and Accounts.

Common Fields Between Production and Sandbox

Accounts
Integration records have fields that are specific for each account, and fields that are common between all
accounts where the integration record is installed. The following fields are common:

■ Application ID
■ Name
■ Description
■ Authentication
■ Consumer Key
■ Consumer Secret

The Consumer Key and Consumer Secret are not directly editable. You cannot change them directly, but
you can regenerate them if needed. The Consumer Key and Consumer Secret can only be regenerated in
the account where the integration record was created.

Important: The Application ID is not editable.

Note: For details on distributing an integration record, see Distributing Integration Records.

Sharing Integration Records Between Sandbox and

Production Accounts
You can create an integration record in your sandbox account and install or auto-install it in your
production account, or the other way around. In this case, you cannot fully manage the integration record
in the account where you installed or auto-installed it, and you can only edit the State and the Note fields.

Sandbox Refresh Impact on Integration Records

When a sandbox account is refreshed, production data is copied to the sandbox account, and the earlier
sandbox content is overwritten. A sandbox refresh is one of the few ways that an integration record can
be uninstalled from a NetSuite account. That is, if a record was created in your sandbox account but not
installed in your production account, it is removed as part of the sandbox refresh. After the refresh, the
integration record can be auto-installed back into the sandbox account, if you have the application ID.
However, you will not have full control of that integration record in the sandbox.

After every sandbox refresh, review the list of integration records, and block those you do not plan to
use, because after the refresh all production integration records are copied to your sandbox accounts,
including the production settings.

SuiteTalk SOAP Web Services Platform Guide

Using Integration Records in Sandbox Accounts 66

If you auto-install the integration record, be aware that data specific to the first installation is not retained.
Data contained in the SOAP Web Services Execution Log, the State field, and the Note field is deleted. For
details, see Auto-Installation of Integration Records.

Token-based Authentication Credentials and

Accounts
If you are using token-based authentication (TBA) in your sandbox and production account, be aware of
the following:

■ The Token Key and Token Secret used for TBA are always different in each account.
■ The Token Key and Token Secret are deleted in your sandbox account after each sandbox refresh,
and you must regenerate them. This has no impact on the Token Key and Token Secret used in your
production account.
■ The Consumer Key and Consumer Secret can be shared between your sandbox and production
accounts if you create an integration record in one account and install it on the other one. In this
case, if you regenerate the Consumer Key or Consumer Secret in your sandbox account, they will
be automatically changed in your production account and this can break your production account
integrations.

Recommended practices:

■ Create a separate integration record in each account to avoid changes in the production account
when credentials are regenerated in a sandbox account.
■ If you decide after testing that you need to make changes to an integration record, create a new
record in your production account with those changes.

Not recommended practice:

■ Do not create new integration records if you only need to change the settings of an existing
integration record or only need to regenerate authentication credentials. Instead, make changes on
an existing integration record in your sandbox account and then install the integration record in your
production account.

Using Integration Records in Conjunction With SSO

Calls
If you are using SOAP web services for single sign-on requests, be aware of the following:

■ With outbound single sign-on requests (SuiteSignOn requests), you do not have to send an
application ID, regardless of which endpoint you are using.

Removing Integration Records

When an integration record is created in a NetSuite account by a user filling out the Integration form, two
things happen: A record is added to, or installed, in that NetSuite account. Additionally, within the broader
NetSuite database, a definition of that record is created. This definition can never be deleted. However, in

SuiteTalk SOAP Web Services Platform Guide

Removing Integration Records 67

some cases, the record can be uninstalled from the account in which it was created or the one to which it
was distributed.

Further, you can always hide an integration record from the list view available at Setup > Integration >
Manage Integrations.

For details, see the following topics:

■ Uninstalling an Integration Record from a NetSuite Account

■ Removing Installed Integration Records from View

Uninstalling an Integration Record from a NetSuite

Account
An integration record can be uninstalled from a NetSuite account only in the following scenarios:

■ If you install an integration record as part of a bundle, the record can be uninstalled from your
account if you uninstall the bundle. Similarly, if the bundle owner removes the record from the bundle,
you can remove the record when you update the bundle.
■ If you create an integration record in a sandbox account and you do not propagate it to the
production account, the record is removed when the sandbox is refreshed.

If you remove the integration record in either of the following scenarios, you can still auto-install the
application later in certain circumstances. For details, see Auto-Installation of Integration Records.

Removing Installed Integration Records from View

Regardless of how an integration record was added to your account, you can hide it from view by blocking
it.

To remove an integration record from view:

1. Navigate to Setup > Integration > Manage Integrations, and open the appropriate record for
editing. Set the State field to Blocked. Note that making this change prevents the application from
authenticating to NetSuite by using the application ID or consumer key associated with this record.
For further details, see Blocking SOAP Web Services Requests. Click Save.
2. In the list view, make sure the Show Inactives box has been cleared. This configuration ensures
that no blocked applications appear in the list view.

Tracking Changes to Integration Records

If you want to review changes that were made to an integration record, you can refer to the system notes
for that record. System notes are used to track events such as the creation of the record, the initial values
of its fields, and subsequent updates. For example, if a user changed the State field from Blocked to
Enabled, a system note would provide a record of that change.

For each event, the system records details such as the ID of the user who made the change and the
timestamp of the change. If a user changed the value of the field, the system note also shows the field’s
former value.

For more details, see the following topics:

SuiteTalk SOAP Web Services Platform Guide

Tracking Changes to Integration Records 68

■ Finding System Notes for an Integration Record

■ Special Cases Related to System Notes Logging

For general details about working with system notes, see the help topics System Notes Overview and
Searching System Notes.

Finding System Notes for an Integration Record

You can locate system notes for integration records in either of the following ways:

■ By using the System Note search type, at Reports > New Search.

■ By clicking on the System Notes subtab of any integration record.

Special Cases Related to System Notes Logging

System notes for the integration record are similar to system notes for other types of records. However,
be aware of special behaviors related to certain fields and situations, as follows:

■ Logging for the Last State Change Field

■ Logging for the State Field
■ Logging for the Reset Credentials Button
■ Generation of an Application ID Is Not logged
■ Logging for Records Shared by Sandbox and Production Accounts
■ Notes Are Logged Only for Fields You Have Permission to Modify

Logging for the Last State Change Field

The Last State Change field shows the date of the last change to the State field. Changes to this field are
reflected in the record’s system notes. However, note the following: If the State field is changed multiple

SuiteTalk SOAP Web Services Platform Guide

Tracking Changes to Integration Records 69

times in one day, only one system note is created to reflect modification to the Last State Change field.
The reason is that this field shows only a date, not a time of day.

However, you can track the details — including the times — of all State changes, by the system notes
logging for the State and Last State Change By fields: System notes are created to reflect all of each
day’s changes to these fields. Each of these system notes includes a date and time.

For example, the following screenshot shows system notes for a record that had its State changed
several times on Feb. 5. The log includes only one change to the Last State Change field, but the details
of each State change are logged through the other system notes.

Logging for the State Field

When you create an integration record and save it with its State set to the default of Enabled, the system
logs two system notes in regard to this field: One note shows that the field initially had a value of Blocked.
Another system note with the same timestamp shows that the field’s value changed to Enabled.

By contrast, if an integration record was installed through auto-installation or bundling, only one event is
listed for the State field. This note shows that the field was saved with whatever value it had at the time of
installation.

SuiteTalk SOAP Web Services Platform Guide

Tracking Changes to Integration Records 70

Logging for the Reset Credentials Button

If you own an integration record that has the Token-based Authentication option selected, you may at
times need to reset the consumer key and secret. To regenerate these values, you open the record for
editing and click the Reset Credentials button. This action is logged in the system notes as the setting of
the Token-Based Authentication Credentials field. The system lists a new value of Reset Credentials.

The actual credentials are not displayed in the system notes, just as they are not displayed anywhere on
the record after being shown for the first time.

Generation of an Application ID Is Not logged

When you create a new integration record in your account, an application ID is automatically generated.
However, this value is not one of those values listed in the system notes at the time you save the new
record. The system notes contain no indication that a value for the field was set.

If you need to locate the application ID, it is visible on the integration record itself and in the integration
record list view, but only by authorized users in the account that owns the record. Note that, although
application IDs are not considered authentication credentials, NetSuite nevertheless recommends that
application IDs be considered confidential.

Logging for Records Shared by Sandbox and Production

Accounts
In some cases, an integration record might exist in both your production and sandbox accounts. For
example, you could create a record in your sandbox and install it in your production account. In many

SuiteTalk SOAP Web Services Platform Guide

Tracking Changes to Integration Records 71

such cases, the record is fully editable in both accounts. (For details on when this is possible, see Using
Integration Records in Sandbox Accounts.) However, if you make a change in one account and the change
is propagated to another account, be aware that a system note is created only in the account where the
change was made.

Notes Are Logged Only for Fields You Have Permission to

Modify
In general, if you install an integration record, system notes are created only for those fields that you are
permitted to change. For that reason, the same record, when viewed in the account that owns it, contains
system notes for a greater number of fields.

This distinction may be particularly noticeable if an account owner makes changes to fields that other
accounts are not permitted to change. These updates are propagated to all accounts that have installed
the record, but system notes are not created in the other accounts.

For details on how ownership of an integration record affects system notes for various fields, see the
following table.

Field Notes

Created By When a record is created or installed, a system note is created to show the value of the
Created By field. However, the way this field is populated varies, as follows: In the account
where the record was created, the field’s value identifies the person who created the record. If
the record was installed, the field identifies the person who installed the record.

Description System notes for the Description field exist only in the owner’s account, even though changes
are pushed to all accounts where the record has been installed.

Name A system note is created for the Name field in an account that installs the record, even though
that account does not have the ability to edit the field. In this sense, the Name field is unique
among fields that are not modifiable by non-owning accounts. Note also that subsequent
changes to the Name field by the account that owns the record are not propagated outside
the account that owns the record, even though a bundle update may show a new name for
the record.

Note Data in the Note field is specific to the account where the record is installed. Therefore, a
value for the Note field is never set during installation, and no system note is created for it
at the time of installation. If you add a value for the field after installation, a system note is
created.

Token-based System notes for the Token-based Authentication field exist only in the owner’s account,
Authentication even though changes are pushed to all accounts where the record has been installed.

User Credentials System notes for the User Credentials field exist only in the owner’s account, even though
changes are pushed to all accounts where the record has been installed.

SuiteTalk SOAP Web Services Platform Guide

Roles and Permissions in SOAP Web Services 72

Roles and Permissions in SOAP Web

Services
NetSuite provides many standard roles with predefined permissions. A role is a set of permissions that
allows customers, vendors, partners and employees access to specific aspects of your data. Each role
grants access at a certain level for each permission.

When logging in using SOAP web services you may provide a role id along with your credentials.
The role id that you provide must have SOAP web services permissions, otherwise an
INSUFFICIENT_PERMISSION error is returned. If no role id is provided, then the user's default role is
used. If the default role does NOT have SOAP web services permissions, then a ROLE_REQUIRED fault is
returned.

The following topics are provided in this section. They do not need to be read in order. However if you
are new to NetSuite SOAP web services, it is recommended that you read each topic to understand how
NetSuite roles and permissions apply in a SOAP web services context.

■ Role and Permission Considerations When Developing in SOAP Web Services

■ Assigning the SOAP Web Services Permission to a Role
■ Setting a Default Role for a SOAP Web Services User
■ Setting a Web Services Only Role for a User
■ Customer Center, Vendor Center, and Partner Center Roles
■ Internal IDs Associated with Roles

Role and Permission Considerations When

Developing in SOAP Web Services
Due to SOAP web services’ reliance on the NetSuite role-based permissions, it is important for SOAP
web services developers to put that into considerations during the design phase to ensure smooth
deployments.

It is common for developers to use the administrator role during development time because it gives them
full permissions and access to all the records and operations. However, the target end users are likely
to have less powerful roles, which may not have access to the data the SOAP web services application
requires.

Another role-related consideration is the preferred custom forms of some roles may not have access to
certain fields or sublists that a SOAP application requires. Hence the application's attempts to set those
fields will result in permission errors.

The solution to these problems is to define a custom role and custom forms for the SOAP application. The
custom role should have the correct access permissions and operations permissions that the SOAP web
services application needs. The custom forms should give access to fields and sublists that are relevant to
the SOAP application. All SOAP web services supported records have a customForm field for the application
to reference specific custom forms.

SuiteTalk SOAP Web Services Platform Guide

Role and Permission Considerations When Developing in SOAP Web Services 73

Note: In 2016.2, a permission has been added to the Role page on the Permissions > Setup
subtab. If the Control SuiteScript and Workflow Triggers in Web Services Request permission is
selected, users cannot change the setting for scripts and workflow triggers on individual SOAP
web services requests. For users who do not have permission to disable scripts, the global setting
for the account applies for all of their requests.

Important: When testing SOAP web services applications, you should do so using the role(s) of
your intended users(s), in addition to the administrator role, to catch permission-related defects.

Assigning the SOAP Web Services Permission to a

Role
All standard NetSuite roles have SOAP web services permissions by default. For security reasons, it
is recommended that you restrict permissions levels and access allowing only the most restricted
permissions necessary to perform a particular set of operations.

For non-standard or custom roles, use these steps to assign the SOAP web services permission to the
role.

To assign the SOAP Web Services permission to a role:

1. Go to Setup > Users/Roles > Manage Roles.

2. Locate the role you want to modify. Click Edit or Customize.
3. Click the Setup subtab.
4. In the Permissions dropdown list, select SOAP Web Services.
5. In the Level dropdown list, select Full.

Note: Users with a SOAP Web Services permission level other than Full (View, Create,
Edit) cannot log in to SOAP web services. The Full level is required. Also note that the SOAP
Web Services permission does not provide access to the SOAP Web Services Usage Log
or to integration records; only administrators can access these pages. For details on the
SOAP Web Services Usage Log, see Using the SOAP Web Services Usage Log. For details on
working with integration records, see SOAP Web Services Security.

6. Click Add.
7. Click Save.

Note also:

■ If you are building an integrated application, it is best to create a new role or customize an existing
role and grant the minimum set of permissions that are necessary for the client to carry out its
functions. It is not recommended that users are assigned administrator privileges for use with SOAP
web services.
■ If your role has permission to view credit card data on the user interface, you can also retrieve this
information through SOAP web services calls. This is beneficial to integrated applications that use an
external credit card processing profile. Based on your role, you may be able to retrieve the credit card
on file for your customers.

SuiteTalk SOAP Web Services Platform Guide

Assigning the SOAP Web Services Permission to a Role 74

■ In order for a role to use the getDeleted operation, the role has to have both the Deleted Records and
the SOAP Web Services permissions. Note that users who have the Deleted Records permission can
access results about any type of record that was deleted, even if they do not have permission to create
or modify that record type. They also have permission to use the Deleted Record search type, unless
the Web Services Only option has been selected for the role.

Setting a Default Role for a SOAP Web Services

User
You can specify a default role for any user making SOAP web services requests. The permissions for the
default role are determined as follows:

■ If a role preference is not set at the request level, then any default SOAP web services role as defined
in the Web Services Preference page for the specific user is used.
Only one default SOAP web services role can be assigned per user and only roles that contain the
SOAP web services permission can be specified as a default SOAP web services role. Note that the user
may be assigned a different role than those specified in their employee record. In other words, a user
may have greater or lesser permissions using SOAP web services as compared to the UI.
■ If neither the request nor the SOAP web services default role is set, then one of these roles is used,
selected in the following order:
□ A non-Customer Center role in the account, indicated as the default role.
□ A non-Customer Center role in the account, selected based on the last login date.
□ A Customer Center role in the account, indicated as the default role.
□ A Customer Center role in the account, selected based on the last login date.

Note: All standard roles have the SOAP web services permission by default when the SOAP
web services feature is enabled. Custom roles, however, must be explicitly set to have SOAP web
services permissions. For information about creating custom roles, see the help topic Customizing
or Creating NetSuite Roles

To set a specific default role for a SOAP web services user:

1. Go to Setup > Integration > Integration Management > SOAP Web Services Preferences.
2. Select the user from the Name list.
3. Select the default role to use for SOAP web services requests for this user.
The internal ID for the selected role automatically populates the ID field.
4. Click OK.
5. Click Save.

Setting a Web Services Only Role for a User

In NetSuite you can designate a user's role as Web Services Only. When a user logs in with a role that
has been designated as Web Services Only, validation is performed to ensure that the user is logging in
through SOAP web services and not through the UI.

SuiteTalk SOAP Web Services Platform Guide

Setting a Web Services Only Role for a User 75

Note: Your account must have the SOAP web services feature enabled for the Web Services
Only check box to appear. See Enabling the SOAP Web Services Feature for steps on enabling this
feature.

The Web Services Only role increases the security of an integrated application by prohibiting a UI user
from accessing the system with permissions and privileges that are specifically created for a web services
applications. For example, you may have a web services application that requires certain employees
to have write access to several records. However, you want to prohibit the employees from being able
to edit these records directly from within the NetSuite UI. If you assign the Web Services Only role to
specified employees, the employees can log in to NetSuite and access the application through web
services, however, the employees cannot switch to their other roles within the system and write, edit, or
delete these data-sensitive records.

Important: The Web Services Only role does not appear in the Change Role list. Therefore,
users cannot change their roles from their original UI login role (A/P clerk, for example) to their
Web Services Only role from within the UI.

To designate a role as Web Services Only:

1. Click Setup > Users/Roles > Manage Roles.

2. On the Manage Roles list page, locate the role you want to set as Web Services Only.
3. Click Edit or Customize.
4. Check the Web Services Only Role box.
5. Click Save.

Note: A role designated as Web Services Only prohibits the user from accessing NetSuite
through the UI. The intention is to enhance the security of your integrations. However, checking
the Web Services Only box does not exclude access to NetSuite by other non-UI methods.
Be aware that a Web Services Only role could combine with other access permissions. For
example, if you designate a role as Web Services Only, and that role (or a user) also has
SuiteAnalytics Connect permissions, the user could also access NetSuite through ODBC.

When to Set the Web Services Only Role

A role should not be designated as Web Services Only until the developers building and testing the
integrated application have completed the application. Waiting to designate a role as Web Services Only
allows developers to go back and forth during design and development time to test the permissions for
the role that is designed specifically for an integrated application. After the development and testing is
complete, the developer can set the Web Services Only role to TRUE for a specified role to prevent users
with this role access to the UI with this set of permissions and privileges.

Note: External roles such as Customer Center, Partner Center, Advanced Partner Center, Vendor
Center, and Employee Center should not be customized to have Web Services Only permissions.

Customer Center, Vendor Center, and Partner

Center Roles
The Customer Center, Vendor Center, and Partner Center roles have implicit SOAP web services
permissions. This allows integration with an externally hosted website where a client can execute any task

SuiteTalk SOAP Web Services Platform Guide

Customer Center, Vendor Center, and Partner Center Roles 76

available under the center-specific role through SOAP web services. For example, the client could login
and submit an order on behalf of the customer.

Note: It is not recommended that you customize Customer Center, Partner Center, or Partner
Center Roles to have only Web Services Only permissions. For information on the Web Services
Only role, see Setting a Web Services Only Role for a User.

If you choose you can remove SOAP web services permissions from the Customer Center, Vendor Center,
and Partner Center roles.

To remove SOAP web services permissions:

1. Go to Setup > Users/Roles > Manage Roles.

2. Locate the role you want to modify.
3. Click Edit or Customize.
4. Click the Setup subtab.
5. In the Permissions list, click the SOAP Web Services line to make it editable.
6. In the Level column, select the value None from the list.
7. Click OK to stop editing the SOAP Web Services line.
8. Click Save.

Internal IDs Associated with Roles

If you have the Show Internal IDs preference on, you can look up the internal ID of a role by going to
Setup > Users/Roles > User Management > Manage Roles (Administrator). The role ID appears in the
Internal ID column. For instructions on setting the Show Internal IDs preference, see Setting the Internal
ID Preference.

Note: The administrator role is not displayed in the Manage Roles page. The internal ID for the
administrator role is 3 in every NetSuite account.

For information about the permissions associated with standard roles, see the help topic Standard Roles
Permissions Table.

You can use the internal IDs of roles in the Passport object, which is used for authentication. For
information about the available authentication methods, see Authentication for SOAP Web Services.

Note: In addition to the NetSuite standard roles, there may exist custom roles that have been
created by your organization. Custom roles are assigned internal IDs sequentially (starting with
1001).

Important: Administrators and users with Full Access roles must use two-factor authentication
in newly provisioned accounts. For more information, see the help topic 2FA in the NetSuite
Application. Using the Administrator role for SOAP web services is not recommended. Using the
Full Access role at all is not recommended. As of 2019.1, changes have been made to the Full
Access role, in preparation for its deprecation.

SuiteTalk SOAP Web Services Platform Guide

Records, Fields, Forms, and Sublists in SOAP Web Services 77

Records, Fields, Forms, and Sublists in SOAP

Web Services
The following topics are covered in this section. These topics do not need to be read in order, however, if
you are new to SOAP web services development, you will need to review each section to fully understand
the SOAP web services API.

■ Records in SOAP Web Services

■ Fields in SOAP Web Services
■ Forms in SOAP Web Services
■ Sublists in SOAP Web Services

Records in SOAP Web Services

Most standard NetSuite records are supported by SOAP web services. The list of supported records
spans all areas of the NetSuite application from ERP to CRM to customization. For a list of records that are
supported in SOAP web services, see the help topic SOAP Web Services Supported Records.
In the SOAP API, the Record class is the abstract super-class of all supported records. A supported record
is always a concrete sub-class of Record. Due to the neutrality required to be language agnostic, the
SOAP web services classes inheritance chain remains simplistic and does not implement language-specific
object-oriented concepts such as multiple inheritance and interfaces.
NetSuite records are divided into the following broad categories:

■ Record Types
■ Search Records
■ Subrecords

A record's standard body fields are its attributes, for example: Customer.email, SalesOrder.salesRep.
Composite attributes such as line items or sublists are structured as complex objects that contain arrays,
for example: SalesOrder.itemList, CalendarEvent.attendeeList. Custom fields within a record (if
available) are also structured as composite attributes, for example: Contact.customFieldList.

Note: A record element that ends with List is generally a sublist. (The exception is the
customFieldList element, which represents custom fields on the record.) For information on
working with sublists in SOAP web services, see Sublists in SOAP Web Services. For more general
information on sublists in NetSuite, see the help topic What is a Sublist?

In addition to standard records, SOAP web services also supports custom objects and their metadata (see
the help topic Customization for more details). Using the getCustomizationId SOAP API, an application
external to NetSuite can query a NetSuite account to obtain metadata about the custom objects that have
been implemented in the account. This lets you build and ship generic applications that will work with
any account. For example, a SOAP web services point-of-sale application can be designed to determine
(during runtime) all the custom fields applied to a NetSuite CashSale record, so that it can then import
CashSale records with the necessary custom fields set.

Record Types
A NetSuite record type typically represents specific business functions such as creating a customer or
updating an opportunity. For a list of all supported record types, see the help topic SOAP Web Services
Supported Records.

SuiteTalk SOAP Web Services Platform Guide

Records in SOAP Web Services 78

Search Records
Search record types encapsulate the available search criteria for a specific NetSuite record type. A
NetSuite search record is defined as a top-level record that is used in the request portion of a search
operation. Any field defined within a search record must be of one of the following logical types.

Type Description

String Corresponds to the SearchStringField type

Int Corresponds to the SearchTextNumberField type

Double Corresponds to the SearchDoubleField type

Boolean Corresponds to the SearchBooleanField type

Datetime Corresponds to the SearchDateField type

MultiSelectRef Corresponds to the SearchMultiSelectField type

MultiSelectEnum Corresponds to the SearchEnumMultiSelectField type

For details on using the search operation, see search. Also see the following topics, which describe all
search types that can be used when constructing SOAP web services searches.

■ SOAP Objects Used in a Basic Search

■ SOAP Objects Used in a Joined Search
■ SOAP Objects used in Advanced Searches

Subrecords
A subrecord is similar to a record. You can take many of the same actions with a subrecord as you can
with a record. However, like a sublist, an instance of a subrecord is always contained within a parent
record. The first subrecord, inventory detail, was exposed to SOAP web services in the 2011.2 endpoint.

Any add, get, update, delete, or search operation on a subrecord must be performed within the context of
an operation on its parent record. For example, if you want to update inventory detail data for a purchase
order transaction, you must update the purchase order record itself. You cannot do an independent
update of the inventory detail object. This limitation applies to all operations on a subrecord.

When working with subrecords, the replaceAll attribute determines whether the subrecord will be added
or updated during an update operation on its parent record. If this attribute is set to true, the subrecord
is deleted and a new one is added. If replaceAll is set to false, the existing subrecord is updated.

Using Internal IDs, External IDs, and References

Each record in NetSuite can be uniquely identified by its record type in combination with either an
external ID or a system-generated NetSuite internal ID.

SuiteTalk SOAP Web Services Platform Guide

Records in SOAP Web Services 79

Important: To see the internal IDs for all fields, records, lists, and custom forms, enable the
Show Internal IDs preference. See Setting the Show Internal IDs Preference. External IDs are
not displayed on records by default. However, you can search for external IDs, or you can add a
custom field to the record types where you want to the external ID to be displayed in the UI. For
information about searching in SOAP web services, see Basic Searches in SOAP Web Services. For
information about working with custom fields, see the help topic Custom Fields.

Internal and external IDs are NOT unique across all record types. Therefore, to perform an operation on
an existing record, you need two pieces of data: the record type and either the internal ID or the external
ID.
References are implemented through the RecordRef type, which is defined in the core XSD.
The RecordRef type is described by three attributes — the internal ID, external ID, and the type:

Important: When referencing records in an update operation, you must provide either the
internal ID or the external ID, but not both. If both are provided, the internal ID is used to locate
the record and the external ID is ignored. Additionally, the external ID attribute is case insensitive.

Uniqueness of Internal and External IDs

Internal and external IDs must be unique not just within a specific record type, but also within certain
record groups. These groups consist of multiple record types. For details, see Shared Internal and
External IDs.
Internal IDs are not reused in the system. After an internal ID has been assigned, if the associated record
is subsequently deleted, the ID is not reused.
Note also that an external ID exists only if you provided it, either at the time of record creation or during
an update. For more on external IDs, see External IDs Overview.

Internal IDs Do Not Indicate When Record Was Created

The assignment of internal IDs to new records is sequential. However, the sequence of internal IDs does
not indicate when or in which order records were added. This is true even within specific record groups
where internal IDs are unique. Therefore, you should not conclude that records with lower internal IDs
were added first, whereas those with higher internal IDs were added last.
Consider the following example. All records belonging to the same high-level group share the same ID
pool. For example, sales orders and invoices both belong to the group of transaction records. When you
create a sales order and it is assigned 1234 as the internal ID, you should not assume that the internal ID
of the next sales order will be 1235. If an invoice or another transaction record is created right after sales
order 1234, that record might have 1235 as internal ID. Additionally, there can be gaps between internal
IDs. Two sales orders created a few minutes’ apart might have a significant gap between their internal
IDs.
For custom applications that rely on the chronological aspect of when data was entered, you should use
the Date Modified or Date Created fields, as they are guaranteed to be chronological. Additionally, for
transactions with auto-generated numbers, the sequence number (for example, “tranid”) is guaranteed
to be sequential based on the date transactions were entered. The internal ID of a record should never

SuiteTalk SOAP Web Services Platform Guide

Records in SOAP Web Services 80

be used to determine when data was entered, and you should not build any functionality based on the
sequence of internal IDs.

Internal IDs for NetSuite Record Types

Like individual records, each record type also has an internal ID. In certain situations, you must use this
ID to specify which type of record you are referencing. By contrast, in some cases, you can use a string
to reference the record type (for example, when using RecordRef). But in other cases you must use the
internal ID, or typeId (for example, when using ListOrRecordRef or CustomRecordRef). The table below
lists the NetSuite record types and their associated typeIds.
Custom fields of the type MultiSelectCustomFieldRef on custom records also reference these values,
because they contain an array of ListOrRecordRef types. For details on working with custom records, see
the help topic Custom Record.

Record Type typeId

ACCOUNT -112

ACCOUNTINGPERIOD -105

ADDRESS -289

ADVINTERCOMPANYJOURNALENTRY -30

APPDEFINITION -255

APPPACKAGE -254

ASSEMBLYBUILD -30

ASSEMBLYITEM -10

ASSEMBLYUNBUILD -30

BILLINGACCOUNT -333

BILLINGSCHEDULE -141

BIN -242

BINTRANSFER -30

BINWORKSHEET -30

BOM -422

BOMREVISION -423

BUDGETCATEGORY -396

BUDGETIMPORT -420

CALENDAREVENT -20

CAMPAIGN -24

CAMPAIGNAUDIENCE -142

CAMPAIGNCATEGORY -143

CAMPAIGNCHANNEL -144

CAMPAIGNFAMILY -145

SuiteTalk SOAP Web Services Platform Guide

Records in SOAP Web Services 81

Record Type typeId

CAMPAIGNOFFER -146

CAMPAIGNRESPONSE -130

CAMPAIGNSEARCHENGINE -148

CAMPAIGNSUBSCRIPTION -149

CAMPAIGNVERTICAL -150

CASHREFUND -30

CASHSALE -30

CHARGE -290

CHECK -30

CLASSIFICATION -101

CONSOLIDATEDEXCHANGERATE -322

CONTACT -6

CONTACTCATEGORY -158

CONTACTROLE -157

COSTCATEGORY -155

CREDITMEMO -30

CRMCUSTOMFIELD -124

CURRENCY -122

CUSTOMER -2

CUSTOMERCATEGORY -109

CUSTOMERDEPOSIT -30

CUSTOMERMESSAGE -161

CUSTOMERPAYMENT -30

CUSTOMERREFUND -30

CUSTOMERSTATUS -104

CUSTOMLIST -123

CUSTOMRECORDCUSTOMFIELD -124

CUSTOMRECORDTYPE -123

CUSTOMTRANSACTION -30

SuiteTalk SOAP Web Services Platform Guide

Records in SOAP Web Services 82

Record Type typeId

DEPARTMENT -102

DEPOSIT -30

DEPOSITAPPLICATION -30

DESCRIPTIONITEM -10

DISCOUNTITEM -10

DOWNLOADITEM -10

EMPLOYEE -4

ENTITYCUSTOMFIELD -124

ESTIMATE -30

EXPENSECATEGORY -126

EXPENSEREPORT -30

FAIRVALUEPRICE -332

GENERALTOKEN -540

GIFTCERTIFICATEITEM -10

GLOBALACCOUNTMAPPING -250

HCMJOB -355

INBOUNDSHIPMENT -427

INTERCOMPANYJOURNALENTRY -30

INTERCOMPANYTRANSFERORDER -30

INVENTORYADJUSTMENT -30

INVENTORYCOSTREVALUATION -30

INVENTORYDETAIL -260

INVENTORYITEM -10

INVENTORYNUMBER -266

INVENTORYTRANSFER -30

INVOICE -30

ISSUE -26

ITEM -10

ITEMACCOUNTMAPPING -251

ITEMCUSTOMFIELD -124

ITEMDEMANDPLAN -246

ITEMFULFILLMENT -30

SuiteTalk SOAP Web Services Platform Guide

Records in SOAP Web Services 83

Record Type typeId

ITEMGROUP -10

ITEMNUMBERCUSTOMFIELD -124

ITEMOPTIONCUSTOMFIELD -124

ITEMRECEIPT -30

ITEMREVISION -269

ITEMSUPPLYPLAN -247

JOB -7

JOBTYPE -177

JOURNALENTRY -30

KITITEM -10

LOCATION -103

LOTNUMBEREDASSEMBLYITEM -10

LOTNUMBEREDINVENTORYITEM -10

MANUFACTURINGCOSTTEMPLATE -294

MANUFACTURINGOPERATIONTASK -36

MANUFACTURINGROUTING -288

MARKUPITEM -10

NEXUS -400

NONINVENTORYPURCHASEITEM -10

NONINVENTORYRESALEITEM -10

NONINVENTORYSALEITEM -10

NOTE -303

NOTETYPE -180

OPPORTUNITY -31

OTHERCHARGEPURCHASEITEM -10

OTHERCHARGERESALEITEM -10

OTHERCHARGESALEITEM -10

OTHERCUSTOMFIELD -124

OTHERNAMECATEGORY -181

PARTNER -5

PARTNERCATEGORY -182

PAYCHECK -30

SuiteTalk SOAP Web Services Platform Guide

Records in SOAP Web Services 84

Record Type typeId

PAYCHECKJOURNAL -30

PAYMENTCARD -538

PAYMENTCARDTOKEN -539

PAYMENTITEM -10

PAYMENTMETHOD -183

PAYROLLITEM -265

PHONECALL -22

PRICELEVEL -186

PRICINGGROUP -187

PROJECTTASK -27

PROMOTIONCODE -121

PURCHASEORDER -30

PURCHASEREQUISITION -30

RESOURCEALLOCATION -28

RETURNAUTHORIZATION -30

SALESORDER -30

SALESROLE -191

SALESTAXITEM -128

SERIALIZEDASSEMBLYITEM -10

SERIALIZEDINVENTORYITEM -10

SERVICEPURCHASEITEM -10

SERVICERESALEITEM -10

SERVICESALEITEM -10

SOLUTION -25

STATISTICALJOURNALENTRY -30

SUBSIDIARY -117

SUBTOTALITEM -10

SUPPORTCASE -23

SUPPORTCASEISSUE -151

SUPPORTCASEORIGIN -152

SUPPORTCASEPRIORITY -153

SUPPORTCASESTATUS -132

SuiteTalk SOAP Web Services Platform Guide

Records in SOAP Web Services 85

Record Type typeId

SUPPORTCASETYPE -154

TASK -21

TERM -199

TIMEBILL -256

TIMEENTRY -295

TIMESHEET -292

TRANSACTION -30

TRANSACTIONBODYCUSTOMFIELD -124

TRANSACTIONCOLUMNCUSTOMFIELD -124

TRANSFERORDER -30

UNITSTYPE -201

USAGE -362

VENDOR -3

VENDORBILL -30

VENDORCATEGORY -110

VENDORCREDIT -30

VENDORPAYMENT -30

VENDORRETURNAUTHORIZATION -30

WINLOSSREASON -203

WORKORDER -30

WORKORDERCLOSE -30

WORKORDERCOMPLETION -30

WORKORDERISSUE -30

External IDs Overview

The externalId attribute of a RecordRef provides a means to reference an object by its foreign key in an
external database.

You can set the externalID attribute during an add or update operation. External IDs are useful in the
following situations:

■ Maintaining client ID relationships

In cases where a client application already maintains references between records, set the externalId
attribute for each record during imports. In subsequent API calls, you can then reference associated
records by the known external ID.
■ Establishing relationships during a single import operation

SuiteTalk SOAP Web Services Platform Guide

Records in SOAP Web Services 86

For example, suppose you want to import customer records with references to sales reps into
NetSuite. If no external ID is used, you would need to import the customer records, determine the IDs
of the related sales reps' employee records, and then re-import the customer records with the sales
reps ID references. By providing an external ID, you can import the customer records in a single API
call using the external ID references to the sales reps.

To prevent duplicate records, you should use external IDs and the upsert and upsertList operations to
add records to NetSuite.

Most NetSuite record types support the use of external ID, but not all do. The following list identifies the
record types that do not support external ID. For all other records, you should assume that external ID
is supported. When in doubt, refer to the appropriate page in the SOAP Schema Browser. On each page
describing a record type, view the Attributes table to see whether external ID is supported.

Important: External IDs are not displayed on records by default. However, you can search for
external IDs, or you can add a custom field to the record types where you want to the external
ID to be displayed in the UI. For information about searching in SOAP web services, see Basic
Searches in SOAP Web Services. For information about working with custom fields, see the help
topic Custom Fields.

The record types that do not support external ID are:

■ Accounting Period
■ Budget Category
■ CRM Custom Field
■ Currency Rate
■ Custom List
■ Custom Record Custom Field
■ Custom Record Type
■ Entity Custom Field
■ Gift Certificate
■ Item Custom Field
■ Item Number Custom Field
■ Item Option Custom Field
■ Landed Cost
■ Other Custom Field
■ State
■ Transaction Body Custom Field
■ Transaction Column Custom Field

Guidelines for External IDs

Consider the following guidelines for external IDs:

■ External IDs must be unique not just within a single record type, but also within certain record groups.
For details about record types and record groups, see Shared Internal and External IDs.

SuiteTalk SOAP Web Services Platform Guide

Records in SOAP Web Services 87

■ External IDs can be updated through CSV import or web services. Therefore, it is recommended that
your organization use a single approach for maintaining external IDs, so that external IDs are not
unknowingly updated using two separate methods.
Although records of a particular type may be used in multiple integration scenarios, each record
instance can only have a single external ID value. To maintain data integrity, only a single integrated
application can set and update external ID values for each record type. External ID values for all
records of a particular type must all come from the same external application.
■ External IDs are case insensitive in web services references. For details, see Using Internal IDs,
External IDs, and References.

Shared Internal and External IDs

System-generated internal IDs and custom external IDs are shared among records belonging to the same
high-level group. Therefore, when referencing a record using RecordRef, providing the system internal ID
or custom external ID without specifying the record type is sufficient to uniquely identify the record within
a specific group.

Note: For information about displaying internal IDs, see Setting the Internal ID Preference.

External IDs must be unique across the whole record group, not just per record type. For example, an
external ID for a customer must not be reused for any other customer or for any other entity record,
including contacts, employees, groups, partners, or vendors. To avoid clashes within record groups, use a
consistent format for constructing your external IDs.

The following table provides the list of these high-level groups and the records belonging to each group.

Record Group Record Types

Account Account; Tax Account

Allocation Allocation Schedule; Intercompany Allocation Schedule

Schedule

Entity Contact; Customer; Employee; Entity; Entity Group; Job; Lead; Other Name; Partner; Project
Template; Prospect; Vendor

Entity Status Customer Status; Job Status

Event Activity; Campaign; Case; Event; Issue; Manufacturing Operation Task; Phone Call; Project Task;
Resource Allocation; Sales Campaign; Solution; Task

Inbound Bulk Ownership Transfer; Inbound Shipment; Receive Inbound Shipment

Shipment

Inventory Item Assembly/Bill of Materials; Description Item; Discount Item; Download Item; Expense Item;
Gift Certificate Item; Inventory Part; Item; Item Group; Kit Item; Lot Numbered Assembly/Bill of
Materials; Lot Numbered Inventory Item; Markup Item; Non-Inventory Part; Non-inventory Item for
Purchase; Non-inventory Item for Resale; Non-inventory Item for Sale; Other Charge Item; Other
Charge Item for Purchase; Other Charge Item for Resale; Other Charge Item for Sale; Payment
Item; Serialized Assembly/Bill of Materials; Serialized Inventory Item; Service; Service Item for
Purchase; Service Item for Resale; Service Item for Sale; Subscription Plan; Subtotal Item; Tax
Group

Payroll Batch Payroll Batch; Payroll Batch - Add Employees

Project Revenue Fixed Amount Project Revenue Rule; Labor Based Project Revenue Rule; Percent Complete Project
Rule Revenue Rule

SuiteTalk SOAP Web Services Platform Guide

Records in SOAP Web Services 88

Record Group Record Types

Revenue Amortization Schedule; Amortization Template; Revenue Recognition Schedule; Revenue

Recognition Recognition Template
Schedule

Timeline Manufacturing Planned Time; Time; Time Entry

Transactions Advanced Intercompany Journal Entry; Assembly Build; Assembly UnBuild; Bin Transfer; Bin
Worksheet; Blanket Purchase Order; Cash Refund; Cash Sale; Check; Commission; Credit Card
Charge; Credit Card Refund; Credit Memo; Custom Transaction; Customer Deposit; Customer
Payment; Customer Payment Authorization; Customer Refund; Deposit; DepositApplication;
Estimate; Expense Report; Fulfillment Request; FxReval; GL Impact Adjustment; Intercompany
Journal Entry; Intercompany Transfer Order; Inventory Adjustment; Inventory Cost Revaluation;
Inventory Count; Inventory Status Change; Inventory Transfer; Inventory Worksheet; Invoice; Item
Fulfillment; Item Receipt; Journal Entry; Opportunity; Ownership Transfer; Partner Commission;
Paycheck; Paycheck Journal; Purchase Contract; Purchase Order; Request For Quote; Requisition;
Return Authorization; Revenue Arrangement; Revenue Commitment; Revenue Commitment
Reversal; Revenue Contract; Sales Order; Statement Charge; Statistical Journal Entry; Store Pickup
Fulfillment; Transaction; Transfer; Transfer Order; Vendor Bill; Vendor Credit; Vendor Payment;
Vendor Request For Quote; Vendor Return Authorization; Work Order; Work Order Close; Work
Order Completion; Work Order Issue

Fields in SOAP Web Services

NetSuite records contain standard body fields and custom fields. Standard fields are those that come with
all NetSuite accounts. In SOAP web services, a record's standard body fields are its attributes, for example:
Customer.email, SalesOrder.salesRep. Standard fields must be of one of the following logical types.

Type Description

String Corresponds to the xsd:string type in the XML Schema

Int Corresponds to the xsd:int type in the XML Schema

Double Corresponds to the xsd:double in the XML Schema

Boolean Corresponds to the xsd:boolean type in the XML Schema and has valid values of true or false. If not
explicitly set to either true or false, then set as false.

Datetime Corresponds to the xsd:dateTime type in the XML Schema which conforms to the ISO 8601 standard.

RecordRef Corresponds to the RecordRef type in the XML Schema. References an nsKey value for any other record
in the system including system defined constants that are controlled by the system.

Enum Corresponds to a specific type defined as an enum in the XSD that represents system constants that are
also available in the UI.

WsEnum Corresponds to a specific type defined as an enum in the XSD that represents system constants that are
NOT available in the UI.

List A List references a type that is a list and should be explicitly defined in the in the XML Schema as a type.
A list can either be null (if it is an optional field), or it must contain at least one entry unless otherwise
noted.

Custom fields are those that have been created by NetSuite users to customize their accounts. Custom
fields can be added to an account using SuiteBuilder point-and-click customization tools. They can also be
added through the SOAP web services add operation. Custom fields must be one of the types defined in
Custom Field Types.

SuiteTalk SOAP Web Services Platform Guide

Fields in SOAP Web Services 89

On records, custom fields are contained in the customFieldList property. For more details, see
CustomFieldList.

Note: If you are getting unusual results in your SOAP web services queries, it may be that a
standard field has been customized.

Consider the following general guidelines when working with both standard and custom fields.

■ If a standard field is set as mandatory in a custom form, the “requiredness” of the field is honored in
SOAP web services. If you do not provide value in your SOAP web services request for a field that is set
as mandatory in a custom form, an error message is returned. For more information on NetSuite form
types, see the help topic Custom Forms.
■ Customizations made to standard fields are honored in SOAP web services. For example, if a standard
field is set as disabled, it is not settable through SOAP web services, either. If you try to set such a field
through SOAP web services, an error message is returned.
■ If a standard field is set to NOT show in the UI, it is not settable through SOAP web services, either. If
you try to set such a field through SOAP web services, an error message is returned.
■ Custom display only (inline) and disabled fields are not settable through SOAP web services because
these are NOT settable through the UI. If you provide a value in your SOAP web services request for
such a field, an error message is returned. For information on field display types, see the help topic
Setting Display Options for Custom Fields.
■ The behavior of custom hidden fields varies depending on the endpoint being used. If you are
using any endpoint since the 2011.2 endpoint (including 2011.2), the get operation does not return
the value of custom hidden fields. If you are using an older endpoint, these values are gettable. By
comparison, in the UI, these values cannot be seen.
If you are using the 2011.1 endpoint or earlier, the value of custom hidden fields is returned
regardless of the setting of the ignoreReadOnlyFields preference.
Custom hidden fields cannot be set, either in the user interface or using SOAP web services,
regardless of the endpoint.
■ Defaulted fields that are set to blank on a SOAP web services update will stay blank on update.
■ The bodyFieldsOnly request-level preference affects the way formulas on forms are processed. As a
result, if the values of custom fields are calculated using formulas, the search might return incorrect
results. If the calculated values of formulas are incorrect, set the bodyFieldsOnly preference to false to
make sure the correct values are returned. For more information, see Request-Level Preferences.

Note: If you are unfamiliar with NetSuite custom fields, it is recommended that you see the
help topic Custom Fields. This section describes the purpose and general characteristics of each
custom field type, which will help you when working with the SOAP customization API (described in
Customization).

Datetime Fields
You can work with datetime fields using the dateTime type in NetSuite. See the following sections for
information about working with the dateTime type.

Using the dateTime Type in NetSuite

When setting a date field using SOAP web services, you must enter a datetime value. The time and the
time zone following the date are used to determine the resulting date. When getting the date field
through SOAP web services, your preferred time zone influences the resulting datetime. Midnight in the

SuiteTalk SOAP Web Services Platform Guide

Fields in SOAP Web Services 90

user's time zone of the stored date (which is also displayed in the UI) is converted to Pacific Standard Time
(PST) or Pacific Daylight Time (PDT), and sent to the SOAP web services user.

Note: During winter months, the Pacific Time Zone is eight hours behind Coordinated Universal
Time (UTC-8) and is referred to as Pacific Standard Time (PST). In summer months, the Pacific
Time Zone is seven hours behind Coordinated Universal Time (UTC-7) and is referred to as Pacific
Daylight Time (PDT).

The following table gives several examples.

Datetime set in the date field Time zone of the Date shown in the Datetime when getting the record
2
user UI

2017-02-21T00:00:00.000-06:00 GMT-06:00 2/21/2017 2017-02-20T22:00:00.000-08:00

1
2017-08-21T00:00:00.000-05:00 GMT-05:00 8/21/2017 2017-08-20T22:00:00.000-07:00
3
2017-02-21T00:00:00.000-05:00 GMT-08:00 2/20/2017 2017-02-20T00:00:00.000-08:00
1
2017-08-21T00:00:00.000-07:00 GMT-05:00 8/21/2017 2017-08-20T22:00:00.000-07:00

Notes for the example table:

1. The user has set their time zone to GMT-6, but daylight saving time (DST) affects the result.
2. This is midnight of the date from the UI that is converted to PST or PDT. Note the time difference,
which equals the difference between the user's preferred time zone and PST or PDT.
3. The datetime which is to be saved is not greater than midnight in the user's preferred time zone.

Guidelines for the dateTime Type

Consider the following guidelines when using the dateTime type:

■ To avoid problems with conversions, set the time zone of the SOAP web services employee to
"(GMT-08:00) Pacific Time (US & Canada)" in Home > Set Preferences (Administrator). Also, submit the
datetimes for date fields as midnight and in PST or PDT. For more information, see Setting Date and
Time Format for SOAP Web Services. This way you can avoid conversions or truncations, and what is
submitted will be identical to what is retrieved through SOAP web services.
■ When changing time zone preferences the user must log in again using SOAP web services for the
change to take effect. If the same session is used, the old time zone is used as well. Caching may also
occur for a period after changing time zones.
■ Users setting the field value need to pay attention to the DST offset, as it influences the decision point
(midnight of user's time zone) according to which value is set to the field.
■ If the time zone specified in a set field request is different from the time zone of the user setting the
field, the datetime is first converted to the time zone of the user, and the date portion is stored. The
time is then set to midnight and returned in PST or PDT. See the second row of the preceding example
table for an example.
■ When posting dateTime values to NetSuite, it is recommended that you indicate the time zone. If no
time zone is indicated, the PST or PDT time zone is used. Note that NetSuite does not use GMT.

Setting Date and Time Format for SOAP Web Services

The following is an example of setting datetime, date, or time fields in SOAP web services, using Date-
Time-Timezone:

SuiteTalk SOAP Web Services Platform Guide

Fields in SOAP Web Services 91

If the user does not indicate the time zone in the request, the NetSuite system time zone is used:

(PST UTC-8/PDT UTC-07): <xmp><s0:endDate>2013-10-30T20:01:24.405</s0:endDate></xmp>

Users can indicate a UTC time zone by adding the 'Z' character at the end of the DateTime format:

Working with Daylight Saving Time in SOAP Web Services

At specified dates in the calendar year, the time is adjusted for daylight saving in some time zones. This
causes a shift from standard time (such as CST) to daylight saving time (such as CDT), and inversely,
depending on the time of the year. These changes come with a gain (start of daylight saving time) or loss
(start of standard time) of one hour in time difference.

The NetSuite time zone settings in Home > Set Preferences (Administrator) are based on standard time
settings. You must keep in mind the required adjustments during daylight saving time in the year. For
example, if your time zone setting in shows (GMT-06:00) Central Time (US & Canada), this is perceived as
-05:00 in SOAP web services context during daylight saving time, but -06:00 in standard time.

Therefore, if you send a SOAP web services request indicating CST (-6) when daylight saving time is in
effect, as in the following example: <tranDate xsi:type="xsd:dateTime">2015-04-13T22:26:26.923-06:00</
tranDate>, the datetime field on the target record is set using CDT (-5) i.e.23:26:26.923 instead of the
intended 22:26:26.923.

Important: If the time is close to midnight, the date may change to the next day after the
conversion.

CustomFieldList
Most record types that are exposed through SOAP web services can have custom fields. Custom fields
are contained in the customFieldList property on each record. The customFieldList property is an array of
CustomFieldRef.

Note: The Disable Mandatory Custom Field Validation preference determines whether a
required custom field with no data provided throws an error, or is accepted as a null value. For
more information on this preferences, see Company-Wide Preferences.

Field Name Type Req. Default Notes

customField varies Yes Value of the custom field. Points to a type of CustomFieldRef in the
XML Schema which is an abstract type.

internalID string Yes The field instance internal ID

recType string No The record type id

xsi:type xsi:type Yes This is a field that is automatically implemented by the XML Schema.
The value should represent the concrete custom field type.

SuiteTalk SOAP Web Services Platform Guide

Fields in SOAP Web Services 92

The following is an example that contains an excerpt of the SOAP body for a list of custom fields. It shows
that the record associated with the SOAP contains four custom fields, all of which are referenced in the
customFieldList property on the record.

<listRel:customFieldList xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com">
<platformCore:customField internalId="72" scriptId="custentity_franchiseeabn_on_customerrec" xsi:type="platformCore:StringCustom
FieldRef">
<platformCore:value>{partner.vatregnumber}</platformCore:value>
</platformCore:customField>
<platformCore:customField internalId="424" scriptId="custentity_score" xsi:type="platformCore:LongCustomFieldRef">
<platformCore:value>25</platformCore:value>
</platformCore:customField>
<platformCore:customField internalId="324" scriptId="custentity_expertise_level" xsi:type="platformCore:SelectCustomFieldRef">
<platformCore:value internalId="2">
<platformCore:name>Medium</platformCore:name>
</platformCore:value>
</platformCore:customField>
<platformCore:customField internalId="57" scriptId="custentity_633637_bsubmit" xsi:type="platformCore:BooleanCustomFieldRef">
<platformCore:value>false</platformCore:value>
</platformCore:customField>
</listRel:customFieldList>

Setting Custom Fields to NULL

Custom fields can only be set to NULL by submitting the field in nullFieldList. For example, to set a custom
field on a customer record to null, submit the following SOAP request, where custEntity9 is the custom
field ID and 373 is the specific instance of the customer record:

<soap:Body>
<platformMsgs:update>
<platformMsgs:record internalId="373" xsi:type="listRel:Customer">
<platformCore:nullFieldList xsi:type="platformCore:NullField">
<platformCore:name>custEntity9</platformCore:name>
</platformCore:nullFieldList>
</platformMsgs:record>
</platformMsgs:update>
</soap:Body>

Note: You cannot set the Custom Form field to NULL. (This field is available on transaction and
entry forms to indicate the form that should be used.) Any request to set it this field to NULL with
nullFieldList will be ignored.

Sample .NET Code

Customer cust = new Customer();

cust.internalId = "373";
cust.nullFieldList = new String[]{"custentity9"};
_service.update(cust);

Sample Java Code

Customer cust = new Customer();

cust.setInternalId("373");
NullField nfl = new NullField(new String[]{"custentity9"});
cust.setNullFieldList(nfl);
port.update(cust);

SuiteTalk SOAP Web Services Platform Guide

Fields in SOAP Web Services 93

Custom Fields and Joined Searches

When a custom field is used to create a parent/child relationship between two existing records, the
resultant joined searches available through the NetSuite UI are not supported in SOAP web services.

User Defined Lists

In SOAP web services, many fields require internal ID values that correspond to an item in a user-defined
list. To locate the internal ID of a specific value in a user-defined list, you must have the Show Internal
IDs preference enabled in your account. For details, see Setting the Show Internal IDs Preference.

After enabling the Show Internal IDs preference, you can then navigate to the appropriate list within
NetSuite. The internal ID values (also referred to as nsKeys) are displayed for each list item.

For example, the Status (entityStatus) field on the customer record takes an internal ID value from the
Customer Status list, which is a user-defined list located at Setup > Sales > Customer Statuses. If you
navigate to this page in NetSuite, you can see the internal ID values for each item in the column called
Internal ID (see figure).

Note: Some user-defined lists can also be edited through SOAP web services to modify the
values for the list. For details, see the help topic Other Lists.

Enumerated Lists
If values being returned for WSEnum and Enum fields in a get or search operation do NOT match the
values enumerated in the schema, the following warning is returned:

Code = Invalid_data

SuiteTalk SOAP Web Services Platform Guide

Fields in SOAP Web Services 94

Message = "Error in record number <id>: Invalid field value <field>.

Please refer to the XSD for enumerated list of valid field values."

In these cases, the existing data is corrupt and must be corrected before it can be retrieved using SOAP
web services.

Field Lengths
Most string fields have a maximum character limit. If the limit is exceeded, an error is returned indicating
which field exceeded the limit and the maximum number of characters allowed for that field.

Field Level Errors

If a required field is missing for a specific record within a request, an error is generated. The associated
record is not processed and an appropriate error status code is returned.

Only the records without errors are processed. If multiple records are submitted within the same request,
records without errors are processed; records with errors are not processed.

Required Fields
Required fields in the UI do not necessarily correspond to required fields in SOAP web services. This is
because there can be standard defaults that are applied if the field is not populated. For example, in the
CalendarEvent record type, the eventAccess field is required in the UI. However, it is optional in SOAP web
services because it has a default value of Public.

Important: The Required column in the SOAP Schema Browser lists T or F (for true or false)
to specify if a field is required by the form in the user interface. Refer to the Cardinality column
to see whether the XSD imposes a requirement for the field. For information on using the SOAP
Schema Browser, see the help topic SOAP Schema Browser.

Fields and Operations

For simplicity, the SOAP WSDL is designed with all available fields listed for each record in each
corresponding XSD. There is no differentiation as to what field is available for each individual operation.
For example, add operations take a separate set of field values than the corresponding update operation
for some records. If your SOAP web services request includes a field value for a field that is unavailable, an
error is thrown for that submission.

If you are using SOAP web services for data migration where there may be fields that need to be
populated that are unavailable during an add operation, you should perform two consecutive requests.
Submit an initial add or addList request, with values for all fields available for an add operation, followed
by an update or updateList request, with values for the fields available only during an update operation.

Default Field Values

The system provides default values only for fields that are not required. When applying a default value,
the system first tries to use a specified value. If none is given, the system uses the default. If no default is
given, the system enters null.

User-defined defaults through the UI do not apply to SOAP web services.

SuiteTalk SOAP Web Services Platform Guide

Fields in SOAP Web Services 95

Note: For information about setting default values to custom fields, see the help topic Setting
Validation and Defaulting Properties.

Hidden Fields
The SOAP web services API includes fields that are not visible in the NetSuite UI. In some cases, these
fields have been hidden through SuiteBuilder point-and-click customization. In other cases, hidden fields
are hidden by NetSuite. These types of hidden fields are used primarily for storing system-generated
information such as dates.

For example, every SOAP-supported record contains either a dateCreated or createdDate field. These fields
are not writeable. By default, these fields are populated with a system-generated timestamp. Note that
system-generated dates and times are preserved for audit trail purposes.

Note: The Use Defaults Web service preference does not affect the behavior of hidden fields.
Even if the Use Defaults preference is not enabled, hidden fields are populated when a value is not
supplied in the request. Also, for audit purposes, the true system date is always recorded for each
record and cannot be overridden.

Important: Calls to get or search (when the full record is returned) return the record in edit
mode.

Forms in SOAP Web Services

If you are building a generic SOAP web services application, to ensure that your applications are account
independent, NetSuite recommends that you create custom “Web-services-only” forms. Use custom
forms for SOAP web services requests by specifying the form in the customForm element of a record. This
will alleviate problems associated with customer-specific customizations to forms used in the UI that may
break your SOAP web services application code.

Note: If you are unfamiliar with NetSuite custom forms, see the help topic Custom Forms. For
information on creating custom forms that you can designate as “web-services-specific,” see the
help topic Creating Custom Entry and Transaction Forms.

For all record types that support custom forms, if a form is specified in the SOAP web services request,
that form will be used for validation. Note that it is generally best practice to specify the custom form in
all SOAP web services update operations. Also be aware that no record type is needed when specifying a
custom form. You only need to specify the internal ID of the custom form.

To get the internal ID of a custom form, in the UI, go to Customization > Forms > [ form type ], where form
type is either an entry or transaction form. The internal ID appears in the Internal ID column if the Show
Internal IDs preference is enabled. (For steps on enabling this preference, see Setting the Show Internal
IDs Preference.)

To specify a form in SOAP web services, see the following C# snippet, which shows how to associate a
particular form with a Customer record.

// create a customer object

Customer customer = new Customer();

customer.internalId = "555"

// create a custom form object

SuiteTalk SOAP Web Services Platform Guide

Forms in SOAP Web Services 96

RecordRef customFormRef = new RecordRef();

// set the internal ID of the custom form. Get the internal ID from
the UI

customFormRef.internalId = "-100";

// set the customForm field on the Customer record to reference the

form

customer.customForm = customFormRef;

If a form is NOT specified, then the default preferred form for that record is used. If a custom form is
saved with a record in the UI, that form is not used in the SOAP web services request unless it is also the
default form for that record type or is explicitly set as the form in the SOAP web services request.

Sublists in SOAP Web Services

Most records in NetSuite include sublists, which generally contain a list of references to other records.
This figure shows the Expenses sublist on the check record. Notice that this sublist includes two lines in
the Expenses sublist.

Note: For general information on sublists in NetSuite, see the help topic What is a Sublist?

In SOAP web services, sublists are represented in a record's schema definition by its List elements.

Note: Except for the customFieldList element (which contains a record's custom fields), all other
elements that end in List represent a record's sublists.

The following is a portion of the schema for the Check record. (Although the XSD shown below describes
the Items sublist on the check record, the same pattern for defining sublists applies to all sublists on all
records.)

Notice that the sublists on the check record include the Expenses sublist, the Items sublist, and the
Landed Costs sublist (not shown in the figure above because the Landed Costs feature is not enabled in
the account).

SuiteTalk SOAP Web Services Platform Guide

Sublists in SOAP Web Services 97

<element name=" landedCostsList " type="tranBank:CheckLandedCostList" minOccurs="0"/>

The itemList element (listed above) is of type CheckItemList, which is defined in the CheckItem
complex type (defined in transactions.bank.xsd). The CheckItem type (shown below) includes all the
properties that can be set for the Item sublist on the check record. Also notice the replaceAll attribute in
CheckItemList. You will set the value of replaceAll to true or false depending on whether you are working
with keyed sublists or non-keyed sublists. See Updating Sublists in SOAP Web Services for details.

<complexType name=" CheckItem ">

<sequence>
<element name="item" type="platformCore:RecordRef" minOccurs="0"/>
<element name="vendorName" type="xsd:string" minOccurs="0"/>
....

<element name="line" type="xsd:long" minOccurs="0"/>

Updating Sublists in SOAP Web Services

When working with sublists, the approach for updating the lines in a sublist will vary depending on
whether you are working with Keyed Sublists or Non-Keyed Sublists.

Keyed Sublists
Keyed sublists have an indexing line element or internal ID that can be used as a key. Keyed sublists allow
you to set the replaceAll attribute to FALSE to update only the lines you are submitting in your SOAP
request. When working with keyed sublists, the value of the replaceAll attribute has the following effects:

■ replaceAll = TRUE: The existing sublist is replaced with the sublist submitted in the SOAP web services
request. The newly submitted sublist should include all values.
□ Lines that do not match the newly submitted lines are removed.
□ Currently existing lines that match lines in the new sublist submission are updated.
□ Newly submitted lines with no matches are added.
The default value for the replaceAll attribute is TRUE.
■ replaceAll = FALSE: Lines in the existing sublist are selectively updated with lines in the sublist
submitted in the SOAP web services request. The newly submitted sublist need only include values to
be added and updated.
□ Lines that do not match the newly submitted lines are preserved.
□ Currently existing lines that match lines in the new sublist submission are updated.
□ Newly submitted lines with no matches are added.

SuiteTalk SOAP Web Services Platform Guide

Sublists in SOAP Web Services 98

The following table lists sublists that are categorized as keyed sublists in SOAP web services. Sublists that
do not appear in this table are considered Non-Keyed Sublists. The sublist key listed for each keyed sublist
below is used to link the sublist data with the appropriate record.

Important: PricingMatrixList and demandPlanDetailList are matrix sublists. Updates to matrix

sublists may require additional handling related to the replaceAll attribute. See Matrix Sublists and
replaceAll.

Sublist Sublist Key Appears on Record(s)

accruedTimeList payrollitem Employee

addressbookList internalId Contact, Customer, Employee, Lead, Partner, Project, Prospect,

Vendor

Note: When you work with the addressbookList on

customer records, be sure to use internalId as the
key. Do not use label.

applyList doc Customer Payment, Credit Memo, Customer Refund, Customer

Deposit, Deposit Application, Vendor Credit, Vendor Payment

assigneeList resource Project Task

attendeeList attendee Calendar Event

binNumberList binNumber Assembly Item (BOM Item), Inventory Item, Lot Numbered
Assemby Item, Lot Numbered Inventory Item, Serialized
Assembly Item, Serialized Inventory Item

campaignDirectMailList internalId Campaign

campaignEmailList internalId Campaign

campaignEventList internalId Campaign

companyContribution payrollitem Employee

List

componentList item Assembly Unbuild, Assembly Build

contactList company Customer, Partner, Vendor

creditList doc Customer Payment, Vendor Payment

creditCardsList internalId Customer, Job

currencyList currency Customer (when Multi-Currency Customer enabled)

deductionList payrollitem Employee

depositList doc Customer Payment, Customer Refund

deptAccessList dept Custom Entity Field, CRM Custom Field, Other Custom Field,
Item Custom Field, Transaction Body Custom Field, Transaction
Column Custom Field, Item Option Custom Field, Custom
Record Custom Field, Item Number Custom Field

dimensionList sequence Fair Value Price

directDepositList internalid Employee

SuiteTalk SOAP Web Services Platform Guide

Sublists in SOAP Web Services 99

Sublist Sublist Key Appears on Record(s)

earningList payrollitem Employee

expCostList doc Invoice, Cash Sale

expenseList orderLine or line Check, Expense Report, Item Receipt, Purchase Order,
Purchase Requisition, Vendor Bill, Vendor Credit, Vendor
Return Authorization

itemList orderLine or line Bin Putaway Worksheet, Bin Transfer, Cash Sale, Check,
Estimate, Inventory Transfer, Invoice, Item Fulfillment,
Item Receipt, Credit Memo, Return Authorization, Cash
Refund, Opportunity, Purchase Order, Purchase Requisition,
Sales Order, Vendor Bill, Vendor Credit, Vendor Return
Authorization, Work Order

Notes:

■ On Item sublists, the value End of Group is not returned in

SOAP web services. This behavior mimics the behavior of
the UI.
■ For cash sale records, the orderLine field establishes the
relationship with an existing sales order, if any. You must
set a value for orderLine to populate the createdFrom field.
■ To create a credit memo with the createdForm field
populated, you must set a value for orderLine. In
subsequent update requests, you must use “line” for line
updates.
■ For item receipt records, orderLine is used for transforms,
because it implies a link between the previous transaction
and the current one. For example, to add an item receipt
from a purchase order, the purchase order lines would be
"orderLines", because the receipt has not been saved. After
the item receipt is saved, lines should be accessed via the
"line" field.
■ For opportunity records, line is used.

itemCostList doc Invoice, Cash Sale

itemsList item Promotion Code, Item Option Custom Field, Item Number
Custom Field.

lineList line Custom Transaction

locationsList locationId Inventory Item, Serialized Inventory Item, Lot Numbered

Inventory Item

merchandiseHierarchy hierarchyversion Inventory Item, Lot Numbered Inventory Item, Serialized

Inventory Item

Note: This sublist is available if the Merchandise

Hierarchy feature is enabled at Setup > Company
> Setup Tasks > Enable Features, on the Items &
Inventory subtab.

milestoneList milestoneId Billing Schedule

SuiteTalk SOAP Web Services Platform Guide

Sublists in SOAP Web Services 100

Sublist Sublist Key Appears on Record(s)

Note: This sublist is available only when

scheduleType is set to Fixed Bid Milestone.

nexusesTaxList nexus Tax Type

partnersList partner Estimate, Cash Sale, Invoice, Sales Order, Opportunity, Credit
Memo, Return Authorization, Cash Refund, Customer

partnersList partner Promotion Code

paymentList The internal ID of the Deposit

record being referenced
in the sublist line.

periodDemandPlanList startDate Item Demand Plan

Note: This sublist includes additional handling for

replaceAll. See Matrix Sublists and replaceAll.

predecessorList task Project Task

pricingMatrixList Varies according to Item

enabled features. See
the help topic Pricing Note: This sublist includes additional handling for
Matrix Keys.
replaceAll. See Matrix Sublists and replaceAll.

ratesList subsidiary Expense Category

Note: Sublist available only to OneWorld accounts.

recurrence recurrenceId Billing Schedule

Note: This sublist is available only when

scheduleType is set to Standard and frequency is set
to Custom.

resourceList resource Calendar Event

roleAccessList role Entity Custom Field, CRM Custom Field, Other Custom Field,
Item Custom Field, Transaction Body Custom Field, Transaction
Column Custom Field, Item Option Custom Field, Custom
Record Custom Field, Item Number Custom Field

salesTeam employee Customer, Invoice, Cash Sale

taxRegistrations id Customer, Partner, Vendor

Sublist available when the SuiteTax feature is enabled.

timeList doc Invoice, Cash Sale

Example
The following sample shows how to add an item to an opportunity record and modify an existing item
in that record. To do this, set replaceAll to FALSE, add the new item, and modify the existing item by

SuiteTalk SOAP Web Services Platform Guide

Sublists in SOAP Web Services 101

referencing the desired item in the line property. The following shows that the existing line item is
modified to change the quantity.

<soapenv:Body>
<platformMsgs:update xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:s0="urn:sales_2017_1.transactions.webser
vices.netsuite.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:plat
formMsgs="urn:messages_2017_1.platform.webservices.netsuite.com">
<platformMsgs:record xsi:type="s0:Opportunity" internalId="1638">
<s0:itemList replaceAll="false">
<s0:item>
<s0:item internalId="380" type="inventoryItem" />
<s0:quantity>1.0</s0:quantity>
<s0:amount>20.0</s0:amount>
</s0:item>
<s0:item>
<s0:line>2</s0:line>
<s0:quantity>10.0</s0:quantity>
</s0:item>
</s0:itemList>
</platformMsgs:record>
</platformMsgs:update>
</soapenv:Body>

Matrix Sublists and replaceAll

Matrix sublists respect the replaceAll attribute for updates, as other Keyed Sublists do, but in some cases,
updates to matrix sublists require additional handling.

Matrix sublists require additional handling for replaceAll because body-level fields populate values into
them. For example, setting the pricing schedule for an item dictates values in the pricing matrix. In the
UI, when a pricing schedule is selected, the pricing schedule logic is run first, and values specified in the
pricing matrix sublist are taken into account to arrive at what the update should do. However, the UI does
not have the notion of replaceAll because the user interacting with the form can delete values they do not
want to keep in individual fields.

SOAP web services requests cannot delete individual field values in a sublist. The only way to get rid of
old values is to set replaceAll to TRUE and send all values in the update request. Some body fields can
override values in a matrix sublist, but a SOAP web services request can then change some or all of these
sublist values, depending on the replaceAll setting.

Review the following cases to get an understanding of how the slaving of values from body fields into a
matrix sublist interacts with the replaceAll setting on updates:

■ No sublist values from body fields and replaceAll=TRUE

The SOAP web services request does not include any body field values that drive values in the sublist,
so the update is handled like those in other keyed sublists where replaceAll is set to TRUE.
The existing sublist is replaced with the sublist submitted in the SOAP web services request. The
newly submitted sublist should include all values.
■ No sublist values from body fields and replaceAll = FALSE
The SOAP web services request does not include any body field values that drive values in the sublist,
so the update is handled like those in other keyed sublists where replaceAll is set to FALSE.
Lines in the existing sublist are selectively updated with lines in the sublist submitted in the SOAP
web services request. The newly submitted sublist need only include values to be added and updated.
■ Sublist values from body fields and replaceAll=TRUE
The SOAP web services request sets body field value(s) that drive values in the sublist, so specialized
handling is required.

SuiteTalk SOAP Web Services Platform Guide

Sublists in SOAP Web Services 102

First, all sublist values are removed. Next, sublist values driven by body field values are set. Then, the
sublist is updated with all lines specified in the newly submitted sublist. The newly submitted sublist
lines thus override the values driven by body fields.

Important: When sublist values from a SOAP web services request override values driven
by body fields, errors may occur. If you do not want these overrides, you must set replaceAll to
FALSE. For example, if you are setting a quantity pricing schedule, you should set ReplaceAll to
FALSE.

■ Sublist values from bodyfields and replaceAll=FALSE

The SOAP web services request sets body field value(s) that drive values in the sublist, so specialized
handling is required.
First, sublist values driven by body field values are set. Then, the sublist is updated with any updated or
added lines from the newly submitted sublist.

Note: By default, replaceAll is set to TRUE for matrix sublists, like other sublists.

Currently Supported Matrix Sublists

The pricingMatrixList on Items and periodDemandPlanList on Item Demand Plans are currently
supported matrix sublists. For details about these sublists, see the help topics Pricing Matrix List and Item
Demand Plan.

Important: In endpoints prior to 2012.1, updates to pricingMatrixList ignore the replaceAll

attribute. For the 2012.1 and later endpoints, replaceAll is respected for this sublist.

Non-Keyed Sublists
Non-keyed sublists have no indexing line element or internal ID that can be used as a key. Each line in a
non-keyed sublist is recorded in a flat list.

In the UI, non-keyed sublists and keyed sublists may look similar; however, technically, they are quite
different. Because non-keyed sublists contain no referencing keys (or handles), you cannot update
a specific line in a non-keyed sublist. Instead, you must interact with the sublist as a whole. In non-
keyed sublists, the replaceAll attribute is ignored and behaves as if it were set to TRUE for all requests.
Consequently, an update operation is similar to the add operation with respect to non-keyed sublists.

In the context of SOAP web services, all sublists not listed as Keyed Sublists are considered to be non-
keyed sublists. The following bullets outline the behaviors of non-keyed sublists.

■ To update a single line in the sublist, retrieve the entire sublist, change a single line as desired, and
then resubmit the entire sublist.
■ To replace the sublist with a subset of lines, retrieve the entire sublist, and then resubmit the subset of
lines. The original sublist is purged and replaced by the new sublist containing the subset of lines.
■ To delete the sublist, submit an empty sublist. See Deleting All Lines on a Sublist for more information.

Sublist Line Numbers

The index number for each sublist line is assigned by the system. SOAP web services developers cannot
change these values. When lines are added or removed from a sublist (using either the UI or SOAP web
services), the system does not re-index the line numbers. Therefore, it is best practice to perform a get

SuiteTalk SOAP Web Services Platform Guide

Sublists in SOAP Web Services 103

operation on the sublist data before trying to update individual lines, otherwise you may be updating the
wrong line in the sublist.
For example, if you perform a get operation on an Items sublist on a transaction record, the index values
for the first three line items might be:

<ns3:line>1</ns3:line>
<ns3:line>8</ns3:line>
<ns3:line>9</ns3:line>

Deleting All Lines on a Sublist

This sample shows how to delete all addresses from the Address sublist on a customer record
(CustomerAddressbookList).

Java
Customer update = new Customer();
update.setInternalId(c.getInternalId());
cabl = new CustomerAddressbookList();
cabl.setAddressbook(new CustomerAddressbook[0]);
cabl.setReplaceAll(true);
update.setAddressbookList(cabl);

SOAP
<update xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<record internalId="724" xsi:type="ns1:Customer" xmlns:ns1="urn:relationships_2017_1.lists.webservices.netsuite.com">
<ns1:addressbookList replaceAll="true" xsi:type="ns1:CustomerAddressbookList"/>
</record>
</update>

The next sample shows how to delete all line items from the Item sublist (OpportunityItemList) on an
opportunity record.

Java
Opportunity update = new Opportunity();
update.setInternalId(opp.getInternalId());
update.setItemList(new OpportunityItemList(new OpportunityItem[0], true));

SOAP
<update xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<record internalId="6147" xsi:type="ns1:Opportunity" xmlns:ns1="urn:sales_2017_1.transactions.webservices.netsuit
e.com">
<ns1:itemList replaceAll="true" xsi:type="ns1:OpportunityItemList"/>
</record>
</update>

Searching a Sublist
Keyed sublists have a line field (typically on transaction sublists). Individual lines in the list can be
searched for by referencing the line value.

SuiteTalk SOAP Web Services Platform Guide

Sublists in SOAP Web Services 104

Also note that when searching records, by default sublists are NOT returned in the result set, which
increases the search response time. However, if you want to return all sublist data in your search, set the
SearchPreferences. bodyFieldsOnly preferences to FALSE in your search request.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Processing 105

SOAP Web Services Processing

This section describes synchronous and asynchronous processing. Also provided are steps for monitoring
your SOAP web services requests. Refer to the following topics:

■ Synchronous Versus Asynchronous Request Processing

■ Asynchronous Request Processing
■ Synchronous Request Processing

Synchronous Versus Asynchronous Request

Processing
SOAP web services requests can be processed synchronously or asynchronously.

With synchronous requests, your client application sends a request to NetSuite, and the client waits until
the request is processed and a response is returned. That is, the application does not proceed with other
work until receiving the response.

With asynchronous requests, your client application sends a request to SOAP web services, where it is
placed in a processing queue and handled asynchronously with other requests. Your client application
does not wait for a response but goes on to other work. After a job is submitted, a job Id is returned in
the SOAP web services response. Your client application can then check on the status and result of the
request by referencing the job Id.

Asynchronous processing may be advantageous in the following situations:

■ If you expect your connection to NetSuite to be slow or unstable.

■ If your job is large, and its processing can be postponed until off-peak hours.

Be aware that asynchronous responses may not be returned immediately. Before committing to using
asynchronous operations, you should consider this factor and decide whether it fits in with your business
logic.

Asynchronous Request Processing

This section describes asynchronous request processing in more detail.

Available Operations
Asynchronous equivalents are available for several synchronous operations, as shown in the table below.

Asynchronous Operation Synchronous Equivalent

asyncAddList addList

asyncUpdateList updateList

asyncUpsertList upsertList

asyncDeleteList deleteList

asyncGetList getList

SuiteTalk SOAP Web Services Platform Guide

Asynchronous Request Processing 106

Asynchronous Operation Synchronous Equivalent

asyncSearch search

asyncInitializeList initializeList

Understanding Asynchronous Requests and Responses

When submitting an asynchronous request, the request is similar to the equivalent synchronous call. The
following code illustrates an asynchronous request for a list of customer records.

<soap:Body>
<platformMsgs:asyncGetList>
<platformMsgs:baseRef internalId="87" type="customer" xsi:type="platformCore:RecordRef"></platformMsgs:baseRef>
<platformMsgs:baseRef internalId="176" type="customer" xsi:type="platformCore:RecordRef"></platformMsgs:baseRef>
</platformMsgs:asyncGetList>
</soap:Body>

The response, however differs in that only information about the request is returned. This information
includes a unique identifier for the request, which is enclosed in the jobId tags.

<soapenv:Body>
<asyncGetListResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<asyncStatusResult xmlns="urn:core_2017_1.platform.webservices.netsuite.com">
<jobId>ASYNCWEBSERVICES_563214_053120061943428686160042948_4bee0685</jobId>
<status>pending</status>
<percentCompleted>0.0</percentCompleted>
<estRemainingDuration>0.0</estRemainingDuration>
</asyncStatusResult>
</asyncGetListResponse>
</soapenv:Body>

Later, you can use the checkAsyncStatus or getAsyncResult operations to track the asynchronous request.
To identify the specific request about which you need data, refer to it by its job Id.

Usage Notes
Be aware of the following characteristics of asynchronous processing:

■ All available jobs are processed contiguously. That is, processing priority is based on when the job is
submitted, and jobs cannot pass one another in the queue.
■ The system does not enforce waiting periods for jobs. That is, as soon as soon as a job is completed,
the next job from the queue is immediately selected and the processing starts.
■ Asynchronous request job Ids are valid for 30 days. After 30 days, you can no longer look up the
request.

Checking the Status of an Asynchronous Job

To check the status of an asynchronous SOAP web services job, you use the checkAsyncStatus operation.
When you use this operation, you reference a job Id. In response, the system returns the job’s status,
among other details.
Specific status values that can be returned include the following:

■ failed
■ finishedWithErrors — indicates that at least one record was processed, but at least one failed.
■ pending

SuiteTalk SOAP Web Services Platform Guide

Asynchronous Request Processing 107

■ processing
■ finished

If the status is failed, finishedWithErrors, or finished, you can in most cases use the getAsyncResult
operation to obtain more details. These details may include the record results, or error and fault
messages. The getAsyncResult operation is described in Checking for Detailed Results of an
Asynchronous Job.
checkAsyncStatus also returns details about the percentage of the job that is complete, and the estimated
time remaining. The estimated remaining time is measured in seconds.

checkAsyncStatus Request and Response

The following is a typical checkAsyncStatus request.

<soap:Body>
<platformMsgs:checkAsyncStatus>
<platformMsgs:jobId>ASYNCWEBSERVICES_563214_053120061943428686160042948_4bee0685
</platformMsgs:jobId>
</platformMsgs:checkAsyncStatus>
</soap:Body>=

The following is a typical checkAsyncStatus response.

<soapenv:Body>
<checkAsyncStatusResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<asyncStatusResult xmlns="urn:core_2017_1.platform.webservices.netsuite.com">
<jobId>ASYNCWEBSERVICES_563214_053120061943428686160042948_4bee0685</jobId>
<status>pending</status>
<percentCompleted>0.0</percentCompleted>
<estRemainingDuration>0.0</estRemainingDuration>
</asyncStatusResult>
</checkAsyncStatusResponse>
</soapenv:Body>

checkAsyncStatus Faults
The checkAsyncStatus operation can throw any of the following faults:

■ InvalidSessionFault
■ AsyncFault
■ UnexpectedErrorFault

For more information on faults, see SOAP Fault Status Codes.

Checking for Detailed Results of an Asynchronous Job

To retrieve details about specific records submitted as part of an asynchronous request, you use the
getAsyncResult operation.

getAsyncResult Time Limits

Be aware of the following limits:

■ You can use the getAsyncResult operation for a particular job Id up to 20 times within a 30-day time
period. If this limit is exceeded, the system returns an INVALID_JOBID user error.
■ Async job IDs are purged from the system every 30 days. If you attempt to download the results 31
days after your initial request, the system returns an INVALID_JOBID user error.

SuiteTalk SOAP Web Services Platform Guide

Asynchronous Request Processing 108

getAsyncResult Example
You can use code like the following to retrieve the getAsyncResult response. This example shows how to
look for records that failed with a status detail code of “unexpected error” and then take some action with
those records.

AsyncAddListResult result = (AsyncAddListResult)port.getAsyncResult("job ID", 1);

WriteResponseList responses = result.getWriteResponseList();
for (WriteResponse response : responses.getWriteResponse())
{
if (!response.getStatus().isIsSuccess())
{
if (response.getStatus().getStatusDetail()[0].getCode() == StatusDetailCodeType.UNEXPECTED_ERROR)
// add for resubmit
}
}

Note: To use getAsyncResult with asyncInitializeList, you must be using the 2013.2 endpoint
or later. You can monitor asyncInitializeList requests using the UI, as described in Monitoring
Asynchronous Jobs from the UI.

getAsyncResult Faults
This operation can throw one of the following faults.

■ InvalidSessionFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ AsyncFault
■ UnexpectedErrorFault

For more information on faults, see SOAP Fault Status Codes.

Note: You can see some details about asynchronous job results by navigating to Setup >
Integration > SOAP Web Services Process Status and viewing the Response.xml file for the job. For
details, see Monitoring Asynchronous Jobs from the UI.

Monitoring Asynchronous Jobs from the UI

SOAP web services jobs submitted asynchronously can be monitored at Setup > Integration > SOAP Web
Services Process Status. To access this log, either the full SOAP Web Services permission or the View SOAP
Web Services Logs permission is needed. Both permissions are available on the role record’s Permissions
subtab under Setup.

On this page, you can view the following information about each job:

■ Date — the date the job was created

■ Sequence — the order of the job in relation to other asynchronous jobs in process (jobs are processed
on a first in, first out basis)
■ Job Number — order number of the job in the work queue
■ Job Id — the Job Id, which is also returned in the asynch SOAP response, and can be used to
programmatically retrieve job status information

SuiteTalk SOAP Web Services Platform Guide

Asynchronous Request Processing 109

■ Status — the status of the job: failed, finishedWithErrors, pending, processing, or finished (for more on
status, see Checking the Status of an Asynchronous Job)
■ Percent Complete — the percentage of job processing that has been completed
■ Est. Remaining Time — the estimated amount of time remaining before the job is completed
■ Request — the SOAP request associated with the job (see additional details below)
■ Response — the SOAP response associated with the job (see additional details below)
■ Cancel — you can check the box in this column to cancel a job that has not yet successfully completed

Limits on Requests and Responses

Note the following limitations:

■ A response for a job is available only after the job has successfully completed.
■ In production environments, the data is accessible for 21 days. In sandbox environments, the data is
accessible for seven days.
■ Lengthy requests and responses are not saved by the system and therefore are not available for your
review. The system imposes the following limits:
□ The system does not save requests that are larger than 100MB.
□ The system does not save responses that are large than 1MB.

Refreshing the Job Status Page

The Job Status page does not automatically refresh. To get the current status of a job, click the Refresh
button at the top of the page.

Synchronous Request Processing

In addition to using the responses NetSuite sends for each request, you can monitor synchronous SOAP
web services processing in the NetSuite user interface. You have the following options:

■ Referring to the execution log of the appropriate integration record. For details on working with
integration records, see Integration Management.
■ Using the SOAP Web Services Usage Log
■ Creating Integration Reports

See also Handling of Lengthy Requests, which describes limitations that exist for sending responses.
For information on monitoring asynchronous requests, see Monitoring Asynchronous Jobs from the UI.

Using the SOAP Web Services Usage Log

Use the SOAP Web Services Usage Log to monitor synchronous requests. This page can be accessed at
Setup > Integration > SOAP Web Services Usage Log.
Only administrators can access the SOAP Web Services Usage Log. Assigning the SOAP Web Services
permission to a role does not provide access to this log. Access is provided to administrators only
because access to this log could allow users to see data they do not have permission to view.
The SOAP Web Services Usage Log allows users to filter their SOAP web services requests by specified
date and time periods, record type, and action (operation). The SOAP requests and responses for each
job are accessible in the Request and Response columns. In production environments, requests and
responses are accessible for 21 days.

SuiteTalk SOAP Web Services Platform Guide

Synchronous Request Processing 110

Note: In case of heavy SOAP web services activity, the logs might be purged earlier than 21 days.

In sandbox environments, requests and responses are accessible for seven days. In sandbox
environments, you can view request and response information in log and search results after seven days.
However, links to the original SOAP request and responses are not available.
Results can be filtered down to the minute. The results returned provide second-level granularity.
Note that lengthy requests and responses are not saved by the system and therefore are not available for
your review. The system imposes the following limits:

■ The system does not save requests that are larger than 100 MB.
■ The system does not save responses that are larger than 10 MB.

For each request, the log includes details such as the following:

■ The request job ID.

■ The date and time that the request was made.
■ The duration of the request.
■ Information about the requests that were rejected due to a violation of the concurrency governance.
■ The integration record used for the request.
■ The type of action used in the request.
■ The record type that was the subject of the request.
■ The email address of the user who sent the request.
■ The status of the request.
■ The number of records included in the request.
■ The number of request records that have finished.
■ The number of request records that failed.
■ The number of records returned in the request’s query.
■ Links to the SOAP request and response.

Note: The SOAP Web Services Usage Log does not show asynchronous requests. For details, see
Monitoring Asynchronous Jobs from the UI.

Creating Integration Reports

You can monitor SOAP web services processing by creating the following types of integration reports:

■ Integration and Automation Usage Summary by Job

■ Integration and Automation Usage Summary by Record Type

Important: The Integration permission is required to view these reports. To enable this
permission, administrators must go to Setup > Users/Roles > Manage Roles. Click Customize next
to the appropriate role. On the Permissions tab, click Reports. In the Permissions dropdown list,
select Integration and click Add.

Note: You might receive a timeout error when creating integration reports for accounts with
large volumes of SOAP web services traffic. Also, although integration reports do offer some
filtering capabilities, users must first take the added step of customizing the report. Be aware that
you can apply filtering in the SOAP Web Services Usage Log without doing customization.

Both of these reports provide details on type of operations used (for example, add, addList, delete), who
performed an operation, and the time an operation was performed.

SuiteTalk SOAP Web Services Platform Guide

Synchronous Request Processing 111

Web Services Integration reports are also useful for administrators who need to diagnose and
troubleshoot issues. Note that each report can be customized to display only the desired information. To
customize a report, click Customize next to the desired report and then modify the report as desired. For
details about how to customize a report, see the help topic Report Customization.
If an integration report is timing out, it is recommended that you customize the report by adding filters so
the report returns fewer results. See Filtering Integration Report Data.

Note: These reports do not support reporting by period even when the Report by Period
preference is set to All Reports. The Report by Period preference can be configured at Home > Set
Preferences, the Analytics subtab.

Integration and Automation Usage Summary by Job

This report can be used for performance statistics. It shows the duration of each SOAP web services
processing job, the number of records modified in each job, the number of successful versus failed record
modifications for each job, and the number of records queried for each job. You can also drill down to job
details by clicking the job number.
Any related SOAP files are stored in View links in the reports Request Doc and Response Doc columns. Be
aware that NetSuite purges SOAP files every 30 days. In sandbox environments, these files are accessible
for seven days.

Note: In sandbox environments, you can view request and response information in log and
search results after 7 days. However, links to the original SOAP request and responses are not
available.

You can view this report at Reports > Integration > Integration and Automation Usage Summary by Job.

Integration and Automation Usage Summary by Record Type

This report lists the record types modified by SOAP web services processing, and the number of records
added, updated, deleted, and queried for each record type.
You can view this report at Reports > Integration > Integration and Automation Usage Summary by
Record Type.

Filtering Integration Report Data

You can customize integration reports to run faster, by adding filters that limit the returned results. For
example, you could limit a report to return only jobs with start dates that fall into a specified date range.

To filter an integration report by start date:

1. Go to Reports > Integration > Integration and Automation Usage Summary by Job > Customize or
Reports > Integration > Integration and Automation Usage Summary by Record Type > Customize.
2. Click Filters.
3. Under Search Fields box, enter Start Date and click the Search button.
The Actual Job Start Date and Start Date fields are listed.
4. Click Start Date.
This field is added to the Choose Filters pane.
5. In the Choose Filters pane:
1. Set Filter to between.

SuiteTalk SOAP Web Services Platform Guide

Synchronous Request Processing 112

2. Set Date Range to custom.

3. In the From and To fields, enter dates in {mm/dd/yyyy} format.
4. Click Done.
6. Click Save.

Handling of Lengthy Requests

Throughout NetSuite, the maximum duration for a single HTTP connection is 15 minutes. However, in
some cases a SOAP web services request may require more than 15 minutes to process. Because the
system cannot send a response after the connection has timed out, the system handles lengthy requests
differently from those that complete more quickly. The exact handling varies depending on the operation.
For details, see the following:

■ Single-Record Requests
■ List and Search Requests

Single-Record Requests
If a synchronous single-record operation does not complete within 15 minutes, the operation is allowed
to finish. In these cases, no response is sent, but the system updates the SOAP Web Services Usage Log
with a partial response. However, note that single-record operations almost always complete before the
HTTP connection times out.
A single-record operation is one that creates or affects only one record. For example, add, update, and
delete are single-record operations.

List and Search Requests

In general, a list or search request that requires longer than 15 minutes to process is terminated by the
system. The exact behavior varies depending on the endpoint.

2014.2 Endpoint
When the 2014.2 or a later endpoint is being used, NetSuite sends a response 10 seconds prior to the
connection timeout. The operation is terminated after the record currently being processed has finished.
The system uses the messaging described in the following table.

Operation Type Relevant Operations Messaging

Search ■ search The response indicates that the operation did not
finish because it timed out.
■ searchMoreWithId

List ■ addList The response indicates that the operation did not
finish because it timed out.
■ deleteList
■ getList For records that were successfully processed, the
response indicates success for that record, along with
■ initializeList (for details, see other standard details, such as the record’s internal ID.
initialize / initializeList)
For other records, the status indicates one of the
■ updateList
following:
■ upsertList
■ The record’s status is unknown – This status is used
if the processing of the record was still in progress
when the response was being created.

SuiteTalk SOAP Web Services Platform Guide

Synchronous Request Processing 113

Operation Type Relevant Operations Messaging

■ The record was not processed.

Using this information and the original SOAP request,

you can determine which data to resend.

The following screenshot shows a response for an addList operation that was terminated.

2014.1 Endpoint and Earlier

If you are using 2014.1 or an earlier endpoint, a lengthy operation is stopped after 15 minutes. The
system does not send a response, but it updates the SOAP Web Services Usage Log with a partial
response, which shows only the records that were processed. For help with the SOAP Web Services Usage
Log, see Using the SOAP Web Services Usage Log.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Security 114

SOAP Web Services Security

NetSuite leverages the latest industry security standards to ensure high levels of security around your
business data. All SOAP web services requests are controlled by the same security measures used in the
NetSuite UI. This includes:

■ Authentication for SOAP Web Services

■ Authorization for SOAP Web Services
■ Session Management for SOAP Web Services
■ Encryption for SOAP Web Services

Additional security-related topics include:

■ Custom Field Security - for information on security applied at the field level and its affect on SOAP web
services
■ PCI Compliance Password Requirements - for information on password requirements associated with
the Payment Card Industry (PCI) Data Security Standard

Authentication for SOAP Web Services

Authentication is the process of determining the identity of requesters by verifying the credentials they
present. Most SOAP web services operations require authentication.

The available methods of authentication include the following:

■ Token-Based Authentication
■ User Credentials
■ Outbound Single Sign-on (SuiteSignOn)

Important: Use only one authentication method in one SOAP message. Mixing different
authentication types in a single SOAP message returns a SOAP fault.

Token-Based Authentication
With this approach, the request must include a consumer key, a token, and other data. Authentication
details must be sent by using request-level credentials, not the login operation. For details on structuring
a SOAP request this way, see Request-Level Credentials.

You generate a consumer key and secret when you create an integration record and configure the record
to permit token-based authentication (by checking the Token-based Authentication box). For details,
see Integration Management.

SuiteTalk SOAP Web Services Platform Guide

Authentication for SOAP Web Services 115

Important: Token-based authentication is supported for use only with the 2015.2 endpoint and
later.

User Credentials
Important: As of the 2020.2 SOAP web services endpoint, authentication through request-
level credentials is not supported. The Passport complex type is not supported. If you attempt to
authenticate through request-level credentials in SOAP web services 2020.2 and later endpoints,
the web services request is not processed, and an error message is returned. You must ensure
that SOAP web services integrations created with 2020.2 and later SOAP web services endpoints
use TBA. Authentication through user credentials continues to be supported in integrations that
use SOAP web services 2020.1 and earlier endpoints. For more information, see the help topic
Token-based Authentication and Web Services.

With this approach, the request must include the credentials associated with a single user: an email
address, password, role, and NetSuite account ID. To find your account ID, go to the SOAP Web Services
Preferences page at Setup > Integration > Integration Management > SOAP Web Services Preferences.
For a list of NetSuite role internal IDs, see Internal IDs Associated with Roles.

When you authenticate by using user credentials, there are two approaches to how the SOAP request
may be structured: you can use the login operation or you can use request-level credentials. For details,
see Structuring SOAP Requests to Include Authentication Details.

For requests that use the 2015.2 WSDL or later, application ID is also mandatory, although technically
application ID is not considered a part of the user authentication process. An application ID is used to
link a request to an integration record that exists in your NetSuite account. To use any integration record
for requests that authenticate through user credentials, the record must have the User Credentials box
checked. For details, see Integration Management.

Outbound Single Sign-on (SuiteSignOn)

This approach allows an external application to perform callbacks to NetSuite after the SuiteSignOn
handshake is complete and there is a live SuiteSignOn token. See the SuiteSignOn Sequence Diagram and
Connection Details for details.

For more information about SuiteSignOn, see the help topic Outbound Single Sign-on (SuiteSignOn).

Structuring SOAP Requests to Include Authentication

Details
If your chosen authentication method is user credentials, the SOAP web services platform supports two
approaches for structuring your SOAP requests. These approaches are described in the following table.

For token-based authentication, you must use request-level credentials.

Note: For more information about token-based authentication, see Token-Based Authentication
Details.

Name Valid with Notes

Login operation ■ Authentication through user credentials This approach initiates a

session that is governed
by timeout and user limits.

SuiteTalk SOAP Web Services Platform Guide

Authentication for SOAP Web Services 116

Name Valid with Notes

For details, see Login and
ssoLogin Operations.

Request-level ■ Authentication through user credentials You can send credentials in

credentials the SOAP header of every
■ Token-based authentication
request. This approach
initiates a stateless form
Important: As of the 2020.2 SOAP web services of SOAP web services
endpoint, authentication through request-level communication in which the
credentials is not supported. The Passport complex type login operation is not invoked
is not supported. If you attempt to authenticate through and certain timeouts do not
request-level credentials in SOAP web services 2020.2 apply. For details, see Request-
and later endpoints, the web services request is not Level Credentials.
processed, and an error message is returned. You must
ensure that SOAP web services integrations created with For information about
2020.2 and later SOAP web services endpoints use TBA. using the TokenPassport
Authentication through user credentials continues to be complex type with token-
supported in integrations that use SOAP web services based authentication, see
2020.1 and earlier endpoints. For more information, TokenPassport Complex Type
see the help topic Token-based Authentication and Web and Updating a SOAP Web
Services. Services Integration to Send
Token-Based Authentication
Details.

Note: If you are using outbound SSO, the information in this topic does not apply. For details on
outbound SSO, see the help topic Outbound Single Sign-on (SuiteSignOn).

Login and ssoLogin Operations

Important: As of the 2020.2 SOAP web services endpoint, authentication through request-
level credentials is not supported. The Passport complex type is not supported. If you attempt to
authenticate through request-level credentials in SOAP web services 2020.2 and later endpoints,
the web services request is not processed, and an error message is returned. You must ensure
that SOAP web services integrations created with 2020.2 and later SOAP web services endpoints
use TBA. Authentication through user credentials continues to be supported in integrations that
use SOAP web services 2020.1 and earlier endpoints. For more information, see the help topic
Token-based Authentication and Web Services.

Request-Level Credentials
Important: As of the 2020.2 SOAP web services endpoint, authentication through request-
level credentials is not supported. The Passport complex type is not supported. If you attempt to
authenticate through request-level credentials in SOAP web services 2020.2 and later endpoints,
the web services request is not processed, and an error message is returned. You must ensure
that SOAP web services integrations created with 2020.2 and later SOAP web services endpoints
use TBA. Authentication through user credentials continues to be supported in integrations that
use SOAP web services 2020.1 and earlier endpoints. For more information, see the help topic
Token-based Authentication and Web Services.

Using the Login Audit Trail

The Login Audit Trail is a specialized search that helps keep track of account users, when they have
logged in, and from where.

SuiteTalk SOAP Web Services Platform Guide

Authentication for SOAP Web Services 117

By using the Login Audit Trail search, you can also find out details about why a SOAP web services request
failed to authenticate.

To define an advanced Login Audit Trail search to see details of SOAP web services login requests:

1. Go to Setup > Users/Roles > User Management > View Login Audit Trail.
2. Check the Use Advanced Search box.
3. Click the Results subtab to define the columns that are displayed in the search results. To view
more verbose information about login attempts, add the Detail result field.
4. Click Submit to run the search and display the results.

The Detail column in the search results contains more information about the login attempts, and provides
information about the reason for the authentication failure.

The following messages indicate some of the most common issues:

■ NonceUsed — The combination of nonce and timestamp was already used by the same user.
■ InvalidTimestamp — The timestamp provided is different from the correct server time by more than
five minutes.
■ InvalidSignature — The request was not signed correctly.

For more information about defining Login Audit Trail searches, see the help topic Login Audit Trail
Overview.

For more information about error messages displayed in the Login Audit Trail, see the help topic TBA-
Related Error Messages in the Login Audit Trail.

Authorization for SOAP Web Services

Authorization is the process of ensuring that the requester has the appropriate entitlement to perform
the requested operation. When users request to be authenticated, they also provide their NetSuite role.
For every SOAP web services request, the system uses the role definition to ensure that the user has the
required permission for the requested operation as well as the requested record type. The role must be
provided in the Passport type via the login operation:

Important: As of the 2020.2 SOAP web services endpoint, authentication through request-
level credentials is not supported. The Passport complex type is not supported. If you attempt to
authenticate through request-level credentials in SOAP web services 2020.2 and later endpoints,
the web services request is not processed, and an error message is returned. You must ensure
that SOAP web services integrations created with 2020.2 and later SOAP web services endpoints
use TBA. Authentication through user credentials continues to be supported in integrations that
use SOAP web services 2020.1 and earlier endpoints. For more information, see the help topic
Token-based Authentication and Web Services.

Example

<soapenv:Body
<login xmlns="urn:messages_2018_1.platform.webservices.netsuite.com">
<passport>
<ns1:email xmlns:ns1="urn:core_2018_1.platform.webservices.netsuite.com">[email protected]</ns1:email>
<ns2:password xmlns:ns2="urn:core_2018_1.platform.webservices.netsuite.com">********</ns2:password>
<ns3:account xmlns:ns3="urn:core_2018_1.platform.webservices.netsuite.com">1234567</ns3:account>
<ns4:role internalId="37" xmlns:ns4="urn:core_2018_1.platform.webservices.netsuite.com"/>
</passport>

SuiteTalk SOAP Web Services Platform Guide

Authorization for SOAP Web Services 118

</login>
</soapenv:Body>

For detailed information on NetSuite roles and permissions and how SOAP web services implement roles
and permissions rules, refer to Roles and Permissions in SOAP Web Services.

Session Management for SOAP Web Services

Warning: As of the 2020.1 endpoint, the login and logout operations are no longer working.
This is because as of the 2020.1 endpoint you must use token-based authentication to
login, instead of the login operation. For more information, see the help topic Token-based
Authentication (TBA). The operation is still working for earlier endpoints that are still supported.
For more information about supported endpoints, see Support for Existing WSDL Versions.

As of the 2020.2 SOAP web services endpoint, authentication through request-level credentials
is not supported. The Passport complex type is not supported. If you attempt to authenticate
through request-level credentials in SOAP web services 2020.2 and later endpoints, the web
services request is not processed, and an error message is returned.

User credentials are not recommended as an authentication method for SOAP web services. If you
are currently using this method, you should transition to use token-based authentication instead.

In NetSuite, session management includes:

■ Session Timeouts
■ Session Limits
■ Manually Managing Cookies

Session Timeouts
The Open Web Application Security Project (OWASP) provides the following guideline: All sessions should
implement an absolute timeout, regardless of session activity. This timeout defines the maximum amount
of time a session can be active. The session is closed and invalidated upon the defined absolute period.
After the session is invalidated, the user must authenticate (log in) again in the web application and
establish a new session. The absolute session timeout limits the amount of time possible for a potential
attacker to use a hijacked session to impersonate a user.

Important: To enhance the security of your account, and to comply with the OWASP guideline,
there is an absolute session timeout implemented for SOAP web services sessions. Currently, the
absolute session timeout value is set to 60 minutes, even if the session is active.

If you use sessions with your SOAP web services integrations, you must ensure that your SOAP web
services calls are able to handle session timeouts. It is recommended that your integrations should
use sessionless protocols based on request-level credentials, such as user credentials or token-based
authentication (TBA). Using TBA is recommended. See Authentication for SOAP Web Services for more
information.

SOAP web services sessions automatically time out after 20 minutes of inactivity, requiring a login to
resume activity. If the server resubmits the cookie during the first 20 minutes, the inactivity timer is reset.

SuiteTalk SOAP Web Services Platform Guide

Session Management for SOAP Web Services 119

If a SOAP web services operation takes more than 15 minutes to complete, it automatically times out.
In this case, consider using asynchronous request processing. For more information, see Synchronous
Versus Asynchronous Request Processing.

If you explicitly log out of a session, and then attempt to use the same session, a SESSION_TIMED_OUT
error message is returned. Your code should be prepared to handle session timeouts by retrying if an
InvalidSessionFault (SESSION_TIMED_OUT) error is received.

Important: Do not make any integration decisions based on the value of the absolute timeout
value or the idle session timeout values, as these values can be changed at any time without
notice.

Session Limits
Session limits involve both user limits and account limits.

User Limits
A specific login (user name, account and password) that is used for a UI session can be used to create
one or more sessions through SOAP web services by using the login operation. More SOAP web services
sessions can occur concurrently, but the number of operations processed concurrently is limited. The UI
session does not affect the SOAP web services sessions and operations.

Without a SuiteCloud Plus license, it is recommended for one user to only create one SOAP web services
session using the login operation, and send requests using this session in one thread sequentially.

If the NetSuite server receives two login or other operations from the same user at the same moment, the
second operation is rejected, and the error "Only one request may be made against a session at a time” is
sent. The error indicates that the per user governance limit is exceeded.

Using the same login from multiple client applications, or multiple instances of the same application is
NOT supported.

If you have a SuiteCloud Plus license, you can designate users as concurrent SOAP web services users.
One SuiteCloud Plus license allows you to designate one user as concurrent SOAP web services user. One
concurrent SOAP web services user can send up to 10 concurrent SOAP web services requests.

Note: If the total account limit for concurrent requests is exceeded, one concurrent SOAP web
services user might not be able to send 10 concurrent requests.

Account Limits
Note that starting from version 2017.2, web services concurrency is not only governed separately per
user and authentication method, but also per account. For information about account concurrency limits,
see Web Services and RESTlet Concurrency Governance.

Each SuiteCloud Plus license increases the account concurrency governance limit by 10, meaning that you
can have 10 additional parallel requests at the same per account. The account base limit depends on your
service tier. For details, see Enabling Web Services Concurrent Users with SuiteCloud Plus.

Manually Managing Cookies

When submitting SOAP web services requests, the NetSuite server can accept any SOAP document
as long as it is valid against the NetSuite WSDL, and it does not matter how the SOAP document was

SuiteTalk SOAP Web Services Platform Guide

Session Management for SOAP Web Services 120

generated. You must ensure that all cookies received from the server are managed and passed back to
the server in subsequent calls. There are a total of three cookies that are initially returned in the HTTP
header of the login response, including the JSESSIONID.

Note: The JSESSIONID cookie is only generated if you use the Login or the ssoLogin operation
for authentication. If you use request-level credentials, this cookie is not generated.

Ensure that your client persists any cookies that our server sends you (re-submits the cookie on the next
request). In Axis, this is accomplished by enabling MaintainSession on the generated Binding object.
In .NET, this involves allocating a CookieContainer. If persistence is not maintained, you will receive the
following error message: SESSION_TIMED_OUT — ”Your connection has timed out. Please log in again.”

Example
The following code shows the cookie information returned in the login response. The cookie information
is contained in the Set-Cookie lines of the code.

HTTP/1.1 200 OK
Date: Mon, 16 Oct 2017 13:34:48 GMT
Content-Type: text/xml; charset=utf-8
X-N-OperationId: a8f84e6e-6300-4f92-9a1a-30fae3da1978
X-Netsuite-Approute: host=test.eng.netsuite.com;enter=2017-10-16 06:34:48.716;buf=785;versrc=passport;apco=err_cxn;ver=2018.1.0;d
cid=000;exit=2017-10-16 06:34:48.720;events=setcookie,rule
Set-Cookie: JSESSIONID=iR8lZOFn88GFV23ZVnnS0BUTi6V2fJZZzil02Xf9gyXvNTVNarxfIWRanvswN0LDYW-gKsBUo75gVslo42EfwTm-qlKnTDo5Syn
W_nc-Yvh0dQJVTzHokW9qGvoyn0jW!-477725890; path=/; HttpOnly
Set-Cookie: NS_ROUTING_VERSION=LAGGING; path=/
Set-Cookie: NS_VER=2017.2.0; domain=test.eng.netsuite.com; path=/
P3P: CP="CAO PSAa OUR BUS PUR"
Vary: User-Agent
Connection: close

For each subsequent request, all of the cookies must be returned in the HTTP header to maintain the
session as follows:

NetSuiteService nss = new NetSuiteService();

nss.Url = https://webservices.netsuite.com/services/NetSuitePort_2017_1_0 ;
nss.CookieContainer = new CookieContainer();

Note: This snippet assumes that your integration includes a Using System.Net; statement.

Java with Axis 1.4

NetSuiteServiceLocator service = new DataCenterAwareNetSuiteServiceLocator(_properties.getProperty("login.acct"));

service.setMaintainSession(true);

Encryption for SOAP Web Services

SOAP web services in NetSuite are protected by TLS encryption. Only requests sent using TLS encryption
are granted access. For more information, see the help topic Supported TLS Protocol and Cipher Suites.

SuiteTalk SOAP Web Services Platform Guide

Custom Field Security 121

Custom Field Security

Custom field security can be applied on a per-field basis. If field security has been applied to a field in the
UI, the custom field schema will include the field level security metadata. Consequently, users should be
aware that the permissions they specify on custom fields will apply to any existing integration that is in
place using endpoints 2008_1 and older. Certain field permissions such as NONE and VIEW might break
the integration in an unintended way.

Note: See the help topic Restricting Access to Custom Fields for details on this feature.

If the custom field security feature is turned on, SOAP web services will respect the access level set on
each field. For example, if you have set a field permission to NONE, and you have code that references
the field, you will not be able to read or write to that field in your code. NetSuite SOAP web services will
essentially ignore that field when the SOAP request is sent. Similarly, if a field permission has been set to
VIEW, you will be able to read the field's value, but you will be unable to set the field's value.

SOAP web services developers should keep custom field security in mind when designing their
integrations. Before beginning a project, they should work with their company's NetSuite administrator to
review which fields may have custom security applied.

SuiteTalk SOAP Web Services Platform Guide

Platform Features 122

Platform Features
The SOAP web services platform refers to the software infrastructure used to expose NetSuite application
functionality via SOAP web services. This section describes some of the core features of the SOAP web
services and includes the following sections:

■ Enabling Web Services Concurrent Users with SuiteCloud Plus: provides an overview of the Web
Services Plus license type.
■ Operations and Their Internal ID Requirements: describes IDs and how they are used.
■ Using SOAP web services to Send Data from a CSV File: describes how to use the NetSuite Data Loader
tool.
■ Searching for SOAP Web Services Log Information: describes how to search for SOAP web services
operation and record information.
■ SOAP Web Services Operations Search Type: describes the SOAP web services operation fields
available for search.
■ SOAP Web Services Record Processing Search Type: describes the SOAP web services record fields
available for search

Important: NetSuite hosts customer accounts in multiple data centers. For that reason, the
correct URL for SOAP web services access varies depending on the data center hosting the
account.

For details about dynamic discovery of URLs, see the help topic Dynamic Discovery of URLs for
SOAP Web Services and RESTlet Clients.

Enabling Web Services Concurrent Users with

SuiteCloud Plus
Your account must have the web services feature enabled before you can assign a user to be a web
services concurrent user. See Enabling the SOAP Web Services Feature for details.

Any user can be designated as concurrent web services user if one or more SuiteCloud Plus license has
been purchased.

Generally, you can purchase one SuiteCloud Plus license per NetSuite account. Contact your sales
representative to discuss any need for additional licenses.

Web services and RESTlet concurrency is also governed per account. The new account governance limit
applies to the combined total of web services and RESTlet requests. Due to this change, if a designated
user makes 10 concurrent web services requests, the number of successful requests depends on other
web services or REST requests that are being processed. Each SuiteCloud Plus license increases the
account base limit for concurrent web services requests by 10. The account base limit depends on your
service tier.

Note: The account limit is lenient, and it is possible to temporarily exceed the limit.

Important: If you use token-based authentication with SOAP web services, a single user can
send concurrent requests up to the account limit. For more information, see SOAP Web Services
Governance for Token-Based Authentication.

For more information about account base limits and the concurrency governance, see Web Services and
RESTlet Concurrency Governance.

SuiteTalk SOAP Web Services Platform Guide

Enabling Web Services Concurrent Users with SuiteCloud Plus 123

Note: SuiteCloud Plus provides other benefits. It increases the number of scheduled script
processors. For details, see the help topic Scheduled Scripts on Accounts with Multiple Processors
(SuiteCloud Plus). It allows the use of multi-threading for CSV import jobs and increases the
number of import jobs that can be run in parallel. For details, see the help topic Use Multiple
Threads and Multiple Queues to Run CSV Import Jobs. For a summary of SuiteCloud Plus
capabilities, see the help topic SuiteCloud Plus Settings.

To designate a user as a concurrent web services user:

1. Open the employee record.

2. Click the Access subtab.
3. Check the Concurrent Web Services User box.
4. Click Save.

Operations and Their Internal ID Requirements

The following table lists the ID requirements for each operation. Note that IDs are only required in calls
where specific records corresponding to the call exist in the NetSuite database. For example, on an add
operation, no ID is required in the request since the record does not yet exist.

An internal ID is created by the system and returned in the response. On search operations, because a
specific record is not being called, an internal ID is not required in the request. However, an internal ID for
each record found is returned in the response.

Note: Since external IDs are provided by the client application, if an external ID is desired for a
record, it can be submitted on an Add operation.

Operation Record ID Required in Record ID Returned in

Request Response

logout — —

add/addList No Yes

update/updateList Yes Yes

delete/deleteList Yes Yes

getDeleted No Yes

get/getList Yes Yes

SuiteTalk SOAP Web Services Platform Guide

Operations and Their Internal ID Requirements 124

Operation Record ID Required in Record ID Returned in

Request Response

getAll No Yes

search/searchNext/searchMore/searchMoreWithId No Yes

getSavedSearch No Yes

The following samples show the use of internal IDs as they pertain to operations. Click to see samples for
any of the following:

■ add operation
■ update operation
■ deleteList operation
■ getList operation
■ search operation

add operation
For an add operation, an internal ID is not required in the request since the record does not yet exist. The
internal ID (in this case 100101) is returned in the response.

Note: There are internal IDs listed in the request, but these internal IDs are embedded in the
request and do not correspond to the actual record being added (an event) but to other existing
records associated with the event record being added.

Request

<soap:Body>
<platformMsgs:add>
<platformMsgs:record xsi:type="actSched:CalendarEvent">
<actSched:title>Web Services Meeting</actSched:title>
<actSched:organizer internalId="-5" type="calendarEvent" xsi:type="platformCore:RecordRef">
<platformCore:name>Mr. Wolfe</platformCore:name>
</actSched:organizer>
<actSched:location>Main Conference Room</actSched:location>
<actSched:attendeeList replaceAll="true" xsi:type="actSched:CalendarEventAttendeeList">
<actSched:attendee xsi:type="actSched:CalendarEventAttendee">
<actSched:sendEmail>false</actSched:sendEmail>
<actSched:attendee internalId="21" type="calendarEvent" xsi:type="platformCore:RecordRef"/>
<actSched:response>_accepted</actSched:response>
<actSched:attendance>_optional</actSched:attendance>
</actSched:attendee>
<actSched:attendee xsi:type="actSched:CalendarEventAttendee">
<actSched:sendEmail>false</actSched:sendEmail>
<actSched:attendee internalId="27" type="calendarEvent" xsi:type="platformCore:RecordRef"/>
<actSched:response>_accepted</actSched:response>
<actSched:attendance>_optional</actSched:attendance>
</actSched:attendee>
</actSched:attendeeList>
</platformMsgs:record>
</platformMsgs:add>
</soap:Body>

Response

<soapenv:Body>

SuiteTalk SOAP Web Services Platform Guide

Operations and Their Internal ID Requirements 125

update operation
In this example the record added above is being updated — since the internal ID matches the one
created in the add operation (100101). Here, the internal ID and the record type are required in the
request and both are also returned in the response.

Request

<soap:Body>
<platformMsgs:update>
<platformMsgs:record internalId="100101" xsi:type="actSched:CalendarEvent">
<actSched:title>Web Services Meeting (Platform)</actSched:title>
</platformMsgs:record>
</platformMsgs:update>
</soap:Body>

Response

<soapenv:Body>
<updateResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<writeResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<ns1:status isSuccess="true" xmlns:ns1="urn:core_2017_1.platform.webservices.netsuite.com"/>
<baseRef internalId="100101" type="calendarEvent" xsi:type="ns2:RecordRef" xmlns:xsi="http://www.w3.org/2001/XMLSchema-
instance" xmlns:ns2="urn:core_2017_1.platform.webservices.netsuite.com"/>
</writeResponse>
</updateResponse>
</soapenv:Body>

deleteList operation
In the following delete request, the internal IDs are required for the request and returned in the
response. In this case, three event records are deleted (100101, 100102, and 100103).

Request

<soap:Body>
<platformMsgs:deleteList>
<platformMsgs:baseRef internalId="100101" type="calendarEvent" xsi:type="platformCore:RecordRef"/>
<platformMsgs:baseRef internalId="100102" type="calendarEvent" xsi:type="platformCore:RecordRef"/>
<platformMsgs:baseRef internalId="100103" type="calendarEvent" xsi:type="platformCore:RecordRef"/>
</platformMsgs:deleteList>
</soap:Body>

Response

<soapenv:Body>
<deleteListResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<writeResponseList xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">

SuiteTalk SOAP Web Services Platform Guide

Operations and Their Internal ID Requirements 126

getList operation
In this example, an internal ID is called for each record to be retrieved — in this case, three different event
records. Again, the internal ID is required for the request and returned in the response.

Request

<soap:Body>
<platformMsgs:getList>
<platformMsgs:baseRef internalId="100104" type="calendarEvent" xsi:type="platformCore:RecordRef"/>
<platformMsgs:baseRef internalId="100105" type="calendarEvent" xsi:type="platformCore:RecordRef"/>
<platformMsgs:baseRef internalId="100106" type="calendarEvent" xsi:type="platformCore:RecordRef"/>
</platformMsgs:getList>
</soap:Body>

Response

<soapenv:Body>
<getListResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<readResponseList xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<readResponse>
<ns1:status isSuccess="true" xmlns:ns1="urn:core_2017_1.platform.webservices.netsuite.com"/>
<record internalId="100104" xsi:type="ns2:CalendarEvent" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:n
s2="urn:scheduling_2017_1.activities.webservices.netsuite.com">
<ns2:title>Customization Meeting</ns2:title>
<ns2:organizer internalId="-5">
.........[more fields]
</record>
</readResponse>
<readResponse>
<ns8:status isSuccess="true" xmlns:ns8="urn:core_2017_1.platform.webservices.netsuite.com"/>
<record internalId="100105" xsi:type="ns9:CalendarEvent" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:n
s9="urn:scheduling_2017_1.activities.webservices.netsuite.com">
<ns9:title>Web Services Meeting (Records)</ns9:title>
<ns9:organizer internalId="-5">
.........[more fields]
</record>
</readResponse>
<readResponse>
<ns15:status isSuccess="true" xmlns:ns15="urn:core_2017_1.platform.webservices.netsuite.com"/>
<record internalId="100106" xsi:type="ns16:CalendarEvent" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:n
s16="urn:scheduling_2017_1.activities.webservices.netsuite.com">
<ns16:title>Web Services Meeting</ns16:title>
<ns16:organizer internalId="-5">
.........[more fields]
</record>
</readResponse>

SuiteTalk SOAP Web Services Platform Guide

Operations and Their Internal ID Requirements 127

</readResponseList>
</getListResponse>
</soapenv:Body>

search operation
For the search operation, an internal ID is not required for the request but is returned for each record
found that matches the specified criteria. In this case, two event records are returned for a search request
calling for each event record that contains web services in the title field.

(Request)
<soap:Body>
<platformMsgs:search>
<platformMsgs:searchRecord xsi:type="actSched:CalendarEventSearch">
<actSched:title operator="contains" xsi:type="platformCore:SearchStringField">
<platformCore:searchValue>web services</platformCore:searchValue>
</actSched:title>
</platformMsgs:searchRecord>
</platformMsgs:search>
</soap:Body>

(Response)
<soapenv:Body>
<searchResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<searchResult xmlns="urn:core_2017_1.platform.webservices.netsuite.com">
<status isSuccess="true"/>
<totalRecords>2</totalRecords>
<pageSize>10</pageSize>
<totalPages>1</totalPages>
<pageIndex>1</pageIndex>
<recordList>
<record internalId="100105" xsi:type="ns1:CalendarEvent" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:n
s1="urn:scheduling_2017_1.activities.webservices.netsuite.com">
<ns1:title>Web Services Meeting (Records)</ns1:title>
<ns1:organizer internalId="-5">
.....[more fields]
</record>
<record internalId="100106" xsi:type="ns2:CalendarEvent" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:n
s2="urn:scheduling_2017_1.activities.webservices.netsuite.com">
<ns2:title>Web Services Meeting</ns2:title>
<ns2:organizer internalId="-5">
.....[more fields]
</record>
</recordList>
</searchResult>
</searchResponse>
</soapenv:Body>

Using SOAP web services to Send Data from a CSV

File
If you have external data stored in a CSV file and want to load this data into NetSuite, you can use the new
NetSuite Data Loader sample application. With this application, you can send SOAP web services requests
that use the data in your CSV files. This approach is beneficial because it lets you use parallel connections,
as available based on your NetSuite licensing.

SuiteTalk SOAP Web Services Platform Guide

Using SOAP web services to Send Data from a CSV File 128

Important: NetSuite Data Loader is intended as a demo application. No regular maintenance is

provided for this application.

NetSuite Data Loader

NetSuite Data Loader is a command line Java application. It requires Gradle and Java JDK 6 to build. The
source code is available for download.
To use the NetSuite Data Loader:

1. Make sure that you are logged in to NetSuite as administrator.

2. Make sure you have enabled the SOAP web services feature at Setup > Company > Setup Tasks >
Enable Features, on the SuiteCloud tab.
3. Select and copy the URL: https://<accountid>.app.netsuite.com/app/external/integration/
integrationDownloadPage.nl.
4. Paste the URL in the address bar of your browser.
5. Substitute your account ID in the URL.
6. Press Enter.
7. Click the link for the .zip file.
8. Read and agree to the license terms.
9. Wait for download to finish.
10. Navigate to the tool's doc directory.
11. Review the README file for more detailed instructions.

Searching for SOAP Web Services Log Information

As of 2016.2, you can access SOAP web services log information through searches in the NetSuite UI. You
can set up results columns and filter data to return only the details you need. These searches support
analysis of SOAP web services failures.
You can create SOAP web services log searches by going to Reports > New Search and selecting one of
the following new search types:

■ SOAP Web Services Operations — Use this type to search for and analyze information about failing
SOAP web services requests and operations.
■ SOAP Web Services Record Processing — Use this search type to search for and analyze information
about failing SOAP web services records.

Each new search type includes join fields to the other search type, so the two search types can be joined
for a more comprehensive SOAP web services log information search.
Note the following:

■ SOAP web services execution log items are retained for one month, so searches do not return data
older than one month.
■ Results for these searches are limited to log items created as of 2016.2; log items created prior to this
release are not included.

Permissions for Accessing SOAP Web Services Searches

Three permissions have been added to NetSuite 2016.2 to for the SOAP web services search types in the
UI.

SuiteTalk SOAP Web Services Platform Guide

Searching for SOAP Web Services Log Information 129

■ The Reports type Integration permission provides access to the Integration field in the SOAP Web
Services Operations search.
■ The Setup type Integration Application permission provides access to the Request and Response
fields in the SOAP Web Services Operations search.
■ The Setup type Set Up SOAP Web Services permission provides access to the SOAP Web Services
Record Processing search.

SOAP Web Services Operations Search Type

The following SOAP web services operation fields are available for search:

■ API Version — The API version used to perform the operation.

■ Authentication Method — The authentication method used by the operation.
■ Job ID — The Job ID.
■ Time — The date and time the operation was performed.
■ Duration — The length of time (in seconds) it took to process the operation.
■ Operation — The SOAP web services operation.
■ Operation Status — The operation status; failed, finished, finished with errors, processing, or
rejected.
■ User Email — The email address associated with the account that performed the operation.
■ Records In Request — The number of records in the request.
■ Records in Response — The number of records in the response.
■ Failed Records — The number of records that failed.
■ Service Type — The type of service used: SYNC or ASYNC.
■ Integration — The related integration record.
■ Finished Records — The number of records completed for the selected operation. This column is
available for advanced searches.
■ Request — A link to the SOAP request. This column is available for advanced searches.
■ Response — A link to the SOAP response. This column is available for advanced searches.

The following image shows the results of a SOAP web services operations search.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Operations Search Type 130

Note: In production environments, the data is accessible for 21 days. In sandbox environments,
the data is accessible for seven days.

SOAP Web Services Record Processing Search Type

The following SOAP web services record fields are available for search:

■ Duration — The length of time (in seconds) it took to process the record.
■ Operation — The operation performed on the record, either ADD, UPDATE, or DELETE.
■ Record Type — The record type.
■ Sequence Number in Request — When multiple records are processed during an operation, this
field indicates the sequence number or processed record within the operation.
■ Status — The record’s status, either Complete, Partially complete, or Failed.
■ Time — The date and time when the record was processed.
■ Record — The record that was processed. This column is available for advanced searches.

Note: In production environments, the data is accessible for 21 days. In sandbox environments,
the data is accessible for seven days.

SuiteTalk SOAP Web Services Platform Guide

Types 131

Types
This section describes the following:

■ Built-in Types — primitive or derived datatypes defined in the XML Schema specification
■ Complex Types — NetSuite derived datatypes
■ Custom Field Types — datatypes used for custom fields
■ Search Types — datatypes used for search records
■ Platform Enumerations — datatypes used to populate system defined lists

A WSDL document in SOAP web services uses the XML Schema to define the structure, semantics and
constraints of the messages sent between the sender and recipient. The XML Schema is a W3C standard.

There is a strong analogy between object-oriented programming and XML Schema. A type defined in XML
Schema can be used to represent an instance of that type in an XML document. Therefore, the body of a
SOAP message consists of a combination of such instances of an XML Schema type.

Built-in Types
Built-in (or primitive) types are those that are not defined in terms of other datatypes. They are used as
a standardized way to define, send, receive and interpret basic data types in SOAP messages. Primitive
data types used in the SOAP web services can be modified for display purposes. For example, although a
price field may be passed in the SOAP messages using an integer primitive data type, the NetSuite UI may
format the value with a currency symbol for display purposes.

Of the extensive set of built-in (or primitive) types provided by the XML Schema language specification,
the SOAP web services implementation uses the following built-in types. For detailed information on XML
Schema built-in types, refer to http://www.w3.org/TR/xmlschema-2/.

■ string —represents character strings in XML

■ int — derived from the decimal type and represents the standard concept of the integer numbers
■ double — is patterned after the IEEE double-precision 64-bit floating point type
■ boolean — represents the concept of binary-valued logic: {true, false}. In NetSuite, a boolean field can
be set to true, false, 1 to indicate true, or 0 to indicate false.
□ In the 2010.2 endpoint and later, SOAP web services validates boolean values. Each value must be
a true xsd boolean (0,1,true,false) as per the W3C specification. For details, see the specification.
□ In endpoints prior to 2010.2, invalid values are treated as false.
■ dateTime — represents integer-valued year, month, day, hour and minute properties. For example,
2005-09-21T15:24:00.000-07:00, where 2005-09-21 is the date, 15:24:00.000 is the time and -07:00 is
the timezone offset. For more information about the dateTime type, see Datetime Fields.

Complex Types
Complex types are structured types built by aggregating elements of simple or previously defined
complex types. NetSuite complex types are defined in the platform core and platform core types XSDs. All
NetSuite record types ultimately reference one of these complex types.

NetSuite complex types include the following:

SuiteTalk SOAP Web Services Platform Guide

Complex Types 132

■ Passport
■ TokenPassport
■ Record
■ RecordList
■ BaseRef
■ RecordRef
■ CustomRecordRef
■ ListOrRecordRef
■ Status
■ StatusDetail
■ NullField
■ ReadResponse
■ ListReadResponse
■ ListWriteResponse
■ WriteResponse

Passport
Important: As of the 2020.2 SOAP web services endpoint, authentication through request-
level credentials is not supported. The Passport complex type is not supported. If you attempt to
authenticate through request-level credentials in SOAP web services 2020.2 and later endpoints,
the web services request is not processed, and an error message is returned. You must ensure
that SOAP web services integrations created with 2020.2 and later SOAP web services endpoints
use TBA. Authentication through user credentials continues to be supported in integrations that
use SOAP web services 2020.1 and earlier endpoints. For more information, see the help topic
Token-based Authentication and Web Services.

The Passport type is used by the login operation to encapsulate the security credentials required for
authentication. The passport type is defined in the core.xsd.

Field Name XML Schema Type Req Notes

email xsd:string Y

password xsd:string Y

account xsd:string Y Must correspond to a valid NetSuite account number

role RecordRef Y A role is a set of permissions that lets a user access specific areas of
data. If not set, NetSuite uses the default Web Services role set for
this user.

The default web services role for a specific user is dependent on the values set when setting the
permissions for a particular role. These are set through the UI in Setup > Users/Roles > Manage Roles.

TokenPassport
The TokenPassport type is used by SOAP web services requests that use token-based authentication. The
TokenPassport type is defined in the core.xsd.

SuiteTalk SOAP Web Services Platform Guide

Complex Types 133

Field Name XML Schema Type Req Notes

account xsd:string Y

consumerKey xsd:string Y

token xsd:string Y

nonce xsd:string Y

timestamp xsd:long Y

signature xsd:string Y

Note: For information about the TokenPassport type, see TokenPassport Complex Type.

Record
The Record type is an abstract type used as the parameter for the add, addList, delete, deleteList, update
and updateList operations. It is also returned in the get, getList, search, searchMore and searchNext
operations. All business object types extend the Record type. The record type is defined in core.xsd.

Field Name XML Schema Type Req Notes

id xsd:string N
(attribute)

xsi:type xsi:type (attribute) N This is a field (attribute) that is automatically implemented by the XML
Schema. The value should represent the concrete Record type such as
Customer or Event.

nullFieldList NullFields[] N A list of fields that are to be set to null explicitly in the update
operation.

Note: You cannot set the Custom Form field to NULL. Any
request to set this field to NULL is ignored.

RecordList
The RecordList type is an array of the Record type. The recordList type is defined in core.xsd.

Field Name XML Schema Type Req Notes

record Record [] N

BaseRef
The BaseRef type is an abstract type used to reference any existing record in NetSuite including other
business records and custom records. The BaseRef type is defined in core.xsd.

Field Name XML Schema Type Req Notes

name BaseRef N

SuiteTalk SOAP Web Services Platform Guide

Complex Types 134

RecordRef
The RecordRef type is used to reference an existing record in NetSuite in get operations. Typically, a
RecordRef references one of the following:

■ Another business object such as a customer or sales order

■ An entry in a user defined list such as the category list for contacts or sales tax items

The recordRef type descends from BaseRef and is defined in core.xsd.

Field Name XML Schema Type Req Notes

internalId xsd:string (attribute) Y See Using Internal IDs, External IDs, and References.

type xsd:string (attribute) N Reference to a value in a SOAP web services only system list. If the
type is known by context, the type is NOT required.

name xsd:string N This is a read-only field that is populated by NetSuite when it's a part
of a get or search response. If this field is populated during a write
operation, it will be ignored.

CustomRecordRef
The CustomRecordRef type is used to reference any existing custom record in NetSuite. The
CustomRecordRef type descends from BaseRef and is defined in core.xsd.

Important: Setting the RecordRef.type to customRecord on an add does NOT return a

CustomRecord. You must use CustomRecordRef. The CustomRecordRef has a typeId to indicate
which kind of CustomRecord it is.

Field Name XML Schema Type Req Notes

internalId xsd:string (attribute) Y References the primary record internal Id. This Id corresponds
to the type of custom record. For a list of possible values, see
ListOrRecordRef.

typeId xsd:string Y References the custom record type Id.

type xsd:string (attribute) N Reference to a value in a SOAP web services only system list.

name xsd:string N

ListOrRecordRef
The listOrRecordRef type is defined in core.xsd.

Field Name XML Schema Type Req Notes

internalId xsd:string (attribute) Y See Using Internal IDs, External IDs, and References.

externalId xsd:string (attribute) N Use to reference records by their external ID in select and multi-
select custom fields.

typeId xsd:string (attribute) N Reference to a value in a SOAP web services only system list.

SuiteTalk SOAP Web Services Platform Guide

Complex Types 135

Field Name XML Schema Type Req Notes

name xsd:string N This is a read-only field that is populated by NetSuite when it's a part
of a get or search response. If this field is populated during a write
operation, it is ignored.

Each record type in NetSuite has a corresponding internal ID (or typeId). This internal ID is required when
using ListOrRecordRef since the type of record being referenced needs to be specified.

Note: To update a ListOrRecordRef object, you must use either the internal ID or the external ID
in your request. Using the name field only does not update the object.

For example, in the following code a new ListOrRecordRef object is created. The list references a
specific Entity record as designated by the internalId of 1011 and specifies that the record is of the type
customer (-2). Note that customer records have an internal ID of -2 as shown in the table below.

ListOrRecordRef[] fieldNameEntity = new ListOrRecordRef[1];

fieldNameEntity[0] = new ListOrRecordRef();
fieldNameEntity[0].setInternalId("1011");
fieldNameEntity[0].setTypeId("-2");

Status
The Status type contains an array of objects of type StatusDetail. The status type is defined in core.xsd.

Field Name XML Schema Type Req Notes

statusDetail StatusDetail [] N Used to capture the specific details for the status. See
StatusDetail.

isSuccesss xsd:Boolean (attribute) Y Indicates whether the status is successful or not. If false, one or
more statusDetail objects are populated.

StatusDetail
The StatusDetail type is used to capture the specific details for the status. The statusDetail type is defined
in core.xsd.

Field Name XML Schema Type Req Notes

code xsd:string Y The status code. See SOAP Web Services Error Handling and Error
Codes for a listing of codes.

message xsd:string Y The detailed message for this status. See SOAP Web Services Error
Handling and Error Codes for details.

type xsd:string Reference to a value in a SOAP web services only system list. Values:
error, warning See SOAP Web Services Error Handling and Error Codes
for details.

NullField
The NullField type is defined in core.xsd. It contains the following fields.

SuiteTalk SOAP Web Services Platform Guide

Complex Types 136

Field Name XML Schema Type Req Notes

name xsd:string Y Name of the field to be null. The specified name must exactly
match an existing field name.

Note: You cannot set the Custom Form field to NULL. Any request to set this field to NULL is
ignored.

ReadResponse
The ReadResponse type is used by the following read operations.

■ The getResponse output message for the get operation.

■ The searchResponse output message for the search operations.

These types have a field named readResponse of the type ReadResponse. The ReadResponse type is
defined in message.xsd.

Field Name XML Schema Type Req Notes

status Status Y

recordRef RecordRef N

ListReadResponse
The ListReadResponse type is used by the following operations.

■ The GetListResponse output message for the getList operation.

These types have a field named response of type ListReadResponse. The ListReadResponse type is
defined in message.xsd.

Field Name XML Schema Type Req Notes

response ReadResponse[] Y An array of ReadResponse types.

ListWriteResponse
The ListWriteResponse type is used by the following operations.

■ The AddListResponse output message for the addList operation.

■ The UpdateListResponse output message for the updateList operation.
■ The DeleteListResponse output message for the deleteList operation.

These types have a field named response of type ListWriteResponse. The ListWriteResponse type is
defined in message.xsd.

Field Name XML Schema Type Req Notes

response WriteResponse[] Y An array of WriteResponse types.

SuiteTalk SOAP Web Services Platform Guide

Complex Types 137

WriteResponse
The WriteResponse type is used by the following operations:

■ The AddResponse output message for the add operation

■ The UpdateResponse output message for the update operation
■ The DeleteResponse output message for the delete operation

These types have a field named writeResponse of type WriteResponse. The WriteResponse type is defined
in message.xsd.

Field Name XML Schema Type Req Notes

status Status Y

recordRef RecordRef N

Custom Field Types

Custom fields are represented by the type CustomFieldRef, which is an abstract type. The table below
contains a list of concrete custom field types that extend the CustomFieldRef type. Each type is followed
by its corresponding type in the UI.

XML Schema Type Custom Field Type in UI

LongCustomFieldRef Integer

DoubleCustomFieldRef Decimal Number

BooleanCustomFieldRef Check Box

StringCustomFieldRef Free-Form Text

Text Area
Phone Number
E-mail Address
Hyperlink
Rich Text

DateCustomFieldRef Date
Time of Day

or Date/Time (both in one field)

SelectCustomFieldRef List/Record
Document

MultiSelectCustomFieldRef Multiple Select

CustomFieldRef
The CustomFieldRef type is an abstract type.

Field Name XML Schema Type Req Notes

internalId xsd:string (attribute) Y References a unique instance of a custom field type.

SuiteTalk SOAP Web Services Platform Guide

Custom Field Types 138

To locate the internal ID for a specific custom field in the UI, go to Customization > Lists, Records, & Fields
> [Custom Field] (where [Custom Field] is the type of custom field such as CRM). The internal IDs for each
custom field that has been created is listed in the ID column in the UI.

LongCustomFieldRef
The LongCustomFieldRef type extends the CustomFieldRef abstract type.

Field Name XML Schema Type Req Notes

value xsd:int Y

internalId xsd:string (attribute) Y References a unique instance of a custom field type.

DoubleCustomFieldRef
The DoubleCustomFieldRef type extends the CustomFieldRef abstract type.

Field Name XML Schema Type Req Notes

value xsd:double Y

internalId xsd:string (attribute) Y References a unique instance of a custom field type.

BooleanCustomFieldRef
The BooleanCustomFieldRef type extends the CustomFieldRef abstract type.

Field Name XML Schema Type Req Notes

value xsd:boolean Y

internalId xsd:string (attribute) Y References a unique instance of a custom field type.

StringCustomFieldRef
The StringCustomFieldRef type extends the CustomFieldRef abstract type.

Field Name XML Schema Type Req Notes

value xsd:string Y

internalId xsd:string (attribute) Y References a unique instance of a custom field type.

DateCustomFieldRef
The DateCustomFieldRef type extends the CustomFieldRef abstract type.

Field Name XML Schema Type Req Notes

value xsd:datetime Y

SuiteTalk SOAP Web Services Platform Guide

Custom Field Types 139

Field Name XML Schema Type Req Notes

internalId xsd:string (attribute) Y References a unique instance of a custom field type.

SelectCustomFieldRef
The SelectCustomFieldRef type extends the CustomFieldRef abstract type. This references a single
ListOrRecordRef and also requires an InternalId attribute to indicate the field name.

Field Name XML Schema Type Req Notes

value ListorRecordRef Y A single ListOrRecordRef.

internalId xsd:string (attribute) Y References a unique instance of a custom field type.

MultiSelectCustomFieldRef
The MultiSelectCustomFieldRef type extends the CustomFieldRef abstract type. This references an array of
ListOrRecordRef's and also requires an internalId attribute to indicate the field name.

Field Name XML Schema Type Req Notes

value ListorRecordRef[] Y An array of type RecordRef

internalId xsd:string (attribute) Y References a unique instance of a custom field type.

CustomFieldList

Field Name XML Schema Type Req Notes

value customFieldRef [] Y An array of type customFieldRef. The actual entries in the array
will be of a concrete type that extends customFieldRef.

The following is an XML excerpt from a SOAP body that illustrates a custom field list that contains all the
available custom field types.

SOAP Sample
<listRel:customFieldList xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com">
<platformCore:customField internalId="526" scriptId="custentity_exchange_rate" xsi:type="platformCore:DoubleCustomFieldRef">
<platformCore:value>2.35</platformCore:value>
</platformCore:customField>
<platformCore:customField internalId="524" scriptId="custentity_soft_skills" xsi:type="platformCore:MultiSelectCustomFieldRef">
<platformCore:value internalId="1">
<platformCore:name>Communication</platformCore:name>
</platformCore:value>
<platformCore:value internalId="5">
<platformCore:name>Teamwork</platformCore:name>
</platformCore:value>
</platformCore:customField>
<platformCore:customField internalId="146" scriptId="custentity_checkbox" xsi:type="platformCore:BooleanCustomFieldRef">

SuiteTalk SOAP Web Services Platform Guide

Custom Field Types 140

<platformCore:value>false</platformCore:value>
</platformCore:customField>
<platformCore:customField internalId="525" scriptId="custentity_first_contact" xsi:type="platformCore:DateCustomFieldRef">
<platformCore:value>2017-03-16T00:00:00.000-07:00</platformCore:value>
</platformCore:customField>
<platformCore:customField internalId="324" scriptId="custentity_proficiency_level" xsi:type="platformCore:SelectCustomFieldRef">
<platformCore:value internalId="2">
<platformCore:name>Medium</platformCore:name>
</platformCore:value>
</platformCore:customField>
<platformCore:customField internalId="72" scriptId="custentity_franchiseeabn_on_customerrec" xsi:type="platformCore:StringCustom
FieldRef">
<platformCore:value>{partner.vatregnumber}</platformCore:value>
</platformCore:customField>
<platformCore:customField internalId="424" scriptId="custentity_test_score" xsi:type="platformCore:LongCustomFieldRef">
<platformCore:value>25</platformCore:value>
</platformCore:customField>
</listRel:customFieldList>

Search Types
Every NetSuite record that supports search has corresponding search and advanced search objects. For
example, the SOAP listRel XSD contains a Customer object, as well as its corresponding CustomerSearch,
CustomerSearchAdvanced, and CustomerSearchRow search objects.

■ When using a < Record > Search object, all search fields within this search object belong to one of the
types decribed in Search XML Schema Types.
■ When searching on custom records or custom fields, all search fields belong to one of the types
described in Search Custom Field XML Schema Types.
■ When using either the < Record > SearchAdvanced or < Record > SearchRow search objects, all
search fields within these “advanced search” objects belong to one of the types described in Search
Column Custom XML Schema Types or Search Column Custom XML Schema Types.

Search XML Schema Types

The following sections define available search types. Every search field within a search object type belongs
to one of these search types.

SearchPreferences

Field Name XML Schema Type Req

bodyFieldsOnly boolean Y/N

pageSize int Y/N

returnSearchColumns boolean Y/N

SearchRequest

Field Name XML Schema Type Req Notes

preferences boolean Y

SuiteTalk SOAP Web Services Platform Guide

Search Types 141

Field Name XML Schema Type Req Notes

searchRecord SearchRecord Y

SearchResult

Field Name XML Schema Type Req Notes

totalRecords int N

pageSize int N

totalPages int N

pageIndex int N

searchId string N

status

recordList platformCore:RecordList

searchRowList platformCore:SearchRowList

SearchStringField

Field Name XML Schema Type Req Notes

operator platformCoreTyp: Y Reference to a value in a system list. For more

SearchStringFieldOperator information on available values, see Platform
(attribute) Enumerations.

searchValue xsd:string Y

SearchBooleanField

Field Name XML Schema Type Req Notes

operator xsd:boolean Y The available values are true or false.

SearchDoubleField

Field Name XML Schema Type Req Notes

operator platformCoreTyp: SearchDoubleField Y Reference to a value in a system list. For more

Operator(attribute) information on available values, see Platform
Enumerations.

searchValue xsd:double Y

searchValue2 xsd:double N If the operator is between or notBetween

searchValue2 must be populated.

SuiteTalk SOAP Web Services Platform Guide

Search Types 142

SearchLongField
Field Name XML Schema Type Req Notes

operator platformCoreTyp: Y Reference to a value in a system list. For more

SearchLongFieldOperator(attribute) information on available values, see Platform
Enumerations.

searchValue xsd:long Y

searchValue2 xsd:long N If the operator is between or notBetween

searchValue2 must be populated.

SearchTextNumberField
Field Name XML Schema Type Req Notes

operator platformCoreTyp: Y Reference to a value in a system list. For more

SearchTextNumberFieldOperator information on available values, see Platform
(attribute) Enumerations.

searchValue xsd:string Y

searchValue2 xsd:string N If the operator is between or notBetween

searchValue2 must be populated.

SearchDateField
Field Name XML Schema Type Req Notes

operator platformCoreTyp: SearchDate Y Reference to a value in a system list. For more

(attribute) information on available values, see Platform
Enumerations.

predefinedSearchValue plateformCoreTyp: N Reference to a value in a system list. For more

SearchDate information on available values, see Platform
Enumerations.

searchValue xsd:dateTime N Either predefinedSearchValue or searchValue

should be populated.

searchValue2 xsd: dateTime N If the operator is between or notBetween

searchValue2 must be populated.

SearchMultiSelectField
This search type is used to specify a list of one or more internal IDs that reference other user defined
records in the system.

Note: Note that the maximum number of values that can be specified in a MultiSelectField is
1000.

Field Name XML Schema Type Req Notes

operator platformCoreTyp: Y Reference to a value in a system list. For more

SearchMultiSelectFieldOperator information on available values, see Platform
(attribute) Enumerations.

SuiteTalk SOAP Web Services Platform Guide

Search Types 143

Field Name XML Schema Type Req Notes

searchValue platformCore: RecordRef Y An array of type SearchMultiSelectRefValue.

SearchEnumMultiSelectField
This search type is used to specify a list of one or more system defined constants.

Field Name XML Schema Type Req Notes

operator platformCoreTyp: Y Reference to a value in a system list. For more

SearchEnumMultiSelectFieldOperator information on available values, see Platform
(attribute) Enumerations.

searchValue xsd:string Y

Search Custom Field XML Schema Types

The following sections define the available search types for custom fields. Every search field within a
search object type belongs to one of these search types.

SearchCustomField
This is an abstract type.

Field Name XML Schema Type Req Notes

id xsd:string (attribute) Y References a unique instance of a custom field

SearchStringCustomField
The SearchStringCustomField type extends the SearchCustomField abstract type.

Field Name XML Schema Type Req Notes

internalId xsd:string (attribute) Y Inherited from the SearchCustomField. Reference a

unique instance of a custom field.

operator platformCoreTyp: Y The type is an enumeration type that restricts the

SearchStringFieldOperator value to a predefined list. For more information on
(attribute) available values, see Platform Enumerations.

searchValue xsd:string Y

SearchBooleanCustomField
The SearchBooleanCustomField type extends the SearchCustomField abstract type.

Field Name XML Schema Type Req Notes

internalId xsd:string (attribute) Y Inherited from the SearchCustomField. Reference a unique

instance of a custom field.

SuiteTalk SOAP Web Services Platform Guide

Search Types 144

Field Name XML Schema Type Req Notes

searchValue xsd: boolean Y The type is an enumeration type that restricts the value to true or
false.

SearchLongCustomField
The SearchLongCustomField type extends the SearchCustomField abstract type.

Field Name XML Schema Type Req Notes

internalId xsd:string (attribute) Y Inherited from the SearchCustomField. Reference a

unique instance of a custom field.

operator platformCoreTyp: Y The type is an enumeration type that restricts the

SearchLongFieldOperator value to a predefined list. For more information on
(attribute) available values, see Platform Enumerations.

searchValue xsd:long Y

searchValue2 xsd:long N

SearchDoubleCustomField
The SearchDoubleCustomField type extends the SearchCustomField abstract type.

Field Name XML Schema Type Req Notes

internalId xsd:string (attribute) Y Inherited from the SearchCustomField. Reference a

unique instance of a custom field.

operator platformCoreTyp: Y The type is an enumeration type that restricts the

SearchDoubleFieldOperator value to a predefined list. For more information on
(attribute) available values, see Platform Enumerations.

searchValue xsd:double Y

searchValue2 xsd:double N

SearchDateCustomField
The SearchDateCustomField type extends the SearchCustomField abstract type.

Field Name XML Schema Type Req Notes

internalId xsd:string (attribute) Y Inherited from the SearchCustomField.

Reference a unique instance of a custom field.

operator platformCoreTyp: Y The type is an enumeration type that restricts

SearchDateFieldOperator the value to a predefined list. For more
(attribute) information on available values, see Platform
Enumerations.

predefinedSearchValue platformCoreTyp: SearchDate

searchValue xsd:dateTime Y

SuiteTalk SOAP Web Services Platform Guide

Search Types 145

Field Name XML Schema Type Req Notes

searchValue2 xsd:dateTime Y

SearchMultiSelectCustomField
The SearchMultiSelectCustomField type extends the SearchCustomField abstract type.

Field Name XML Schema Type Req Notes

internalId xsd:string (attribute) Y Inherited from the SearchCustomField. Reference a

unique instance of a custom field.

operator platformCoreTyp: Y The type is an enumeration type that restricts the

SearchMultiSelectFieldOperator value to a predefined list. For more information on
(attribute) available values, see Platform Enumerations.

searchValue ListOrRecordRef Y

SearchEnumMultiSelectCustomField
The SearchEnumMultiSelectCustomField type extends the SearchCustomField abstract type.

Field Name XML Schema Type Req Notes

internalId xsd:string (attribute) Y Inherited from the SearchCustomField. Reference a

unique instance of a custom field.

operator platformCoreTyp: SearchEnumMulti Y The type is an enumeration type that restricts the
SelectFieldOperator (attribute) value to a predefined list. For more information on
available values, see Platform Enumerations.

searchValue xsd:string Y

SearchCustomFieldList

Field Name XML Schema Type Req Notes

customField platformCore: SearchCustomField [] Y

Search Column XML Schema Types

The following search types support advanced search functionality in SOAP web services.

SearchColumnField
This is an abstract type.

Field Name XML Schema Type Req Notes

customLabel xsd:string

SuiteTalk SOAP Web Services Platform Guide

Search Types 146

SearchColumnBooleanField
The SearchColumnBooleanField type extends the SearchColumnField abstract type.

Field Name XML Schema Type Req Notes

searchValue xsd:boolean Y

SearchColumnStringField
The SearchColumnStringField type extends the SearchColumnField abstract type.

Field Name XML Schema Type Req Notes

searchValue xsd:string Y

SearchColumnLongField
The SearchColumnLongField type extends the SearchColumnField abstract type.

Field Name XML Schema Type Req Notes

searchValue xsd:long Y

SearchColumnTextNumberField
The SearchColumnStringField type extends the SearchColumnField abstract type.

Field Name XML Schema Type Req Notes

searchValue xsd:string Y

SearchColumnDoubleField
The SearchColumnDoubleField type extends the SearchColumnField abstract type.

Field Name XML Schema Type Req Notes

searchValue xsd:double Y

SearchColumnDateField
The SearchColumnDateField type extends the SearchColumnField abstract type.

Field Name XML Schema Type Req Notes

searchValue xsd:dateTime Y

SuiteTalk SOAP Web Services Platform Guide

Search Types 147

SearchColumnEnumSelectField
The SearchColumnEnumSelectField type extends the SearchColumnField abstract type.

Field Name XML Schema Type Req Notes

searchValue xsd:string Y

SearchColumnSelectField
The SearchColumnSelectField type extends the SearchColumnField abstract type. This references a single
ListOrRecordRef and also requires an internalId attribute to indicate the field name.

Field Name XML Schema Type Req Notes

searchValue RecordRef Y

Search Column Custom XML Schema Types

The following search types support advanced search functionality in SOAP web services.

SearchColumnCustomField
This is an abstract type.

Field Name XML Schema Type Req Notes

customLabel xsd:string

SearchColumnBooleanCustomField
The SearchColumnBooleanField type extends the SearchColumnCustomField abstract type.

Field Name XML Schema Type Req Notes

searchValue xsd:boolean Y

internalId xsd:string (attribute) Y

SearchColumnStringCustomField
The SearchColumnStringCustomField type extends the SearchColumnCustomField abstract type.

Field Name XML Schema Type Req Notes

searchValue xsd:string Y

internalId xsd:string (attribute) Y

SuiteTalk SOAP Web Services Platform Guide

Search Types 148

SearchColumnLongCustomField
The SearchColumnLongCustomField type extends the SearchColumnCustomField abstract type.

Field Name XML Schema Type Req Notes

searchValue xsd:long Y

internalId xsd:string (attribute) Y

SearchColumnDoubleCustomField
The SearchColumnDoubleCustomField type extends the SearchColumnCustomField abstract type.

Field Name XML Schema Type Req Notes

searchValue xsd:double Y

internalId xsd:string (attribute) Y

SearchColumnDateCustomField
The SearchColumnDateCustomField type extends the SearchColumnCustomField abstract type.

Field Name XML Schema Type Req Notes

searchValue xsd:dateTime Y

internalId xsd:string (attribute) Y

SearchColumnEnumMultiSelectCustomField
The SearchColumnEnumMultiSelectCustomField type extends the SearchColumnCustomField abstract
type.

Field Name XML Schema Type Req Notes

searchValue xsd:string Y

internalId xsd:string (attribute) Y

SearchColumnSelectCustomField
The SearchColumnSelectCustomField type extends the SearchColumnCustomField abstract type. This
references a single ListOrRecordRef and also requires an internalId attribute to indicate the field name.

Field Name XML Schema Type Req Notes

searchValue ListOrRecordRef Y A single ListOrRecordRef

SuiteTalk SOAP Web Services Platform Guide

Search Types 149

Field Name XML Schema Type Req Notes

internalId xsd:string (attribute) Y

SearchColumnMultiSelectCustomField
The SearchColumnMultiSelectCustomField type extends the SearchColumnCustomField abstract type.
This references an array of ListOrRecordRefs.

Field Name XML Schema Type Req Notes

searchValue ListOrRecordRef[] Y

internalId xsd:string (attribute) Y

SearchColumnCustomFieldList
The SearchColumnCustomFieldList type extends the SearchColumnCustomField abstract type.

Field Name XML Schema Type Req Notes

customField SearchColumnCustomField

Sample Code
SOAP Request — Opportunity Search
Following is an example that contains an excerpt of the SOAP body that illustrates an opportunity search
containing several search field types.

<opportunitySearch>
<projectedTotal operator="lessThan">
<searchValue>100000</searchValue>
</projectedTotal>
<title operator="contains">
<searchValue>Enterprise</searchValue>
</title>
<createdDateRange operator="between">
<fromValue>2003-10-02</fromValue>
<toValue>2003-10-12</toValue>
</createdDateRange>
<opportunityStatusList operator="anyOf">
<searchValue>inProgress</searchValue>
<searchValue>closedWon</searchValue>
</opportunityStatusList>
<customFieldList>
<customField xsi:type="SearchSelectCustomField" internalId="35" scriptId="cust_SalesEngineer" operator="equals">
<searchValue>Buddy Williams</searchValue>
</customField>
<customField xsi:type="SearchBooleanCustomField" internalId="165" scriptId="cust_hasSalesEngineer" operator="true"/>
<customField xsi:type="SearchStringCustomField" internalId="322" scriptId="cust_DemoNotes" operator="startsWith">
<searchValue>CRM</searchValue>
</customField>
<customField xsi:type="SearchMultiSelectCustomField" internalId="155" scriptId="cust_ProductAreas" operator="noneOf">
<searchValue>Inventory</searchValue>
<searchValue>Warehousing</searchValue>
</customField><
</customFieldList>
</opportunitySearch>

SuiteTalk SOAP Web Services Platform Guide

Platform Enumerations 150

Platform Enumerations
The following search types are used throughout SOAP web services to populate system defined lists. The
tables below outline the available values that should be used to populate these fields in your SOAP web
services requests. These enumerations are defined in the platformCoreTyp XSD.

Search Types (Table 1)

Enumerations SearchString SearchLongField SearchDoubleField SearchPeriod SearchTime

FieldOperator Operator Operator Field FieldOperator

is X

isNot X

startsWith X

doesNotStartWith X

contains X

doesNotContain X

equalTo X X X

lessThan X X

greaterThan X X

lessThanOrEqualTo X X

greaterThanOrEqualTo X X

notEqualTo X X

notLessThan X X

notGreaterThan X X

notLessThanOrEqualTo X X

notGreaterThanOrEqualTo X X

between X X X

notBetween X X

empty X X

notEmpty X X

Search Types (Table 2)

Enumerations SearchDate SearchEnum SearchMulti SearchDate

FieldOperator MultiSelect SelectField
FieldOperator Operator

anyOf X X

noneOf X X

on X

before X

after X

onOrBefore X

onOrAfter X

within X

empty X

SuiteTalk SOAP Web Services Platform Guide

Platform Enumerations 151

Search Types (Table 2)

Enumerations SearchDate SearchEnum SearchMulti SearchDate

FieldOperator MultiSelect SelectField
FieldOperator Operator

notOn X

notBefore X

notAfter X

notOnOrBefore X

notOnOrAfter X

notWithin X

notEmpty X

fiscalHalfBeforeLast X

fiscalHalfBeforeLastToDate X

fiscalQuarterBeforeLast X

fiscalQuarterBeforeLastToDate X

fiscalYearBeforeLast X

fiscalYearBeforeLastToDate X

fiveDaysAgo X

fiveDaysFromNow X

fourDaysAgo X

fourDaysFromNow X

fourWeeksStartingThisWeek X

lastBusinessWeek X

lastFiscalHalf X

lastFiscalHalfOneFiscalYearAgo X

lastFiscalHalfToDate X

lastFiscalQuarter X

lastFiscalQuarterOneFiscalYearAgo X

lastFiscalQuarterToDate X

lastFiscalQuarterTwoFiscalYearsAgo X

lastFiscalYear X

lastFiscalYearToDate X

lastMonth X

lastMonthOneFiscalQuarterAgo X

lastMonthOneFiscalYearAgo X

lastMonthToDate X

lastMonthTwoFiscalQuartersAgo X

lastMonthTwoFiscalYearsAgo X

lastRollingHalf X

lastRollingQuarter X

lastRollingYear X

SuiteTalk SOAP Web Services Platform Guide

Platform Enumerations 152

Search Types (Table 2)

Enumerations SearchDate SearchEnum SearchMulti SearchDate

FieldOperator MultiSelect SelectField
FieldOperator Operator

lastWeek X

lastWeekToDate X

monthAfterNext X

monthAfterNextToDate X

monthBeforeLast X

monthBeforeLastToDate X

nextBusinessWeek X

nextFiscalHalf X

nextFiscalQuarter X

nextFiscalYear X

nextFourWeeks X

nextMonth X

nextOneHalf X

nextOneMonth X

nextOneQuarter X

nextOneWeek X

nextOneYear X

nextWeek X

ninetyDaysAgo X

ninetyDaysFromNow X

oneYearBeforeLast X

previousFiscalQuartersLastFiscalYear X

previousFiscalQuartersThisFiscalYear X

previousMonthsLastFiscalHalf X

previousMonthsLastFiscalQuarter X

previousMonthsLastFiscalYear X

previousMonthsSameFiscalHalfLastFiscalYear X

previousMonthsSameFiscalQuarterLastFiscal X
Year

previousMonthsThisFiscalHalf X

previousMonthsThisFiscalQuarter X

previousMonthsThisFiscalYear X

previousOneDay X

previousOneHalf X

previousOneMonth X

previousOneQuarter X

previousOneWeek X

previousOneYear X

SuiteTalk SOAP Web Services Platform Guide

Platform Enumerations 153

Search Types (Table 2)

Enumerations SearchDate SearchEnum SearchMulti SearchDate

FieldOperator MultiSelect SelectField
FieldOperator Operator

previousRollingHalf X

previousRollingQuarter X

previousRollingYear X

sameDayFiscalQuarterBeforeLast X

sameDayFiscalYearBeforeLast X

sameDayLastFiscalQuarter X

sameDayLastFiscalYear X

sameDayLastMonth X

sameDayLastWeek X

sameDayMonthBeforeLast X

sameDayWeekBeforeLast X

sameFiscalHalfLastFiscalYear X

sameFiscalHalfLastFiscalYearToDate X

sameFiscalQuarterFiscalYearBeforeLast X

sameFiscalQuarterLastFiscalYear X

sameFiscalQuarterLastFiscalYearToDate X

sameMonthFiscalQuarterBeforeLast X

sameMonthFiscalYearBeforeLast X

sameMonthLastFiscalQuarter X

sameMonthLastFiscalQuarterToDate X

sameMonthLastFiscalYear X

sameMonthLastFiscalYearToDate X

sameWeekFiscalYearBeforeLast X

sameWeekLastFiscalYear X

sixtyDaysAgo X

sixtyDaysFromNow X

startOfFiscalHalfBeforeLast X

startOfFiscalQuarterBeforeLast X

startOfFiscalYearBeforeLast X

startOfLastBusinessWeek X

startOfLastFiscalHalf X

startOfLastFiscalHalfOneFiscalYearAgo X

startOfLastFiscalQuarter X

startOfLastFiscalQuarterOneFiscalYearAgo X

startOfLastFiscalYear X

startOfLastMonth X

startOfLastMonthOneFiscalQuarterAgo X

SuiteTalk SOAP Web Services Platform Guide

Platform Enumerations 154

Search Types (Table 2)

Enumerations SearchDate SearchEnum SearchMulti SearchDate

FieldOperator MultiSelect SelectField
FieldOperator Operator

startOfLastMonthOneFiscalYearAgo X

startOfLastRollingHalf X

startOfLastRollingQuarter X

startOfLastRollingYear X

startOfLastWeek X

startOfMonthBeforeLast X

startOfNextBusinessWeek X

startOfNextFiscalHalf X

startOfNextFiscalQuarter X

startOfNextFiscalYear X

startOfNextMonth X

startOfNextWeek X

startOfPreviousRollingHalf X

startOfPreviousRollingQuarter X

startOfPreviousRollingYear X

startOfSameFiscalHalfLastFiscalYear X

startOfSameFiscalQuarterLastFiscalYear X

startOfSameMonthLastFiscalQuarter X

startOfSameMonthLastFiscalYear X

startOfThisBusinessWeek X

startOfThisFiscalHalf X

startOfThisFiscalQuarter X

startOfThisFiscalYear X

startOfThisMonth X

startOfThisWeek X

startOfThisYear X

startOfWeekBeforeLast X

tenDaysAgo X

tenDaysFromNow X

thirtyDaysAgo X

thirtyDaysFromNow X

thisBusinessWeek X

thisFiscalHalf X

thisFiscalHalfToDate X

thisFiscalQuarter X

thisFiscalQuarterToDate X

thisFiscalYear X

SuiteTalk SOAP Web Services Platform Guide

Platform Enumerations 155

Search Types (Table 2)

Enumerations SearchDate SearchEnum SearchMulti SearchDate

FieldOperator MultiSelect SelectField
FieldOperator Operator

thisFiscalYearToDate X

thisMonth X

thisMonthToDate X

thisRollingHalf X

thisRollingQuarter X

thisRollingYear X

thisWeek X

thisWeekToDate X

thisYear X

threeDaysAgo X

threeDaysFromNow X

threeFiscalQuartersAgo X

threeFiscalQuartersAgoToDate X

threeFiscalYearsAgo X

threeFiscalYearsAgoToDate X

threeMonthsAgo X

threeMonthsAgoToDate X

today X

tomorrow X

twoDaysAgo X

twoDaysFromNow X

weekAfterNext X

weekAfterNextToDate X

weekBeforeLast X

weekBeforeLastToDate X

yesterday X

Important: The onOrAfter, onOrBefore, notOnOrAfter and notOnOrBefore operators only

consider the date you specify in your request, and ignore the time you specify. If you need to
specify not only the date but also the time in your search, use the after or before operators. Note,
however, when you use these operators, the exact time specified in your request is not part of the
result set.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Operations 156

SOAP Web Services Operations

SOAP web services exposes NetSuite as a data source for programmatic access, hence most of the data
operations developers expect, such as insert, update, delete, and select/search are supported. There are
also a number of operations that are available as supporting operations for data read/write operations
(for example: initialize and getSelectValue), or for providing metadata (for example: getCustomizationId),
or for exposing an application function to programmatic access (for example: attach, detach).

Note: If an operation you are looking for doesn’t appear in the list of operations below, look at
the Support for Existing WSDL Versions for your version of the WSDL.

See these sections for complete details on all SOAP web services operations:

■ SOAP Web Services Standard Operations

■ SOAP Web Services List Operations
■ SOAP Web Services Asynchronous Operations

Important: NetSuite hosts customer accounts in multiple data centers. For that reason, the
correct URL for SOAP web services access varies depending on the data center hosting the
account.

For details about dynamic discovery of URLs, see the help topic Dynamic Discovery of URLs for
SOAP Web Services and RESTlet Clients.

SOAP Web Services Standard Operations

The following operations are supported in SOAP web services. They are organized in alphabetical order:

Operation / API Summary

add / addList Use to add one or more records into the system. The system returns a
NetSuite identifier (internalId) that is unique for each record created within a
record type.

attach / detach Use to attach or detach another record or file to/from another record.

changeEmail Use to change the email address for the account.

changePassword Use to change the password for the account.

checkAsyncStatus Use to check the status of an asynchronous SOAP web services submission.

delete / deleteList Use to delete one or more records in the system. The records to be deleted
are identified by either the internal or external ID and the record type.

get / getList Use to query the system for one or more records. You must provide either
the internal or external ID and the record type for each query item.

getAccountGovernanceInfo Use to retrieve the account concurrency limit and the unallocated
concurrency limit.

getAll Use to return a list of records that do not have a search interface.

getAsyncResult Use to retrieve the results of an asynchronous SOAP web services

submission.

getBudgetExchangeRate Use to get and filter all data related to the Budget Exchange Rates table.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Standard Operations 157

Operation / API Summary

getConsolidatedExchangeRate Use to get and filter all data related to the Consolidated Exchange Rates
table.

Important: The exposure of the consolidated exchange rate

record prompted the removal of the getConsolidatedExchangeRate
operation from the 2017.1 endpoint. You can still use the
getConsolidatedExchangeRate operation on earlier endpoints. For
more information about working with consolidated exchange rates
on endpoints starting from 2017.1, see the help topic Consolidated
Exchange Rate.

getCurrencyRate Use to get currency exchange rates from the Currency Exchange Rate table.

getCustomizationId Use to retrieve the internalIds, externalIds, and/or scriptIds of all custom
objects of a specified type.

getDataCenterUrls Use for dynamic discovery of the correct URL for SOAP web services
requests.

Important: All SOAP web services integrations must include

logic to dynamically discover the correct URL.

Important: As of the 2019.1 SOAP web services endpoint, you

must use account-specific domains with SOAP web services. You can
use the SOAP getDataCenterUrls operation to obtain the correct
domain. Or, go to Setup > Company > Setup Tasks >Company
Information in the NetSuite UI. Your domains are listed on the
Company URLs subtab.

getDeleted Use to retrieve a list of deleted records of a particular type during a specified
period.

getIntegrationGovernanceInfo Use to retrieve the concurrency limit for the specific integration and the
limitType. With this information the integration can identify how many
concurrent requests it can send.

getItemAvailability Use to retrieve the inventory availability for a specific list of items.

getPostingTransactionSummary Use to retrieve a summary of the actual data in an account.

getSavedSearch Use to retrieve a list of existing saved searches for each record type. Specify
the search record type to get a list of record references of the saved search.

getSelectValue Use to retrieve valid values for a particular recordRef field where the
referenced record type is not yet exposed in the SOAP web services API or
when the logged in role does not have permission to the instances of the
record type.

getServerTime Use to get server time, resulting in more accurate and reliable sync'ing of
data than using using local client time. The client will use the time from
server to determine if the record has changed since the last synchronization.

initialize / initializeList Use to emulate the UI workflow by pre-populating fields on transaction line
items with values from a related record. The initializeList operation can be
used to run batch processes to retrieve initialized records.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Standard Operations 158

Operation / API Summary

mapSso
Warning: As of the NetSuite 2021.1 release, the mapSso
operation is no longer available. This affects all endpoints, and even
though the SOAP schema remains for older endpoints, the method
is not working. For SOAP web services you must use token-based
authentication instead. For more information, see the help topic
Token-based Authentication (TBA).

search Use to search for a set of records based on specific search criteria. This
operation supports pagination, so that large result sets can be retrieved in
smaller sets. For more information on how to control pagination, refer to
SOAP Web Services Preferences.

searchMoreWithId Use to retrieve search results for users who send requests to NetSuite by
providing request-level credentials, rather than by invoking login.

ssoLogin
Warning: As of the NetSuite 2021.1 release, the ssoLogin
operation is no longer available. This affects all endpoints, and even
though the SOAP schema remains for older endpoints, the method
is not working. For SOAP web services you must use token-based
authentication instead. For more information, see the help topic
Token-based Authentication (TBA).

update / updateList Use to update one or more existing records in the system by providing
new values for the fields to be updated for each record. The records to be
updated are identified by either the internal or external ID and the record
type.

updateInviteeStatus / Allows event invitees to accept or decline NetSuite events. After invitees have
updateInviteeStatusList responded to the event, the Event record is updated with their response.

upsert / upsertList Use to add new records and update existing records in a single operation.
Records are identified by external ID and record type. If a record of the
specified type with a matching external ID exists in the system, it is updated.
If it does not exist, a new record is created.

SOAP Web Services List Operations

Within a single SOAP request, only one operation can be performed. For example, one add, one addList
or one delete. However, a single list operation (addList, updateList, upsertList, deleteList, getList, and
initializeList) lets you work with multiple record types. For example, with a single addList operation you
can add 3 customers, 4 opportunities, and 1 contact.

Note that list operations process records in the order in which the records are submitted. For example, an
addList operation will add all records in the order they appear in the list.

SOAP Web Services Asynchronous Operations

The following asynchronous equivalents are available for these list operations:

■ addList: asyncAddList
■ updateList: asyncUpdateList
■ upsertList: asyncUpsertList

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Asynchronous Operations 159

■ deleteList: asyncDeleteList
■ getList: asyncGetList
■ search: asyncSearch
■ initialize / initializeList: asyncInitializeList

You can use the checkAsyncStatus and getAsyncResult operations to track asynchronous requests.
For information on asynchronous request processing, see Asynchronous Request Processing and
Synchronous Versus Asynchronous Request Processing.

add
The add operation is used to add a new instance of a record in NetSuite. It is similar to the addList
operation except that it allows only one record to be added at a time. Note that to prevent duplicate
records, NetSuite recommends using the alternate upsert and upsertList operations along with external
IDs to add records to NetSuite.

Note: Although records of a particular type may be used in multiple integration scenarios, each
record instance can only have a single external ID value. To maintain data integrity, only a single
integrated application can set and update external ID values for each record type. External ID
values for all records of each type must all come from the same external application.

Request
The AddRequest type is used for the request. It contains the following fields.

Element Name XSD Type Notes

record Record The record type is an abstract type so an instance of a type that extends record
must be used — such as Customer or Event.

Response
The AddResponse type is used for the response. It contains the following fields.

Element Name XSD Type Notes

response WriteResponse Contains details on the status of the operation and a reference to the
created record.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

SuiteTalk SOAP Web Services Platform Guide

add 160

Sample Code
SOAP Request
In this example, a single customer record is added.

Note: For information about adding custom fields to records, see the code sample in Entity
Custom Field.

<soap:Body>
<platformMsgs:add>
<platformMsgs:record xsi:type="listRel:Customer">
<listRel:companyName>Shutter Fly, Inc</listRel:companyName>
<listRel:unsubscribe>false</listRel:unsubscribe>
</platformMsgs:record>
</platformMsgs:add>
</soap:Body>

SOAP Response
In the response, notice that the internal ID for the record added is returned.

<soapenv:Body>
<addResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<writeResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<ns1:status isSuccess="true" xmlns:ns1="urn:core_2017_1.platform.webservices.netsuite.com"/>
<baseRef internalId="979" type="customer" xsi:type="ns2:RecordRef" xmlns:xsi="http://www.w3.org/2001/XMLSchema-
instance" xmlns:ns2="urn:core_2017_1.platform.webservices.netsuite.com"/>
</writeResponse>
</addResponse>
</soapenv:Body>

C#
private void addCustomer()
{
// This operation requires a valid session
this.login( true );

Customer customer = new Customer();

// Set entityId, company name, and email

if ( "true".Equals( _dataCollection["promptForFieldValues"] ) )
{
_out.writeLn(
"\nPlease enter the following customer information. " +
"Note that some fields have already been populated. " );
_out.write( "Entity name: " );
customer.entityId = _out.readLn();
_out.write( "Company name: " );
customer.companyName = _out.readLn();
_out.write( "E-mail: " );
customer.email = _out.readLn();
_out.write( "Sales Rep key: " );
RecordRef salesRep = new RecordRef();
salesRep.internalId = _out.readLn();
//salesRep.type = RecordType.contact;
//salesRep.typeSpecified = true;
customer.salesRep = salesRep;
}
else
{
customer.entityId = "XYZ Inc";
customer.companyName = "XYZ, Inc.";

SuiteTalk SOAP Web Services Platform Guide

add 161

customer.email = "[email protected]";
}

// Set email preference

customer.emailPreference = CustomerEmailPreference._hTML;
customer.emailPreferenceSpecified = true;

// Set entity status. The nsKey can be obtained from Setup > SFA > Customer Statuses.
// The default status is "Closed Won" which has an nsKey of 13
RecordRef status = new RecordRef();
if ( "true".Equals( _dataCollection["promptForFieldValues"] ) )
{
_out.write( "Entity status nsKey (press enter for default value of Closed Won): " );
String statusKey = _out.readLn();
if ( statusKey.Equals( "" ) )
{
status.internalId = "13";
}
else
{
status.internalId = statusKey;
}
}
else
{
status.internalId = "13";
}

customer.entityStatus = status;

// Populate the address list for this customer. You can put in as many
// adresses as you like.
CustomerAddressbook address = new CustomerAddressbook();
address.defaultShipping = true;
address.defaultShippingSpecified = true;
address.defaultBilling = false;
address.defaultBillingSpecified = true;
address.label = "Shipping Address";
address.addressee = "William Sanders";
address.attention = "William Sanders";
address.addr1 = "4765 Sunset Blvd";
address.city = "San Francisco";
address.state = "CA";
address.zip = "94131";
address.country = Country._unitedStates;

// Attach the CustomerAddressbookList to the customer

CustomerAddressbookList addressList = new CustomerAddressbookList();
CustomerAddressbook[] addresses = new CustomerAddressbook[1];
addresses[0] = address;
addressList.addressbook = addresses;
customer.addressbookList = addressList;

// Invoke add() operation

WriteResponse response = _service.add( customer );

// Print the document id from the SOAP header

//_out.info(
//"\nThe add() operation with document id " + _service.documentInfo.nsID + " was processed " );

// Process the response

if ( response.status.isSuccess )
{
_out.info(
"\nThe following customer was added successfully:" +
"\nkey=" + ((RecordRef) response.baseRef).internalId +
"\nentityId=" + customer.entityId +
"\ncompanyName=" + customer.companyName +
"\nemail=" + customer.email +
"\nstatusKey=" + customer.entityStatus.internalId +
"\naddressbookList[0].label=" + customer.addressbookList.addressbook[0].label );

// Create a second customer that's a sub-customer of the first customer

SuiteTalk SOAP Web Services Platform Guide

add 162

/*
Customer subCustomer = new Customer();

subCustomer.entityId = "XYZ Japan";

// Set the parent customer

recordRef = new RecordRef();
recordRef.internalId = ((RecordRef) response.baseRef).internalId;
//recordRef.internalId = "125";
subCustomer.parent = recordRef;

// Invoke add() operation

response = _service.add( subCustomer );

// Process the response

//"\nThe add() operation with job id " + _service.sessionInfo.jobID + " was processed " );
if ( !response.status.isSuccess )
{
_out.info( "\nThe customer was not added:" );
_out.error( getStatusDetails( response.status ) );
}
else
{
_out.info(
"\nThe following customer was added successfully:" +
"\nkey=" + ((RecordRef) response.baseRef).internalId +
"\nentityId=" + customer.entityId +
"\ncompanyName=" + customer.companyName);
}
*/
}
else
{
_out.error( "The customer was not added:", true );
_out.error( getStatusDetails( response.status ) );
}
}

Java
public void addCustomer() throws RemoteException, ExceededRecordCountFault,
ExceededUsageLimitFault, InsufficientPermissionFault, InvalidSessionFault {
// This operation requires a valid session
this.login(true);

Customer customer = new Customer();

// Set entityId, company name, and email

if ("true".equals(_properties.getProperty("promptForFieldValues"))) {
_console
.writeLn("\nPlease enter the following customer information. "
+ "Note that some fields have already been populated. ");
_console.write("Entity name: ");
customer.setEntityId(_console.readLn());
_console.write("Company name: ");
customer.setCompanyName(_console.readLn());
_console.write("E-mail: ");
customer.setEmail(_console.readLn());
} else {
customer.setEntityId("XYZ Inc");
customer.setCompanyName("XYZ, Inc.");
customer.setEmail("[email protected]");
}

// Set email preference.

customer.setEmailPreference(CustomerEmailPreference._hTML);

// Set entity status. The nsKey can be obtained from Setup > SFA >
// Customer Statuses.
// The default status is "Closed Won" which has an nsKey of 13
RecordRef status = new RecordRef();

SuiteTalk SOAP Web Services Platform Guide

add 163

if ("true".equals(_properties.getProperty("promptForFieldValues"))) {
_console.write("Entity status nsKey (press enter for default value of Closed Won): ");
String statusKey = _console.readLn();
if (statusKey.equals("")) {
status.setInternalId("13");
} else {
status.setInternalId(statusKey);
}
} else {
status.setInternalId("13");
}

customer.setEntityStatus(status);

// Populate the address list for this customer. You can put in as many
// adresses as you like.
CustomerAddressbook address = new CustomerAddressbook();
address.setDefaultShipping(Boolean.TRUE);
address.setDefaultBilling(Boolean.FALSE);
address.setLabel("Shipping Address");
address.setAddressee("William Sanders");
address.setAttention("William Sanders");
address.setAddr1("4765 Sunset Blvd");
address.setCity("San Francisco");
address.setState("CA");
address.setZip("94131");
address.setCountry(Country._unitedStates);

// Attach the CustomerAddressbookList to the customer

CustomerAddressbookList addressList = new CustomerAddressbookList();
CustomerAddressbook[] addresses = new CustomerAddressbook[1];
addresses[0] = address;
addressList.setAddressbook(addresses);
customer.setAddressbookList(addressList);

// Invoke add() operation

WriteResponse response = _port.add(customer);

// Print the document id from the SOAP header

// _console.info(
// "\nThe add() operation with document id " + _port.documentInfo.nsID +
// " was processed " );

// Process the response

if (response.getStatus().isIsSuccess()) {
_console.info("\nThe following customer was added successfully:"
+ "\nkey="
+ ((RecordRef) response.getBaseRef()).getInternalId()
+ "\nentityId="
+ customer.getEntityId()
+ "\ncompanyName="
+ customer.getCompanyName()
+ "\nemail="
+ customer.getEmail()
+ "\nstatusKey="
+ customer.getEntityStatus().getInternalId()
+ "\naddressbookList[0].label="
+ customer.getAddressbookList().getAddressbook(0)
.getLabel());
} else {
_console.error("The customer was not added:", true);
_console.error(getStatusDetails(response.getStatus()));
}
}

addList
The addList operation is used to add one or more new instances of a record to NetSuite. If there are
multiple records, they can either be of the same record type or different record types. For example, it's
possible to add a customer and a contact within a single request using this operation. However, each

SuiteTalk SOAP Web Services Platform Guide

addList 164

record entered must have a unique signature. Adding two records with the same signature results in a
SOAP fault. The signature consists of parameters required to identify a record as unique.
For example, in the case of entities, a record is uniquely identified by its name, its type and its parent
hierarchy. So you could have two records with the same entityId (or name) belonging to two different
record types as follows:

Customer (the type):

John Smith
MyCompany: John Smith

Contact
John Smith

But a second record such as the following would be invalid:

Contact
John Smith

Note: An asynchronous equivalent is available for this operation, asyncAddList. For information
about asynchronous request processing, see Synchronous Versus Asynchronous Request
Processing.

Note that to prevent duplicate records, NetSuite recommends using the alternate upsert and upsertList
operations when adding records to NetSuite.

Request
The AddListRequest type is used for the request.

Element Name XSD Type Notes

record[] Record Contains an array of record objects. The record type is an abstract type so an
instance of a type that extends record must be used—such as Customer or
Event.

Response
The AddListResponse type is used for the response.

Element Name XSD Type Notes

response[] WriteResponse Contains an array of WriteResponse objects, each of which contains details
on the status of that add operation and a reference to that created record.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault

SuiteTalk SOAP Web Services Platform Guide

addList 165

■ UnexpectedErrorFault

Sample Code

SOAP Request
In the following example, two customer records are added. When using the addList operation, you can
submit two different record types in the same request.

<soap:Body>
<platformMsgs:addList>
<platformMsgs:record xsi:type="listRel:Customer">
<listRel:entityId>Shutter Fly</listRel:entityId>
<listRel:companyName>Shutter Fly, Inc</listRel:companyName>
<listRel:unsubscribe>false</listRel:unsubscribe>
</platformMsgs:record>
<platformMsgs:record xsi:type="listRel:Customer">
<listRel:entityId>GNC</listRel:entityId>
<listRel:companyName>GNC Corp</listRel:companyName>
<listRel:unsubscribe>false</listRel:unsubscribe>
</platformMsgs:record>
</platformMsgs:addList>
</soap:Body>

SOAP Response
In the response, notice that the internal ID for each record added is returned.

<soapenv:Body>
<addListResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<writeResponseList xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<writeResponse>
<ns1:status isSuccess="true" xmlns:ns1="urn:core_2017_1.platform.webservices.netsuite.com"/>
<baseRef internalId="980" type="customer" xsi:type="ns2:RecordRef" xmlns:xsi="http://www.w3.org/2001/XMLSchema-
instance" xmlns:ns2="urn:core_2017_1.platform.webservices.netsuite.com"/>
</writeResponse>
<writeResponse>
<ns3:status isSuccess="true" xmlns:ns3="urn:core_2017_1.platform.webservices.netsuite.com"/>
<baseRef internalId="981" type="customer" xsi:type="ns4:RecordRef" xmlns:xsi="http://www.w3.org/2001/XMLSchema-
instance" xmlns:ns4="urn:core_2017_1.platform.webservices.netsuite.com"/>
</writeResponse>
</writeResponseList>
</addListResponse>
</soapenv:Body>

Java Sample
public void addListCustomer() throws RemoteException {
this.login(true);

Customer cust1 = new Customer();

cust1.setEntityId("Shutter Fly");
cust1.setCompanyName("Shutter Fly, Inc");
cust1.setUnsubscribe(false);

Customer cust2 = new Customer();

cust2.setEntityId("GNC");
cust2.setCompanyName("GNC Corp");
cust2.setUnsubscribe(false);

Customer[] customers = new Customer[2];

customers[0] = cust1;
customers[1] = cust2;

SuiteTalk SOAP Web Services Platform Guide

addList 166

WriteResponseList responseList = _port.addList(customers);

}

attach / detach
The attach and detach operations can be used to define or remove a relationship between two records.
For example, a Contact record can be associated with a Partner record, or an Opportunity record can be
associated with a Customer record.

Important: A user error is thrown if you attempt to attach files or records that do not exist.

You can also use the attach / detach operations to attach or detach a file to or from a record. Any file
that is in the NetSuite File Cabinet, for example an MS Word or Excel file or a PDF can be attached to any
record other than a custom record.
Note that when attaching Contacts to other entity records, the Contact's role can also be specified during
the request. Contact Roles are roles available in a user defined list at List > Relationships > Contacts. This
list has been exposed as ContactRole in accounting.xsd.
Note that to prevent duplicate records, NetSuite recommends using the alternate upsert and upsertList
operations along with external ids to add records to NetSuite.

Note: Contact records can be attached to all entity records expect for other Contact or Group
records.

The following table lists all records that support the attach/detach operations. It also lists which records
can accept file attachments as well as which records can accept Contact records as attachments.

Record Type Accepts File Attachments Accepts Contact Record Attachments

Transactions

Check X X

Custom Transaction X

Expense Report X

Inventory Adjustment X X

Item Fulfillment X X

Intercompany Transfer X X
Order

Opportunity X X

Transfer Order X X

Sales Order X X

Customer Payment X X

Return Authorization X X

Credit Memo X X

Cash Refund X X

Estimate X X

SuiteTalk SOAP Web Services Platform Guide

attach / detach 167

Record Type Accepts File Attachments Accepts Contact Record Attachments

Invoice X X

Cash Sale X X

Purchase Order X X

Requisition X X

Customer Payment X X

Customer Refund X X

Customer Deposit X X

Vendor Bill X X

Vendor Credit X X

Vendor Return X X
Authorization

Work Order X

Work Order Issue X

Work Order Close X

Work Order Completion X

Entities

Customer X X

Contact X

Employee X

Partner X X

Vendor X X

Project X X

Group X
Note: Although you cannot currently attach
Contact records to Group, you can attach members to
create a static group.

Activities

Task X

Event X

Phone Call X

Project Task X

Support

SupportCase X

Issue X

SuiteTalk SOAP Web Services Platform Guide

attach / detach 168

Record Type Accepts File Attachments Accepts Contact Record Attachments

Marketing

Campaign X

Request (attach)
The AttachRequest type is used for this request. It contains the following fields:

Element Name XSD Type Notes

attachReference AttachReference

Request (detach)
The DetachRequest type is used for this request. It contains the following fields:

Element Name XSD Type Notes

detachReference DetachReference

Response (attach)
The AttachResponse type is used for this response. It contains the following fields:

Element Name XSD Type Notes

response WriteResponse

Response (detach)
The DetachResponse type is used for this response. It contains the following fields:

Element Name XSD Type Notes

response WriteResponse

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault

SuiteTalk SOAP Web Services Platform Guide

attach / detach 169

■ UnexpectedErrorFault

Sample Code

SOAP Request (attach)

<attach xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<attachReferece xsi:type="ns1:AttachContactReference" xmlns:ns1="urn:core_2017_1.platform.webservices.netsuite.com">
<ns1:attachTo internalId="176" type="customer" xsi:type="ns1:RecordRef">
<ns1:name xsi:type="xsd:string">Adelina Shonkwiler</ns1:name>
</ns1:attachTo>
<ns1:contact internalId="1467" xsi:type="ns1:RecordRef"/>
<ns1:contactRole internalId="-10" xsi:type="ns1:RecordRef">
<ns1:name xsi:type="xsd:string">Primary Contact</ns1:name>
</ns1:contactRole>
</attachReferece>
</attach>

SOAP Request (detach)

<detach xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<detachReferece xsi:type="ns1:DetachBasicReference" xmlns:ns1="urn:core_2017_1.platform.webservices.netsuite.com">
<ns1:detachFrom internalId="176" type="customer" xsi:type="ns1:RecordRef">
<ns1:name xsi:type="xsd:string">Adelina Shonkwiler</ns1:name>
</ns1:detachFrom>
<ns1:detachedRecord internalId="1467" type="contact" xsi:type="ns1:RecordRef"/>
</detachReferece>
</detach>

SOAP Response (attach)

<attachResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<writeResponse>
<ns1:status isSuccess="true" xmlns:ns1="urn:core_2017_1.platform.webservices.netsuite.com"/>
<baseRef internalId="176" type="customer" xsi:type="ns2:RecordRef" xmlns:ns2="urn:core_2017_1.platform.webservices.net
suite.com">
<ns2:name>Adelina Shonkwiler</ns2:name>
</baseRef>
</writeResponse>
</attachResponse>

SOAP Response (detach)

<detachResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<writeResponse>
<ns1:status isSuccess="true" xmlns:ns1="urn:core_2017_1.platform.webservices.netsuite.com"/>
<baseRef internalId="176" type="customer" xsi:type="ns2:RecordRef" xmlns:ns2="urn:core_2017_1.platform.webservices.netsuit
e.com">
<ns2:name>Adelina Shonkwiler</ns2:name>
</baseRef>
</writeResponse>
</detachResponse>

Java (attach operation)

public void attach() throws Exception

SuiteTalk SOAP Web Services Platform Guide

attach / detach 170

{
RecordRef contactRef = new RecordRef();
contactRef.setInternalId("1467");
contactRef.setType(RecordType.contact);

RecordRef contactRoleRef = new RecordRef();

contactRoleRef.setInternalId("-10");
contactRoleRef.setName("Primary Contact");

RecordRef customerRef = new RecordRef();

customerRef.setInternalId("176");
customerRef.setType(RecordType.customer);

AttachContactReference attachRef = new AttachContactReference();

attachRef.setContact(contactRef);
attachRef.setAttachTo(customerRef);
attachRef.setContactRole(contactRoleRef);

WriteResponse attachResponse = sessMgr.getPort().attach(attachRef);

}

Java (detach operation)

public void detach() throws Exception
{
RecordRef contactRef = new RecordRef();
contactRef.setInternalId("1467");
contactRef.setType(RecordType.contact);

RecordRef customerRef = new RecordRef();

customerRef.setInternalId("176");
customerRef.setType(RecordType.customer);

AttachContactReference detachRef = new AttachContactReference();

detachRef.setContact(contactRef);
detachRef.setAttachTo(customerRef);

WriteResponse detachResponse = sessMgr.getPort().detach(detachRef);

}

changeEmail
Use the changeEmail operation to change a user's email address.

This topic provides details about how to change a user's email address with SOAP web services code. For
details about how to make this change in the NetSuite user interface, see the help topics Change Email
Link and Your User Credentials.

Important: This operation is supported as of the 2012.2 endpoint. The 2012.2 and later
endpoints support changeEmail and changePassword operations.

Important: Be aware that a user’s email address is not changed immediately. The old email
address remains in effect until the new email address is validated by the user, through a validation
link sent to the new address. A notification is also sent to the old address. This behavior is the
same as when users change their email addresses through the user interface.

Request
The ChangeEmailRequest type is used for the request.

SuiteTalk SOAP Web Services Platform Guide

changeEmail 171

Element Name XSD Type Notes

changeEmail ChangeEmail

The ChangeEmail type takes the following fields:

■ currentPassword
■ newEmail
■ newEmail2
■ justThisAccount

Response
The ChangeEmailResponse type is used for the response. It does not contain any fields.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InsufficientPermissionFault
■ InvalidAccountFault
■ InvalidCredentialsFault
■ InvalidVersionFault
■ ExceededRequestLimitFault
■ UnexpectedErrorFault
■ UserError

Sample Code

SOAP Request

<changeEmail xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<changeEmail>
<ns6:currentPassword xmlns:ns6="urn:core_2017_1.platform.webservices.netsuite.com">xxxxxxx</ ns6:currentPassword>
<ns7:newEmail xmlns:ns7="urn:core_2017_1.platform.webservices.netsuite.com">[email protected]</ns7:newEmail>
<ns8:newEmail2 xmlns:ns8="urn:core_2017_1.platform.webservices.netsuite.com"> newEmail @tester.com</ns8:newEmail2>
<ns9:justThisAccount xmlns:ns9="urn:core_2017_1.platform.webservices.netsuite.com">true</ns9:justThisAccount>
</changeEmail>
</changeEmail>

SOAP Response

SuiteTalk SOAP Web Services Platform Guide

changeEmail 172

</sessionResponse>
</changeEmailResponse>

Java

public void test_ChangeEmail() throws Exception {

sessMgr.loginWithEmail("[email protected]");
ChangeEmail c = new ChangeEmail();
c.setCurrentPassword("xxxxxx");
c.setNewEmail("[email protected]");
c.setNewEmail2("[email protected]");
c.setJustThisAccount(true);
sessMgr.getPort().changeEmail(c);
sessMgr.loginWithEmail("[email protected]");
}

changePassword
Use the changePassword operation to change a user's NetSuite password.

This topic provides details about how to change a user's password with SOAP web services code. For
details about how to make this change in the NetSuite user interface, see the help topics Change
Password Link and Your User Credentials.

Request
The ChangePasswordRequest type is used for the request.

Element Name XSD Type Notes

changePassword ChangePassword

The ChangePassword type takes the following fields:

■ currentPassword
■ newPassword
■ newPassword2

Response
The ChangePasswordResponse type is used for the response. It does not contain any fields.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InsufficientPermissionFault
■ InvalidAccountFault

SuiteTalk SOAP Web Services Platform Guide

changePassword 173

■ InvalidCredentialsFault
■ InvalidVersionFault
■ ExceededRequestLimitFault
■ UnexpectedErrorFault
■ UserError

Sample Code

SOAP Request

<soapenv:Body>
<changePassword xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<changePassword>
<ns6:currentPassword xmlns:ns6="urn:core_2017_1.platform.webservices.netsuite.com">password1</ns6:currentPassword>

<ns7:newPassword xmlns:ns7="urn:core_2017_1.platform.webservices.netsuite.com">password2</ns7:newPassword>
<ns8:newPassword2 xmlns:ns8="urn:core_2017_1.platform.webservices.netsuite.com">password2</ns8:newPassword2>
</changePassword>
</changePassword>
</soapenv:Body>

SOAP Response

<soapenv:Body>
<changePasswordResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<sessionResponse>
<platformCore:status isSuccess="true" xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com"/>
</sessionResponse>
</changePasswordResponse>
</soapenv:Body>

Java

ChangePassword changePW = new ChangePassword();

changePW.setCurrentPassword("password1");
changePW.setNewPassword("password2");
changePW.setNewPassword2("password2");

c.getPort().changePassword(changePW);

checkAsyncStatus
See checkAsyncStatus in Synchronous Versus Asynchronous Request Processing for details.

delete
The delete operation is used to delete an instance of a record. It is similar to the deleteList operation,
except that it permits only one record to be deleted per request.

SuiteTalk SOAP Web Services Platform Guide

delete 174

Request
The DeleteRequest type is used for the request. It contains the following fields.

Element Name XSD Type Notes

recordRef RecordRef Indentifies the record to be deleted.

deletionReason DeletionReason Identifies a deletion reason and deletion reason memo. This parameter
supports the Use Deletion Reasons feature, which requires users to provide
reasons when they delete transactions. However, even when this feature is
not enabled, you must use this parameter with every delete request. (You
can provide a value of null in such cases.) For more details, see Deletion
Reason Usage Notes.

Deletion Reason Usage Notes

Note the following about the deletionReason parameter:

■ The deletionReason complex type includes two fields: deletionReasonCode and deletionReasonMemo.
The deletionReasonCode must identify a deletion reason that is listed at Setup > Accounting >
Accounting Lists. If the Use Deletion Reasons feature is enabled and you use the deletionReasonCode
to identify a code that does not exist, the request fails with an INVALID_REF_KEY error.
■ Deletion reasons can be saved only for transactions. However, in SOAP web services, you must
use the deletionReason parameter even when referencing other record types, and even when the
Use Deletion Reasons feature is not enabled. For situations where it is not appropriate to identify a
deletion reason, pass in a value of null.
■ Even when when a deletion reason is required, you can use a value of null. In these cases, the
system automatically populates the deletion reason fields with default values. These defaults are:
Other for deletionReasonCode and This transaction was deleted by script or web service for
deletionReasonMemo.
■ The deletionReason complex type is defined in the core XSD.

For more details about the Use Deletion Reasons feature, see the help topic Recording a Reason for
Deleting a Transaction.

Response
The DeleteResponse type is used for the response. It contains the following fields.

Element Name XSD Type Notes

response WriteResponse Contains details on the status of the delete operation and a reference to
the deleted record.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

SuiteTalk SOAP Web Services Platform Guide

delete 175

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

Note: If you attempt to delete a record that does not exist, the system returns an
INVALID_KEY_OR_REF error.

Sample Code
The following example shows how to delete a cash sale transaction.

private void deleteCashSale()

{
RecordRef myCashSale = new RecordRef();
myCashSale.internalId = "1745";
myCashSale.type = RecordType.cashSale;
myCashSale.typeSpecified = true;

RecordRef myDeletionReasonCode = new RecordRef();

myDeletionReasonCode.internalId = "3";

DeletionReason myDeletionReason = new DeletionReason();

myDeletionReason.deletionReasonCode = myDeletionReasonCode;
myDeletionReason.deletionReasonMemo = "Per John in Accounting";

_service.delete(myCashSale, myDeletionReason);

SOAP Request

<soap:Body>
<delete xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<baseRef type="cashSale" internalId="1745" xsi:type="q1:RecordRef" xmlns:q1="urn:core_2017_1.platform.webservices.netsuit
e.com"/>
<deletionReason>
<deletionReasonCode internalId="3" xmlns="urn:core_2017_1.platform.webservices.netsuite.com"/>
<deletionReasonMemo xmlns="urn:core_2017_1.platform.webservices.netsuite.com">Per John in Accounting</deletionReason
Memo>
</deletionReason>
</delete>
</soap:Body>

SOAP Response

<soapenv:Body>

SuiteTalk SOAP Web Services Platform Guide

delete 176

deleteList
The deleteList operations is used to delete one or more record instances. The record instances can be of
various record types. For example, it is possible to delete a customer and a contact within a single request
by using this operation.

Note: An asynchronous equivalent is available for this operation, asyncDeleteList. For

information about asynchronous request processing, see Synchronous Versus Asynchronous
Request Processing.

Request
The DeleteListRequest type is used for the request. It contains the following fields.

Element Name XSD Type Notes

record[] RecordRef An array of recordRef objects that specify the records to be deleted.

deletionReason DeletionReason Identifies a deletion reason and deletion reason memo. This parameter
supports the Use Deletion Reasons feature, which requires users to provide
reasons when they delete transactions. However, even when this feature
is not enabled, you must use this parameter with every deleteList request.
(You can provide a value of null in such cases.) For more details, see
Deletion Reason Usage Notes.

Deletion Reason Usage Notes

Note the following about the deletionReason parameter:

■ A single deletion reason applies to the entire array of records being deleted. If some of the records
are transactions and some are not, then the deletion reason still applies to the transactions. It is
ignored for the other records.
■ The deletionReason complex type includes two fields: deletionReasonCode and deletionReasonMemo.
The deletionReasonCode must identify a deletion reason that is listed at Setup > Accounting >
Accounting Lists. If the Use Deletion Reasons feature is enabled and you use the deletionReasonCode
to identify a code that does not exist, the request fails with an INVALID_REF_KEY error.
■ Deletion reasons can be saved only for transactions. However, in SOAP web services, you must
use the deletionReason parameter even when referencing other record types, and even when the
Use Deletion Reasons feature is not enabled. For situations where it is not appropriate to identify a
deletion reason, pass in a value of null.
■ Even when when a deletion reason is required, you can use a value of null. In these cases, the
system automatically populates the deletion reason fields with default values. These defaults are:

SuiteTalk SOAP Web Services Platform Guide

deleteList 177

Other for deletionReasonCode and This transaction was deleted by script or web service for
deletionReasonMemo.
■ The deletionReason complex type is defined in the core XSD.

For more details about the Use Deletion Reasons feature, see the help topic Recording a Reason for
Deleting a Transaction.

Response
The DeleteListResponse type is used for the response. It contains the following fields.

Element Name XSD Type Notes

response[] WriteResponse Contains an array of WriteResponse objects, each of which contains details
on the status of the delete operation and a reference to the deleted record.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

Sample Code
The following examples show various ways of using the deleteList operation.

C#
The following example shows how to delete two cash sale transactions. Both transactions have the same
deletion reason.

private void deleteCashSales()

{
RecordRef myCashSale = new RecordRef();
myCashSale.internalId = "1727";
myCashSale.type = RecordType.cashSale;
myCashSale.typeSpecified = true;

RecordRef myCashSale2 = new RecordRef();

myCashSale2.internalId = "1728";
myCashSale2.type = RecordType.cashSale;
myCashSale2.typeSpecified = true;

SuiteTalk SOAP Web Services Platform Guide

deleteList 178

RecordRef myDeletionReasonCode = new RecordRef();

myDeletionReasonCode.internalId = "2";

DeletionReason myDeletionReason = new DeletionReason();

myDeletionReason.deletionReasonCode = myDeletionReasonCode;
myDeletionReason.deletionReasonMemo = "Per Scott";

RecordRef[] myCashSaleRefs = new RecordRef[2];

myCashSaleRefs[0] = myCashSale;
myCashSaleRefs[1] = myCashSale2;

_service.deleteList(myCashSaleRefs, myDeletionReason);

The following example shows how to delete two records of different types: an employee record and a
calender event record. Because it’s not possible to set a deletion reason for either of those two types of
records, the deletion reason used is null.

private void deleteVariousRecords()

{
RecordRef myEmployee = new RecordRef();
myEmployee.internalId = "360";
myEmployee.type = RecordType.employee;
myEmployee.typeSpecified = true;

RecordRef myCalendarEvent = new RecordRef();

myCalendarEvent.internalId = "381";
myCalendarEvent.type = RecordType.calendarEvent;
myCalendarEvent.typeSpecified = true;

RecordRef[] myRecords = new RecordRef[2];

myRecords[0] = myEmployee;
myRecords[1] = myCalendarEvent;

_service.deleteList(myRecords, null);

SOAP Request
The following SOAP request shows how to delete an employee and calendar event record.

<soap:Body>
<deleteList xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<baseRef type="employee" internalId="360" xsi:type="q1:RecordRef" xmlns:q1="urn:core_2017_1.platform.webservices.netsuit
e.com"/>
<baseRef type="calendarEvent" internalId="381" xsi:type="q2:RecordRef" xmlns:q2="urn:core_2017_1.platform.webservices.netsuit
e.com"/>
</deleteList>
</soap:Body>

SOAP Response
In the response, the status for each item in the request is returned. If a problem exists with one of the
items, creating an error, the other records are still processed.

<soapenv:Body>
<deleteListResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<writeResponseList>
<platformCore:status isSuccess="true" xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com"/>
<writeResponse>

SuiteTalk SOAP Web Services Platform Guide

deleteList 179

<platformCore:status isSuccess="true" xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com"/>

get
The get operation is used to retrieve a record by providing the unique id that identifies that record.

Request
The getRequest type is used for the request. It contains the following fields.

Element Name XSD Type Notes

recordRef RecordRef A recordRef object that specifies the id of the record to be retrieved.

Response
The getResponse type is used for the response. It contains the following fields.

Element Name XSD Type Notes

status Status The status for this operation. All applicable errors or warnings are listed within
this type.

record Record A record that represents the specified id. The actual record returned needs to
be a type that extends the abstract type Record.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

SuiteTalk SOAP Web Services Platform Guide

get 180

Usage Notes for Custom Fields Generated from Custom

Segments
The get operation supports the usage of unified scripts IDs of custom segments. If the unified script ID is
used on a custom segment, it is returned, if the legacy one is used, it is returned.

As of 2019.1, any new custom segments that you create automatically use the unified ID.

SOAP Response with Unified Script ID Used on the Custom

Segment

<soapenv:Body>
<getResponse xmlns="urn:messages_2018_2.platform.webservices.netsuite.com">
<readResponse>
<platformCore:status isSuccess="true" xmlns:platformCore="urn:core_2018_2.platform.webservices.netsuite.com"/>
<record internalId="107" xsi:type="listRel:Customer" xmlns:listRel="urn:relationships_2018_2.lists.webservices.net
suite.com">
<listRel:customForm internalId="3" xmlns:platformCore="urn:core_2018_2.platform.webservices.netsuite.com">
<platformCore:name>Customer_Preferred=T_Store=F</platformCore:name>
</listRel:customForm>
<listRel:entityId>Tim Harris</listRel:entityId>

…[more fields]…

<platformCore:customField internalId="58" scriptId="cseg_633637_beforeload" xsi:type="platformCore:BooleanCus

tomFieldRef">
<platformCore:value>false</platformCore:value>
</platformCore:customField>
</listRel:customFieldList>
</record>
</readResponse>
</getResponse>
</soapenv:Body>

SOAP Request – Return Customer Record

In this example, a single customer record is retrieved. Note that the internal ID for the specific instance of
the record and the record type (customer) must be specified.

<soapenv:Body>
<get xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<baseRef internalId="107" type="customer" xsi:type="ns7:RecordRef" xmlns:ns7="urn:core_2017_1.platform.webservices.net
suite.com"/>
</get>
</soapenv:Body>

SOAP Response

<soapenv:Body>
<getResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<readResponse>
<platformCore:status isSuccess="true" xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com"/>
<record internalId="107" xsi:type="listRel:Customer" xmlns:listRel="urn:relationships_2017_1.lists.webservices.net
suite.com">
<listRel:customForm internalId="3" xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com">
<platformCore:name>Customer_Preferred=T_Store=F</platformCore:name>
</listRel:customForm>
<listRel:entityId>Tim Harris</listRel:entityId>

SuiteTalk SOAP Web Services Platform Guide

get 181

<listRel:isPerson>false</listRel:isPerson>
<listRel:companyName>Glenrock General Hospital</listRel:companyName>
<listRel:entityStatus internalId="13" xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com">
<platformCore:name>CUSTOMER-Closed Won</platformCore:name>
</listRel:entityStatus>
<listRel:phone>555-394-3830</listRel:phone>
<listRel:email>[email protected]</listRel:email>

...[more fields]...

<listRel:isInactive>false</listRel:isInactive>
<listRel:dateCreated>2017-09-04T15:59:15.000-07:00</listRel:dateCreated>
<listRel:emailPreference>_default</listRel:emailPreference>
<listRel:sendEmail>false</listRel:sendEmail>
<listRel:customFieldList xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com">
<platformCore:customField internalId="59" scriptId="custentity_633637_asubmit" xsi:type="platformCore:Boolean
CustomFieldRef">
<platformCore:value>false</platformCore:value>
</platformCore:customField>
<platformCore:customField internalId="58" scriptId="custentity_633637_bload" xsi:type="platformCore:BooleanCus
tomFieldRef">
<platformCore:value>false</platformCore:value>
</platformCore:customField>
</listRel:customFieldList>
</record>
</readResponse>
</getResponse>
</soapenv:Body>

private void getCustomer()

{
// This operation requires a valid session
this.login( true );

// Prompt for the nsKey

_out.write( "\nnsKey for record to be retrieved: " );
String nsKey = _out.readLn();

// Invoke the get() operation to retrieve the record

RecordRef recordRef = new RecordRef();
recordRef.internalId = nsKey;
recordRef.type = RecordType.customer;
recordRef.typeSpecified = true;

ReadResponse response = _service.get( recordRef );

// Process response from get() operation

_out.info( "\nRecord returned from get() operation: " );
if ( !response.status.isSuccess )
{
_out.info(
"ERROR: " +
getStatusDetails( response.status ) );
}
else
{
Customer customer = (Customer) response.record;
_out.info(
"\nnsKey=" + customer.internalId + ", " +
"\nentityId=" + customer.entityId +
(customer.companyName==null ? "" : ("\ncompanyName=" + customer.companyName)) +
(customer.stage==null ? "" : ("\nstage=" + customer.stage)) +
(customer.email==null ? "" : ("\nemail=" + customer.email)) +
(customer.phone==null ? "" : ("\nphone=" + customer.phone)) +
"\nisInactive=" + customer.isInactive +
(!customer.dateCreatedSpecified ? "" : ("\ndateCreated=" +
customer.dateCreated.ToShortDateString())) );
}

SuiteTalk SOAP Web Services Platform Guide

get 182

Java

public void getCustomer() throws RemoteException, ExceededUsageLimitFault,

UnexpectedErrorFault, InvalidSessionFault, ExceededRecordCountFault {
// This operation requires a valid session
this.login(true);

// Prompt for the nsKey

_console.write("\nnsKey for record to be retrieved: ");
String nsKey = _console.readLn();

// Invoke the get() operation to retrieve the record

RecordRef recordRef = new RecordRef();
recordRef.setInternalId(nsKey);
recordRef.setType(RecordType.customer);

ReadResponse response = _port.get(recordRef);

// Process response from get() operation

_console.info("\nRecord returned from get() operation: ");
if (!response.getStatus().isIsSuccess()) {
_console.info("ERROR: " + getStatusDetails(response.getStatus()));
} else {
Customer customer = (Customer) response.getRecord();
_console
.info("\nnsKey="
+ customer.getInternalId()
+ ", "
+ "\nentityId="
+ customer.getEntityId()
+ (customer.getCompanyName() == null ? ""
: ("\ncompanyName=" + customer
.getCompanyName()))
+ (customer.getStage() == null ? ""
: ("\nstage=" + customer.getStage()))
+ (customer.getEmail() == null ? ""
: ("\nemail=" + customer.getEmail()))
+ (customer.getPhone() == null ? ""
: ("\nphone=" + customer.getPhone()))
+ "\nisInactive="
+ customer.getIsInactive()
+ (customer.getDateCreated() != null ? ""
: ("\ndateCreated=" + customer
.getDateCreated().toString())));
}
}

getAccountGovernanceInfo
The getAccountGovernanceInfo operation can be used to retrieve the account concurrency limit and the
unallocated concurrency limit through SOAP web services.

If an integration has insufficient concurrency limit allocated to it, it can use the
getAccountGovernanceInfo operation. With the retrieved information the integration can determine
whether there is sufficient unallocated concurrency limit for the account and can suggest the
administrator to increase the concurrency limit allocated to the integration.

If an integration does not have concurrency limit allocated to it, and the unallocated concurrency limit
is insufficient, the application can use the getAccountGovernanceInfo operation. With the retrieved
information the integration can advise the administrator to concider decreasing the concurrency limit
allocated for other integrations and calculate if that is feasible.

SuiteTalk SOAP Web Services Platform Guide

getAccountGovernanceInfo 183

Note: The operation will return results only if you are logged in as an administrator.

SOAP Request
<soapenv:Body>
<getAccountGovernanceInfo/>
</soapenv:Body>

SOAP Response
<soapenv:Body>
<getAccountGovernanceInfoResponse>
<platformCore:getAccountGovernanceInfoResult>
<platformCore:status isSuccess="true"/>
<platformCore:accountConcurrencyLimit>5</platformCore:accountConcurrencyLimit>
<platformCore:unallocatedConcurrencyLimit>3</platformCore:unallocatedConcurrencyLimit>
</platformCore:getAccountGovernanceInfoResult>
</getAccountGovernanceInfoResponse>
</soapenv:Body>

getAll
The getAll operation is used to retrieve a list of all records of the specified type. Records that support the
getAll operation are listed in the GetAllRecordType, as defined in the platformCoreType system constants
XSD file.

Note: You cannot use the search operation to retrieve state values. You must use the getAll
operation. The getAll operation will return all states, not the legal ones for your default country.
Also note that the country and state must match on the address.

Request
The getAllRequest type is used for the request. It contains the following fields.

Element Name XSD Type Notes

recordType GetAllRecordType Specify the record type.

Response
The getList response type is used for the response. It contains the following fields.

Element Name XSD Type Notes

status Status The status for this operation. All applicable errors or warnings are listed within
this type.

recordList Record[] A list of records that correspond to the specified ids. The actual records
returned need to be of a type that extends the abstract type Record.

SuiteTalk SOAP Web Services Platform Guide

getAll 184

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

Sample Code
The following sample shows how to retrieve the list of all Currency records.

Java

public void getAll() throws Exception {

c.getAll(GetAllRecordType.currency);
}

SOAP Request

<soapenv:Body>
<getAll xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<record recordType="currency"/>
</getAll>
</soapenv:Body>

SOAP Response

<soapenv:Body>
<getAllResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<platformCore:getAllResult xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com">
<platformCore:status isSuccess="true"/>
<platformCore:totalRecords>2</platformCore:totalRecords>
<platformCore:recordList>
<platformCore:record internalId="1" xsi:type="listAcct:Currency" xmlns:listAcct="urn:accounting_2017_1.lists.web
services.netsuite.com">
<listAcct:name>US USD</listAcct:name>
<listAcct:symbol>USD</listAcct:symbol>
<listAcct:isBaseCurrency>true</listAcct:isBaseCurrency>
<listAcct:isInactive>false</listAcct:isInactive>
<listAcct:overrideCurrencyFormat>false</listAcct:overrideCurrencyFormat>
<listAcct:displaySymbol>$</listAcct:displaySymbol>
<listAcct:symbolPlacement>_beforeNumber</listAcct:symbolPlacement>
<listAcct:locale>_unitedStatesEnglish</listAcct:locale>
<listAcct:formatSample>$1,234.56</listAcct:formatSample>

SuiteTalk SOAP Web Services Platform Guide

getAll 185

<listAcct:exchangeRate>1.0</listAcct:exchangeRate>
<listAcct:currencyPrecision>_two</listAcct:currencyPrecision>
</platformCore:record>
<platformCore:record internalId="2" xsi:type="listAcct:Currency" xmlns:listAcct="urn:accounting_2017_1.lists.web
services.netsuite.com">
<listAcct:name>UK GBP</listAcct:name>
<listAcct:symbol>GBP</listAcct:symbol>
<listAcct:isBaseCurrency>true</listAcct:isBaseCurrency>
<listAcct:isInactive>false</listAcct:isInactive>
<listAcct:overrideCurrencyFormat>false</listAcct:overrideCurrencyFormat>
<listAcct:displaySymbol>£</listAcct:displaySymbol>
<listAcct:symbolPlacement>_beforeNumber</listAcct:symbolPlacement>
<listAcct:locale>_unitedKingdomEnglish</listAcct:locale>
<listAcct:formatSample>£1,234.56</listAcct:formatSample>
<listAcct:exchangeRate>0.6</listAcct:exchangeRate>
<listAcct:currencyPrecision>_two</listAcct:currencyPrecision>
</platformCore:record>
</platformCore:recordList>
</platformCore:getAllResult>
</getAllResponse>
</soapenv:Body>

getAsyncResult
See Checking for Detailed Results of an Asynchronous Job in Asynchronous Request Processing for
details.

getBudgetExchangeRate
On the Budget Exchange Rates table, you can maintain exchange rates between the root-parent and child
subsidiaries for use in the budgeting process. Use the getBudgetExchangeRate operation to get and filter
all data related to this table.

Important: This operation can be used only in NetSuite OneWorld accounts.

In the UI, you can see the Budget Exchange Rates table by going to List > Accounting > Budget Exchange
Rates. Note that in SOAP web services, this table is read-only.

SuiteTalk SOAP Web Services Platform Guide

getBudgetExchangeRate 186

For general information on the Budget Exchange Rate table, see the help topic Budget Exchange Rates.

Request
The GetBudgetExchangeRateRequest type is used for the request.

Element Name XSD Type Notes

budgetExchangeRateFilter BudgetExchageRateFilter You can filter the returned exchange rates for a budget
using this filter.

BudgetExchangeRateFilter

Element Name XSD Type Notes

period RecordRef References an existing period. This argument is required.

fromSubsidiary RecordRef References the receiving subsidiary. This argument is optional.

toSubsidiary RecordRef References the originating subsidiary. This argument is optional.

Response
The GetBudgetExchangeRateResult type is used for the response.

Element Name XSD Type Notes

status Status The status for this operation. All applicable errors or
warnings are listed within this type.

budgetExchangeRateList BudgetExchangeRateList Returns a list of available exchange rates in a budget.

BudgetExchangeRateList

Element Name XSD Type Notes

budgetExchangeRate BudgetExchangeRate References the exchange rate for a budget.

BudgetExchangeRate

Element Name XSD Type Notes

period RecordRef References an existing period.

fromSubsidiary RecordRef References the receiving subsidiary.

toSubsidiary RecordRef References the originating subsidiary.

currentRate double References the current rate.

averageRate double References the average rate.

SuiteTalk SOAP Web Services Platform Guide

getBudgetExchangeRate 187

Element Name XSD Type Notes

historicalRate double References the historical rate.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

Sample Code

SOAP Request

<?xml version="1.0" encoding="UTF-8"?>

SOAP Response

<?xml version="1.0" encoding="utf-8"?>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/
XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Body>
<getBudgetExchangeRateResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<platformCore:getBudgetExchangeRateResult xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com">
<platformCore:status isSuccess="true"/>
<platformCore:budgetExchangeRateList>
<platformCore:budgetExchangeRate>
<platformCore:period internalId="3"/>
<platformCore:fromSubsidiary internalId="4"/>
<platformCore:toSubsidiary internalId="1"/>
<platformCore:currentRate>1.9586</platformCore:currentRate>
<platformCore:averageRate>1.9586</platformCore:averageRate>
<platformCore:historicalRate>1.9586</platformCore:historicalRate>
</platformCore:budgetExchangeRate>
</platformCore:budgetExchangeRateList>

SuiteTalk SOAP Web Services Platform Guide

getBudgetExchangeRate 188

</platformCore:getBudgetExchangeRateResult>
</getBudgetExchangeRateResponse>
</soapenv:Body>
</soapenv:Envelope>

Java

/* Make Record Ref out of an internalId */

public static RecordRef mrr(String internalId)
{
RecordRef toRet = new RecordRef();
toRet.setInternalId(internalId);
return toRet;
}

c.getPort().getBudgetExchangeRate(new BudgetExchangeRateFilter(mrr("3"),mrr("4"),null));

getConsolidatedExchangeRate
On the Consolidated Exchange Rates table, you can maintain exchange rates between the root-parent
and child subsidiaries. Use the getConsolidatedExchangeRate operation to get and filter all data related
to this table.

Important: The exposure of the consolidated exchange rate record prompted the removal
of the getConsolidatedExchangeRate operation from the 2017.1 endpoint. You can still use the
getConsolidatedExchangeRate operation on earlier endpoints. For more information about
working with consolidated exchange rates on endpoints starting from 2017.1, see the help topic
Consolidated Exchange Rate.

Important: This operation can be used only in NetSuite OneWorld acccounts.

In the UI, you can see the Consolidated Exchange Rates table by going to List > Accounting >
Consolidated Exchange Rates. Note that in SOAP web services, this table is read-only.

For general information on currencies and working with the Consolidated Exchange Rate table, see the
following topics:

SuiteTalk SOAP Web Services Platform Guide

getConsolidatedExchangeRate 189

■ Creating Currency Records

■ Currency Exchange Rates

Note: If you choose, you can set exchange rates in the Consolidated Exchange Rates table
directly. See the steps under “To set exchange rates in the Consolidated Exchange Rates table” for
details.

■ Currency Exchange Rate Integration

■ Currency Management

getConsolidatedExchangeRate for the Multi-Book Accounting

Feature
Results for the getConsolidatedExchageRate operation can include values for the book field. Results can
also be filtered by this field.

■ If the Multi-Book Accounting feature is enabled:

□ If the book is not set in the request, getConsolidatedExchangeRate returns values for all
accounting books that have the Enable Consolidation option selected.
□ If the book is set in the request, getConsolidatedExchangeRate returns values for the specified
accounting book.
■ If the Multi-Book Accounting feature is not enabled:
□ If the book is set in the request, getConsolidatedExchangeRate returns an error with the code =
"FEATURE_DISABLED" and the message = "The ''Multi-Book Accounting'' feature is not enabled in
your NetSuite account."
□ Book is not part of the response.

Note: In endpoints prior to 2016.2, the getConsolidatedExchangeRate operation can only be

used to return results for the primary accounting book, even if the Multi-Book Accounting feature
is enabled.

Request
The GetConsolidatedExchangeRateRequest type is used for the request.

Element Name XSD Type Notes

consolidatedExchangeRateFilter ConsolidatedExchangeRateFilter You can filter the returned consolidated

exchange rates using this filter.

ConsolidatedExchangeRateFilter
ConsolidatedExchangeRateFilter is defined in the core XSD.

Element Name XSD Type Notes

period RecordRef References an existing period. This argument is required.

SuiteTalk SOAP Web Services Platform Guide

getConsolidatedExchangeRate 190

Element Name XSD Type Notes

fromSubsidiary RecordRef References the receiving subsidiary. This argument is optional.

toSubsidiary RecordRef References the originating subsidiary. This argument is optional.

book RecordRef References the specific accounting book for accounts with the Multi-Book
Accounting feature enabled.

Response
The GetConsolidatedExchangeRateResult type is used for the response.

Element Name XSD Type Notes

status Status The status for this operation. All applicable

errors or warnings are listed within this type.

consolidatedExchangeRateList ConsolidatedExchangeRateList Returns a list of available consolidated

exchange rates.

ConsolidatedExchangeRateList

Element Name XSD Type Notes

consolidatedExchangeRate ConsolidatedExchangeRate References an existing period.

ConsolidatedExchangeRate

Element Name XSD Type Notes

period RecordRef References an existing period.

fromSubsidiary RecordRef References the receiving subsidiary.

toSubsidiary RecordRef References the originating subsidiary.

currentRate double References the current rate.

averageRate double References the average rate.

historicalRate double References the historical rate.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault

SuiteTalk SOAP Web Services Platform Guide

getConsolidatedExchangeRate 191

■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

Sample Code
The getConsolidatedExchangeRate and getBudgetExchangeRate operations are used in the same way.
Therefore, please refer to the Sample Code for getBudgetExchangeRate.

getCurrencyRate
Use this operation to get the exchange rate between two currencies based on a certain date. The
exchange rate values you are getting are those that appear in the Exchange Rate column of the Currency
Exchange Rates table, which you can view at Lists > Accounting > Currency Exchange Rates.

The role used to execute this operation must have at least View level of the Currency permission (a Lists
type permission).

Note: The Multiple Currencies feature must be enabled in your account before using the
getCurrencyRate operation. For information on enabling this feature, see the help topic Enabling
the Multiple Currencies Feature.

Request
The GetCurrencyRateRequest type is used for the request. This method accepts the argument
CurrencyRateFilter. With this filter you specify what you want returned in the results.

If you do not specify anything in the filter, the resulting CurrencyRateList will contain all currency
exchange rates (all combinations) for the actual date. For example, if you specify baseCurrency only (for
example, Euro), you will get all rates for Euro {USD,YEN,SING,....}.

Element Name XSD Type Notes

currencyRateFilter CurrencyRateFilter Filter the returned currency exchange rates using this filter.

SuiteTalk SOAP Web Services Platform Guide

getCurrencyRate 192

CurrencyRateFilter

Element Name XSD Type Notes

baseCurrency RecordRef References the base currency. This argument is optional.

fromCurrency RecordRef References the from or “exchange” currency. This argument is optional.

effectiveDate dateTime This argument is optional. If a date is not provided, the date defaults to the
current date.

Response
The GetCurrencyRateResponse type is used for the response.

Element Name XSD Type Notes

status Status The status for this operation. All applicable errors or warnings are listed within
this type.

currencyRate double Returns a list of available currency exchange rates.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ InsufficientPermissionFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

Sample Code

SOAP Request

<soapenv:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:soapen

v="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header>
<ns1:passport soapenv:mustUnderstand="0" soapenv:actor="http://schemas.xmlsoap.org/soap/actor/next" xmlns:ns1="urn:mes
sages_2017_1.platform.webservices.netsuite.com">
<ns2:email xmlns:ns2="urn:core_2017_1.platform.webservices.netsuite.com">[email protected]</ns2:email>
<ns3:password xmlns:ns3="urn:core_2017_1.platform.webservices.netsuite.com">*******</ns3:password>
<ns4:account xmlns:ns4="urn:core_2017_1.platform.webservices.netsuite.com">1234567</ns4:account>
<ns5:role internalId="37" xmlns:ns5="urn:core_2017_1.platform.webservices.netsuite.com"/>

SuiteTalk SOAP Web Services Platform Guide

getCurrencyRate 193

</ns1:passport>
</soapenv:Header>
<soapenv:Body>
<getCurrencyRate xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<currencyRateFilter>
<ns6:baseCurrency internalId="2" xmlns:ns6="urn:core_2017_1.platform.webservices.netsuite.com"/>
<ns7:fromCurrency internalId="1" xmlns:ns7="urn:core_2017_1.platform.webservices.netsuite.com">
<ns8:effectiveDate xmlns:ns8="urn:core_2017_1.platform.webservices.netsuite.com">2012-08
11T06:58:59.628Z</ns8:effectiveDate>
</currencyRateFilter>
</getCurrencyRate>
</soapenv:Body>
</soapenv:Envelope>

SOAP Response
<soapenv:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:soapen
v="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header>
<platformMsgs:documentInfo xmlns:platformMsgs="urn:messages_2017_1.platform.webservices.netsuite.com">
<platformMsgs:nsId>WEBSERVICES_1326288_08092012257172984776216537_6c7c330232bb5</platformMsgs:nsId>
</platformMsgs:documentInfo>
</soapenv:Header>
<soapenv:Body>
<getCurrencyRateResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<platformCore:getCurrencyRateResult xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com">
<platformCore:status isSuccess="true"/>
<platformCore:currencyRateList>
<platformCore:currencyRate>
<platformCore:baseCurrency internalId="2"/>
<platformCore:fromCurrency internalId="1"/>
<platformCore:exchangeRate>0.42283298</platformCore:exchangeRate>
<platformCore:effectiveDate>1970-01-01T00:00:00.000-08:00</platformCore:effectiveDate>
</platformCore:currencyRate>
</platformCore:currencyRateList>
</platformCore:getCurrencyRateResult>
</getCurrencyRateResponse>
</soapenv:Body>
</soapenv:Envelope>

Java
This sample shows how to get the actual rate for tomorrow and for USD to GBP.

public void getCurrencyRate() throws Exception

{
this.login();

CurrencyRateFilter crf = new CurrencyRateFilter();

Calendar cal = Calendar.getInstance();
cal.add(Calendar.DAY_OF_YEAR, +1); //tomorrow
crf.setEffectiveDate(cal);

RecordRef currencyRef1 = new RecordRef();

currencyRef1.setInternalId("1"); //USD
crf.setBaseCurrency(currencyRef1);

RecordRef currencyRef2 = new RecordRef();

currencyRef2.setInternalId("2"); //GBP
crf.setFromCurrency(currencyRef2);

GetCurrencyRateResult gcrr = _port.getCurrencyRate(crf);

CurrencyRateList crl = gcrr.getCurrencyRateList();
CurrencyRate cr = crl.getCurrencyRate(0);
Double rate = cr.getExchangeRate();

System.out.println("Exchange rate is = " + rate);

SuiteTalk SOAP Web Services Platform Guide

getCurrencyRate 194

Note: The mrr() method is a convenience method for specifying a record without the need to
indicate a record type.

/* Make Record Ref out of an internalId */

public static RecordRef mrr(String internalId)
{
RecordRef toRet = new RecordRef();
toRet.setInternalId(internalId);
return toRet;
}

getCustomizationId
When integrating with NetSuite through SOAP web services, in many cases, you will want to know which
custom objects exist in an account. You may also want to obtain metadata for these custom objects so
that your application can handle any business logic that is specific to the account.

To learn which custom objects exist in an account, use the getCustomizationId operation to retrieve
the internalIds, externalIds, and/or scriptIds of all custom objects of a specified type. These types,
enumerated in CustomizationType, include the following:

■ crmCustomField
■ customList
■ customRecordType
■ customRecordCustomField
■ customSegment
■ entityCustomField
■ itemCustomField
■ itemOptionCustomField
■ otherCustomField
■ transactionBodyCustomField
■ transactionColumnCustomField

Note: The CustomizationType object is defined in the coreTypes XSD.

After the IDs are returned, you can then pass the ID value(s) to either the get or getList operation to
obtain metadata for specific custom objects (see Using get and getList with getCustomizationId for more
details).

Note the following:

■ To see the UI equivalent of a NetSuite custom object, go to Customization > Lists, Records, & Fields
> [custom object type]. For information on working with each object type in SOAP web services, see
the help topic SuiteBuilder Overview. For a more general understanding of the NetSuite customization
model, see the help topic SuiteBuilder (Customization).
■ Normally, you cannot add or update the internalId of a NetSuite object. Custom objects, however,
are an exception to this rule. You can specify the ID on add, but you cannot update the ID thereafter.
Also note that internalIds for custom objects can be set to any unique alphanumeric string up to 30
characters long. This string cannot include any spaces, but it can include underscores ( _ ).

SuiteTalk SOAP Web Services Platform Guide

getCustomizationId 195

■ The getCustomizationId operation also returns fields generated from custom segments. See the SOAP
samples at SOAP Request for Returning Custom Segments.

Using get and getList with getCustomizationId

If you want only the internalIds, externalIds, and/or scriptIds for custom objects of a specific type, you can
call getCustomizationId on that custom type (for example, crmCustomField). However, if you also want the
metadata for any or all of the custom objects referenced in the getCustomizationId response, you must
invoke a get or getList request and specify each object's ID.

When using either the get or getList operations in conjunction with getCustomizationId, be aware of the
following:

■ If you specify more than one ID in a get | getList call, the IDs you pass are read in the following order:
internalId, externalId, scriptId.
■ If an invalid scriptId is specified but the internalId or externalId is correct, the scriptId is ignored.
■ NetSuite will reject get | getList requests if only a scriptId is passed for record types that do not
support scriptIds.

Request
The getCustomizationIdRequest type is used for this request. It contains the following fields:

Element Name XSD Type Notes

customizationType CustomizationType Any of the custom object types enumerated in CustomizationType.

includeInactives boolean A value of true or false is required. A value of false means no inactive
custom objects are returned in the response.

A value of true means that both active and inactive custom objects are
returned in the response.

■ To determine which of the returned custom objects are inactive,

you must perform either a get or getList operation to obtain the
metadata for the custom object type(s). For custom records and
custom lists, the value is specified in the isInactive element.
■ Although the includeInactives argument is required, the value
you set applies to custom record and custom list objects only.
In NetSuite, custom fields cannot be set to active or inactive.
Therefore, when using getCustomizationId on a custom field
type, the value you specify for includeInactives will be ignored.
Whether you specify true or false, all custom field objects (of the
type specified in your request) will be returned.

Response
The getCustomizationIdResult type is used for the response. It contains the following fields:

Element Name XSD Type Notes

status Status The status for this operation. All applicable errors or warnings are
listed within this type.

SuiteTalk SOAP Web Services Platform Guide

getCustomizationId 196

Element Name XSD Type Notes

totalRecords xsd:int The total number of records for this request. Depending on the
pageSize value, some or all the records may be returned in the
response.

customizationRefList CustomizationRef A list of custom objects that correspond to the specified customization
type. Also returns the internalId, externalId, and/or scriptId of each
object.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

Sample Code
The following sample is a two-part sample. The first part of the sample shows how to construct a
getCustomizationId request so that the IDs for all custom record type objects in a NetSuite account are
returned. Notice that in the getCustomizationId request, the value of the includeInactives parameter is set
to false, meaning that only custom records marked as “active” in the account will be returned.

The second part of the sample shows how to take internalIds that are returned, and make a getList
request to return the metadata for each custom record type.

C# Sample
NetSuiteService nss = new NetSuiteService();

// credential code ignored here in this sample ...

// Perform getCustomizationId on custom record type

CustomizationType ct = new CustomizationType();
ct.getCustomizationTypeSpecified=true;
ct.getCustomizationType = GetCustomizationType.customRecordType;

// Retrieve active custom record type IDs. The includeInactives param is set to false.
GetCustomizationIdResult getCustIdResult = nss.getCustomizationId(ct, false);

// Retrieve the metadata of the returned custom record types

ReadResponse [] readResp = nss.getList(getCustIdResult.customizationRefList);

SOAP Request (getCustomizationId)

<soapenv:Body>

SuiteTalk SOAP Web Services Platform Guide

getCustomizationId 197

<getCustomizationId xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<customizationType getCustomizationType="customRecordType"/>
<includeInactives>false</includeInactives>
</getCustomizationId>
</soapenv:Body>

SOAP Response (getCustomizationId)

<getCustomizationIdResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<platformCore:getCustomizationIdResult xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com">
<platformCore:status isSuccess="true"/>
<platformCore:totalRecords>1</platformCore:totalRecords>
<platformCore:customizationRefList>
<platformCore:customizationRef internalId="15" scriptId="customrecord15" type="customRecordType">
<platformCore:name>Customer Satisfaction Survey</platformCore:name>
</platformCore:customizationRef>
</platformCore:customizationRefList>
</platformCore:getCustomizationIdResult>
</getCustomizationIdResponse>

SOAP Request (getList)

<getList xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<baseRef xmlns:q1="urn:core_2017_1.platform.webservices.netsuite.com" xsi:type="q1:CustomizationRef" inter
nalId="15" scriptId="customrecord15" type="customRecordType">
<q1:name>Customer Satisfaction Survey</q1:name>
</baseRef>
</getList>

SOAP Response (getList)

<getListResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<readResponseList>
<readResponse>
<platformCore:status isSuccess="true" xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com"/>
<record internalId="15" xsi:type="setupCustom:CustomRecordType" xmlns:setupCustom="urn:customiza
tion_2017_1.setup.webservices.netsuite.com">
<setupCustom:recordName>Customer Satisfaction Survey</setupCustom:recordName>
<setupCustom:includeName>true</setupCustom:includeName>
<setupCustom:showId>true</setupCustom:showId>
<setupCustom:showCreationDate>true</setupCustom:showCreationDate>
<setupCustom:showCreationDateOnList>true</setupCustom:showCreationDateOnList>
<setupCustom:isAvailableOffline>false</setupCustom:isAvailableOffline>
<setupCustom:allowQuickSearch>false</setupCustom:allowQuickSearch>
<setupCustom:isInactive>false</setupCustom:isInactive>
<setupCustom:disclaimer>Record numbers cannot be reverted back to names after being
updated. </setupCustom:disclaimer>
<setupCustom:enableNumbering>false</setupCustom:enableNumbering>
<setupCustom:numberingCurrentNumber>413</setupCustom:numberingCurrentNumber>
<setupCustom:allowNumberingOverride>false</setupCustom:allowNumberingOverride>
<setupCustom:isNumberingUpdateable>false</setupCustom:isNumberingUpdateable>
<setupCustom:scriptId>customrecord15</setupCustom:scriptId>
<setupCustom:fieldList>
<setupCustom:customField scriptId="customrecord_CONTACT_TYPE">
<setupCustom:label>Contact type</setupCustom:label>
<setupCustom:fieldType>_listRecord</setupCustom:fieldType>
<setupCustom:selectRecordType internalId="16" xmlns:platformCore="urn:core_2017_1.platform.webser
vices.netsuite.com">
<platformCore:name>Customer contact type</platformCore:name>
</setupCustom:selectRecordType>
<setupCustom:storeValue>true</setupCustom:storeValue>
<setupCustom:showInList>false</setupCustom:showInList>
<setupCustom:globalSearch>false</setupCustom:globalSearch>

SuiteTalk SOAP Web Services Platform Guide

getCustomizationId 198

<setupCustom:isParent>false</setupCustom:isParent>
<setupCustom:displayType>_normal</setupCustom:displayType>
<setupCustom:isMandatory>true</setupCustom:isMandatory>
<setupCustom:checkSpelling>false</setupCustom:checkSpelling>
<setupCustom:defaultChecked>false</setupCustom:defaultChecked>
<setupCustom:isFormula>false</setupCustom:isFormula>
<setupCustom:recType>15</setupCustom:recType>
<setupCustom:roleRestrict>false</setupCustom:roleRestrict>
<setupCustom:accessLevel>_edit</setupCustom:accessLevel>
<setupCustom:searchLevel>_edit</setupCustom:searchLevel>
</setupCustom:customField>
<setupCustom:customField scriptId="customrecord_IF_OTHER">
<setupCustom:label>Other contact type</setupCustom:label>
<setupCustom:fieldType>_freeFormText</setupCustom:fieldType>
<setupCustom:storeValue>true</setupCustom:storeValue>
<setupCustom:showInList>false</setupCustom:showInList>
<setupCustom:globalSearch>false</setupCustom:globalSearch>
<setupCustom:isParent>false</setupCustom:isParent>
<setupCustom:displayType>_normal</setupCustom:displayType>
<setupCustom:displayWidth>42</setupCustom:displayWidth>
<setupCustom:isMandatory>false</setupCustom:isMandatory>
<setupCustom:checkSpelling>false</setupCustom:checkSpelling>
<setupCustom:defaultChecked>false</setupCustom:defaultChecked>
<setupCustom:isFormula>false</setupCustom:isFormula>
<setupCustom:recType>15</setupCustom:recType>
<setupCustom:roleRestrict>false</setupCustom:roleRestrict>
<setupCustom:accessLevel>_edit</setupCustom:accessLevel>
<setupCustom:searchLevel>_edit</setupCustom:searchLevel>
</setupCustom:customField>

// custom field list continues ...

</setupCustom:fieldList>
<setupCustom:formsList>
<setupCustom:forms>
<setupCustom:formName>Standard Customer Satisfaction Survey
Form<setupCustom:formName>
<setupCustom:formPref>false</setupCustom:formPref>
</setupCustom:forms>
</setupCustom:formsList>
<setupCustom:parentsList>
<setupCustom:parents>
<setupCustom:childDescr>Customer</setupCustom:childDescr>
</setupCustom:parents>
</setupCustom:parentsList>
</record>
</readResponse>
</readResponseList>
</getListResponse>

SOAP Request for Returning Custom Segments

<soapenv:Body>
<getCustomizationId xmlns="urn:messages_2019_1.platform.webservices.netsuite.com">
<customizationType getCustomizationType="customSegment"/>
<includeInactives>false</includeInactives>
</getCustomizationId>
</soapenv:Body

SOAP Response with Unified Script ID Used on the Custom

Segment
<soapenv:Body>
<getCustomizationIdResponse xmlns="urn:messages_2019_1.platform.webservices.netsuite.com">
<platformCore:getCustomizationIdResult xmlns:platformCore="urn:core_2019_1.platform.webservices.netsuite.com">
<platformCore:status isSuccess="true"/>

SuiteTalk SOAP Web Services Platform Guide

getCustomizationId 199

<platformCore:totalRecords>1</platformCore:totalRecords>
<platformCore:customizationRefList>
<platformCore:customizationRef scriptId="cseg_testws" internalId="1" type="customSegment">
<platformCore:name>TestWS</platformCore:name>
</platformCore:customizationRef>
</platformCore:customizationRefList>
</platformCore:getCustomizationIdResult>
</getCustomizationIdResponse>
</soapenv:Body>

Java Sample
The following Java sample show how to construct a getCustomizationId request so that the IDs for all
custom record type objects are returned. In this example, inactive custom record type objects are not
returned.

// Perform getCustomizationId operation on the custom record type

public void getCustomizationId () throws Exception {

CustomizationType ct = new CustomizationType();
ct.setGetCustomizationType(GetCustomizationType.entityCustomField);
ct.getGetCustomizationType();

c.getCustomizationId(GetCustomizationType.customRecordType, false);

getDataCenterUrls
You use the getDataCenterUrls operation to obtain the correct URL for external client access to NetSuite.

getDataCenterURLs requests do not require authentication, nor any information identifying the
application. The getDataCenterUrls operation ignores all authentication data, if any such data is sent.

SOAP web services versions 2019.1 and later are only available on account-specific domains. The
URL for your account-specific SOAP web services domain includes your account ID. For example,
if your account ID was 123456, then your account-specific SOAP web services domain would be
123456.suitetalk.api.netsuite.com. As of 2019.1, the getDataCenterUrls operation also returns your
account-specific SOAP web services domain.

For more details about dynamic discovery of URLs, see the help topic Dynamic Discovery of URLs for SOAP
Web Services and RESTlet Clients.

Important: As of the 2019.1 SOAP web services endpoint, you must use account-specific
domains with SOAP web services. Use the SOAP getDataCenterUrls operation to obtain the
correct domain. Or, go to Setup > Company > Setup Tasks > Company Information in the NetSuite
UI. Your domains are listed on the Company URLs subtab.

Important: If you receive the following error, either use your account-specific domain for your
request for the data center URL, or use the c parameter in your request to specify your account
ID. Using either your account-specific domain, or using the c parameter in your request, ensures
that you receive the correct response. The routing depends on the version of your NetSuite
account, and not the version of the WSDL you use.

SuiteTalk SOAP Web Services Platform Guide

getDataCenterUrls 200

In addition to the URL for SOAP web services access, the getDataCentersUrls operation also supports
discovery of other NetSuite domains. You can use this operation to discover any of the following:

■ restletDomain – https://<accountID>.restlets.api.netsuite.com
■ systemDomain – https://<accountID>.app.netsuite.com
■ webservicesDomain – https://<accountID>.suitetalk.api.netsuite.com

Note: When you send your initial dynamic discovery call, you should use the https://
webservices.netsuite.com URL.

If you are building an integration for your own use or for a single customer, you integration must include
logic to determine the correct URL for the appropriate NetSuite account. If you are building an application
that will be distributed to multiple customers, you must incorporate logic that can determine the correct
URL for any of those customers.

REST Services as Alternate Methods for Dynamic Discovery of

URL
The getDataCenterUrls operation is available in the 2012.2 and later endpoints. However, you do not
have to upgrade your endpoint to support dynamic discovery of the correct SOAP web services domain.
NetSuite also provides REST services that you can use.

For general information about the DataCenterUrls REST service, see the help topic DataCenterUrls REST
Service.

Request
The GetDataCenterUrlsRequest type is used for this request. It requires the following field:

Element Name XSD Type Notes

account string NetSuite account ID.

Note: If an invalid account ID is specified, the default URLs are

returned.

Response
The GetDataCenterUrlsResult type is used for the response. It contains the following fields:

Element Name XSD Type Notes

status Status The status for this operation. All applicable errors or warnings are listed
within this type.

restDomain string URL used by external client applications to access NetSuite through a RESTlet.

systemDomain string

SuiteTalk SOAP Web Services Platform Guide

getDataCenterUrls 201

Element Name XSD Type Notes

webservicesDomain string URL used by external client applications to access NetSuite through SOAP
web services.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ ExceededRequestSizeFault
■ UnexpectedErrorFault

Also, a DATA_REQD error is thrown if no account ID is provided in the request. For an example, see SOAP
Response (empty account).

Sample Code

C# Sample

class DataCenterDomains : NetSuiteService

{

private System.Uri OriginalUri;

public DataCenterDomains (string account, bool doNotSetUrl)

: base()
{
OriginalUri = new System.Uri(this.Url);
if (account == null || account.Length == 0)
account = "empty";
if (!doNotSetUrl)
{
DataCenterUrls urls = getDataCenterUrls(account).dataCenterUrls;
Uri dataCenterUri = new Uri(urls.webservicesDomain + OriginalUri.PathAndQuery);
this.Url = dataCenterUri.ToString();
}
}

public void SetAccount(string account)

{
if (account == null || account.Length == 0)
account = "empty";

this.Url = OriginalUri.AbsoluteUri;
DataCenterUrls urls = getDataCenterUrls(account).dataCenterUrls;
Uri dataCenterUri = new Uri(urls.webservicesDomain + OriginalUri.PathAndQuery);
this.Url = dataCenterUri.ToString();
}
}

Java Sample

/**
* Since 12.2 endpoint accounts are located in multiple data centers with different domain names.

SuiteTalk SOAP Web Services Platform Guide

getDataCenterUrls 202

* To use the correct one, wrap the Locator and get the correct domain first.
*
* See getDataCenterUrls WSDL method documentation in the Help Center.
*/
private static class dataCenters extends NetSuiteServiceLocator
{
private String account;

public dataCenters (String account)

{
this.account = account;
}

@Override
public NetSuitePortType getNetSuitePort(URL defaultWsDomainURL)
{
try
{
NetSuitePortType _port = super.getNetSuitePort(defaultWsDomainURL);
// Get the webservices domain for your account
DataCenterUrls urls = _port.getDataCenterUrls(account).getDataCenterUrls();
String wsDomain = urls.getWebservicesDomain();

// Return URL appropriate for the specific account

return super.getNetSuitePort(new URL(wsDomain.concat(defaultWsDomainURL.getPath())));
}
catch (Exception e)
{
throw new RuntimeException(e);
}
}
}

---
// Locate the NetSuite web service.
NetSuiteServiceLocator service = new dataCenters ("myAccount");
// Get the service port (to the correct data center)
_port = service.getNetSuitePort(new URL("https://webservices.netsuite.com/services/NetSuitePort_2012_2"));

Java Sample

public void testDataCenterUrlsPublic() throws Exception

{
NLWsClient c = new NLWsClient();
c.initPort();
String account = "1326288";

System.out.println("Account: " + account);

DataCenterUrls urls = c.getPort().getDataCenterUrls(account).getDataCenterUrls();

System.out.println("\tREST domain: " + urls.getRestDomain());

System.out.println("\tWeb services domain: " + urls.getWebservicesDomain());
System.out.println("\tSystem domain: " + urls.getSystemDomain());
System.out.println();
}

SOAP Request

<?xml version="1.0" encoding="UTF-8"?>

SuiteTalk SOAP Web Services Platform Guide

getDataCenterUrls 203

</getDataCenterUrls>
</soapenv:Body>
</soapenv:Envelope>

SOAP Response

<?xml version="1.0" encoding="utf-8"?>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/
XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Header>
<platformMsgs:documentInfo xmlns:platformMsgs="urn:messages_2017_1.platform.webservices.netsuite.com">
<platformMsgs:nsId>WEBSERVICES_1326288_08162012790521873260264554_10fa27f165429</platformMsgs:nsId>
</platformMsgs:documentInfo>
</soapenv:Header>
<soapenv:Body>
<getDataCenterUrlsResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<getDataCenterUrlsReturn xsi:type="GetDataCenterUrlsResult" xmlns:platformCore="urn:core_2017_1.platform.webser
vices.netsuite.com">
<platformCore:status isSuccess="true"/>
<platformCore:dataCenterUrls>
<platformCore:restDomain>https://<accountID>.restlets.api.netsuite.com</platformCore:restDomain>
<platformCore:webservicesDomain>https://<accountID>.suitetalk.api.netsuite.com</platformCore:webservicesDomain>
<platformCore:systemDomain>https://<accountID>.app.netsuite.com</platformCore:systemDomain>
</platformCore:dataCenterUrls>
</getDataCenterUrlsReturn>
</getDataCenterUrlsResponse>
</soapenv:Body>
</soapenv:Envelope>

SOAP Response (empty account)

<?xml version="1.0" encoding="utf-8"?>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/
XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Header>
<platformMsgs:documentInfo xmlns:platformMsgs="urn:messages_2017_1.platform.webservices.netsuite.com">
<platformMsgs:nsId>WEBSERVICES__0911201212589142971204370270_d03cd34b349479541b</platformMsgs:nsId>
</platformMsgs:documentInfo>
</soapenv:Header>
<soapenv:Body>
<getDataCenterUrlsResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<getDataCenterUrlsReturn xsi:type="GetDataCenterUrlsResult" xmlns:platformCore="urn:core_2017_1.platform.webser
vices.netsuite.com">
<platformCore:status isSuccess="false">
<platformCore:statusDetail type="ERROR">
<platformCore:code>DATA_REQD</platformCore:code>
<platformCore:message>You need to provide a proper value for the required field: account.</platformCore:mes
sage>
</platformCore:statusDetail>
</platformCore:status>
</getDataCenterUrlsReturn>
</getDataCenterUrlsResponse>
</soapenv:Body>
</soapenv:Envelope>

getDeleted
You use the getDeleted operation to retrieve a list of deleted records. When you use this operation, you
can filter by record type, by script ID, and by the date of record deletion. For each record that matches the
filter criteria, the system returns the following data:

SuiteTalk SOAP Web Services Platform Guide

getDeleted 204

■ The record’s type

■ The record’s name
■ The record’s internal ID
■ The record’s external ID (if avalaible)
■ The date the record was deleted

The getDeleted operation can be useful when you want to synchronize information in a client application
with NetSuite. For example, an Outlook client application plug-in maintains a list of contacts and
synchronizes that list with NetSuite. The getDeleted operation can be used to determine contact deletions
since the last synchronization with NetSuite.

Permissions
By default, only account administrators and users with the Full Access role have permission to use
the getDeleted operation. However, you can grant permission to other roles. To use the getDeleted
operation, the role has to have the Deleted Records permission (and the Web Services permission).

Users who have the Deleted Records permission can access results about any type of record that
was deleted, even if they do not have permission to create or modify that record type. They also have
permission to use the Deleted Record search type in the user interface, unless the Web Services Only
option has been selected for the role.

You can give a role the Deleted Records permission by going to Setup > Users/Roles > Manage Roles. Go
to the Permissions > Setup subtab, and add a line for the permission.

Usage Notes
Note the following:

■ Not all record types support the getDeleted operation. For a complete list of supported record types
for this operation, refer to the DeletedRecordType enumeration in the coreTypes xsd.
■ Data about deleted records remains available indefinitely.
■ The getDeleted response does not differentiate between records deleted through SOAP web services
and through the UI.
■ Even though it is not a search, the getDeleted operation respects the pageSize search preference.
■ The getDeleted operation changed in 2015.1. If you are using the 2014.2 endpoint or earlier, refer to
the Platform Guide for your WSDL version. To obtain an older version of the platform guide, see the
help topic SOAP Web Services Archives.

Request
The GetDeletedRequest type is used for the request.

Element Name XSD Type Notes

getDeletedFilter GetDeletedFilter See GetDeletedFilter.

SuiteTalk SOAP Web Services Platform Guide

getDeleted 205

Element Name XSD Type Notes

pageIndex xsd: int Use this argument to specify which page of results to return in your
response. If there is only one page of results, enter 1.

GetDeletedFilter
The GetDeletedFilter lets you retrieve data based on the date, record type, and script ID of the deleted
records.

Element Name XSD Type Notes

deletedDate SearchDateField The date that the record was deleted. For example, you can
search for records that were deleted since a particular date or
between two dates.

type SearchEnumMultiSelectField The type of the record that was deleted. For a complete list of all
of the values currently supported by the getDeleted operation,
refer to the DeletedRecordType enumerations in the coreTypes
XSD.

scriptID SearchStringField The scriptID identifying the specific custom record or custom
transaction type. Use this field to narrow the results to custom
records (or custom transactions) only of that particular type.
If you do not specify a script ID, and rely only on the type field,
the operation returns details on all instances that were deleted,
regardless of type.

Response
The DeletedRecord type is used for the response.

Element Name XSD Type Notes

status Status The status for this operation. All applicable errors or warnings are listed
within this type.

totalRecords xsd: int The total number of records that meet the filter criteria.

pageSize xsd: int The total number of records listed on each page of the results.

totalPages xsd: int The total number of available pages.

pageIndex xsd: int The number identifying the current page of results.

deletedRecordList deletedRecordList A list of records that meet the filter criteria

Faults
This operation can throw any of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault

SuiteTalk SOAP Web Services Platform Guide

getDeleted 206

■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

Sample Code
The following sample shows how to retrieve details about deleted instances of a custom record type with
the script ID customrecord1. It specifies that 10 results should be returned per page, and it includes logic
to retrieve all pages.

Java

{
c.setSearchPrefsPageSize(10);

GetDeletedFilter filter = new GetDeletedFilter();

filter.setType(new SearchEnumMultiSelectField(new String[] {DeletedRecordType._customRecord}, SearchEnumMultiSelectFieldOpera
tor.anyOf));
filter.setScriptId(new SearchStringField("customrecord1", SearchStringFieldOperator.is));

GetDeletedResult result;
int i = 1;
do
{
result = c.m_port.getDeleted(filter, i);
if (i == 1)
{
System.out.println(String.format("Page Size : %d, Total Pages : %d, Total Records : %d", result.getPageSize(),
result.getTotalPages(), result.getTotalRecords()));
}
processDeletedRecordList(result.getDeletedRecordList());
System.out.println(String.format("Current Page Index : %d", result.getPageIndex()));
i++;
}
while (i <= result.getTotalPages());
}

getIntegrationGovernanceInfo
The getIntegrationGovernanceInfo operation can be used to retrieve the available concurrency limit for
the specific integration using the operation through SOAP web services.

The operation does not have any parameters and returns the value for concurrency limit and the limit
type.

The limit type can be:

■ _integrationSpecific, when a limit has been allocated to the integration.

■ _accountLimit, when no specific limit has been allocated to the integration.

SuiteTalk SOAP Web Services Platform Guide

getIntegrationGovernanceInfo 207

■ _internal, when it is an internal application. In this case the limit is not displayed.

With this information the integration can determine how many concurrent requests it can send.

Every integration should use this operation to get information about the available limit and to not exceed
the number of available threads that send requests to NetSuite.

Note: The operation will return results only if you are logged in as an administrator.

SOAP Request
<soapenv:Body>
<getIntegrationGovernanceInfo />
</soapenv:Body>

SOAP Response
<soapenv:Body>
<getIntegrationGovernanceInfoResponse>
<platformCore:getIntegrationGovernanceInfoResult>
<platformCore:status isSuccess="true"/>
<platformCore:integrationConcurrencyLimit>2</platformCore:integrationConcurrencyLimit>
<platformCore:limitType>_integrationSpecific</platformCore:limitType>
</platformCore:getIntegrationGovernanceInfoResult>
</getIntegrationGovernanceInfoResponse>
</soapenv:Body>

getItemAvailability
The getItemAvailability operation can be used to retrieve the inventory availability for a specific list of
items.

You can filter the returned list using a lastQtyAvailableChange filter. If set, only items with quantity
available changes recorded as of this date are returned.

If the Multi-Location Inventory feature is enabled, this operation returns results for all locations. For
locations that do not have any items available, only location IDs and names are listed in results.

Warning: This operation supports up to 10,000 records. If this limit is exceeded, an error is
returned.

Request
The GetItemAvailabilityRequest type is used for the request.

Element Name XSD Type Notes

itemAvailabilityFilter ItemAvailabilityFilter You can filter the returned itemAvailability using this filter.

SuiteTalk SOAP Web Services Platform Guide

getItemAvailability 208

ItemAvailabilityFilter

Element Name XSD Type Notes

item RecordRefList References an exiting item record in NetSuite.

lastQtyAvailableChange dateTime If set, only items with quantity available changes recorded as of the
specified date are returned.

Response
The GetItemAvailabilityResult type is used for the response.

Element Name XSD Type Notes

status Status The status for this operation. All applicable errors or warnings are listed within
this type.

itemAvailabilityList List Returns a list of available items.

ItemAvailabilityList

Element Name XSD Type Notes

item RecordRef References an existing item record.

lastQtyAvailableChange dateTime If set, only items with quantity available changes recorded as of this date
are returned.

locationId RecordRef References a location in a user defined list at Lists > Accounting >
Locations.

quantityOnHand double The number of units of an item in stock.

onHandValueMli double

reorderPoint double The stock level at which a new order for the item needs to be placed

preferredStockLevel double The preferred quantity of this item maintained in inventory for a specific
location.

quantityOnOrder double The number of units of an item pending receipt from a vendor.

quantityCommitted double The number of units of an item reserved by unfulfilled sales orders.

quantityBackOrdered double The number of units of an item reserved by unfulfilled sales orders.

quantityAvailable double The number of units in stock that have not been committed to fulfill sales.

ItemAvailabilityFilter

Element Name XSD Type Notes

item RecordRefList

lastQtyAvailableChange dateTime

SuiteTalk SOAP Web Services Platform Guide

getItemAvailability 209

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

Sample Code

SOAP Request (for C# sample)

<soap:Body>
<platformMsgs:getItemAvailability>
<platformMsgs:itemAvailabilityFilter>
<platformCore:item>
<platformCore:recordRef internalId="390" type="inventoryItem">
<platformCore:name/>
</platformCore:recordRef>
</platformCore:item>
<platformCore:lastQtyAvailableChange/>
</platformMsgs:itemAvailabilityFilter>
</platformMsgs:getItemAvailability>
</soap:Body>

SOAP Response (for C# sample)

<soapenv:Body>
<getItemAvailabilityResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<getItemAvailabilityResult xmlns="urn:core_2017_1.platform.webservices.netsuite.com">
<status isSuccess="true"/>
<itemAvailabilityList>
<itemAvailability>
<item internalId="390" type="inventoryItem">
<name>testItem</name>
</item>
<locationId internalId="1" type="location">
<name>East Coast</name>
</locationId>
<quantityOnHand>20.0</quantityOnHand>
<onHandValueMli>0.0</onHandValueMli>
<quantityCommitted>0.0</quantityCommitted>
<quantityAvailable>20.0</quantityAvailable>
</itemAvailability>
<itemAvailability>
<item internalId="390" type="inventoryItem">
<name>testItem</name>
</item>
<locationId internalId="2" type="location">
<name>West Coast</name>
</locationId>
</itemAvailability>
</itemAvailabilityList>

SuiteTalk SOAP Web Services Platform Guide

getItemAvailability 210

</getItemAvailabilityResult>
</getItemAvailabilityResponse>
</soapenv:Body>

C# Sample
private void getItemAvailability()
{
this.login(true);

RecordRef item1 = new RecordRef();

item1.internalId = "59";
item1.type = RecordType.inventoryItem;
item1.typeSpecified = true;

RecordRef[] recordrefs = new RecordRef[1];

recordrefs[0] = item1;

ItemAvailabilityFilter filter = new ItemAvailabilityFilter();

filter.item = recordrefs;
GetItemAvailabilityResult res = _service.getItemAvailability(filter);

Java Sample
public void getItemAvailability() throws RemoteException {
this.login(true);

RecordRef item1 = new RecordRef();

item1.setInternalId("25");
item1.setType(RecordType.inventoryItem);

RecordRef item2 = new RecordRef();

item2.setInternalId("76");
item2.setType(RecordType.giftCertificateItem);

RecordRef[] recordRefArray = new RecordRef[2];

recordRefArray[0] = item1;
recordRefArray[1] = item2;

RecordRefList itemRefList = new RecordRefList();

itemRefList.setRecordRef(recordRefArray);

ItemAvailabilityFilter itemAvailability = new ItemAvailabilityFilter();

itemAvailability.setItem(itemRefList);

GetItemAvailabilityResult response = _port.getItemAvailability(itemAvailability);

}

getList
The getList operation is used to retrieve a list of one or more records by providing the unique ids that
identify those records.

If there are multiple ids provided, they can either belong to the same record type or different record
types. For example, it is possible to retrieve a customer and a contact within a single request using this
operation.

If some of the provided ids are invalid, the request is still processed for the valid ids and the response will
contain a warning that indicates that some of the ids were invalid.

SuiteTalk SOAP Web Services Platform Guide

getList 211

Note: An asynchronous equivalent is available for this operation, asyncGetList. For information
about asynchronous request processing, see Synchronous Versus Asynchronous Request
Processing.

Request
The getListRequest type is used for the request. It contains the following fields.

Element Name XSD Type Notes

recordRef RecordRef An array of recordRef objects that specify the ids of the records to be retrieved.

Response
The getListResponse type is used for the response. It contains the following fields.

Element Name XSD Type Notes

status Status The status for this operation. All applicable errors or warnings are listed within
this type.

recordList Record[] A list of records that correspond to the specified ids. The actual records
returned need to be of a type that extends the abstract type Record.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

Sample Code

SOAP Request
In the following example, two records are retrieved — one customer record and one employee record.
Note that you must provide the internal ID of the specify instance of the record and the record type for
the getList.

<soap:Body>
<platformMsgs:getList>
<platformMsgs:baseRef internalId="983" type="customer" xsi:type="platformCore:RecordRef"/>
<platformMsgs:baseRef internalId="-5" type="employee" xsi:type="platformCore:RecordRef"/>
</platformMsgs:getList>

SuiteTalk SOAP Web Services Platform Guide

getList 212

</soap:Body>

SOAP Response
<soapenv:Body>
<getListResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<readResponseList xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<readResponse>
<ns1:status isSuccess="true" xmlns:ns1="urn:core_2017_1.platform.webservices.netsuite.com"/>
<record internalId="983" xsi:type="ns2:Customer" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ns2="urn:rela
tionships_2017_1.lists.webservices.netsuite.com">
<ns2:entityId>Shutter Fly</ns2:entityId>
<ns2:isInactive>false</ns2:isInactive>
<ns2:companyName>Shutter Fly, Inc</ns2:companyName>
.
...[more fields]
.
<ns2:customFieldList>
<ns6:customField internalId="265" scriptId="custentity_map" xsi:type="ns6:StringCustomFieldRef" xmlns:n
s6="urn:core_2017_1.platform.webservices.netsuite.com">
<ns6:value>http://maps.google.com</ns6:value>
</ns6:customField>
</ns2:customFieldList>
</record>
</readResponse>
<readResponse>
<ns8:status isSuccess="true" xmlns:ns8="urn:core_2017_1.platform.webservices.netsuite.com"/>
<record internalId="-5" xsi:type="ns9:Employee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ns9="urn:employ
ees_2017_1.lists.webservices.netsuite.com">
<ns9:entityId>A Wolfe</ns9:entityId>
<ns9:isInactive>false</ns9:isInactive>
.
...[more fields]
.
</record>
</readResponse>
</readResponseList>
</getListResponse>
</soapenv:Body>

C#
private int getCustomerList()
{
// This operation requires a valid session
this.login( true );

// Prompt for list of nsKeys and put in an array

_out.write( "\nnsKeys for records to retrieved (separated by commas): " );
String reqKeys = _out.readLn();
string [] nsKeys = reqKeys.Split( new Char[] {','} );

return getCustomerList( nsKeys, false );

}

Java
public int getCustomerList() throws RemoteException,
ExceededUsageLimitFault, UnexpectedErrorFault, InvalidSessionFault,
ExceededRecordCountFault {
// This operation requires a valid session
this.login(true);

// Prompt for list of nsKeys and put in an array

SuiteTalk SOAP Web Services Platform Guide

getList 213

_console
.write("\nnsKeys for records to retrieved (separated by commas): ");
String reqKeys = _console.readLn();
String[] nsKeys = reqKeys.split(",");

return getCustomerList(nsKeys, false);

}

getPostingTransactionSummary
The getPostingTransactionSummary operation lets you retrieve a summary of the actual data that posted
to the general ledger in an account. You can use available filters and fields to generate reports that
are similar to what you see when you run financial reports such as a Trial Balance, Balance Sheet, or an
Income Statement.

Note: For information about NetSuite financial reports and financial statements, see the
following topics:

■ Financial Reports
■ Financial Statements Overview

The getPostingTransactionSummary operation returns the fields defined in PostingTransactionSummary.

You can query by any filter defined in PostingTransactionSummaryFilter and group the results by any field
defined in PostingTransactionSummaryField.

The first call to the operation returns the first page, total number of hits (totalRecords), and the number of
pages. You can then retrieve subsequent pages by giving the page number.

Note: NetSuite caches the results after the first call to getPostingTransactionSummary as
subsequent pages are being retrieved. The cache is reset if the session expires, or if you make
another call to this operation with a page index of 1.

Also note the following:

■ This operation can only be executed in a role that has the Financial Statements permission assigned.
To enable this permission for a role, a NetSuite administrator must go to Setup > User Roles > Manage
Roles, click the Reports tab, select Financial Statments from the Permission list, and then click Save.
■ To search for null, specify -1. If the return is null, the element will be skipped (not -1).
■ A maximum of 10,000 expressions is supported. A request with more than this number of expressions
returns an error.
■ For large reports (for example, you have chosen all the columns), the query will take a long time on
first request, but subsequent requests will be fast. Make sure your timeout limit is set high.

Important: The information in the following paragraph pertains to NetSuite OneWorld

accounts only.

The amounts returned from getPostingTransactionSummary are in the currency of the subsidiary, not
the parent. If you want the amounts in the currency of the parent, you must programmatically apply
the appropriate exchange rate. To obtain exchange rates, you must call getConsolidatedExchangeRate,
which reads data from the Consolidated Exchange Rate table. In your code, you must then multiply
amount values returned by getPostingTransactionSummary by the exchange rate values returned by
getConsolidatedExchangeRate.

Although the NetSuite UI automatically consolidates all amounts, you must perform your own exchange
rate calculations in SOAP web services.

SuiteTalk SOAP Web Services Platform Guide

getPostingTransactionSummary 214

Note: You may want to do planning in your local currency, in which case there is no need for
exchange rate conversions.

Request
The GetPostingTransactionSummaryRequest type is used for the request.

Element Name XSD Type Notes

fields PostingTransactionSummaryField Specify how you want your data grouped.

filters PostingTransactionSummaryFilter Specify your filtering criteria.

pageIndex xsd:int Specify the page to be returned.

PostingTransactionSummaryField

Element Name XSD Type Notes

period RecordRef Specify to group data by period.

account RecordRef Specify to group data by account.

parentItem RecordRef Specify to group data by parent item.

item RecordRef Specify to group data by item.

customer RecordRef Specify to group data by customer.

department RecordRef Specify to group data by department.

class RecordRef Specify to group data by class.

location RecordRef Specify to group data by location.

subsidiary RecordRef Specify to group data by subsidiary.

book RecordRef If you use the Multi-Book Accounting feature, specify to group data by
accounting book.

PostingTransactionSummaryFilter

Element Name XSD Type Notes

period RecordRef Filter your request by period.

account RecordRef Filter your request by account.

parentItem RecordRef Filter your request by parent item.

item RecordRef Filter your request by item.

customer RecordRef Filter your request by customer.

department RecordRef Filter your request by department.

class RecordRef Filter your request by class.

SuiteTalk SOAP Web Services Platform Guide

getPostingTransactionSummary 215

Element Name XSD Type Notes

location RecordRef Filter your request by location.

subsidiary RecordRef Filter your request by subsidiary.

book RecordRef If you use the Multi-Book Accounting feature, filter your request by accounting
book.

Response
The GetPostingTransactionSummaryResult type is used for the response.

Element Name XSD Type Notes

status Status The status for this operation. All applicable

errors or warnings are listed within this
type.

totalRecords xsd:int The total number of records for this

search. Depending on the pageSize value,
some or all the records may be returned
in this response.

pageSize xsd:int The page size for this search.

totalPages xsd:int The total number of pages that are part of

this search.

pageIndex xsd:int The page index for the current set of

results.

postingTransactionSummaryList PostingTransactionSummaryList Returns a list of available transaction

summary results based on filters defined
in your request.

PostingTransactionSummaryList

Element Name XSD Type Notes

postingTransactionSummary PostingTransactionSummary Returns a list of available transactions that are

filtered by and grouped by values specified
in PostingTransactionSummaryField and
PostingTransactionSummaryFilter.

PostingTransactionSummary

Element Name XSD Type Notes

period RecordRef Returns a summary based on period.

account RecordRef Returns a summary based on account.

parentItem RecordRef Returns a summary based on parent item.

item RecordRef Returns a summary based on item.

SuiteTalk SOAP Web Services Platform Guide

getPostingTransactionSummary 216

Element Name XSD Type Notes

customer RecordRef Returns a summary based on customer.

department RecordRef Returns a summary based on department.

class RecordRef Returns a summary based on class.

location RecordRef Returns a summary based on location.

subsidiary RecordRef Returns a summary based on subsidiary.

book RecordRef If you use the Multi-Book Accounting feature, specify to group data by
accounting book.

amount double Returns a summary based on amount.

Important: This argument is required.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

Sample Code

Example One
The sample provided shows how to get and print account values using the
getPostingTransactionSummary operation.

Java

/* Make Record Ref out of an internalId */

public static RecordRef mrr(String internalId)
{
RecordRef toRet = new RecordRef();
toRet.setInternalId(internalId);
return toRet;
}

public void testPostingActivity() throws Exception

{
//c.setHttpPort(80);
c.login();
PostingTransactionSummaryField pagb = new PostingTransactionSummaryField();

SuiteTalk SOAP Web Services Platform Guide

getPostingTransactionSummary 217

pagb.setParentItem(Boolean.TRUE);

/*
pagb.set_class(Boolean.FALSE);
pagb.setItem(Boolean.FALSE);
pagb.setCustomer(Boolean.FALSE);
pagb.setLocation(Boolean.FALSE);
*/

PostingTransactionSummaryFilter paf = new PostingTransactionSummaryFilter();

//paf.setAccount(new RecordRefList(new RecordRef[]{mrr("5"),mrr("12")}));
long start = System.currentTimeMillis();
GetPostingTransactionSummaryResult res = c.getPort().getPostingTransactionSummary(pagb, paf, 1);

for (int i=0; i<10; i++)

{
if (res.getPostingTransactionSummaryList().getPostingTransactionSummary(i).getAccount() != null)
System.out.println("Account:" + res.getPostingTransactionSummaryList().getPostingTransactionSummary(i).getAccount().getInter
nalId());
if (res.getPostingTransactionSummaryList().getPostingTransactionSummary(i).getPeriod() != null)
System.out.println("Period:" + res.getPostingTransactionSummaryList().getPostingTransactionSummary(i).getPeriod().getInternalId());
if (res.getPostingTransactionSummaryList().getPostingTransactionSummary(i).getCustomer() != null)
System.out.println("Customer:" + res.getPostingTransactionSummaryList().getPostingTransactionSummary(i).getCustomer().getInter
nalId());
if (res.getPostingTransactionSummaryList().getPostingTransactionSummary(i).get_class() != null)
System.out.println("_class:" + res.getPostingTransactionSummaryList().getPostingTransactionSummary(i).get_class().getInternalId());
if (res.getPostingTransactionSummaryList().getPostingTransactionSummary(i).getDepartment() != null)
System.out.println("Department:" + res.getPostingTransactionSummaryList().getPostingTransactionSummary(i).getDepartment().getInter
nalId());
if (res.getPostingTransactionSummaryList().getPostingTransactionSummary(i).getLocation() != null)
System.out.println("Location:" + res.getPostingTransactionSummaryList().getPostingTransactionSummary(i).getLocation().getInter
nalId());
if (res.getPostingTransactionSummaryList().getPostingTransactionSummary(i).getSubsidiary() != null)
System.out.println("Subsidiary:" + res.getPostingTransactionSummaryList().getPostingTransactionSummary(i).getSubsidiary().getInter
nalId());
if (res.getPostingTransactionSummaryList().getPostingTransactionSummary(i).getItem() != null)
System.out.println("Item:" + res.getPostingTransactionSummaryList().getPostingTransactionSummary(i).getItem().getInternalId());
System.out.println("Amount:" + res.getPostingTransactionSummaryList().getPostingTransactionSummary(i).getAmount());
}
for (int i=res.getPageIndex(); i<res.getTotalPages(); i++)
{
System.err.println("Elapsed Time : " + (System.currentTimeMillis() - start));
res = c.getPort().getPostingTransactionSummary(pagb,paf,i+1);
}
System.err.println("Elapsed Time : " + (System.currentTimeMillis() - start));
GetPostingTransactionSummaryResult p = c.getPort().getPostingTransactionSummary(pagb, paf, res.getTotalPages()+2);
assertFalse(p.getStatus().isIsSuccess());
}

Example Two
The following SOAP and Java show how to get the posting activity for posting period 109. The sample
prints the unconsolidated and consolidated amounts in the parent subsidiary by child subsidiary and
account – for example, if subsidiary 2 is in Euros and subsidiary 1, the parent company, is in dollars, show
the amount in Euros and the amount in dollars for that account in period 109.

SOAP Request

<soapenv:Body>
<getPostingTransactionSummary xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<fields>
<ns6:period xmlns:ns6="urn:core_2017_1.platform.webservices.netsuite.com">true</ns6:period>
<ns7:account xmlns:ns7="urn:core_2017_1.platform.webservices.netsuite.com">true</ns7:account>
<ns8:subsidiary xmlns:ns8="urn:core_2017_1.platform.webservices.netsuite.com">true<ns8:subsidiary >
</fields>
<filters>
<ns9:period xmlns:ns9="urn:core_2017_1.platform.webservices.netsuite.com">
<ns9:recordRef internalId="109"/>

SuiteTalk SOAP Web Services Platform Guide

getPostingTransactionSummary 218

</ns9:period>
</filters>
<pageIndex>1</pageIndex>
</getPostingTransactionSummary>
</soapenv:Body>

SOAP Reponse

<soapenv:Body>
<getPostingTransactionSummaryResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<platformCore:getPostingTransactionSummaryResult xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuit
e.com">
<platformCore:status isSuccess="true"/>
<platformCore:totalRecords>19</platformCore:totalRecords>
<platformCore:pageSize>1000</platformCore:pageSize>
<platformCore:totalPages>0</platformCore:totalPages>
<platformCore:pageIndex>1</platformCore:pageIndex>
<platformCore:postingTransactionSummaryList>
<platformCore:postingTransactionSummary>
<platformCore:period internalId="109"/>
<platformCore:account internalId="2"/>
<platformCore:subsidiary internalId="1"/>
<platformCore:amount>500.0</platformCore:amount>
</platformCore:postingTransactionSummary>
<platformCore:postingTransactionSummary>
<platformCore:period internalId="109"/>
<platformCore:account internalId="6"/>
<platformCore:subsidiary internalId="1"/>
<platformCore:amount>19.0</platformCore:amount>
</platformCore:postingTransactionSummary>
<platformCore:postingTransactionSummary>
<platformCore:period internalId="109"/>
<platformCore:account internalId="6"/>
<platformCore:subsidiary internalId="2"/>
<platformCore:amount>5.0</platformCore:amount>
</platformCore:postingTransactionSummary>
<platformCore:postingTransactionSummary>
<platformCore:period internalId="109"/>
<platformCore:account internalId="6"/>
<platformCore:subsidiary internalId="4"/>
<platformCore:amount>6.0</platformCore:amount>
</platformCore:postingTransactionSummary>
<platformCore:postingTransactionSummary>
<platformCore:period internalId="109"/>
<platformCore:account internalId="6"/>
<platformCore:subsidiary internalId="8"/>
<platformCore:amount>-3.0</platformCore:amount>
</platformCore:postingTransactionSummary>
<platformCore:postingTransactionSummary>
<platformCore:period internalId="109"/>
<platformCore:account internalId="16"/>
<platformCore:subsidiary internalId="6"/>
<platformCore:amount>-4.0</platformCore:amount>
</platformCore:postingTransactionSummary>
<platformCore:postingTransactionSummary>
<platformCore:period internalId="109"/>
<platformCore:account internalId="24"/>
<platformCore:subsidiary internalId="8"/>
<platformCore:amount>-100.0</platformCore:amount>
</platformCore:postingTransactionSummary>
<platformCore:postingTransactionSummary>
<platformCore:period internalId="109"/>
<platformCore:account internalId="58"/>
<platformCore:subsidiary internalId="8"/>
<platformCore:amount>100.0</platformCore:amount>
</platformCore:postingTransactionSummary>
<platformCore:postingTransactionSummary>
<platformCore:period internalId="109"/>
<platformCore:account internalId="112"/>
<platformCore:subsidiary internalId="1"/>
<platformCore:amount>-496.0</platformCore:amount>

SuiteTalk SOAP Web Services Platform Guide

getPostingTransactionSummary 219

</platformCore:postingTransactionSummary>
<platformCore:postingTransactionSummary>
<platformCore:period internalId="109"/>
<platformCore:account internalId="112"/>
<platformCore:subsidiary internalId="5"/>
<platformCore:amount>-1.0</platformCore:amount>
</platformCore:postingTransactionSummary>
<platformCore:postingTransactionSummary>
<platformCore:period internalId="109"/>
<platformCore:account internalId="139"/>
<platformCore:subsidiary internalId="4"/>
<platformCore:amount>-9.0</platformCore:amount>
</platformCore:postingTransactionSummary>
<platformCore:postingTransactionSummary>
<platformCore:period internalId="109"/>
<platformCore:account internalId="142"/>
<platformCore:subsidiary internalId="8"/>
<platformCore:amount>3.0</platformCore:amount>
</platformCore:postingTransactionSummary>
<platformCore:postingTransactionSummary>
<platformCore:period internalId="109"/>
<platformCore:account internalId="145"/>
<platformCore:subsidiary internalId="5"/>
<platformCore:amount>1.0</platformCore:amount>
</platformCore:postingTransactionSummary>
<platformCore:postingTransactionSummary>
<platformCore:period internalId="109"/>
<platformCore:account internalId="148"/>
<platformCore:subsidiary internalId="2"/>
<platformCore:amount>-5.0</platformCore:amount>
</platformCore:postingTransactionSummary>
<platformCore:postingTransactionSummary>
<platformCore:period internalId="109"/>
<platformCore:account internalId="153"/>
<platformCore:subsidiary internalId="6"/>
<platformCore:amount>4.0</platformCore:amount>
</platformCore:postingTransactionSummary>
<platformCore:postingTransactionSummary>
<platformCore:period internalId="109"/>
<platformCore:account internalId="155"/>
<platformCore:subsidiary internalId="1"/>
<platformCore:amount>-23.0</platformCore:amount>
</platformCore:postingTransactionSummary>
<platformCore:postingTransactionSummary>
<platformCore:period internalId="109"/>
<platformCore:account internalId="175"/>
<platformCore:subsidiary internalId="4"/>
<platformCore:amount>3.0</platformCore:amount>
</platformCore:postingTransactionSummary>
<platformCore:postingTransactionSummary>
<platformCore:period internalId="109"/>
<platformCore:account internalId="186"/>
<platformCore:subsidiary internalId="8"/>
<platformCore:amount>0.0</platformCore:amount>
</platformCore:postingTransactionSummary>
<platformCore:postingTransactionSummary>
<platformCore:period internalId="109"/>
<platformCore:account internalId="187"/>
<platformCore:subsidiary internalId="8"/>
<platformCore:amount>0.0</platformCore:amount>
</platformCore:postingTransactionSummary>
</platformCore:postingTransactionSummaryList>
</platformCore:getPostingTransactionSummaryResult>
</getPostingTransactionSummaryResponse>
</soapenv:Body>

Java

/* Make Record Ref out of an internalId */

public static RecordRef mrr(String internalId)

SuiteTalk SOAP Web Services Platform Guide

getPostingTransactionSummary 220

{
RecordRef toRet = new RecordRef();
toRet.setInternalId(internalId);
return toRet;
}

public void testPostingWorkflow() throws Exception

{
c.setCredentials(CRED_DB96_SIC);
c.useRequestLevelCredentials();

// Show and group by subsidiary, period and account.

// These are basic columns. If you do not include account,
// all amounts will be 0.
PostingTransactionSummaryField pagb = new PostingTransactionSummaryField();
pagb.setSubsidiary(Boolean.TRUE);
pagb.setPeriod(Boolean.TRUE);
pagb.setAccount(Boolean.TRUE);

PostingTransactionSummaryFilter paf = new PostingTransactionSummaryFilter();

paf.setPeriod(new RecordRefList(new RecordRef[]{mrr("109")}));
GetPostingTransactionSummaryResult gestalt =
c.getPort().getPostingTransactionSummary(pagb,paf,1);
ConsolidatedExchangeRateFilter f = new ConsolidatedExchangeRateFilter();
f.setPeriod(mrr("109"));
f.setToSubsidiary(mrr("1"));
GetConsolidatedExchangeRateResult cerr = c.getPort().getConsolidatedExchangeRate(f);

for (PostingTransactionSummary unConsolidated :

gestalt.getPostingTransactionSummaryList().getPostingTransactionSummary())
{
ConsolidatedExchangeRate rate = null;
for (ConsolidatedExchangeRate testRate :
cerr.getConsolidatedExchangeRateList().getConsolidatedExchangeRate())
{
if
(testRate.getFromSubsidiary().getInternalId().equals
(unConsolidated.getSubsidiary().getInternalId()))
{
rate = testRate;
break;
}
}
if (rate == null)
continue; // the Target Subsidiary will not have a conversion rate to itself.
System.out.println("\n\nFor Subsidiary: " + unConsolidated.getSubsidiary().getInternalId() +
" to Consolidated Parent (1).\nPeriod: " + unConsolidated.getPeriod().getInternalId() +
"\nAccount Id: " + unConsolidated.getAccount().getInternalId() +
"\nUnconsolidated Amount is: " + unConsolidated.getAmount() +
"\nConsolidated Amounts are (Avg/Historical/Current): "
+ (unConsolidated.getAmount()*rate.getAverageRate()) + " / " +
(unConsolidated.getAmount()*rate.getHistoricalRate()) + " / " +
(unConsolidated.getAmount()*rate.getCurrentRate()));
}
}

getSavedSearch
This operation allows users to retrieve a list of existing saved search IDs on a per-record-type basis (for
example, all saved search IDs for every Customer saved search). Note that after you retrieve the list of
saved search IDs, you may need to look in the NetSuite UI to see the criteria defined for the saved search.
To navigate to the list of saved searches in the NetSuite UI, go to Lists > Search > Saved Searches.

This API takes a search record type as a request argument and returns a list of record references of the
saved search. For each saved search, the response includes the internalId, scriptId, and name.

For use cases explaining why you would want to get a list of saved search IDs and then reference a
specific ID in your code, see Reference Existing Saved Searches.

SuiteTalk SOAP Web Services Platform Guide

getSavedSearch 221

Note: There is no async equivalent for this operation.

Request
The GetSavedSearchRequest type is used for the request. It contains the following fields.

Element Name XSD Type Notes

record GetSavedSearchRecord

Response
The GetSavedSearchResponse type is used for the response. It contains the following fields.

Element Name XSD Type Notes

status Status The status for this operation. All applicable errors or warnings are listed within
this type.

totalRecords xsd:int The total number of records for this search. Depending on the pageSize value,
some or all the records may be returned in this response

recordRefList Record[] A list of records that correspond to the specified ids. The actual records
returned need to be of a type that extends the abstract type Record.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

Sample Code

C#
GetSavedSearchRecord record = new GetSavedSearchRecord();
record.searchTypeSpecified = true;
record.searchType = SearchRecordType.transaction;

_service.getSavedSearch(record);
;

SuiteTalk SOAP Web Services Platform Guide

getSavedSearch 222

Java
public void getSavedSearches() throws RemoteException{
this.login(true);

GetSavedSearchRecord record = new GetSavedSearchRecord();

record.setSearchType(SearchRecordType.transaction);

GetSavedSearchResult result = _port.getSavedSearch(record);

}

SOAP Request
<soap:Body>
<getSavedSearch xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<record searchType="transaction"/>
</getSavedSearch>
</soap:Body>

SOAP Response
<soapenv:Body>
<getSavedSearchResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<platformCore:getSavedSearchResult xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com">
<platformCore:status isSuccess="true"/>
<platformCore:totalRecords>5</platformCore:totalRecords>
<platformCore:recordRefList>
<platformCore:recordRef xsi:type="platformCore:CustomizationRef" internalId="26" scriptId="customsearch26">
<platformCore:name>Custom Transaction Search</platformCore:name>
</platformCore:recordRef>
<platformCore:recordRef xsi:type="platformCore:CustomizationRef" internalId="27" scriptId="customsearch27">
<platformCore:name>CC Transaction Search</platformCore:name>
</platformCore:recordRef>
<platformCore:recordRef xsi:type="platformCore:CustomizationRef" internalId="42" scriptId="customsearch42">
<platformCore:name>Returned Items</platformCore:name>
</platformCore:recordRef>
<platformCore:recordRef xsi:type="platformCore:CustomizationRef" internalId="44" scriptId="customsearch44">
<platformCore:name>Ordered More than One Item</platformCore:name>
</platformCore:recordRef>
<platformCore:recordRef xsi:type="platformCore:CustomizationRef" internalId="46" scriptId="customsearch46">
<platformCore:name>Spending Account Average</platformCore:name>
</platformCore:recordRef>
</platformCore:recordRefList>
</platformCore:getSavedSearchResult>
</getSavedSearchResponse>
</soapenv:Body>

getSelectValue
Use the getSelectValue operation to retrieve valid select options for a particular RecordRef,
CustomRecordRef, or enumerated static field. This is useful if you are writing an application UI that needs
to mimic NetSuite UI logic, if the referenced record type is not yet exposed in SOAP web services, or when
the logged-in user's role does not have permission to the instances of the referenced record type. A call
to getSelectValue may return different results for the same field for different roles.
The getSelectValue operation can be used on standard body fields and custom body fields. It can also be
used on sublist fields that appear on both standard and custom records.
These topics describe each aspect of the operation:

■ GetSelectValue Overview

SuiteTalk SOAP Web Services Platform Guide

getSelectValue 223

■ Paginating Select Values

■ Filtering Select Value Text
■ Getting Dependent Select Values
■ Sample Code

Important: If you reference a field or a select value that is renamed in future versions of
NetSuite, your requests will still be handled, however, a warning will be returned. Also, when
working with this operation be aware of any special permissions applied to a field. For example,
a permission error will be thrown if you attempt to get select values on a field that has been
disabled on a form.

Note: The getSelectValue operation will not return the following values: "" , (blank), -1,
-New-, -2, -Custom-.

GetSelectValue Overview
The following figure shows a RecordRef field (Company) as displayed in the user interface, along with a list
of select values for this field. You can use getSelectValue to return the entire list of values or a subset of
values.

In accounts where there are levels of field dependencies, such as OneWorld accounts, you can use
getSelectValue to get select values for field “B” based on the value of field “A”. The following screenshot
shows an employee record in a OneWorld account. The select values associated with the Department field
are based on the value specified in the Subsidiary field. In this scenario, you can use getSelectValue to
get the values on the Department field by specifying the internal ID of its filterBy (“master”) field, which is
Subsidiary (internal ID —subsidiary). For more information, see Getting Dependent Select Values.

SuiteTalk SOAP Web Services Platform Guide

getSelectValue 224

Running getSelectValue against records that are created from other records may result in an
INSUFFICIENT_PERMISSION error.

Paginating Select Values

The first call to getSelectValue returns the total number of select values for the specified field. If you
choose, you can return a subset of those values by specifying a pageIndex number in the request.

Note: To define a page size, set the pageSize element in the SearchPreference type. The value
must be greater than 10 and less than the system-defined maximum of 1,000. If the number of
select values exceeds the page size, the remaining results must be retrieved in subsequent calls
getSelectValue with a new pageIndex value.

Filtering Select Value Text

To help end users pick from a long list of select values, you can use the contains, startsWith,
or is search operators to filter the results returned by getSelectValue. The filter element in the
GetSelectValueFieldDescription object lets you set the operator type in your request.

<complexType name=" GetSelectValueFieldDescription ">

Getting Dependent Select Values

The getSelectValue operation can also be used to get select values that are available on the condition of
other field values. For example, in OneWorld accounts the values that appear in many dropdown fields
are based on the values specified for either Customer or Subsidiary. As another example, on the Item
sublist of a Sales Order, the values for the Tax Code field depend on both customer and item values.

In your getSelectValue call, you will use the GetSelectFilterByFieldValueList and

GetSelectFilterByFieldValue objects to specify the filterBy field of a dependent field. (The dependent
field is the field you want to get the values for. The filterBy field is the field that controls which values are
available for the dependent field.)

<complexType name=" GetSelectFilterByFieldValueList ">

SuiteTalk SOAP Web Services Platform Guide

getSelectValue 225

<element name="filterBy" type="platformCore:GetSelectFilterByFieldValue" minOccurs="1" maxOccurs="unbounded"/>

</sequence>
</complexType>
<complexType name=" GetSelectFilterByFieldValue ">
<sequence>
<element name=" sublist " type="xsd:string" minOccurs="0" maxOccurs="1"/>
<element name=" field " type="xsd:string" minOccurs="1" maxOccurs="1"/>
<element name=" internalId " type="xsd:string" minOccurs="1" maxOccurs="1"/>
</sequence>
</complexType>

The sublist, field, and internalId arguments will contain:

■ the name of the sublist the filterBy field appears on (if it appears on a sublist)
■ the schema name of the filterBy field (for example, “entity”)
■ the internalId of the specific entity record (for example, “87”)

A getSelectValue call for a dependent field with no filterBy (“master”) field specified returns 0 records. This
type of call also returns a warning that notes the filterBy field, so the call can be corrected.

Important: Currently there is no programmatic way to discover what the filterBy field is for
another field. Note, however, on transaction records the Customer ( entity ) field is always the
filterBy field for any dependent RecordRef field. For all other record types, you must use the UI to
see which field is the filterBy field.

Request
The getSelectValueRequest type is used for the request. It contains the following elements.

Element Name XSD Type Notes

fieldDescription GetSelectValueFieldDescription Use to specify all characteristics of the field containing the
select values. For example, depending on the field and the
values you want returned, you will specify the names or
internalIds for the record type, sublist, and field. You may
also specify filtering criteria to refine the select options
returned in the response.

pageIndex xsd: int For select values that span multiple pages, use this
argument to specify which page to return in your
response.

GetSelectValueFieldDescription

Element Name XSD Type Notes

recordType RecordType Specify a record defined in coreTypes.xsd

customRecordType RecordRef If you are getting select values for a field appearing on a
custom record, specify the internal or external ID of the
custom record, as well as the custom record type.

sublist xsd:string If getting select values for a field on a sublist, you must
specify the sublist name (as it is defined in the schema).
Sublist names are those names that appear toward the

SuiteTalk SOAP Web Services Platform Guide

getSelectValue 226

Element Name XSD Type Notes

bottom of a record schema and are appended with List,
for example itemList, saleTeamList, timeList.

field xsd:string Specify a field name, as defined in the schema for that
record. The field value can represent either a body field or
a sublist field.

customForm RecordRef If the RecordRef or CustomRecordRef field is associated

with a custom form, specify the internal or external ID of
the custom form, as well as the custom form type.

filter GetSelectValueFilter If you choose, you can filter select options using the
contains, is, or startsWith operator. Use any of these
operators to return a subset of the options associated
with the RecordRef or CustomRecordRef field.

For example, to get a specific list of customers on an

opportunity record, you can search for “Adam” with the
contains operator to get only customers whose name
contains Adam.

■ sublist – If the filterBy field is on a sublist, you will

specify the name of the sublist containing this field.
Sublist names are appended with List (for example
item List ).
■ field – The name of the filterBy field (for example,
entity or subsidiary ).
■ internalId – The internalId value of the filterBy field
(for example, “87” or “112”). If the filterBy field on an
Opportunity record is Customer, you would specify:
sublist = null
field = “entity”
internalId = “87” (87 being the internalId of a specific
customer record, such as the Abe Simpson customer
record)

If a getSelectValue call does not return a warning, but

also does not return any values, make sure you have
specified all required filterByValueList values. To better
understand which filterByValueList values are required in
a record, go to a new record form in the UI. On the form
you can see what other fields you must fill in, before your
target field can get a value. The values in these fields are
the required filterByValueList values you must specify.

Response
The getSelectValueResponse type is used for the response. It contains the following elements.

Element Name XSD Type Notes

status Status The status for this operation. All applicable errors or warnings are listed within
this type.

SuiteTalk SOAP Web Services Platform Guide

getSelectValue 227

Element Name XSD Type Notes

totalRecords xsd:int The total number of record references for this search. Depending on the
pageSize value, some or all the references may be returned in the response.

totalPages xsd:int The total number of pages for this search. Depending on the pageSize value,
some or all the pages may be returned in this response.

baseRefList BaseRef[] An array of baseRefs that references existing NetSuite records, including
custom records. These baseRefs represent the valid values available for the
current field.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

Sample Code

SOAP Request

<?xml version="1.0" encoding="UTF-8"?><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org soap/envelope/" xmlns:xsd="http://

www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001 XMLSchema-instance">
<soapenv:Header>
<ns1:passport soapenv:actor="http://schemas.xmlsoap.org/soap/actor/next" soapenv:mustUnderstand="0" xmlns:ns1="urn:mes
sages_2017_1.platform.webservices.netsuite.com">
<ns2:email xmlns:ns2="urn:core_2017_1.platform.webservices.netsuite.com">[email protected]<ns2:email >
<ns3:password xmlns:ns3="urn:core_2017_1.platform.webservices.netsuite.com"><SOAP web services password><ns3:password >
<ns4:account xmlns:ns4="urn:core_2017_1.platform.webservices.netsuite.com">000071</ns4:account
<ns5:role internalId="37" xmlns:ns5="urn:core_2017_1.platform.webservices.netsuite.com"/>
</ns1:passport>
</soapenv:Header>
<soapenv:Body>
<getSelectValue xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<fieldDescription>
<ns6:recordType xmlns:ns6="urn:core_2017_1.platform.webservices.netsuite.com">salesOrder<ns6:recordType >
<ns7:sublist xmlns:ns7="urn:core_2017_1.platform.webservices.netsuite.com">itemList</ns7:sublist>
<ns8:field xmlns:ns8="urn:core_2017_1.platform.webservices.netsuite.com">item</ns8:field>
<ns9:filterByValueList xmlns:ns9="urn:core_2017_1.platform.webservices.netsuite.com">
<ns9:filterBy>
<ns9:field>entity</ns9:field>
<ns9:internalId>8</ns9:internalId>
</ns9:filterBy>
</ns9:filterByValueList>
</fieldDescription>
<pageIndex>1</pageIndex>
</getSelectValue>
</soapenv:Body>

SuiteTalk SOAP Web Services Platform Guide

getSelectValue 228

</soapenv:Envelope>

Java
This sample shows how to get select values for the Item field that appears on the Item sublist of a Sales
Order record.

In this sample the variable “c” is a shortcut for the application that needs to communicate with NetSuite
via SOAP Web Services. For more information on building an application, see SOAP Web Services Quick
Start.

GetSelectFilterByFieldValueList myFilterByList = new GetSelectFilterByFieldValueList(new

GetSelectFilterByFieldValue[]{new GetSelectFilterByFieldValue(null,"entity","8")});

GetSelectValueFieldDescription myGSVField = new GetSelectValueFieldDescription(RecordType.salesOrder,

null, "itemList", "item", null, null, myFilterByList);

BaseRef[] br = c.getSelectValue(myGSVField);

getServerTime
This operation takes no arguments and returns the NetSuite server time in GMT, regardless of a user's
time zone. Developers do not have to rely on client time when writing synchronization procedures
because the client time may not be in synch with the NetSuite server time.

If you choose, you can write client code that takes the GMT returned by NetSuite and convert the time
to your local time zone. The format of the dateTime value returned by getServerTime contains integer-
valued year, month, day, hour and minute properties, a decimal-valued second property and a boolean
time-zoned property (timestamp) – for example, 2005-09-21T15:24:00.000-07:00, where 2005-09-21 is the
date, 15:24:00.000 is the time and -07:00 is your own time zone offset, if you choose to set one.

Any user with an active session can call getServerTime. There are no explicit permissions for this
operation. For example, if you need to synchronize customer data with NetSuite, you can call
getServerTime to initialize your synchronization process. To synchronize new or changed customers
records, you can search customers and filter by lastModifiedDate using the value returned in
getServerTime. To synchronize deleted customer records, you can call the getDeleted operation and use
the value returned in getServerTime. This makes your synchronization process independent of your client
time,which may not be in sync with the NetSuite server time and hence the timestamp we use to track
changes.

Request
The GetServerTimeRequest type is used for the request. It takes no arguments.

Response
The GetServerTimeResponse type is used for the response. It contains the following elements.

Element Name XSD Type Notes

response GetServerTimeResult See GetServerTimeResult, below.

SuiteTalk SOAP Web Services Platform Guide

getServerTime 229

GetServerTimeResult
The GetServerTimeResult type contains the following elements.

Element Name XSD Type Notes

status Status The status for this request. All applicable errors or warnings will be listed within
this type, which is defined in the platformCore XSD.

serverTime dateTime dateTime value returned is in GMT.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ UnexpectedErrorFault

Sample Code

Java

public void testGetServerTime() throws Exception

{
c.login();

GetServerTimeResult rs = c.getPort().getServerTime();
System.out.println("Welcome to NetSuite. At the sound of the tone the NetSuite time will be : " + new
SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(rs.getServerTime().getTime()));

System.out.println("This compares with a client time of " + new SimpleDateFormat("yyyy-MM-dd

HH:mm:ss").format(Calendar.getInstance().getTime() ));
System.out.println("This represents a skew of " + (Calendar.getInstance().getTimeInMillis()
rs.getServerTime().getTimeInMillis() )/1000 + " seconds from netsuite
(where positive time means the client clock is comparatively fast).");
}

initialize / initializeList
Use the initialize operation to emulate the UI workflow by prepopulating fields on transaction line items
with values from a related record. Your SOAP web services application can then modify only the values it
needs to before submitting the record.

For example, in the UI clicking Bill from a Sales Order record loads an Invoice record where fields are
populated with values from the Sales Order. When loading an invoice record in SOAP web services, you
can reference the related Sales Order record to initialize fields with values from that sales order.

SuiteTalk SOAP Web Services Platform Guide

initialize / initializeList 230

Note: An asynchronous equivalent is available for the initializeList operation, asyncInitializeList.

For information about asynchronous request processing, see Synchronous Versus Asynchronous
Request Processing.

The following table lists all the transaction types that can be used with the initialize operation and the
valid reference types they can use.

(Target Record) Initialize Reference Notes

Transaction Type

Assembly Unbuild Assembly Build

Cash Refund Cash Sale

Cash Refund Return Authorization

Cash Sale Customer Populates Billable tabs

Cash Sale Estimate

Cash Sale Opportunity

Cash Sale Sales Order

Credit Memo Customer

Credit Memo Invoice

Credit Memo Return Authorization

Customer Deposit Sales Order

Customer Payment Customer Use the arAccount parameter to specify the accounts receivable
(AR) account in a Customer to Customer Payment initialization. (This
parameter is define in InitializeAuxRefType.)

Customer Payment Invoice

Customer Refund Credit Memo

Customer Refund Customer

Deposit Application Customer Deposit

Estimate Opportunity

Invoice Customer Defaults billable time, expense, and items

Invoice Estimate

Invoice Opportunity

Invoice Sales Order Defaults the line items as well as billable time, expense, and items

Item Fulfillment Intercompany

Transfer Order

Item Fulfillment Sales Order Defaults the line items for fulfillment

Item Fulfillment Transfer Order The line field on a transfer order does not have to correspond to the
orderLine field on a newly created item fulfillment.

Item Fulfillment Vendor Return

Authorization

SuiteTalk SOAP Web Services Platform Guide

initialize / initializeList 231

(Target Record) Initialize Reference Notes

Transaction Type

Item Receipt Intercompany

Transfer Order

Item Receipt Purchase Order Initializing an item receipt from a dropship purchase order is not
supported. The recommended workflow is to initialize an item
fulfillment from the sales order that has the dropship item. The
accounting impact will be the same and more desirable because
inventory levels will not be affected.

Item Receipt Return Authorization

Item Receipt Transfer Order

Purchase Order Requisition

Return Authorization Cash Sale

Return Authorization Invoice

Return Authorization Sales Order

Sales Order Estimate

Sales Order Opportunity

Vendor Bill Purchase Order You can initialize or link a single purchase order to a vendor bill, or a
list of purchase orders to a vendor bill. Note that when linking multiple
purchase orders to a single vendor bill, all purchase orders must be
for the same vendor.

When you initialize a vendor bill from a purchase order, the purchase
order gets transformed but any attached files are not transferred to
the vendor bill.

For more information, see the help topic Linking Purchase Orders to a
Vendor Bill.

When you initialize a vendor bill, there are two possibilities for the
value of the account field on the vendor bill.

■ If you have not populated the Default Payables Account field under
the Financial subtab in the Vendor record, SOAP web services
populate the Account field of the initialized vendor bill with the
account most recently used on a vendor bill.
■ If you have populated the Default Payables Account field under the
Financial subtab in the Vendor record, SOAP web services populate
the Account field of the initialized vendor bill with the same field
value.

Vendor Bill Vendor Use the apAccount parameter to specify the accounts payable (AP)
account in a Vendor to Vendor Bill initialization. (This parameter is
define in InitializeAuxRefType.)

When you initialize a vendor bill, there are two possibilities for the
value of the account field on the vendor bill.

SuiteTalk SOAP Web Services Platform Guide

initialize / initializeList 232

(Target Record) Initialize Reference Notes

Transaction Type
■ If you have populated the Default Payables Account field under the
Financial subtab in the Vendor record, SOAP web services populate
the Account field of the initialized vendor bill with the same field
value.

Vendor Credit Vendor

Vendor Credit Vendor Bill

Vendor Credit Vendor Return

Authorization

Vendor Payment Employee

Vendor Payment Vendor

Vendor Payment Vendor Bill

Vendor Return Vendor

Authorization

Vendor Return Vendor Bill

Authorization

Work Order Close Work Order The work order must be configured to use WIP.

Work Order Work Order The work order must be configured to use WIP.
Completion

Work Order Issue Work Order The work order must be configured to use WIP.

Ignore Read-Only Preference

To submit an initialized record without having to remove read-only fields populated during the
initialization, set the Ignore Read-Only header preference to TRUE.

Important: When this preference is set to TRUE, read-only fields are ignored during the SOAP
web services request. The fields still cannot be set.

Request
The InitializeRequest type is used for this request. It contains the following fields:

Element Name XSD Type Notes

initializeRecord InitializeRecord

The InitializeRecord type takes the following fields:

■ type
■ reference
■ auxReference
■ referenceList

SuiteTalk SOAP Web Services Platform Guide

initialize / initializeList 233

Response
The InitializeResponse type is used for the response. It contains the following fields:

Element Name XSD Type Notes

status Status The status for this operation. All applicable errors or warnings are listed within
this type.

record Record The record type of the resulting initialization.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

Sample Code

SOAP Request (initialize)

<soapenv:Body>
<platformMsgs:initialize xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-
instance" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:platformCoreTyp="urn:types.core_2017_1.platform.webservices.netsuit
e.com" xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com" xmlns:platformMsgs="urn:messages_2017_1.platform.web
services.netsuite.com">
<platformMsgs:initializeRecord>
<platformCore:type>invoice</platformCore:type>
<platformCore:reference internalId="1513" type="salesOrder">
<platformCore:name>1511</platformCore:name>
</platformCore:reference>
</platformMsgs:initializeRecord>
</platformMsgs:initialize>
</soapenv:Body>

SOAP Request (initializeList)

<initializeList xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<initializeRecord>
<ns1:type xmlns:ns1="urn:core_2017_1.platform.webservices.netsuite.com">customerPayment
</ns1:type>
<ns2:reference internalId="176" type="customer" xmlns:ns2="urn:core_2017_1.platform.webservices.netsuite.com"/>

SuiteTalk SOAP Web Services Platform Guide

initialize / initializeList 234

</initializeRecord>
<initializeRecord>
<ns3:type xmlns:ns3="urn:core_2017_1.platform.webservices.netsuite.com">
invoice</ns3:type>
<ns4:reference internalId="176" type="customer" xmlns:ns4="urn:core_2017_1.platform.webservices.netsuite.com"/>
</initializeRecord>
</initializeList>

Java (initializeList)

InitializeRef iRef1 = new InitializeRef();

iRef1.setInternalId("176");
iRef1.setType(InitializeRefType.customer);

InitializeRecord ir1 = new InitializeRecord();

ir1.setReference(iRef1);
ir1.setType(InitializeType.customerPayment);

InitializeRecord ir2 = new InitializeRecord();

ir2.setReference(iRef1);
ir2.setType(InitializeType.invoice);

sessMgr.getPort().getNetSuitePortTypePort().initializeList(new InitializeRecord[]{ir1, ir2});

C# (initialize)

private void Initialize()

{
this.login(true);

InitializeRef ref1 = new InitializeRef();

ref1.type = InitializeRefType.salesOrder;

//internal id of the sales order to be converted to cash sale

ref1.internalId = "792";
ref1.typeSpecified = true;

InitializeRecord rec = new InitializeRecord();

rec.type = InitializeType.cashSale;
rec.reference = ref1;

ReadResponse read1 = _service.initialize(rec);

}

mapSso
Warning: As of the NetSuite 2021.1 release, the mapSso operation is no longer available. This
affects all endpoints, and even though the SOAP schema remains for older endpoints, the method
is not working. For SOAP web services you must use token-based authentication instead. For more
information, see the help topic Token-based Authentication (TBA).

search
The search operation is used to execute a search on a specific record type based on a set of criteria. You
can search by defining search filter fields on the record, joined fields on an associated record, search

SuiteTalk SOAP Web Services Platform Guide

search 235

return columns, or joined search return columns from an associated record. The results of the search can
be complete records, or a select set of fields specified through search return columns.

Note that you can also use the search operation to return an existing saved search. You cannot use the
search operation to retrieve state values. You must use the getAll operation to retrieve all state values
in the system. The getAll operation will return all states, not the legal ones for your default country. Also
note that the country and state must match on the address.

Important: The search preferences you set in the SearchPreferences object affect the search
request and response. See SOAP Web Services Preferences for details.

Use the search operation to execute the following types of searches:

■ Basic search — Execute a search on a record type based on search filter fields that are specific to that
type. See Basic Searches in SOAP Web Services.
■ Joined search — Execute a search on a record type based on search filter fields on an associated
record type. See Joined Searches in SOAP Web Services
■ Advanced search — Execute a search on a record type in which you specify search filter fields and/
or search return columns or joined search columns. Using advanced search, you can also return an
existing saved search. See Advanced Searches in SOAP Web Services.

Note: An asynchronous equivalent is available for the search operation, asyncSearch. For
information about asynchronous request processing, see Synchronous Versus Asynchronous
Request Processing.

Not all transaction types are supported by SOAP web services searches. For the list of unsupported
transactions, see the help topic Transaction Search.

Also see the following sections for information on setting additional search filtering values and searching
for custom fields:

■ Setting Valid Search Values

■ Setting the anyof, mine, or myteam Filtering Values
■ Searching by lastModifiedDate
■ Understanding Sorting in Advanced Search
■ Search-Related Sample Code
■ Searching for a Multi-select Custom Field

Important: To go directly to search-related code samples, see Search-Related Sample Code.

Basic Searches in SOAP Web Services

See the following topics to learn how to execute a basic search in NetSuite using SOAP web services:

■ Basic Searches
■ SOAP Objects Used in a Basic Search
■ Basic Search Code Sample

SuiteTalk SOAP Web Services Platform Guide

search 236

Basic Searches
A basic search lets you search records of a specific type using the fields on that record as search filters.
The following figure shows the UI equivalent of a basic Customer search. Start by going to Lists >
Relationships > Customers > Search, and ensure that the Use Advanced Search box is not checked. You
can specify one or more field values to use as filters for search results.

In a basic search, field criteria are the only values you set. You cannot specify search return columns. In
SOAP web services, specifying search return columns is the equivalent of performing an advanced search.
(See Advanced Searches in SOAP Web Services for details.)

In the example of a basic Customer search (see previous figure), the results returned include the record
ID of every customer that has the Category field set to From Advertisement and the Status field set to
Customer-Closed Won. Note that ALL the other data associated with these specific customer records are
returned as well. As a consequence, in SOAP web services a basic search tends to increase the search
response time.

SOAP Objects Used in a Basic Search

To perform a basic search in which you specify search filter criteria only, use:

1. < Record > Search

2. < Record > SearchBasic

For more details, see Basic Search Objects Explained and Basic Search Code Sample.

Basic Search Objects Explained

In SOAP web services, any record that supports search has a corresponding < Record > Search object,
which contains a basic element. The basic element references a < Record > SearchBasic object, which
defines all available search criteria (filter fields) specific to that record type.

The XSD snippet below shows the CustomerSearch object. The basic element references the
CustomerSearchBasic object, which defines all available search criteria for the Customer record.

<complexType name=" CustomerSearch ">

SuiteTalk SOAP Web Services Platform Guide

search 237

<sequence>
<element name=" basic " type="platformCommon: CustomerSearchBasic " minOccurs="0"/>
<element name="callJoin" type="platformCommon:PhoneCallSearchBasic" minOccurs="0"/>
<element name="campaignResponseJoin" type="platformCommon:CampaignSearchBasic" minOccurs="0"/>
.....

</sequence>
</extension>
</complexContent>
</complexType>

Note: < Record > Search objects reside in the same XSD as their corresponding record objects.
In this case, both the Customer and CustomerSearch objects reside in the listRel XSD. Also note
that the CustomerSearch object, like all < Record > Search objects, provide available search
joins for that record type. For information on joined searches, see Joined Searches in SOAP Web
Services.

This snippet shows the CustomerSearchBasic object. All < Record > SearchBasic objects are defined
in the platformCommon XSD. This sample shows four of the available fields (accountNumber, address,
addressee, addressLabel) that can be used as search criteria on the Customer record.

<complexType name=" CustomerSearchBasic ">

Important: < Record > SearchBasic does not work for subrecords.

For a code sample of a basic search, see Basic Search Code Sample.

Basic Search Behavior with User Event Scripts and Workflows

If the bodyFieldsOnly preference is set to false, a basic search triggers user event scripts and workflows.
To avoid triggering user event scripts and workflows while using basic search, do one of the following:

■ Set the bodyFieldsOnly preference to true. For information about this preference, see bodyFieldsOnly.
■ Set the runServerSuiteScriptAndWorkflowTriggers preference to false. For information about this
preference, see runServerSuiteScriptAndWorkflowTriggers.

Joined Searches in SOAP Web Services

See the following topics to learn how to execute a joined search in NetSuite using SOAP web services:

■ Joined Searches
■ SOAP Objects Used in a Joined Search

SuiteTalk SOAP Web Services Platform Guide

search 238

■ Joined Search Code Samples

Joined Searches
A joined search allows you search against a specific record type using the fields on an associated record
as search filters. In the UI, you can identify which associated records provide joined filter criteria by first
navigating to a record's search interface. For example, for the Customer search interface, go to Lists >
Relationships > Customers > Search.

Check the Use Advanced Search box and wait for the page to update. Then scroll through the Filter
dropdown list. Joined search records are indicated by the record name followed by an ellipsis (....). Search
fields from any of the records listed (that are also currently exposed in SOAP web services) can be
included in the search criteria.

Note: For a list of SOAP web services-supported records, see the help topic SOAP Web Services
Supported Records.

SOAP Objects Used in a Joined Search

To perform a joined search in which you use search filter criteria from an associated record, use:

1. < Record > Search

2. < Record > SearchBasic

For more details, see Joined Search Objects Explained and Joined Search Code Samples.

Joined Search Objects Explained

In SOAP web services, all search joins are listed in the < Record > Search object. For example, to find
available search joins for the Contact or Employee record, see the ContactSearch and EmployeeSearch
XSDs, respectively.

SuiteTalk SOAP Web Services Platform Guide

search 239

The snippet below shows the CustomerSearch object, which includes < xxx > Join elements. These
elements reference search criteria available from other SOAP-supported records.

<complexType name=" CustomerSearch ">

<complexContent>
<extension base="platformCore:SearchRecord">
<sequence>
<element name="basic" type="platformCommon:CustomerSearchBasic" minOccurs="0"/>
<element name=" callJoin " type="platformCommon: PhoneCallSearchBasic " minOccurs="0"/>
<element name=" campaignResponseJoin " type="platformCommon: CampaignSearchBasic " minOccurs="0"/>
<element name=" caseJoin " type="platformCommon: SupportCaseSearchBasic " minOccurs="0"/>
.....

</sequence>
</extension>
</complexContent>
</complexType>

In this case, all search filter criteria from the PhoneCallSearchBasic, CampaignSearchBasic, and
SupportCaseSearchBasic objects are available to the Customer record as joined search filters. Note that
all < Record > SearchBasic objects in NetSuite SOAP web services are defined in the platformCommon
XSD.

For a code sample of a joined search, see Joined Search Code Samples.

Important: Only fields on SOAP-supported records can be specified as filter criteria for a
joined search request. For a list of SOAP-supported records, see the help topic SOAP Web Services
Supported Records.

Returning an Associated Joined List of Records

Using a combination of joined search and the internalId list on each record, you can retrieve a list of
records for an associated list of records. For example, you can retrieve a list of contacts for a specific list
of customers. To do this, you must first retrieve the desired list of internalIds for the record you need to
retrieve by, and then submit that list in a joined search query to retrieve the associated list.

See Joined Search Code Samples for an example of a joined search which uses a list of records.

Advanced Searches in SOAP Web Services

Advanced searching in SOAP web services provides users with the ability to:

■ Perform a search that references an existing saved search. See Reference Existing Saved Searches.
■ Perform a search that references an existing saved search, and then overrides existing search return
columns with new search return columns. See Specify Search Criteria and Search Return Columns.
■ Perform a search that references an existing saved search, and then provides additional search filter
criteria (on top of the criteria already specified in the saved search). See Specify Search Criteria and
Search Return Columns.
■ Perform a search that specifies search criteria and search result columns. See Specify Search Criteria
and Search Return Columns.

The SOAP web services API includes advanced search objects for all records that have an existing search
interface. To see which objects are used to execute advanced searches, see SOAP Objects used in
Advanced Searches

SuiteTalk SOAP Web Services Platform Guide

search 240

For advanced search code samples, see Advanced Search Code Samples.

In case you encounter duplicate or missing search results, ensure your search references an existing
saved search in which the results are sorted by Internal ID. For more information about defining the
sorting of the results, see the help topic Defining a Saved Search.

The following is an XSD snippet of the listRel XSD. This sample provides a high-level overview of advanced
search objects and their relationship to the basic search object < Record > Search. In this sample, the
objects Customer SearchAdvanced, Customer SearchRow, and Customer SearchRowBasic (not shown
in sample) are considered to be advanced search objects in the SOAP web services API.

Note: For additional SOAP and code samples related to searches, see Search-Related Sample
Code, Joining Through Custom Fields, and Searches.

Reference Existing Saved Searches

Advanced search in SOAP web services lets you reference an existing saved search. Returning saved
searches provides you with access to data that otherwise could not be returned in SOAP web services.
For example, advanced search lets you return saved searches that include formula filters (in the search
criteria) or expressions.

When working with saved searches, two questions come to mind for SOAP web services users:

■ Reasons to Reference an Existing Saved Search

■ How to Reference an Existing Saved Search

Reasons to Reference an Existing Saved Search

The following use cases illustrate possible scenarios for referencing a saved search:

■ You want to return only a subset of data from a record (in other words, data that is specified through
the saved search's return columns).

SuiteTalk SOAP Web Services Platform Guide

search 241

■ Your integration application processes a set of records that are identified in a saved search.
Periodically, users change the criteria of the search. By referencing a saved search ID, your code
can reference their saved search. Developers do not have to change and re-test code every time the
search criteria changes.
■ You have a complex search that compiles data from many different records. You can create a saved
search in the NetSuite UI, and then reference this search in SOAP web services rather than try to code
the search in SOAP web services.
■ You want to reference an existing saved search based on Leads, for example. You can return all the
data provided in this search, and then define additional criteria for the search response. For example,
you can return a Leads saved search and then provide additional criteria that returns the leads from
this search created with today's date. In other words, if you reference a saved search and add any filter
criteria to the search request, the additional criteria will be conjunctive with the saved search criteria.

How to Reference an Existing Saved Search

First you must obtain the saved search ID. You can do so through the UI by going to Lists > Search >
Saved Searches. The saved search ID appears in the ID column.

You can also use the getSavedSearch operation to programmatically retrieve a list of saved search IDs for
a specific record type. Note that this operation does nothing more than return a list of saved search IDs
on a per-record-type basis (for example, all saved search IDs for the customer record type).

You can then use the search() operation, along with the < Record > SearchAdvanced object to
return the details of the saved search. The following is a example that shows how to instantiate the
CustomerSearchAdvanced object and specify a savedSearchId to return.

// create search object

CustomerSearchAdvanced customerSearch = new CustomerSearchAdvanced();

//set saved search id

customerSearch.savedSearchId="100";

// perform the search

NetSuiteService nss = new NetSuiteService();
SearchResult result = nss.search(customerSearch);

For more detailed samples, see Advanced Search Code Samples.

Usage Notes
■ Only one saved search can be referenced as part of the search call.
■ If you reference a saved search that contains search functions, you will get the results back. However,
you cannot create an advanced search that uses search functions. Creating a search in SOAP web
services that uses search functions is not currently supported.
■ If you reference a saved search for which you do not have permission, the exception is ignored and
fields have no value (are not in the SOAP response at all).
■ If you reference a saved search that contains summary results, you will get the following error:
We cannot return search columns for summary saved search < saved search ID >
The following figure shows the UI equivalent of setting a summary type on a search return column. If a
value is set, the saved search cannot be returned.

SuiteTalk SOAP Web Services Platform Guide

search 242

Specify Search Criteria and Search Return Columns

Similar to a basic search, an advanced search allows you search against a specific record type using the
fields on that record as search filters. In addition, you can also specify a set of search return columns or
joined columns to return.

This kind of advanced search is useful for retrieving only the record data you need rather than the
contents of an entire record.

Advanced searches work well, for example, for users who may have a mobile client that needs to display
only the name, phone number, and email address of their sales rep contact. Rather than returning
all of the data on a contact record, users can create an advanced search that pulls only the relevant
information. They are no longer required to download the entire record.

For advanced search code samples that show how to specify both search criteria and search return
columns, see Advanced Search Code Samples.

Search Return Columns

The following figures show the UI equivalent of an advanced search that includes search return columns.

1. First, specify the basic search criteria on the Criteria subtab (in this example all customers that
have a company name starting with the letter A).

SuiteTalk SOAP Web Services Platform Guide

search 243

2. Next, click the Results subtab to define the search return columns. When your search is executed,
your search response will return only the company name, phone, and contact name of all
customers whose company starts with the letter A.

The following figure shows the results of the search. Only the relevant data are returned.

SuiteTalk SOAP Web Services Platform Guide

search 244

SOAP Objects used in Advanced Searches

The following summarizes the objects used in different types of advanced searches. For additional details,
see Advanced Search Objects Explained and Advanced Search Code Samples.

■ To perform a search that specifies search filter criteria and search result columns, use:
1. < Record > Search
2. < Record > SearchBasic
3. < Record > SearchRow
4. < Record > SearchRowBasic
■ To perform a search that references an existing saved search, use:
1. < Record > SearchAdvanced
■ To perform a search that references an existing saved search, and then overrides existing search
return columns with new search return columns, use:
1. < Record > SearchAdvanced
2. < Record > SearchRow
3. < Record > SearchRowBasic
■ To perform a search that references an existing saved search, and then provides additional search
filter criteria (that is in addition to the criteria already specified in the saved search), use:
1. < Record > SearchAdvanced
2. < Record > Search
3. < Record > SearchBasic

Advanced Search Objects Explained

The < Record >SearchAdvanced object contains:

■ a criteria element - references the < Record > Search object through which you specify standard
search field criteria. (See Basic Searches in SOAP Web Services for details on the < Record >Search
object.)
■ a columns element - references the < Record > SearchRow object through which you specify a set of
search result columns to return in the response.
■ a savedSearchId attribute - references the saved search internal ID (for example, 57, 99, 63).

Note: If the Show Internal ID preference is enabled in your NetSuite account, the saved search
internal ID appears in the Internal ID column in a saved search list. Programmatically, you can use
getSavedSearch to obtain a list of saved search internal IDs for a specific record type.

■ a savedSearchScriptId attribute - references a custom saved search ID (for example,

customsearch_mySpecialSearch).

Note: If the Show Internal ID preference is enabled in your NetSuite account, the saved search
ID appears in the ID column in a saved search list.

Important: You cannot use getSavedSearch to return a list of custom saved search IDs; only
the system-defined internal IDs (57, 99, 63, etc.) will be returned.

The XSD sample below shows the CustomerSearchAdvanced object:

SuiteTalk SOAP Web Services Platform Guide

search 245

<complexType name=" CustomerSearchAdvanced ">

The < Record >SearchRow object contains:

■ a basic element - references the < Record > SearchRowBasic object, which specifies available search
return columns and column joins for that record type.
■ <xxx>Join elements - references the < Record > SearchRowBasic object, which specifies search return
columns and column joins for the associated record type.

The XSD below shows a snippet of the CustomerSearchRow object:

<complexType name=" CustomerSearchRow ">

The < Record >SearchRowBasic object contains:

■ search result column elements - use to define specific column names in your response.

The next snippet shows the CustomerSearchRowBasic object, which, like ALL < Record > SearchRowBasic
objects, resides in the platformCommon XSD. This object lists all available search return columns for the
Customer record.

<complexType name=" CustomerSearchRowBasic ">

<sequence>
<element name=" accountNumber " type="platformCore: SearchColumnStringField " minOccurs="0" maxOccurs="unbounded"/>
<element name=" address " type="platformCore: SearchColumnStringField " minOccurs="0" maxOccurs="unbounded"/>
<element name=" addressee " type="platformCore: SearchColumnStringField " minOccurs="0" maxOccurs="unbounded"/>
<element name=" addressLabel " type="platformCore: SearchColumnStringField " minOccurs="0" maxOccurs="unbounded"/>
...

</sequence>
</complexType>

Note that all search return columns reference SearchColumn< xxx >Field objects. See Search Column
Custom XML Schema Types for definitions of each search column object.

SuiteTalk SOAP Web Services Platform Guide

search 246

Important: When executing an advanced search, you can set the SearchPreferences.
returnSearchColumns preference to TRUE to ensure that only search return columns are returned
in a search. An error is thrown if returnSearchColumns is set to TRUE and you have not specified
search return columns in your request. (Note that you will not receive an error if you are using
advanced search functionality to return a saved search that already includes search return
columns.)

Note: Also note that in an advanced search, the bodyFieldsOnly preference is ignored.

The default value for returnSearchColumns is TRUE.

How Custom Fields Are Identified in Search Results

When executing an advanced search, you might choose to include as part of your search results values
from custom fields. In some cases, the way that the system identifies these values varies depending
on which endpoint you are using. For many users, this difference might not be of great consequence.
However, you may want to review this information if you are upgrading from a previous endpoint to the
2013.2 WSDL or later, and if your integration depends on these values.

Specifically, this difference applies to scenarios in which you execute an advanced search, join to a record
that has a custom field, and include the custom field in your search results. With 2013.1 and earlier
endpoints, the system in its response adds a prefix to the string used to identify the custom field. In
2013.2 and later, this prefix is not added.

For example, suppose you had a custom item field on your inventory item record, and this custom field
had an ID of custitem_style.

First, note that this value is referred to as internalId when using 2013.1 or an earlier endpoint. With
2013.2 and later endpoints, the value is called scriptId.

Second, with older endpoints, in some cases, the system modifies this value slightly. For example:
Suppose you executed a TransactionSearchAdvanced and joined to the item record. If you included in
your search results the custom field pictured above, the 2013.1 endpoint, or an earlier one, would identify
the field’s internalId as having a value of “item_custitem_style.” That is, in this particular scenario, the
system would add the “item_” prefix. With a different type of join, a different prefix would be added.

SuiteTalk SOAP Web Services Platform Guide

search 247

If you are using the 2013.2 endpoint or later, the system does not add a prefix. The scriptId returned in
the response is the same as in the request (“custitem_style,” in this example). Therefore, if you upgrade
to 2013.2 or a later WSDL and if you have integrations that depend on this value, you must modify these
integrations.

Note: For code samples in Java and C#, see Searching for a Multi-select Custom Field.

Behavior with 2013.1 and Earlier Endpoints Example

In the following example, the user executes a TransactionSearchAdvanced operation with a join to the
item record. The user is searching for estimates that are associated with inventory items. In the results,
the user wants to include the value of the custom field with the internalId “custitem_color.”

<soapenv:Body>
<platformMsgs:search>
<platformMsgs:searchRecord xsi:type="s0:TransactionSearchAdvanced">
<s0:criteria>
<s0:basic>
<platformCommon:internalId operator="anyOf">
<platformCore:searchValue internalId="11962" type="estimate" />
</platformCommon:internalId>
<platformCommon:type operator="anyOf">
<platformCore:searchValue>_estimate</platformCore:searchValue>
</platformCommon:type>
</s0:basic>
<s0:itemJoin>
<platformCommon:type operator="anyOf">
<platformCore:searchValue>_inventoryItem</platformCore:searchValue>
</platformCommon:type>
</s0:itemJoin>
</s0:criteria>
<s0:columns>
<s0:itemJoin>
<platformCommon:customFieldList>
<platformCore:customField xsi:type="platformCore:SearchColumnSelectCustomField" internalId="custitem_color" />
</platformCommon:customFieldList>
</s0:itemJoin>
</s0:columns>
</platformMsgs:searchRecord>
</platformMsgs:search>
</soapenv:Body>

The response might look like the following. Note that the internalId value is now “item_custitem_color.”

<platformCore:searchRowList>
<platformCore:searchRow xsi:type="tranSales:TransactionSearchRow" xmlns:tranSales="urn:sales_2017_1.transactions.webservices.net
suite.com">
<tranSales:itemJoin xmlns:platformCommon="urn:common_2017_1.platform.webservices.netsuite.com">
<platformCommon:customFieldList>
<platformCore:customField internalId="item_custitem_color" xsi:type="platformCore:SearchColumnSelectCustomField">
<platformCore:searchValue internalId="1" typeId="6" />
</platformCore:customField>
</platformCommon:customFieldList>
</tranSales:itemJoin>
</platformCore:searchRow>
</platformCore:searchRowList>

Behavior with 2013.2 and Later Endpoints Example

The SOAP request below represents another TransactionSearchAdvanced that joins to the item record.
(In this example, because the 2013.2 WSDL is being used, the “custitem_color” value is identified as the
scriptId, rather than internalId.)

<soapenv:Body>

SuiteTalk SOAP Web Services Platform Guide

search 248

<ns6:criteria xsi:type="ns6:TransactionSearch">
<ns6:basic xsi:type="ns7:TransactionSearchBasic" xmlns:ns7="urn:common_2017_1.platform.webservices.netsuite.com">
<ns7:internalId operator="anyOf" xsi:type="ns8:SearchMultiSelectField" xmlns:ns8="urn:core_2017_1.platform.webser
vices.netsuite.com">
<ns8:searchValue internalId="67" xsi:type="ns8:RecordRef"/>
</ns7:internalId>
<ns7:type operator="anyOf" xsi:type="ns9:SearchEnumMultiSelectField" xmlns:ns9="urn:core_2017_1.platform.webservices.net
suite.com">
<ns9:searchValue xsi:type="xsd:string">_estimate</ns9:searchValue>
</ns7:type>
</ns6:basic>
</ns6:criteria>
<ns6:columns xsi:type="ns6:TransactionSearchRow">
<ns6:itemJoin xsi:type="ns10:ItemSearchRowBasic" xmlns:ns10="urn:common_2017_1.platform.webservices.netsuite.com">

<ns10:customFieldList xsi:type="ns11:SearchColumnCustomFieldList" xmlns:ns11="urn:core_2017_1.platform.webser

vices.netsuite.com">
<ns11:customField scriptId="custitem_color" xsi:type="ns11:SearchColumnSelectCustomField"/>
</ns10:customFieldList>
</ns6:itemJoin>
</ns6:columns>
</searchRecord>
</search>
</soapenv:Body>

In the SOAP response, the scriptId value – “custitem_color” – is unchanged. No prefix has been added.

<platformCore:searchRowList>
<platformCore:searchRow xsi:type="tranSales:TransactionSearchRow" xmlns:tranSales="urn:sales_2017_1.transactions.webservices.net
suite.com">
<tranSales:itemJoin xmlns:platformCommon="urn:common_2017_1.platform.webservices.netsuite.com">
<platformCommon:customFieldList>
<platformCore:customField internalId="211" scriptId="custitem_color" xsi:type="platformCore:SearchColumnSelectCustom
Field">
<platformCore:searchValue internalId="1" typeId="28"/>
</platformCore:customField>
</platformCommon:customFieldList>
</tranSales:itemJoin>
</platformCore:searchRow>
</platformCore:searchRowList>

Joining Through Custom Fields

If you are using 2013.2 or a later WSDL, you may notice that many RecordType Search objects include
CustomSearchJoin. This object lets you join to records that are associated with the primary record
through a custom field.

That is, if Record A includes a custom field of type list/record or multiple select, and this custom field
references another record that is exposed to SOAP web services, the 2013.2 WSDL and later WSDLs allow
your search of Record A to include a join to the SearchBasic of the referenced record.

Similarly, many RecordType SearchRow objects now include CustomSearchRowBasic. You can use this
object to include columns from the referenced record in the results of an advanced search.

See the following for more details on executing searches using CustomSearchJoin and
CustomSearchRowBasic:

■ Overview of CustomSearchJoin and CustomSearchRowBasic

■ CustomSearch Objects Defined
■ Using CustomSearchJoin and CustomSearchRowBasic Example
■ CustomSearchJoin Usage Notes

SuiteTalk SOAP Web Services Platform Guide

search 249

Overview of CustomSearchJoin and CustomSearchRowBasic

This topic describes some of the basics of using CustomSearchJoin and CustomSearchRowBasic.

Executing a Search
To use CustomSearchJoin, you can execute either a joined search or an advanced search.
For example, consider an employee record that has been altered to include a custom field pointing to the
account record. In this case, you can search the employee record and use CustomSearchJoin to include
data from the account record as part of your search criteria. You would execute your search using either
of the following two objects:

■ EmployeeSearch — Results returned would include the entire employee record for each employee
that meets your criteria. (For general details on this type of search, see Joined Searches in SOAP Web
Services.)
■ EmployeeSearchAdvanced — Results returned could include any columns you specify from the
employee record or the account record. (For general details on this type of search, see Advanced
Searches in SOAP Web Services.) In this scenario, you would use CustomSearchRowBasic as well as
CustomSearchJoin.

Sample Use Cases for CustomSearchJoin

You can use CustomSearchJoin in a couple of different scenarios.
A common case is one in which you have altered a standard record type to include a custom field that
references another standard record type. This scenario includes the example where your employee
record has been altered to include a custom field that points to the account record.
Additionally, you can join to and from custom record types. For example, suppose your organization
uses custom record types called Customer Survey and Customer Suggestion. If Customer Survey and
Customer Suggestion both include fields that reference each other, a search of Customer Survey could
include a join to Customer Suggestion and vice versa.
Similarly, you can join between the following:

■ A customized record type that references a standard record type.

■ A standard record type that references a custom record type.

Sample Use Cases for CustomSearchRowBasic

CustomSearchRowBasic can be used in conjunction with all of the custom field usage described above for
CustomSearchJoin.
Additionally, your search does not have to include the use of CustomSearchJoin in order for you to use
CustomSearchRowBasic. For example, you could use EmployeeSearchAdvanced to search using criteria
that is defined on the employee record (and not use any joins). But in your results, you might still want
to include data from the record referenced by a custom field on the employee record. You do this using
CustomSearchRowBasic.
Note that CustomSearchRowBasic is available only when you are executing an advanced search.

Note: CustomSearchJoin and CustomSearchRowBasic are available only for accounts that have
upgraded to 2013.2 or a later endpoint.

CustomSearch Objects Defined

For accounts that have upgraded to 2013.2 or a later endpoint, common.xsd includes two elements
that support joining to and gathering result data from records that are referenced by a custom field.

SuiteTalk SOAP Web Services Platform Guide

search 250

These objects are CustomSearchJoin and CustomSearchRowBasic. The main purpose of these objects is
described in Overview of CustomSearchJoin and CustomSearchRowBasic. This topic describes how the
objects are defined in the schema.

CustomSearchJoin is included in many RecordType Search objects. This element is defined as follows:

CustomSearchRowBasic is included in many RecordType SearchRow objects. This element is defined as

follows:

Notice that both of these elements use CustomizationRef, which you use to identify the custom field.
CustomizationRef includes five possible attributes. Of these, you can use only internal ID or script ID to
identify a custom field. The other attributes (external ID, type, and name) are not applicable to custom
fields.

The following example shows how you can use script ID to reference a custom field and join to
AccountSearchBasic:

CustomizationRef field_account = new CustomizationRef(null,null,null,null,"custentity_account");

CustomSearchJoin customSearchJoin = new CustomSearchJoin(field_account,accountSearchBasic);

For a more extensive example, see Using CustomSearchJoin and CustomSearchRowBasic Example.

Note: CustomSearchJoin and CustomSearchRowBasic are available only for accounts that have
upgraded to the 2013.2 or a later endpoint.

Using CustomSearchJoin and CustomSearchRowBasic Example

If you are using the 2013.2 WSDL or later, you have access to CustomSearchJoin and
CustomSearchRowBasic. This topic shows how you might use these objects in your code. For details
on the general purpose of these objects and sample use cases, see Overview of CustomSearchJoin and
CustomSearchRowBasic.

The example below assumes that your employee record has been altered to include a custom field that
references the account record. This sample shows how you might use EmployeeSearchAdvanced to find
employee records associated with an account of a certain type and value.

public void testSearch1() throws Exception{

// We are searching for employees associated with a certain type of account. Here we specify that account.

AccountSearchBasic accountSearchBasic = new AccountSearchBasic();

accountSearchBasic.setType(new SearchEnumMultiSelectField(new String[]{AccountType.__bank}, SearchEnumMultiSelectFieldOperator.any
Of));

// Here we specify the field on the employee record that references the account record.

SuiteTalk SOAP Web Services Platform Guide

search 251

CustomizationRef field_account = new CustomizationRef();

field_account.setScriptId("custentity_account");

// Here we create a custom search join object.

CustomSearchJoin customSearchJoin = CustomSearchJoin(field_account, accountSearchBasic);

// Next, we pass the custom search join that we just created into an EmployeeSearch instance.

EmployeeSearch employeeSearch = new EmployeeSearch();

employeeSearch.setCustomSearchJoin(new CustomSearchJoin[] {customSearchJoin});

// Next, we specify that we want the results to include the balance of the account.

AccountSearchRowBasic accountSearchRowBasic = new AccountSearchRowBasic();

accountSearchRowBasic.setBalance(new SearchColumnDoubleField[]{new SearchColumnDoubleField()});
CustomSearchRowBasic customSearchRowBasic =new CustomSearchRowBasic(field_account,accountSearchRowBasic);

// Here, we specify that we want the employee's internal ID included in the results.

EmployeeSearchRowBasic employeeSearchRowBasic = new EmployeeSearchRowBasic();

employeeSearchRowBasic.setInternalId(new SearchColumnSelectField[]{new SearchColumnSelectField()});

// In the following snippet, we pass the specified search columns into an EmployeeSearchRow instance.

EmployeeSearchRow employeeSearchRow = new EmployeeSearchRow();

employeeSearchRow.setCustomSearchJoin(new CustomSearchRowBasic[]{customSearchRowBasic});
employeeSearchRow.setBasic(employeeSearchRowBasic);

// Create the advanced search.

EmployeeSearchAdvanced employeeSearchAdvanced = new EmployeeSearchAdvanced();

employeeSearchAdvanced.setCriteria(employeeSearch);
employeeSearchAdvanced.setColumns(employeeSearchRow);

c.search(employeeSearchAdvanced);

Note: CustomSearchJoin and CustomSearchRowBasic are available only for accounts that have
upgraded to the 2013.2 or a later endpoint.

CustomSearchJoin Usage Notes

If you are using the 2013.2 WSDL or later, you have access to CustomSearchJoin. Refer to the following
sections to better understand the capabilities of this search object:

■ Use CustomSearchJoin Only With Custom Fields

■ CustomSearchJoin Connects Only With SearchBasics
■ Nested Joins Are Not Allowed

Use CustomSearchJoin Only With Custom Fields

You cannot use CustomSearchJoin in conjunction with a standard field that references another record.
For example, the standard employee record includes the Department field. If you decide to use
CustomSearchJoin, and you identify the Department field as your custom field, the system returns an
error reading “Invalid custom field reference.” You should use the standard departmentJoin that is already
provided as part of the EmployeeSearch object.

SuiteTalk SOAP Web Services Platform Guide

search 252

CustomSearchJoin Connects Only With SearchBasics

CustomSearchJoin allows only for a basic search of the referenced record. For example, if the employee
record has been altered to include a custom field that points to the account record, you can join to
AccountSearchBasic – but not AccountSearch or AccountSearchAdvanced. This limitation is consistent
with the capabilities of searching in the UI.

Nested Joins Are Not Allowed

You cannot use nested joins. For example, suppose your contact record includes a custom field
referencing the employee record, which includes a custom field that references the account record. A
search of the contact record could include a join to the employee record, but the same search could not
also join to the account record.

Note: CustomSearchJoin and CustomSearchRowBasic are available only for accounts that have
upgraded to the 2013.2 or a later endpoint.

Setting Valid Search Values

Prior to the 2008.2 endpoint, if you performed a search that included an invalid search enum filter value,
you would generally still get records returned in your search. For example, if you performed a search for
all customers with the Country enum search value set to "United States" (rather than the supported enum
value _unitedStates), you would still get results from your search. Although the value "United States" was
not recognized, you continued to get customer records. Note, however, the search results returned ALL
customers in the system, since the value “United States” was invalid.
Starting with the 2008.2 endpoint, instead of ignoring any invalid search enum values, and still returning
search results, NetSuite now returns 0 records and a no-match warning. Therefore, when setting search
values, be sure to use the values defined in the schema.
The following is an example of what is now returned if invalid values are specified:

<platformCore:searchResult xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com">
<platformCore:status isSuccess="true">
<platformCore:statusDetail type="WARN">
<platformCore:code>WARNING</platformCore:code>
<platformCore:message>The field country's enum value <United States> is
invalid for this search.</platformCore:message>
</platformCore:statusDetail>
</platformCore:status>
<platformCore:totalRecords>0</platformCore:totalRecords>
<platformCore:totalPages>0</platformCore:totalPages>
<platformCore:searchId>WEBSERVICES_MSTRWLF_10212008563721605896842316_60315faa132ad</platformCore:searchId>
<platformCore:searchRowList/>

Setting the anyof, mine, or myteam Filtering Values

In SOAP web services, you can further define your search using the following filtering values:

Filter Note

@NONE@ Equates to anyof (see Filtering Lists that Contain Null Values) or unassigned depending on the field.

@CURRENT@ Equates to mine. For example, use this filter to return all of your own events.

@HIERARCHY@ Equates to my team. For example, use this filter on a salesRep field for customer records. If you
have previously defined the members of your sales team, using the @HIERARCHY@ filter will
return only the customers that have worked with members of your sales team.

SuiteTalk SOAP Web Services Platform Guide

search 253

The following provides a SOAP sample for finding my events.

Filtering Lists that Contain Null Values

For select lists or multi selects which can have a null value, the UI supports the search criteria on these list
type fields as “None Of” “-None-“, which essentially means not “Any Of” all list options. Such a search would
result in all records which do NOT have this list type field as null. To accomplish this “None Of” “-None-“
search you need to set the internalId of the search key to “@None@”.

Example
To search for Customers which have a Partner associated with them in NetSuite, the SOAP would look as
below for the “Partner field not null” part:

<ns3:partner operator="noneOf">
<ns8:searchValue internalId="@NONE@" xmlns:ns8="urn:core_2017_1.platform.webservices.netsuite.com"/>
</ns3:partner>
<ns3:customFieldList>

Java code to generate this SOAP would be:

// Adding search criteria where Partner is not null

RecordRef[] noPartner = new RecordRef[1];
noPartner[0] = new RecordRef();
noPartner[0].setInternalId("@NONE@");
SearchMultiSelectField partner = new SearchMultiSelectField();
partner.setOperator(SearchMultiSelectFieldOperator.noneOf);
partner.setSearchValue(noPartner);
custSearch.setPartner(partner);

C# code to generate this SOAP would be:

// Adding search criteria where Partner is not null

RecordRef[] noPartner = new RecordRef[1];
noPartner[0] = new RecordRef();
noPartner[0].internalId = "@NONE@";
SearchMultiSelectField partner = new SearchMultiSelectField();
partner.@operator = SearchMultiSelectFieldOperator.noneOf;
partner.searchValue = noPartner;
custSearch.partner = partner;

Searching by lastModifiedDate
This sample shows how to create a customer, and then search for the customer that was created based
on a specific time frame. In this case, the sample uses the lastModifiedDate field to search “within” a
couple of seconds before the customer was created and then a minute after. The search returns the
record that was previously created.

Java
Customer c = (Customer) new TestCustomer().createMinimalRecord();

SuiteTalk SOAP Web Services Platform Guide

search 254

Calendar timeFrom = Calendar.getInstance();

WriteResponse wr = sessMgr.getPort().add(c);
outputResult(wr.getStatus().isIsSuccess());

Calendar timeTo = Calendar.getInstance();

timeTo.setTimeInMillis(timeTo.getTimeInMillis() + 60000);

CustomerSearch cs = new CustomerSearch();

CustomerSearchBasic csb = new CustomerSearchBasic();
SearchDateField sdf = new SearchDateField();
sdf.setOperator(SearchDateFieldOperator.within);
sdf.setSearchValue(timeFrom);
sdf.setSearchValue2(timeTo);
csb.setLastModifiedDate(sdf);

cs.setBasic(csb);

SearchResult sr = sessMgr.getWrappedPort().search(cs, this);

SOAP
<searchRecord xsi:type="ns1:CustomerSearch" xmlns:ns1="urn:relationships_2017_1.lists.webservices.netsuite.com">
<ns1:basic xsi:type="ns2:CustomerSearchBasic" xmlns:ns2="urn:common_2017_1.platform.webservices.netsuite.com">
<ns2:lastModifiedDate operator="within" xsi:type="ns3:SearchDateField" xmlns:ns3="urn:core_2017_1.platform.webser
vices.netsuite.com">
<ns3:searchValue xsi:type="xsd:dateTime">2007-02-10T00:16:17.750Z</ns3:searchValue>
<ns3:searchValue2 xsi:type="xsd:dateTime">2007-02-10T00:17:53.015Z</ns3:searchValue2>
</ns2:lastModifiedDate>
</ns1:basic>
</searchRecord>

Understanding Sorting in Advanced Search

In SOAP web services, when you return a saved search that has sorting criteria specified in the saved
search, the records are returned according to the specified sorted by order. To see the sorted by criteria
that has been applied to a saved search, you can look at the saved search criteria in the UI.

Note: When performing a search using SOAP web services, there is no way to specify the sort
order of the returned results in the request itself.

In an ad-hoc SOAP web services search (a search in which sorted by criteria have not been set), you
should be aware of the implicit sorted by order in which records are returned. This order is based on
record type. Record types and the default sort by order for each record type are listed in the following
table:

Note: For a list of all records associated with each type, see the help topic SOAP Web Services
Supported Records.

Record Type Default “Sorted by” Order

Entities Name (the name of the entity)

Actvities Event (the title of the Event)

Marketing Campaign ID

Note: Promotion Code searches are sorted and returned by

promotion code name.

Transactions Date Created

SuiteTalk SOAP Web Services Platform Guide

search 255

Record Type Default “Sorted by” Order

Support Number

Note: Topic searches are sorted and returned by topic title.

File Cabinet Name (the name of the file or folder)

Items Name (the name of the item)

Communications Note - sorted/returned by Author

(includes the Note and the Message Message - sorted/returned by Message Internal ID
records)

Website Name

Lists Name

Note: Gift Certificate searches are sorted and returned by

Name (From).

Request
The SearchRequest type is used for the request. It contains the following field.

Element Name XSD Type Notes

searchRecord SearchRecord The SearchRecord type is an abstract type. An instance of a type that
extends SearchRecord must be used—such as CustomerSearchBasic or
EventSearchBasic.

Response
The SearchResponse type is used for the response. It contains the following fields.

Element Name XSD Type Notes

status Status The status for this search. All applicable errors or warnings will be listed
within this type.

totalRecords xsd:int The total number of records for this search. Depending on the pageSize
value, some or all the records may be returned in this response

pageSize xsd:int The page size for this search.

totalPages xsd:int The total number of pages that are part of this search.

pageIndex xsd:int The page index for the current set of results.

searchId string Returns a specific search based on its search ID.

recordList Record[] A list of records that meet the criteria for this search. The actual records
returned need to be of a type that extends the abstract type of record.

searchRowList SearchRowList A list of return columns that meet the criteria for this search.

SuiteTalk SOAP Web Services Platform Guide

search 256

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

Search-Related Sample Code

See the following search-related code samples:

■ Basic Search Code Sample

■ Joined Search Code Samples
■ Advanced Search Code Samples
■ Searching for a Multi-select Custom Field

Basic Search Code Sample

SOAP Request
In the following example, customer records that have an email that contains shutterfly.com are searched
for. Note that you can limit the search page size at the request level (see pageSize).

<soap:Body>
<platformMsgs:search>
<searchRecord xsi:type="ContactSearch">
<customerJoin xsi:type="CustomerSearchBasic">
<email operator="contains" xsi:type="platformCore:SearchStringField">
<platformCore:searchValue>shutterfly.com</platformCore:searchValue>
<email>
<customerJoin>
</searchRecord>
</search>
</soap:Body>

SOAP Response
Notice that in this example, only one matching record was found. You can see that the page size was set
such that if multiple records were found, only 10 would be returned at a time.

<soapenv:Body>
<searchResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<searchResult xmlns="urn:core_2017_1.platform.webservices.netsuite.com">
<status isSuccess="true"/>
<totalRecords>1</totalRecords>
<pageSize>10</pageSize>
<totalPages>1</totalPages>
<pageIndex>1</pageIndex>
<recordList>
<record internalId="983" xsi:type="ns1:Customer" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ns1="urn:relation
ships_2017_1.lists.webservices.netsuite.com">

SuiteTalk SOAP Web Services Platform Guide

search 257

<ns1:entityId>Shutter Fly</ns1:entityId>
<ns1:isInactive>false</ns1:isInactive>
<ns1:companyName>Shutter Fly, Inc</ns1:companyName>
<ns1:entityStatus internalId="6"><name>LEAD-New</name>
.
.
.
<ns1:customFieldList>
<customField internalId="165" scriptId="custentity_map" xsi:type="StringCustomFieldRef">
<value>http://maps.google.com</value>
</customField>
<customField internalId="76" scriptId="custentity_had_order_problems" xsi:type="BooleanCustomFieldRef"><value>false</
value></customField>
</ns1:customFieldList>
</record>
</recordList>
</searchResult>
</searchResponse>
</soapenv:Body>

private void searchCustomer()

{
_out.writeLn( "\nEnter search parameters" );

// Instantiate a search object for customers. Note that the search

// object is different from the regular record used for add and update.
CustomerSearch custSearch = new CustomerSearch();

// Search the customer entity id which is a string field

_out.write( "Entity ID (press enter to skip): " );
String nameValue = _out.readLn();
SearchStringField entityId = null;
if ( !nameValue.Equals( "" ) )
{
entityId = new SearchStringField();
entityId.@operator = SearchStringFieldOperator.contains;
entityId.operatorSpecified = true;
entityId.searchValue = nameValue;
custSearch.basic.entityId = entityId; //see note below for an alternative
}
//Note: You could also use CustomerSearchBasic to access entityId directly, for example:
CustomerSearchBasic custSearchBasic = new CustomerSearchBasic();
custSearchBasic.entityId = entityId;
// Search the customer stage which is a list field
_out.write( "Customer Stage (one or more nsKeys separated by commas, press enter to skip): " );
String stageKeysValue = _out.readLn();
SearchMultiSelectField stage = null;
if ( !stageKeysValue.Equals( "" ) )
{
stage = new SearchMultiSelectField();
stage.@operator = SearchMultiSelectFieldOperator.anyOf;
stage.operatorSpecified = true;

string [] nskeys = stageKeysValue.Split( new Char[] {','} );

RecordRef[] recordRefs = new RecordRef[ stageKeysValue.Length ];

for (int i=0; i<nskeys.Length; i++ )
{
RecordRef recordRef = new RecordRef();
recordRef.internalId = nskeys[i];
recordRefs[i] = recordRef;
}
stage.searchValue = recordRefs;
custSearch.stage = stage;
}

// Search by isActive field which is a boolean

/*
SearchBooleanField isActive = new SearchBooleanField();

SuiteTalk SOAP Web Services Platform Guide

search 258

while ( true )
{
_out.write( "Is active [T/F] (default is T): " );
String upcomingStr = _out.readLn();

if ( "T".Equals( upcomingStr.ToUpper() ) || "".Equals( upcomingStr.ToUpper() ) )

{
isActive.searchValue = true;
isActive.searchValueSpecified = true;
break;
}
else if ( upcomingStr.ToUpper().Equals( "F" ) )
{
isActive.searchValue = false;
isActive.searchValueSpecified = true;
break;
}
else
{
_out.writeLn( "Invalid selection" );
}
}
custSearch.active = isActive;
*/
if ( custSearch.entityId == null && custSearch.stage == null )
{
_out.info( "\nNo search criteria was specified. Searching for all records." );
}
else
{
_out.info(
"\nSearching for customers with the following criteria: " +
(entityId==null ? "" : ("\nentityID=" + custSearch.entityId.searchValue) + ",
Operator=" + [email protected]()) +
(stage==null ? "" : ("\nstage nsKeys='" + stageKeysValue + "',
Operator=" + [email protected]())) );
}

// Invoke search() web services operation

SearchResult response = _service.search( custSearch );

// Process response
if ( response.status.isSuccess )
{
// Process the records returned in the response and print to console
processCustomerSearchResponse( response );

// Since pagination controls what is returned, check to see

// if there are anymore pages to retrieve.
searchMore( response );
}
else
{
_out.error( getStatusDetails( response.status ) );
}
}

Java

public void searchCustomer() throws RemoteException,

ExceededUsageLimitFault, UnexpectedErrorFault, InvalidSessionFault,
ExceededRecordCountFault {
_console.writeLn("\nEnter search parameters");

// Instantiate a search object for customers. Note that the search

// object is different from the regular record used for add and update.
CustomerSearch custSearch = new CustomerSearch();

// Search the customer entity id which is a string field

_console.write("Entity ID (press enter to skip): ");

SuiteTalk SOAP Web Services Platform Guide

search 259

String nameValue = _console.readLn();

SearchStringField entityId = null;
if (!nameValue.equals("")) {
entityId = new SearchStringField();
entityId.setOperator(SearchStringFieldOperator.contains);
entityId.setSearchValue(nameValue);
custSearch.setEntityId(entityId);
}

// Search the customer stage which is a list field

_console
.write("Customer Stage (one or more nsKeys separated by commas, press enter to skip): ");
String stageKeysValue = _console.readLn();
SearchMultiSelectField stage = null;
if (!stageKeysValue.equals("")) {
stage = new SearchMultiSelectField();
stage.setOperator(SearchMultiSelectFieldOperator.anyOf);

String[] nskeys = stageKeysValue.split(",");

RecordRef[] recordRefs = new RecordRef[stageKeysValue.length()];

for (int i = 0; i < nskeys.length; i++) {
RecordRef recordRef = new RecordRef();
recordRef.setInternalId(nskeys[i]);
recordRefs[i] = recordRef;
}
stage.setSearchValue(recordRefs);
custSearch.setStage(stage);
}
if (custSearch.getEntityId() == null && custSearch.getStage() == null) {
_console
.info("\nNo search criteria was specified. Searching for all records.");
} else {
_console
.info("\nSearching for customers with the following criteria: "
+ (entityId == null ? ""
: ("\nentityId=" + custSearch
.getEntityId().getSearchValue())
+ ", Operator="
+ entityId.getOperator().toString())
+ (stage == null ? "" : ("\nstage nsKeys='"
+ stageKeysValue + "', Operator=" + stage
.getOperator().toString())));
}

// Set page size for number of records to be returned in search

// response

// Invoke search() web services operation

SearchResult result = _port.search(custSearch);

// Process result
if (result.getStatus().isIsSuccess()) {
// Process the records returned in the result and print to console
processCustomerSearchResponse(result);

// Since pagination controls what is returned, check to see

// if there are anymore pages to retrieve.
searchMore(result);
} else {
_console.error(getStatusDetails(result.getStatus()));
}
}

Joined Search Code Samples

Customer Search With Contact Join Sample One

This sample shows how to execute a customer search in which the contact email address is specified as
the search criteria.

SuiteTalk SOAP Web Services Platform Guide

search 260

Java

public void contactSearch_with_CustomerJoin() throws Exception {

ContactSearch cs = new ContactSearch();
ContactSearchBasic contactSearchBasic = new ContactSearchBasic();
contactSearchBasic.setEmail(new SearchStringField("[email protected]", SearchStringFieldOperator.is));
CustomerSearchBasic customerSearchBasic = new CustomerSearchBasic();
customerSearchBasic.setEntityId(new SearchStringField("My Customer", SearchStringFieldOperator.is));
cs.setBasic(contactSearchBasic);
cs.setCustomerJoin(customerSearchBasic);
sessMgr.getWrappedPort().search(cs, this);
}

SOAP

<search xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<searchRecord xsi:type="ns4:ContactSearch" xmlns:ns4="urn:relationships_2017_1.lists.webservices.netsuite.com">
<ns4:basic xsi:type="ns5:ContactSearchBasic" xmlns:ns5="urn:common_2017_1.platform.webservices.netsuite.com">
<ns5:email operator="is" xsi:type="ns6:SearchStringField" xmlns:ns6="urn:core_2017_1.platform.webservices.netsuit
e.com">
<ns6:searchValue xsi:type="xsd:string">[email protected]</ns6:searchValue>
</ns5:email>
</ns4:basic>
<ns4:customerJoin xsi:type="ns7:CustomerSearchBasic" xmlns:ns7="urn:common_2017_1.platform.webservices.netsuit
e.com">
<ns7:entityId operator="is" xsi:type="ns8:SearchStringField" xmlns:ns8="urn:core_2017_1.platform.webservices.net
suite.com">
<ns8:searchValue xsi:type="xsd:string">My Customer</ns8:searchValue>
</ns7:entityId>
</ns4:customerJoin>
</searchRecord>
</search>

Contact Search With Customer Join Sample Two

The following sample shows how to return an associated joined list of records. In this case, all contacts
associated with customers of internalId 1, 2 and 3 are returned.

Java

RecordRef[] rr = new RecordRef[]{new RecordRef("1", RecordType.customer),

new RecordRef("2", RecordType.customer), new RecordRef("3", RecordType.customer)};
CustomerSearchBasic customerSearchBasic = new CustomerSearchBasic();
customerSearchBasic.setInternalId(new SearchMultiSelectField(rr,
SearchMultiSelectFieldOperator.anyOf));
ContactSearch contactSearch = new ContactSearch();
contactSearch.setCustomerJoin(customerSearchBasic);

SOAP

<soapenv:Body>
<search xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<searchRecord xsi:type="ns1:ContactSearch" xmlns:ns1="urn:relationships_2017_1.lists.webservices.netsuite.com">
<ns1:customerJoin xsi:type="ns2:CustomerSearchBasic" xmlns:ns2="urn:common_2017_1.platform.webservices.netsuite.com">
<ns2:internalId operator="anyOf" xsi:type="ns3:SearchMultiSelectField" xmlns:ns3="urn:core_2017_1.platform.webservices.net
suite.com">
<ns3:searchValue internalId="1" type="customer" xsi:type="ns3:RecordRef"/>
<ns3:searchValue internalId="2" type="customer" xsi:type="ns3:RecordRef"/>
<ns3:searchValue internalId="3" type="customer" xsi:type="ns3:RecordRef"/>
</ns2:internalId>
</ns1:customerJoin>
</searchRecord>
</search>

SuiteTalk SOAP Web Services Platform Guide

search 261

</soapenv:Body>

Item Search With Pricing Join Sample Three

The following sample shows how to search for all items that have a price level of 10.00.

private void myItemSearch()

{

ItemSearchBasic myItemSearchBasic = new ItemSearchBasic();

SearchEnumMultiSelectField myEnum = new SearchEnumMultiSelectField();

myEnum.@operator = SearchEnumMultiSelectFieldOperator.anyOf;
myEnum.operatorSpecified = true;
String[] searchStringArray = new String[1];
searchStringArray[0] = "_inventoryItem";
myEnum.operatorSpecified = true;
myEnum.searchValue = searchStringArray;

myItemSearchBasic.type = myEnum;

PricingSearchBasic myPricingSearchBasic = new PricingSearchBasic();

SearchDoubleField rateValue = new SearchDoubleField();

rateValue.@operator = SearchDoubleFieldOperator.equalTo;
rateValue.operatorSpecified = true;
rateValue.searchValue = 10.00;
rateValue.searchValueSpecified = true;

myPricingSearchBasic.rate = rateValue;

ItemSearch myItemSearch = new ItemSearch();

myItemSearch.basic = myItemSearchBasic;
myItemSearch.pricingJoin = myPricingSearchBasic;

SearchResult searchResult = _service.search(myItemSearch);

}

SOAP Request

<soap:Body>
<search xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<searchRecord xmlns:q1="urn:accounting_2017_1.lists.webservices.netsuite.com" xsi:type="q1:ItemSearch">
<q1:basic>
<type operator="anyOf" xmlns="urn:common_2017_1.platform.webservices.netsuite.com">
<searchValue xmlns="urn:core_2017_1.platform.webservices.netsuite.com">_inventoryItem</searchValue>
</type>
</q1:basic>
<q1:pricingJoin>
<rate operator="equalTo" xmlns="urn:common_2017_1.platform.webservices.netsuite.com">
<searchValue xmlns="urn:core_2017_1.platform.webservices.netsuite.com">10</searchValue>
</rate>
</q1:pricingJoin>
</searchRecord>
</search>
</soap:Body>

Advanced Search Code Samples

The following advanced search samples are provided.

SuiteTalk SOAP Web Services Platform Guide

search 262

1. Perform a search that includes a saved search ID.

2. Perform a search with a defined page size.
3. Perform a search in which you override search columns in a saved search.
4. Perform a search in which you specify additional saved search criteria.
5. Programmatically manipulate data returned by a search

Perform a search that includes a saved search ID.

// Create a service
NetSuiteService nss = new NetSuiteService();

// Perform the search. Note that you can get the saved search ID using
// either getSavedSearch() or through the UI
TransactionSearchAdvanced tsa1 = new TransactionSearchAdvanced();
tsa1.savedSearchId="57"; //substitute your own saved search internal ID
nss.search(tsa1);

SOAP Request

SOAP Response

// The default is to return search rows

<platformCore:searchRow xsi:type="tranSales:TransactionSearchRow" xmlns:tranSales="urn:sales_2017_1.transactions.webservices.net
suite.com">
<tranSales:basic xmlns:platformCommon="urn:common_2017_1.platform.webservices.netsuite.com">
<platformCommon:account>
<platformCore:searchValue internalId="125"/>
</platformCommon:account>
<platformCommon:amount>
<platformCore:searchValue>12481.9</platformCore:searchValue>
</platformCommon:amount>
<platformCommon:entity>
<platformCore:searchValue internalId="78"/>
</platformCommon:entity>
<platformCommon:mainline>
<platformCore:searchValue>false</platformCore:searchValue>
</platformCommon:mainline>
<platformCommon:number>
<platformCore:searchValue>102</platformCore:searchValue>
</platformCommon:number>
<platformCommon:postingPeriod>
<platformCore:searchValue internalId="72"/>
</platformCommon:postingPeriod>
<platformCommon:tranDate>
<platformCore:searchValue>2005-02-10T00:00:00.000-08:00</platformCore:searchValue>
</platformCommon:tranDate>
<platformCommon:tranId>
<platformCore:searchValue>102</platformCore:searchValue>
</platformCommon:tranId>
<platformCommon:type>
<platformCore:searchValue internalId="SalesOrd"/>
</platformCommon:type>
</tranSales:basic>
</platformCore:searchRow>

SuiteTalk SOAP Web Services Platform Guide

search 263

Perform a search with a defined page size.

This sample performs the same search as the previous sample, however, you are specifying the number
of results that are returned per page.

TransactionSearchAdvanced tsa2 = new TransactionSearchAdvanced();

tsa2.savedSearchId="57"; //substitute your own saved search internal ID

// Set search preference to return search columns

SearchPreferences sp = new SearchPreferences();
sp.pageSizeSpecified = true;
sp.pageSize = 10;
nss.searchPreferences = sp;
nss.search(tsa2);

Perform a search in which you override search columns in a saved

search.
In this sample you are returning a specific saved search (57), and then overriding the search return
columns in the saved search and specifying your own search return columns.

TransactionSearchAdvanced tsa3 = new TransactionSearchAdvanced();

tsa3.savedSearchId="57"; //substitute your own saved search internal ID

// Set search preference to return search columns

// Already defined returnSearchColumns
//SearchPreferences sp = new SearchPreferences();
//sp.returnSearchColumns = true;
//nss.searchPreferences = sp;

// Instantiate SearchColumn object

TransactionSearchRow tsr = new TransactionSearchRow();
TransactionSearchRowBasic tsrb = new TransactionSearchRowBasic();

// return internId
SearchColumnSelectField [] orderIdCols = new SearchColumnSelectField[1];
SearchColumnSelectField orderIdCol = new SearchColumnSelectField();
orderIdCol.customLabel = "Sales Order ID"; // Define a custom label
orderIdCols[0] = orderIdCol;
tsrb.internalId = orderIdCols;

SearchColumnDateField [] tranDateCols = new SearchColumnDateField[1];

SearchColumnDateField tranDateCol = new SearchColumnDateField();
tranDateCols[0] = tranDateCol;
tsrb.tranDate = tranDateCols;
SearchColumnBooleanField [] isFulfilledCols = new SearchColumnBooleanField[1];
SearchColumnBooleanField isFulfilledCol = new SearchColumnBooleanField();
isFulfilledCol.customLabel = "Order Fulfilled"; // Define a custom label
isFulfilledCols[0] = isFulfilledCol;
tsrb.shipRecvStatus = isFulfilledCols;

tsr.basic = tsrb;
tsa3.columns = tsr;
nss.search(tsa3);

SOAP Request

SuiteTalk SOAP Web Services Platform Guide

search 264

<searchRecord xmlns:q1="urn:sales_2017_1.transactions.webservices.netsuite.com" xsi:type="q1:TransactionSearchAd

vanced" savedSearchId="57">
<q1:columns>
<q1:basic>
<internalId xmlns="urn:common_2017_1.platform.webservices.netsuite.com">
<customLabel xmlns="urn:core_2017_1.platform.webservices.netsuite.com">Sales Order ID
</customLabel>
</internalId>
<shipRecvStatus xmlns="urn:common_2017_1.platform.webservices.netsuite.com">
<customLabel xmlns="urn:core_2017_1.platform.webservices.netsuite.com">Order Fulfilled
</customLabel>
</shipRecvStatus>
<tranDate xmlns="urn:common_2017_1.platform.webservices.netsuite.com" />
</q1:basic>
</q1:columns>
</searchRecord>
</search>

SOAP Response

<platformCore:searchRow xsi:type="tranSales:TransactionSearchRow" xmlns:tranSales="urn:sales_2017_1.transactions.webservices.net

Perform a search in which you specify additional saved search criteria.

The next sample shows how to take a saved search and specify additional search filter criteria. The
additional search critera will not override the criteria already defined in the saved search.

TransactionSearchAdvanced tsa4 = new TransactionSearchAdvanced();

tsa4.savedSearchId="57";

TransactionSearch ts = new TransactionSearch();

TransactionSearchBasic tsb = new TransactionSearchBasic();
// condition 1: on SO only
SearchEnumMultiSelectField semsfTranType = new SearchEnumMultiSelectField();
semsfTranType.operatorSpecified = true;
semsfTranType.@operator = SearchEnumMultiSelectFieldOperator.anyOf;
String [] tranTypes = new String[1];
String tranType = "_salesOrder";
tranTypes[0] = tranType;
semsfTranType.searchValue = tranTypes;
tsb.type = semsfTranType;

// condition 2: tranId contains 182

SearchStringField sfTranId = new SearchStringField();
sfTranId.searchValue = "182"; // tranId contains 11
sfTranId.@operator = SearchStringFieldOperator.contains;
sfTranId.operatorSpecified = true;
tsb.tranId=sfTranId;

// condition 3: Is MultiShipping Routes enabled

SearchBooleanField sbfShipLineEnabled = new SearchBooleanField();
sbfShipLineEnabled.searchValue = true;
sbfShipLineEnabled.searchValueSpecified = true;

SuiteTalk SOAP Web Services Platform Guide

search 265

tsb.shipping = sbfShipLineEnabled;

// condition 4: Open SO
SearchBooleanField sbfTranStatus = new SearchBooleanField();
sbfTranStatus.searchValue = true;
sbfTranStatus.searchValueSpecified = true;
tsb.shipRecvStatusLine = sbfTranStatus;

ts.basic = tsb;
tsa4.criteria = ts;
tsa4.columns = tsr; //note - columns previously defined above.
nss.search(tsa4);

SOAP Request

<searchRecord xmlns:q1="urn:sales_2017_1.transactions.webservices.netsuite.com" xsi:type="q1:TransactionSearchAdvanced">

<q1:criteria>
<q1:basic>
<tranId operator="contains" xmlns="urn:common_2017_1.platform.webservices.netsuite.com">
<searchValue xmlns="urn:core_2017_1.platform.webservices.netsuite.com">182</searchValue>
</tranId>
<type operator="anyOf" xmlns="urn:common_2017_1.platform.webservices.netsuite.com">
<searchValue xmlns="urn:core_2017_1.platform.webservices.netsuite.com">_salesOrder
</searchValue>
</type>
</q1:basic>
</q1:criteria>
<q1:columns>
<q1:basic>
<internalId xmlns="urn:common_2017_1.platform.webservices.netsuite.com">
<customLabel xmlns="urn:core_2017_1.platform.webservices.netsuite.com">Sales Order ID
</customLabel>
</internalId>
<shipRecvStatus xmlns="urn:common_2017_1.platform.webservices.netsuite.com">
<customLabel xmlns="urn:core_2017_1.platform.webservices.netsuite.com">Order Fulfilled
</customLabel>
</shipRecvStatus>
<shipRecvStatusLine xmlns="urn:common_2017_1.platform.webservices.netsuite.com">
<customLabel xmlns="urn:core_2017_1.platform.webservices.netsuite.com">
Order Line Fulfilled</customLabel>
</shipRecvStatusLine>
<tranDate xmlns="urn:common_2017_1.platform.webservices.netsuite.com" />
<tranId xmlns="urn:common_2017_1.platform.webservices.netsuite.com" />
</q1:basic>
</q1:columns>
</searchRecord>

SOAP Request (with Shipping and ShipRecvStatusLine criteria)

<searchRecord xmlns:q1="urn:sales_2017_1.transactions.webservices.netsuite.com" xsi:type="q1:TransactionSearchAdvanced">

<q1:criteria>
<q1:basic>
<shipRecvStatus xmlns="urn:common_2017_1.platform.webservices.netsuite.com">
<searchValue xmlns="urn:core_2017_1.platform.webservices.netsuite.com">true</searchValue>
</shipRecvStatus>
<tranId operator="contains" xmlns="urn:common_2017_1.platform.webservices.netsuite.com">
<searchValue xmlns="urn:core_2017_1.platform.webservices.netsuite.com">11</searchValue>
</tranId>
<type operator="anyOf" xmlns="urn:common_2017_1.platform.webservices.netsuite.com">
<searchValue xmlns="urn:core_2017_1.platform.webservices.netsuite.com">_salesOrder
</searchValue>
</type>
</q1:basic>
</q1:criteria>
<q1:columns>
<q1:basic>
<internalId xmlns="urn:common_2017_1.platform.webservices.netsuite.com">
<customLabel xmlns="urn:core_2017_1.platform.webservices.netsuite.com">Sales Order ID
</customLabel>

SuiteTalk SOAP Web Services Platform Guide

search 266

</internalId>
<shipRecvStatus xmlns="urn:common_2017_1.platform.webservices.netsuite.com">
<customLabel xmlns="urn:core_2017_1.platform.webservices.netsuite.com">Order Fulfilled
</customLabel>
</shipRecvStatus>
<tranDate xmlns="urn:common_2017_1.platform.webservices.netsuite.com" />
</q1:basic>
</q1:columns>
</searchRecord>

SOAP Response

<platformCore:searchRow xsi:type="tranSales:TransactionSearchRow" xmlns:tranSales="urn:sales_2017_1.transactions.webservices.net

suite.com">
<tranSales:basic xmlns:platformCommon="urn:common_2017_1.platform.webservices.netsuite.com">
<platformCommon:internalId>
<platformCore:searchValue internalId="986"/>
<platformCore:customLabel>Sales Order ID</platformCore:customLabel>
</platformCommon:internalId>
<platformCommon:shipRecvStatusLine>
<platformCore:searchValue>true</platformCore:searchValue>
<platformCore:customLabel>Order Line Fulfilled</platformCore:customLabel>
</platformCommon:shipRecvStatusLine>
<platformCommon:tranDate>
<platformCore:searchValue>2008-09-11T00:00:00.000-07:00</platformCore:searchValue>
</platformCommon:tranDate>
</tranSales:basic>
</platformCore:searchRow>

Programmatically manipulate data returned by a search

Java

public void searchCustomerBySavedSearch() throws RemoteException {

this.login(true);

CustomerSearchAdvanced searchRecord = new CustomerSearchAdvanced();

searchRecord.setSavedSearchId("26"); // A saved customer search

SearchResult result = _port.search(searchRecord);

if( result.getTotalRecords() > 0 ) {

// retain the search ID to get more pages
String sSearchId = result.getSearchId();

SearchRowList rowList = result.getSearchRowList();

processRowList(rowList);

int iNumPages = result.getTotalPages();

for ( int i=2; i<=iNumPages; i++) {

result = _port.searchMoreWithId(sSearchId, i);
rowList = result.getSearchRowList();

processRowList(rowList);
}
}
}

public void processRowList(SearchRowList rowList) {

for (int i=0; i<rowList.getSearchRow().length; i++) {
CustomerSearchRow row = (CustomerSearchRow) rowList.getSearchRow(i);
CustomerSearchRowBasic basic = row.getBasic();

SearchColumnStringField companyName = basic.getCompanyName(0);

SuiteTalk SOAP Web Services Platform Guide

search 267

_console.write("Company Name: "+companyName.getSearchValue());

if (basic.getEmail(0).getSearchValue() != null) {
String email = basic.getEmail(0).getSearchValue();
_console.write("\tEmail: "+email);
}
if (basic.getPhone(0).getSearchValue() != null) {
String phone = basic.getPhone(0).getSearchValue();
_console.write("\tPhone: "+phone);
}
_console.writeLn("\n");
}
}

Searching for a Multi-select Custom Field

In the following code sample, the results for the custom transaction field custcolcolumnname are
returned.

Java

// transaction search by custom column field

TransactionSearchBasic transactionSearch = new TransactionSearchBasic();

SearchCustomFieldList searchCustomFieldList = new SearchCustomFieldList();

transactionSearch.setCustomFieldList(searchCustomFieldList);

// make the multiselectsearch

SearchMultiSelectCustomField searchMultiSelectCustomField = new SearchMultiSelectCustomField();

ListOrRecordRef listOrRecordRef = new ListOrRecordRef();

listOrRecordRef.setInternalId("3"); // the internal id of the custom list value
listOrRecordRef.setType("1"); // your custom list typeId

searchCustomFieldList.setCustomField(new SearchCustomField[]{searchMultiSelectCustomField});

// make the search expression

searchMultiSelectCustomField.setscriptId("custcolcolumnname"); //the name of the tx custom column
searchMultiSelectCustomField.setOperator(SearchMultiSelectFieldOperator.anyOf);

searchMultiSelectCustomField.setSearchValue(new ListOrRecordRef[] {listOrRecordRef});

SearchResult sr = _port.search(transactionSearch);

private void searchForMultiSelectCustomField()

{
if (_isAuthenticated)
{
_out.info("\nExecuting search ..... \n");
// transaction search by custom column field
TransactionSearch transactionSearch = new TransactionSearch();
TransactionSearchBasic transactionSearchBasic = new TransactionSearchBasic();

//Java - the SearchCustomFieldList is not used.

//SearchCustomFieldList searchCustomFieldList = new SearchCustomFieldList();
//transactionSearch.setCustomFieldList(searchCustomFieldList);
SearchMultiSelectCustomField searchMultiSelectCustomField = new
SearchMultiSelectCustomField();

// make the search expression

//the name of the transaction custom column

SuiteTalk SOAP Web Services Platform Guide

search 268

searchMultiSelectCustomField.scriptId = "custbody_multi_select";
searchMultiSelectCustomField.@operator = SearchMultiSelectFieldOperator.anyOf;
searchMultiSelectCustomField.operatorSpecified = true;
//custom list called colors with typei id 1, values blue - internalid 1, green - id2 etc
//we are looking for transactions which have transaction body field
//of type multi select set to color blue
ListOrRecordRef listOrRecordRef = new ListOrRecordRef();
listOrRecordRef.internalId = "3";
listOrRecordRef.typeId = "1";

searchMultiSelectCustomField.searchValue = new ListOrRecordRef[] { listOrRecordRef };

SearchCustomField[] searchCustomFieldList = new SearchCustomField[] {
searchMultiSelectCustomField };

//Java
//searchCustomFieldList.setCustomField(new SearchCustomField[]{searchMultiSelectCustomField});
transactionSearchBasic.customFieldList = searchCustomFieldList;
transactionSearch.basic = transactionSearchBasic;
SearchResult searchRes = _service.search(transactionSearch);
_out.info("\nSearch Result contains " + searchRes.totalRecords + " record(s) \n");
}
else
{
_out.info(
"\nCannot call search operation because there is no active session. " +
"You must be first logged on before attempting to call saved search.\n");
}
}

Search Issues and Best Practices for SOAP Web Services

and SuiteScript
You may encounter issues when a SOAP web services or SuiteScript search executed in NetSuite returns
multiple pages of results. These issues occur because records can be created, deleted, or updated as you
page through the search results. You can avoid the issues described here by following the recommended
best practices.

Potential Issues for SOAP Web Services and SuiteScript

Searches
Consider the following possible issues when you execute a search in SOAP web services or SuiteScript
that returns a large data set.

■ If a record that originally fit the search criteria is updated and no longer fits the criteria, it is skipped
by the search. In this case, some records that were originally included in the search results may not be
returned, and the total number of returned records may be smaller than the original total number of
results.
■ If new records are created that fit the search criteria, they are also returned. The total number of
returned records may be higher after you page through the results than the original total number of
results, and duplicate results may be returned.
■ Results may be missing. For example, if a record from the first results page is updated and it no longer
fits the criteria, another record now fits into page one. However, because earlier pages are skipped
when going through subsequent pages of search results, this record is not returned.
■ In SOAP web services, a greater or smaller number of records may be returned after you page
through the search results than the number of records that originally fit the search criteria.
■ Page two and the subsequent pages of the results set may contain fewer records than the specified
page size.

SuiteTalk SOAP Web Services Platform Guide

search 269

■ If new records of the same type, matching the search criteria, are created between a search request
and a searchMoreWithId request, it can cause position changes in the results and can move records
on or even out of search pages. This causes missing or duplicate records on pages.

Best Practices for Searches in SOAP Web Services and

SuiteScript
To avoid the issues associated with paging through search results, and for more reliable search results,
consider the following best practices.

■ Avoid using loosely defined search criteria that return a large data set. If a large data set is returned
and you must go through the results page by page, records may be missing or duplicated, because
the data may keep changing as you go through the pages of search results.
■ Make your search criteria as specific as possible. With more specific criteria, the result set is smaller
and there is less chance that records fitting the search criteria are created or updated as you go
through the pages of the result set.
■ If your search results fit into one page, you can avoid the issues that may occur when you page
through the result set.
■ Similarly, if you use more specific search criteria, there is less chance that records are updated in a way
that they no longer fit the criteria. You can avoid the issue of records missing from the result set.
■ Using a within lastModifedDate filter is the best solution to ensure new or updated records will not fit
the search criteria or to ensure that no new records are added or updated during your search.
■ In SuiteScript 2.0, as an alternative to using the N/search module, you can use the searchTask object
members and searchTaskStatus object members of the N/task Module when you search for large data
sets. Note that searchTask is an asynchronous search.
■ By creating a hybrid integration that uses SOAP web services and RESTlets, you can also use the N/task
module as an alternative to SOAP web services search.
■ In SOAP web services searches, use Advanced Searches and reference existing saved searches when
possible. This way you avoid performance issues like slow SQL and timeout. For more information, see
Advanced Searches in SOAP Web Services.

searchMoreWithId
Users who authenticate to NetSuite by providing their credentials in the SOAP header of their requests
must use searchMoreWithId to retrieve search results that span multiple pages.

The searchMoreWithId operation allows you to reference a specific search result set by its searchId, a
parameter included in all search results. As with searchMore, you must set the pageIndex value to specify
which page in the search to return.

Usage Notes
Consider the following information when you use the searchMoreWithId operation.

■ When you paginate through the search results, the searchMoreWithId operation triggers a new
search for the page specified by the pageIndex value. If records included in the search result set are
updated while you go through the result pages, and they do not match the earlier search criteria
anymore, they will be omitted from the results displayed on that page you specified. To avoid this, you
need to ensure that records are not modified while you are calling a search operation.

SuiteTalk SOAP Web Services Platform Guide

searchMoreWithId 270

■ Search IDs expire if they have not been used within 15 minutes after their creation.
Passing an expired or invalid searchId will return search results with a “failed” status and
StatusDetailCode=INVALID_JOB_ID.
■ There is no async equivalent for this operation.
■ For information about achieving the best search performance, see Search Issues and Best Practices
for SOAP Web Services and SuiteScript.

Request
The SearchMoreWithIdRequest type is used for the request. It contains the following fields.

Element Name XSD Type Notes

searchId string The search result ID.

pageIndex int An index that specifies which page in the search to return.

Response
The SearchMoreWithIdResponse type is used for the response. It contains the following fields.

Element Name XSD Type Notes

status Status The status for this search. All applicable errors or warnings will be listed
within this type.

totalRecords xsd:int The total number of records for this search. Depending on the pageSize
value, some or all the records may be returned in this response

pageSize xsd:int The page size for this search.

totalPages xsd:int The total number of pages that are part of this search.

pageIndex xsd:int The page index for the current set of results.

searchId string Returns a specific search based on its search ID.

recordList Record[] A list of records that meet the criteria for this search. The actual records
returned need to be of a type that extends the abstract type of record.

searchRowList SearchRowList A list of return columns that meet the criteria for this search.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault

SuiteTalk SOAP Web Services Platform Guide

searchMoreWithId 271

■ ExceededRequestSizeFault
■ UnexpectedErrorFault

Sample Code
The following samples show the SOAP for the initial search as well as the SOAP for subsequent
searchMoreWithId operation used to specify the next page of the search. The ID returned in the initial
search is specified as the searchId when executing searchMoreWithId.

Note: Prefix-to-namespace mappings have been omitted for readability.

SOAP Request for Initial Search

<soapenv:Envelope>
<soapenv:Header>
<platformMsgs:searchPreferences>
<platformMsgs:bodyFieldsOnly>true</platformMsgs:bodyFieldsOnly>
<platformMsgs:pageSize>100</platformMsgs:pageSize>
</platformMsgs:searchPreferences>
<platformMsgs:passport>
<platformCore:email>[email protected]</platformCore:email>
<platformCore:password><SOAP web services password></platformCore:password>
<platformCore:account>000034</platformCore:account>
<platformCore:role internalId="37"/>
</platformMsgs:passport>
</soapenv:Header>
<soapenv:Body>
<platformMsgs:search>
<searchRecord xsi:type="platformCommon:ContactSearchBasic">
<platformCommon:city operator="is" xsi:type="platformCore:SearchStringField">
<platformCore:searchValue xsi:type="xsd:string">San Francisco</platformCore:searchValue>
</platformCommon:city>
</searchRecord>
</platformMsgs:search>
</soapenv:Body>
</soapenv:Envelope>

SOAP Response for Initial Search

<soapenv:Envelope>
<soapenv:Header>
<platformMsgs:documentInfo>
<platformMsgs:nsId>WEBSERVICES_528736_07012008543995006307049233_d53ef4d2273b15<platformMsgs:nsId >
</platformMsgs:documentInfo>
</soapenv:Header>
<soapenv:Body>
<platformMsgs:searchResponse>
<platformCore:searchResult>
<platformCore:status isSuccess="true"/>
<platformCore:totalRecords>231</platformCore:totalRecords>
<platformCore:pageSize>100</platformCore:pageSize>
<platformCore:totalPages>3</platformCore:totalPages>
<platformCore:pageIndex>1</platformCore:pageIndex>
<platformCore: searchId > WEBSERVICES_528736_07012008543995006307049233_d53ef4d2273b15
<platformCore: searchId >
<platformCore:recordList>
<platformCore:recordList>
<platformCore:record internalId="4" externalId="entity-4" xsi:type="listRel:Contact">
<listRel:entityId>john</listRel:entityId>
<listRel:firstName>John</listRel:firstName>

SuiteTalk SOAP Web Services Platform Guide

searchMoreWithId 272

.....
</platformCore:record>
</platformCore:recordList>
</platformCore:searchResult>
</searchMoreWithIdResponse>
</soapenv:Body>
</soapenv:Envelope>

SOAP Request for Getting the Next Page Using

searchMoreWithId
<soapenv:Envelope>
<soapenv:Header>
<platformMsgs:searchPreferences>
<platformMsgs:bodyFieldsOnly>true</platformMsgs:bodyFieldsOnly>
<platformMsgs:pageSize>100</platformMsgs:pageSize>
</platformMsgs:searchPreferences>
<platformMsgs:passport>
<platformCore:email>[email protected]</platformCore:email>
<platformCore:password><SOAP web services password></platformCore:password>
<platformCore:account>000034</platformCore:account>
<platformCore:role internalId="37"/>
</platformMsgs:passport>
</soapenv:Header>
<soapenv:Body>
<platformMsgs:searchMoreWithId>
<searchId>WEBSERVICES_528736_07012008543995006307049233_d53ef4d2273b15</searchId>
<pageIndex>2</pageIndex>
</platformMsgs:searchMoreWithId>
</soapenv:Body>
</soapenv:Envelope>

SOAP Response for Getting the Next Page Using

searchMoreWithId
<soapenv:Envelope>
<soapenv:Header>
<platformMsgs:documentInfo>
<platformMsgs:nsId>WEBSERVICES_528736_07012008543995006307049233_d53ef4d2273b15</platformMsgs:nsId>
</platformMsgs:documentInfo>
</soapenv:Header>
<soapenv:Body>
<platformMsgs:searchMoreWithIdResponse>
<platformCore:searchResult>
<platformCore:status isSuccess="true"/>
<platformCore:totalRecords>231</platformCore:totalRecords>
<platformCore:pageSize>100</platformCore:pageSize>
<platformCore:totalPages>3</platformCore:totalPages>
<platformCore:pageIndex>1</platformCore:pageIndex>
<platformCore: searchId > WEBSERVICES_528736_07012008543995006307049233_d53ef4d2273b15
</platformCore: searchId >
<platformCore:recordList>
<platformCore:record internalId="5" externalId="entity-5" xsi:type="listRel:Contact">
<listRel:entityId>mike</listRel:entityId>
<listRel:firstName>Mike</listRel:firstName>
.....
</platformCore:record>
</platformCore:recordList>
</platformCore:searchResult>
</platformMsgs:searchMoreWithIdResponse>
</soapenv:Body>
</soapenv:Envelope>

SuiteTalk SOAP Web Services Platform Guide

searchMoreWithId 273

Java
public List<Contact> searchContactsByCity(NetSuitePortType port, String city) throws Exception
{
SearchResult searchResult = null; // search result for each page
Record [] contacts = null; // contacts for each page
List<Contact> consolidatedResults = new ArrayList<Contact>(); // to return

// build search criteria

ContactSearchBasic contactSearch = new ContactSearchBasic();
contactSearch.setCity(new SearchStringField(city, SearchStringFieldOperator.is));

// execute the search

searchResult = port.search(contactSearch);

if( searchResult.getTotalRecords() > 0 )

{
// retain the search ID to get more pages
String sSearchId = searchResult.getSearchId();

// process first page

contacts = searchResult.getRecordList().getRecord();
for (Record contact : contacts)
consolidatedResults.add((Contact)contact);

// process remaining pages using search ID

int iNumPages = searchResult.getTotalPages();
for ( int i=2; i<=iNumPages; i++)
{
// get the page
searchResult = port.searchMoreWithId(sSearchId, i);

// process the page

contacts = searchResult.getRecordList().getRecord();
for (Record contact : contacts)
consolidatedResults.add((Contact)contact);
}
}
return consolidatedResults;
}

ssoLogin
Warning: As of the NetSuite 2021.1 release, the ssoLogin operation is no longer available. This
affects all endpoints, and even though the SOAP schema remains for older endpoints, the method
is not working. For SOAP web services you must use token-based Aauthentication instead. For
more information, see the help topic Token-based Authentication (TBA).

update
The update operation is used to update an instance of a record in NetSuite. It is similar to the updateList
operation, which allows users to update more than one record at a time.

Only the fields that have been populated in each submitted record are updated in the system. If a field
has NOT been populated, it is not updated in the system and it retains its previous value. If a field is
set to an empty string, the previous value of the field is replaced with an empty string. Therefore, when
updating records, it is recommended that you get the desired record, instantiate a new record of the
same type, populate only the fields that require an update and then submit the updated record. This
ensures that only the fields requiring an update are written on submission.

SuiteTalk SOAP Web Services Platform Guide

update 274

Important: Calculated and hidden fields in records are always updated by the system unless
your service explicitly overrides the system values. For more information, see Hidden Fields.
Also, custom fields can only be set to NULL by submitting the field in nullFieldList. For more
information, see CustomFieldList.

To ensure that the most recent data for a specific record is being modified, when a Web service request
is received, the values for that record are retrieved at the time of the Update request rather than with the
initial Get of the associated record. The record is then updated by the values submitted in the request.
It is possible that between the time of the retrieval of the record field values and the submission of the
updated fields that the record is altered from another source (for example from a UI submission). In
this case an error message is returned to indicate that the fields have been modified since your service
retrieved the record.

Although records of a particular type may be used in multiple integration scenarios, each record instance
can only have a single external ID value. To maintain data integrity, only a single integrated application
can set and update external ID values for each record type. External ID values for all records of a
particular type must all come from the same external application.

Note: As of the 2011.2 endpoint, when a record is updated and the values that are sent are
exactly the same as the existing record values, the record is not reset (nothing happens). In
previous endpoints, sometimes records were reset in these cases.

Request
The UpdateRequest type is used for the request. It contains the following fields.

Element Name XSD Type Notes

record Record Contains an array of record objects. The record type is an abstract type so an
instance of a type that extends record must be used—such as Customer or
Event.

Response
The UpdateResponse type is used for the response. It contains the following fields.

Element Name XSD Type Notes

response WriteResponse Contains details on the status of the operation and a reference to the
updated record.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault

SuiteTalk SOAP Web Services Platform Guide

update 275

■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

Sample Code

SOAP Request
In the following example, a customer's companyName is updated. The internal ID for the customer must
be provided in the request.

<soap:Body>
<platformMsgs:update>
<platformMsgs:record internalId="980" xsi:type="listRel:Customer">
<listRel:companyName>Shutter Fly Corporation</listRel:companyName>
</platformMsgs:record>
</platformMsgs:update>
</soap:Body>

SOAP Response

<soapenv:Body>
<updateResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<writeResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<ns1:status isSuccess="true" xmlns:ns1="urn:core_2017_1.platform.webservices.netsuite.com"/>
<baseRef internalId="980" type="customer" xsi:type="ns2:RecordRef" xmlns:xsi="http://www.w3.org/2001/XMLSchema-
instance" xmlns:ns2="urn:core_2017_1.platform.webservices.netsuite.com"/>
</writeResponse>
</updateResponse>
</soapenv:Body>

private void updateCustomer()

{
// This operation requires a valid session
this.login( true );

Customer customer = new Customer();

// Get nsKey for update

_out.write( "\nEnter nsKey for customer record to be updated : " );
customer.internalId = _out.readLn().ToUpper();

// Set name and email

customer.entityId = "XYZ 2 Inc";
customer.companyName = "XYZ 2, Inc.";
customer.email = "[email protected]";

// Populate the address. Updating a list through WS results in the

// entire contents of the previous list being replaced by the new
// list.
CustomerAddressbook address = new CustomerAddressbook();
address.defaultBilling = true;
address.defaultBillingSpecified = true;
address.defaultBilling = false;

SuiteTalk SOAP Web Services Platform Guide

update 276

address.defaultBillingSpecified = true;
address.label = "Billing Address";
address.addr1 = "4765 Sunset Blvd";
address.city = "San Mateo";
address.state = "CA";
address.country = Country._unitedStates;

// Attach the address to the customer

// Invoke add() operation

WriteResponse response = _service.update( customer );

// Process the response

if ( response.status.isSuccess )
{
_out.info(
"\nThe following customer was updated successfully:" +
"\nkey=" + ((RecordRef) response.baseRef).internalId +
"\nentityId=" + customer.entityId +
"\ncompanyName=" + customer.companyName +
"\nemail=" + customer.email +
"\naddressbookList[0].label=" + customer.addressbookList.addressbook[0].label );
}
else
{
_out.error( getStatusDetails( response.status ) );
}
}

Java

public void updateCustomer() throws RemoteException,

ExceededUsageLimitFault, UnexpectedErrorFault, InvalidSessionFault,
ExceededRecordCountFault {
// This operation requires a valid session
this.login(true);

Customer customer = new Customer();

// Get nsKey for update

_console.write("\nEnter nsKey for customer record to be updated : ");
customer.setInternalId(_console.readLn().toUpperCase());

// Set name and email

customer.setEntityId("XYZ 2 Inc");
customer.setCompanyName("XYZ 2, Inc.");
customer.setEmail("[email protected]");

// Populate the address. Updating a list through WS results in the

// entire contents of the previous list being replaced by the new
// list.
CustomerAddressbook address = new CustomerAddressbook();
address.setDefaultBilling(Boolean.TRUE);
address.setDefaultShipping(Boolean.FALSE);
address.setLabel("Billing Address");
address.setAddr1("4765 Sunset Blvd");
address.setCity("San Mateo");
address.setState("CA");
address.setCountry(Country._unitedStates);

// Attach the address to the customer

CustomerAddressbookList addressList = new CustomerAddressbookList();
CustomerAddressbook[] addresses = new CustomerAddressbook[1];
addresses[0] = address;
addressList.setAddressbook(addresses);

SuiteTalk SOAP Web Services Platform Guide

update 277

customer.setAddressbookList(addressList);

// Invoke add() operation

WriteResponse response = _port.update(customer);

// Process the response

if (response.getStatus().isIsSuccess()) {
_console.info("\nThe following customer was updated successfully:"
+ "\nkey="
+ ((RecordRef) response.getBaseRef()).getInternalId()
+ "\nentityId="
+ customer.getEntityId()
+ "\ncompanyName="
+ customer.getCompanyName()
+ "\nemail="
+ customer.getEmail()
+ "\naddressbookList[0].label="
+ customer.getAddressbookList().getAddressbook(0)
.getLabel());
} else {
_console.error(getStatusDetails(response.getStatus()));
}
}

Updating Record Lists

When updating a list of records (a sublist) within a business record you CANNOT update a specific item
in the list. Instead you must interact with the sublist as a whole. For details, see Sublists in SOAP Web
Services.

updateList
The updateList operation is used to update one or more instances of a record type in NetSuite.

If there are multiple records, they can either be of the same record type or different record types. For
example, it's possible to update a customer and a contact within a single request using this operation.

Only the fields that have been populated in each submitted record are updated in the system. If a field
has not been populated, it is not updated in the system and it retains its previous value. If a field is set to
an empty string, the previous value of the field is replaced with an empty string.

Important: Calculated and hidden fields in records are always updated by the system unless
your service explicitly overrides the system values. For more information, refer to Hidden Fields.

Request
The UpdateListRequest type is used for the request. It contains the following fields.

SuiteTalk SOAP Web Services Platform Guide

updateList 278

Element Name XSD Type Notes

record[] Record Contains an array of record objects. The record type is an abstract type 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, asyncUpdateList. For

information about asynchronous request processing, see Synchronous Versus Asynchronous
Request Processing.

Response
The UpdateListResponse type is used for the response. It contains the following fields.

Element Name XSD Type Notes

response[] WriteResponse Contains an array of WriteResponse objects, each of which contains details
on the status of that update operation and a reference to the created record.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

Sample Code

SOAP Request
In the following example, two customer records are updated. The first has the single field companyName
updated, whereas the second updates two fields: entityID and companyName. The internalID for each
record must be provided and the type of record (Customer) to be updated.

<soap:Body>
<platformMsgs:updateList>
<platformMsgs:record internalId="980" xsi:type="listRel:Customer">
<listRel:companyName>Shutter Fly Corporation</listRel:companyName>
</platformMsgs:record>
<platformMsgs:record internalId="981" xsi:type="listRel:Customer">
<listRel:entityId>GNCC</listRel:entityId>
<listRel:companyName>GNCC Corp</listRel:companyName>
</platformMsgs:record>
</platformMsgs:updateList>

SuiteTalk SOAP Web Services Platform Guide

updateList 279

</soap:Body>

SOAP Response
<soapenv:Body>
<updateListResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<writeResponseList xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<writeResponse>
<ns1:status isSuccess="true" xmlns:ns1="urn:core_2017_1.platform.webservices.netsuite.com"/>
<baseRef internalId="980" type="customer" xsi:type="ns2:RecordRef" xmlns:xsi="http://www.w3.org/2001/XMLSchema-
instance" xmlns:ns2="urn:core_2017_1.platform.webservices.netsuite.com"/>
</writeResponse>
<writeResponse>
<ns3:status isSuccess="true" xmlns:ns3="urn:core_2017_1.platform.webservices.netsuite.com"/>
<baseRef internalId="981" type="customer" xsi:type="ns4:RecordRef" xmlns:xsi="http://www.w3.org/2001/XMLSchema-
instance" xmlns:ns4="urn:core_2017_1.platform.webservices.netsuite.com"/>
</writeResponse>
</writeResponseList>
</updateListResponse>
</soapenv:Body>

C#
private void updateCustomerList()
{
// This operation requires a valid session
this.login( true );

// Prompt for list of nsKeys and put in an array

_out.write( "\nEnter nsKeys for customer records to be updated (separated by commas): " );
String reqKeys = _out.readLn();
string [] nsKeys = reqKeys.Split( new Char[] {','} );

// Create an array of Record objects to hold the customers

Record[] records = new Record[nsKeys.Length];

// For each submitted nsKey, populate a customer object

for ( int i=0; i<nsKeys.Length; i++)
{
Customer customer = new Customer();

// Update name
customer.entityId = "XYZ Inc " + i;
customer.companyName = "XYZ, Inc. " + i;

customer.internalId = nsKeys[i].Trim();
records[i] = customer;
}

// Invoke updateList() operation to update customers

WriteResponse[] responses = _service.updateList( records );

// Process responses for all successful updates

_out.info( "\nThe following customers were updated successfully:" );
bool hasFailures = false;
for ( int i=0; i<responses.Length; i++ )
{
if ( (responses[i] != null) && (responses[i].status.isSuccess) )
{
_out.info( "\nCustomer[" + i + "]:" );
_out.info(
"key=" + ((RecordRef) responses[i].baseRef).internalId +
"\nentityId=" + ((Customer) records[i]).entityId +
"\ncompanyName=" + ((Customer) records[i]).companyName );
}
else
{

SuiteTalk SOAP Web Services Platform Guide

updateList 280

hasFailures = true;
}
}

// Process responses for all unsuccessful updates

if ( hasFailures )
{
_out.info( "\nThe following customers were not updated:\n" );
for ( int i=0; i<responses.Length; i++ )
{
if ( (responses[i] != null) && (!responses[i].status.isSuccess) )
{
_out.info( "Customer[" + i + "]:" );
_out.info( "key=" + ((RecordRef) responses[i].baseRef).internalId );
_out.errorForRecord( getStatusDetails( responses[i].status ) );
}
}
}
}

Java

public void updateCustomerList() throws RemoteException,

ExceededUsageLimitFault, UnexpectedErrorFault, InvalidSessionFault,
ExceededRecordCountFault {
// This operation requires a valid session
this.login(true);

// Prompt for list of nsKeys and put in an array

_console
.write("\nEnter nsKeys for customer records to be updated (separated by commas): ");
String reqKeys = _console.readLn();
String[] nsKeys = reqKeys.split(",");

// Create an array of Record objects to hold the customers

Record[] records = new Record[nsKeys.length];

// For each submitted nsKey, populate a customer object

for (int i = 0; i < nsKeys.length; i++) {
Customer customer = new Customer();

// Update name
customer.setEntityId("XYZ Inc " + i);
customer.setCompanyName("XYZ, Inc. " + i);

customer.setInternalId(nsKeys[i].trim());
records[i] = customer;
}

// Invoke updateList() operation to update customers

WriteResponseList responseList = _port.updateList(records);

// Process responses for all successful updates

WriteResponse[] responses = responseList.getWriteResponse();
boolean hasFailures = false;
_console.info("\nThe following customers were updated successfully:");
for (int i = 0; i < responses.length; i++) {
if ((responses[i] != null)
&& (responses[i].getStatus().isIsSuccess())) {
_console.info("\nCustomer[" + i + "]:");
_console.info("key="
+ ((RecordRef) responses[i].getBaseRef()).getInternalId()
+ "\nentityId="
+ ((Customer) records[i]).getEntityId()
+ "\ncompanyName="
+ ((Customer) records[i]).getCompanyName());
} else {
hasFailures = true;
}
}

SuiteTalk SOAP Web Services Platform Guide

updateList 281

// Process responses for all unsuccessful updates

if (hasFailures) {
_console.info("\nThe following customers were not updated:\n");
for (int i = 0; i < responses.length; i++) {
if ((responses[i] != null)
&& (!responses[i].getStatus().isIsSuccess())) {
_console.info("Customer[" + i + "]:");
_console.info("key="
+ ((RecordRef) responses[i].getBaseRef()).getInternalId());
_console.errorForRecord(getStatusDetails(responses[i]
.getStatus()));
}
}
}
}

updateInviteeStatus
The updateInviteeStatus operation lets users respond to NetSuite events that have been sent to them.
This operation takes both the internal ID of the event as well as a calendar event status as arguments.

After invitees have responded to the event invitation, the Event record is updated with their response.
Possible responses include accepted, declined, tentative, and noResponse.

Note the following:

■ For information on the Event record in SOAP web services, see the help topic Events (CalendarEvent).
For general information on scheduling events in NetSuite, see the help topic Scheduling Events.)
■ There is no async equivalent for the updateInviteeStatus operation.

Note the following when using this operation:

■ Users must have a valid session. This operation includes a passport header to support request level
credentials. (For information on request level authentication, see Request-Level Credentials.)
■ To update other properties on the Event record, the event owner should still use the update
operation. Note, however, event owners are not exempt from using updateInviteeStatus if they have
to update their own event response status. There may be cases in which event owners must decline
their own event and have another person run the event for them.
■ Unlike in the NetSuite UI, invitees will not be able to send a message back to the organizer. SOAP web
services does not currently support messages attached to events. An event invitee's response can
include only one of the following values: _accepted, _declined, _tentative, _noResponse.

Request
The UpdateInviteeStatusRequest type is used for the request.

Element Name XSD Type Notes

eventId RecordRef References an existing instance of an Event record.

responseCode CalendarEventAttendeeResponse The CalendarEventAttendeeResponse type includes the

following enums:

_accepted
_declined
_tentative
_noResponse

SuiteTalk SOAP Web Services Platform Guide

updateInviteeStatus 282

Response
The UpdateInviteeStatusResponse type is used for the response.

Element Name XSD Type Notes

response WriteResponse Contains details on the status of the operation and a reference to the
updated record.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

Sample Code

NetSuiteService nss = new NetSuiteService();

// login details omitted

UpdateInviteeStatusReference inviteeStatusRef = new UpdateInviteeStatusReference();

// Set the event id for the status update

RecordRef eventIdRef = new RecordRef();
eventIdRef.internalId = "100"; // Substitute this with your own event id
inviteeStatusRef.eventId = eventIdRef;

// Set the event status

inviteeStatusRef.responseCode = CalendarEventAttendeeResponse._accepted;

// Update invitee event status

WriteResponse resp = nss.updateInviteeStatus(inviteeStatusRef);

SOAP Request

<updateInviteeStatus xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<updateInviteeStatusReference>
<eventId internalId="100" xmlns="urn:core_2017_1.platform.webservices.netsuite.com" />
<responseCode xmlns="urn:core_2017_1.platform.webservices.netsuite.com">_accepted
</responseCode>
</updateInviteeStatusReference>
</updateInviteeStatus>

SuiteTalk SOAP Web Services Platform Guide

updateInviteeStatus 283

SOAP Response

updateInviteeStatusList
The updateInviteeStatusList operation is used to update one or more NetSuite events. For general details
on the updateInviteeStatus operation, see updateInviteeStatus.

Request
The UpdateInviteeStatusListRequest type is used for the request.

Element Name XSD Type Notes

updateInviteeStatusReference[] UpdateInviteeStatusReference UpdateInviteeStatusReference uniquely

identifies the event and the status you want
to update the event with.

The UpdateInviteeStatusReference type includes the following elements:

■ eventId
■ responseCode

Element Name XSD Type Notes

eventId RecordRef References an existing instance of an Event record.

responseCode CalendarEventAttendeeResponse The CalendarEventAttendeeResponse type includes the

following enums:

_accepted
_declined
_tentative
_noResponse

Response
The UpdateInviteeStatusListResponse type is used for the response.

Element Name XSD Type Notes

response[] WriteResponse Contains an array of WriteResponse objects, each of which contains details on
the status of that updateInviteeStatusList operation and a reference to each
event record.

SuiteTalk SOAP Web Services Platform Guide

updateInviteeStatusList 284

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

Sample Code

UpdateInviteeStatusReference [] inviteeStatusRefList = new UpdateInviteeStatusReference[2];

for (int i=0; i<2; i++)
{
RecordRef eventIdRef = new RecordRef();
if (i==0)
eventIdRef.internalId = "100";
else
eventIdRef.internalId = "101";
UpdateInviteeStatusReference statusRef = new UpdateInviteeStatusReference();
statusRef.eventId = eventIdRef;
statusRef.responseCode = CalendarEventAttendeeResponse._accepted;
inviteeStatusRefList[i] = statusRef;
}
nss.updateInviteeStatusList(inviteeStatusRefList);

SOAP Request

<updateInviteeStatusList xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<updateInviteeStatusReference>
<eventId internalId="100" xmlns="urn:core_2017_1.platform.webservices.netsuite.com" />
<responseCode xmlns="urn:core_2017_1.platform.webservices.netsuite.com">_accepted
</responseCode>
</updateInviteeStatusReference>
<updateInviteeStatusReference>
<eventId internalId="101" xmlns="urn:core_2017_1.platform.webservices.netsuite.com" />
<responseCode xmlns="urn:core_2017_1.platform.webservices.netsuite.com">_accepted
</responseCode>
</updateInviteeStatusReference>
</updateInviteeStatusList>

SOAP Response

SuiteTalk SOAP Web Services Platform Guide

updateInviteeStatusList 285

<baseRef internalId="100" type="calendarEvent" xsi:type="platformCore:RecordRef" xmlns:platform

Core="urn:core_2017_1.platform.webservices.netsuite.com"/>
</writeResponse>
<writeResponse>
<platformCore:status isSuccess="true" xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com"/>
<baseRef internalId="101" type="calendarEvent" xsi:type="platformCore:RecordRef" xmlns:platform
Core="urn:core_2017_1.platform.webservices.netsuite.com"/>
</writeResponse>
</writeResponseList>
</updateInviteeStatusListResponse>

upsert
The upsert operation is used to add a new instance or to update an instance of a record in NetSuite. It is
similar to the upsertList operation, which allows users to add or update more than one record at a time.

The upsert operation is similar to both the add and update operations, but upsert can be run without first
determining whether a record exists in NetSuite. A record is identified by its external ID and its record
type. If a record of the specified type with a matching external 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, upsert is supported only for records that support the
external ID field. Also, this operation prohibits the passing of internal ID values.

Note: To prevent duplicate records, NetSuite recommends using external IDs and the upsert
and upsertList operations to add records to NetSuite.

Limitations on upsert
■ Although records of a particular type may be used in multiple integration scenarios, each record
instance can only have a single external ID value. To maintain data integrity, only a single integrated
application can set and update external ID values for each record type. External ID values for all
records of a particular type must all come from the same external application.
■ Upsert cannot complete updates during an initialize / initializeList operation, when a record is
transformed into a record of another type. In this case, upsert only adds and does not update records.
■ Updates through the upsert operation are also subject to the same limitations as updates through the
update operation. For details of these limitations, see update.

Request
The UpsertRequest type is used for the request. It contains the following fields.

Element Name XSD Type Notes

record Record Contains an array of record objects. The record type is an abstract type so an
instance of a type that extends record must be used—such as Customer or
Event.

Response
The UpsertResponse type is used for the response. It contains the following fields.

SuiteTalk SOAP Web Services Platform Guide

upsert 286

Element Name XSD Type Notes

response WriteResponse Contains details on the status of the operation and a reference to
thecreated or updated record.

Faults
■ This operation can throw one of the following faults. See SOAP Fault Status Codes for more
information.
□ InvalidSessionFault
□ InvalidCredentialsFault
□ ExceededRequestLimitFault
□ ExceededUsageLimitFault
□ ExceededRecordCountFault
□ ExceededRequestSizeFault
□ UnexpectedErrorFault
■ This operation returns the following run-time error if the passed record type does not support the
external ID field:

INVALID_RCRD_TYPE: <record_type> does not support external ID and cannot be used with upsert

■ This operation returns the following run-time error if passed data includes internal ID:

USER_ERROR: You cannot set internalId with upsert.

■ This operation returns the following run-time error if passed data does not include external ID:

USER_ERROR: This operation requies a value for externalId.

For more information about error codes, see Error Status Codes.

Sample Code

SOAP Request
<soap:Body>
<upsert xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<record xmlns:q1="urn:relationships_2017_1.lists.webservices.netsuite.com" xsi:type="q1:Customer" exter
nalId="THISISMYEXTID">
<q1:entityId>XYZ 2 Inc</q1:entityId>
<q1:companyName>XYZ 2, Inc.</q1:companyName>
<q1:email>[email protected]</q1:email>
</record>
</upsert>
</soap:Body>

SOAP Response
<soapenv:Body>

SuiteTalk SOAP Web Services Platform Guide

upsert 287

C#
private void upsertCustomer()
{
// This operation requires a valid session
this.login( true );

Customer customer = new Customer();

// Get externalId for upsert

_out.write( "\nEnter externalId for customer record to be created or updated : " );
customer.externalId = _out.readLn().ToUpper();

// Set name and email

customer.entityId = "XYZ 2 Inc";
customer.companyName = "XYZ 2, Inc.";
customer.email = "[email protected]";

// Invoke upsert() operation

WriteResponse response = _service.upsert( customer );

// Process the response

if (response.status.isSuccess )
{
_out.info(
"\nThe upsert operation was successful :" +
"\ninternalId=" + ((RecordRef) response.baseRef).internalId +
"\nexternalId=" + ((RecordRef) response.baseRef).externalId +
"\nentityId=" + customer.entityId +
"\ncompanyName=" + customer.companyName);
} else {
_out.error( getStatusDetails( response.status ) );
}
}

Java
public void upsertCustomer() throws RemoteException,ExceededUsageLimitFault,
UnexpectedErrorFault, InvalidSessionFault,ExceededRecordCountFault
{
// This operation requires a valid session
this.login(true);
Customer customer = new Customer();

// Get extenalId for add or update

_console.write("\nEnter externalId for customer record to be updated : ");
customer.setExternalId(_console.readLn());

// Set name and email

customer.setEntityId("XYZ 2 Inc");
customer.setCompanyName("XYZ 2, Inc.");
customer.setEmail("[email protected]");

// Invoke upsert() operation

WriteResponse response = _port.upsert(customer);

// Process the response

if (response.getStatus().isIsSuccess())

SuiteTalk SOAP Web Services Platform Guide

upsert 288

{
_console.info("\nThe following customer was created/updated successfully:"
+ "\nkey=" + ((RecordRef) response.getBaseRef()).getInternalId()
+ "\nexternalId=" + ((RecordRef) response.getBaseRef()).getExternalId()
+ "\nentityId=" + customer.getEntityId()
+ "\ncompanyName=" + customer.getCompanyName()
+ "\nemail=" + customer.getEmail());
}
else
{
_console.error(getStatusDetails(response.getStatus()));
}
}

upsertList
The upsertList operation is used to add or update one or more instances of a record type in NetSuite.

If there are multiple records, they can either be of the same record type or different record types. For
example, it's possible to add or update a customer and a contact within a single request using this
operation.

The upsertList operation is similar to both the addList and updateList operations, but upsert can be run
without first determining whether records exist in NetSuite. Records are identified by their external ID and
their record type. If a record of the specified type with a matching external 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 records that support
the external ID field. Also, this operation prohibits the passing of internal ID values.

Note: To prevent duplicate records, NetSuite recommends using external IDs and the upsert
and upsertList operations to add records to NetSuite.

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. To maintain data integrity, only a single integrated
application can set and update external ID values for each record type. External ID values for all
records of a particular type must all come from 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, upsertList only adds and does not update
records.
■ Updates through the upsertList operation are also subject to the same limitations as updates through
the updateList operation. For details of these limitations, see updateList.

Request
The UpsertListRequest type is used for the request. It contains the following fields.

Element Name XSD Type Notes

record[] Record Contains an array of record objects. The record type is an abstract type so an
instance of a type that extends record must be used—such as Customer or
Event.

SuiteTalk SOAP Web Services Platform Guide

upsertList 289

Note: An asynchronous equivalent is available for this operation, asyncUpsertList. For

information about asynchronous request processing, see Synchronous Versus Asynchronous
Request Processing.

Response
The UpsertListResponse type is used for the response. It contains the following fields.

Element Name XSD Type Notes

response[] WriteResponse Contains an array of WriteResponse objects, each of which contains details on
the status of that upsert operation and a reference to the created or updated
record.

Faults
This operation can throw one of the following faults. See SOAP Fault Status Codes for more information
on faults.

■ InvalidSessionFault
■ InvalidCredentialsFault
■ ExceededRequestLimitFault
■ ExceededUsageLimitFault
■ ExceededRecordCountFault
■ ExceededRequestSizeFault
■ UnexpectedErrorFault

This operation returns the following run-time error if the passed record type does not support the
external ID field:

INVALID_RCRD_TYPE: <record_type> does not support external ID and cannot be used with upsert

This operation returns the following run-time error if passed data includes internal ID:

USER_ERROR: You cannot set internalId with upsert.

This operation returns the following run-time error if passed data does not include external ID:

USER_ERROR: This operation requies a value for externalId.

For more information about error codes, see Error Status Codes.

Sample Code

SOAP Request
<soap:Body>

SuiteTalk SOAP Web Services Platform Guide

upsertList 290

SOAP Response
<soapenv:Body>
<upsertListResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<writeResponseList>
<writeResponse>
<platformCore:status isSuccess="true" xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com"/>
<baseRef internalId="970" externalId="ext1" type="customer" xsi:type="platformCore:RecordRef" xmlns:platform
Core="urn:core_2017_1.platform.webservices.netsuite.com"/>
</writeResponse>
<writeResponse>
<platformCore:status isSuccess="true" xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com"/>
<baseRef internalId="974" externalId="ext2" type="customer" xsi:type="platformCore:RecordRef" xmlns:platform
Core="urn:core_2017_1.platform.webservices.netsuite.com"/>
</writeResponse>
</writeResponseList>
</upsertListResponse>
</soapenv:Body>

C#
private void upsertCustomerList()
{
// This operation requires a valid session
this.login( true );

// Prompt for list of externalIds and put in an array

_out.write( "\nEnter externalIds for customer records to be updated (separated by commas): " );
String reqKeys = _out.readLn();
string [] nsKeys = reqKeys.Split( new Char[] {','} );

// Create an array of Record objects to hold the customers

Record[] records = new Record[nsKeys.Length];

// For each submitted nsKey, populate a customer object

for ( int i=0; i<nsKeys.Length; i++)
{
Customer customer = new Customer();

// Update name
customer.entityId = "XYZ Inc " + i;
customer.companyName = "XYZ, Inc. " + i;

customer.externalId = nsKeys[i].Trim();
records[i] = customer;
}

// Invoke upsertList() operation to create or update customers

WriteResponse[] responses = _service.upsertList( records );

// Process responses for all successful updates

_out.info( "\nThe following customers were updated or created successfully:" );

bool hasFailures = false;

for ( int i=0; i<responses.Length; i++ )

SuiteTalk SOAP Web Services Platform Guide

upsertList 291

{
if ( (responses[i] != null) && (responses[i].status.isSuccess) )
{
_out.info( "\nCustomer[" + i + "]:");
_out.info( "internalId=" + ((RecordRef) responses[i].baseRef).internalId + " externalId="+((RecordRef)
responses[i].baseRef).externalId +
"\nentityId=" + ((Customer) records[i]).entityId +
"\ncompanyName=" + ((Customer) records[i]).companyName );
}
else
{
hasFailures = true;
}
}

// Process responses for all unsuccessful updates

Java

public void upsertCustomerList() throws RemoteException,ExceededUsageLimitFault,

UnexpectedErrorFault,InvalidSessionFault,ExceededRecordCountFault
{
// This operation requires a valid session
this.login(true);

// Prompt for list of externalIds and put in an array

_console.write("\nEnter externalIds for customer records to be updated (separated by commas): ");
String reqKeys = _console.readLn();
String[] nsKeys = reqKeys.split(",");

// Create an array of Record objects to hold the customers

Record[] records = new Record[nsKeys.length];

// For each submitted nsKey, populate a customer object

for (int i = 0; i < nsKeys.length; i++)
{
Customer customer = new Customer();

// Update name
customer.setEntityId("XYZ Inc " + i);
customer.setCompanyName("XYZ, Inc. " + i);
customer.setExternalId(nsKeys[i].trim());

records[i] = customer;
}

// Invoke upsertList() operation to create or update customers

WriteResponseList responseList = _port.upsertList(records);

// Process responses for all successful upserts

WriteResponse[] responses = responseList.getWriteResponse();

boolean hasFailures = false;

_console.info("\nThe following customers were processed successfully:");

for (int i = 0; i < responses.length; i++)

SuiteTalk SOAP Web Services Platform Guide

upsertList 292

{
if ((responses[i] != null) && (responses[i].getStatus().isIsSuccess()))
{
_console.info("\nCustomer[" + i + "]:");
_console.info("key=" + ((RecordRef) responses[i].getBaseRef()).getInternalId()
+ "\nexternalId=" + ((RecordRef) responses[i].getBaseRef()).getExter
nalId()
+ "\nentityId=" + ((Customer) records[i]).getEntityId()
+ "\ncompanyName=" + ((Customer) records[i]).getCompanyName());
}
else
{
hasFailures = true;
}
}

// Process responses for all unsuccessful updates

if (hasFailures)
{
_console.info("\nThe following customers were not updated:\n");
for (int i = 0; i < responses.length; i++)
{
if ((responses[i] != null) && (!responses[i].getStatus().isIsSuccess()))
{
_console.info("Customer[" + i + "]:");
_console.info("key=" + ((RecordRef) responses[i].getBaseRef()).getInter
nalId());
_console.errorForRecord(getStatusDetails(responses[i].getStatus()));
}
}
}

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services PHP Toolkit 293

SOAP Web Services PHP Toolkit

If you are new to PHP and SOAP web services, you should review the following topics:

■ PHP Toolkit Overview

■ Downloading the PHP Toolkit
■ Configuring an Environment for the PHP Toolkit
■ Creating a SOAP Web Services PHP Project
■ Creating and Submitting Records Using the PHP Toolkit
■ Logging SOAP Requests and Responses Using the PHP Toolkit

If you run into issues during your development, see Troubleshooting PHP and SOAP Web Services.

Important: Using PHP scripts with SOAP web services requires PHP version 5.6 or later.

PHP Toolkit Overview

NetSuite provides a library and tools to assist in the development of PHP applications that interface to the
SOAP web services platform.
The NetSuite PHP toolkit for SOAP web services is a core library containing all classes, objects and
methods parsed from the WSDL of a SOAP web services endpoint. The toolkit also comes with several
helper functions that can be used to simplify working with arrays and objects.

Important: Each PHP Toolkit is specific to a SOAP web services endpoint. You must download
the correct version of the toolkit for the endpoint you are using. Also, updating to a new endpoint
requires an update of the toolkit. To use the 2022.2 PHP Toolkit, you must upgrade to the
2022.2 WSDL. The 2022.2 PHP Toolkit does not officially support different WSDL versions.

Updating Existing PHP Code

NetSuite offered a completely revamped PHP Toolkit as part of 2012.2. As of 2012.2, the PHP Toolkit has
the ability to generate proxy classes for every new NetSuite WSDL, creating a development environment
similar to Axis or .NET.
Additionally, the new toolkit uses a different programming model (the use of proxy classes over pure
associative arrays, though the latter is still supported).
If you upgrade to any version of the PHP Toolkit later than 2012.2, existing PHP applications created using
previous versions of the toolkit will need to be updated. To understand the nature of the coding changes,
see the table below. Also see the sample applications that come with the new toolkit.

PHP Toolkit 2012.2 and Later PHP Toolkit Versions Older than 2012.2

Record object Each record type can now be initialized using Initialize the object using the object
initialization the same record type name. nsComplexObject.

Example - To initialize a Customer record object: Example - To initialize a Customer record

object:
$CustomerRec = new Customer();
$CustomerRec = new
nsComplexObject(‘Customer');

Object type Each complex, search and custom field type is These objects are initialized using the
Initialization initialized using the same object type name: object nsComplexObject.

SuiteTalk SOAP Web Services Platform Guide

PHP Toolkit Overview 294

PHP Toolkit 2012.2 and Later PHP Toolkit Versions Older than 2012.2
All object types Example - To initialize a basic search for Example - To initialize a basic search for
are listed and customers: customers:
explained in Platform
Enumerations. $selectTypeField = new RecordRef(); $search = new nsComplexObject
(‘CustomerSearchBasic');
To initialize a recordRef object:
To initialize a recordRef object:
$selectTypeField = new RecordRef();
$selectTypeField = new nsComplexObject
(‘RecordRef');

Calling the NetSuite The operations are called from the service The operations are called from the client
SOAP web services object instantiated from the NetSuiteService object instantiated from the nsClient class
operations class (NetSuiteService.php). (declared on the phptoolkit.php).

Example - Example -

$service = new NetSuiteService(); $myNSclient = new nsClient( nsHost::live );

… …

$addResponse = $service->add($request); $addResponse = $myNSclient-

>add($contact);

Request object You must instantiate a request object None. The record object is directly set to
depending on the kind of operation. This the operation.
request object will accept the Record object,
which will then be set to the operation. Each Example - To add a customer:
operation has a corresponding request type. $CustomerRec = new
nsComplexObject(‘Customer');
■ AddRequest for add operation
■ AddListRequest for addList operation …

■ SearchRequest for search operation. $addResponse = $myNSclient-

>add($CustomerRec);
Example - To add a customer:

$service = new NetSuiteService();

$CustomerRec = new Customer();

$request = new AddRequest();

$request->record = $CustomerRec;

$addResponse = $service->add($request);

The setFields method A function to set an array of field objects to the This is a method of the record object
record object. used to set the array of field values to the
record.
Example -
Example -
$customerRec = new Customer();
$customerFields = array (
$customerFields = array (
'isPerson' => true,
'isPerson' => true, 'firstName' => $firstName,
'firstName' => $firstName, 'lastName' => $lastName,
'lastName' => $lastName, 'companyName' => $companyName
'companyName' => $companyName
);
);
// create Customer record
setFields($customerRec, $ customerFields);
$customer = new nsComplexObject
('Customer');

SuiteTalk SOAP Web Services Platform Guide

PHP Toolkit Overview 295

PHP Toolkit 2012.2 and Later PHP Toolkit Versions Older than 2012.2
// set fields
$customer->setFields($customerFields);

Downloading the PHP Toolkit

To download the 2022.2 PHP Toolkit, click the link for the PHPToolkit_2022_2.zip file.

Note: If your browser does not download the PHP Toolkit zip file, copy the link and paste it in
the address bar of a new tab or window of your browser. If needed, you can also try a different
browser.

The toolkit is provided as an archive file and contains:

■ A folder called PHPToolkit that contains:

□ NetSuiteService.php – Class library
□ NSconfig.php – Passport configuration file
□ NSPHPClient.php – Helper functions
■ A folder called Samples that contains PHP code examples that are usable in your own projects.

Next see, Configuring an Environment for the PHP Toolkit.

Configuring an Environment for the PHP Toolkit

You can run PHP scripts from the command line by installing a PHP interpreter. Command line scripts are
suitable for stand-alone applications and are useful for scripting and testing. See Installing PHP for the
Command Line for more details.

The PHP Toolkit's real power, however, is in the ability to use a web server-based PHP interpreter module
to integrate NetSuite into an existing web presence, whether it is an external e-commerce website, or an
intranet-only Human Resources portal, for example.

A web server executes a PHP script through the included PHP interpreter module. PHP scripts can be text
files containing PHP code, or they can be HTML web pages containing PHP tags indicating sections of PHP
code. See Installing a Web Server for PHP for more details.

Note: For information on downloading the PHP Toolkit, see Downloading the PHP Toolkit.

Installing PHP for the Command Line

Many distributions of Linux and Mac OS X® are pre-installed with PHP. Packages for Windows® can be
obtained from http://windows.php.net/download/.

After PHP is installed, you need to edit the php.ini file. The PHP Toolkit needs to use certain libraries that
are not enabled in a PHP installation by default.

In the php.ini configuration file, in the section [Dynamic Extensions], the following lines need to be added
if they do not exist:

extension=php_soap.dll
extension=php_openssl.dll

SuiteTalk SOAP Web Services Platform Guide

Configuring an Environment for the PHP Toolkit 296

The modules indicated by the .dll extensions pertains to a Windows installation. If you are configuring a
Unix-based platform, change .dll to .so:

extension=php_soap.so
extension=php_openssl.so

Note: For a Windows installation of PHP, change the caching directory to something similar to:

soap.wsdl_cache_dir="c:/Windows/Temp"

Installing a Web Server for PHP

Note: This section talks about using Apache Web Server, but any web server that supports PHP,
SSL, and SOAP should be able to be used for SOAP web services.

The simplest way to provision a web server for the PHP Toolkit is to install a LAMP package. LAMP is the
acronym for Linux, Apache, MySQL, and PHP. After a LAMP package is installed, a complete web server
with database and PHP scripting functionality is available with little configuration required. The PHP
Toolkit does require, however, that you make a few modifications to the default LAMP installation.

Note: There are several LAMP distributions available free of charge for most computer
architectures. A well known package for Windows® is WAMP, which is available at http://
www.wampserver.com/en/. Follow the instructions that come with the package to install and
initially configure it.

After LAMP is installed, the php.ini and the httpd.conf configuration files need to be edited. Note that
the LAMP installation will not use any existing PHP installation; it will install its own self-contained PHP
package.

In the php.ini configuration file, in the section [Dynamic Extensions], the following lines need to be added
if they do not exist:

extension=php_soap.dll
extension=php_openssl.dll

The modules indicated by the .dll extensions pertains to a Windows installation. If you are configuring a
Unix-based platform, change .dll to .so :

extension=php_soap.so
extension=php_openssl.so

The Apache Web Server needs to be told to load the PHP module so that it can run PHP scripts. In the
httpd.conf configuration file in the section Dynamic Shared Object Support, the following line must
be added. (Note that the line may already exist; in that case check that the path to the PHP module is
correct.)

LoadModule php5_module C:\<PATH TO PHP>\modules\libphp5.dll

The module indicated by the .dll extension pertains to a windows installation. If you are configuring
a Unix-based platform, the PHP module will have a .so extension. Note also that the path to the PHP
module will differ:

LoadModule php5_module /<PATH TO PHP>/bin/php/modules/libphp5.so

SuiteTalk SOAP Web Services Platform Guide

Configuring an Environment for the PHP Toolkit 297

Important: As indicated in these examples, the name of the module is libphp5.dll or libphp5.so,
but be aware that SOAP web services requires PHP 5.6 or later. In other words, the name of the
module is not specific to the exact PHP version. (However, the exact version is likely indicated by
the <PATH TO PHP> folder name.)

Important: After a change to any configuration files, LAMP's services must be restarted.

Important: If you are running PHP scripts from the command line and through a web server,
there will be two php.ini files that need to be edited, one for the command line PHP installation,
and one provided by the LAMP installation.

Note: For a Windows installation of PHP, change the caching directory to something similar to:

soap.wsdl_cache_dir="c:/Windows/Temp"

Creating a SOAP Web Services PHP Project

For each project you need to perform the following steps:

1. Copy the PHPToolkit directory to the directory in your IDE where your project resides.
2. Edit the NSconfig.php file, substituting your own account details.
3. If SOAP logging is required, create a folder called nslog inside the PHPToolkit folder. See Logging
SOAP Requests and Responses Using the PHP Toolkit for more details.
4. Each solution needs to include the NetSuiteService.php file by adding the following line to the
main source file:

require_once '../PHPToolkit/NetSuiteService.php';

This step will prompt most IDEs to parse the NetSuiteService.php file for auto completion
information.
5. Instantiate a service:

$service = new NetSuiteService();

Important: Each time you upgrade your NetSuite endpoint, for example from WSDL version
2022.1 to 2022.2, you will also need upgrade the NetSuiteService.php class library to take
advantage of any new features.

In 2016.1, token-based authentication support was added to the PHPToolkit.

The following guidelines should be followed when using token-based authentication with PHPToolkit:

■ Each request requires a unique TokenPassport

■ NetSuite does not generate TokenPassports. You must provide your own implementation of
iTokenPassportGenerator
■ You configure NetSuite to use your iTokenPassportGenerator by calling the setTokenGenerator:

$generator = new MyTokenPassportGenerator();

$service->setTokenGenerator($generator);

SuiteTalk SOAP Web Services Platform Guide

Creating a SOAP Web Services PHP Project 298

For more information about token-based authentication, see the help topic Token-based Authentication
(TBA).

Creating and Submitting Records Using the PHP

Toolkit
These sections provide basic examples for creating and submitting NetSuite records using the PHP
toolkit.

■ Creating a Record with PHP

■ Creating a Record with the setFields Method
■ Submitting a Record

Creating a Record with PHP

The following example shows how to create and submit a Purchase Order. In this case, the Purchase
Order object is created then populated one field at a time.

Note that after the Purchase Order is instantiated, the IDE should automatically start suggesting
members of the PurchaseOrder object using its code completion mechanism.

// Include the PHP Toolkit Library

require_once '../PHPToolkit/NetSuiteService.php';

// Instantiate a service
$service = new NetSuiteService();

// Create Purchase Order object

$po = new PurchaseOrder();

// Create entity record

$po->entity = new RecordRef();

// PO internal ID = 38
$po->entity->internalId = 38;

// Create PO Item sublist

$po->itemList = new PurchaseOrderItemList();

// Create PO Item
$poi = new PurchaseOrderItem();
$poi->item = new RecordRef();

// Set Item details

$poi->item->internalId = 15;
$poi->quantity = 5;

// Attach items array to PO

$po->itemList->item = array($poi);

Creating a Record with the setFields Method

An alternative method to create the object is to use array notation to set the object fields. The advantage
is more compact code; the disadvantage is that code completion will not work.

The following example creates the same Purchase Order object using the setFields method:

SuiteTalk SOAP Web Services Platform Guide

Creating and Submitting Records Using the PHP Toolkit 299

// Create the Purchase Order object

$po = new PurchaseOrder();

// Create array of fields

$purchaseOrderFields = array('entity' => array('internalId' => 38), 'itemList' => array('item' => array( array('item' => array('in
ternalId' => 15), 'quantity' => 5)) ) );

// Call setFields to recursively create objects and populate their fields

setFields($po, $purchaseOrderFields);

In addition to creating and populating objects, the setFields method performs basic type and field
checking to make sure the array structure corresponds to the expected object hierarchy and types.

Note: The setFields method is defined in the NSPHPClient.php helper file, which is included
automatically by NetSuiteService.php

Submitting a Record
After the object is created and populated, the object can be submitted to NetSuite in one of the
operations supported by the type of object you have created. The following code sample shows the add
operation:

// Create Add request

$request = new AddRequest();

// Attach the Purchase Order to the request

$request->record = $po;

// Submit the record and save the response

$addResponse = $service->add($request);

The add operation returns a ReadResponse object that is used to access the result of the operation. The
following code sample reads and displays a simple textual indication of the result:

if (!$addResponse->writeResponse->status->isSuccess)
{
echo "ADD ERROR";
}
else
{
echo "ADD SUCCESS, id " . $addResponse->writeResponse->baseRef->internalId;
}

Note: The PHP Toolkit package contains more code examples in the Samples folder.

Logging SOAP Requests and Responses Using the

PHP Toolkit
To enable SOAP logging with the PHP Toolkit, create a folder called nslog in the PHPToolkit folder inside
the project. The PHP Toolkit will automatically spool the SOAP requests generated by the PHP code, and
the responses that have been returned by the server, into the nslog folder in standard XML format.

The following listing shows the typical project structure when logging is enabled:

Project_1 <Directory>

SuiteTalk SOAP Web Services Platform Guide

Logging SOAP Requests and Responses Using the PHP Toolkit 300

PHPToolkit.php
NSconfig.php
NetSuiteService.php
nslog <Directory>
20120317.160138.6941-add-request.xml
20120317.165167.8345-add-response.xml
20120317.180653.3467-delete-request.xml
20120317.187474.3356-delete-response.xml
...

Note: To disable logging, rename or delete the nslog folder.

Troubleshooting PHP and SOAP Web Services

The following table provides solutions for problems that may be encountered when using PHP with
NetSuite’s SOAP web services.

Problem Solution

The following error is returned when attempting to Edit the php.ini file by uncommenting "extension=php_openssl.dll"
send requests over https: under Dynamic Extensions.

Fatal error: Uncaught SoapFault exception: [WSDL] Windows only: Make sure that libeay32.dll and ssleay32.dll files are
SOAP-ERROR: Parsing WSDL: Couldn't load from in your path. You can do this by copying the files to your System32
'https://webservices.netsuite.com/wsdl/v2017_2_0/ folder.
netsuite.wsdl'.

The following time out error is returned: Edit the php.ini file and change max_execution_time - 30 (or default
value) to 200.
Fatal error: Maximum execution time of 30 seconds
exceeded.

The following error message is returned: Edit the php.ini file and by setting default_socket_timeout = 200.

Debug Error: Uncaught SoapFault exception: [HTTP]

Error Fetching http headers.

The following error message is returned: Open the php.ini file and edit error_reporting. Set it to E_ERROR
instead of E_ALL.
Warning: It is not yet possible to assign complex types
to properties.

The execution of script stops and error was not shown, Open the php.ini file and set error_reporting = E_ERROR &
or notices are being shown on the page. ~E_NOTICE.

The following error is returned: Open the php.ini file and set memory_limit = 80M.

Fatal error: Allowed memory size of 8388608 bytes

exhausted (tried to allocate 3024 bytes).

Performance issue: For a non-Windows installation of PHP, look for property

soap.wsdl_cache_dir in the php.ini file and make sure that the
Every time a SOAP web services request executes, PHP specified folder ("/tmp" -> c:\tmp) exists in the host.
performs a GET on the wsdl.

Note: For a Windows installation of PHP, change

the caching directory to something similar to:
soap.wsdl_cache_dir="c:/Windows/Temp"

Also, since a NetSuite WSDL version does not change after its
release, you can increase the wsdl_cache_ttl to six months, until the
release of the next WSDL version. This way you avoid downloading
the WSDL multiple times, limiting the available room for errors and
performance issues.

SuiteTalk SOAP Web Services Platform Guide

Troubleshooting PHP and SOAP Web Services 301

Problem Solution

You have made a change in your php.ini file, yet the Make sure that the property exists only one time in the php.ini file.
value you set is not respected.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Error Handling and Error Codes 302

SOAP Web Services Error Handling and

Error Codes
This section provides information on the following:

■ The three exception types that are supported in SOAP web services: warnings, errors, and faults. See
SOAP Web Services Warnings, Errors, and Faults for an overview.
■ SOAP Faults that can be thrown for each operation. See SOAP Faults for Each Operation.
■ □ SOAP Fault Status Codes
□ Error Status Codes
□ Warning Status Codes

SOAP Web Services Warnings, Errors, and Faults

Based on the error code or fault that is received, the client can take the appropriate action.

■ Warnings: informational notifications requiring an action within the UI but requiring no response from
a Web service call. Data may or may not be processed depending on preference settings. For more
information on preferences, see Company-Wide Preferences.
■ Errors: exceptions returned on a record-by-record basis due to invalid or incomplete data. The service
is processed as requested, however, only those records without errors are updated.
■ Faults: a fundamental exception type that results in the entire request not being processed.

Warnings
A warning is a notification sent to a user to prevent a subsequent error or to ensure better data quality. In
the Netsuite UI, a warning is presented to the user through a dialog box and generally requires an action
from the user. Since there is no interaction of this nature in the SOAP web services model, the request
must specify what to do in the case of a warning. The options are:

■ Ignore the warning and submit the record to the database

■ Heed the warning and abort the submission — treat as an error

You can set a company wide preference on the SOAP Web Services Preferences page on how to handle
warnings or you can specify how warnings should be handled in a specific request. Request level
preferences override company-wide preferences. Refer to Company-Wide Preferences for information on
how to set company-wide preferences.
Following is an example of a warning message in the response to a request to add a customer record
without a zip code (with the Treat Warnings as Errors preference set to false):

Code
<addResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<writeResponse>
<platformCore:status isSuccess="true" xmlns:platformCore="urn:core.platform_2017.1.platform.webservices.netsuite.com">
<platformCore:statusDetail type="WARN">
<platformCore:code>WARNING</platformCore:code>
<platformCore:message>Without a zip/postal code it will not be possible to use
this address with 3rd Party shippers. Click Cancel to edit the address.
</platformCore:message>
</platformCore:statusDetail>

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Warnings, Errors, and Faults 303

</platformCore:status>
<baseRef internalId="50" type="customer" xsi:type="platformCore:RecordRef" xmlns:platformCore="urn:core.platform_2017.1.plat
form.webservices.netsuite.com"/>
</writeResponse>
</addResponse>

The above customer was added because no error occurred. However, future errors could be avoided by
responding appropriately to the warning message.
For a detailed list of all warning messages and the associated codes generated by NetSuite, see Warning
Status Codes.

Errors
Errors result if invalid or incomplete data is submitted when performing an operation. For example, if
a client attempts to update a customer record with an invalid internal ID, the operation fails and the
response contains an error code and message.
When numerous records are submitted within the same request, each is treated individually. For example,
if a client attempts to update two events within the same request, where one record has invalid data and
the other has valid data, only one of the records has an error and is not updated.

Code
<updateListResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<writeResponseList>
<platformCore:status isSuccess="true" xmlns:platformCore="urn:core.platform_2017_1.platform.webservices.netsuite.com"/>
<writeResponse>
<platformCore:status isSuccess="false" xmlns:platformCore="urn:core.platform_2017_1.platform.webservices.netsuite.com">
<platformCore:statusDetail type="ERROR">
<platformCore:code>RCRD_DSNT_EXIST</platformCore:code>
<platformCore:message>That record does not exist. Invalid record:type=event,id=222,scompid=3604360</platformCore:mes
sage>
</platformCore:statusDetail>
</platformCore:status>
<baseRef internalId="222" type="calendarEvent" xsi:type="platformCore:RecordRef" xmlns:platformCore="urn:core.platfor
m_2017_1.platform.webservices.netsuite.com"/>
</writeResonse>
<writeResponse>
<platformCore:status isSuccess="true" xmlns:platformCore="urn:core.platform_2017_1.platform.webservices.netsuite.com"/>
<baseRef internalId="220" type="calendarEvent" xsi:type="platformCore:RecordRef" xmlns:platformCore="urn:core.platfor
m_2017_1.platform.webservices.netsuite.com"/>
</writeResponse>
</writeResponseList>
</updateListResponse>

For a detailed list of all error messages and the associated codes, see Error Status Codes.

Error Reporting for afterSubmit Script Failures

When an afterSubmit script runs after a SOAP web services add or update request, and the script fails, the
records are still created or updated in NetSuite. The SOAP response indicates that the record has been
created or updated even if an afterSubmit script that runs after the SOAP web services request fails.
Using the internal ID of the record, available in the SOAP response, you can avoid creating duplicate
records. If the SOAP response indicates that the records have been saved, you only need to retry the user
event script. You should not send the SOAP web services request again.
For information about working with afterSubmit scripts, see the help topics afterSubmit(context) and
SuiteScript 2.x User Event Script Type.
The following is an example of the error message in the SOAP response.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Warnings, Errors, and Faults 304

<?xml version="1.0" encoding="utf-8"?>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/
XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Header>
<platformMsgs:documentInfo xmlns:platformMsgs="urn:messages_2017_1.platform.webservices.netsuite.com">
<platformMsgs:nsId>WEBSERVICES_3604360_042020171945139757546407083_e2869fb06ef3</platformMsgs:nsId>
</platformMsgs:documentInfo>
</soapenv:Header>
<soapenv:Body>
<addResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
<writeResponse>
<platformCore:status isSuccess="false" xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com">
<platformCore:statusDetail type="ERROR">
<platformCore:aftersubmitFailed>true</platformCore:aftersubmitFailed><platformCore:code>USER_ERROR</platformCore:code>
<platformCore:message>Please enter value(s) for: Company Name, Subsidiary</platformCore:message>
</platformCore:statusDetail>
</platformCore:status>
<baseRef internalId="68" externalId="EID_PO_68" type="purchaseOrder" xsi:type="platformCore:RecordRef" xmlns:platform
Core="urn:core_2017_1.platform.webservices.netsuite.com"/>
</writeResponse>
</addResponse>
</soapenv:Body>
</soapenv:Envelope>

Faults
Faults are exceptions that are of a more fundamental nature than errors. A key distinction between errors
and faults is that a fault prevents any operation within a request from being processed whereas an error
prevents only a single operation from succeeding on an individual record.
For example, continuing from the case above, if the user's session has timed out when making the
request, neither update for either event record is processed and an invalidSessionFault is returned in the
response.

Expand code
<soapenv:Fault>
<faultcode>soapenv:Server.userException</faultcode>
<faultstring>Your connection has timed out. Please log in again.
</faultstring>
<detail>
<platformFaults:invalidSessionFault xmlns="urn:faults.platform_2017_1.platform.webservices.netsuite.com">
<platformFaults:code>INVALID_SESSION</platformFaults:code>
<platformFaults:message>Your connection has timed out. Please log in again.</platformFaults:message>
</platformFaults:invalidSessionFault>
<ns1:hostname xmlns:ns1="http://xml.apache.org/axis">partners-java10009.bos.netsuite.com
</ns1:hostname>
</detail>
</soapenv:Fault>

SOAP uses the detail element to capture the error code through the code element and the error message
through the message element. The faultcode and faultstring are automatically populated by the server.
Following is an example of a SOAP fault named InvalidCredentialsFault for an invalid e-mail address that is
returned as part of the login operation.

Code
<soapenv:Fault>
<faultcode>soapenv:Server.userExveption</faultcode>
<faultstring>You have entered an invalid e-mail address or account number. Please try again.</faultstring>
<detail>

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Warnings, Errors, and Faults 305

<platformFaults:invalidCredentialsFault xmlns="urn:faults.platform_2017_1.platform.webservices.netsuite.com">
<platformFaults:code>INVALID_LOGIN_CREDENTIALS</platformFaults:code>
<platformFaults:message>You have entered an invalid e-mail address or account number. Please try again.</platformFault
s:message>
</platformFaults:invalidCredentialsFault>
<ns1:hostname xmlns:ns1="http://xml.apache.org/axis">partners-java10009.bos.netsuite.com
</ns1:hostname>
</detail>
</soapenv:Fault>

For a detailed list of fault messages and the associated codes, see SOAP Fault Status Codes. The list does
not contain every SOAP fault status code. Some SOAP faults do not have a special fault code.

Important: Unexpected errors return an error ID that can be provided to NetSuite Customer
Support to help them isolate the error in your account. The following is an example of the error
ID:

<platformCore:code>UNEXPECTED_ERROR</platformCore:code>
<platformCore:message>An unexpected error occurred. Error ID: fevsjhv41tji2juy3le73</platformCore:message>

Error IDs will be especially helpful for async operations, as the ID will indicate the error that occurred
during the execution of the job, not the retrieval. The exception is if the async error occurred at the
platform-level. In this case, the stack will be attached to the job itself.

SOAP Faults for Each Operation

The following table lists the SOAP fault types that can be thrown for each operation.

ACCT_TEMP_UNAVAILABLE

EMAIL_ADDRS_REQD

INVALID_ACCT

INVALID_LOGIN_CREDENTIALS

INVALID_VERSION

PSWD_REQD

UNEXPECTED_ERROR

WS_CONCUR_SESSION_DISALLWD

WS_FEATURE_REQD

WS_PERMISSION_REQD

MapSso throws…

ACCT_TEMP_UNAVAILABLE

EMAIL_ADDRS_REQD

INVALID_ACCT

INVALID_LOGIN_CREDENTIALS

INVALID_VERSION

SuiteTalk SOAP Web Services Platform Guide

SOAP Faults for Each Operation 306

MapSso throws…

PSWD_REQD

UNEXPECTED_ERROR

WS_CONCUR_SESSION_DISALLWD

WS_FEATURE_REQD

WS_PERMISSION_REQD

Logout throws...

INVALID_VERSION

UNEXPECTED_ERROR

WS_CONCUR_SESSION_DISALLWD

SESSION_TIMED_OUT

WS_REQUEST_BLOCKED

add / update / delete throw...

INVALID_VERSION

SESSION_TIMED_OUT

UNEXPECTED_ERROR

USER_ERROR

WS_CONCUR_SESSION_DISALLWD

WS_LOG_IN_REQD

addList / updateList / deleteList throw...

INVALID_VERSION

MAX_RCRDS_EXCEEDED

SESSION_TIMED_OUT

UNEXPECTED_ERROR

USER_ERROR

WS_CONCUR_SESSION_DISALLWD

WS_LOG_IN_REQD

getList/getAll throw...

INVALID_VERSION

MAX_RCRDS_EXCEEDED

SESSION_TIMED_OUT

SuiteTalk SOAP Web Services Platform Guide

SOAP Faults for Each Operation 307

getList/getAll throw...

UNEXPECTED_ERROR

USER_ERROR

WS_CONCUR_SESSION_DISALLWD

WS_LOG_IN_REQD

get throws...

INVALID_VERSION

SESSION_TIMED_OUT

UNEXPECTED_ERROR

USER_ERROR

WS_CONCUR_SESSION_DISALLWD

WS_LOG_IN_REQD

search / searchNext / searchMore throw...

INVALID_VERSION

MAX_RCRDS_EXCEEDED

SESSION_TIMED_OUT

UNEXPECTED_ERROR

USER_ERROR

WS_CONCUR_SESSION_DISALLWD

WS_LOG_IN_REQD

WS_REQUEST_BLOCKED

SOAP Fault Status Codes

The following table defines SOAP fault types and their corresponding codes. For a complete description
of faults and how they differ from errors and warnings, refer to SOAP Web Services Warnings, Errors, and
Faults.

Fault Name Description

InsufficientPermissionFault This fault is thrown when the client does not have the appropriate
permissions to perform an action based on the role under which they
are currently logged in. If the client (user) has more than one role,
they may need to login again supplying a different role with more
permissions.

InvalidAccountFault This fault is thrown when the client attempts to login with an invalid
account id.

InvalidPartnerCredentials Partner ID or password submitted with this request is invalid.

SuiteTalk SOAP Web Services Platform Guide

SOAP Fault Status Codes 308

Fault Name Description

InvalidRequestIP Originating IP is not one of the registered IPs from which this Partner
request may come.

InvalidSessionFault This fault can be thrown when the client's session has timed out or
was terminated as the result of a second SOAP web services client
establishing another session. The fault message occurs on the first
request attempted after the session is terminated/timed out. For more
details on how NetSuite handles sessions, see Session Management for
SOAP Web Services.

InvalidVersionFault This fault is thrown in the event that the request message contains an
unsupported version of the schema.

ExceededConcurrentRequestLimitFault This fault is thrown in the event that the maximum number of
concurrent requests has been reached.

ExceededRecordCountFault This fault is thrown in the event the maximum number of records
allowed for an operation has been exceeded. For more information, see
SOAP Web Services Governance Overview.

ExceededRequestLimitFault This fault is thrown if the allowed number of concurrent requests is

exceeded. For more information, see SOAP Web Services Governance
Overview.

ExceededRequestSizeFault

ExceededUsageLimitFault

UnexpectedErrorFault This fault is thrown in the event of an occurrence of an unexpected

exception.

InvalidCredentialsFault This fault is thrown in the event of an invalid username (e-mail),

password, role, or application ID.

This fault is also thrown if two-factor authentication is required but is

missing.

AsyncFault

Error Status Codes

The following table lists error status code types that can be returned in a message Response. These are
values that are used in the code field of the statusDetail type where the type attribute has a value of error.

These codes are listed in the StatusDetailCodeType enumeration, which is defined in the platform faults
XSD. You can also view error codes on the Status Detail Code page of the SOAP Schema Browser.

Error Code Returned Long Description or Message

ABORT_SEARCH_EXCEEDED_ This search has timed out. You can choose to schedule it to run in the background and
MAX_TIME have the results emailed to you when complete. On the saved search form, click the
"Email" tab, check "Send According to Schedule", choose an email address on the "Specific
Recipients" subtab and a recurrence pattern on the "Schedule" subtab.

ABORT_UPLOAD_VIRUS_ The file {1} contains a virus {2}. Upload abort.

DETECTED

ACCESS_DENIED Access to this configuration is denied. Please contact NetSuite to gain access to this
configuration.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 309

Error Code Returned Long Description or Message

ACCTNG_PRD_REQD Missing next accounting period

ACCT_DISABLED account disabled

ACCT_DISABLED This account has been disabled.

ACCT_DISABLED Please contact <a href=''mailto:{1}''> Accounts Receivable</a> at 650.627.1316 to re-enable

this company.

ACCT_DISABLED Your account has been inactivated by an administrator.

ACCT_MERGE_DUP The account merge would result in one or more items using duplicate accounts.

ACCT_NAME_REQD Accounts require a name.

ACCT_NEEDS_CAMPAIGN_ Please contact your account representative to provision campaign emailing for your
PROVISION account.

ACCT_NOT_CREATED Account creation was unsuccessful. NetSuite Customer Support has been alerted to this
problem.

ACCT_NUM_REQD Missing Account Number. Account number is a required field and it cannot be null or
empty.

ACCT_NUMS_REQD_OR_DONT_ Missing ACCT # or ACCT numbers don't match

MATCH

ACCT_PERIOD_SETUP_REQD The accounting period range {1} has not been defined. Please visit '<A href='{2}'>Setup >
Accounting > Manage Accounting Periods</A>' to define this period or set up your year.

ACCT_PRDS_BEING_ADDED Periods are currently being added to this account. Please try again later.

ACCT_REQD Attempting to adjust provisioning for a customer without an existing account

ACCT_TEMP_DISABLED You have entered an invalid password on {1} consecutive attempts. Access to your account
has been suspended for {2} minutes. If you have forgotten your password, please contact
Customer Support.

ACCT_TEMP_UNAVAILABLE Can't update information - this company's database is currently offline for maintenance.
Please try again later.

ACCT_TEMP_UNAVAILABLE (Temporarily unavailable)

ACCT_TEMP_UNAVAILABLE The account you are trying to access is currently unavailable while we undergo our
regularly scheduled maintenance.

ACCT_TEMP_UNAVAILABLE We are currently performing maintenance on our system. Please try again soon.

ACCT_TEMP_UNAVAILABLE The account you are trying to access is currently unavailable while we undergo our
regularly scheduled maintenance.

ACCT_TEMP_UNAVAILABLE Your account is disabled for {1} more minutes due to {2} consecutive failed login attempts.

ACCT_TEMP_UNAVAILABLE Your account is not yet ready for you to log in. Please wait and try again.

ACCT_TEMP_UNAVAILABLE Your company database is offline.

ACCT_TEMP_UNAVAILABLE Your data is still being loaded. Please try again later. Contact <a href='/app/crm/support/
nlcorpsupport.nl?type=bug&spf=31'>Professional Services</a> if you have questions.

ACH_NOT_AVAILBL ACH Processing is not available in this environment.

ACH_SETUP_REQD Account {1} is not setup for ACH transactions.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 310

Error Code Returned Long Description or Message

ACTIVE_AP_ACCT_REQD This transaction requires an active Accounts Payable account. Please enable an existing
Accounts Payable account, create a new Accounts Payable account, or contact your System
Administrator.

ACTIVE_ROLE_REQD You can only set an active login role as the SOAP web services default role.

ACTIVE_TRANS_EXIST There are active direct deposit transactions for this paycheck

ADDITIONAL_ Additional Authentication required - 2FA.

AUTHENTICATION_REQUIRED_
2FA

ADDITIONAL_ Additional Authentication required - Security Questions.

AUTHENTICATION_REQUIRED_
SQ

ADDRESS_LINE_1_REQD Address Line 1 is a required field and it cannot be null or empty.

ADMIN_ACCESS_REQ At least one active administrator for each account must have access.

ADMIN_ACCESS_REQ At least one active administrator for this account must have access.

ADMIN_ACCESS_REQD Only administrators may enter a memorized transaction in a closed period.

ADMIN_ONLY_ACCESS {1} only the administrator may access this page.

ADMIN_ONLY_ACCESS {1} only the administrator may currently access this page.

ADMIN_USER_REQD User is not an Admin of the demo account

ADMISSIBILITY_PACKG_TYP_ An Admissibility Package Type is required for this international shipment.

REQD

ALL_DATA_DELETE_REQD You must first delete all the data in your account before performing this action. Click <a
href='/pages/setup/clearaccount.jsp?import=T'>here</a> to delete your data.

ALL_MTRX_SUBITMES_OPTNS_ The following matrix subitems exist but aren't included in the options you just specified. On
REQD the Matrix tab, please make sure the options you select include all existing subitems: {1}

ALREADY_IN_INVT The following {1} numbers are already in inventory: {2}

ALREADY_IN_INVT The following {1} number is already in inventory: {2}

AMORTZN_INVALID_DATE_ Amortization end date can not be before amortization start date.
RANGE

AMORTZN_TMPLT_DATA_ One or more line items on this transaction have Variable Amortization Templates, but do
MISSING not have the required {1} also populated. Please either change the Template for these
items or indicate which {1} will be used to schedule the amortization.

AMT_DISALLWD Description items may not have an amount.

AMT_EXCEEDS_APPROVAL_ No one in your chain of command has a sufficient spending limit to approve this
LIMIT transaction.

ANSWER_REQD Please provide an answer.

APPROVAL_PERMS_REQD {1} The restrictions on your role do not allow you to approve or reject this record.

AREA_CODE_REQD Please include an area code with the phone number.

ASSIGNEE_REQD {1} must be assigned to {2}

AT_LEAST_ONE_FILE_REQD Download folder must have at least one file.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 311

Error Code Returned Long Description or Message

AT_LEAST_ONE_PACKAGE_ 1 or more packages are required.

REQD

AT_LEAST_ONE_RETURN_FLD_ You must specify at least one field to be returned.

REQD

AT_LEAST_ONE_SUB_REQD You must choose at least one subsidiary.

ATTACH_SIZE_EXCEEDED The data you are uploading exceeds the maximum allowable size of {1}. Please change your
selection and try again

ATTACH_SIZE_EXCEEDED This message exceeds the limit of 24 MB. Please reduce the size of the message and its
attachments and try again. Note: Files can be larger when attached due to encoding.

ATTACHMNT_CONTAINS_ The attachment with file name {1} contains a virus {2}. It is removed from the message.
VIRUS

ATTACHMNT_CONTAINS_ The attachment file {0} contains virus {1}. Save message abort.
VIRUS

AUDIT_W2_1099 Use this report to audit the information that will be used to generate W2s and 1099s.

AUTO_NUM_UPDATE_ We currently do not support an automatic numbering update of more than {1} {2} records.
DISALLWD Please contact <A href='/app/crm/support/nlcorpsupport.nl?type=support'>NetSuite
Customer Support</A> to request a full numbering update of your {2}s.</a>

AVS_ERROR This order failed the AVS check and will not be saved. An AVS mismatch has been
detected and the transaction has been rejected. However, a valid authorization has been
created against the cardholder's account. If you want to accept this order, click Go Back and
check the Ignore AVS checkbox and Save the order. Note that this will result in a second
authorization.

BALANCE_EXCEEDS_CREDIT_ Customer balance exceeds credit limit

LIMIT

BANK_ACCT_REQD You must have a bank account to perform this operation. Click <a href='/app/accounting/
account/account.nl'>here</a> to add one.

BASE_CRNCY_REQD You may not delete you base currency.

BILL_PAY_STATUS_ View Online Bill Pay Status information is currently not available. Please try again in a few
UNAVAILABLE minutes.

BILL_PAY_STATUS_ View Online Bill Pay Status is not available until your bill pay registration is complete.
UNAVAILABLE

BILL_PMTS_MADE_FROM_ Your payment has been recorded, but online bill payments can only be made from the
ACCT_ONLY account {1}, so no online bill pay payment will be made. You should return to the
payment screen if you wish to print the check.

BILLABLES_DISALLWD {1} does not allow billables.

BILLING_ISSUES Your account has been locked due to billing issues. You must call your NetSuite Sales
Representative for further assistance.

BILLING_ISSUES Your account has not been fully paid for. Please log in to your account and follow the billing
process or contact your Account Manager.

BILLING_SCHDUL_INVALID_ Billing schedules may not have a recurrence count greater than 500
RECURR

BILLPAY_APPROVAL_ Approve Online Bill Payments is currently not available. Please try again in a few minutes.
UNAVAILBL

BILLPAY_REGSTRTN_REQD Online bill pay approve payments is not available until your billpay registration is complete.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 312

Error Code Returned Long Description or Message

BILLPAY_SRVC_UNAVAILBL Online Bill Pay service is temporarily suspended. If you prefer to wait until Online
Bill Pay service is restored, just leave payments to be approved in this list. We will
notify you by email as soon as the service is available again. If you need to make an
urgent payment, we suggest that you print a check. To do this: 1. Clear the Online
Bill Pay check box for that payment. 2. Click the underlined date of the payment, and
you will return to the Bill Payment page. 3. On the Bill Payment page, click To Be Printed
instead of Bill Pay. 4. Click Submit. 5. Go to Transactions > Print Checks and Forms >
Checks, and then mark the check to be printed. 6. Click Submit.

BILLPAY_SRVC_UNAVAILBL The Online Bill Pay service is currently not available. Please try again in a few minutes.

BIN_DSNT_CONTAIN_ The following bins do not contain enough of the requested item ({1}): {2}
ENOUGH_ITEM

BIN_DSNT_CONTAIN_ The following bin does not contain enough of the requested item ({1}): {2}
ENOUGH_ITEM

BIN_ITEM_UNAVAILBL The following bins are not available for the specified item: {1}

BIN_ITEM_UNAVAILBL The following bins are not available for the specified item ({1}): {2}

BIN_ITEM_UNAVAILBL The following bin in not available for the specified item ({1}): {2}

BIN_ITEM_UNAVAILBL The following bin is not available for the specified item: {1}

BIN_SETUP_REQD The following bins are not associated with the item '{1}': {2}. You can associate bins with
an item on the inventory tab of the item record.

BIN_UNDEFND The following bins specified for the item {1} are not defined in the transaction location ({2}):
{3}

BUNDLE_IS_DEPRECATED This bundle is no longer available. It has been deprecated by bundle {1} on account {2}.

BUNDLE_IS_DEPRECATED You cannot update this bundle as it has been deprecated and you have not been granted
access to the replacement bundle. Please contact the solution provider.

CALENDAR_PREFS_REQD Set up {1} Calendar Preferences first.

CALENDAR_PREFS_REQD Set up Calendar Preferences first

CAMPAGIN_ALREADY_ You cannot delete email campaigns that have already been executed
EXECUTED

CAMPAIGN_IN_USE You cannot delete a campaign event that already has activity.

CAMPAIGN_SET_UP_REQD The following steps need to be performed before a campaign can be created:{1}

CANNOT_RESET_PASSWORD Sorry, we are currently unable to reset your password. Please contact support or try again
later.

CANT_APPLY_PMT The top level entity cannot accept payment because it has a status of {1}. It must have a
status of {2} or {3} to accept payment.

CANT_APPLY_PMT This entity cannot accept payment because it has a status of {1}. It must have a status of {2}
or {3} to accept payment.

CANT_AUTO_CREATE_ The 'Intercompany Expenses' accounting preference does not currently support the
ADJSTMNT automated creation of adjustments. If you would like to create adjustments automatically,
please change that preference to 'Allow and Auto Adjust.'

CANT_CALC_FEDEX_RATES FedEx rates cannot be calculated:

CANT_CANCEL_APPRVD_ You cannot cancel this return authorization because it has already been approved.
RETRN_AUTH

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 313

Error Code Returned Long Description or Message

CANT_CANCEL_BILL_PMT The Online Bill Payment cannot be stopped because the payment may already have been
made.

CANT_CHANGE_COMMSSN The Online Bill Payment cannot be stopped because the payment may already have been
made.

CANT_CHANGE_CONTACT_ You cannot change the restriction on this contact.

RESTRICTN

CANT_CHANGE_CRMRECORDT Cannot alter standard CrmRecordTypeLinks

YPELINKS

CANT_CHANGE_EVENT_ You cannot change the primary type for this event
PRIMARY_TYP

CANT_CHANGE_IP_ADDRESS The domain {1} is currently associated with IP address {2}. You cannot change the IP
address of a live domain.

CANT_CHANGE_LEAD_ You cannot change the category for a leadsource that is defined as the default leadsource
SOURCE_CAT for another category

CANT_CHANGE_PSWD You changed your password less than 24 hours ago. NetSuite only allows one password
change per 24-hour period.

CANT_CHANGE_REV_REC_ The rev rec template on a billable expense can not be changed or removed after it is saved.
TMPLT

CANT_CHANGE_REV_REC_ The rev rec template on billable time and items can not be changed or removed after it is
TMPLT saved.

CANT_CHANGE_SUB You cannot change the subsidiary on this record because doing so will change the
subsidiary selected on the associated employee record.

CANT_CHANGE_TASK_LINK Cannot alter standard task links

CANT_CHANGE_UNITS_TYP You may not change the units type of an item after it has been set.

CANT_CHANGE_VSOE_ You are attempting to change the VSOE Allocation for a transaction in a closed period. You
ALLOCTN must either change the posting period for the related transaction or open the period.

CANT_CHG_POSTED_BILL_ The receipts for this bill can not be changed after the bill variance has been posted.
VRNC

CANT_CHG_POSTED_BILL_ One or more lines have had their bill variance posted and can not be changed.
VRNC

CANT_COMPLETE_FULFILL The fulfillment cannot be completed.

CANT_CONNECT_TO_STORE Error - Unable to connect to store {1}

CANT_CONVERT_CLASS_DEPT You cannot convert classes to departments because you already have department data in
the system. You must remove all departments first.

CANT_CONVERT_CLASS_LOC You cannot convert classes to locations because you already have location data in the
system. You must remove all locations first.

CANT_CONVERT_INVT_ITEM This item is a member of a kit or a non-numbered assembly. You may not convert it to a
numbered inventory item.

CANT_CREAT_SHIP_LABEL A shipping label could not be generated because the In Bond Code field is not set. Please
enter a value in the In Bond Code field on the Item Fulfillment page.

CANT_CREATE_FILES Could not create files for uploading your data

CANT_CREATE_NON_UNIQUE_ A record with the same unique signatures already exists. You must enter unique signatures
RCRD for each record you create.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 314

Error Code Returned Long Description or Message

CANT_CREATE_PO Purchase Orders cannot be created for assembly items.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because a currency must be defined for the "Ship
From" country "{1}" when using the Insured Value option. Go to Lists -> Accounting ->
Currencies to create a currency for {1}.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because a currency must be defined for the "Ship
To" country "{1}" when using the COD option. Go to Lists -> Accounting -> Currencies to
create a currency for {1}.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because the Addressee field of the "Ship To"
address is not set. Please enter a "Ship To" Addressee on the Item Fulfillment page.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because the Address 1 field of the "Ship From"
address is not set. Please go to $(regex) to enter the "Ship From" Address 1.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because the Address 1 field of the "Ship To"
address is not set. Please enter a "Ship To" Address 1 on the Item Fulfillment page.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because the Attention field of the "Ship From"
address is not set. Please go to $(regex) to enter the "Ship From" Attention.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because the City field of the "Ship To" address is
not set. Please enter a "Ship To" City on the Item Fulfillment page.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because the City of the "Ship From" address is not
set. Please go to $(regex) to enter the "Ship From" City.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because the Company or Location Name of the
"Ship From" address is not set. Please go to $(regex) to enter the "Ship From" Company/
Location Name.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because the Country field of the "Ship To" address
is not set. Please enter a "Ship To" Country on the Item Fulfillment page.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because the Country of the "Ship From" address is
not set. Please go to $(regex) to set the "Ship From" Country.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because the Package Weight was not entered.
Please enter a value in the Package Weight field on the Item Fulfillment page.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because the Phone Number of the "Ship From"
address is not set. Please go to $(regex) to set the "Ship From" Phone Number.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because the Phone Number of the "Ship To"
address is not set. Please enter a "Ship To" Phone Number on the Item Fulfillment page.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because the Pickup Type was not set. Please go to
Setup > Set Up Shipping to select a shipping Pickup Type.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because the shipping method was not set. Please
go to Lists > Shipping Items to select a Shipping Label Integration shipping method for this
shipping item.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because the State field of the "Ship To" address is
not set. Please enter a "Ship To" State on the Item Fulfillment page.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because the State of the "Ship From" address is
not set. Please go to $(regex) to enter the "Ship From" State.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because the Zip Code of the "Ship From" address is
not set. Please go to $(regex) to enter the "Ship From" Zip Code.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because the Zip field of the "Ship To" address is
not set. Please enter a "Ship To" Zip code on the Item Fulfillment page.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 315

Error Code Returned Long Description or Message

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because your {1} Account Number is not set. Go to
Setup > Set Up Shipping > {2} Registration to enter your {3} Account Number.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because your {1} Registration Address Line 1 is not
set. Go to Setup > {2} Registration to complete the Address Line 1 field.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because your {1} Registration City is not set. Go to
Setup > {2} Registration to enter your City.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because your {1} Registration Company field is not
set. Go to Setup > {2} Registration to enter a name in the Company field.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because your {1} Registration Country is not set.
Go to Setup > {2} Registration to select your Country.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because your {1} Registration Ship to Attention
field is not set. Go to Setup > {2} Registration to enter a name in the Ship to Attention field.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because your {1} Registration State is not set. Go
to Setup > {2} Registration to select or enter your State.

CANT_CREATE_SHIP_LABEL A shipping label could not be generated because your {1} Registration Zip Code is not set.
Go to Setup > {2} Registration to enter your Zip Code.

CANT_CREATE_WORK_ORD Work orders can only be created for assembly items.

CANT_DEL_DEFAULT_
CALENDAR

CANT_DEL_DEFAULT_SHIP_ This Shipping Item cannot be deleted because it is the Default Shipping Method. Please
METHOD go to Setup > Accounting > Set Up Shipping and choose a new Default Shipping Method
before deleting this Shipping Item.

CANT_DEL_REALIZED_ A Realized Gain/Loss Transaction cannot be deleted.

GAINLOSS

CANT_DEL_TRANS_RVRSL The reversal of the month-end Unrealized Gain/Loss transaction cannot be deleted.

CANT_DELETE_ACCT This account cannot be deleted because it has associated transactions.

CANT_DELETE_ACCT This account cannot be deleted because it is a special type of account needed by {1}

CANT_DELETE_ACCT This account cannot be deleted because it is a special type of account needed by NetSuite

CANT_DELETE_ACCT This account cannot be deleted because it is a special type of account needed by the
system.

CANT_DELETE_ACCT This account cannot be deleted because it is used by one or more transactions or it has
child accounts or it is used by one or more items.

CANT_DELETE_ACCT_PRD You may not delete an accounting period with transactions posted to it. You must first edit
the transactions, change the posting period and then delete the period.

CANT_DELETE_ALLOCTN This allocation detail can not be deleted because it has a journal entry.

CANT_DELETE_BIN You may not delete this bin record because it is already in use. You must either remove all
references to it in item records and transactions or make it inactive.

CANT_DELETE_CATEGORY This category cannot be deleted because it has child items

CANT_DELETE_CATEGORY This category cannot be deleted because it has subcategories

CANT_DELETE_CC_PROCESSOR This credit card processor is used in transaction and cannot be deleted.

CANT_DELETE_CELL This cell cannot be deleted because it has child items

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 316

Error Code Returned Long Description or Message

CANT_DELETE_CHILD_RCRD_ This {1} record cannot be deleted because it is referenced by other records.
FOUND

CANT_DELETE_CHILD_RCRDS_ This record can not be deleted because it has child records.
EXIST

CANT_DELETE_CLASS This class cannot be deleted because it has child items

CANT_DELETE_COLOR_THEME This color theme cannot be deleted because it is being used

CANT_DELETE_COMMSSN_ This schedule has already been used to generate commission calculations and can't
SCHDUL be deleted. If no authorizations have been made, schedule can be deleted after being
removed from all active plans.

CANT_DELETE_COMPANY This company cannot be deleted because it has child entities

CANT_DELETE_COMPANY_TYP This company type cannot be deleted because the company has associated transactions.

CANT_DELETE_CONTACT_HAS_ The contact record cannot be deleted because it has child records.
CHILD

CANT_DELETE_CONTACT_HAS_ This contact cannot be deleted because it has child entities

CHILD

CANT_DELETE_CSTM_FIELD This custom field cannot be deleted because it is referred to by other custom fields

CANT_DELETE_CSTM_FORM This custom form cannot be deleted because it is referred to by other custom forms

CANT_DELETE_CSTM_ITEM_ This custom item field has dependent matrix items. It can not be deleted.
FIELD

CANT_DELETE_CSTM_LAYOUT This custom layout cannot be deleted because it is used by custom forms

CANT_DELETE_CSTM_LIST This custom list cannot be deleted because it is referred to by custom fields

CANT_DELETE_CSTM_RCRD This custom record cannot be deleted because it is referred to by custom fields

CANT_DELETE_CSTM_RCRD_ This custom record entry cannot be deleted because it is referred to by other records
ENTRY

CANT_DELETE_CUST You can't delete this customer because it's set up as default Anonymous Customer

CANT_DELETE_CUSTOMER This customer or job cannot be deleted because it has child entities.

CANT_DELETE_DEFAULT_FLDR You cannot delete the default folders.

CANT_DELETE_DEFAULT_ You cannot delete the default case priority. Please select a new default first.
PRIORITY

CANT_DELETE_DEFAULT_ Default Sales Rep Role cannot be deleted.

SALES_REP

CANT_DELETE_DEFAULT_ You cannot delete a default case status. Please select a new default first.
STATUS

CANT_DELETE_DEFAULT_ You can't delete or inactivate that status because it is a set up as a default status. Please
STATUS navigate to <a href='/app/setup/sfasetup.nl' target='_blank'>Sales Preferences</a> and
change that status

CANT_DELETE_DEFAULT_ You may not delete or inactivate that value because it is a default. Please select a new
VALUE default first.

CANT_DELETE_DEFAULT_ The default Web site cannot be deleted.

WEBSITE

CANT_DELETE_EMPL This employee cannot be deleted because it has child entities

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 317

Error Code Returned Long Description or Message

CANT_DELETE_ENTITY This entity cannot be deleted because it has child items

CANT_DELETE_FIN_STATMNT_ This financial statement layout cannot be deleted because it is referred to by other layouts.
LAYOUT

CANT_DELETE_FLDR These predefined folders cannot be deleted

CANT_DELETE_HAS_CHILD_ This {1} cannot be deleted because it has child items

ITEM

CANT_DELETE_INFO_ITEM This information item cannot be deleted because it has child items

CANT_DELETE_ITEM This item cannot be deleted because it has child items

CANT_DELETE_ITEM_LAYOUT This item/category layout cannot be deleted because it is used by store tabs

CANT_DELETE_ITEM_TMPLT This item/category template cannot be deleted because it is referred to by a theme or an

item

CANT_DELETE_JOB_ Default Job Resource Role cannot be deleted.

RESOURCE_ROLE

CANT_DELETE_LEGACY_ Legacy category cannot be removed

CANT_DELETE_MEMRZD_ This memorized transaction cannot be deleted because it referenced in transactions

TRANS

CANT_DELETE_OR_CHANGE_ Special accounts cannot be deleted and their type cannot be changed
ACCT

CANT_DELETE_PLAN_ Trying to delete plan assignment referenced by precalcs.

ASSGNMNT

CANT_DELETE_PRESNTN_CAT This presentation category cannot be deleted because it has subcategories

CANT_DELETE_RCRD This {1} record cannot be deleted because it referenced by other records

CANT_DELETE_RCRD This record cannot be deleted because it has {1}child records{2}

CANT_DELETE_RCRD This record cannot be deleted because it is referenced by other records or it is used by one
or more transactions.

CANT_DELETE_RCRD This record cannot be deleted, because it is referred to by other records.

CANT_DELETE_RCRDS Selected records could not be deleted because one or more of them are of a special type of
account needed by {1}

CANT_DELETE_RCRDS Selected records could not be deleted because one or more of them are referenced by
other records.

CANT_DELETE_SITE_TAG This site tag cannot be deleted because it is being used.

CANT_DELETE_SITE_THEME This site theme cannot be deleted because it is being used

CANT_DELETE_SOLUTN This solution cannot be deleted because it has been applied to support cases.

CANT_DELETE_STATUS_TYPE You cannot delete the only status of type {1}

CANT_DELETE_SUBTAB This subtab cannot be deleted because it is referred to by custom fields

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 318

Error Code Returned Long Description or Message

CANT_DELETE_SYSTEM_NOTE You cannot alter or delete a system logged note.

CANT_DELETE_TAX_VENDOR This is a special tax vendor and cannot be deleted.

CANT_DELETE_TMPLT_RCRD This template record cannot be deleted.

CANT_DELETE_TRANS This transaction cannot be deleted because it is a Google Checkout order awaiting updated
payment information.

CANT_DELETE_TRANS This transaction cannot be deleted because it is a posting Google Checkout order.

CANT_DELETE_TRANS This transaction cannot be deleted because it is linked to one or more commission
transactions. The commission authorizations due to this transaction need to be removed to
be able to delete this transaction.

CANT_DELETE_TRANS This transaction cannot be deleted because it is referenced by an intercompany

adjustment. The adjustment must be deleted first.

CANT_DELETE_TRANS This transaction cannot be deleted because it is referred to by other transactions. It may be
a bill or an invoice that has been paid or an expense that has been reimbursed.

CANT_DELETE_TRAN_LINE Failed to delete line {1}. This line is linked to another transaction.

CANT_DELETE_TRAN_LINES Lines with partially recognized rev rec or amortization schedules can not be deleted.

CANT_DELETE_UPDATE_ACCT This account cannot be deleted or changed because it is a special type of account needed
by {1}

CANT_DELETE_URL This third party conversion tracking URL cannot be deleted because it is reference by other
records.

CANT_DELETE_VENDOR This {1:Vendor} is related to a {2:Partner} which is eligible for commission and cannot be
deleted.

CANT_DELETE_VENDOR This vendor cannot be deleted because there are dependent items, such as a pending
payment. If you wish to remove the payee, you must first delete all such dependent items.

CANT_DIVIDE_BY_ZERO There is a divide by zero error in this search. It may be an error with a formula you have
used. Please retry without the formula(s). If an error still occurs, please file with Customer
Support. If it does not, please correct your formula. Typically that consists of taking the
denominator and wrapping it in NULLIF(<denominator>,0).

CANT_DOWNLOAD_EXPIRED_ This file has expired and can no longer be downloaded

FILE

CANT_EDIT_CHARGED_ORDER You cannot charge an order that is already completely charged.

CANT_EDIT_CUST_LIST Can not modify this Custom List because its entries are in use.

CANT_EDIT_CUST_PMT This customer payment cannot be edited while it has an Automated Clearing House
transmission in process.</TD></TR><TR><TD class=text> </TD></TR><TR><TD class=text>
To view the status of customer payments with ACH transmissions, go to Transactions >
View Electronic Funds Transfer Status.

CANT_EDIT_DPLYMNT_IN_ You cannot change or delete a deployment that is in progress or in the queue.
PROGRESS

CANT_EDIT_DPLYMNT_IN_ You cannot edit a script deployment when it is being executed.

PROGRESS

CANT_EDIT_FOLDER Predefined folders cannot be updated.

CANT_EDIT_OLD_CASE This case cannot be edited because it was closed {1} or more days ago.

CANT_EDIT_STANDARD_OBJ Cannot alter standard dashboards

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 319

Error Code Returned Long Description or Message

CANT_EDIT_STANDARD_OBJ Cannot alter standard dashboard role maps

CANT_EDIT_STANDARD_OBJ Cannot alter standard dashboard section maps

CANT_EDIT_STANDARD_OBJ Cannot alter standard fields

CANT_EDIT_STANDARD_OBJ Cannot alter standard forms or layouts

CANT_EDIT_STANDARD_OBJ Cannot alter standard portlets

CANT_EDIT_STANDARD_OBJ Cannot alter standard report snapshot layouts

CANT_EDIT_STANDARD_OBJ Cannot alter standard roles

CANT_EDIT_STANDARD_OBJ Cannot alter standard searches

CANT_EDIT_STANDARD_OBJ Cannot alter standard sections

CANT_EDIT_STANDARD_OBJ Cannot alter standard tabs

CANT_EDIT_STANDARD_OBJ Cannot alter standard tasks

CANT_EDIT_STANDARD_OBJ Cannot alter standard task categories

CANT_EDIT_STANDARD_OBJ Cannot alter standard templates

CANT_EDIT_STANDARD_OBJ Cannot Alter Standard Types

CANT_EDIT_STANDARD_OBJ Cannot alter standard words

CANT_EDIT_TAGATA The Receivable Tegata is linked to Invoices and is no longer editable

CANT_EDIT_TRAN You cannot edit intercompany adjustments.

CANT_EDIT_TRAN You cannot edit the account of a transaction line that is linked to others

CANT_EDIT_TRAN You cannot edit this expense report

CANT_EDIT_TRAN You cannot edit this transaction because it was automatically created by the Payroll feature

CANT_ESTABLISH_LINK Unable to establish link with {1}

CANT_FIND_BUG Cannot locate the bug that was just entered (1)!

CANT_FIND_MAIL_MERGE_ID Mail Merge Id not found

CANT_FIND_RCRD Could not find record with {1} = {2}

CANT_FIND_SAVED_IMPORT No saved import with internalId {1}

CANT_FIND_SOURCE_ The source account for the amortization schedule could not be determined.
AMORTZN_ACCT

CANT_FIND_UPS_REG_FOR_ No UPS registration was found for the location selected. Please select a different shipping
LOC item, or go to Setup > Set Up Shipping to register a UPS account for this location.

CANT_FULFILL_ITEM An item receipt has been posted

CANT_INACTIVATE_ You cannot inactivate a plan that has commission payments that are pending authorization.
COMMSSN_PLAN Please clear the commission payments at Transactions > Authorize Commissions before
inactivating this plan.

CANT_INACTIVE_DEFAULT_ You cannot inactivate the default synchronization category.

SYNC_CAT

CANT_INACTIVE_DEFAULT_ You cannot inactivate this template record because it is set up as a default template
TMPLT

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 320

Error Code Returned Long Description or Message

CANT_LOAD_SAVED_SEARCH_ Error loading saved search params

PARAM

CANT_LOGIN_WITH_OAUTH A login operation or Request Level Credentials must not be used in conjunction with OAuth
authorization{:do not translate 'login' or capitalized words}

Can not lookup field {1} by {2}

CANT_MAKE_CONTACT_ Employee contacts cannot be made private

PRIVATE

CANT_MAKE_CONTACT_ Individual relationship contacts cannot be made private

PRIVATE

CANT_MARK_SHIPPED Item {1:item name} cannot be marked shipped because the remaining quantity on the
linked purchase order does not match the remaining quantity on the sales order.

CANT_MERGE_EMPLS employees can not be merged

CANT_MODIFY_APPRVD_TIME Time records can not be modified after they have been approved.

CANT_MODIFY_FULFILL_ You may not change the fulfillable status of an item which has transactions associated with
STATUS it.

CANT_MODIFY_ISSUE_STATUS The issue status '{1:issue status name}' cannot be changed from {2:base status} to {3:base
status} because it is in use.

CANT_MODIFY_LOCKED_FLD You may not update or delete a locked custom field.

CANT_MODIFY_PARENT Payments have been accepted from the top level parent. The top level parent can not be
changed.

CANT_MODIFY_REV_REC The value of Rev Rec on Rev Commit may not be modified for this transaction.

CANT_MODIFY_SUB You cannot change the subsidiary of this entity because one or more transactions exist for
this entity.

CANT_MODIFY_TAGATA The Payable Tegata is no longer in Issued state and cannot be modified.'

CANT_MODIFY_TAGATA The Receivable Tegata is no longer in Holding state and cannot be modified.

CANT_MODIFY_TEGATA The Payable Tegata is linked to bills and cannot be modified.'

CANT_MODIFY_VOID_TRANS The G/L impact of a voided transaction cannot be changed.

CANT_MODIFY_VOID_TRANS You may not change the GL impact on a voided {1: transaction type}.

CANT_MOVE_REALIZED_ You cannot move a Realized Gain/Loss transaction to a date before either the source or the
GAINLOSS payment transaction.

CANT_PAY_TAGATA Endorsed Tegata can only be paid on or after its maturity date.

CANT_PAY_TAGATA Payable Tegata can only be paid on or after its maturity date.

CANT_PROCESS_IMG Faceless PDF Library unable to process image. Image DPI:{1}.

CANT_RCEIV_BEFORE_FULFILL The item receipt for a transfer order line can not occur before the item fulfillment.

CANT_RCEIV_ITEM A mark shipped fulfillment line has been processed against item {1:item name}. This item
cannot be received.

CANT_RECEIVE_TAGATA Receivable Tegata can only be collected on or after its maturity date.

CANT_REJECT_ORDER You cannot reject this order because it has already been approved.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 321

Error Code Returned Long Description or Message

CANT_REMOV_ALL_ You may not modify this sales order in such a way that it removes all links to any fulfillment.
FULFILMNT_LINKS The modifications you made would leave the fulfillment <a href="/app/accounting/
transactions/transaction.nl?id={1}">{2}</a> unlinked.

CANT_REMOV_ITEM_SUB You may not remove a subsidiary from an item that is a member of an assembly, group, or
kit item if the parent item is available in that subsidiary.

CANT_REMOVE_ACH_PAY_ ACH payment methods cannot be removed

METHOD

CANT_REMOVE_APPROVAL The accounting approval cannot be removed from this expense report because some of its
lines have already been invoiced to the customer.

CANT_REMOVE_DOMAIN You are trying to remove a domain that is referenced by {1} CRM template(s). Please first
clear the domain from CRM templates before trying to remove it.

CANT_REMOVE_NEXUS A nexus cannot be removed from a subsidiary if the nexus is associated with a transaction.

CANT_REMOVE_SCHDUL You have attempted to remove an active schedule from a plan. Removing this participant is
not permitted after commissions against the plan have been generated.

CANT_REMOVE_SUB You cannot remove subsidiary: {1} because this record is used on a transaction for
subsidiary: {1}.

CANT_REMOVE_SUB You attempted to remove one or more subsidiaries from this item, but the item appears in
at least one transaction in those subsidiaries. To remove a subsidiary from the item, make
sure the item does not appear in any transactions for that subsidiary.

CANT_RESUBMIT_FAILED_ You cannot submit a deployment for execution whose status is set to Scheduled.
DPLYMNT

CANT_RETURN_FLD Can not return field {1}. Reason: {2}

CANT_RETURN_USED_GIFT_ Used gift certificates can not be returned.

CERT

CANT_REV_REC_BODY_AND_ The Revenue Recognition fields must be specified at EITHER the transaction body or the
LINE item line level, and may NOT be specified at both levels.

CANT_REVERSE_AUTH Card type doesn't allow reversals. No resolution. Authorization cannot be reversed.

CANT_SCHDUL_RECUR_EVENT Because the number of days in each month differs, recurring monthly events cannot be
scheduled after the 28th.

CANT_SEND_EMAIL Unable to send notification email

CANT_SEND_EMAIL Unable to send notification email to support rep

CANT_SET_CLOSE_DATE Unable to set expected close date of prospect/lead based on current estimates/
opportunities.

CANT_SET_INTERNALID You cannot set internalId with upsert.

CANT_SET_STATUS Unable to set status of prospect/lead based on current estimates.

CANT_SWITCH_ROLES_FROM_ Role switching is not allowed from this login.

CANT_SWITCH_SHIP_METHOD Switching the shipping method to another carrier is an unsupported operation, because it
requires reloading the item fulfillment form for that carrier.

CANT_UPDATE_ACCTNG_PRDS You cannot update accounting periods using SuiteScript or SOAP web services. Go to Setup
> Accounting > Manage G/L > Manage Accounting Periods.

CANT_UPDATE_AMT The amount on lines containing partially/fully recognized schedules can not be changed

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 322

Error Code Returned Long Description or Message

CANT_UPDATE_DYNAMIC_ You cannot update dynamic groups. Instead you must modify the saved search associated
GROUP with the group

CANT_UPDATE_FLDR These predefined folders cannot be updated

CANT_UPDATE_LINKED_ You cannot update linked transaction lines

TRANS_LINES

CANT_UPDATE_PRODUCT_ This item has multiple product feeds. SOAP web services schema version 2_6 or greater is
FEED required to modify product feeds for this item

CANT_UPDATE_RECRD_HAS_ Cannot update bug. Record has changed since you last retrieved it.
CHANGED

CANT_UPDATE_RECUR_EVENT Event <id {1}> contains recurrence patterns that are not supported in your client
application. You are not allowed to update recurrence pattern on this event. Contact your
software vendor for the latest Web Services upgrade.

CANT_UPDATE_ROOT_ Can not update root level website categories through SOAP web services.
CATEGORY

CANT_UPDATE_STATUS_TYPE You cannot update the only status of type {1}

CANT_VERIFY_CARD Card Verify not supported. Retry request.

CANT_VOID_TRANS You cannot void this transaction because it is linked to by one or more transactions such as
payments. You must delete or void those transactions first

CARD_EXPIRED Expired Card. Re-submit with valid expiration date.

CARD_ID_REQD Card ID required. Provide a valid card ID.

CASE_ALREADY_ASSIGNED This case cannot be grabbed because it is already assigned to another rep. To view the
case, go back and click the case number.

CASE_DSNT_EXIST Case doesn't exist or no customer is associated with case.

CASE_NOT_GROUP_MEMBER {1} this case record does not belong to your group.

CASH_SALE_EDIT_DISALLWD This cash sale cannot be edited while it has an Automated Clearing House transmission
in process.</TD></TR><TR><TD class=text> </TD></TR><TR><TD class=text> To view the
status of cash sales with ACH transmissions, go to Transactions > View Electronic Funds
Transfer Status.

CC_ACCT_REQD You must have a credit card account to perform this operation.

CC_ACCT_REQD You must have a credit card account to perform this operation. Click <a href='/app/
accounting/account/account.nl'>here</a> to add one.

CC_ALREADY_SAVED That credit card is already saved. Please use the saved credit card.

CC_EMAIL_ADDRESS_REQD Please go back and provide an email address to CC store orders to.

CC_NUM_REQD Please provide a credit card number.

CC_PROCESSOR_ERROR An error occurred while processing the credit card. Please contact the merchant for
assistance.

CC_PROCESSOR_ERROR An unexpected error occurred while processing the credit card through MerchantE (reason
code = {1}). Please contact NetSuite support.

CC_PROCESSOR_NOT_FOUND A suitable credit card processor was not found for this transaction.

CC_SECURITY_CODE_REQD This transaction requires the Credit Card Security Code. Please enter the required value in
the {1} field and re-submit.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 323

Error Code Returned Long Description or Message

CERT_AUTH_EXPD CA expired on {1}

CERT_EXPD Certificate expired on {1}

CERT_UNAVAILABLE Certificate unavailable (most likely has not been presented by client)

CHANGE_PMT_DATE_AND_ The payment is more than 30 days past due and has NOT been sent. Edit the payment to
REAPPROVE change the date and reapprove.

CHAR_ERROR Character error on Line# {1} Column# {2} (Byte # {3}). {4}

CHECKOUT_EMAIL_REQD Please go back and provide an email address to email checkout errors to.

CITY_REQD City is a required field and it cannot be null or empty.

CLASS_ALREADY_EXISTS A class already exists with that name. Go <a href="javascript:history.go(-1);";>back</a>,

change the name and resubmit.

CLASS_OR_DEPT_OR_CUST_ only one of class, cust, and dept can be non-null

REQD

CLEAR_AUTOCALC For items that use the time phased replenishment method, you must clear the Auto-
Calculate checkbox next to the Reorder Point and Preferred Stock Level fields. The mass
update cannot be performed unless these settings are changed.

CLOSE_PREVIOUSE_PERIOD Please close previous period before working on this one.

CLOSED_TRAN_PRD The G/L impact of a transaction in a closed period cannot be changed.

CLOSED_TRAN_PRD You cannot move a transaction to or from a closed period.

COGS_ERROR COGS lines not cleaned up

COGS_ERROR Cost of Goods Sold lines not in balance

COGS_ERROR LIFO/FIFO COGS count does not equal the number of items requested COGS ERROR 9765
itemsLinked={1}, itemsTotal={2} kdoc={3}, nid={4}

COMMSSN_ALREADY_CALCLTD You have attempted to remove an active sales participant from a plan. Removing this
participant is not permitted after commissions against the plan have been generated.

COMMSSN_FEATURE_ You have not enabled the Commissions feature.

DISABLED

COMMSSN_FEATURE_ You have not enabled the Partner Commissions/Royalties feature.

DISABLED

COMMSSN_PAYROLL_ITEM_ A commission payroll item must be added for each employee to be processed through
REQD payroll

COMP_DELETED_OR_MERGED The company you try to attach the context to has been deleted or merged.

COMPANION_PROP_REQD Error - Items do not have companion property (column) {1}

COMPANY_FLD_REQD The Company field is required for COD shipments. Go to Setup > Accounting > Shipping, set
the Company field on your FedEx Registration record and re-submit.

CONCUR_BILLPAY_JOB_ Your account currently has a bill pay approval job in progress. Only one bill pay approval
DISALLWD job per account is allowed at a time. Please wait until this process completes before
submitting another group of payments for approval. Visit the <a href='/app/
external/xml/upload/uploadlog.nl?displayType=BILLPAY'>status page </a> to track the
progress of the current job.

CONCUR_BULK_JOB_ This Account is already running a bulk processing job. Please visit the <a href='/app/
DISALLWD external/xml/upload/uploadlog.nl?displayType=BULKFULFILL'>status page </a> to track the
progress of the current job.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 324

Error Code Returned Long Description or Message

CONCUR_MASS_UPDATE_ A mass update is currently running in this account. Please try again in a few minutes.
DISALLWD

CONCUR_SEARCH_DISALLWD Search aborted by concurrent {1} search. Only one search may run at a time.

CONSLD_PRNT_AND_CHILD_ A company can be a consolidated child or a consolidated parent but not both
DISALLWD

CONTACT_ALREADY_EXISTS A contact record with this name already exists. Every contact record must have a unique
name.

CONTACT_ALREADY_EXISTS A contact with the name [{1}] already exists

CONTACT_NOT_GROUP_ {1} this contact does not belong to your group.

MEMBR

COOKIES_DISABLED You have disabled cookies from being stored on your computer or turned off per-session
cookies. Please enable this feature and try again

COUNTRY_STATE_MISMATCH The country and state/province are mismatched, the country is {1} and the state/province is
{2}. Please enter a state/province short name that matches the country.

CREATEDFROM_REQD Please enter a value for createdFrom.

CREDITS_DISALLWD Credits Not Allowed. Contact MerchantE to have credits enabled.

CRNCY_MISMATCH_BASE_ The currency you are registered to use is different from the base currency of this company.
CRNCY

CRNCY_NOT_UPDATED The following currencies were not updated: {1}

CRNCY_RCRD_DELETED This currency record has been deleted. You can create a new currency record at Lists >
Accounting > Currencies > New.

CRNCY_REQD currency expected for pricing element

CSC_SETUP_REQD To display the CSC field on the form, you must enable the "Use Card Security Code for
Credit Card Transactions" preference, located on the Setup > Accounting Preferences task.

CSTM_FIELD_KEY_REQD The specified custom field key is missing.

CSTM_FIELD_VALUE_REQD The specified custom field value is missing.

CSV_DELIMITER_ERROR Values in the following CSV file(s) are not comma separated, and cannot be imported.
Please reformat the file(s) and try again. For instructions, <a href='javascript:
nlPopupHelp("DOC_Reformatting_Semi-Colon_Separated_CSV_Files","help")'>visit this help
topic.</a>

CUST_ARLEADY_HAS_ACCT Attempting to provision a new account to a customer with an existing account

CUST_CNTR_USER_ACCESS_ This form is only accesible to customer center users.

ONLY

CUST_LEAD_NOT_GROUP_ {1} this customer or lead does not belong to your group.
MEMBR

CYBERSOURCE_ERROR An unexpected error occurred while processing the credit card through CyberSource
(reason code = {1}). Please contact NetSuite Customer Support.

CYBERSOURCE_ERROR : The credit card was declined by the card issuer. Use a different card for payment or
contact the card issuer for more information.

CYBERSOURCE_ERROR The credit card transaction was denied by the issuing bank. Please try another card or
contact the card issuer for more information.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 325

Error Code Returned Long Description or Message

CYBERSOURCE_ERROR The credit card has expired or the expiration date does not match the date on file with the
card issuer. Please correct the expiration date or try another card.

CYBERSOURCE_ERROR The credit card transaction was denied due to insufficient funds. Please try another card or
contact the card issuer for more information.

CYBERSOURCE_ERROR The credit card transaction could not be completed because the issuing bank was not
available. Please try another card or wait a few minutes and try again.

CYBERSOURCE_ERROR Inactive card or card not authorized for card-not-present transactions. Please try another
card or contact the card issuer for more information.

CYBERSOURCE_ERROR The card has reached the credit limit. Please try another card or contact the card issuer for
more information.

CYBERSOURCE_ERROR Invalid card verification number. Please check to make sure you have provided the correct
card verification number.

CYBERSOURCE_ERROR Invalid credit card account number. Please check to make sure you have provided the
correct credit card account number.

CYBERSOURCE_ERROR The type of credit card provided is not accepted by this merchant. Please try another card
or contact the merchant for more information.

CYBERSOURCE_ERROR Successful transaction.

CYBERSOURCE_ERROR The request is missing one or more required fields. Possible action: See the reply fields
missingField_0...N for which fields are missing. Resend the request with the complete
information.

CYBERSOURCE_ERROR One or more fields in the request contains invalid data. Possible action: See the reply
fields invalidField_0...N for which fields are invalid. Resend the request with the correct
information.

CYBERSOURCE_ERROR The merchantReferenceCode sent with this authorization request matches the
merchantReferenceCode of another authorization request that you sent in the last 15
minutes. Possible action: Resend the request with a unique merchantReferenceCode value.

CYBERSOURCE_ERROR Error: General system failure. See the documentation for your CyberSource client (SDK) for
information about how to handle retries in the case of system errors.

CYBERSOURCE_ERROR Error: The request was received but there was a server timeout. This error does not include
timeouts between the client and the server. Possible action: To avoid duplicating the order,
do not resend the request until you have reviewed the order status in the Business Center.
See the documentation for your CyberSource client (SDK) for information about how to
handle retries in the case of system errors.

CYBERSOURCE_ERROR Error: The request was received, but a service did not finish running in time. Possible action:
To avoid duplicating the order, do not resend the request until you have reviewed the order
status in the Business Center. See the documentation for your CyberSource client (SDK) for
information about how to handle retries in the case of system errors.

CYBERSOURCE_ERROR The issuing bank has questions about the request. You do not receive an authorization
code programmatically, but you might receive one verbally by calling the processor.
Possible action: Call your processor or the issuing bank to possibly receive a verbal
authorization. For contact phone numbers, refer to your merchant bank information.

CYBERSOURCE_ERROR Expired card. You might also receive this if the expiration date you provided does not match
the date the issuing bank has on file. Possible action: Request a different card or other form
of payment.

CYBERSOURCE_ERROR General decline of the card. No other information provided by the issuing bank. Possible
action: Request a different card or other form of payment.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 326

Error Code Returned Long Description or Message

CYBERSOURCE_ERROR Insufficient funds in the account. Possible action: Request a different card or other form of
payment.

CYBERSOURCE_ERROR Stolen or lost card. Possible action: Review the customers information and determine if you
want to request a different card from the customer.

CYBERSOURCE_ERROR Issuing bank unavailable. Possible action: Wait a few minutes and resend the request.

CYBERSOURCE_ERROR Inactive card or card not authorized for card-not-present transactions. Possible action:
Request a different card or other form of payment.

CYBERSOURCE_ERROR The card has reached the credit limit. Possible action: Request a different card or other
form of payment.

CYBERSOURCE_ERROR Invalid card verification number. Possible action: Request a different card or other form of
payment.

CYBERSOURCE_ERROR The customer matched an entry on the processors negative file. Possible action: Review the
order and contact the payment processor.

CYBERSOURCE_ERROR Invalid account number. Possible action: Request a different card or other form of payment.

CYBERSOURCE_ERROR The card type is not accepted by the payment processor. Possible action: Request a
different card or other form of payment. Also, check with CyberSource Customer Support to
make sure your account is configured correctly.

CYBERSOURCE_ERROR General decline by the processor. Possible action: Request a different card or other form of
payment.

CYBERSOURCE_ERROR There is a problem with your CyberSource merchant configuration. Possible action: Do not
resend the request. Contact Customer Support to correct the configuration problem.

CYBERSOURCE_ERROR The requested amount exceeds the originally authorized amount. Occurs, for example, if
you try to capture an amount larger than the original authorization amount. This reason
code only applies if you are processing a capture through the API. See Using the API for
Captures and Credits. Possible action: Issue a new authorization and capture request for
the new amount.

CYBERSOURCE_ERROR Processor failure. Possible action: Tell the customer the payment processing system is
unavailable temporarily, and to try their order again in a few minutes.

CYBERSOURCE_ERROR The authorization has already been captured. This reason code only applies if you are
processing a capture through the API. See Using the API for Captures and Credits. Possible
action: No action required.

CYBERSOURCE_ERROR The requested transaction amount must match the previous transaction amount. This
reason code only applies if you are processing a capture or credit through the API. See
Using the API for Captures and Credits. Possible action: Correct the amount and resend the
request.

CYBERSOURCE_ERROR The card type sent is invalid or does not correlate with the credit card number. Possible
action: Ask your customer to confirm that the card is the type that they indicated in your
Web store, then resend the request.

CYBERSOURCE_ERROR The request ID is invalid. This reason code only applies when you are processing a capture
or credit through the API. See Using the API for Captures and Credits. Possible action:
Request a new authorization, and if successful, proceed with the capture.

CYBERSOURCE_ERROR You requested a capture through the API, but there is no corresponding, unused
authorization record. Occurs if there was not a previously successful authorization request
or if the previously successful authorization has already been used by another capture
request. This reason code only applies when you are processing a capture through the API.
See Using the API for Captures and Credits. Possible action: Request a new authorization,
and if successful, proceed with the capture.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 327

Error Code Returned Long Description or Message

CYBERSOURCE_ERROR The capture or credit is not voidable because the capture or credit information has already
been submitted to your processor. Or, you requested a void for a type of transaction that
cannot be voided. This reason code applies only if you are processing a void through the
API. See Using the API for Voids for information about voids. Possible action: No action
required.

CYBERSOURCE_ERROR You requested a credit for a capture that was previously voided. This reason code
applies only if you are processing a void through the API. See Using the API for Voids for
information about voids. Possible action: No action required.

CYBERSOURCE_ERROR Error: The request was received, but there was a timeout at the payment processor.
Possible action: To avoid duplicating the transaction, do not resend the request until you
have reviewed the transaction status in the Business Center.

CYBERSOURCE_ERROR The authorization request was approved by the issuing bank but declined by
CyberSource based on your Smart Authorization settings. Possible action: Do not
capture the authorization without further review. Review the ccAuthReply_avsCode,
ccAuthReply_cvCode, and ccAuthReply_authFactorCode fields to determine why
CyberSource rejected the request.

CYBERSOURCE_ERROR Unable to process credit card transaction. The code returned from CyberSource {1} is not a
recognized reason code. Please contact NetSuite support.

CYCLE_IN_PROJECT_PLAN The changes made to this entity have cause a cycle in the project plan. Select a different
parent and/or predecessors to avoid the cycle.

DASHBOARD_LOCKED Your dashboard has been set up and locked by an administrator. Please contact them for
details.

DATA_MUST_BE_UNIQUE The update failed because every entry in this column must be unique.

DATA_REQD You need to provide a proper value for the required field: {1}.

DATA_REQD You are missing the following required field(s):{1}

DATE_EXPECTED You entered '{1}' into a field where a calendar date was expected.\nPlease go back and
change this value to the correct date.

DATE_PARAM_REQD missing date parameter

DATE_PRD_MISMATCH Your transaction date does not fall between the start and end dates of your accounting
period.

DEFAULT_CUR_REQD Default currency cannot be null

DEFAULT_EXPENSE_ACCT_ A default expense account must be specified to activate items on the list. Go to Setup >
REQD Payroll > Set Up Payroll and click the Default Accounts subtab. In the Payroll Expenses
Account field, choose a default general ledger account for your payroll expenses. Then, click
Save.

DEFAULT_ISSUE_OWNER_ There is no default owner for the issue role {1}. This operation cannot be completed until
REQD this is corrected.

DEFAULT_LIAB_ACCT_REQD A default liability account must be specified to activate items on the list.nGo to Setup >
Payroll > Set Up Payroll and click the Default Accounts subtab. In the Payroll Liabilities
Account field, choose a default general ledger account for your payroll liabilities. Then, click
Save.

DEFAULT_ROLE_REQD Login Failed because you do not have a default role for the company and email entered.
Please Try Again.

DEFAULT_TYPE_DELETE_ You cannot delete default types

DISALLWD

DEFERRAL_ACCT_REQD Lines with amortization templates must have a deferral account.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 328

Error Code Returned Long Description or Message

DEFERRAL_ACCT_REQD Lines with revenue recognition templates must have a deferral account.

DEFERRED_REV_REC_ACCT_ The {1} item does not have a Deferred Revenue Account specified. Please assign the item
REQD a Deferred Revenue Account using the standard User Interface, and then re-import the
transaction.

DEPT_IN_USE Your classes cannot be converted to departments because your existing department
records are referred to by transactions or other records. These department records cannot
be overwritten.

DFRNT_SWAP_PRICE_LEVELS_ Please select different price levels to swap prices.

REQD

DISALLWD_IP_ADDRESS The specified IP address rules must allow the login of your current IP Address. Your current
IP address is {1}. For information on entering IP address rules, click Help at the top of the
page.

DISCOUNT_ACCT_SETUP_ Please <a href='/app/setup/acctsetup.nl'>Set Up Discount Accounts</a> first.

REQD

DISCOUNT_DISALLWD You have attempted to save this transaction with one or more discounts and where
all items have Permit Discount = Never. You must change one of the items to permit
a discount, add a new item without the restriction or remove the discount from the
transaction.

DISCOUNT_DISALLWD_VSOE Posting discounts are not allowed on items in VSOE bundles.

DISCOUNT_EXCEED_TOTAL Discount can not exceed item total.

DISTRIB_REQD_ONE_DAY_ All items must be distributed at least one day before they may be transferred.
BFORE

DOMAIN_IN_USE The domain {1} is already in use

DOMAIN_WEBSITE_REQD Please select a Web Site for domain {1}

DROP_SHIP_ERROR The following error occurred when updating the quantity on the drop ship {1:transaction
type}: {2:error message}

DROP_SHIP_ERROR The transaction was successfully saved, but an error occurred while running user events
and email alerts after updating the drop ship {1:transaction type}(s)

DROP_SHIP_ERROR The transaction was successfully saved, but an error occurred while running user events
after updating the drop ship {1:transaction type}(s)

DROP_SHIP_OR_SPECIAL_ Items can be Drop Ship or Special Order but not both
ORD_ALLWD

DUE_DATE_BFORE_START_ Due date occurs before start date

DATE

DUE_DATE_REQD Please enter a value for {1} Due Date

DUP_ACCT_NAME The account name you have chosen is already used. Go <a
href='javascript:history.go(-1);';>back</a>, change the name and resubmit.

DUP_ACCT_NOT_ALLWD You may not use duplicate accounts on an item.

DUP_ACCT_NUM The account number you have chosen is already used.

DUP_ACCT_NUM The account number you have chosen is already used. Go <a
href="javascript:history.go(-1);";>back</a>, change the number and resubmit.

DUP_ACCT_ON_TRANS This transaction has duplicate accounts. The main line of the transaction and the line
labeled '{1}' both use the account named '{2}'.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 329

Error Code Returned Long Description or Message

DUP_BIN A bin already exists with that name. Go back, change the name, and resubmit.

DUP_BIN There is already another bin with that number. Please choose a bin number that is not used
by another bin.

DUP_BUNDLE_IN_ACCT That bundle has already been copied or installed in this account.

DUP_BUNDLE_IN_ACCT You cannot install this bundle as it is a copy of bundle {1} that you previously installed.

DUP_CATEGORY This category already exists

DUP_CATEGORY_NAME A category already exists with that name. Go <a href="javascript:history.go(-1);";>back</a>,

change the name and resubmit.

DUP_COLOR_THEME This color theme already exists

DUP_CSTM_FIELD This custom field already exists

DUP_CSTM_LAYOUT This custom layout already exists

DUP_CSTM_LIST There is already a Custom List or Custom List element with that name

DUP_CSTM_RCRD There is already a Custom Record with that name

DUP_CSTM_RCRD_ENTRY There is already a Custom Record Entry with that name

DUP_CSTM_TAB This custom tab already exists

DUP_EMPL_EMAIL There is already an employee with external access to this account using that email address.
All employees with external access must have a unique email address for login purposes.
Go <a href="javascript:history.go(-1);";>back</a>, change the email address and resubmit.

DUP_EMPL_ENTITY_NAME There is already an employee with external access to this account using that entity name.
All employees with external access must have a unique entity name for login purposes. Go
<a href="javascript:history.go(-1);";>back</a>, change the entity name and resubmit.

DUP_EMPL_TMPLT There is already an employee template with that name. Go <a

href="javascript:history.go(-1);";>back</a>, change the template name and resubmit.

DUP_ENTITY This entity already exists.

DUP_ENTITY_EMAIL There is already an external entity (eg. customer, vendor, or employee) with access to this
account using that email address. All external entities with access must have a unique email
address for login purposes.

DUP_ENTITY_NAME There is already an external entity (eg. customer, vendor, or employee) with access to this
account using that entity name. All external entities with access must have a unique entity
name for login purposes.

DUP_FEDEX_ACCT_NUM There is an existing NetSuite registration for FedEx account number {1}.

DUP_FINANCL_STATMNT_ This financial statement layout already exists.

LAYOUT

DUP_INFO_ITEM This information item already exists

DUP_ISSUE_NAME_OR_NUM You cannot set {1:issue record name} {2:issue number} to be a duplicate of itself or one of
its duplicates.

DUP_ITEM Uniqueness error - there is already an item with that name or name/parent combination.

DUP_ITEM_LAYOUT This item/category layout already exists

DUP_ITEM_NAME There is already an item with that name. . Go <a href="javascript:history.go(-1);";>back</

a>, change the name and resubmit.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 330

Error Code Returned Long Description or Message

DUP_ITEM_OPTION A child item child with that combination of options already exists

DUP_ITEM_TMPLT This item/category template already exists

DUP_MATRIX_OPTN_ABBRV Matrix option '{1}' already uses that abbreviation. Please choose another.

DUP_MEMRZD_TRANS There is already a Memorized Transaction with that name. Go <a

href="javascript:history.go(-1);";>back</a>, change the name and resubmit.

DUP_NAME That name is already in use. Go <a href="javascript:history.go(-1);";>back</a>, change

the name and resubmit.

DUP_PAYROLL_ITEM There is already a payroll item named {1}

DUP_PRESNTN_CAT This presentation category already exists

DUP_RCRD A {1} already exists with that name. Go <a href="javascript:history.go(-1);";>back</a>,

change the name and resubmit.

DUP_RCRD Matched more than one record for {1}

DUP_RCRD Matched more than one record (internalIds {1} and {2})

DUP_RCRD This record already exists

DUP_RCRD_LINK Link to that record already exists

DUP_SALES_TAX_ITEM You have entered a duplicate Sales Tax Item. Go <a

href="javascript:history.go(-1);";>back</a>, change the name, city, state or zip code and
resubmit.

DUP_SHIPPING_ITEM You have entered a duplicate Shipping Item. Go <a

href="javascript:history.go(-1);";>back</a>, change the name and resubmit.

DUP_SHORT_NAME Duplicate short name

DUP_SITE_THEME This site theme already exists

DUP_SOURCE_ACCT Duplicate source accounts are not allowed.

DUP_TAX_CODE You have entered a duplicate Tax Code. Go <a href="javascript:history.go(-1);";>back</

a>, change the name and resubmit.

DUP_TAX_CODE You have entered a duplicate Tax Code. Go <a href=\"javascript:history.go(-1);\";>back</

a>, change the name, city, state or zip code and resubmit.

DUP_TRACKING_NUM You entered the following tracking number twice: {1}. Note that a single tracking number
may not contain spaces or commas. A space or comma will be interpreted as the separator
between different tracking numbers. For example, '1029 3847 465' will be interpreted as 3
different tracking numbers. It should be entered without spaces: '10293847465'.

DUP_TRANS Duplicate Trans. Unable to locate, no match.

DUP_UPS_ACCT_NUM There is an existing NetSuite registration for UPS account number {1}.

DUP_VENDOR_EMAIL There is already a vendor with external access to this account using that email address. All
vendors with external access must have a unique email address for login purposes. Go <a
href='javascript:history.go(-1);';>back</a>, change the email address and resubmit.

DUP_VENDOR_NAME There is already a vendor using that entity name. All vendors must have a unique entity
name. Go <a href="javascript:history.go(-1);";>back</a>, change the entity name and
resubmit.

DUPLICATE_INVENTORY_NUM Duplicate inventory number found in entry: {1}

DUPLICATE_INVENTORY_NUM Duplicate inventory number found on different lines of transaction

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 331

Error Code Returned Long Description or Message

DUPLICATE_KEYS This record contains duplicated key or keys. Please correct it before next update.

DUPLICATE_NAME_FOR_PRD Please choose a different period name. "{1}" is already taken.

DUPLICATE_NAME_FOR_ROLE Please choose a different role name. "{1}" is already taken.

EARNING_ITEM_REQD At least one employee in this payroll has no earning items. Please make sure that every
employee has at least one earning item.

EDITION_DSNT_SUPRT_ WorldPay is not supported in this edition.

WORLDPAY

EIN_OR_TIN_REQD You must set either the Employer Identification Number (EIN) or SSN/TIN (Social Security
Number, Tax ID Number) to complete this fulfillment. Please go to Setup > Company >
Company Information to set either of these fields and re-submit.

EMAIL_ADDRS_REQD Please enter your email address

EMAIL_ADDRS_REQD_TO_ Please enter an email address for this company. A notification email will be sent when this
NOTIFY case record is saved.

EMAIL_ADDRS_REQD_TO_ The recipient you are sending this email to does not have an email address. Please enter
NOTIFY one and try again

EMAIL_REQ_HANDLER_ERROR an error occurred while instantiating an email requesthandler

EMAIL_REQ_HANDLER_ERROR An Error occurred while performing system-level validation of email request for <{1}> from
<{2}>

EMAIL_REQ_HANDLER_ERROR An Error occurred while POSTing data into requestHandlder: {1}

EMAIL_REQ_HANDLER_ERROR an error occurred while servicing an email requesthandler in state: {1}

EMAIL_REQD You must enter a valid email address to email the transaction.

EMAIL_REQD_ACCT_ Cannot provision an account without an email address for this customer: Was external
PROVISION access granted?

EMPL_IN_USE You can't delete this employee, as commissions have been calculated for this employee.

EMPL_IN_USE You can't delete this employee, as it is or has been referenced by other employees as a
supervisor.

ERROR_DELETE_CARD_DATA Failed to delete card data. Retry request.

ERROR_IN_TERRITORY_ Error Performing Initial Round_Robin Assignment for Territory: {1}

ASSGNMNT

ERROR_IN_TERRITORY_ Error Performing Round_Robin Assignment for Territory: {1}

ASSGNMNT

ERROR_PRCSSNG_TRANS There were errors processing the selected transactions. Please process them individually
for more information.

ERROR_REFUND_TRANS Failed to refund International transaction. Retry request.

ERROR_REVERSE_AUTH Failed to reverse International authorization. Retry request.

ERROR_SENDING_TRAN_EMAIL The transaction was entered successfully, but an unexpected error occurred while sending
the transaction email {1}

ERROR_VOID_TRANS Failed to void International transaction. Retry request.

EVENT_ID_NOT_FOUND Event ID not found

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 332

Error Code Returned Long Description or Message

EXCEEDED_MAX_ALLWD_LOC You have reached the maximum allowance of {1} location records. If you need to create
additional location records, please contact our NetSuite Customer Support team for
assistance

EXCEEDED_MAX_CONCUR_ The maximum number of concurrent requests has been exceeded. Please try your request
RQST again when an existing session has completed.

EXCEEDED_MAX_EMAILS This account has {1} more bulk emails that can be sent. If you would like to purchase an
additional block of emails, please contact your account manager.

EXCEEDED_MAX_EMAILS The merge exceeds the number of bulk merge emails allotted to your account this year.
This account has {1} more bulk emails that can be sent this year. Please contact your
NetSuite account manager to purchase additional block of emails.

EXCEEDED_MAX_EMAILS This campaign email event exceeds the number of emails ({1}) that can be sent per event
without setting up a default campaign domain or specifying one on the campaign email
template.

EXCEEDED_MAX_EMAILS This merge operation exceeds the number of emails ({1}) that can be sent per execution
without setting up a bulk merge domain or specifying one on the email template.

EXCEEDED_MAX_EMAILS You cannot schedule more than {1} emails per year. If you'd like to purchase an additional
block of emails, please contact your account manager.

EXCEEDED_MAX_FEATURED_ There is a limit of {1} featured items on this page.

ITEMS

EXCEEDED_MAX_FIELD_ Address line 1 cannot exceed 35 characters. Please check the shipper and recipient address
LENGTH to ensure the "Address 1" field is a maximum of 35 characters.

EXCEEDED_MAX_FIELD_ Address line 2 cannot exceed 35 characters. Please check the shipper and recipient address
LENGTH to ensure the "Address 2" field is a maximum of 35 characters.

EXCEEDED_MAX_FIELD_ The field {1} contained more than the maximum number ( {2} ) of characters allowed.
LENGTH

EXCEEDED_MAX_FIELD_ The string "{1}" contained more than the maximum number of characters allowed.
LENGTH

EXCEEDED_MAX_FIELD_ Too many characters for a field

LENGTH

EXCEEDED_MAX_MATRIX_ The total combination of subitems you have selected exceeds the maximum allowed of
OPTNS 2000. Please choose fewer options on the matrix tab.

EXCEEDED_MAX_PDF_ There is a maximum of 100 custom elements allowed on a PDF layout.

ELEMENTS

EXCEEDED_MAX_PDF_EXPORT_ PDF Export is limited to 30 columns.

COL

EXCEEDED_MAX_PIN_RETRIES PIN entered incorrectly too often.

EXCEEDED_MAX_RCRD You have reached the maximum allowance of {1} {2} records. If you need to create
additional {2} records, please contact our NetSuite Customer Support team for assistance

EXCEEDED_MAX_REPORT_COL The option you selected in the Column field results in a report that exceeds the maximum
number of columns allowed. Please select additional filters or select a shorter date/period
range.

EXCEEDED_MAX_REPORT_ Reports are limited to {1} rows. Please narrow your results.
ROWS

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 333

Error Code Returned Long Description or Message

EXCEEDED_MAX_REPORT_SIZE The results of this report are too large. Please narrow your results.

EXCEEDED_MAX_SESSIONS Maximum active sessions exceeded. Please wait 5 minutes and login again.

EXCEEDED_MAX_SHIP_ The maximum number of custom shipping packages has been exceeded: {1}. Please
PACKAGE reduce item quantities to generate fewer packages, or enter the packages manually.

EXCEEDED_MAX_TIME The operation has exceeded maximum allowed time for completion. Operation aborted.

EXCEEDED_MAX_TRANS_LINES Transactions may not contain more than {1} lines.

EXCEEDED_MAX_USERS_ The changes you have made to this employee's access have caused you to exceed either
ALLWD your full access or Employee Center allowance. To make these changes you must either
adjust the number of employees assigned the Employee Center role or contact your
account representative to purchase additional licenses.

EXCEEDED_MAX_USERS_ Assigning this role would exceed your full access licenses ({1}). To assign this role, you must
ALLWD remove another employee's full access roles or contact your account representative to
purchase additional licenses.

EXCEEDED_MAX_USERS_ The changes you have made to this employee's access have caused you to exceed either
ALLWD your full access or Retail User allowance. To make these changes you must either adjust the
number of employees assigned the Retail Clerk role or contact your account representative
to purchase additional licenses.

EXCEEDED_PER_TRANS_MAX Exceeded per transaction maximum on account {1}

EXCEEDED_RQST_SIZE_LIMIT You have exceeded the permitted request size limit ({1})

EXCEEDS_ALLWD_LICENSES Adding access for this user exceeds the number of licenses you have purchased. To add
another user, you must first remove access from an existing user or contact NetSuite to
purchase additional licenses.

EXCEEDS_ALLWD_LICENSES Adding a {1} would exceed the number of licenses you have purchased. Please contact
NetSuite for additional licenses.

EXPENSE_ENTRY_DISALLWD {1} does not allow expense entry.

EXPIRED_SEARCH_CRITERIA Your search criteria expired. The criteria for a specific search generally expire after 15
minutes of inactivity. Please return to the search definition page and re-submit your search.

EXT_CAT_LINK_SETUP_REQD Error - you have not properly set up links from your External Catalog Site back into {1}!

EXTERNALID_NOT_ Field {1} does not support externalId

SUPPORTED

EXTERNALID_REQD This operation requires a value for externalId.

FAILED_FEDEX_LABEL_VOID Failed FedEx Label Void

FAILED_FORM_VALIDATION Form validation failed. You cannot submit this record.

FAILED_UPS_LABEL_VOID Failed UPS Label Void

FAX_NUM_REQD You must enter a fax number.

FAX_NUM_REQD You must enter a fax number for this recipient before performing a fax merge operation.

FAX_NUM_REQD You must enter a valid fax number to fax the transaction.

FAX_SETUP_REQD Before you can send faxes, you need to go to the <a href='/app/setup/printing.nl'>Set Up
Printing, Fax & Email</a> page and set up the fax service.

FEATURE_DISABLED You do not have the correct features enabled to search on {1}.

FEATURE_DISABLED The ''{1}'' feature is not enabled in your {2} account.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 334

Error Code Returned Long Description or Message

FEATURE_DISABLED The feature '{1}' required to access this page is not enabled in this account.

FEATURE_UNAVAILABLE {1} Trial does not allow access to this feature. If you would like more information
about this feature, please contact your account manager.

FEATURE_UNAVAILABLE Error - This business does not have the External Catalog Site feature enabled.

FEATURE_UNAVAILABLE Test Drive does not allow access to this feature. If you would like more information about
this feature, please contact your account manager.

FEATURE_UNAVAILABLE That feature is only available to Plus users

FEATURE_UNAVAILABLE The {1} feature is not available to your company.

FEATURE_UNAVAILABLE This feature is not available to your company.

FED_ID_REQD Must have Federal Identification Number to process 1099-MISC forms.

FED_WITHHOLDING_REQD Your employee record does not have current Federal Withholding information.Please
contact your supervisor to set up your record with the appropriate information.

FEDEX_ACCT_REQD The FedEx Account Number has not been set.

FEDEX_CANT_INTEGRATE_ The fulfillment cannot be integrated with {1} because the Shipping Integration Carrier is set
FULFILL to UPS.

FEDEX_DROPOFF_TYP_REQD The FedEx Dropoff Type has not been set.

FEDEX_INVALID_ACCT_NUM This account number was not recognized by FedEx. Please re-enter your account number,
or contact FedEx to open a new account.

FEDEX_ITEM_CONTENTS_REQD For international shipments, {1} requires specific information about the item contents.

FEDEX_METER_NOT_ A FedEx Meter Number was not retrieved for account number {1}. Please try your request
RETRIEVED again in a few minutes.

FEDEX_METER_REQD The FedEx Meter Number has not been set.

FEDEX_ONE_PACKG_ALLWD The selected FedEx service allows only one package per fulfillment. If more than one
package is required, please break up the shipment into multiple fulfillments of one package
each.

FEDEX_ORIGIN_COUNTRY_US_ The origin country must be United States (US) for all Item Fulfillments when using a FedEx
REQD shipping method.

FEDEX_RATING_SRVC_ The FedEx rating services application is currently unavailable. Please try your request again
UNAVAILBL in a few minutes.

FEDEX_REG_NOT_FOUND A valid FedEx Registration was not found for the specified location:

FEDEX_SHIP_SRVC_REQD The FedEx Shipping Service has not been set.

FEDEX_SHIP_SRVC_UNAVAILBL The FedEx shipping services application is currently unavailable. Please try your request
again in a few minutes.

FEDEX_UNSUPRTD_ORIGIN_ The origin country {1} is currently not supported for Item Fulfillments when using a FedEx
COUNTRY shipping method.

FEDEX_USD_EXCHANGE_RATE_ Cannot retrieve FedEx realtime rates: USD Exchange Rate is required when requesting
REQD FedEx realtime rates.

FEDEX_VOID_ERROR The FedEx Void failed due to a system error.

FIELD_CALL_DATE_REQD Missing Required Field: Call Date

FIELD_DEFN_REQD Field definition not found

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 335

Error Code Returned Long Description or Message

FIELD_NOT_SETTABLE_ON_ You are not allowed to set the nsKey for a record
ADD

FIELD_PARAM_REQD Please enter a value for {1}

FIELD_PARAM_REQD Please enter values for {1}.

FIELD_REQD Mandatory Field Missing

FIELD_REQD You must first select a field

FILE_ALREADY_EXISTS A file with the same name already exists in the selected folder.

FILE_ALREADY_EXISTS Note: You are attempting to upload a file with a name matching an existing file in the
selected folder. Please rename this file or select another folder, and then upload your file.

FILE_DISALLWD_IN_ROOT_ You attempted to copy a file to the root directory. Only folders can exist in the root
FLDR directory.

FILE_DISALLWD_IN_ROOT_ You attempted to move a file to the root directory. Only folders can exist in the root
FLDR directory.

FILE_MISSING File Missing

FILE_NOT_DOWNLOADABLE Illegal request for a file that isn't downloadable

FILE_NOT_FOUND File/Media Item {1} not found.

FILE_NOT_FOUND File not found. Please try your download again.

FILE_REQD You must enter a file before submitting this form.

FILE_REQD You must upload a file before creating this media item

FILE_UPLOAD_IN_PROGRESS Files are currently being uploaded to this account.

FILTER_BY_AMT_REQD Please enter an amount to filter by.

FINANCE_CHARGE_SET_PREFS Finance Charge Item cannot be edited as an item. Please go to the finance charge
preferences page to make changes

FINANCE_CHARGE_SETUP_ Please set <a href='/app/setup/finchargepref.nl'>Finance Charge Preferences</a> first.

REQD

FIRST_LAST_NAMES_REQD Please enter both your first and last name.

FIRST_QTY_BUCKET_MUST_BE_ Quantity defined for first quantity bucket must be zero

ZERO

FLD_VALUE_REQD Results are incomplete. You must provide a value for field {1}.

FLD_VALUE_TOO_LARGE Value for field {1} is too large to be processed.

FOLDER_ALREADY_EXISTS A folder with the same name already exists in the selected folder.

FORM_RESUBMISSION_REQD You have logged in to a different user since you navigated to this form. You must re-submit
this form as the new user.

FORM_SETUP_REQD No appropriate forms are enabled for this role. Please contact your Administrator.

FORM_UNAVAILBL_ONLINE This form is not available online

FORMULA_ERROR Your formula has an error in it. It could resolve to the wrong datatype, use an unknown
function, or have a syntax error. Please go back, correct the formula, and re-submit.

FRIENDLY_NAME_REQD Missing Friendly Name. Friendly Name is a required field and it cannot be null or empty.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 336

Error Code Returned Long Description or Message

FULFILL_REQD_FIELDS_ For the listed items, please edit the item record and provide values for the specified fields,
MISSING and retry the fulfillment.

FULFILL_REQD_FIELDS_ The {1} field is required to complete this fulfillment. Please return to the International tab
MISSING on the item fulfillment and provide a value for the specified field and retry the fulfillment.

FULFILL_REQD_PARAMS_ Could not perform operation '{1}' since {2} parameter was not set.
MISSING

FULL_DISTRIB_REQD You must fully distribute all {1} numbers for {1} numbered items.

FULL_USERS_REQD_TO_ Only full {1} users can integrate with partners.

INTEGRATE

FX_MALFORMED_RESPONSE Received malformed response from Foreign Exchange source.

FX_RATE_REQD_FEDEX_RATE Cannot retrieve {1} realtime rates: {2} Exchange Rate is required when requesting {3}
realtime rates.

FX_TRANS_DISALLWD FX transactions not accepted for this account. Contact MerchantE.

GETALL_RCRD_TYPE_REQD The getAll record type is required.

GIFT_CERT_AMT_EXCEED_ Gift certificate redemption amount exceeds available amount on the gift certificate
AVAILBL

GIFT_CERT_AUTH_ALREADY_ Gift certificate authorization code {1} already exists

EXISTS

GIFT_CERT_CAN_BE_USED_ A gift certificate may only be used one time on a transaction

ONCE

GIFT_CERT_CODE_REQD Gift certificate codes are missing

GIFT_CERT_CODE_REQD Missing gift certificate authorization code(s). Please go back and enter authorization codes
on the {1}.

GIFT_CERT_CODE_REQD You must specify a gift certificate code.

GIFT_CERT_IN_USE Another user is using gift certificate {1}

GIFT_CERT_IN_USE Gift certificate code {1} is already in use

GIFT_CERT_INVALID_NUM Gift certificate numbers may not contain the '{1}' character.

GROUP_DSNT_EXIST That group does not exist

GROUP_REQD You cannot perform a bulk merge operation with an empty group

GROUP_TYPE_REQD The group type is required.

GRTR_QTY_PRICE_LEVEL_REQD Each quantity pricing level must be greater than the previous quantity pricing level.

ILLEGAL_ID Illegal ID. Please enter a name.

ILLEGAL_PERIOD_STRUCTURE Illegal period structure. Date {1} is in multiple periods.

INACTIVE_CC_PROFILE The credit card processing profile provided is inactive.

INACTIVE_RCRD_FOR_ROLE The record for this role has been made inactive.

INAVLID_FILE_TYP A change has been made to this file's format. You cannot upload this type of file.

INAVLID_FILE_TYP You attempted to upload a restricted file type. Please try again with a selection from the list
below:

INAVLID_ITEM_TYP Invalid item type [{1}] for item [{2}].

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 337

Error Code Returned Long Description or Message

INAVLID_PRICING_MTRX Invalid Quantity Pricing Matrix for quantity level {1} : Quantity {2}, Base Price {3}

INCOMPATIBLE_ACCT_ The account change you have made is incompatible with old transactions. If you need to
CHANGE swap two accounts, you need to do it in 3 steps. For example, to change the income and
asset accounts for an item:<ul><li>(1) Change the income account to a temporary account
and save</li><li>(2) Change asset account to the old income account and save</li><li>(3)
Change the income to the old asset account and save</li></ul>Please contact customer
support if you need assistance with this.

INCOMPATIBLE_ACCT_ The account change you have made is incompatible with old transactions. Please either
CHANGE change the account selection appropriately or do not request to update past transactions.

INCOMPLETE_BILLING_ADDR Billing address is incomplete.

INCOMPLETE_FILE_UPLOAD The upload did not complete correctly. Please try uploading the file again. If you have
repeatedly received this error message, please send mail to <a href="mailto:{1}">{2}
NetSuite Customer Support</a>.

INCRCT_ORD_INFO The order contains incorrect information and was not placed.

INITIALIZE_ARG_REQD The initialize reference id is required.

INITIALIZE_ARG_REQD The initialize reference type is required.

INITIALIZE_ARG_REQD The initialize type is required.

INITIALIZE_AUXREF_REQD The initialize auxReference type is required.

INSTALL_SCRIPT_ERROR Installation Script Error

INSUFCNT_NUM_PRDS_FOR_ Not enough accounting periods in range specified for revenue recognition.
REV_REC

INSUFCNT_OPEN_PRDS_FOR_ Not enough open accounting periods available for revenue recognition.
REV_REC

INSUFFICIENT_CHARS_IN_ Global searches must contain at least three characters to prevent excessive matches.
SEARCH

INSUFFICIENT_FLD_ You are attempting to read an unauthorized field: {1}

PERMISSION

INSUFFICIENT_FLD_ You cannot access this search because it includes restricted fields. Please contact your
PERMISSION administrator.

INSUFFICIENT_FUND Decline. Insufficient funds.

INSUFFICIENT_PERMISSION For security reasons, only an administrator is allowed to edit an administrator record.

INSUFFICIENT_PERMISSION Global search is not permitted from this role.

INSUFFICIENT_PERMISSION Insufficient privileges

INSUFFICIENT_PERMISSION Your issue DB access has been inactivated. Please contact your issue DB administrator.

INSUFFICIENT_PERMISSION Your current login role does not have an associated Issue Role. Please change to a different
role or contact your Issue administrator.

INSUFFICIENT_PERMISSION Only the owner can make a contact private

INSUFFICIENT_PERMISSION Only the super user can update or delete bug entries

INSUFFICIENT_PERMISSION Permission error: you may not edit this role.

INSUFFICIENT_PERMISSION Permission Violation: partners do not have access to this report.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 338

Error Code Returned Long Description or Message

INSUFFICIENT_PERMISSION Permission Violation: partners may not delete saved reports.

INSUFFICIENT_PERMISSION Permission Violation: You cannot delete saved reports not created by yourself.

INSUFFICIENT_PERMISSION Test Drive does not allow access to this feature. If you would like more information
about this feature, please contact your account manager.

INSUFFICIENT_PERMISSION The restriction settings on your role deny you access to this item.

INSUFFICIENT_PERMISSION This folder does not exist or you do not have permission to access this folder.

INSUFFICIENT_PERMISSION This folder does not permit the direct addition of files

INSUFFICIENT_PERMISSION This order has been partially or fully processed and may not be edited by a user without
permission to approve sales orders.

INSUFFICIENT_PERMISSION User permission level could not be established

INSUFFICIENT_PERMISSION You do not have permissions to set a value for element {1} due to one of the following
reasons: 1) The field is read-only; 2) An associated feature is disabled; 3) The field is
available either when a record is created or updated, but not in both cases.

INSUFFICIENT_PERMISSION Your role does not have permission to provision accounts.

INSUFFICIENT_PERMISSION You are not allowed to approve your own transactions.

INSUFFICIENT_PERMISSION You are not authorized to change this event's organizer. Public events may only have
their organizer changed by administrators, the event's organizer, or delegates with edit
permission to the event's calendar. Private or busy events may only have their organizer
changed by the owner.

INSUFFICIENT_PERMISSION You cannot update a system defined template.

INSUFFICIENT_PERMISSION You cannot update cases using this form.

INSUFFICIENT_PERMISSION You can not access this page unless you are logged in as the consolidated parent company.

INSUFFICIENT_PERMISSION You can only delete notes that you created.

INSUFFICIENT_PERMISSION You do not have access to the activity history for that record

INSUFFICIENT_PERMISSION You do not have access to the media item you selected.

INSUFFICIENT_PERMISSION You do not have access to this page

INSUFFICIENT_PERMISSION You do not have access to this template

INSUFFICIENT_PERMISSION You do not have permission to access this list.

INSUFFICIENT_PERMISSION You do not have permission to access this register.

INSUFFICIENT_PERMISSION You do not have permission to access this type of transaction.

INSUFFICIENT_PERMISSION You do not have permission to create this type of record. Please choose a different record
type.

INSUFFICIENT_PERMISSION You do not have permission to email transactions.

INSUFFICIENT_PERMISSION You do not have permission to perform this operation.

INSUFFICIENT_PERMISSION You do not have permission to print {1}

INSUFFICIENT_PERMISSION You do not have permission to view this page.

INSUFFICIENT_PERMISSION You do not have privileges to approve commissions.

INSUFFICIENT_PERMISSION You do not have privileges to create commissions.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 339

Error Code Returned Long Description or Message

INSUFFICIENT_PERMISSION You do not have privileges to create this transaction.

INSUFFICIENT_PERMISSION You do not have privileges to perform that operation.

INSUFFICIENT_PERMISSION You do not have privileges to perform this action.

INSUFFICIENT_PERMISSION You do not have privileges to perform this operation

INSUFFICIENT_PERMISSION You do not have privileges to use this page.

INSUFFICIENT_PERMISSION You do not have privileges to view this account

INSUFFICIENT_PERMISSION You do not have privileges to view this page

INSUFFICIENT_PERMISSION You may not create a new Liability Adjustment or edit existing Liability Adjustments.

INSUFFICIENT_PERMISSION You may not delete built-in audiences.

INSUFFICIENT_PERMISSION You may not delete built-in categories.

INSUFFICIENT_PERMISSION You may not delete built-in items.

INSUFFICIENT_PERMISSION You may not delete built-in tabs.

INSUFFICIENT_PERMISSION You must have either 'Transactions -> Invoice' or 'Transactions -> Cash Sale' permission to
bill sales orders.

INSUFFICIENT_PERMISSION You must have either 'Transactions -> Invoice' or 'Transactions -> Cash Sale' permission to
fulfill sales orders.

INSUFFICIENT_PERMISSION You must have 'Transactions -> {1}'permission to build work orders.

INSUFFICIENT_PERMISSION You must have 'Transactions -> Fulfill Sales Orders' view permission to view sales order
fulfillments.

INSUFFICIENT_PERMISSION You must have 'Transactions -> Fulfill Sales Orders' edit permission to fulfill sales orders.

INSUFFICIENT_PERMISSION You need employee access to delete this record.

INSUFFICIENT_PERMISSION {1} The {2} restrictions on your role deny you access to this record.

INSUFFICIENT_PERMISSION {1} The {2} restrictions on your role prevent you from seeing this record.

INSUFFICIENT_PERMISSION {1} The customer restrictions on your partner role prevent you from seeing this record.

INSUFFICIENT_PERMISSION {1} The restrictions on your role deny you access to this record.

INSUFFICIENT_PERMISSION {1} The restrictions on your role do not allow you to modify this record.

INSUFFICIENT_PERMISSION {1} You need {2} the '{3}' permission to access this page. Please contact your account
administrator.

INSUFFICIENT_PERMISSION {1} You need a higher level of the '{2}' permission to access this page. Please contact your
account administrator.

INSUFFICIENT_PERMISSION {1} You need a higher permission for custom record type {2} to access this page. Please
contact your account administrator.

INTEGER_REQD_FOR_QTY Quantity must be an integer for numbered items.

INTL_FEDEX_ONE_PACKG_ International FedEx fulfillments allow only one package. If more than one package is
ALLWD required, please break up the shipment into multiple fulfillments of one package each.

INTL_SHIP_EXCEED_MAX_ITEM The maximum number of items for FedEx International shipping has been exceeded: {1}

INVALID_ABN Invalid ABN registration number {1}.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 340

Error Code Returned Long Description or Message

INVALID_ACCT Invalid login. No such account.

INVALID_ACCT Invalid account number.

INVALID_ACCT_NUM_CSTM_ The account number custom field does not exist!! Consult billing cell.
FIELD

INVALID_ACCT_PRD You can not create an accounting period that is not a year or does not belong to a year.

INVALID_ACCT_TYP Invalid account type [ {1} ].

INVALID_ACCT_TYP There is no account of type: {1}

INVALID_ACCT_TYP The account and its parent have different account type.

INVALID_ACCT_TYP You cannot change an account to or from A/R or A/P

INVALID_ACTION You have attempted an unsupported action.

INVALID_ADDRESS_OR_ An error has occurred. Please ensure that the address information and shipper number are
SHIPPER_NO correct, then resubmit the form.

INVALID_ADJUSTMENT_ACCT The account you selected in Adjustment Account is the same as the asset account for one
of the items you are adjusting. Please go back and change the account. Normally, the
adjustment account would be an expense account.

INVALID_AES_FTSR_EXEMPTN_ The AES/FTSR Exemption Number is invalid.

NUM

INVALID_ALLOCTN_METHOD You have attempted to allocate landed costs to a transaction using an allocation method
that results in no allocation for any lines in the transaction. The allocation method you
chose is {1}. To correct this problem, go back to the transaction and choose a different
allocation method, or modify the items/lines on the transaction so that there will be some
cost allocated to the lines.

INVALID_AMORTZN_ACCT The destination account for the amortization schedule could not be determined.

INVALID_AMT Amount applied greater than total payments and credits

INVALID_AMT Foreign currency transactions that use Revenue Commitments cannot have a non-discount
line with a negative amount. Please use a non-posting discount item instead.

INVALID_AMT Amount Error (credit) Insufficient Funds (debit). Transaction amount is 0 or too long. Re-
submit transaction with a valid amount.

INVALID_AMT No Action Taken (credit) PIN entry necessary (debit). Reversal amount larger then original
amount. No action to take, transaction may not qualify for best level of Interchange.

INVALID_AMT Base and consumer amounts are inconsistent with the FX rate. Correct provided amounts.

INVALID_APP_ID Invalid application id: {1}

INVALID_ASSIGN_STATUS_ Invalid assignee/status combination({1}/{2})

COMBO

INVALID_ASSIGN_STATUS_ Invalid assignee/status combination (assignee {1}, status {2}, issue #{3}). No default owner
COMBO for issue role?

INVALID_ASSIGN_STATUS_ Invalid assignee/status combination ({1},{2})

COMBO

INVALID_AUTH Invalid double authorization. The order is currently authorized for {1}, valid until {2}.

INVALID_AUTH_CODE You have entered an invalid authorization code for this campaign email address. Please
check the authorization code in the email message, and enter it again.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 341

Error Code Returned Long Description or Message

INVALID_AUTOAPPLY_VALUE Ambiguous data: <autoApply> has been selected and lines have been selected in the
<applyList> element.

INVALID_AVS_ADDR AVS Address Length Error. Please correct the AVS Address and re-submit.

INVALID_AVS_ADDR Invalid AVS address or zip data. Please correct the AVS data and re-submit.

INVALID_AVS_ZIP AVS Zip Length Error. Please correct the AVS Zip and re-submit.

INVALID_BALANCE_RANGE Your balance is not within the allowed range.

INVALID_BILLING_SCHDUL The billing schedule definition is incompatible with this transaction. Please modify the
current billing schedule or select a different one.

INVALID_BILLING_SCHDUL_ Billing schedules may not extend beyond 500 years from today
DATE

INVALID_BILLING_SCHDUL_ You cannot create a billing schedule with two entries on the same date. Please go back and
ENTRY edit the billing schedule or start date.

INVALID_BIN_NUM Bin numbers may not contain the '{1}' character

INVALID_BOM_QTY Inventory/Assembly quantities cannot be negative

INVALID_BOOLEAN_VALUE Checkbox / boolean data must be either 'T' or 'F'

INVALID_BUG_NUM Bug number specified was incorrect. ("{1}" isn't a number.)

INVALID_CAMPAIGN_ You cannot use this channel to setup this event

CHANNEL

INVALID_CAMPAIGN_GROUP_ While in {1}, you can only send {2} emails per campaign event. Please modify one or more
SIZE of your target groups to contain {2} members or less. All campaign emails will be sent to
your {1} login email address.

INVALID_CAMPAIGN_STATUS You cannot set the status of this campaign event back to 'In Progress' because it already
has some activity.

INVALID_CARD Missing Card Holder Account Data. Please provide valid card data and re-submit.

INVALID_CARD Card not in authorizers database.

INVALID_CARD The referencing transaction (i.e. reversal request) was not carried out with the same card as
the original transaction. Re-submit with original card.

INVALID_CARD_ID Invalid Card ID. Provide a valid card ID.

INVALID_CARD_NUM Invalid Card Number. Please provide a valid card number and re-submit.

INVALID_CARD_NUM Card No. Error. Card number has unknown Bank Identification Number (BIN) or fails check
digit edit. Re-try card number again, verify with merchant it is a valid card with proper logos
for card types the merchants accept.

INVALID_CARD_TYP Card Type Not Accepted. Contact MerchantE to add the card type.

INVALID_CARD_TYP Merchant doesn't accept the transaction's card type.

INVALID_CASE_FORM You cannot create cases using this form.

INVALID_CATGRY_TAX_ A Vendor must be created in a cateogry with the Tax Agency checkbox checked.
AGENCY_REQ

INVALID_CC_EMAIL_ADDRESS The email address to CC store orders to is invalid. Please go back and correct it.

INVALID_CC_NUM Credit card numbers must contain between 13 and 20 digits.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 342

Error Code Returned Long Description or Message

INVALID_CC_NUM Credit card number is not valid. Please check that all digits were entered correctly.

INVALID_CC_NUM Credit card number must contain only digits.

INVALID_CERT Intercompany Transfer Orders cannot be entered when the Setup > Accounting >
Accounting Preferences > Order Management > Use Item Cost as Transfer Cost preference
is enabled.

INVALID_CERT Invalid CA certificate

INVALID_CERT Invalid certificate key

INVALID_CERT Invalid certificate

INVALID_CERT Failed to verify client certificate, send email to {1} for help.

INVALID_CERT_AUTH The indicated CA is not the issuer of this certificate

INVALID_CHARGE_AMT Charge amount too large. This order can't be charged for more than {1}

INVALID_CHARS_IN_EMAIL Email address contains invalid characters.

INVALID_CHARS_IN_NAME The From Name field cannot contain apostrophes, quotation marks, commas, or greater
than or less than signs.

INVALID_CHARS_IN_NAME You cannot use the colon ':' character in the topic name - please remove it .

INVALID_CHARS_IN_PARAM_ The Additional Parameters field can not contain any of the following characters: "?\<>|/!@#
FIELD $%^*()+,.:;'"". Please remove them and try again

INVALID_CHARS_IN_URL Spaces are not allowed in the {1}url.Examples of a valid {1}url are: http://
www.example.com/image.gif or https://one.two.org/user-name/test.jpg

INVALID_CHARS_IN_URL The URL component you have chosen contains a space or one of the following prohibited
character: &?\<>|/!@#$%^&*()+=,.:;'". Please remove them and try again

INVALID_CHECKOUT_EMAIL The email address to email checkout errors to is invalid. Please go back and correct it.

INVALID_CITY Merchant City Length Error. Reduce the city name length.

INVALID_COLUMN_NAME Invalid column name in get_invtitem_col_sum_all_locs: {1} [ {2} ]

INVALID_COLUMN_VALUE An attempt was made to set a column to an invalid value. Dynamic SQL being executed
[ {1} ]

INVALID_CONTENT_TYPE Invalid content type. You can only use application/json, application/xml or text/plain with
RESTlets.

INVALID_COSTING_METHOD SERIAL and LOT are the only costing methods that may be passed as parameters to this
page.

INVALID_CRNCY_EXCH_RATE Invalid currency conversion rate.

INVALID_CRYPT_KEY {1} is not a valid cryptographic key written as a hexadecimal number.

INVALID_CSTM_FIELD_DATA_ The customfield [{1}] reference object does not match its data type.
TYP

INVALID_CSTM_FIELD_RCRD_ Invalid custom field record type

TYP

INVALID_CSTM_FIELD_REF The specified custom field reference {1} is invalid.

INVALID_CSTM_FORM {1} is an invalid custom form

INVALID_CSTM_RCRD_KEY Invalid custom record key [{1}].

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 343

Error Code Returned Long Description or Message

INVALID_CSTM_RCRD_QUERY Invalid custom record object in query.

INVALID_CSTM_RCRD_TYPE_ Invalid custom record type

KEY

INVALID_CSTM_RCRD_TYPE_ Invalid custom record type key.

KEY

INVALID_CSTM_RCRD_TYPE_ {1} refers to a custom list. To get the contents of this list, use the 'get' or 'getAll' operation
KEY with a RecordRef of type 'customList'

INVALID_CSTM_RCRD_TYP_KEY Invalid custom record type key in query.

INVALID_CUR You have entered an invalid currency symbol or internal ID: {1}.

INVALID_CURR_CODE Failed to find a currency code for the currency symbol {1}. Verify your currency symbol is
ISO-compliant and re-submit.

INVALID_CURRENCY_CODE Failed to find currency code for the requested country code. Check country code and retry
request.

INVALID_CURRENCY_CODE Request currency code must match FX rate currency code. Retry request with a currency
code that matches the FX currency code.

INVALID_CURRENCY_TYP Currency Type Not Accepted. Contact MerchantE to add the currency type.

INVALID_CUSTOMER_RCRD This customer record {1} is not valid. Please create the customer first.

INVALID_DATA Invalid data combination, can not set {1} to {2} and {3} to {4}

INVALID_DATA_FORMAT Invalid data format. You should return a JavaScript object.

INVALID_DATA_FORMAT Invalid data format. You should return TEXT.

INVALID_DATE Date Error. Invalid date.

INVALID_DATE The date < {1} > is invalid. You must specify a date after < {2} >.

INVALID_DATE_FORMAT Date field not in your preferred date format

INVALID_DATE_RANGE The date range you specified does not enclose all its child periods.

INVALID_DATE_RANGE Invalid time range. The {1} "{2}" start time ({3}) must be earlier than its end time ({4}).

INVALID_DATE_RANGE Invalid Date Range - the To Date value must be on or after the From Date value

INVALID_DATE_RANGE The date range you specified does not fall inside that of the parent period.

INVALID_DEAL_RANGE Invalid Deal Range - low must be less than projected and high must be greater than
projected.

INVALID_DELETE_REF Either RecordRef or CustomRecordRef should be used for 'delete' operation.

INVALID_DESTINATION_FLDR The destination folder is the same as the current folder.

INVALID_DESTNTN_COUNTRY The destination Country is invalid or has not been set.

INVALID_DESTNTN_POST_ The destination Postal Code is invalid or has not been set.
CODE

INVALID_DESTNTN_STATE The destination State is invalid or has not been set.

INVALID_DETACH_RECORD_ Missing or Invalid RecordType for DetachFrom.

TYP

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 344

Error Code Returned Long Description or Message

INVALID_DETACH_RECORD_ Detaching of record type {1} from {2} is not supported.

TYP

INVLAID_DISCOUNT_MARKUP Posting and non-posting discounts/markups are not allowed on the same transaction

INVALID_DOMAIN_KEY The private domain key is invalid, please enter a valid private domain key.

INVALID_DOMAIN_NAME Invalid domain name {1}, please enter a valid domain name.

INVALID_DUP_ISSUE_REF Cannot set this issue to be a duplicate of itself or of an issue that is a duplicate of this issue.

INVALID_EMAIL Email address is not valid.

INVALID_EMAIL Your email or code is invalid. Please try again

INVALID_EMAIL You have entered an invalid email address. Please try again.

INVALID_EMAIL_ADDR Some of the email addresses you have entered are invalid: {1:list of invalid email addresses}

INVALID_EMAIL_ADDR The email address for the web store is invalid. Please go back and correct it.

INVALID_END_DATE You entered an end date ({1}) that is before the start date ({2})

INVALID_END_DATE {1} [{2}] recurrence end date is invalid

INVALID_END_TIME invalid 'end' time

INVALID_ENTITY_INTERNALID Attempt to insert entity with nkey -1 or 0

INVALID_ENTITY_STATUS You entered an invalid entity status.

INVALID_EVENT_TIME You cannot make the time that close to the start or end of the day, because it shifts the
event across a day boundary.

INVALID_EXP_DATE Invalid expiration date. Please correct the expiration date and re-submit.

INVALID_EXPNS_ACCT_SUB The expense account associated with expense category '{1:expense category}' is not
available in the subsidiary of customer '{2:customer}'.

INVALID_EXPRESSION ERROR: Invalid Expression

INVALID_FAX_NUM The Fax Number is invalid.

INVALID_FAX_PHONE_FORMAT Invalid FaxPhoneNumber. The format of FaxPhoneNumber must contain area code plus
seven digit number.

INVALID_FIELD_FOR_RCRD_ Record type {1} does not support field {2}

TYP

INVALID_FIELD_NAME_FOR_ The specified name [{1}] must exactly match an existing field name.
NULL

INVALID_FILE Verify that you have a valid file to upload.

INVALID_FILE_ENCODING The file encoding: {1} is not valid. Please refer to the documentation for a list of supported
file encodings.

INVALID_FILE_TYP Invalid file type. File is not a compressed/zip file.

INVALID_FILE_TYP Invalid file type. File is not a compressed zip file.

INVALID_FILE_TYP The media file type you uploaded was not recognized. Please try again.

INVALID_FLD ERROR: Field Not Found

INVALID_FLD_RANGE Value outside of valid min/max range for this field

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 345

Error Code Returned Long Description or Message

INVALID_FLD_TYPE Application error: NLField of type {1} is not supported.

INVALID_FLD_VALUE You have entered an Invalid Field Value {1} for the following field: {2}

INVALID_FLDR_SIZE Error in update_folder_size

INVALID_FORMAT_IN_PARAM_ The Additional Parameters field is not formatted correctly. Please reformat and try again
FIELD

INVALID_FORMULA Your formula contains a reference to an encrypted field. This is not allowed.

INVALID_FORMULA Your formula could result in a divide by zero error. Please go back, correct the formula and
resumbit.

INVALID_FORMULA_FIELD Your formula has an unrecognized field in it. Please go back and correct the formula and
resubmit.

INVALID_FROM_DATE invalid 'from' date

INVALID_FROM_TIME invalid 'from' time

INVALID_FULFILMNT_ITEM You have an invalid item {1} in the fulfillment request.

INVALID_FX_BASE_CURRENCY FX amount in base currency is required. Provide the base amount.

INVALID_FX_RATE Exchange Rate must be 1 for vendors in your currency.

INVALID_GET_REF Either RecordRef or CustomRecordRef should be used for 'get' operation.

INVALID_GIFT_CERT Invalid gift certificate

INVALID_GIFT_CERT_AMT The remaining amount on a gift certificate can not be negative

INVALID_GIFT_CERT_CODE Gift certificate code must contain only letters and digits.

INVALID_GROUP_TYP This type of group cannot be defined based on another group of the same type.

INVALID_GROUP_TYP You cannot define this group type using this search.

INVALID_GROUP_TYPE The group type {1} is invalid.

INVALID_GRP This type of group cannot be defined based on another group.

INVALID_GST_PST_AGENCIES The GST or PST agencies are not valid. Please review your company preferences

INVALID_ID No order found with id {1}

INVALID_ID Identifiers can contain only digits, alphabetic characters, or "_" with no spaces

INVALID_ID You have provided an invalid script id or internal id: {1}

INVALID_ID The externalId attribute is not supported for {1}

INVALID_INITIALIZE_ARG The reference type {1} and initialize type {2} are not matched.

INVALID_INITIALIZE_ARG InitializeRef should be used for 'initialize' operation.

INVALID_INITIALIZE_AUXREF Invalid initialize operation argument 'auxReference'.

INVALID_INITIALIZE_REF You can not initialize {1}: invalid reference {2}.

INVALID_INITIALIZE_REF Can not initialize customerPayment: invalid customer reference {1}.

INVALID_INITIALIZE_REF Can not initialize customerPayment: invalid invoice reference {1}.

INVALID_INITIALIZE_REF You have an invalid sales order {1} or the order is already billed

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 346

Error Code Returned Long Description or Message

INVALID_INITIALIZE_REF You have an invalid sales order {1} or the order is already closed.

INVALID_INSURED_VALUE The Insured Value cannot exceed the total sum of the items being shipped.

INVALID_INTERNAL_ID The specified internal id is not allowed.

INVALID_INTERNALID Unparseable Internal Id, did you mean to lookup this field by Name or External ID?

INVALID_INV_DATE Invoice date on billing schedule may not be after {1}

INVALID_INVENTORY_NUM Invalid set of inventory numbers: values must be separated by commas, spaces, tabs, or
line feeds.

INVALID_INV_DATE Invoice date on billing schedule may not be after {1}

INVALID_IP_ADDRESS_RULE The following IP Address rule is not valid: {1}

INVALID_ISSUE_BUILD_ Cannot set issue {1} to {2} {3} and {4} {5} because that version is not associated with that
VERSION build.

INVALID_ISSUE_PRIORITY Severity 1 issues must have priority 1.

INVALID_ISSUE_PRODUCT Cannot set issue {1} to {2} {3} and {4} {5} because that product is not associated with that
build.

INVALID_ISSUE_PRODUCT Cannot set issue {1} to {2} {3} and {4} {5} because that product is not associated with that
module.

INVALID_ISSUE_STATUS Cannot set issue {1} to status {2} and assignee {3} because that status requires an assignee
with issue role {4}.

INVALID_ITEM_OPTION Invalid item option {1} for item {2}

INVALID_ITEM_OPTIONS The options for item '{1}' are no longer available. Please change your order and try again.

INVALID_ITEM_SUBTYP Invalid item subtype [{1}] for item [{2}].

INVALID_ITEM_TYP The item [{1}] does not have a valid item type.

INVALID_ITEM_WEIGHT The total item weight must be > 0.0

INVALID_JOB_ID You have specified an invalid Job Id

INVALID_KEY_OR_REF The specified key is invalid.

INVALID_KEY_OR_REF Invalid {1} reference key {2}.

INVALID_KEY_OR_REF Invalid {1} reference key {2} for {3} {4}.

INVALID_KEY_PASSWORD_ This key is invalid or may require a password

REQD

INVALID_LINE_ID No line items match the entered id(s) {1}.

INVALID_LINK_SUM Links sum to more than applied transaction amount

INVALID_LINK_SUM Links sum to more than original transaction amount

INVALID_LIST_ID You must specify a valid line ID. Please set {1}.

INVALID_LIST_KEY Could not perform operation ''{1}'' on an invalid line [{2}].

INVALID_LIST_KEY Could not perform operation 'add' on an existing line [{1}].

INVALID_LOC Item Fulfillment/Item Receipt location does not match the location on the Transfer Order

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 347

Error Code Returned Long Description or Message

INVALID_LOC_SUB_RESTRICTN You may not add inventory to a location that is incompatible with the subsidiary restrictions
for this item.

INVALID_LOGIN Invalid login. Online Form access is disabled.

INVALID_LOGIN Invalid login. Supplier access is disabled.

INVALID_LOGIN_ATTEMPT Invalid login attempt.

INVALID_LOGIN_CREDENTIALS A problem occured verifying the presented email address, password, roleName or account
number, please verify these pieces of information and try again

INVALID_LOGIN_CREDENTIALS You have entered an invalid email address or account number. Please try again.

INVALID_LOGIN_CREDENTIALS You have entered an invalid email address or password. Please try again.

INVALID_LOGIN_CREDENTIALS You have entered an invalid login password. Please try again.

INVALID_LOGIN_CREDENTIALS You have entered an invalid password. Please try again.

INVALID_LOGIN_IP Invalid login. IP Address does not match any of the IP Address rules specified for this entity.

INVALID_LOT_NUM_FORMAT Lot numbers must be entered using this format: LOT#(Quantity).nFor example, to enter a
quantity of 100 items as Lot number ABC1234, enter "ABC1234(100)" in the Lot Numbers
field.

INVALID_ MACRO_ID The Macro ID: {1} is not valid! Please refer to the documentation for a list of supported
macro IDs.

INVALID_MARKUP_DISCOUNT Markup/Discount % must be between -999% and 999%

INVALID_MCC Merchant Category Code Length Error. Provide a valid MCC.

INVALID_MEMBER_HIERARCHY You have defined a group/kit/assembly item that contains a loop in the member hierarchy.
You must remove any group/kit/assembly member items that contain this item as a
member.

INVALID_MEMRZD_TRANS A memorized transaction may not contain any serial or lot numbers. Go back, remove the
numbers, and try to re-Memorize the transaction. Posting transactions such as Bills or Cash
Sales may not use serial or lot numbered items. Non-Posting transactions such as Purchase
Orders or Sales Orders may use serial or lot numbered items but may not contain serial or
lot numbers.

INVALID_MERCHANT_KEY Merchant key is not supplied or incorrect.

INVALID_MERCHANT_NAME Merchant Name Length Error. Reduce the merchant name length.

INVALID_NAME Invalid savepoint name. Must start with an alphabet character and can only contain
alphanumeric, underscore, dollar, and hash characters.

INVALID_NEXUS Transaction Nexus is incorrect: it is {1} but should be {2}

INVALID_NUM Invalid Decimal Number

INVALID_NUMBER Invalid Decimal Number

INVALID_NUMBER Invalid Integer

INVALID_NUMBER Invalid integer {1}

INVALID_NUMBER Invalid number {1}

INVALID_NUMBER You entered "{1}" into a field where a numeric value was expected. Please go back and
change this value to a number.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 348

Error Code Returned Long Description or Message

INVALID_NUMBER You entered an invalid number: Go <a href="javascript:history.go(-1);";>back</a>,

change this value and resubmit.

INVALID_OBJ There are no objects of this type

INVALID_ONLINE_FORM Online Form not found

INVALID_ONLINE_FORM This online form is inactive or not available online.

INVALID_ONLINE_FORM_URL You cannot submit Online forms from this URL. Use the live version: {1} instead

INVALID_OPENID_DOMAIN This is not a valid domain. Please go back and enter your domain name without prefixes
such as 'http://' or 'www'.

INVALID_OPERATION That operation is not supported for this record type: {1}

INVALID_ORD_STATUS This order has been partially or fully processed and may not be reset to 'Pending Approval'.

INVALID_ORIGIN_COUNTRY The origin Country is invalid or has not been set.

INVALID_ORIGIN_POSTCODE The origin Postal Code is invalid or has not been set.

INVALID_ORIGIN_STATE The origin State is invalid or has not been set.

INVALID_PAGE_INDEX Job {1} does not have a page {2}

INVALID_PAGE_PARAM Invalid page parameter. Unable to view page.

INVALID_PAGER_NUM The Pager Number is invalid.

INVALID_PARAM Please select either {1} or {2} parameter but not both.

INVALID_PARENT An account cannot be its own parent

INVALID_PARTNER_CODE An account for this customer cannot be provisioned unless its partnercode ({1}) is empty or
numeric.

INVALID_PARTNER_ID Invalid partner id: {1}

INVALID_PASSWORD Invalid key password

INVALID_PAYCHECK_DATE Paychecks for {1} must be on or after {2}

INVALID_PERIOD A period may be only an adjustment period, a quarter, or a year.

INVALID_PHONE The phone number of the {1} address is invalid. Please verify the phone number is correctly
formatted and includes the area code.

INVALID_PHONE_FAX_PAGER_ The Phone, Fax, or Pager Number is invalid.

NUM

INVALID_PHONE_NUM The Phone Number is invalid.

INVALID_PICKUP_POSTAL_ An error has occurred. Pickup Postal Code {1} is not the postal code associated with
CODE Shipper Number {2}.

INVALID_PIN Incorrect PIN. PIN number may have been entered incorrectly. Re-submit with proper PIN.

INVALID_PIN_DEBIT_TRANS_ Invalid pin debit transaction type. Only a sale (D) is supported.
TYP

INVALID_PORTLET_TYP unsupported portlet type [{1}], id [{2}] processed by cardMetaDataGenerator

INVALID_POST Invalid Post

INVALID_PRESENTATION_TYP Presentation Type not recognized

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 349

Error Code Returned Long Description or Message

INVALID_PROBABILITY_RANGE Probability must be between 0 and 100.

INVALID_PROFILE_ID Invalid Profile ID or Profile Key. Correct the profile ID and profile key, and re-submit.

INVALID_PROJ_BILLING_TYP The project billing type is incompatible with the billing schedule on the transaction. Please
select a different billing schedule.

INVALID_PST_TAX_VALUE PST tax value is not a valid number: {1}

INVALID_PSWD Email address "{1}" has been previously registered under a different password from the
new password you just provided. For security reasons, you will first need to go back and
supply the correct new password for "{1}" to merge the accounts.

INVALID_PSWD Invalid Password. The password must be between 6 and 10 character with at least one
numeric and one alphabetic character.

INVALID_PSWD Password must be at least 6 characters long.

INVALID_PSWD Password must be at least 6 characters long and contain at least one number or special
character.

INVALID_PSWD Password must contain at least one letter (A-Z).

INVALID_PSWD Password must contain at least one number or special character.

INVALID_PSWD The current password you supplied is incorrect.

INVALID_PSWD Your new password must be at least {1} characters, contain at least one non-letter, and be
substantially different from the current password.

INVALID_PSWD Your new password must be at least 6 characters, contain at least one non-letter, and be
substantially different from the current password.

INVALID_PSWD Your password cannot be the same as your login. Please choose a new password.

INVALID_PSWD Your password must be at least 6 characters

INVALID_PSWD You've used that password before. Please choose a new password.

INVALID_PSWD_HINT Your hint is too similar to your password. Please choose something less obvious.

INVALID_PSWD_ILLEGAL_CHAR Password contains an illegal character.

INVALID_PURCHASE_TAX_ Purchase tax code not defined properly for item

CODE

INVALID_QTY The new quantity and new value must be either both positive or both negative.

INVALID_QTY You may not receive a larger quantity than you shipped.

INVALID_QUANTITY Serial and lot number quantities must be integers

INVALID_QUANTITY Serial and lot number quantities must be positive.

INVALID_QUESTION Please select a different question.

INVALID_QUESTION Please select a question.

INVALID_RCRD Invalid record specification: {1}

INVALID_RCRD_CONVERSION Only customer records can be converted to child or parent records. Please select only
customer records for this duplicate merge operation.

INVALID_RCRD_HEADER_ Invalid record header: Unable to parse field name from {1}

INVALID_RCRD_HEADER_ Invalid record header: Unable to parse record id from {1}

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 350

Error Code Returned Long Description or Message

INVALID_RCRD_HEADER_ Invalid record header: Unable to parse record type from {1}

INVALID_RCRD_ID Invalid id {1} to create a record.

INVALID_RCRD_INITIALIZE You have entered an invalid default value for this record initialize operation.

INVALID_RCRD_OBJ You do not have a valid record object.

INVALID_RCRD_REF Invalid RecordRef internalId {1} for field {2}

INVALID_RCRD_REF Invalid record reference.

INVALID_RCRD_REF Invalid record reference

INVALID_RCRD_TRANSFRM You have entered an invalid default value for this record transformation operation.

INVALID_RCRD_TRANSFRM That type of record transformation is not allowed. Please see the documentation for a list of
supported transformation types

INVALID_RCRD_TRANSFRM That is not a valid record transformation.

INVALID_RCRD_TYPE Invalid Record Type

INVALID_RCRD_TYPE {1}: type argument {2} is not a valid record or is not available in your account. Please see
the documentation for a list of supported record types.

INVALID_RCRD_TYPE The record type [{1}] is invalid.

INVALID_RCRD_TYPE The record type is invalid.

INVALID_RECIPIENT Recipient internal id does not match an existing entity.

INVALID_RECR_REF Could not update {1} to {2} because referenced record does not exist

INVALID_RECUR_DATE_RANGE This event recurrence is invalid because its duration is either negative or longer than one
day. {1}

INVALID_RECUR_DATE_RANGE This event recurrence is invalid because its end-by date is before its start date. {1}

INVALID_RECUR_DATE_RANGE This event recurrence is invalid because its end time and duration do not match. {1}

INVALID_RECUR_DATE_RANGE This event recurrence is invalid because its end time is more than one day after its start
time. {1}

INVALID_RECUR_DATE_RANGE This event recurrence is invalid because its end time is not after its start time. {1}

INVALID_RECUR_DATE_RANGE This event recurrence is invalid because its start time or end time/duration is empty. {1}

INVALID_RECUR_DATE_RANGE This event recurrence is invalid because its times are not in order. {1}

INVALID_RECUR_DESC_REQD This event recurrence is invalid because it has no description. {1}

INVALID_RECUR_DOW This event recurrence has an invalid day-of-week field. {1}

INVALID_RECUR_DOWIM This event recurrence has an invalid day-of-week-in-month value. {1}

INVALID_RECUR_DOWMASK This event recurrence is invalid because its day-of-week mask is not 7 characters long. {1}

INVALID_RECUR_FREQUENCY This event recurrence has an invalid frequency. {1}

INVALID_RECUR_PATTERN This event does not have a valid recurrence pattern.

INVALID_RECUR_PATTERN This event recurrence is invalid because it is not a monthly or yearly event and it has day-of-
week and day-of-week-in-month field values. {1}

INVALID_RECUR_PATTERN This event recurrence is invalid because it only has one recurrence time and it must have
either none or at least two. {1}

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 351

Error Code Returned Long Description or Message

INVALID_RECUR_PATTERN This event recurrence is invalid because one of its times is out of the range 0 to 86399. {1}

INVALID_RECUR_PATTERN This event recurrence is invalid because only one of the day-of-week and day-of-week-in-
month fields is set. Both must be set or both must be unset. {1}

INVALID_RECUR_PATTERN This event recurrence is invalid either because it is not weekly and it has a day-of-week
mask, or it is weekly and it has no day-of-week mask. {1}

INVALID_RECUR_PATTERN This single day event is invalid since it contains a recurrence pattern.

INVALID_RECUR_PERIOD This event recurrence has an invalid period. {1}

INVALID_RECUR_TIME_ZONE_ This event recurrence in invalid because it has no time zone. {1}
REQD

INVALID_REF_CANT_INITIALIZE Cannot initialize customerRefund: invalid creditMemo reference {1}.

INVALID_REF_CANT_INITIALIZE Cannot initialize customerRefund: invalid customer reference {1}.

INVALID_REF_CANT_INITIALIZE You can not initialize {1} by referencing {2}.

INVALID_REF_KEY Invalid externalId {1}.

INVALID_REF_KEY Invalid reference key [{1}].

INVALID_REFFERER_EMAIL The refferer email address you have entered is not valid. Please try again.

INVALID_REFUND_AMT Refund amount must be between zero and the original amount. Correct amount and retry
request.

INVALID_REFUND_AMT The amount you can refund is {1} because the the order has already been refunded for {2}

INVALID_REPORT The referenced Report and Row are no longer valid, because the layout containing them
has changed. Please edit this reference row to reselect Report and Row.

INVALID_REPORT_ID Invalid report ID.

INVALID_REPORT_ROW Invalid Reference Row

INVALID_REPORT_ROW Invalid Report Row Reference

INVALID_REQUEST invalid request (failed isValid() check). Email request handler unable to service request for
address= <{1}> .

INVALID_RESOURCE_TIME Total resource time for '{1}' cannot exceed {2} planned time entries.

INVALID_RESULT_SUMMARY_ The result field {1} cannot be grouped. Please edit the search and omit this field or use a
FUNC different summary function.

INVALID_RETURN_DATA_ The return value of the RESTlet function cannot be used to create a well-formed XML
OBJECT document.

INVALID_RETURN_DATA_ The XML document does not contain a root element because the RESTlet function does not
OBJECT return a JavaScript Object.

INVALID_REV_REC_DATE_ Rev rec end date can not be before rev rec start date.
RANGE

INVALID_ROLE The specified role is invalid.

INVALID_ROLE Your role does not give you permission to view this page.

INVALID_ROLE_FOR_EVENT You seem to have been invited to this {1} in a different role. Please change your role to view
the {1}.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 352

Error Code Returned Long Description or Message

INVALID_RQST_CONTACTS_ it has associated primary contacts.

EXIST

INVALID_RQST_PARENT_REQD it has associated contact records that would be left with no parent company.

INVALID_RQST_SBCUST_JOBS_ it has associated sub-customers or jobs.

EXIST

INVALID_SAVED_SRCH Missing or invalid saved search for Custom KPI. The search must have a date column as an
available filter. Please see help next to Custom KPI dropdown list on KPI setup page.

INVALID_SAVEDSEARCH A saved search with the internal ID {1} does not exist.

INVALID_SAVEDSEARCH We cannot return search columns for summary saved search {1}.

INVALID_SCHDUL_AMT The total amount on the schedule must equal the sum of the individual recognition
amounts.

INVALID_SCHDUL_AMT The total amount on the schedule must be equal to the amount of the source transaction
line.

INVALID_SCHDUL_FORMAT To create a valid schedule, please enter the bracket values in ascending orders without
gaps.

INVALID_SCRIPT_ID A saved search with the script ID {1} does not exist.

INVALID_SEARCH That search or mass update does not exist.

INVALID_SEARCH You may search by {1} or {2} but not both

INVALID_SEARCH_CRITERIA Can't search transactions: invalid cross reference key

INVALID_SEARCH_CRITERIA Global Search supports at most three keywords and requires at least one. Keywords are
composed of only letters, digits, and dashes.

INVALID_SEARCH_FIELD_KEY search field keys are not consistent({1}/{2})

INVALID_SEARCH_FIELD_NAME search field names are not consistent({1}/{2})

INVALID_SEARCH_FIELD_OBJ {1} is not a valid search custom field

INVALID_SEARCH_FIELD_OBJ {1} must be used to search custom field {2}

INVALID_SEARCH_FIELD_OBJ Server application error: invalid search customfield object.

INVALID_SEARCH_FIELD_OBJ Invalid search field object: {1}

INVALID_SEARCH_JOIN_ID Invalid Search Join ID

INVALID_SEARCH_MORE Invalid searchMore operation. Please make sure that you have had a successful search
operation before you can perform any searchMore operation.

INVALID_SEARCH_OPERATOR You need to provide a valid search field operator.

INVALID_SEARCH_OPERATOR You can not use this operator '{1}' for internalId search.

INVALID_SEARCH_PAGE_INDEX Invalid search page index.

INVALID_SEARCH_PAGE_SIZE Invalid search page size.

INVALID_SEARCH_PREF You cannot set returnSearchColumns to false while you specify search columns.

INVALID_SEARCH_PREF You cannot set returnSearchColumns to true without specifying search columns or
referencing a saved search.

INVALID_SEARCH_SELECT_OBJ Invalid search select field object: {1}

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 353

Error Code Returned Long Description or Message

INVALID_SEARCH_VALUE You need to provide a search value.

INVALID_SEARCH_VALUE You need to provide search values.

INVALID_SECONDARY_EMAIL Invalid secondary email address. The email address must be in a valid format.

INVALID_SECPAY_ The username or password used to process the transaction with SECPay was not valid.
CREDENTIALS Please make sure you have entered the correct username, password, and remote password
in your SECPay account setup.

INVALID_SERIAL_NUM No items match the entered serial number

INVALID_SERIAL_OR_LOT_ Serial and lot numbers may not contain the '{1}' character.
NUMBER

INVALID_SESSION A valid NLSession is required to generate record xml

INVALID_SESSION A valid session is required. Please log in first.

INVALID_SHIP_DATE The Future Ship Date is invalid. Please verify the entered Future Ship Date is no more than 7
days in the future, and resubmit the fulfillment.

INVALID_SHIP_FROM_STATE The Ship From State/Province Code is missing or invalid. Please enter the 2 to 5 character
abbreviation for the state or province of the address that contains it.

INVALID_SHIP_GRP You cannot add shipping groups when creating a transaction that has multiple shipping
routes enabled. You must first add the items, then get the transaction and update the
shipping groups separately.

INVALID_SHIP_SRVC The selected service is not valid for international shipments. Please choose an international
service and retry your request.

INVALID_SHIP_TO_SATE The Ship To State/Province Code is missing or invalid. Please enter the 2 to 5 character
abbreviation for the state or province of the address that contains it.

INVALID_SHIPPER_STATE The Shipper State/Province Code is missing or invalid. Please enter the 2 to 5 character
abbreviation for the state or province of the address that contains it.

INVALID_SITE_CSTM_FILE File is not a NetSuite site customization export file: it cannot be imported.

INVALID_SOAP_HEADER Invalid SOAP Header: '{1}'. Value is '{2}'.

INVALID_SRCH That search or mass update does not exist (internal id={1})

INVALID_SRCH_CRITERIA The field rule value "{1}" is invalid for field type {2} with criterion "{3}."

INVALID_SRCH_CSTM_FLD This search refers to custom field with id = {1} which either is restricted or is not applied to
this record type.

INVALID_SRCH_FUNCTN An nlobjSearchColumn contains an invalid function: {1}.

INVALID_SRCH_SORT An nlobjSearchColumn that is not sortable contains a sort specification: {1}.

INVALID_SRCH_SUMMARY_TYP An nlobjSearchFilter contains an invalid summary type: {1}.

INVALID_SRCH_TYP Search Type not allowed as standalone search

INVALID_SRVC_ITEM_SUB The service item '{1:service item}' is not available in the subsidiary of customer
'{2:customer}'.

INVALID_SSO Invalid SuiteSignOn reference: {1}. That SuiteSignOn object does not exist or has been
marked as inactive.

INVALID_SSS_DEBUG_SESSION You have exceeded the maximum allowable idle time for debugging scripts. To debug
another script, simply reload the script debugger page and start a new debugging session.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 354

Error Code Returned Long Description or Message

INVALID_SSS_DEBUG_SESSION You have canceled your current script debugging session.

INVALID_STATE Merchant State Length Error. Provide a valid state.

INVALID_STATE Signup prospect state '{1}' is invalid.

INVALID_STATUS You may not change this issue''s status from ''{1}'' to ''{2}''.

INVALID_SUB The subsidiary restrictions on this record are incompatible with those defined for account:
{1}. Subsidiary access on this record must be a subset of those permitted by the account.

INVALID_SUB The subsidiary restrictions on this record are incompatible with those defined for account:
{1}. Subsidiary access on this record must be a superset of those permitted by the account.

INVALID_SUB The subsidiary restrictions on this record are incompatible with those defined for
department: {1}. Subsidiary access on this record must be a subset of those permitted by
the department.

INVALID_SUB The subsidiary restrictions on this record are incompatible with those defined for item: {1}.
Subsidiary access on this record must be a superset of those permitted by the item.

INVALID_SUB The subsidiary restrictions on this record are incompatible with those defined for location:
{1}. Subsidiary access on this record must be a subset of those permitted by the location.

INVALID_SUB The Subsidiary selected doesnt match the bank account selected.

INVALID_SUB This record does not support multiple subsidary restrictions. You must choose a single
subsidiary.

INVALID_SUB Transaction references multiple subsidiaries

INVALID_SUB You may not add members to a group/kit/assembly unless the subsidiaries for those
members completely contain the subsidiaries of the group/kit/assembly.

INVALID_SUB {1} can not be used with the selected subsidiary

INVALID_SUBLIST_DESC Invalid sublist description - all sublists must appear exactly as they do in the WSDL (eg end
with 'List')

INVALID_SUBSCRIPTION_ You cannot change the global subscription status from its current value of {1:status name}.
STATUS

INVALID_SUBSCRIPTION_ You cannot set the global subscription status to the value {1:status name}.
STATUS

INVALID_SUMMARY_SRCH In a summary search, you must sort by a result field with a summary function. Please go
back and correct the sort by field on the results tab.

INVALID_SUPERVISOR Employees can not be their own supervisor.

INVALID_SUPERVISOR You can't insert this employee record as it would create a loop in the supervisor hierarchy.

INVALID_TASK_ID The task ID: {1} is not valid. Please refer to the documentation for a list of supported task
IDs.

INVALID_TASK_ID You have specified an invalid task Id

INVALID_TAX_AMT Invalid tax amount. Correct tax amount and retry request.

INVALID_TAX_CODE Invalid Canadian Tax Code: {1}

INVALID_TAX_CODE_FOR_SUB The selected tax code is not available in subsidiary.

INVALID_TAX_CODES Invalid Tax Code(s): {1}

INVALID_TAX_PMT You may not commit tax payment information prior to the start date of the Payroll Service.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 355

Error Code Returned Long Description or Message

INVALID_TAX_VALUE GST and PST amount cannot be negative!

INVALID_TAX_VALUE GST tax value is not a valid number: {1}

INVALID_TIME_FORMAT {1} is not a valid time and it should use the following format h:mm a.

INVALID_TO_DATE invalid 'to' date

INVALID_TRACKING_NUM The tracking number is not valid.

INVALID_TRACKING_NUM You have entered a tracking number that exceeds the maximum size of {1} characters:
{2}. Multiple tracking numbers must be separated by spaces, tabs, or commas. Slash
(/), semicolon (;), colon (:), or any other character that is not a space or a comma will be
interpreted as a part of the tracking number.

INVALID_TRAN_ITEM_LINE Item {1} can not be included on the {2} because it is not distributed as of the transaction
date

INVALID_TRANS This transaction is not valid.

INVALID_TRANS_COMPNT You have entered an invalid component for this transaction.

INVALID_TRANS_ID Invalid Transaction ID. Correct the transaction ID, then re-submit.

INVALID_TRANS_ID Only sale transactions can be refunded. Provide a valid transaction ID.

INVALID_TRANS_SUB_ACCT Transaction subsidiary {1} is not valid for account {2}. Please choose a different account.

INVALID_TRANS_SUB_CLASS Transaction subsidiary {1} is not valid for class {2}. Please choose a different class.

INVALID_TRANS_SUB_DEPT Transaction subsidiary {1} is not valid for department {2}. Please choose a different
department.

INVALID_TRANS_SUB_ENTITY Transaction subsidiary {1} is not valid for entity {2}. Please choose a different entity.

INVALID_TRANS_SUB_ITEM Transaction subsidiary {1} is not valid for item {2}. Please choose a different item.

INVALID_TRANS_SUB_LOC Transaction subsidiary {1} is not valid for location {2}. Please choose a different location.

INVALID_TRANS_TYP Transaction type specified is incorrect.

INVALID_TRANSACTIO_DATE There are no Accounting Periods that cover this transaction date.

INVALID_TRANSACTION_DATE Transaction date {1} is not valid. Transaction dates may be at most {2} years in the past and
{3} years in the future.

INVALID_TRIAL_TYP The trialtype is not availabe in the product specified.

INVALID_TYP Invalid type {1}, use {2}

INVALID_UNIT_TYP On serialized items, you may not choose a units type that has fractional conversion rates.

INVALID_UNSUPRTD_RCRD_ Invalid or unsupported record type: {1}

TYP

INVALID_UPS_ACCT An invalid UPS Account Number was entered. Please verify you have entered the correct
Shipper Number and re-submit the form.

INVALID_UPS_PACKG_WEIGHT UPS requires a minimum package weight of .1 LBS and a maximum package weight of 150
LBS. Please adjust the package weights accordingly and resubmit the fulfillment.

INVALID_UPS_VALUES UPS did not accept the entered values for the following fields. Please go back and correct
these values:

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 356

Error Code Returned Long Description or Message

INVALID_URL Please begin the {1} url with http:// or https://Examples of a valid {1}url
are: http://www.example.com/image.gif or https://one.two.org/user-name/
test.jpg

INVALID_URL Request for invalid URL: {1}

INVALID_URL_PARAM Error: URL param {1}="{2}" - expected an integer.

INVALID_VALUE You have entered an invalid value {1} for {2}.

INVALID_VAT_AMOUNT VAT amount cannot be negative

INVALID_VAT_REGSTRTN_NUM Invalid VAT registration number {1}.

INVALID_VSOE_ALLOCTN VSOE allocations must be greater than or equal to 0

INVALID_WEBSITE_SECTION The Web site section you entered does not exist.

INVALID_WO You have an invalid work order {1} or the order is already closed.

INVALID_WO_ITEM Special Work Order Items can not be Drop Ship or Special Order

INVALID_WORLDPAY_ID Exchange source does not recognize your WorldPay ID. Please check that it is correct.

INVALID_WS_VERSION The async operation has been submitted through different endpoint version: {1}.

INVALID_YEAR Invalid year {1}

INVALID_YEAR_FORMAT Illegal year format or value. Examples: 1999, 2000, 2001, etc.

INVALID_ZIP_CODE Merchant Zip Length Error. Provide a valid 5 digit zip.

INVALID_ZIP_FILE Invalid archive. Zip file must contain at least one file.

INVALID_ZIP_POST_CODE The submitted Zip/Postal Code is invalid. This field may only contain a maximum of 16
digits, spaces, and the dash character (-).

INVENTORY_NUM_DISALLWD Inventory numbers are only allowed on items with serial numbered or lot numbered items.

INVLAID_BOOLEAN_VALUE You have entered an invalid boolean value. Please use true, false, T, or F for boolean values
and resubmit your import.

IP_REQUEST Your IP address {1} does not match any of the ipaddress rules specified for this account.

ISSUE_ASSIGNEE_DISALLWD The specified assignee is disallowed for this issue's status.

ISSUE_PRODUCT_VERSION_ Cannot set issue {1} to {2} {3} and {4} {5} because that product is not associated with that
MISMATCH version.

ISSUE_VERSION_BUILD_ Issue version and build do not match.

MISMATCH

ITEM_ACCT_REQD One of the items on this transaction has an amount but no account. Please fix the item and
resubmit the transaction.

ITEM_ACCT_REQD One of the items on this transaction has an amount but no account. Please fix the item and
resubmit the transaction. It might be that you have recently elected to charge for shipping
and have not assigned an account to the shipping item that is included in this transaction.

ITEM_ACCT_REQD You must specify asset and COGS accounts for this inventory item.

ITEM_COUNT_MISMATCH COGS_CORRECTION: 2 means of calculating the item count do not match for item: {1} vs
{2})

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 357

Error Code Returned Long Description or Message

ITEM_COUNT_MISMATCH COGS_CORRECTION: 2 means of calculating the item count do not match for item: {1} vs
{2}) There are transactions in the system in which this item is used but the asset account for
that item is not the current Asset Account in the item record

ITEM_IS_UNAVAILABLE (Item is unavailable)

ITEM_NAME_MUST_BE_ An item with that name already exists. Please choose another name
UNIQUE

ITEM_NOT_UNIQUE The item [{1}] is not unique.

ITEM_PARAM_REQD_IN_URL Error - Item parameter (id=nnn) was not provided on the URL

ITEM_QTY_AMT_MISMATCH Inventory and assembly items cannot have zero quantity and non-zero amount.

ITEM_TYP_REQS_UNIT Items of type {1} require {2} unit

ITEM_TYP_REQS_UNIT Items of type {1} subtype {2} require {3} unit

JE_AMOUNTS_MUST_BALANCE The amounts in the journal entry must balance.

JE_LINE_MISSING_REQD_DATA {1} are mandatory on all lines of the journal entry.

JE_MAX_ONE_LINE Journal Entries can have a maximum of {1} lines.

JE_REV_REC_IN_PROGRESS This account is currently processing Revenue Recognition Journal Entries. Only one such
process is allowed at a time.

JE_UNEXPECTED_ERROR Journal Entries failed to be created due to unexpected error.

JOB_NOT_COMPLETE The specified job is not complete yet

JS_EXCEPTION A JavaScript Exception was thrown

KEY_REQD Empty key not allowed for {1}

KPI_SETUP_REQD Please enable the Forecast ({1}) & Quota KPIs

KPI_SETUP_REQD Please enable the Forecast & Quota KPIs

KPI_SETUP_REQD please enable the Sales & Forecast KPIs

KPI_SETUP_REQD Please enable the Sales & Forecast ({1}) KPIs

KPI_SETUP_REQD Please enable the Sales & Quota KPIs

LABEL_REQD Please enter a value for Label

LANGUAGE_SETUP_REQD Please go to company preference to add language to translate.

LINK_LINES_TO_ONE_ORD Lines on this record can only be linked to a single order.

LINKED_ACCT_DONT_MATCH You are attempting to link transaction line items, but items on the lines do not match.
This can happen when you create a fulfillment from a sales order, a receipt from a
purchase order, an invoice from a sales order, a vendor bill from a purchase order, or
a reimbursement from a purchase. Please verify that items in the transaction you are
creating match the items in the originating transaction.

LINKED_ENTITIES_DONT_ You are attempting to link transactions, but the entities on the transactions do not match.
MATCH

LINKED_ITEMS_DONT_MATCH Linked items don't match

LIST_ID_REQD Required field missing in a related list. You must set {1}.

LIST_KEY_REQD There is no list key for field {1} of list {2}. Please assign a key and resubmit your task.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 358

Error Code Returned Long Description or Message

LOCATIONS_IN_USE Your classes cannot be converted to locations because your existing location records are
referred to by transactions or other records. These location records cannot be overwritten.

LOCATIONS_SETUP_REQD You must first define locations (Lists->Locations->New) before you can distribute inventory.

LOCATIONS_SETUP_REQD You must first define locations (Lists->Locations->New) before you can transfer inventory.

LOCATION_REQD You must specify a location to use {1} numbers when Multi-Location Inventory is enabled

LOCKED_DASHBOARD Your dashboard has been set up and locked by an administrator. Please contact them for
details.

LOGIN_DISABLED Invalid login. Customer access is disabled.

LOGIN_DISABLED Login access has been disabled for this role.

LOGIN_DISABLED Your access to {1} has been deactivated. Please contact the company's administrator to re-
activate your access.

LOGIN_DISABLED Your access to this account has been removed or disabled. Please contact the account
adminstrator.

LOGIN_DISABLED_PARTNER_ Disabled login: Advanced Partner Center access has been disabled by the account
CTR administrator.

LOGIN_DISABLED_PARTNER_ Disabled login: Standard Partner Center access has been disabled by the account
CTR administrator.

LOGIN_EMAIL_REQD Invalid login. You must provide an email address.

LOGIN_NAME_AND_PSWD_ Please enter both a user name and a password.

REQD

LOGIN_REQD You must <a href='/pages/login.jsp' target='_self'>log in</a> before accessing this page.

LOST_UPSELL_CRITERIA Your upsell criteria were lost. This is probably due to a transient condition such as a server
reboot. Click <a href=# onclick='history.go(-1);'>here</a> to go back and try again.

MACHN_LIST_KEY_NAMES_ Server application error: no list key names are defined for field {1} of record of type {2}.
REQD

MANDATORY_PRD_TYPE_REQD Please select the mandatory period type...

MASS_UPDATE_CRITERIA_LOST Your mass update criteria were lost. This is probably due to a transient condition such as a
server reboot. Click <a href=# onclick='history.go(-1);'>here</a> to go back and try again.

MATCHING_CUR_SUB_REQD The parent specified must have the same currency and subsidiary as the child

MATCHING_SERIAL_NUM_ The serial numbers on a transfer order receipt must have been fulfilled
REQD

MATRIX_INFO_TEMP_LOST Matrix item information was lost. This was probably due to a transient condition like a
server reboot. Please try again.

MATRIX_SUBITEM_NAME_ The following matrix sub-item name is too long (80 character max): {1} Please
TOO_LONG shorten your parent item name or your option abbreviations.

MAX_16_LINES_ALLWD_PER_ A maximum of 16 lines per payee can be applied per online bill payment.
BILLPAY

MAX_200_LINES_ALLWD_ON_ Journal Entries can have a maximum of 200 lines.

TRANS

MAX_BARCODE_PRINT_ A maximum of {1} barcodes can be printed at a time.

EXCEEDED

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 359

Error Code Returned Long Description or Message

MAX_BULK_MERGE_RCRDS_ You cannot perform a bulk merge operation with a group larger than {1} records
EXCEEDED

MAX_EMAILS_EXCEEDED This campaign email event exceeds the number of emails ({1}) that can be sent per month
without setting up a default campaign domain or specifying one on the campaign email
template.

MAX_EMAILS_EXCEEDED This merge operation exceeds the number of emails ({1}) that can be sent per month
without setting up a bulk merge domain or specifying one on the email template.

MAX_RCRDS_EXCEEDED The maximum number ( {1} ) of records allowed for a {2} operation has been exceeded.

MAX_VALUES_EXCEEDED Too many values specified for a MultiSelectField, the maximum is 1000

MEDIA_FILE_INVALID_JSCRIPT Media file was of type javascript and would not compile. Error on line:

MEDIA_NOT_FOUND Media item not found {1}

MEDIA_NOT_INITIALIZED Media Item cannot be initialized

MEMORIZED_TRANS_ERROR failed retrieving 'chargeit' record from trancard while processing memorized tran

MEMORIZED_TRANS_ERROR A failure occurred while trying to enter one of your automated memorized transactions.
The reason for this failure is shown in the description field on this page. Because of the
failure, the system has changed this memorized transaction from an automated one to
a reminder. You may click the link above to view the memorized transaction in question
and make any needed changes to it. When you are done with the changes, click Memorize
and then Cancel. This will modify your existing memorized transaction rather than creating
a new one. When filling out the Memorized Transaction Form, you may choose to select
'Automatic' to resume automated posting of this transaction.

MERGE_OPERATION_ You cannot perform merge operations on records that belong to your group.
DISALLWD

MERGE_RCRD_REQD You must specify a record to merge into

METAVANTE_ERROR This Online Bill Payment has been {1} in your NetSuite account. However, the payment
was not able to be {2} at Metavante. To {3} this payment at Metavante, please contact
NetSuite Customer Support immediately, using the options provided in the Support >
Customer Service section of your NetSuite account.

METAVANTE_SECRET_ Missing Secret Answer. A secret answer is required by the Metavante CSP service. It cannot
ANSWER_REQD be null or empty.

METAVANTE_SECRET_ Missing or invalid Secret Question ID. A valid Secret Question is required by the Metavante
QESTION_REQD CSP service. Please refer to Table 2, above, for a list of valid Secret Question IDs.

METAVANTE_SETUP_REQD Your NetSuite account is not currently integrated with a Metavante Online Bill Pay
account. To set up an active account, you need to reapply to Metavante. Go to
Setup > Set Up Online Bill Pay and follow the instructions on that page to apply for a
Metavante account.

METAVANTE_TEMP_ Metavante is temporarily unavailable. Please try again later. If you would like
UNAVAILBL to print the payment to mail yourself, click Back, and then click the date of the payment on
the Approve Online Bill Payments page. When the payment's detail record appears, clear
the Bill Pay box and either check the To Be Printed box and click Submit or click the Print
button.

MISMATCH_EVENT_ISSUE_ Event status ({1}) and issue base status ({2}) do not match
STATUS

MISMATCH_ISSUE_PRODUCT_ Issue product and version do not match.

VERSION

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 360

Error Code Returned Long Description or Message

MISMATCH_SALES_ Sales team sales rep total does not equal 100%, {1} sales reps, {2} total contribution.
CONTRIBUTION

MISMATCHED_CURRENCY The transaction currency does not match the names currency

MISMATCHED_QTY_PRICING Quantities do not match accross pricings

MISMATCHED_SEARCH_ Search error: Parentheses are unbalanced.

PARENTHESIS

MISSING_ACCT_PRD You are attempting to create an amortization or revenue recognition schedule outside the
range of available accounting periods. Please adjust the periods on this transaction or go to
Setup>Accounting>Manage Accounting Periods to set up more periods.

MISSING_CRNCY_EXCH_RATE No currency conversion rate defined

MISSING_ENUM No Enumerated Value {1} for Enumerated Type {2}

MISSING_REQD_FLD Missing required value for mandatory field: {1}

MISSING_REQD_FLD The Company record does not have all required fields set. Please ensure the State, Zip/
Postal Code, and Country fields are set and try your request again.

MISSNG_ACCT_PRD Unable to find an Accounting Period for the allocation date.

MISSNG_REV_REC_RCRD Unable to locate Revenue Recognition records.

MISSNG_SO_REV_REC_PARAMS Unable to get Revenue Recognition parameters from originating sales order.

MISSNG_SO_START_END_ Unable to acquire start and end date from Sales Order.
DATES

MLI_REQD Multi-location Inventory Error (MLI_LOCATION_REQUIRED): this transaction or its items

must have locations.

MLTPLE_TAX_LINES_DISALLWD Multiple Tax lines for line item in transaction:

MSNG_FIELD_OWRTE_MUST_ The missingFieldOverwrite attribute must be true when updating a salesOrder.

BE_TRUE

MST_UPDATE_ITEMS_THEN_ You cannot update items and shipping rates at the same time on transactions that have
RATES multiple shipping routes enabled. You must first update the items, then get the transaction
and update the shipping rates separately.

MULTI_ACCT_CANT_CHANGE_ The password cannot be changed here because the email address is associated with
PSWD multiple accounts. The user must change their password via the link in the settings portal of
the home page.

MULTI_LOC_INVT_ERROR Multi-Location Inventory Error: You may not create an Assembly Build transaction with an
assembly item that has not been distributed and member items that have been distributed.
You must create an Inventory Distribution transaction for the assembly item before
building it. You also may not create an Assembly Build transaction on a date prior to the
distribution date of the assembly but after the distribution date of any of the member
items.

MULTI_PRIMARY_PARTNER_ You are not allowed to select multiple primary partners.

DISALLWD

MULTI_SHIP_ROUTES_REQD {1} {2} has multiple shipping routes enabled, which is only supported in version 2008_2 and
newer. You are not allowed to update any shipping fields on this record.

MULTISELECT_TYPE_REQD Server application error: no multiselect type is defined for field {1} of {2} record type.

MUST_DEFINE_BASE_UNIT One unit must be designated as the base unit.

MUST_RESUBMIT_RCRD Configuration changes have been made to your account. You must resubmit your record.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 361

Error Code Returned Long Description or Message

NAME_ALREADY_IN_USE A mass update has already been saved with that name. Please use a different name.

NAME_ALREADY_IN_USE A search has already been saved with that name. Please use a different name.

NAME_REQD Missing Name. Name is a required field and it cannot be null or empty.

NAME_TYPE_FLDR_FIELDS_ missing required fields : name, type, and folder

REQD

NARROW_KEYWORD_SEARCH Please provide more detailed keywords so your search does not return too many results.

NEED_BILL_VARIANCE_ACCT Bill variance account is missing

NEGATIVE_PAYMENT_ Negative payments not allowed

DISALLWD

NEGATIVE_TAX_RATE_ A Tax rate cannot be negative

DISALLWD

NEW_CONNECTION_ Not allowed to create new connections.

DISALLWD

NEXUS_REQD No tax agency defined for subsidiary: subsidiary {1} is not linked to nexus {2}

NO_DATA_FOUND No data was found

NO_EXPENSES_FOR_PRD The Allocation sources or destinations did not have any expenses associated with them for
the selected period.

NO_ITEMS_TO_PRINT There are no items to print

NO_MASS_UPDATES_ There are currently no mass updates running.

RUNNING

NO_MTRX_ITEMS_TO_UPDATE There are no matrix subitems to update.

NO_ORD_SHPMNT There is no shipment on that order.

NO_RCRD_FOR_USER There is no record for this user in the company's entity table. (emaillogin.semail='{1}',
kentity={2})

NO_RCRDS_MATCH No Records matched your request.

NO_SCHDUL_APPLIED There were no schedules that need to applied to the particular period.

NO_SCHDUL_APPLIED There were no schedules that need to be applied to the input accounting period.

NON_ADMIN_CANNOT_ This user cannot integrate with a partner.

INITIATE_LINK

NONMATCHING_EMAILS Email addresses don't match

NONUNIQUE_INDEX_VALUE An attempt was made to insert a row with a non-unique index value. Dynamic SQL being
executed [ {1} ]

NONZERO_AMT_REQD You did not enter non-zero amounts for any accounts.

NONZERO_QTY_REQD Build quantity must be greater than zero.

NONZERO_WEIGHT_REQD Selected service must have a weight greater than zero.

NOT_AN_INVITEE You are not on the invitee list for event.

NOT_IN_INVT You may not distribute {1} numbers that are not currently in inventory. You attempted to
distribute the following {1} numbers that were not in inventory: {2}

NULL_CHECK_NUMBER Null Check Number

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 362

Error Code Returned Long Description or Message

NUM_ITEMS_GRTR_THAN_QTY The number of {1} entered ({2}) is greater than the item quantity ({3})

NUM_ITEMS_NOT_EQUAL_TO_ The number of {1} entered ({2}) is not equal to the item quantity ({3})
QTY

NUM_REQD_FOR_FIRST_LABEL No number was specified for the first label.

NUMERIC_CHECK_NUM_REQD Invalid Check Number. Check number must be a numeric value and can be at most 7 digits
long.

NUMERIC_REF_NUM_REQD Reference Number Must Be Numeric. Please provide a valid number and re-submit.

OI_FEATURE_REQD You have not enabled Outlook Integration feature for your account.

OI_PERMISSION_REQD You do not have permission to access Outlook Integration feature.

ONE_ADMIN_REQD_PER_ACCT This operation would leave your account without an active Administrator. To successfully
perform the mass update, please deselect at least one entity with an Administrator role.

ONE_ADMIN_REQD_PER_ACCT You can't delete this employee. No administrators for this account would remain.

ONE_ADMIN_REQD_PER_ACCT You can't inactivate {1}. The account would be left with no active administrators.

ONE_ADMIN_REQD_PER_ACCT You can't remove the administrator role from this user. No administrators for this account
would remain.

ONE_EMPL_REQD At least one employee is required to process payroll

ONE_PAY_ITEM_PER_EMPL An employee may not have multiple instances of payroll items. Go <a
href="javascript:history.go(-1);";>back</a>, remove these items and resubmit.

ONE_POSITIVE_VALUE_REQD You must enter at least one positive value for at least one item.

ONE_RCRD_REQD_FOR_MASS_ Please create at least one {1} before using this mass update.
UPDATE

ONE_ROLE_REQD You can't inactivate all roles. You would not be able to log in.

ONLINE_BANK_FILE_REQD You must first upload an Online Bank file before using the Online Bank Statement.

ONLINE_BILL_PAY_DUP Another entity with the same online bill pay name, account, and address already exists.
Please find and use that entity for online bill pay.

ONLINE_BILL_PAY_SETUP_ {1} is not set up for Online Bill Pay. To set up this payee, click Go Back. When
REQD the Approve Online Bill Payments page appears, click Enable Payee in the Enabled for
Billpay column. When the payee's record appears, check Enable Online Bill Pay and
submit these required fields:<ul><li>Legal Name</li><li>Print on Check As</li><li>Phone</
li><li>Billing Address</li></ul> Then, go to Transactions > Approve Online Bill Payments
to approve the payment.

ONLINE_FORM_DSNT_EXIST This online form does not exist.

ONLINE_FORM_EMPTY The online form you requested is empty.

ONLINE_FORM_ID_REQD Missing required online form ID

ONLINE_FORM_USER_ACCESS_ This form is only accesible to online form users.

ONLY

ONLINE_ORD_FEATURE_ Can't open store for {1}. This company does not have the Use Sales Orders feature
DISABLED enabled. The feature is required for customers to make online purchases.

ONLY_ONE_CONTRIB_ITEM_ Only one instance of a company contribution item is allowed on an employee record.
REQD

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 363

Error Code Returned Long Description or Message

ONLY_ONE_DEDCT_ITEM_ Only one instance of a deduction item is allowed on an employee record.

REQD

ONLY_ONE_DISTRIB_ALLWD You may not distribute {1} numbers more than one time. You attempted to distribute the
following {1} numbers more than one time: {2}

ONLY_ONE_EARNING_ITEM_ Only one instance of an earning item is allowed on an employee record.

REQD

ONLY_ONE_LOT_NUM_ALLWD You may not enter more than a single serial/lot number before an item is selected.

ONLY_ONE_PREF_BIN_ALLWD There may be at most one preferred bin per location for an item. The following location has
more than one preferred bin for this item: {1}

ONLY_ONE_PREF_BIN_ALLWD You may not have more than one preferred bin per item.

ONLY_ONE_UNIT_AS_BASE_ Only one unit may be designated as the base unit.

UNIT

ONLY_ONE_UPLOAD_ALLWD You cannot upload more than one file at a time

ONLY_ONE_WITHLD_ITEM_ Only one instance of a withholding item is allowed on an employee record.

REQD

OPENID_DOMAIN_IN_USE This domain is already in use by another NetSuite account, and a domain cannot be used
by multiple accounts.

OPENID_NOT_ENABLED The OpenID Single Sign-on feature is not enabled in this account.

OPRTN_UNAVAILBL_TO_
GATEWAY

ORD_ALREADY_APPRVD You cannot cancel this order because it has already been approved.

ORD_UNAVAILBL_TO_FULFILL This order is not available for fulfillment. The current Google Order Financial State is {1}

ORDER_DSNT_EXIST That order does not exist.

OTHER_PMT_AUTH_IN_ Another payment authorization is currently in progress for this order. Pleaase try again in a
PROGRESS few minutes.

OVER_FULFILL_DISALLWD You can not over-fulfill an item unless you have selected the 'Allow Overage on Item
Fulfillments' preference.

OVER_FULFILL_RECEIV_ Transfer orders can not be overfulfilled or overreceived

DISALLWD

OVERAGE_DISALLWD Overage is not allowed.

OVERLAPPING_PRDS_ Illegal period structure. Overlapping periods.

DISALLWD

OVERLAPPING_PRDS_ There is an overlapping period. Please check your Active or Inactive Periods to ensure that
DISALLWD there is not an existing period.

OWNER_REQD You cannot make a contact private without an owner

PACKAGE_WEIGHT_REQD Attempted to create a package without specifying a nonzero package weight.

PACKG_LEVEL_REF_DISALLWD Package level reference numbers are not allowed for shipments whose origin/destination
pair is not US/US or Puerto Rico/Puerto Rico.

PACKG_VALUE_TOO_LARGE Package declared value cannot be greater than $999.00 USD

PARENT_CANT_ITSELF_BE_ Parent item can not be a member of itself

MEMBER

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 364

Error Code Returned Long Description or Message

PARENT_MUST_BE_MATRIX_ A Child matrix item's parent must be a matrix item

ITEM

PARENT_REQD A Child matrix item must have its parent specified

PARSING_ERROR Unable to parse value into the correct type. Problem occured on record type: {1}, internalid:
{2}, field : {3}, value: {4}

PARTIAL_FULFILL_RCEIV_ Transfer orders can not be partially fulfilled or partially received

DISALLWD

PARTNER_ACCESS_DENIED Partners do not have access to this item.

PARTNER_ACCT_NOT_LINKED Account ({1}) from partner ({2} is not linked.

PARTNER_CODE_ALREADY_ A partner with that partner code ({1}) already exists.

USED

PAY_HOLD_ON_SO This sales order cannot be fulfilled because it has a payment hold.

PAYCHECK_ALREADY_PAID You are trying to edit a paycheck that is already paid by direct deposit. A paycheck cannot
be edited after funds have been processed by the Automated Clearing House (ACH).

PAYCHECK_IN_USE You cannot clear this paycheck because it is linked to by one or more liability payments. You
must delete or void those transactions first

PAYEE_REQD_FOR_PMT Your payment has been recorded, but an online bill pay payment will not be made because
no payee was specified.You should return to the payment screen if you wish to print the
check.

PAYPAL_FUND_SOURCE_REQD Please return to PayPal to select a different funding source.

PAYPAL_INVALID_PMT_ Paypal is unable to process this payment. Please select an alternate payment method.
METHOD

PAYPAL_INVALID_PMT_ Your PayPal account is not configured to use Express Checkout. Please follow directions on
METHOD the PayPal payment method record.

PAYPAL_PMT_NOTIFICATION PayPal Payment Notification

PAYPAL_SETUP_REQD The account referenced by this paypal id is not setup to use express checkout. Please
return to the paypal setup page and follow directions for setting up paypal express
checkout.

PAYROLL_COMMITTED You are trying to edit a paycheck reversal that is in a committed Payroll Batch.

PAYROLL_COMMITTED You are trying to edit a paycheck that is in a committed Payroll Batch.

PAYROLL_COMMITTED You are trying to modify a committed payroll batch or a document on a committed payroll
batch.

PAYROLL_EXPENSE_ACCT_ Please select an expense account for payroll item <a href='/app/common/item/
REQD payrollitem.nl?id={1}&e=T'>{2}</a>

PAYROLL_EXPENSE_ACCT_ Please select a expense account for payroll item <a href='/app/common/item/
REQD payrollitem.nl?id={1}&e=T'>{2}</a>

PAYROLL_FEATURE_DISABLED You have not enabled the Payroll feature.

PAYROLL_FEATURE_ You are trying to edit a Pay Cheque - Payroll is not available in NetSuite Canada.
UNAVAILABLE

PAYROLL_IN_PROCESS A payroll process is currently running in this account. Please try again in a few minutes.

PAYROLL_ITEM_DELETE_ Unable to remove payroll item: {1} - There are existing transactions for this payroll item.
DISALLWD You may mark it inactive instead.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 365

Error Code Returned Long Description or Message

PAYROLL_LIABILITY_ACCT_ Please select a liability account for payroll item <a href='/app/common/item/payrollitem.nl?
REQD id={1}&e=T'>{2}</a>

PAYROLL_MAINTENANCE The Payroll feature in your account is undergoing routine maintenance from {1} Pacific
Time on {2} to {3} Pacific Time on {4}. We apologize for any inconvenience this causes you.

PAYROLL_SETUP_REQD The default payroll expense account is missing. Please go to Setup -> Payroll -> Set Up
Payroll and set the default payroll expense account.

PAYROLL_SETUP_REQD You are trying to create a paycheck before your payroll setup is complete. Please complete
your payroll setup.

PAYROLL_SETUP_REQD You are trying to process payroll before your payroll setup is complete. Please complete
your payroll setup.

PAYROLL_UPDATE_REQD You made changes that require you to update your payroll information. Click <a href="/app/
payroll/managepayroll.nl">here</a> to commit updates to the payroll service.

PERMISSION_VIOLATION Permission Violation: you may not access this record.

PERMISSION_VIOLATION Permission Violation: you may no longer edit this record.

PHONE_NUM_REQD Please provide a phone number.

PIN_DEBIT_TRANS_DISALLWD Non-USD pin debit transactions are not supported. PINNED Debit for USD transactions
only.

PLAN_IN_USE This plan has already been used to generate commission calculations and can't be deleted.

PLAN_OVERLAP_DISALLWD Plan overlap is not permitted. You have attempted to assign someone to this plan for a time
period that overlaps with another plan.

PMT_ALREADY_APPRVD The payment has already been approved and sent to the bill pay carrier for processing.

PMT_ALREADY_EXISTS A payment with the same amount and date already exists for this payee.

PMT_ALREADY_SBMTD This payment has already been submitted for online bill pay.

PMT_EDIT_DISALLWD Access to this Bill Pay transaction is restricted, and it cannot be modified. Transactions can
only be modified until 3PM CST on the payment date.

PMT_EDIT_DISALLWD This liability payment cannot be edited while it has an Automated Clearing House
transmission in process.</TD></TR><TR><TD class=text> </TD></TR><TR><TD class=text>
To view the status of payments with ACH transmissions, go to Transactions > View ACH
Vendor Payments Status.

POSITIVE_BIN_QTY_REQD Bin quantities must be positive or zero.

POSITIVE_QTY_REQD Assembly member items must have positive quantities

POSITIVE_UNITCOST_REQD Lines cannot have a negative unit cost.

POSTING_DISCOUNT_ Posting Discounts are not allowed on lines with Revenue Recognition Schedules.
DISALLWD

POSTING_PRD_SETUP_REQD Creation of Journal Entries require a single Accounting Period value across all Revenue
Recognition events. Please setup a 'Posting Period' filter.

PRDS_DISALLWD_NAMES_ After adding new periods, not all names would be unique.
NOT_UNIQUE

PRD_SETUP_REQD You must change your period definitions to contain fiscal years. Please visit 'Setup->Manage
Accounting Periods' and click 'Set Up Year'.

PRD_SETUP_REQD You must define the periods of the prior fiscal year. Please visit 'Setup->Manage Accounting
Periods' and click 'Set Up Year'.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 366

Error Code Returned Long Description or Message

PRDS_DISALLWD_NAMES_ After adding new periods, not all names would be unique.
NOT_UNIQUE

PREF_VENDOR_COST_REQD Drop ship/Special Order items must have a preferred vendor and a purchase price.

PREF_VENDOR_REQD Drop ship/Special Order items must have a preferred vendor for each of the {1} the item is
accessible to.

PREFERRED_TAX_AGENCY_ A preferred Tax Agency has been deleted - Please choose a new one in <a href="/app/
REQD setup/acctsetup.nl";>Set Up Accounting</a>

PREFERRED_TAX_AGENCY_ Error: No preferred Tax Agencies have been set up (go to <a href='/app/setup/
REQD acctsetup.nl';>Set Up Accounting</a>)

PRIVATE_RCRD_ACCESS_ You cannot view or edit this record because it is marked private
DISALLWD

PRIVATE_STATUS_CHNG_ You cannot make this contact private.

DISALLWD

PSWD_EXPIRED Password has expired. Please change your Netsuite password before continuing.

PSWD_REQD A password must be entered when granting login access privileges to this record.

PSWD_REQD Password is empty.

PSWD_REQD Please type your password into both fields.

PSWD_REQD You must provide a password to give this person access to your account.

PWSDS_DONT_MATCH New passwords don't match.

PWSDS_DONT_MATCH The passwords you entered do not match. Please reenter your passwords.

PWSDS_DONT_MATCH The Passwords you entered do not match. Please reenter your passwords.

PWSDS_DONT_MATCH The passwords you have entered do not match.

QTY_EXCEEDED_QTY_BUCKETS More quantities defined than there are quantity buckets

QTY_REQD Quantities must be defined

RATE_REQUEST_SHPMNT_ The rate request shipment value has not been set.
REQD

RATE_SRVC_UNAVAILBL The rate for this service is not available for the specified source and destination addresses.

RCRD_DELETED_SINCE_ Items you have requested in the record have been deleted since you retrieved the form
RETRIEVED

RCRD_DELETED_SINCE_ The record has been deleted since you retrieved it.
RETRIEVED

RCRD_DSNT_EXIST Group Record Not Found

RCRD_DSNT_EXIST That record does not exist.{1}

RCRD_DSNT_EXIST There are no records of this type.

RCRD_EDITED_SINCE_ The record has been edited since you retrieved it. Hit the back button and click Refresh/
RETRIEVED Reload to retrieve the updated record, then resubmit your changes.

RCRD_HAS_BEEN_CHANGED Record has been changed

RCRD_ID_NOT_INT Record id is not integer: {1}

RCRD_LOCKED_BY_WF This record has been locked by a user defined workflow.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 367

Error Code Returned Long Description or Message

RCRD_NOT_FOUND Could not find any records by this name.

RCRD_PREVSLY_DELETED This record has already been deleted.

RCRD_PREVSLY_DELETED This record has been deleted since the list was generated.

RCRD_REF_RCRD_TYP_ The record type and its object reference are not matched.
MISMATCH

RCRD_SUB_MISMATCH_WITH_ The subsidiary restrictions on this record are incompatible with those defined for class: {1}.
CLASS Subsidiary access on this record must be a subset of those permitted by the class.

RCRD_TYPE_REQD The record type is required.

RCRD_UNEDITABLE That record is not editable.

REACHED_LIST_END You have reached the end of the list.

REACHED_LIST_START You have reached the start of the list.

REC_TYP_REQD You must provide either standard or custom record type information.

RECALCING_PLAN_SCHDUL Cannot inactivate a plan when schedules in the plan are recalculating. Try again when
recalculation is complete.

RECUR_EVENT_DISALLWD A yearly event cannot be on the 29th of February

RECURSV_REF_DISALLWD ERROR: Recursive Reference

REPORT_EXPIRED Your report request has expired. A newly created report definition will normally expire after
15 minutes of inactivity unless the definition is saved. Click back to the report definition
page and re-submit your report request.

REQD_FORM_TAG_MISSING Your HTML template file is missing some mandatory fields or a form tag. Please make the
changes to the form and try again

REQD_FORM_TAG_MISSING Your Online HTML Form template is missing a required closing FORM tag

REQD_FORM_TAG_MISSING Your Online HTML Form template is missing one or more of the required following required
tags: <HTML>, <HEAD>

REQD_FORM_TAG_MISSING Your Online HTML template is missing the required form tag for the main form: <NLFORM>

REQD_LOC_FIELDS_MISSING Location {1} does not have all required fields set. Please ensure the State, Zip/Postal Code,
and Country fields are set and try your request again.

REQD_SUB_FIELDS_MISSING The Subsidiary {1} does not have all required fields set. Please ensure the State, Zip/Postal
Code, and Country fields are set and try your request again.

REQUEST_PARAM_REQD This request is missing a required parameter.

REV_REC_DATE_REQD No Revenue Recognition Start Date Specified

REV_REC_TMPLT_DATA_ One or more line items on this transaction have Variable Revenue Recognition Templates,
MISSING but do not have the required {1} also populated. Please either change the Template for
these items or indicate which {1} will be used to schedule the recognition of revenue.

REV_REC_UPDATE_DISALLWD Modification of revenue recognition related information on this item is not allowed because
revenue has been recognized for this or related lines.

REVERSAL_DATE_WARNING Reversal Date is in a closed accounting period. Please go to Manage Accounting Periods
and re-open the accounting period.

ROLE_REQD Please specify a role to which access should be granted

ROLE_REQUIRED To login, a role is required unless a default has been previously set.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 368

Error Code Returned Long Description or Message

ROUNDING_DIFF_TOO_BIG rounding difference too big -> tax1: {1} /tax2: {2}

ROUNDING_ERROR Rounding Error: {1}

ROUTING_NUM_REQD Missing Routing Number. Bank routing number is a required field and it cannot be null or
empty.

SALES_DISCOUNT_ACCT_REQD Please set the Sales Discount Account Preference

SAME_ACCT_TYP_REQD_FOR_ Parent acccount must be of same account type.

PARENT

SAVED_SRCH_EMAIL_ERROR E-mail Alert Failure using saved search '{1}'. Reason: {2}

SCHDUL_EDIT_DISALLWD This schedule cannot be edited as it has already been used for commission calculations.
Please go back and select 'save as new' instead.

SCHEDULED_REPORT_ERROR NetSuite encountered an error while trying to generate your scheduled report.

SCHEDULED_REPORT_ERROR NetSuite encountered an error while trying to generate your scheduled report. Please click
{1}here{2} to notify NetSuite Support.

SCHEDULED_REPORT_ERROR NetSuite encountered an error while trying to generate your scheduled report. This error
most likely occurred because the query was too large. To run this report successfully, try
using filters, or select a different date/period range to narrow the query.

SEARCH_DATE_FILTER_REQD The search must have a date column as an available filter

SEARCH_ERROR Unable to search - Unexpected error in search engine.

SEARCH_INTEGER_REQD Please enter an integer number to search on.

SEARCH_TIMED_OUT Your search has timed out. If your search includes the '{1}' operator, try using '{2}' instead.
If your search includes broad search criteria, try narrowing the criteria.

SEARCH_TIMED_OUT Your search has timed out. This might be avoided by using a smaller page size.

SECURE_TRANS_REQD_ON_ Store Server Error: As configured, this server does not permit secure transactions, required
CHECKOUT by store checkout.

SERIAL_NUM_MATCH_MULTI_ {1} different items match this serial number. Select an item from the item dropdown list.
ITEMS

SESSION_TERMD_2ND_LOGIN_ You can have a maximum of {1} active users at a time in {2}. If you would like to add active
DECTD users, please contact your account manager to discuss your upgrade options. Or, you may
choose to inactivate an existing user before adding a new one. Note that Employee Center
users are not included in this total

SESSION_TERMD_2ND_LOGIN_ You can have a maximum of {1} active users at a time that are enabled for Offline Sales
DECTD Client. If you would like to add active users, please contact your account manager to discuss
your upgrade options. Or, you may choose to disable Offline Sales Client on an existing
user before enabling a new one.

SESSION_TIMED_OUT Your connection has timed out. Please log in again.

SESSION_TIMED_OUT Your connection has timed out. Please <a href='/pages/login.jsp' target='_self'>log in</a>
again.

SESSION_TIMED_OUT Your session has timed out. Please re-enter your information and try again.

SESSION_TIMED_OUT Your session has timed out. Please re-print the document(s).

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 369

Error Code Returned Long Description or Message

SET_SHIPPING_PICKUP_TYP Please verify that you have selected a pickup type under setup shipping.

SETUP_METER_REQD Please set up this meter

SHIP_ADDR_REQD Shipping address is incomplete.

SHIP_MANIFEST_ALREADY_ A Shipping Manifest has already been processed for the requested date/time {1}.
PRCSSD

SHIP_MANIFEST_ERROR No Shipments found to generate a Shipping Manifest for close date {1} for meter {2}.

SHIP_MANIFEST_ERROR No Shipping Manifest files found in FedEx Directory for report only request for meter {1}.

SHIP_SETUP_REQD No {1} registration was found for the location selected. Please select a different shipping
item, or go to Setup > Set Up Shipping to register a {2} account for this location.

SHIP_TALBE_UNBALNCD The Shipping Table is not balanced. Please review the table and ensure there is a Charge
for every Range Value, and that there are no duplicates

SHIPFROM_ADDRESS_NOT_ A shipping label could not be generated because the Phone Number of the "Ship From"
SET address is not set. Please go to $(regex) to enter the "Ship From" Phone Number.

SHIPMNT_INSURANCE_NOT_ Insurance is not available when shipping to the destination country: {1}
AVAILABLE

SINGLE_VALUE_REQD Multiple values found for a dropdown field that can only take one.

SITE_DOMAIN_NAME_REQD Notice: URL Components cannot be used until you have established a domain name for
your site

SITE_TAG_ALREADY_EXISTS This site tag already exists

SITEMAP_GEN_ERROR An error occurred while trying to generate the Sitemap.

SO_HAS_CHILD_TRANS This salesOrder has a one or more child transactions associated with it, and cannot be
updated.

SO_LINE_HAS_PO Error: A Drop Ship/Special Order already exists for sales order {1}, line {2}.

SRVC_UNAVAILBL_FOR_LOC The requested service is unavailable between the selected locations.

SSS_AUTHOR_MUST_BE_ The author internal id or email must match an employee.

EMPLOYEE

SSS_CONNECTION_TIME_OUT The host you are trying to connect to is not responding.

SSS_DEBUG_DISALLWD Script Debugging is not allowed on this server.

SSS_DRIP_EMAIL_RAN_OUT_ Campaign event ran out of coupon codes.

OF_COUPON_CODES

SSS_DUP_DRIP_EMAIL You are attempting to send the same campaign email twice to the same recipient.

SSS_FILE_SIZE_EXCEEDED The file you are trying to load exceeds the maximum allowed file size of {1} megabyte.

SSS_INSTRUCTION_COUNT_ Script Execution Instruction Count Exceeded.

EXCEEDED

SSS_INVALID_ATTACH_ Attaching of record type {1} to {2} is not supported.

RECORD_TYPE

SSS_INVALID_BCC_EMAIL One or more bcc emails are not valid.

SSS_INVALID_CC_EMAIL One or more cc emails are not valid.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 370

Error Code Returned Long Description or Message

SSS_INVALID_CMPGN_EVENT_ That campaign event is invalid, disabled, or is not a Lead Nurturing Email event. Please
ID select an active Lead Nurturing Email campaign event.

SSS_INVALID_EMAIL_ That email template is invalid, disabled, or no longer exists. Please select an active email
TEMPLATE template.

SSS_INVALID_FORM_ You have entered an invalid form element name. It must be prefixed with "custpage",
ELEMENT_NAME unique, and cannot contain any non-alphanumeric characters to be added to the form or
sublist.

SSS_GSO_FLTR_OPRTOR SSS Invalid GetSelectOption Filter Operator {1}, must be one of the following: {2}

SSS_INVALID_HEADER One or more headers are not valid.

SSS_INVALID_HOST_CERT An untrusted, unsupported, or invalid certificate was found for this host.

You may also receive this error if the domain name is spelled incorrectly or does not use
valid syntax. Verify that the domain name:

■ Has 63 or fewer characters

■ Contains alphanumeric characters (a-z, A-Z, 0-9) or hyphens
■ Starts with a letter
■ Ends with a letter or digit

SSS_INVALID_LIST_COLUMN_ You have entered an invalid list column name. It must be unique and cannot contain any
NAME non-alphanumeric characters.

SSS_INVALID_LOCK_WAIT_ You have entered an invalid wait time ({1}) for acquiring a lock. The wait time must be
TIME greater than 0ms and less than 5000ms.

SSS_INVALID_LOG_TYPE Execution log type must be one of AUDIT, DEBUG, ERROR, or EMERGENCY.

SSS_INVALID_PORTLET_ You have entered an invalid refresh interval of {1} seconds. It must not be negative.
INTERVAL

SSS_INVALID_PORTLET_ You have entered an invalid refresh interval of {1} seconds. It must be at least {2} seconds if
INTERVAL not in testing status.

SSS_INVALID_SCRIPTLET_ID That Suitelet is invalid, disabled, or no longer exists.

SSS_INVALID_SRCH_COL An nlobjSearchColumn contains an invalid column, or is not in proper syntax: {1}.

SSS_INVALID_SRCH_COLUMN_ An nlobjSearchColumn contains an invalid column join ID, or is not in proper syntax: {1}.
JOIN

SSS_INVALID_SRCH_COLUMN_ An nlobjSearchColumn contains an invalid column summary type, or is not in proper syntax:
SUM {1}.

SSS_INVALID_SRCH_FILTER An nlobjSearchFilter contains invalid search criteria: {1}.

SSS_INVALID_SRCH_FILTER_ An nlobjSearchFilter contains an invalid join ID, or is not in proper syntax: {1}.
JOIN

SSS_INVALID_SRCH_ An nlobjSearchFilter contains an invalid operator, or is not in proper syntax: {1}.

OPERATOR

SSS_INVALID_SUBLIST_ You have attempted an invalid sublist or line item operation. You are either trying to cannot
OPERATION access a field on a non-existent line or you are trying to add or remove lines from a static
sublist.

SSS_INVALID_SUBMIT_OPTION You have entered an invalid submit option for this record type: {1}

SSS_INVALID_TYPE_ARG You have entered an invalid type argument: {1}

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 371

Error Code Returned Long Description or Message

SSS_INVALID_UI_OBJECT_TYPE That operation is not supported for this type of UI object: {1}. It is only supported for type:
{2}.

SSS_INVALID_URL The URL must be a fully qualified HTTP or HTTPS URL if it is referencing a non-NetSuite
resource.

SSS_INVALID_URL_CATEGORY The URL category must be one of RECORD, TASKLINK or SUITELET.

SSS_INVALID_WF_RCRD_TYPE You have entered an invalid record type {1}. Workflow automation is not supported for this
type of record.

SSS_MEMORY_USAGE_ Script Out Of Memory.

EXCEEDED

SSS_MISSING_REQD_ {1}: Missing a required argument: {2}

ARGUMENT

SSS_QUEUE_LIMIT_EXCEEDED Script Queue Usage Limit Exceeded

SSS_RECORD_TYPE_MISMATCH The record you are attempting to load has a different type: {1} from the type specified: {2}.

SSS_REQUEST_LIMIT_ Request Limit Exceeded!

EXCEEDED

SSS_REQUEST_TIME_ The host you are trying to connect to is not responding or has exceeded the maximum
EXCEEDED allowed response time.

SSS_SCRIPT_DESERIA Scheduled Script deserialization failure

LIZATION_FAILURE

SSS_SEARCH_TIMEOUT Your search request has timed out. You may need to refine your search or combine the
results of multiple searches to achieve the desired result.

SSS_SSO_CONFIG_REQD The SuiteSignOn object {1} is not configured for use with this script. You must specify the
script as a connection point for this SuiteSignOn.

SSS_STACK_FRAME_DEPTH_ Script Stack Frame Depth Exceeded

EXCEEDED

SSS_TIME_LIMIT_EXCEEDED Script Execution Time Exceeded.

SSS_TRANS_IN_PROGRESS You cannot call nlapiBeginTransaction() because there is already a transaction in progress.

SSS_TRANSACTION_REQD That operation can only be performed when there is a transaction in progress

SSS_UNKNOWN_HOST The host you requested {1} is unknown or cannot be found.

SSS_USAGE_LIMIT_EXCEEDED Script Execution Usage Limit Exceeded

START_DATE_AFTER_END_DATE The start date must preceed the end date.

START_DATE_REQD Please enter a value for {1} Start Date

STATE_ALREADY_EXISTS A State/Province/County with the same name already exists.

STATE_REQD State is a required field and it cannot be null or empty.

STATUS_ASSIGNEE_REQD The issue status {1} does not define an assignee issue role. That status may not be used
until this is corrected.

STORAGE_LIMIT_EXCEEDED You entered a value that will exceed the internal storage limit of {1}. Please reduce the
number.

STORE_ALIAS_UNAVAILABLE The Store alias you chose "{1}" is already taken. Please go back and choose another.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 372

Error Code Returned Long Description or Message

STORE_DOMAIN_ The store domain name you chose '{1}' is already taken. Please go back and choose
UNAVAILABLE another.

SUB_MISMATCH Resources for Time and Material projects must be in the customer's subsidiary. The
following resources are in a different subsidiary: {1}

SUB_RESTRICT_VIEW_REQD Subsidiary Restrict View Required: You must first restrict your view to a subsidiary
before running this report (Home > Set Preferences ><a href="/app/center/userprefs.nl?
whence={1}">Restrict View</a>).

SUB_TAX_AGENCY_REQD No tax agency defined for subsidiary

SUBITEM_REQD You must first select the new subitems on the matrix tab you want to add.

SUBITEM_REQD You must first select the subitems on the matrix tab you want to create.

SUBSIDIARY_MISMATCH The employee and billable customer must be in the same subsidiary.

SUCCESS_TRANS The transaction was entered {1} successfully, {2}

SUPRT_CNTR_LOGIN_ERROR {1} Support Center login error: we are unable to find the customer record for account={2}

TAG_ALREADY_EXISTS That tag name is already being used. Please go back and rename it.

TAG_SUBSTITUTN_ERROR Error: Tag substitution loop encountered. Tag substitution sequence: {1}

TAG_SUBSTITUTN_ERROR Error: Tag substitution result is too large. Tag substitution sequence: {1}

TAGATA_ALREADY_ENDORSED The Receivable Tegata has already been endorsed.

TAX_ACCT_SETUP_REQD Tax Accounts Not Defined.

TAX_CODE_REQD No default tax code is defined for country {1}

TAX_CODES_SETUP_PROBLEM The tax codes haven't been set properly

TAX_CODES_SETUP_REQD Can't open store for {1}. This company does not have its tax codes fully set up. This is
required to properly calculate taxes on international, other-province and same-province
orders.

TAX_CODES_SETUP_REQD The company is not usable. Administrator hasn't set up the tax codes.

TAX_GROUP_SETUP_REQD You have not created tax groups in your NetSuite account. To ensure that your customers
are charged the correct amount of sales tax, you must create tax groups by entering them
manually at Lists > Accounting > Tax Groups > New.

TAX_PRD_REQD No Current Tax Period is defined. <a href='/app/setup/period/taxperiods.nl'>Click here</a>

to create a tax period.

TAX_SETUP_REQD The tax period range {1} has not been defined. Please visit '<A href='{2}'>Setup >
Accounting > Manage Tax Periods</A>' to define this period or set up your year.

TEMPLATE_NOT_FOUND Template not found

TEMPLATE_NOT_FOUND Template Record not found

THIRD_PARTY_BILLING_ACCT_ A 3rd Party Billing Account Number must be provided when selecting a 3rd Party Billing
REQD Type.

TICKET_NOT_LOCATED The ticket {1} cannot be located in the error database. If this is from a customer logged
case, the error may not yet be inserted into the system.

TIME_ENTRY_DISALLWD {1} does not allow time entry.

TIMEOUT_THE_RECORD_ Timeout: the record doesn't exist anymore.

DOESNT_EXIST_ANYMORE

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 373

Error Code Returned Long Description or Message

TOPIC_REQD You must select and add a topic to this solution.

TRAN_DATE_REQD Missing transaction date.

TRAN_LINE_FX_AMT_REQD Missing foreign currency amount on non-variance transaction line

TRAN_LINK_FX_AMT_REQD Missing foreign currency amount on non-variance transaction link

TRAN_PERIOD_CLOSED The action is causing generation of foreign exchange variance in a closed period. Please
retry with {1} as the exchange rate.

TRAN_PERIOD_CLOSED You are not allowed to change the revenue recognition status for one or more lines on this
transaction as it would impact a closed period.

TRAN_PERIOD_CLOSED You cannot change the G/L impact of a transaction in a closed period.

TRAN_PRD_CLOSED This action cannot be completed because it requires modification of the transaction in a
closed period due to foreign exchange variance. You may either open the period for this
transaction or use the same rate ({1})between the transactions that will be linked.

TRANS_ALREADY_REFUNDED Transaction Already refunded. A refund has already been performed on the transaction.

TRANS_ALREADY_SETTLED Transaction Already Settled. Void failed because transaction has already settled, submit
credit.

TRANS_ALREADY_VOIDED Transaction Already Voided. Void failed because transaction is already voided.

TRANS_AMTS_UNBALNCD Transaction is not in balance! amounts+taxes+shipping: {1}, total amount: {2}

TRANS_APPLIED_AMTS_ Transaction is not in balance! Total to apply of ${1} does not equal sum of applied ${2} and
UNBALNCD unapplied ${3}

TRANS_APPLIED_AMTS_ Transaction is not in balance! Total to apply of ${1} does not equal sum of payment ${2}
UNBALNCD and credits ${3} and deposits ${4}

TRANS_CLASS_UNBALNCD Transaction out of balance for class {1} total = {2}.

TRANS_DEPT_UNBALNCD Transaction out of balance for department {1} total = {2}.

TRANS_DOES_NOT_EXIST No transaction exists for that entity.

TRANS_DSNT_EXIST The transaction you are attempting to access does not exist.

TRANS_EDIT_DISALLWD This transaction is in a period that has been closed. You may not edit it.

TRANS_EDIT_DISALLWD You cannot edit this transaction. {1} does not support the imported transaction.

TRANS_FORGN_CRNCY_ Transaction and foreign currency account use different currencies.

MISMATCH

TRANS_FORGN_CUR_ Transaction was not in balance (Foreign currency). Posting total = {1}
UNBALNCD

TRANS_FORGN_CUR_ Transaction was not in balance (Foreign currency). Total = {1}

UNBALNCD

TRANS_IN_USE This transaction cannot be deleted because it is linked to by one or more

transactions. Click <a href='/app/accounting/transactions/payments.nl?
id={1}&label={2}&type={3}&alllinks=T'>here>/a> to see the list of linked transactions.

TRANS_LINE_AND_PMT_ Transaction is not in balance! Line item sum of ${1} not equal to payment amount ${2}
UNBALNCD

TRANS_LINES_UNBALNCD Transaction is not in balance! Line item sum of ${1} does not equal amount of ${2}

TRANS_LINES_UNBALNCD Transaction is not in balance! Line item sum of ${1} does not equal applied amount of ${2}

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 374

Error Code Returned Long Description or Message

TRANS_LOC_UNBALNCD Transaction out of balance for location {1} total = {2}.

TRANS_NOT_CLEANED Transaction not cleaned up.

TRANS_NOT_COMPLETED Transaction was not complete.

TRANS_PRCSSNG_ERROR Errors occurred while processing the selected transaction. Please process it individually for
more information.

TRANS_UNBALNCD The debits and credits are not balanced on this transaction because amounts entered
include more decimal places than are supported for this currency. Please round off the
amount of each line to a maximum of {1} decimal places.

TRANS_UNBALNCD Transaction is not in balance! {1}

TRANS_UNBALNCD Transaction is not in balance! {1},{2} othercount = {3}

TRANS_UNBALNCD Transaction out of balance for {1} {2} total = {3}.

TRANS_UNBALNCD Transaction was not in balance. Posting total = {1}

TRANS_UNBALNCD Transaction was not in balance. Total = {1}

TRANSACTION_DELETED The transaction you are attempting to access has been deleted.

TRANSORD_SHIP_REC_ You can not recieve more from a transfer order than you have shipped
MISMATCH

TWO_FA_AUTH_REQD All your other roles require a one-time key at login. Please click "Go Back" to enter a one-
time key or contact the company's administrator if you have questions.

TWO_FA_REQD Two-Factor Authentication required

UNABLE_TO_PRINT_CHECKS Unable to print checks.

UNABLE_TO_PRINT_DEPOSITS Unable to print deposits.

UNAUTH_CAMPAIGN_RSPNS_ Unauthorized campaign response request

RQST

UNAUTH_UNSUBSCRIBE_RQST Unauthorized unsubscribe request

UNDEFINED_ACCTNG_PRD The accounting period range {1} has not been defined. Please visit '<A href='/app/setup/
period/fiscalperiods.nl'>Setup > Accounting > Manage Accounting Periods</A>' to define
this period or set up your year.

UNDEFINED_ACCTNG_PRD The comparison accounting period range {1} has not been defined. Please visit '<A href='/
app/setup/period/fiscalperiods.nl'>Setup > Accounting > Manage Accounting Periods</A>'
to define this period or set up your year.

UNDEFINED_ACCTNG_PRD The default accounting period for this report has not been defined. Please visit '<A href='/
app/setup/period/fiscalperiods.nl'>Setup > Accounting > Manage Accounting Periods</A>'
to define this period or set up your year.

UNDEFINED_CSTM_FIELD Undefined customfield.

UNDEFINED_TAX_PRD The default tax period for this report has not been defined. Please visit '<A href='/app/
setup/period/taxperiods.nl'>Setup > Accounting > Manage Tax Periods</A>' to define this
period or set up your year.

UNEXPECTED_ERROR An error occurred while processing item options.

UNEXPECTED_ERROR An unexpected error has occurred.

UNEXPECTED_ERROR An unexpected error has occurred. A FedEx Shipping Label was not generated.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 375

Error Code Returned Long Description or Message

UNEXPECTED_ERROR An unexpected error has occurred while generating this content.Our Customer Support
staff have been notified and are looking into the problem.

UNEXPECTED_ERROR An unexpected error has occurred while synching a record. Click [OK] to skip the record
and continue.

UNEXPECTED_ERROR An unexpected error has occurred. NetSuite Customer Support has been alerted to this
problem.

UNEXPECTED_ERROR An unexpected error occurred while extracting email from SMTP server

UNEXPECTED_ERROR An unexpected error occurred while logging email request completion

UNEXPECTED_ERROR An unexpected error occurred while logging email request failure

UNEXPECTED_ERROR An unexpected error occurred while logging email request start

UNEXPECTED_ERROR An unexpected error occurred while processing the payment.

UNEXPECTED_ERROR An unexpected error occurred with the group SQL

UNEXPECTED_ERROR An Unexpected JavaScript Error has occurred

UNEXPECTED_ERROR Error

UNEXPECTED_ERROR Error: {1}

UNEXPECTED_ERROR Please specify an scompid

UNEXPECTED_ERROR Problem during commission calculation

UNEXPECTED_ERROR An unexpected error occurred.

UNEXPECTED_ERROR Dto java class is not defined for {1}.

UNEXPECTED_ERROR Server error: no dto class is defined for record of type {1}

UNEXPECTED_ERROR Server error: missing database entries in WSRecordElement and WSNameSpace table for
object of {1}

UNEXPECTED_ERROR Application error: no form request class is defined for record of type {1}

UNIQUE_CONTACT_NAME_ . Contact names must be unique

REQD

UNIQUE_CUST_EMAIL_REQD A customer record with this email address already exists. You must enter a unique
customer email address for each record you create.

UNIQUE_CUST_EMAIL_REQD A customer record with this email address already exists. You must enter a unique
customer email address for each record you create. To correct this record, click <a
href='javascript:history.go(-1);';>back</a> and enter a new customer email address in the
Customer field. Then, click Submit.

UNIQUE_CUST_ID_REQD A customer record with this ID already exists. You must enter a unique customer ID for
each record you create.

UNIQUE_CUST_ID_REQD A customer record with this ID already exists. You must enter a unique
customer ID for each record you create. To correct this record, click <a
href='javascript:history.go(-1);';>back</a> and enter a new customer ID in the Customer
field. Then, click Submit.

UNIQUE_ENTITY_NAME_REQD multiple sub-customers or jobs have name '{1}' which would create a naming conflict upon
merge. All names must be unique. Before merging, you must change one of the subs
named '{2}' to something else.

UNIQUE_GROUPID_REQD You must specify exactly one numeric groupId

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 376

Error Code Returned Long Description or Message

UNIQUE_PARTNER_CODE_ {1:name of partner record} Code "{2:partner code}" already exists. Please select a unique
REQD code for each record.

UNIQUE_QTY_REQD Quantities must be unique

UNIQUE_RCRD_ID_REQD A record with this ID already exists. You must enter a unique ID to create or update this
record.

UNIQUE_SOLUTION_CODE_ A solution with this particular solution code already exists. Please assign a different code.
REQD

UNITS_TYP_IN_USE This units type is used by {1} {2}. You must delete the {2} and all associated transactions to
delete this units type.

UNKNOWN_CARRIER Package Tracking is not available for id {1}. Unknown carrier.

UNKNOWN_RCRD_TYPE Unknown record type

UNKNOWN_SCRIPT_TYP Unknown Script Type

UNKNWN_ALLOCTN_SCHDUL_ Unable to determine allocation schedule frequency type.

FREQ_TYP

UNKNWN_EMAIL_AUTHOR The author of this email cannot be found.

UNKNWN_EXCHANGE_RATE Unable to determine the exchange rate for currency symbol {1}. Please create a currency
item with an exchange rate for this currency.

UNRECOGNIZED_METHOD unrecognized method '{1}'

UNSUBSCRIBE_REQD Unsubscribe is mandatory, please enter a value for this field.

UNSUPPORTED_METHOD Unsupported method

UNSUPPORTED_WS_VERSION TBA not supported in this SuiteTalk endpoint version

UNSUPRTD_DOC_TYP You attempted to upload an unsupported document type. Please try again with a selection
from the list below:

UPDATE_DISALLWD Update is not allowed

UPDATE_PRICE_AMT_REQD Please specify an amount to update prices.

UPGRADE_WS_VERSION Could not set '{1}' to field '{2}' of record number {3} due to schema enumeration restriction.

UPGRADE_WS_VERSION Please consider upgrading to endpoint {1}

UPGRADE_WS_VERSION Sales order <id {1}> contains item serial/lot numbers that are not supported in your client
application. You are not allowed to update serial/lot numbers on this sales order. Contact
your software vendor for the latest SOAP web services upgrade.

UPGRADE_WS_VERSION Sales order <id {1}> has items with more than one serial/lot numbers that is not supported
in your client application. The serial/lot numbers have been removed to successfully return
the sales order. Contact your software vendor for the latest SOAP web services upgrade.

UPGRADE_WS_VERSION This {1} has multiple {2}s. SOAP web services schema version {3} or greater is required to
modify {2} for this {1}

UPGRADE_WS_VERSION {1} {2} has multiple shipping routes enabled, which is only supported in version 2008_2 and
newer. The shipping information has been omitted to successfully return this record.

UPS_CANT_INTEGRATE_ The fulfillment cannot be integrated with UPS because the Shipping Integration Carrier is
FULFILL not set to UPS.

UPS_CONFIG_ERROR A UPS configuration error occured. Please contact tech support.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 377

Error Code Returned Long Description or Message

UPS_LICENSE_AGREEMNT_ You must agree to the UPS license agreement

REQD

UPS_ONLINE_RATE_ The UPS Online Realtime Rates System is temporarily unavailable. Please resubmit your rate
UNAVAILBL request in a few minutes.

UPS_ONLINE_RATE_ UPS did not return any rates for the specified origin and destination addresses.
UNAVAILBL

UPS_ONLINE_SHIP_ The UPS Online Shipping System is temporarily unavailable. Please resubmit your fulfillment
UNAVAILBL in a few minutes.

UPS_REG_NUM_IN_USE The submitted UPS Registration Number, {1}, is already in use. Please resubmit the
registration with a different UPS registration Number.

UPS_SETUP_REQD No UPS registration was found. Please register your UPS account with NetSuite before
attempting to send a fulfillment request to UPS.

UPS_VOID_ERROR The UPS Void failed due to a system failure.

UPS_XML_ERROR XML Sent to UPS. UPS returned error code/text:

URL_ID_PARAM_REQD URL is missing the id parameter. The file could not be retrieved.

URL_REQD You must enter a URL for this media item.

USER_CONTEXT_REQD User context is not set

USER_DISABLED user disabled

USER_ERROR Application ID mandatory but missing.

USER_ERROR An error occurred during your last update.

USER_ERROR A User Error Has Occurred

USER_ERROR Detach requires an AttachBasicReference

USER_ERROR Either internalId or externalId is required.

USER_ERROR Folder cannot be made a subfolder of itself.

USER_ERROR Gift Certificate From, Recipient Name, and Recipient Email are required.

USER_ERROR Invalid Attachment record combination

USER_ERROR Missing Item Weight or Weight Unit.

USER_ERROR Missing or Invalid RecordType for AttachTo

USER_ERROR Must submit a non-abstract instance of baseRef (eg RecordRef, CustomRecordRef) NOT a
baseRef

USER_ERROR Must submit a non-abstract instance of record or searchRecord (eg customer or

customerSearchBasic).

USER_ERROR No budget inserted or updated.

USER_ERROR {1}

USER_ERROR Please enter value(s) for: Company Name, Subsidiary

USPS_ACCT_NUM_ALREADY_ There is an existing NetSuite registration for Endicia account number {1}.
EXISTS

USPS_INVALID_INSURED_ Insured value exceeds the {1} maximum allowed by Endicia.

VALUE

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 378

Error Code Returned Long Description or Message

USPS_INVALID_PACKAGING The Carrier Packaging that you have selected is not valid for this item fulfillment.
 Usually this indicates the selected packaging cannot be used with the selected USPS
shipping method, or the package weight is invalid. Please check the documentation for
more details.

USPS_INVALID_PSWD The Endicia Web Password does not match the Web Password for this USPS Registration
account number.

USPS_LABEL_VOIDED This error required 1 or more labels created for this transaction to be voided at Endicia.

USPS_LABEL_VOIDED This error required 1 or more labels created for this transaction to be voided at
Endicia.

USPS_MAX_ITEM_EXCEEDED International USPS fulfillments allow a maximum of 5 unique items per package, due
to customs documentation. If more than one package is required, please break up the
shipment into multiple fulfillments.

USPS_ONE_PACKAGE_ALLWD International USPS fulfillments allow only one package. If more than one package is
required, please break up the shipment into multiple fulfillments of one package each.

USPS_PASS_PHRASE_NOT_ The Endica Pass Phrase was not updated: {1}

UPDATED

USPS_REFUND_FAILED Failed Endicia Refund Request

USPS_REFUND_FAILED The Endicia Refund Request failed due to a system error.

USPS_RETRY A response was not received for the USPS funding request. Please try again in a few
minutes.

USPS_VALIDATE_ADDR The address you entered could not be validated. Please verify the city, state, and/or zip
code. You can validate an address by visiting the <a href="http://zip4.usps.com/
zip4/welcome.jsp" target="_blank">U.S. Postal Service</a> web site, or the <a href="http://
www.endicia.com/Developers/ZipLookup/" target="_blank">Endicia</a> web site.

USPS_VERIFY_TRACKING_NUM Please verify that the following tracking numbers were created and voided in your Endicia
account before proceeding.

USPS_VOID_ERROR An error was detected during the Endicia Void operation:

USPS_VOID_ERROR An error was detected during the Endicia Void operation:

VALID_EMAIL_REQD Missing or invalid email address. Email address is a required field and it cannot be null or
empty. The email address must be in a valid format.

VALID_EMAIL_REQD_FOR_ Please enter a valid email address when granting login access privileges to this record.
LOGIN

VALID_FIRST_NAME_REQD Missing or invalid First Name. Users first name is a required field and cannot be null or
empty.

VALID_LAST_NAME_REQD Missing or invalid Last Name. Users last name is a required field and cannot be null or
empty.

VALID_LINE_ITEM_REQD You must have at least one valid line item for this transaction.

VALID_PHONE_NUM_REQD Missing or invalid Home phone number. The Home phone number is a required field and
it cannot be null or empty. The format of the Home phone number must contain area code
plus seven digit number.

VALID_PRD_REQD Insert Transaction Failure: No valid, open, posting period for date - {1}. Please visit Setup >
Manage Accounting Periods to set up a new accounting period.

VALID_PRD_REQD Insert Transaction Failure: No valid, open, tax period for date - {1}. Please visit Setup >
Manage Tax Periods to set up a new tax period.

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 379

Error Code Returned Long Description or Message

VALID_PRD_REQD Update Transaction Failure: No valid, open, {1} period for date - {2}

VALID_URL_REQD Please go back and provide a valid URL for all five fields on the External tab.

VALID_VERSION_REQD_IN_URL If the version parameter is passed through the URL, it MUST contain a valid version in a
phased release environment. Valid: {1}

VALID_WORK_PHONE_REQD Missing or invalid Work phone number. The Work phone number is a required field and it
cannot be null or empty. The format of the Work phone number must contain area code
plus seven digit number.

VALID_ZIPCODE_REQD Missing or invalid ZIP code field. ZIP code is a required field and it cannot be null or empty.
ZIP code and state values are checked against an internal database to make sure that ZIP
code specified exists in state specified.

VENDOR_TYPE_REQD No Vendor Type was specified. If creating a Tax Agency, please ensure that the vendor type
is active and marked as a tax agency.

VERIFY_DESTNTN_ZIP_CODE Please verify that the destination zipcode is correctly specified.

VERIFY_PAYROLL_FUND_ACCT The payroll funding account has not been verified. Please verify the payroll funding account

VERIFY_ZIP_CODE_SETUP Please verify that you have correctly set your zip code under setup company. If you have
multi-location enabled, verify that you have set a correct zipcode for each location.

VISA_ERROR Communication error with Visa. Please retry.

VOID_FAILED Void Failed. Failed to void transaction, retry void or issue credit.

VOIDING_REVERSAL_ You may not create a voiding reversal for transactions with inventory impact. To reverse the
DISALLWD inventory impact of the transaction, you will need to create an inventory adjustment.

VSOE_CANT_ADD_ITEM_ When the Is VSOE bundle box is checked, Items for Purchase cannot be added to
GROUP item groups.

VSOE_REV_REC_TMPLT_REQD All Lines in a VSOE Bundle with a VSOE Allocation must have a revenue recognition
template.

VSOE_TOTAL_ALLOCATION_ The total vsoe allocation in a bundle must equal the total bundle sales amount.
ERROR

VSOE_TRAN_VSOE_BUNDLE_ You have indicated that you would like this transaction to be treated as a Bundle (multi-
ERROR element arrangement) for VSOE purposes. Please either uncheck the 'Transaction Is
VSOE Bundle' checkbox or remove the Item Groups that have the 'Is VSOE Bundle' option
specified.

WF_EXEC_USAGE_LIMIT_ Workflow Execution Usage Limit Exceeded

EXCEEDED

WORK_DAYS_REQD Select one or more working days.

WORLDPAY_ERROR A failure occurred while attempting to connect to WorldPay.

WORLDPAY_ERROR There was a problem with your WorldPay credentials. Please be sure you are using the
correct combination of Installation ID, Merchant Code and XML Password

WRITE_OFF_ACCT_REQD To receive items without restocking, you must first set a value for the write-off account. To
set the value of the write-off account, go to Accounting > Accounting Preferences > Order
Management > Write-Off Account for Returns.

WS_CONCUR_SESSION_ Someone has logged in as this user from a different SOAP web services session. Only one
DISALLWD person may login as a particular user at a time. As a consequence, this session has been
terminated.

WS_CONCUR_SESSION_ Only one request may be made against a session at a time

DISALLWD

SuiteTalk SOAP Web Services Platform Guide

Error Status Codes 380

Error Code Returned Long Description or Message

WS_EXCEEDED_CONCUR_ You can have a maximum of {1} active concurrent WS users at a time in {2}
USERS_ALLWD

WS_FEATURE_REQD You have not enabled SOAP web services feature for your account.

WS_INVALID_SEARCH_ When using request-level credentials, you must use the {1} operation instead of {2}
OPERATN

WS_LOG_IN_REQD You must log in before performing a web service operation.

WS_PERMISSION_REQD You do not have permission to access SOAP web services feature.

WS_REQUEST_BLOCKED SuiteTalk concurrent request limit exceeded. Request blocked.

ZIP_FILE_CONTAINS_VIRUS The zip file contains a virus {1}. Upload abort.

Warning Status Codes

The code USER_ERROR is returned in the code field of the statusDetail type where the type attribute has
a value of warning. A warning message is also returned which varies depending on the exact cause of the
warning and is usually self-descriptive. For a complete description of warnings and how they differ from
errors and faults, refer to SOAP Web Services Warnings, Errors, and Faults.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Frequently Asked Questions (FAQ) 381

SOAP Web Services Frequently Asked

Questions (FAQ)
Where is the NetSuite WSDL located?
In general, the WSDL is located on the URL specific to your account. See the help topic URLs for Account-
Specific Domains for information about finding your account-specific URLs.

What programming languages and platforms are supported in this release?

This release should work with any platform or tool that supports SOAP 1.1. NetSuite has verified that
the Java Apache Axis and Microsoft .NET platforms work correctly, and sample programs for these
environments are available in the Resources section of the Web Services portal. Also note that there is a
PHP toolkit available for PHP developers wanting to build SOAP web services applications. See SOAP Web
Services PHP Toolkit for more details.

What is an internal ID (or nsKey)? What is a RecordRef? How do I get the values for
internal IDs?
An internal ID is a unique key used to reference a record within NetSuite. In SOAP web services, the
RecordRef type is used to abstract the internal ID. For example, a RecordRef is required to uniquely
identify the records for update, delete, or get operations. Also, a typical record exposed through SOAP
web services will have references to other NetSuite records of different types through the RecordRef type.

The internal ID for a record can be obtained as follows:

■ If a record type has been exposed through SOAP web services, a search operation will return the
internal ID.
■ Alternatively, you can also obtain the internal ID for that record in the UI on the list page for that
record type. In order to see the internal ID, go to Home > Set Preferences > General and select the
Show Internal IDs check box.

What are the maximum number of records allowed for write operations such as addList,
updateList, or deleteList?
This varies depending on whether records are submitted during peak or off-peak hours. For more
detailed information, see the section called Understanding Record Limiting in the NetSuite Help Center.

Why can't I maintain a valid session using Apache Axis?

The NetSuite SOAP web services implementation requires the client application to support multiple
cookies on one line, as is the standard for cookies. There is a bug in Apache Axis that puts each cookie on
its own line in the HTTP Headers. A patched version of the axis.jar can be downloaded from NetSuite Web
Services Developer's page to fix this problem. Please note that the patch you download depends on the
version of Axis that you are using. Replace the existing axis.jar file in the lib directory of your project with
the NetSuite version.

Why can't I maintain a valid session using Microsoft .NET?

The NetSuite SOAP web services implementation requires the client application to support multiple
cookies. Please see the .NET sample application for an example of how to enable support for multiple
cookies.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Frequently Asked Questions (FAQ) 382

I have populated some fields in a record when adding or updating, but why are these
fields not being populated in the SOAP document?
This is a .NET anomaly. For every field that's not of type string, the generated .NET object contains an
additional attribute whose name is the field name concatenated with the word "Specified". For example,
there is a Boolean field name called inactive in the Customer record type. When .NET generates this class,
it adds an additional Boolean field called inactiveSpecified. This field needs to be set to true for the inactive
field to be included in the SOAP document.

Can multiple users logged into the same account run SOAP web services simultaneously?
Yes. SOAP web services are associated to the user, NOT the account. Therefore, multiple users can access
the same account via SOAP web services. Also, a single user can have a concurrent browser and SOAP
web services session, and additional SOAP web services sessions for a certain user can exist for SOAP web
services partner applications.

Is it possible to run SOAP web services and XML independently and simultaneously within
an account without mutually exclusive restrictions?
There are currently no restrictions. However, to ensure adequate load distribution, the use of all NetSuite
integration technologies will be analyzed and restrictions implemented as appropriate.

How do I query for all records of a certain type?

Use the search operation with a search record that has no fields populated.

I get a SOAP fault and a message which states “The Operation has timed-out.” when using
my .Net client and I get no SOAP response back. What could be causing this?
If you have not explicitly set the timeout on your .Net application, this may be related to the preset
timeout of 100 seconds on the SoapHttpClientProtocol class. You must change this timeout to be
equal to or greater than the NetSuite timeout (15 minutes). Otherwise, your client will abort processing
prematurely.

Note: If you receive the same fault, or a service unavailable error which includes an HTTP error
code (for example, 50x), this is likely a NetSuite related timeout. Server restarts can occur, and if
you receive the HTTP 503 error code, you need to retry sending the request later.

Sample Code: .Net

public NSClient( )
{
_isAuthenticated = false;
_pageSize = 40;
// Instantiate the NetSuite web services
_service = new NetSuiteService();
// Set client timeout to 100 hours
_serice.timeout = 100*60*60*1000;

Sample Code: Java

// Locate the NetSuite web service.

NetSuiteServiceLocator service = new NetSuiteServiceLocator();
// Enable client cookie management. This is required.
service.setMaintainSession(true);
// Get the service port
_port = service.getNetSuitePort();
// Setting client timeout to 2 hours for long running operations
((NetSuiteBindingStub) _port).setTimeout(1000 * 60 * 60 * 2);

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Frequently Asked Questions (FAQ) 383

I am getting an unexpected server side protocol timeout error (502) and no SOAP
response is sent back. What could be causing this?
Check the timeout settings on any intermediaries that you are using — such as proxy servers or port
sniffers (SOAPScope).
To edit the timeout setting for SOAPScope, you need to edit the httpd.conf file to the desired settings
and then restart the SOAPScope service. The httpd.conf file is located in the conf subdirectory of the
SOAPScope data directory.

Note: There is a link to the SOAPScope data directory in the Start menu.

In the following code the default Timeout value of 300 has been changed to 901.

PidFile nul:
Timeout 901
KeepAlive On
MaxKeepAliveRequests 0
KeepAliveTimeout 15

Why do I receive socket timeout exception errors?

Networks are inherently unreliable, and a SocketTimeoutException can occur anytime. To handle
this error, you must implement a mechanism to keep sending your SOAP web services requests. For
information about setting up a retry mechanism, see Web Services and RESTlet Concurrency Governance.

Why are attachments uploaded with Messages getting corrupted?

This may be due to incorrectly encoding a file before sending it. The schema has a data type of
xsd:base64Binary which is mapped to a byte array in .NET and Axis (java). On the client side we only need
to pass a text or binary file as a byte array with no further base64 encoding. Therefore, do NOT Base64
Encode the file before sending it to Axis or .NET as these layers will do so themselves.

Sample Code:

■ Correct

--------
fis = new FileInputStream(inFile);
b = new byte[(int)inFile.length()];
fis.read(b);
myMediaItem.setContent(b);
--------

■ Incorrect

---------
fis = new FileInputStream(inFile);
b = new byte[(int)inFile.length()];
fis.read(b);
myMediaItem.setContent(new String(Base64.encode(b)));

How can I determine internal ID values for individual items in a custom list?
Generally, a certain list displays the internal IDs as one of the columns. For example, List > Relationships
> Customers displays the internal IDs as the second column (when the Show Internal ID preference is
enabled). In the NetSuite Help Center, see Setting the Show Internal IDs Preference for more details.
When referencing items in a custom list, you must first reference the SelectCustomFieldRef by its
internal ID, which is displayed in the respective custom field list (for example, for a custom customer field
it would be displayed at Customization > Lists, Records, & Fields > Entity Fields).

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Frequently Asked Questions (FAQ) 384

Next, reference the internal ID to the Custom List or Record. Internal IDs to custom lists are NOT
displayed in the UI. You must refer to the HTML source for the internal ID. When in the HTML source,
search for the name of the value and note the integer which follows. For example, if referring to the Items
of Interest custom list (provided in most test accounts) and need to select Monitors as one of the values,
view the HTML source in the browser and find that string:
Accessories1F[1]Computers3F[1] Monitors2 F[1]Peripherals4F

Note: The display order is in the order the values appear, but the internal IDs may be different.
Monitors in this case has a internal ID of 2.

If you are referring to a Record, you need to locate the internal ID displayed in the column of the
appropriate list.

When working with custom records, why do I need a separate CustomRecordRef class,
when even for creating a customRecord I have to instantiate the RecordRef type?
In general RecordRef is for get() and Record is for add(). We sometimes use RecordRef to store name/
value pairs.
RecordRef and CustomRecordRef both descend from BaseRef. They are most prominently used in
get(), and that is why they have a type attribute. CustomRecordRef has a typeId to indicate which kind
of CustomRecord it is. Therefore, you can NOT get a CustomRecord by setting the RecordRef.type to
customRecord on add — you must use CustomRecordRef to specify the kind of CustomRecord.
CustomRecord descends from Record, like Customer or Opportunity. This is what you submit to add() and
it is what is returned through search(). CustomRecord uses a RecordRef() to store its type information.
Java Example
To add a CustomRecord

CustomRecord myCR = new CustomRecord();

RecordRef rt = new RecordRef();
rt.setName("Authors");
rt.setId("3"); // This indicates a typeId of 3 and corresponds to the Authors CustomRecord type
myCR.setRecType(rt);
myCR.setName("Ernest Hemmingway"); // This is what will show up in List->
CustomRecords->Authors under Name
myCR.setCustomFieldList(myCFL); // An already filled out CustomField List
WriteResponse wr = port.add(myCR);

Note that setTypeId is not submitted since this is the internal ID returned by the response, like for normal
records.
To get a CustomRecord:

CustomRecordRef myCRR = new CustomRecordRef();

myCRR.setKey("1200"); // The key we got back
myCRR.setTypeId("3"); // For Authors
myCRR.setType(RecordType.customRecord);
ReadResponse rr = port.get(myCRR);

.Net Example
To add a CustomRecord

CustomRecord myCR = new CustomRecord();

RecordRef rt = new RecordRef();
rt.name = "Authors";
// This indicates a typeId of 3 and corresponds to the Authors CustomRecord type
rt.internalId = "3";
customRecord.recType = rt;
// This is what will show up in List->CustomRecords->Authors under Name

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Frequently Asked Questions (FAQ) 385

customRecord.name = "Ernest Hemingway";

customRecord.customFieldList = myCFL; // An already filled out CustomField List
WriteResponse wr = port.add(customRecord);

To get a CustomRecord:

CustomRecordRef myCRR = new CustomRecordRef();

myCRR.internalId = "1200"; // The key we got back
myCRR.typeId = "3"; // For Authors
ReadResponse rr = _service.get(myCRR);

How can I set multiple fields' values to NULL when using the PHP toolkit?
You can set values to NULL by submitting the fields in nullFieldList. The following example sets the fax and
phone field to NULL.

// Include NetSuite Class Library

require_once '../PHPToolkit/NetSuiteService.php';

// Instantiate new service

$service = new NetSuiteService();

// Create contact record

$ctact = new Contact();

// Set up record fields

$aBook = array (
"addressbook" => array(
array(
"defaultBilling" => true,
"defaultShipping" => false,
"addr1" => $_POST['bill_addr1'],
"city" => $_POST['bill_city'],
"state" => $_POST['bill_state'],
"zip" => $_POST['bill_zip'] ),
array( "defaultBilling" => false,
"defaultShipping" => true,
"addr1" => $_POST['ship_addr1'],
"city" => $_POST['ship_city'],
"state" => $_POST['ship_state'],
"zip" => $_POST['ship_zip'] )));

// Use setFields to fill the contact record with the fields

setFields($ctact, array("addressbookList"=>$aBook));

// Create NullField record

$nfl = new NullField();

// Set the null fields in the record

setFields($nfl, array("name" => array( "fax","phone")));
setFields($ctact, array("internalId" => "87", "nullFieldList" => $nfl));

// Update the contact record

$response = $service->update($ctact);

Why do I not get data for all elements on a search for a certain record type?
When performing searches on records, by default only the body fields are returned.
For example, if a Get or GetList operation against a customer record is submitted, the addressbooklist
element contains data but if a Search operation against a customer record is submitted, the
addressbooklist element is un-defined.

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Frequently Asked Questions (FAQ) 386

To return field values for all lists on a record, you must set the bodyFieldsOnly element of the
searchPreferences type to false. It is recommended that the default settings are used wherever list values
are not necessary since this significantly improves performance.

Note: You can perform quick and full searches as the same time. For example, to show a list of
email folders, but only query for messages in the default folder, do a quick search to get folder
names/keys, and a full search on all messages.

Does SOAP web services support double-byte character sets like those used in Japanese
and Korean?
The WSDL itself is only in English, but data can be in any language that uses UTF-8 character encoding,
including those that use double-byte character sets.

Why are some classes from the NetSuite WSDL not being generated?
If you are using Java, to generate unreferenced types you should set the all parameter in your axis-
wsdl2java ant task to true. For example:

<axis-wsdl2java timeout="120000" output="${generated.src.dir}" verbose="true" url="${wsdl-1.3.url}" al

l="true" wrapArrays="true">

What is the process flow for using SOAP web services asynchronous calls?
The process flow for using WS asynchronous calls is as follows:

1. Make the desired asynchronous call defined in NetSuitePortType – asyncAddList, asyncUpdateList,

asyncDeleteList, asyncGetList, asyncSearch.
A job ID is returned.
2. Call the checkAsyncStatus method with the job ID as the parameter. The returned object,
AsyncStatusResult, encapsulates the object AsyncStatusType, which indicates the status of the
asynchronous job. The defined statuses are failed, finishedWithErrors, pending, processing, and
finished.
This step may iterate until the desired status is reached. Alternatively, navigate to Setup >
Integration > SOAP Web Services Process Status to obtain the status information.
3. Call the getAsyncResult method with the job ID and page index as the parameters. The returned
object AsyncResult contains the result of each record on which the asynchronous job operated.

Note: AsyncResult is an abstract type; hence one of its concrete subclasses AsyncAddListResult,
AsyncDeleteListResult, AsyncGetListResult, AsyncSearchResult, AsyncUpdateListResult – is
returned.

Are SOAP web services samples available for different development platforms?
The NetSuite SOAP web services implementation is designed to work with any development platform that
is able to generate SOAP messages. We provide Java and C# sample applications, which are available for
download in our SuiteTalk portal (http://www.netsuite.com/portal/developers/resources/suitetalk.shtml).

SuiteTalk SOAP Web Services Platform Guide

SOAP Web Services Frequently Asked Questions (FAQ) 387

You may also find useful community-based developer assistance at the web services forum in the
NetSuite Usergroup.

Can I use SOAP web services with my sandbox account?

Please note that the URL for the WSDL differs between your production account and your sandbox
account. If you want to use SOAP web services with your sandbox account you will need to use the
following URL:

https://<accountID>-sb1.suitetalk.netsuite.com

Note: Provide your own account ID in your SOAP web services request.

Where can I download the current version of the WSDL?

The NetSuite SOAP WSDL provides a complete description of available services, operations, and messages
for SOAP web services.

To download the current version of the WSDL:

1. Navigate to http://www.netsuite.com/portal/developers/resources/suitetalk-documentation.shtml
2. Click View Zipped.

For additional information, see the following areas in the the NetSuite Help Center:

■ Release Notes – Describes all changes in the newest release, including an overview of platform
enhancements and a list of newly exposed records.
■ Platform Guide – Offers an overview of the NetSuite SOAP web services architecture. Includes a
"Getting Started" section for users of both C# and Java.
■ Records Guide – Features detailed reference pages on all supported records.

For downloadable versions of Help Center documentation, see the help topic User Guides.

SuiteTalk SOAP Web Services Platform Guide

Teamcenter 13.1 Teamcenter Basics
100% (2)
Teamcenter 13.1 Teamcenter Basics
386 pages
Dameware Server Administrator Guide
No ratings yet
Dameware Server Administrator Guide
64 pages
861 PeopleCode API Reference
No ratings yet
861 PeopleCode API Reference
3,364 pages
CP R80.30 Installation and Upgrade Guide - Cleaned PDF
No ratings yet
CP R80.30 Installation and Upgrade Guide - Cleaned PDF
688 pages
Oracle SuperCluster M7+M8 Security
No ratings yet
Oracle SuperCluster M7+M8 Security
138 pages
Oracle Fusion Applications Human Capital Management Reference Manual
No ratings yet
Oracle Fusion Applications Human Capital Management Reference Manual
710 pages
HCM 9.2 - Administer Workforce
No ratings yet
HCM 9.2 - Administer Workforce
1,892 pages
Functional Upgrade Guide
No ratings yet
Functional Upgrade Guide
318 pages
r12 SCM Open Interfaces and APIs
50% (2)
r12 SCM Open Interfaces and APIs
1,680 pages
Symantec DLP 12.0 Admin Guide PDF
100% (1)
Symantec DLP 12.0 Admin Guide PDF
1,472 pages
Juniper - Premium.JN0-220.by .VCEplus.26q
No ratings yet
Juniper - Premium.JN0-220.by .VCEplus.26q
14 pages
Suite8 Data Dictionary 8.10.0
No ratings yet
Suite8 Data Dictionary 8.10.0
499 pages
HCIA Security H12-711
100% (1)
HCIA Security H12-711
43 pages
8118 28 Im WLANHandsetInstallation 8AL90832ENAA 2 en
No ratings yet
8118 28 Im WLANHandsetInstallation 8AL90832ENAA 2 en
47 pages
Oracle JDeveloper 11g Handbook: A Guide to Fusion Web Development
From Everand
Oracle JDeveloper 11g Handbook: A Guide to Fusion Web Development
Duncan Mills
No ratings yet
Oracle Exadata Database Service Cloudcustomer
No ratings yet
Oracle Exadata Database Service Cloudcustomer
1,152 pages
Chagwa V1.0: Allowing Change, Agile and Waterfall Projects in the Organisation
From Everand
Chagwa V1.0: Allowing Change, Agile and Waterfall Projects in the Organisation
Jurgen van Gorp
No ratings yet
Om API
No ratings yet
Om API
1,600 pages
Job Data Modernization Red Paper
100% (1)
Job Data Modernization Red Paper
60 pages
Mysql Errors 9.2 en
No ratings yet
Mysql Errors 9.2 en
610 pages
Cisco Prime Document PDF
No ratings yet
Cisco Prime Document PDF
376 pages
SA3 Summative Reviewer
No ratings yet
SA3 Summative Reviewer
6 pages
Managing User Accounts and User Environments in Oracle Solaris 11.4
No ratings yet
Managing User Accounts and User Environments in Oracle Solaris 11.4
46 pages
Licensing Information User Manual Oracle Server x9 2
No ratings yet
Licensing Information User Manual Oracle Server x9 2
59 pages
Oracle® Advanced Support Gateway: User's Guide
No ratings yet
Oracle® Advanced Support Gateway: User's Guide
140 pages
Virtual Desktop Infrastructure
No ratings yet
Virtual Desktop Infrastructure
368 pages
Oracle® Service Contracts: User Guide Release 12
No ratings yet
Oracle® Service Contracts: User Guide Release 12
534 pages
01 System Administration Guide Basic
No ratings yet
01 System Administration Guide Basic
464 pages
F5 LTM Lab Manual-1 PDF
No ratings yet
F5 LTM Lab Manual-1 PDF
82 pages
Sun ZFS Storage 7000 System Administration Guide: Part No: 820-4167-13 Rev. A November 2010
No ratings yet
Sun ZFS Storage 7000 System Administration Guide: Part No: 820-4167-13 Rev. A November 2010
430 pages
Implementing SSL / TLS Using Cryptography and PKI
From Everand
Implementing SSL / TLS Using Cryptography and PKI
Joshua Davies
No ratings yet
Adapters
No ratings yet
Adapters
280 pages
ArcMC AdminGuide 2 92
No ratings yet
ArcMC AdminGuide 2 92
343 pages
Authenticationguide
No ratings yet
Authenticationguide
231 pages
BRM Configuring and Running Billing
No ratings yet
BRM Configuring and Running Billing
342 pages
Integration Interfaces
No ratings yet
Integration Interfaces
170 pages
Netsuite Manufacturing
No ratings yet
Netsuite Manufacturing
173 pages
BRM Configuring and Collecting Payments
No ratings yet
BRM Configuring and Collecting Payments
258 pages
Hcm92ecih b012023
No ratings yet
Hcm92ecih b012023
186 pages
Oracle® Fusion Middleware: Release Notes For Oracle Business Intelligence 11 Release 1 (11.1.1)
No ratings yet
Oracle® Fusion Middleware: Release Notes For Oracle Business Intelligence 11 Release 1 (11.1.1)
182 pages
115 HZRG
No ratings yet
115 HZRG
318 pages
Hcm92eawh b012023
No ratings yet
Hcm92eawh b012023
172 pages
Oracle® Common Application Components: API Reference Guide Release 11i
No ratings yet
Oracle® Common Application Components: API Reference Guide Release 11i
174 pages
Netsuite FixedAssetsManagement
No ratings yet
Netsuite FixedAssetsManagement
155 pages
NetSuiteOneWorld Guide
No ratings yet
NetSuiteOneWorld Guide
139 pages
Oracle® Service Contracts: Implementation Guide Release 12
No ratings yet
Oracle® Service Contracts: Implementation Guide Release 12
134 pages
Working With Oracle Solaris 11.4 Directory and Naming Services: LDAP
No ratings yet
Working With Oracle Solaris 11.4 Directory and Naming Services: LDAP
144 pages
How To Make Bootable Pen-Drive For Solaris 11
No ratings yet
How To Make Bootable Pen-Drive For Solaris 11
136 pages
NetSuite OneWorld Guide
No ratings yet
NetSuite OneWorld Guide
132 pages
Implementing+Cisco+SD WAN+Solutions+ (SDWAN300) +v1
100% (1)
Implementing+Cisco+SD WAN+Solutions+ (SDWAN300) +v1
500 pages
Oracle® Clusterware: Installation Guide 11g Release 1 (11.1) For Microsoft Windows
No ratings yet
Oracle® Clusterware: Installation Guide 11g Release 1 (11.1) For Microsoft Windows
106 pages
Managing File Systems in Oracle Solaris 11.4
No ratings yet
Managing File Systems in Oracle Solaris 11.4
94 pages
Financial Statements Guide
No ratings yet
Financial Statements Guide
78 pages
Integrated SOA Gateway Users Guide
No ratings yet
Integrated SOA Gateway Users Guide
120 pages
Handbook of Mobile Application Development: A Guide to Selecting the Right Engineering and Quality Features
From Everand
Handbook of Mobile Application Development: A Guide to Selecting the Right Engineering and Quality Features
Mohamed Sarrab
No ratings yet
LICENSE36353635635
No ratings yet
LICENSE36353635635
3 pages
Template - Product Launch Checklist
No ratings yet
Template - Product Launch Checklist
35 pages
Slide e Filing e BE Form 2021 YA 2021 ENG
No ratings yet
Slide e Filing e BE Form 2021 YA 2021 ENG
84 pages
Oracle Advanced Support Gateway Security Guide: Part No: E40643-49
No ratings yet
Oracle Advanced Support Gateway Security Guide: Part No: E40643-49
74 pages
Using Oracle SQL Developer Web PDF
No ratings yet
Using Oracle SQL Developer Web PDF
66 pages
Heaven Sent Me
From Everand
Heaven Sent Me
Mary Jinkens
No ratings yet
Netsuite FinancialStatementsGuide
No ratings yet
Netsuite FinancialStatementsGuide
78 pages
Ps Fluid Grids Standards Rev1
No ratings yet
Ps Fluid Grids Standards Rev1
41 pages
Connector CPP 9.0 En.a4
No ratings yet
Connector CPP 9.0 En.a4
54 pages
Dell XC630-10 Nutanix On VMware ESXi Reference Architecture
No ratings yet
Dell XC630-10 Nutanix On VMware ESXi Reference Architecture
51 pages
IBM MQ GUI Wizard Help: Version 9 Release 0
No ratings yet
IBM MQ GUI Wizard Help: Version 9 Release 0
40 pages
Introduction To Apache Kafka and Its Setup
No ratings yet
Introduction To Apache Kafka and Its Setup
29 pages
AI Agents Made Easy: Build Your Digital Workforce with No-Code Tools
From Everand
AI Agents Made Easy: Build Your Digital Workforce with No-Code Tools
Barron Wilson
No ratings yet
Tib Amx BPM Install
No ratings yet
Tib Amx BPM Install
66 pages
Dao Tao Chung Chi Bao Mat Fortigate FCA - Study Guide
No ratings yet
Dao Tao Chung Chi Bao Mat Fortigate FCA - Study Guide
32 pages
Multiple Application Integration Guide: Oracle ATG One Main Street Cambridge, MA 02142 USA
No ratings yet
Multiple Application Integration Guide: Oracle ATG One Main Street Cambridge, MA 02142 USA
34 pages
Nextcloud Manual
No ratings yet
Nextcloud Manual
81 pages
Safely Accessing Website
No ratings yet
Safely Accessing Website
24 pages
All NL All The Day
No ratings yet
All NL All The Day
74 pages
Java Se Subscription Enterprise Performance Pack Users Guide
No ratings yet
Java Se Subscription Enterprise Performance Pack Users Guide
15 pages
Cisco Anyconnect Posture With Asa, Ise and Amp V1.1: About This Demonstration
No ratings yet
Cisco Anyconnect Posture With Asa, Ise and Amp V1.1: About This Demonstration
29 pages
Test Lab Guide: Deploying An AD CS Two-Tier PKI Hierarchy
No ratings yet
Test Lab Guide: Deploying An AD CS Two-Tier PKI Hierarchy
22 pages
Database Notes
No ratings yet
Database Notes
23 pages
Ameya Yamini Linear Regression Doc
No ratings yet
Ameya Yamini Linear Regression Doc
15 pages
Best Practices For A Tools Only Upgrade
No ratings yet
Best Practices For A Tools Only Upgrade
35 pages
PCO 15.2 Security Guide
No ratings yet
PCO 15.2 Security Guide
26 pages
Bevager Vendor Import SPM
No ratings yet
Bevager Vendor Import SPM
7 pages
Netsuite CopyToAccount
No ratings yet
Netsuite CopyToAccount
16 pages
Using Security Certificates On Yealink IP Phones
No ratings yet
Using Security Certificates On Yealink IP Phones
24 pages
SW 7 0 ISE Configuration Guide DV 1 0
No ratings yet
SW 7 0 ISE Configuration Guide DV 1 0
16 pages
OutSystems Platform - Enterprise Cloud Technical Specifications
No ratings yet
OutSystems Platform - Enterprise Cloud Technical Specifications
20 pages
Chat
No ratings yet
Chat
2 pages
PSR User Guide
No ratings yet
PSR User Guide
10 pages
Dovecot and Postfix Client Certificate Authentication - Mortikia Blog
No ratings yet
Dovecot and Postfix Client Certificate Authentication - Mortikia Blog
3 pages
Oracle® Exadata Storage Server Hardware: Read This First 11 Release 2 (11.2)
No ratings yet
Oracle® Exadata Storage Server Hardware: Read This First 11 Release 2 (11.2)
2 pages
Deer Transport L.L.C
No ratings yet
Deer Transport L.L.C
1 page
OA Framework Beginners Guide
From Everand
OA Framework Beginners Guide
Sudhakar Mani
No ratings yet
Salesforce Certified Tableau Architect Dumps
No ratings yet
Salesforce Certified Tableau Architect Dumps
21 pages
Oracle Technology Network License Agreement For Oracle Java SE
No ratings yet
Oracle Technology Network License Agreement For Oracle Java SE
1 page