1. SuiteCloud Platform
  2. SuiteTalk Web Services
  3. SuiteTalk SOAP Web Services Records Guide
  4. Lists
  5. Account

Account

One of the first tasks you must complete before you can begin managing accounting in NetSuite is to set up a chart of accounts (COA).

For information about working with accounts in the UI, see Chart of Accounts Management.

The account record is defined in the listAcct (accounting) XSD.

Supported Operations

The following operations can be used with the account record.

add | addList | delete | deleteList | get | getList | getSavedSearch | getSelectValue | search | update | updateList | upsert | upsertList

Note:

You can also use the asynchronous equivalents of SOAP web services list operations. For information about asynchronous operations, see SOAP Web Services Asynchronous Operations. For more information about request processing, see Synchronous Versus Asynchronous Request Processing.

Field Definitions

The SOAP Schema Browser includes definitions for all body fields, sublist fields, search filters, and search joins available to this record. For details, see the SOAP Schema Browser’s account reference page.

Note:

For information on using the SOAP Schema Browser, see SOAP Schema Browser.

Note:

The unit and unitstype fields are used only for statistical accounts, not other types of accounts. For general details on statistical accounts, see Statistical Accounting Overview.

Usage Notes

Currently there are no available search joins for this record.

In the 2020.2 and later endpoints, when you set the Use Account Numbers preference, the name field only includes the account name, and not the account number. When Use Account Numbers is not set, both name and displayName display only the account name. Endpoints 2020.1 and older are not affected.

SOAP Endpoint Version

Use Account Numbers = True

Use Account Numbers = False

name

displayName

name

displayName

2021.1

Account Name

Account Number + Account Name

Account Name

Account Name

2020.2

Account Name

Account Number + Account Name

Account Name

Account Name

2020.1 and older

Account Number + Account Name

—

Account Name

—

Saved search results that use the Name field now only display the Account Name, and not the Account Number and the Account Name.

If your integration uses the Search operation for an Account search and requires the Account Name to include the Account Number in the search results, you need to change the Name field (id: "name") to the Display Name field (id: "displayname"), before using your integration with the 2020.2 or later endpoints.

For information about the effect of the Use Account Numbers preference in the UI, see General Accounting Preferences.

Certain Fields are Available for OneWorld Accounts Only

The following fields are available for OneWorld accounts only:

Be aware of the following limitations for these fields in 2016.1 and earlier endpoints:

Get Response

The following snippet shows a SOAP response to a get request on the account record.

          <listAcct:localizationsList>
   <listAcct:accountLocalizations>
      <listAcct:accountingContext internalId="2" xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com">
         <platformCore:name>European Accounting Context</platformCore:name>
      </listAcct:accountingContext>
      <listAcct:acctName>France</listAcct:acctName>
        <listAcct:locale>_frenchFrance</listAcct:locale>
   </listAcct:accountLocalizations>
      <listAcct:accountLocalizations>
      <listAcct:acctName>Germany</listAcct:acctName>
      <listAcct:locale>_german</listAcct:locale>
   </listAcct:accountLocalizations>
</listAcct:localizationsList>

Java Update Request

The following Java snippet uses the acctContext field in an update request.

          Account account = new Account();

account.setInternalId("161");
AccountLocalizationsList accountLocalizationsList = new AccountLocalizationsList();
AccountLocalizations[] accountLocalizations = {new AccountLocalizations()};
accountLocalizations[0].setLocale(Language._russian);
accountLocalizations[0].setAcctName("Office Expenses");
RecordRef acctContext = new RecordRef();
acctContext.setInternalId("1");
accountLocalizations[0].setAccountingContext(acctContext);
accountLocalizationsList.setAccountLocalizations(accountLocalizations);
account.setLocalizationsList(accountLocalizationsList);

c.updateRecord(account);

Update Request

The following SOAP snippet uses the acctContext field in an update request.

          <update xmlns="urn:messages_2017_1.platform.webservices.netsuite.com>
      <record internalId="161" xsi:type="ns8:Account" xmlns:ns8="urn:accounting_2017_1.lists.webservices.netsuite.com">
         <ns8:localizationsList replaceAll="false" xsi:type="ns8:AccountLocalizationsList">    
            <ns8:accountLocalizations xsi:type="ns8:AccountLocalizations">    
               <ns8:accountingContext internalId="1" xsi:type="ns9:RecordRef" xmlns:ns9="urn:core_2017_1.platform.webservices.netsuite.com"/>
                <ns8:acctName xsi:type="xsd:string">Office Expenses</ns8:acctName>     
                <ns8:locale xsi:type="ns10:Language" xmlns:ns10="urn:types.common_2017_1.platform.webservices.netsuite.com">_russian</ns8:locale>
            </ns8:accountLocalizations>   
         </ns8:localizationsList>  
      </record>
</update>

Related Topics

General Notices