Prices for the individual markets are represented by the OfferMarketPrice object. By default, market offer prices are calculated from the reference prices and converted automatically into the respective market’s currency, if it does not match the offer price’s currency, but they can also be specified explicitly (manual market price management).

All services and operations concerning the market offers must be called with MarketOfferService in the URL followed by the command/operation.

E.g.: https://api.refurbed.com/refb.merchant.v1.MarketOfferService/CreateMarketOffer

All calls must be done using POST method.

Create (CreateMarketOffer/BatchCreateMarketOffer)

Set a specific market offer price for one country by creating a market offer. If you create market offers in batches of up to 50 market offers via BatchCreateMarketOffer you can set market prices for different countries for the same offer. To create a market offer you need the ID or SKU of your offer and the price, currency code, and market code. You can also set a min price for a certain market.

You can find a list of all available market codes and their currencies by calling MarketService/ListMarkets. In the response, you will also see the attribute is_site which indicates if there is a located website/domain for that country.

<aside> ⚠️ Please only set a market_price where the calculated_market_prices array in the offer object returns true in the is_site_market field, which means that there is domain/localized site for that region.

</aside>

Read (ListMarketOffers/ListMarketOffersByOffer)

You can get an overview of all existing market offers by using the List command. The response will contain an array/list of all market offers according to the pagination rules with all related information. As for every read command that is served over our API you can use extensive filters and sort by sending a specific payload in the request header. To receive information about one specific market offer use the ListMarketOffersByOffer command which offers you more market price-specific filter options.

Update (UpdateMarketOffer/BatchUpdateMarketOffer)

Once you have created all your market offers you can update their currency, price, and min price. This operation gives you also the possibility to delete a min price that you have previously set but don’t want to use anymore.

<aside> 💡

Learn more: Minimum Price Feature - How does it work and what are the main benefits?

</aside>

Delete (DeleteMarketOffer/BatchDeleteMarketOffer)

Delete a market offer by indicating the ID or SKU of the applicable offer and the market code of the applicable country. If you are still selling to this specific country, the offer's reference price will be used to calculate the market offer price again.

Workflow Example

You are selling your product A with SKU 12345 in Austria at a price of €500. You decide to extend your reachability and sell also in Italy but you want to sell at a different price. Include Italy as a country in your shipping profile and set shipping costs if applicable and the min and max delivery time. Market_offers inherit all offer attributes except the price (min price, price). Then create your market offer for the market Italy.

Get the list of available markets alphabetically by name: POST to MarketService/ListMarkets

{
  "sort": {
    "order": "ASC",
    "by": "NAME"
  }
}