{"_id":"5b19742cb3baf90003cab504","category":{"_id":"5b19742cb3baf90003cab4ec","version":"5b19742cb3baf90003cab5ae","project":"57336fd5a6a9c40e00e13a0b","__v":0,"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-05-12T15:22:00.041Z","from_sync":false,"order":4,"slug":"coupon","title":"Catalog"},"parentDoc":null,"project":"57336fd5a6a9c40e00e13a0b","user":"560d5913af97231900938124","version":{"_id":"5b19742cb3baf90003cab5ae","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5adf4e59ac13b80003d23152","createdAt":"2018-04-24T15:33:45.744Z","releaseDate":"2018-04-24T15:33:45.744Z","categories":["5b19742cb3baf90003cab4e8","5b19742cb3baf90003cab4e9","5b19742cb3baf90003cab4ea","5b19742cb3baf90003cab4eb","5b19742cb3baf90003cab4ec","5b19742cb3baf90003cab4ed","5b19742cb3baf90003cab4ee","5b19742cb3baf90003cab4ef","5b19742cb3baf90003cab4f0","5b19742cb3baf90003cab4f1","5b19742cb3baf90003cab4f2"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"3.26 Release","version_clean":"8976.0.0-Extended","version":"8976-Extended"},"githubsync":"","__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-06-29T19:38:20.083Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"method":"get","results":{"codes":[]},"settings":"","auth":"optional","params":[],"url":""},"isReference":true,"order":6,"body":"##Definition\nhttps<span>://sandbox.bluesnap.com/services/2/skus/:sku-id/merchant-price/resolve?{ip|currency|quantity|storeid|country|state}\n</span>\n\n<hr>\n\n##Documentation\nThe Retrieve SKU Price request enables you to retrieve the price of an existing SKU in your account. This service supports currency conversion.\n\n###Request Content\nEnter the `sku-id` and the relevant parameter into the web service URL, in the format:\n`services/2/skus/{sku-id}/merchant-price/resolve?{ip|currency|quantity|storeid|country|state}`\n\nFor example:\n`services/2/skus/987654/merchant-price/resolve?currency=USD`\n<br>\n**Query Parameters** \n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Parameter Name\",\n    \"h-1\": \"Description\",\n    \"h-2\": \"Example\",\n    \"0-0\": \"**country**\",\n    \"0-1\": \"Country of the shopper. This will resolve the currency and the tax.\",\n    \"0-2\": \"`country=fr`\",\n    \"1-0\": \"**currency**\",\n    \"1-1\": \"Currency in which to retrieve the price. It will be converted from the base currency.\",\n    \"1-2\": \"`currency=USD`\",\n    \"2-0\": \"**ip**\",\n    \"2-1\": \"IP of the shopper to assist in identifying the geo-location of the shopper.\",\n    \"2-2\": \"`ip=93.174.104.49`\",\n    \"3-0\": \"**quantity**\",\n    \"4-0\": \"**state**\",\n    \"5-0\": \"**storeid**\",\n    \"3-1\": \"Quantity in the order. This will be multiplied by the price for a single item in order to get the total price.\",\n    \"3-2\": \"`quantity=4`\",\n    \"4-2\": \"`state=MA`\",\n    \"5-2\": \"`storeid=1234`\",\n    \"4-1\": \"State of the shopper, to resolve the currency and the tax. US states only.\"\n  },\n  \"cols\": 3,\n  \"rows\": 6\n}\n[/block]\n###Response Details\nIf successful, the response HTTP status code is 200 OK.\nThe response contains the retrieved `item-price` resource (see [item-price](doc:item-price)).\nFor details about possible errors, see: [General Errors](doc:general-errors) and [Catalog Errors](doc:catalog-errors).\n\n<hr>\n\n##Examples\n\n###Request Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -v -X GET https://sandbox.bluesnap.com/services/2/skus/2180474/merchant-price/resolve?country=fr \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='\",\n      \"language\": \"curl\",\n      \"name\": \"Retrieve SKU Price Request: with country\"\n    },\n    {\n      \"code\": \"curl -v -X GET https://sandbox.bluesnap.com/services/2/skus/2180474/merchant-price/resolve?currency=USD \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='\",\n      \"language\": \"curl\",\n      \"name\": \"with currency\"\n    },\n    {\n      \"code\": \"curl -v -X GET https://sandbox.bluesnap.com/services/2/skus/2180474/merchant-price/resolve?ip=93.174.104.49 \\\\\\n-H 'Content-Type: application/xml' \\\\\\n-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ='\",\n      \"language\": \"curl\",\n      \"name\": \"with IP\"\n    }\n  ]\n}\n[/block]\n###Response Examples\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\"?>\\n<item-price xmlns=\\\"http://ws.plimus.com\\\">\\n  <store-id>12700</store-id>\\n  <quantity>1</quantity>\\n  <unit-price>\\n    <charge-price>\\n      <charge-type>initial</charge-type>\\n      <value>21.82</value>\\n      <currency>EUR</currency>\\n      <formatted-price>\\n        <iso>EUR 21.82</iso>\\n        <symbol>€21.82</symbol>\\n      </formatted-price>\\n      <tax-included>false</tax-included>\\n    </charge-price>\\n    <charge-price>\\n      <charge-type>recurring</charge-type>\\n      <value>0.00</value>\\n      <currency>EUR</currency>\\n      <formatted-price>\\n        <iso>EUR 0.00</iso>\\n        <symbol>€0.00</symbol>\\n      </formatted-price>\\n      <tax-included>false</tax-included>\\n    </charge-price>\\n  </unit-price>\\n  <total-price>\\n    <charge-price>\\n      <charge-type>initial</charge-type>\\n      <value>21.82</value>\\n      <currency>EUR</currency>\\n      <formatted-price>\\n        <iso>EUR 21.82</iso>\\n        <symbol>€21.82</symbol>\\n      </formatted-price>\\n      <tax-included>false</tax-included>\\n    </charge-price>\\n    <charge-price>\\n      <charge-type>recurring</charge-type>\\n      <value>0.00</value>\\n      <currency>EUR</currency>\\n      <formatted-price>\\n        <iso>EUR 0.00</iso>\\n        <symbol>€0.00</symbol>\\n      </formatted-price>\\n      <tax-included>false</tax-included>\\n    </charge-price>\\n  </total-price>\\n  <total-price-with-tax>\\n    <charge-price>\\n      <charge-type>initial</charge-type>\\n      <value>26.09</value>\\n      <currency>EUR</currency>\\n      <formatted-price>\\n        <iso>EUR 26.09</iso>\\n        <symbol>€26.09</symbol>\\n      </formatted-price>\\n      <tax-included>false</tax-included>\\n    </charge-price>\\n    <charge-price>\\n      <charge-type>recurring</charge-type>\\n      <value>0.00</value>\\n      <currency>EUR</currency>\\n      <formatted-price>\\n        <iso>EUR 0.00</iso>\\n        <symbol>€0.00</symbol>\\n      </formatted-price>\\n      <tax-included>false</tax-included>\\n    </charge-price>\\n  </total-price-with-tax>\\n  <tax>4.28</tax>\\n  <tax-recurring>0.00</tax-recurring>\\n  <tax-rate>19.6</tax-rate>\\n  <country>fr</country>\\n</item-price>\",\n      \"language\": \"xml\",\n      \"name\": \"Retrieve SKU Response: country\"\n    },\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\"?>\\n<item-price xmlns=\\\"http://ws.plimus.com\\\">\\n  <store-id>12700</store-id>\\n  <quantity>1</quantity>\\n  <unit-price>\\n    <charge-price>\\n      <charge-type>initial</charge-type>\\n      <value>30.00</value>\\n      <currency>USD</currency>\\n      <formatted-price>\\n        <iso>USD 30.00</iso>\\n        <symbol>$30.00</symbol>\\n      </formatted-price>\\n      <tax-included>false</tax-included>\\n    </charge-price>\\n    <charge-price>\\n      <charge-type>recurring</charge-type>\\n      <value>0.00</value>\\n      <currency>USD</currency>\\n      <formatted-price>\\n        <iso>USD 0.00</iso>\\n        <symbol>$0.00</symbol>\\n      </formatted-price>\\n      <tax-included>false</tax-included>\\n    </charge-price>\\n  </unit-price>\\n  <total-price>\\n    <charge-price>\\n      <charge-type>initial</charge-type>\\n      <value>30.00</value>\\n      <currency>USD</currency>\\n      <formatted-price>\\n        <iso>USD 30.00</iso>\\n        <symbol>$30.00</symbol>\\n      </formatted-price>\\n      <tax-included>false</tax-included>\\n    </charge-price>\\n    <charge-price>\\n      <charge-type>recurring</charge-type>\\n      <value>0.00</value>\\n      <currency>USD</currency>\\n      <formatted-price>\\n        <iso>USD 0.00</iso>\\n        <symbol>$0.00</symbol>\\n      </formatted-price>\\n      <tax-included>false</tax-included>\\n    </charge-price>\\n  </total-price>\\n  <total-price-with-tax>\\n    <charge-price>\\n      <charge-type>initial</charge-type>\\n      <value>30.00</value>\\n      <currency>USD</currency>\\n      <formatted-price>\\n        <iso>USD 30.00</iso>\\n        <symbol>$30.00</symbol>\\n      </formatted-price>\\n      <tax-included>false</tax-included>\\n    </charge-price>\\n    <charge-price>\\n      <charge-type>recurring</charge-type>\\n      <value>0.00</value>\\n      <currency>USD</currency>\\n      <formatted-price>\\n        <iso>USD 0.00</iso>\\n        <symbol>$0.00</symbol>\\n      </formatted-price>\\n      <tax-included>false</tax-included>\\n    </charge-price>\\n  </total-price-with-tax>\\n  <tax>0.00</tax>\\n  <tax-recurring>0.00</tax-recurring>\\n  <tax-rate>0</tax-rate>\\n</item-price>\",\n      \"language\": \"xml\",\n      \"name\": \"currency\"\n    },\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\"?>\\n<item-price xmlns=\\\"http://ws.plimus.com\\\">\\n  <store-id>12700</store-id>\\n  <quantity>1</quantity>\\n  <unit-price>\\n    <charge-price>\\n      <charge-type>initial</charge-type>\\n      <value>21.82</value>\\n      <currency>EUR</currency>\\n      <formatted-price>\\n        <iso>EUR 21.82</iso>\\n        <symbol>€21.82</symbol>\\n      </formatted-price>\\n      <tax-included>false</tax-included>\\n    </charge-price>\\n    <charge-price>\\n      <charge-type>recurring</charge-type>\\n      <value>0.00</value>\\n      <currency>EUR</currency>\\n      <formatted-price>\\n        <iso>EUR 0.00</iso>\\n        <symbol>€0.00</symbol>\\n      </formatted-price>\\n      <tax-included>false</tax-included>\\n    </charge-price>\\n  </unit-price>\\n  <total-price>\\n    <charge-price>\\n      <charge-type>initial</charge-type>\\n      <value>21.82</value>\\n      <currency>EUR</currency>\\n      <formatted-price>\\n        <iso>EUR 21.82</iso>\\n        <symbol>€21.82</symbol>\\n      </formatted-price>\\n      <tax-included>false</tax-included>\\n    </charge-price>\\n    <charge-price>\\n      <charge-type>recurring</charge-type>\\n      <value>0.00</value>\\n      <currency>EUR</currency>\\n      <formatted-price>\\n        <iso>EUR 0.00</iso>\\n        <symbol>€0.00</symbol>\\n      </formatted-price>\\n      <tax-included>false</tax-included>\\n    </charge-price>\\n  </total-price>\\n  <total-price-with-tax>\\n    <charge-price>\\n      <charge-type>initial</charge-type>\\n      <value>26.18</value>\\n      <currency>EUR</currency>\\n      <formatted-price>\\n        <iso>EUR 26.18</iso>\\n        <symbol>€26.18</symbol>\\n      </formatted-price>\\n      <tax-included>false</tax-included>\\n    </charge-price>\\n    <charge-price>\\n      <charge-type>recurring</charge-type>\\n      <value>0.00</value>\\n      <currency>EUR</currency>\\n      <formatted-price>\\n        <iso>EUR 0.00</iso>\\n        <symbol>€0.00</symbol>\\n      </formatted-price>\\n      <tax-included>false</tax-included>\\n    </charge-price>\\n  </total-price-with-tax>\\n  <tax>4.36</tax>\\n  <tax-recurring>0.00</tax-recurring>\\n  <tax-rate>20</tax-rate>\\n  <country>nl</country>\\n</item-price>\",\n      \"language\": \"xml\",\n      \"name\": \"IP\"\n    }\n  ]\n}\n[/block]\n<br>\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>","excerpt":"","slug":"retrieve-sku-price","type":"endpoint","title":"Retrieve SKU Price"}

Extended Payment API

Orders

Shopping Context

Shoppers

Catalog

Subscriptions

Wallets

Errors

Resources

Test Data & Codes

Guides & Tools

getRetrieve SKU Price

Definition

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

Documentation

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

Retrieve SKU Price Request: with country
with currency
with IP
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

Retrieve SKU Response: country
currency
IP
<?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>