Deposit Application

A deposit application transaction applies a customer deposit against an invoice after the order is complete.

For details about this type of transaction, see Applying a Customer Deposit.

The deposit application record is defined in tranCust (customers) XSD.

Supported Operations

add | addList | delete | deleteList | get | getDeleted | getList | getSavedSearch | getSelectValue | initialize / initializeList | 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 deposit application reference page.

Note:

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

Usage Notes

Initializing Deposit Applications

You can initialize a Deposit Application from a Customer Deposit.

The SOAP web services initialize operation emulates the UI workflow by prepopulating fields on transaction line items with values from a related record. For more information about this operation, see initialize / initializeList.

Initializing Deposit Applications from Customer Deposits

For NetSuite accounts with multiple A/R accounts, the InitializeAuxRefType arAccount parameter can be used to specify an A/R account a deposit application record is initialized from a customer deposit record. The returned record contains lines that correspond to the specified A/R account.

The arAccount parameter is defined in InitializeAuxRefType in the coreTypes XSD.

For information about working with the customer deposit record in the UI, see Customer Deposits. For information about working with customer deposit records in SOAP web services, see Customer Deposit.

The following example shows the initialization of a deposit application from a customer deposit:

Java

          DepositApplication da = (DepositApplication)c.initialize(new InitializeRef(null, InitializeRefType.customerDeposit, "1506", null), InitializeType.depositApplication, new InitializeAuxRef(null, InitializeAuxRefType.arAccount, "9", null));

System.out.println(da.getArAcct());

da.getApplyList().getApply(0).setApply(true);

c.addRecord(da); 

        

SOAP Request

          <soapenv:Body>
        <initialize xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
            <initializeRecord>
                <ns9:type xmlns:ns9="urn:core_2017_1.platform.webservices.netsuite.com">depositApplication</ns9:type>
                <ns10:reference type="customerDeposit" internalId="1506" xmlns:ns10="urn:core_2017_1.platform.webservices.netsuite.com"/>
                <ns11:auxReference type="arAccount" internalId="9" xmlns:ns11="urn:core_2017_1.platform.webservices.netsuite.com"/>
            </initializeRecord>
        </initialize>
    </soapenv:Body> 

        

SOAP Response

          <soapenv:Body>
        <initializeResponse 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 xsi:type="tranCust:DepositApplication" xmlns:tranCust="urn:customers_2017_1.transactions.webservices.netsuite.com">
                    <tranCust:createdDate>2016-11-07T09:35:00.000-08:00</tranCust:createdDate>
                    <tranCust:lastModifiedDate>2016-11-07T09:35:00.000-08:00</tranCust:lastModifiedDate>
                    <tranCust:arAcct internalId="9" xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com">
                        <platformCore:name>11200 Delinquent Accounts</platformCore:name>
                    </tranCust:arAcct>
                    <tranCust:status>Not Deposited</tranCust:status>
                    <tranCust:customer internalId="87" xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com">
                        <platformCore:name>Abe Simpson</platformCore:name>
                    </tranCust:customer>
                    <tranCust:tranDate>2016-11-07T00:00:00.000-08:00</tranCust:tranDate>
                    <tranCust:postingPeriod internalId="288" xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com">
                        <platformCore:name>Nov 2016</platformCore:name>
                    </tranCust:postingPeriod>
                    <tranCust:deposit internalId="1506" xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com">
                        <platformCore:name>Customer Deposit #1</platformCore:name>
                    </tranCust:deposit>
                    <tranCust:total>222.0</tranCust:total>
                    <tranCust:applied>0.0</tranCust:applied>
                    <tranCust:unapplied>222.0</tranCust:unapplied>
                    <tranCust:tranId>To Be Generated</tranCust:tranId>
                </record>
            </readResponse>
        </initializeResponse>
    </soapenv:Body> 

        

Related Topics

General Notices