Overview

Allows you to retrieve pricing data for countries where you want to sell your products

v4.0

The ESW Pricing Advisor API v4.0 allows you to retrieve pricing data for countries where you want to sell your products. This data helps you determine how to price your products and display them at checkout. You can fetch pricing data for a specific delivery country or for all countries supported by ESW.

The information you can retrieve includes:

  • FX Rates
  • Estimated Duties
  • Estimated Taxes
  • Estimated Fees
  • Retailer Adjustments
  • Rounding Models
  • Pricing Model

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, fees & taxes, retailer adjustment, and rounding models are also agreed upon during your onboarding with ESW.

categoriesin v4.0

As a part of this capability, the pricing advice is returned in form of a list. This allows you to create custom categories and have different pricing advice per category. ESW always returns default Pricing advice so that if an expected category is missing then you can fall-back to default.

categories
"categories": [
      {
        "id": "default",
        "estimatedTax": 10.00,
        "estimatedDuty": 5.00,
        "estimatedFee": 2.00,   
        "retailerAdjustment": 5.00,
        "roundingConfigurations": [],
        "currencyDisplays": []
      },
      {
        "id": "luxury",
        "estimatedTax": 15.00,
        "estimatedDuty": 6.00,
        "estimatedFee": 5.00,   
        "retailerAdjustment": 10.00,
        "roundingConfigurations": [],
        "currencyDisplays": []
      }
    ]

Note:
All the numbers in the above example are percentages. For example, 10 means 10%.
To calculate 10% of 200, divide 10 by 100 and multiply by 200: (10 / 100) * 200 = 20

currencyDisplaysin v4.0

The following code snippet shows and example of the currency displays

currencyDisplays
"currencyDisplays": [
          {
            "currencyIso": "AUD",
            "currencySymbol": "$",
            "currencyExponent": 2,
            "decimalSeparator": ".",
            "thousandSeparator": ",",
            "showTrailingZeros": true,
            "configurationString": ""[Number][ExponentSeparator][Exponent] [CurrencyISO]"
          },
          {
            "currencyIso": "EUR",
            "currencySymbol": "€",
            "currencyExponent": 2,
            "decimalSeparator": ".",
            "thousandSeparator": ",",
            "showTrailingZeros": true,
            "configurationString": ""[Number][ExponentSeparator][Exponent] [CurrencyISO]"
          }
        ]

roundingModelsin v4.0

The following code snippet shows an example of the rounding models

roundingModels
"roundingConfigurations": [
          {
            "currencyIso": "AUD",
            "currencyExponent": 2,
            "direction": "Up",
            "model": "none.none"
          },
          {
            "currencyIso": "Eur",
            "currencyExponent": 2,
            "direction": "Up",
            "model": "none.fixed00"
          }
        ]
Concepts
The following section describe concepts and terms that are used throughout the Pricing Advisor documentation
Methods
Pricing Advisor API v4.0 includes the following methods