Import products
Add prices to your products
- OMS
- Business
Maximilian Seifert
Business Analyst
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.
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:
Parameter | Type | Details |
---|---|---|
price | INTEGER | The current price of the variant for a shop country, in cents. |
currencyCode | STRING | ISO 4217 currency code. |
countryCode | STRING | ISO 3166 alpha-2 country code. For example DE or CH |
tax | FLOAT | Tax 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"
}
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
}
Products > Choose one Product ID
.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.
Import products
Maximilian Seifert
Business Analyst