Interact with Admin API in Multi-Merchant Setup

Use this page when you already work in a multi-merchant setup and need request examples.

This page is API-focused.

If you need the conceptual model, start with Merchants.

If you need the rollout sequence, use Merchant Allocation.

Before you start

Make sure these prerequisites are met:

• The merchant exists.
• The warehouse exists.
• The warehouse is connected to the merchant.
• The warehouse is connected to the target shop country.
• The assortment includes the merchant where needed.

In multi-merchant setups, send merchantReferenceKey explicitly for prices and stocks.

Admin API

Update assortment

In SCAYLE, you update shop country assortments by narrowing down or extending product sets based on different criteria. By including or excluding master categories, product IDs, or attributes, you replace the current assortment with the updated one.

This method is used to update a shop country assortment.

JavaScriptPHPcURLJava

Copy

Create stock information

You can update stock information by overriding existing information with a more recent warehouse stock change.

• If you provide a changedAt date which is older than the last processed stock information, the stock will not change as this will be considered as outdated information. In this case the method will return the current stock. If you would like to find out if the information you sent was outdated, you have to compare what you’ve sent to what was returned in the response.
• Sending a stock update without sellableWithoutStock flag will reset the value to false (the default value).
• It is not possible to update stock information for composite product variants.
• merchantReferenceKey can be provided to create merchant-specific stocks. It must refer to one of the merchants provided on product creation.

Make sure the provided warehouseReferenceKey exists before you create a stock. You can create a new shop warehouse.

Examples

JavaScriptPHPcURLJava

Copy

Create/update a price

Prices are defined on a product variant level and contain all information about prices, taxes and validity — upcoming prices can also be defined for automatic future price updates.

This method can be used to create a new Product Variant Price. You can create prices which are valid from now or in the future. If there is an already existing price for the same validation time frame, it will get replaced.

If multiple prices of the same variant are to be created then use update-variant endpoint which supports sending multiple prices at once.

Creating a new price, which is valid from the time of creation, will invalidate the current active price and become the new active one based on the dimensions explained on the prices overview page.

merchantReferenceKey can be provided to create a merchant-specific price.

It must refer to one of the merchants provided on product creation.

Examples

Create a merchant-specific price valid from now

JavaScriptPHPcURLJava

Copy

Create Valid Price for Future

JavaScriptPHPcURLJava

Copy

Create Valid Expiring Price

JavaScriptPHPcURLJava

Copy

Create Price with Unit Price

JavaScriptPHPcURLJava

Copy

Create Merchant-Specific Price

JavaScriptPHPcURLJava

Copy