Update SKU Price

Update product prices using origin or destination pricing models

Overview

Update prices for individual SKUs using one of two pricing models:

• Origin Pricing: Define prices in your foreign currency, and e-CROSS automatically localizes them for all connected sales channels
• Destination Pricing: Define prices in the destination country’s currency with all operational fees included

Update e-CROSS as soon as possible after SKU price changes to minimize the time it takes to reflect in sales channels, as each sales channel front-end has different caching mechanisms.

Pricing Models

Origin Pricing

Use origin pricing when you define prices in your foreign currency. e-CROSS will automatically localize these prices for each connected sales channel.

Update SKU Price (Origin)

cURL

curl -X POST 'https://product.api.e-cross.tech/ext/prices/origin/1234567891' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "listPrice": 30.00,
    "salePrice": 30.00
  }'

Success

{
  "status": "LOCALIZATION IN PROGRESS",
  "publishedCount": 1,
  "publishedSkus": [
    "1234567891"
  ],
  "failedCount": 0,
  "failedSkus": [],
  "merchantId": "ACME"
}

Request Parameters

skuId · string · required

Identifier of the SKU (the SKU_ID used to create the SKU).

listPrice · number

The value in your foreign currency that will be localized into the “crossed” price in the local currency of connected sales channels. Use this when you want to apply a price promotion. In the product card, it will display as: “R$ 250,00 200,00”.

salePrice · number · required

The value in your foreign currency that will be localized into the final retail price in the local currency of connected sales channels. This is the payout value for each sale, meaning the amount that will be paid to you for each unit sold after the conciliation cycle.

Response Fields

status · string · required

Status of the localization process. Can be LOCALIZATION IN PROGRESS (queued) or ERROR (error in request).

publishedCount · integer · required

The number of price localization requests that were queued. In origin pricing, if there are 3 sales channels connected, then 3 localization requests will be queued.

publishedSkus · array · required

Array of SKU IDs that were queued to be localized.

failedCount · integer · required

The number of price localization requests that failed.

failedSkus · array · required

Array of SKU IDs that failed to be queued for localization.

merchantId · string · required

The merchant ID of this localization context.

Destination Pricing

Use destination pricing when you define prices as they must be sold in connected sales channels, meaning already in the local sales channel’s country currency and including all operational fees.

Update SKU Price (Destination)

cURL

curl -X POST 'https://product.api.e-cross.tech/ext/prices/destination/1234567891' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "salesChannel": "ECOM",
    "country": "BR",
    "listPrice": 30.00,
    "salePrice": 30.00
  }'

Success

{
  "status": "LOCALIZATION IN PROGRESS",
  "publishedCount": 1,
  "publishedSkus": [
    "1234567891"
  ],
  "failedCount": 0,
  "failedSkus": [],
  "merchantId": "ACME"
}

Request Parameters

skuId · string · required

Identifier of the SKU (the SKU_ID used to create the SKU).

salesChannel · string · required

Identifier of the destination sales channel (e.g., ECOM).

country · string · required

Identifier of the destination sales channel’s country (e.g., BR for Brazil).

listPrice · number

The value in the destination country currency that represents the “crossed” price. Use this when you want to apply a price promotion in the sales channel. In the product card, it will display as: “R$ 250,00 200,00”.

salePrice · number · required

The value in the destination country currency that will be the final retail price in the sales channel. This is the final price and will be integrated with the sales channel as-is.

Response Fields

status · string · required

Status of the localization process. Can be LOCALIZATION IN PROGRESS (queued) or ERROR (error in request).

publishedCount · integer · required

The number of price localization requests that were queued.

publishedSkus · array · required

Array of SKU IDs that were queued to be localized.

failedCount · integer · required

The number of price localization requests that failed.

failedSkus · array · required

Array of SKU IDs that failed to be queued for localization.

merchantId · string · required

The merchant ID of this localization context.

e-CROSS will perform “reverse localization” of the destination price to estimate the payout value for each sale. This is only an estimate because the real payout value will be calculated based on the checkout value of orders.

How It Works

1. Origin Pricing: You send prices in your currency → e-CROSS localizes for each sales channel → Final retail prices are calculated automatically
2. Destination Pricing: You send final retail prices in destination currency → e-CROSS performs reverse localization → Estimated payout values are calculated

Price updates are processed asynchronously. The API performs online validation and queues the price localization to be processed. Changes may take some time to reflect in sales channels due to caching mechanisms.

Get SKU Price

Next: Learn how to retrieve current prices for a SKU