Fair Value Price

The fair value price record is part of the Advanced Revenue Management (Revenue Allocation) feature. The FairValuePrice complex type is defined in the Accounting XSD.

Before you can use SOAP web services to create fair value price records, you must have enabled the Advanced Revenue Management (Revenue Allocation) feature. You must also have added a formula for calculating a fair value price. For general information about the Advanced Revenue Management (Revenue Allocation) feature, see Advanced Revenue Management (Essentials) and (Revenue Allocation). For details about the fair value price record, see Fair Value Setup.

Configuration of advanced revenue management is complex. You should engage NetSuite Professional Services or a NetSuite partner to assist with your implementation.

Supported Operations

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 fair value price reference page.

Note:

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

Usage Notes

In the following example, a fair value price record is updated with new values.

Java

              public void FairValuePrice() throws Exception {

        RecordRef currencyRef = new RecordRef();
        currencyRef.setInternalId("1");

        FairValuePrice fairValue = new FairValuePrice();
        fairValue.setInternalId("1");
        fairValue.setExternalId("FairValue_001");
        fairValue.setCurrency(currencyRef);
        fairValue.setFairValueFormula(FairValueFormula);
        fairValue.setFairValue(new Double("200"));
        fairValue.setLowValuePercent(new Double("80"));
        fairValue.setHighValuePercent(new Double("115"));

        c.updateRecord(FairValue);

    }

SOAP Request

             <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:applicationInfo soapenv:actor="http://schemas.xmlsoap.org/soap/actor/next" soapenv:mustUnderstand="0" xmlns:ns1="urn:messages_2017_1.platform.webservices.netsuite.com">               
            <ns1:applicationId>APPLICATIONS_ID</ns1:applicationId>           
         </ns1:applicationInfo>           
         <ns2:passport soapenv:actor="http://schemas.xmlsoap.org/soap/actor/next" soapenv:mustUnderstand="0" xmlns:ns2="urn:messages_2017_1.platform.webservices.netsuite.com">               
            <ns3:email xmlns:ns3="urn:core_2017_1.platform.webservices.netsuite.com">EMAIL</ns3:email>               
            <ns4:password xmlns:ns4="urn:core_2017_1.platform.webservices.netsuite.com">PASSWORD</ns4:password>               
            <ns5:account xmlns:ns5="urn:core_2017_1.platform.webservices.netsuite.com">ACCOUNT_ID</ns5:account>               
            <ns6:role internalId="37" xmlns:ns6="urn:core_2017_1.platform.webservices.netsuite.com"/>           
         </ns2:passport>       
      </soapenv:Header>       
      <soapenv:Body>           
         <update xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">               
            <record externalId="FairValue_001" internalId="1" xsi:type="ns7:FairValuePrice" xmlns:ns7="urn:accounting_2017_1.lists.webservices.netsuite.com">                   
               <ns7:fairValue xsi:type="xsd:double">200.0</ns7:fairValue>                   
               <ns7:currency internalId="1" xsi:type="ns8:RecordRef" xmlns:ns8="urn:core_2017_1.platform.webservices.netsuite.com"/>                   
               <ns7:lowValuePercent xsi:type="xsd:double">85.0</ns7:lowValuePercent>                   
               <ns7:highValuePercent xsi:type="xsd:double">115.0</ns7:highValuePercent>               
            </record>           
         </update>       
      </soapenv:Body>   
   </soapenv:Envelope>

SOAP Response

             <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_xxxxxx_xxxxxxxxxxxxxxxxx_xxxxxxxxx</platformMsgs:nsId>
         </platformMsgs:documentInfo>
      </soapenv:Header>
      <soapenv:Body>
         <updateResponse xmlns="urn:messages_2017_1.platform.webservices.netsuite.com">
            <writeResponse>
               <platformCore:status isSuccess="true" xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com"/>
               <baseRef internalId="1" externalId="FairValue_001" type="fairValuePrice" xsi:type="platformCore:RecordRef" xmlns:platformCore="urn:core_2017_1.platform.webservices.netsuite.com"/>
            </writeResponse>
         </updateResponse>
      </soapenv:Body>
   </soapenv:Envelope>