Skip to main content

​
Overview

Retrieve the current localized price for a given SKU in a specific sales channel and currency. This endpoint returns both the localized prices (in destination currency) and the merchant currency prices (in your foreign currency).

​
Get SKU Price

Retrieve the current price for a SKU in a sales channel and currency. 
curl -X GET 'https://product.api.e-cross.tech/ext/skus/12345678901/validPrice?salesChannel=ECOM&currency=BRL' \
  -H 'Authorization: Bearer YOUR_TOKEN'

{
  "id": "ACME-12345678901-ECOM",
  "merchantId": "ACME",
  "skuId": "12345678901",
  "skuName": "Black T-Shirt",
  "merchantCurrency": "USD",
  "localizedCurrency": "BRL",
  "localizationTimestamp": "2024-11-14T12:01:29.363Z",
  "grossOutboundListPrice": 13.64,
  "grossOutboundSalePrice": 11.27,
  "grossOutboundListPriceWithTaxes": 13.64,
  "grossOutboundSalePriceWithTaxes": 11.27,
  "localizedListPriceWithTaxes": 75,
  "localizedSalePriceWithTaxes": 62
}

​
Path Parameters

​
skuId
string
required
Identifier of the SKU (the SKU_ID used to create the SKU).

​
Query Parameters

​
salesChannel
string
required
The identifier of the sales channel (e.g., ECOM).
​
currency
string
required
The local currency code of the sales channel’s country (e.g., BRL for Brazil, USD for United States).

​
Response Fields

​
id
string
required
The unique identifier of the SKU price record within e-CROSS.
​
merchantId
string
required
The unique identifier of the merchant in the e-CROSS platform.
​
skuId
string
required
The SKU identifier.
​
skuName
string
required
The title of the SKU in the original language.
​
merchantCurrency
string
required
The merchant currency (your foreign currency).
​
localizedCurrency
string
required
The localized price currency (destination country currency).
​
localizationTimestamp
string
required
The timestamp when this localization occurred, in ISO 8601 format.
​
grossOutboundListPrice
number
required
The value in your merchant foreign currency that is the basis for the promotional price for the localized price.
​
grossOutboundSalePrice
number
required
The estimated value in your merchant foreign currency that will be the payout value after each unit sold.
​
grossOutboundListPriceWithTaxes
number
required
The value in your merchant foreign currency that is the basis for the promotional price with all taxes and duties included. This value differs from grossOutboundListPrice when the destination sales channel doesn’t calculate taxes and duties online and such values are embedded in the product price.
​
grossOutboundSalePriceWithTaxes
number
required
The value in your merchant foreign currency that represents the final retail price with taxes and duties included. This value differs from grossOutboundSalePrice when the destination sales channel doesn’t calculate taxes and duties online and such values are embedded in the product price.
​
localizedListPriceWithTaxes
number
required
The value in the localizedCurrency that represents the final promotional value for the sales channel.
​
localizedSalePriceWithTaxes
number
required
The value in the localizedCurrency that represents the final retail value for the sales channel.
Use this endpoint to verify the current prices for your SKUs in specific sales channels and understand how your origin prices have been localized.

Update Inventory

Next: Learn how to update SKU inventory levels