Concepts

The following section describe concepts and terms that are used throughout the Pricing Advisor documentation

The ESW Pricing Advisor API allows you to retrieve pricing data for countries where you want to sell your products. This data helps determine how you want to price your products and display them at the checkout.

Using the Pricing Advisor API, you can retrieve pricing data for a specific delivery country or for all countries where ESW delivers. The information you can retrieve includes:

  • FX Rates
  • Estimated Duties
  • Estimated Taxes
  • Retailer Adjustments
  • Rounding Models

Note

FX rates are updated daily based on the price feed that you specify during your onboarding. ESW offers three pricing feeds – HSBC, XE, or Thomson Reuters.
The rates for the estimated duties & taxes, retailer adjustment, and rounding models are also agreed upon during your onboarding with ESW.

Pricing Advisor Concepts

The following sections describe key concepts and terms used throughout the Pricing Advisor documentation.

Rounding

Rounding is the process of altering a number to a simplified, approximate value. The rounding direction determines whether the value is adjusted up or down. ESW uses standard rounding directions within its models.

There are three rounding directions supported: Up, Down, and Nearest.

Up

The rounding direction is Up when a number is rounded to the next highest value.

  • Whole Numbers: 1706.00 with direction Up and target 10 → 1710.00
  • Decimal Numbers: 1700.06 with direction Up and target 10 → 1700.10

Down

The rounding direction is Down when a number is rounded to the next lowest value.

  • Whole Numbers: 1714.00 with direction Down and target 10 → 1710.00
  • Decimal Numbers: 1700.14 with direction Down and target 10 → 1700.10

Nearest

The Nearest rounding direction rounds to the value closest to the original number.

If the remainder is 0–4, round Down. If it's 5–9, round Up.

  • Whole Numbers: 1704.00 with direction Nearest → 1700.00; 1705.00 → 1710.00
  • Decimal Numbers: 1700.14 → 1700.10; 1700.15 → 1700.20

Rounding Models

ESW's rounding models give you complete control over how final prices are calculated and presented. You can apply specific rules to ensure pricing consistency across markets.

The Pricing Advisor API supports the following rounding models: Fixed, None, and Multiple.


Info

Rounding models are the combination of one or more rounding methods that you would like to apply to a given value.
For example: none.fixed, fixed.multiple, multiple.none, and so on.

Fixed Rounding Models

The Fixed rounding method adjusts the price so that it always ends with a specified value, known as the rounding target. This target can apply to either the whole number part (left of the decimal) or the decimal part (right of the decimal).

Examples

  • Whole Numbers: 1700.00 with direction Up and target 50 → 1750.00
  • Decimal Numbers: 1700.00 with direction Up and decimal target 50 → 1700.50

Fixed Rounding Examples Table

Fixed Rounding Model Examples

Input Rounding Model Direction Result
1001.00 fixed00.fixed50 Up 1100.50
1001.00 fixed0.fixed4 Up 1010.40
1001.00 fixed0.fixed4567 Up 1010.45
406,677.00 fixed8000.fixed00 Up 408,000.00
406,677.00 fixed00.fixed00 Up 406,700.00
406,677.00 fixed00.fixed25 Up 406,700.25
189.36 fixed99.fixed99 Nearest 199.99
25,689.36 fixed99.fixed99 Up 25,699.99

Multiple Rounding Models

The Multiple rounding method adjusts the price so that it ends with the nearest multiple of a specified rounding target. You can apply the target to either the whole number (left of the decimal) or the decimal part (right of the decimal).

  • Whole Numbers: 1701.00 → 1710.00 (direction: Up, target: 10)
  • Decimal Numbers: 1700.01 → 1700.50 (direction: Up, target: 50)

Additional Examples

Input Model Direction Result
1001.01 multiple10.multiple10 Up 1010.10
1001.01 multiple100.multiple5 Up 1100.05
7001.01 multiple1000.fixed0 Up 8000.00

None Rounding Model

The None rounding model is used when you do not want to round prices. This means the calculated price remains exactly as it is. It’s useful when precision is required and no adjustment is desired.

Examples

Input Model Direction Result
1001.01 fixed10.none Up 1010.01
1001.01 none.multiple5 Up 1001.05

Technical Differences In Pricing Advisor API Versions

currencyDisplays

The currencyDisplays object contains the pricing display configuration for each currency ISO.

{
"currencyDisplays": [
  {
    "currencyIso": "string",
    "currencyExponent": 0,
    "currencySymbol": "string",
    "showTrailingZeros": true,
    "thousandSeparator": "string",
    "decimalSeparator": "string",
    "configurationString": "string"
  }
]
}

roundingModels

Rounding applies only to the decimal number (right of the decimal point). Supported models: Fixed, None.

Example: Rounding 41.35 only applies to ".35" not "41"

Overview
Allows you to retrieve the pricing data for the delivery countries from the ESW system
Overview
Allows you to retrieve pricing data for countries where you want to sell your products