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

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.

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.

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:

• accountingContext. At least one Accounting Context must exist in your account for this field to be available.

• acctNumber. The Use Account Numbers accounting preference must be enabled for this field to be available.

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

• get operations on the account record return only lines that have null values for the accountingContext and acctNumber fields.

• You cannot set values for the accountingContext and acctNumber fields in the localization sublist.

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> 

        

General Notices