docs
  1. SCAYLE Resource Center
  2. Onboarding Guide
  3. Onboarding: Backend
  4. Add prices to your products

Add prices to your products

Money makes the world go round–and the same applies to SCAYLE. You need to add prices to sell products. So let’s get down to business.

In SCAYLE prices are defined at the product variant level.

You must provide prices for each country in all required currencies.

If you want to sell a product in two shop countries, you need to import product variant prices for each country in the local currency.

The Admin API provides a specific endpoint for the price import.

We’ll explain everything you need to know about the basic setup in the following section.

What information should I know to create a price via the Admin API?

You have to use the Admin API endpoint /variants/{variantIdentifier}/prices with the POST HTTP method. Additionally, know the variant identifier for the price creation. This can be found in the SCAYLE Panel (Products > Choose one Product ID > Scroll down to variants) or by using the variants endpoint of the Admin API.

The following parameters are mandatory for price creation per variant:

ParameterTypeDetails
priceINTEGERThe current price of the variant for a shop country, in cents.
currencyCodeSTRING

ISO 4217 currency code.
For example USD or EUR.

countryCodeSTRINGISO 3166 alpha-2 country code. For example DE or CH
taxFLOATTax rate of the country shop.

The variantIdentifier is part of the request URL. All other parameters are part of the request body. The request body must follow this structure:

{
    "price": 1090,
    "tax": 19,
    "countryCode": "DE",
    "currencyCode": "EUR"
}

Let’s create prices for our Fashion Store

For our Fashion Store, we have to import prices for Switzerland and Germany. That means we need to include two different currencies: CHF and EUR. Therefore, we’ll import variant prices for DE and CH in their respective currencies.

For the product variant id 3, we need to import 15,90€ and 18,30 CHF as prices. Create two requests by using the price endpoint.

Request 1

{
    "price": 1590,
    "tax": 19,
    "countryCode": "DE",
    "currencyCode": "EUR"
}

Request 2

 {
    "price": 1830,
    "tax": 7.7,
    "countryCode": "CH",
    "currencyCode": "CHF"
}

The response will include a lot of information. But don't panic–this is normal. Those are optional parameters that could have been set in the request body or are set automatically ,such as validFrom . This parameter is set with the current timestamp to define from which date the price should be used. Here you can see a response for the request 1:

{
    "key": "1-1055",
    "price": 1590,
    "oldPrice": null,
    "recommendedRetailPrice": null,
    "buyingPrice": null,
    "tax": 19,
    "countryCode": "DE",
    "currencyCode": "EUR",
    "groupKey": null,
    "promotionKey": null,
    "validFrom": "2023-04-19T15:28:32+00:00",
    "validTo": null
}

Where can you find price information in the SCAYLE Panel?

  1. Go to the product details page Products > Choose one Product ID.
  2. Scroll down to the end of the page, and there you’ll find an overview of all prices per country: Prices per country.

Prices per country

Now you know how to create prices and are one step closer to a sellable product. We're just missing one more thing. But we’ll be there in no time.

Further education - SCAYLE Academy