Retrieve SKU Price

Definition

https://sandbox.bluesnap.com/services/2/skus/:sku-id/merchant-price/resolve?{ip|currency|quantity|storeid|country|state}

The Retrieve SKU Price request enables you to retrieve the price of an existing SKU in your account. This service supports currency conversion.

Request Content

Enter the sku-id and the relevant parameter into the web service URL, in the format:
services/2/skus/{sku-id}/merchant-price/resolve?{ip|currency|quantity|storeid|country|state}

For example:
services/2/skus/987654/merchant-price/resolve?currency=USD

Query Parameters

Parameter Name	Description	Example
country	Country of the shopper. This will resolve the currency and the tax.	`country=fr`
currency	Currency in which to retrieve the price. It will be converted from the base currency.	`currency=USD`
ip	IP of the shopper to assist in identifying the geo-location of the shopper.	`ip=93.174.104.49`
quantity	Quantity in the order. This will be multiplied by the price for a single item in order to get the total price.	`quantity=4`
state	State of the shopper, to resolve the currency and the tax. US states only.	`state=MA`
storeid		`storeid=1234`

Response Details

If successful, the response HTTP status code is 200 OK.
The response contains the retrieved item-price resource (see item-price).
For details about possible errors, see: General Errors and Catalog Errors.

Examples

Request Examples

curl -v -X GET https://sandbox.bluesnap.com/services/2/skus/2180474/merchant-price/resolve?country=fr \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='

curl -v -X GET https://sandbox.bluesnap.com/services/2/skus/2180474/merchant-price/resolve?currency=USD \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='

curl -v -X GET https://sandbox.bluesnap.com/services/2/skus/2180474/merchant-price/resolve?ip=93.174.104.49 \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='

Response Examples

<?xml version="1.0" encoding="UTF-8"?>
<item-price xmlns="http://ws.plimus.com">
  <store-id>12700</store-id>
  <quantity>1</quantity>
  <unit-price>
    <charge-price>
      <charge-type>initial</charge-type>
      <value>21.82</value>
      <currency>EUR</currency>
      <formatted-price>
        <iso>EUR 21.82</iso>
        <symbol>€21.82</symbol>
      </formatted-price>
      <tax-included>false</tax-included>
    </charge-price>
    <charge-price>
      <charge-type>recurring</charge-type>
      <value>0.00</value>
      <currency>EUR</currency>
      <formatted-price>
        <iso>EUR 0.00</iso>
        <symbol>€0.00</symbol>
      </formatted-price>
      <tax-included>false</tax-included>
    </charge-price>
  </unit-price>
  <total-price>
    <charge-price>
      <charge-type>initial</charge-type>
      <value>21.82</value>
      <currency>EUR</currency>
      <formatted-price>
        <iso>EUR 21.82</iso>
        <symbol>€21.82</symbol>
      </formatted-price>
      <tax-included>false</tax-included>
    </charge-price>
    <charge-price>
      <charge-type>recurring</charge-type>
      <value>0.00</value>
      <currency>EUR</currency>
      <formatted-price>
        <iso>EUR 0.00</iso>
        <symbol>€0.00</symbol>
      </formatted-price>
      <tax-included>false</tax-included>
    </charge-price>
  </total-price>
  <total-price-with-tax>
    <charge-price>
      <charge-type>initial</charge-type>
      <value>26.09</value>
      <currency>EUR</currency>
      <formatted-price>
        <iso>EUR 26.09</iso>
        <symbol>€26.09</symbol>
      </formatted-price>
      <tax-included>false</tax-included>
    </charge-price>
    <charge-price>
      <charge-type>recurring</charge-type>
      <value>0.00</value>
      <currency>EUR</currency>
      <formatted-price>
        <iso>EUR 0.00</iso>
        <symbol>€0.00</symbol>
      </formatted-price>
      <tax-included>false</tax-included>
    </charge-price>
  </total-price-with-tax>
  <tax>4.28</tax>
  <tax-recurring>0.00</tax-recurring>
  <tax-rate>19.6</tax-rate>
  <country>fr</country>
</item-price>

<?xml version="1.0" encoding="UTF-8"?>
<item-price xmlns="http://ws.plimus.com">
  <store-id>12700</store-id>
  <quantity>1</quantity>
  <unit-price>
    <charge-price>
      <charge-type>initial</charge-type>
      <value>30.00</value>
      <currency>USD</currency>
      <formatted-price>
        <iso>USD 30.00</iso>
        <symbol>$30.00</symbol>
      </formatted-price>
      <tax-included>false</tax-included>
    </charge-price>
    <charge-price>
      <charge-type>recurring</charge-type>
      <value>0.00</value>
      <currency>USD</currency>
      <formatted-price>
        <iso>USD 0.00</iso>
        <symbol>$0.00</symbol>
      </formatted-price>
      <tax-included>false</tax-included>
    </charge-price>
  </unit-price>
  <total-price>
    <charge-price>
      <charge-type>initial</charge-type>
      <value>30.00</value>
      <currency>USD</currency>
      <formatted-price>
        <iso>USD 30.00</iso>
        <symbol>$30.00</symbol>
      </formatted-price>
      <tax-included>false</tax-included>
    </charge-price>
    <charge-price>
      <charge-type>recurring</charge-type>
      <value>0.00</value>
      <currency>USD</currency>
      <formatted-price>
        <iso>USD 0.00</iso>
        <symbol>$0.00</symbol>
      </formatted-price>
      <tax-included>false</tax-included>
    </charge-price>
  </total-price>
  <total-price-with-tax>
    <charge-price>
      <charge-type>initial</charge-type>
      <value>30.00</value>
      <currency>USD</currency>
      <formatted-price>
        <iso>USD 30.00</iso>
        <symbol>$30.00</symbol>
      </formatted-price>
      <tax-included>false</tax-included>
    </charge-price>
    <charge-price>
      <charge-type>recurring</charge-type>
      <value>0.00</value>
      <currency>USD</currency>
      <formatted-price>
        <iso>USD 0.00</iso>
        <symbol>$0.00</symbol>
      </formatted-price>
      <tax-included>false</tax-included>
    </charge-price>
  </total-price-with-tax>
  <tax>0.00</tax>
  <tax-recurring>0.00</tax-recurring>
  <tax-rate>0</tax-rate>
</item-price>

<?xml version="1.0" encoding="UTF-8"?>
<item-price xmlns="http://ws.plimus.com">
  <store-id>12700</store-id>
  <quantity>1</quantity>
  <unit-price>
    <charge-price>
      <charge-type>initial</charge-type>
      <value>21.82</value>
      <currency>EUR</currency>
      <formatted-price>
        <iso>EUR 21.82</iso>
        <symbol>€21.82</symbol>
      </formatted-price>
      <tax-included>false</tax-included>
    </charge-price>
    <charge-price>
      <charge-type>recurring</charge-type>
      <value>0.00</value>
      <currency>EUR</currency>
      <formatted-price>
        <iso>EUR 0.00</iso>
        <symbol>€0.00</symbol>
      </formatted-price>
      <tax-included>false</tax-included>
    </charge-price>
  </unit-price>
  <total-price>
    <charge-price>
      <charge-type>initial</charge-type>
      <value>21.82</value>
      <currency>EUR</currency>
      <formatted-price>
        <iso>EUR 21.82</iso>
        <symbol>€21.82</symbol>
      </formatted-price>
      <tax-included>false</tax-included>
    </charge-price>
    <charge-price>
      <charge-type>recurring</charge-type>
      <value>0.00</value>
      <currency>EUR</currency>
      <formatted-price>
        <iso>EUR 0.00</iso>
        <symbol>€0.00</symbol>
      </formatted-price>
      <tax-included>false</tax-included>
    </charge-price>
  </total-price>
  <total-price-with-tax>
    <charge-price>
      <charge-type>initial</charge-type>
      <value>26.18</value>
      <currency>EUR</currency>
      <formatted-price>
        <iso>EUR 26.18</iso>
        <symbol>€26.18</symbol>
      </formatted-price>
      <tax-included>false</tax-included>
    </charge-price>
    <charge-price>
      <charge-type>recurring</charge-type>
      <value>0.00</value>
      <currency>EUR</currency>
      <formatted-price>
        <iso>EUR 0.00</iso>
        <symbol>€0.00</symbol>
      </formatted-price>
      <tax-included>false</tax-included>
    </charge-price>
  </total-price-with-tax>
  <tax>4.36</tax>
  <tax-recurring>0.00</tax-recurring>
  <tax-rate>20</tax-rate>
  <country>nl</country>
</item-price>