Go to full article

Overview

This API allows a provider to update / expire a price point against a product in a pricing book.

Updating a Price Point

To update a price point:

1. Create a "UpdatePricePoint" request
2. Provide the following mandatory inputs
   1. Product ID
   2. Saleable To

 The below inputs are optional and can be provided as per defined business rules

1. Pricing Book ID (otherwise, the price point will be added to your default price book)
2. Minimum Quantity (otherwise, zero will be stamped as default minimum quantity)
3. Notify Upon Paid Purchase

Business Rules

• Mandatory fields (Product ID, Saleable To) must be present
• Data types must be verified for inputs whose data type is supposed to be other than String (e.g. integer, float, boolean, date etc.)
• Product ID must be valid (should exist in Emersion database)
• Product must be owned by the caller account
• Pricing book ID (if provided) must be valid  (should exist in Emersion database)
• Pricing book ID (if provided) must be owned by the calling provider

Return Value: In case of success, the ID of the updated / expired price point will be returned to the caller

SOAP Example

Request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:emersion:api">
   <soapenv:Header/>
   <soapenv:Body>
      <urn:UpdatePricePointRequest>
         <urn:ProductID>1704263</urn:ProductID>
         <!--Optional:-->
         <urn:PricingBookID>100219</urn:PricingBookID>
         <!--Optional:-->
         <urn:MinimumQuantity>1</urn:MinimumQuantity>
         <urn:SaleableTo>2019-03-11</urn:SaleableTo>
         <!--Optional:-->
         <urn:NotifyUponPurchase>false</urn:NotifyUponPurchase>
      </urn:UpdatePricePointRequest>
   </soapenv:Body>
</soapenv:Envelope>

Response:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:emersion:api">
   <SOAP-ENV:Body>
      <ns1:UpdatePricePointResponse>
         <ns1:PricePointID>17972712</ns1:PricePointID>
      </ns1:UpdatePricePointResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>