All services and operations concerning the offers must be called with OfferService in the URL followed by the command/operation.
E.g.: https://api.refurbed.com/refb.merchant.v1.OfferService/ListOffers
All calls must be done using POST method.
CreateOffer / BatchCreateOffers)Once your products are listed in the refurbed product catalog you can create offers for them. You can do so by using refurbed’s instance ID, GTIN or Manufacturer Part Number (MPN) of the product. Please note that the instance ID is the main product identifier within refurbed. GTIN and MPN may vary per producer and reseller and can as such not always identify a product with 100% certainty.
<aside> ℹ️ If you intend to use GTIN or MPN to create offers be aware that we trust our own instance IDs more to identify a product than a GTIN and MPN, so if you create an offer directly with a GTIN or MPN the offer will be in an UNVERIFIED state and not be visible to customers unless you log into the merchant backend and verify the created offers manually (Button “Verify” will appear).
</aside>
Log into the merchant interface, go to the Offers section, and click on Create in the top right. Now you can search and see if your products are already listed. Another way is to export the whole refurbed product catalog and search/filter in the file. If you cannot find the products you want to list then you can request them by following these requirements for listing new products: Requirements for listing
Currently, products can’t be created by an external party.
An Offer combines information like grading, taxation, stock, reference price, and reference min. price. Below is an overview of which arguments are needed to create an offer:
| field | required | description | type |
|---|---|---|---|
| instance_id | ✅ | refurbed’s internal reference number, can be found in our product catalog (download in the merchant backend). | string($int64) |
| sku | ✅ | SKU that will be connected to the offer, it will be the reference if you e.g. want to offer updates via API. MUST be unique. | string |
| reference_min_price | ❌ | Defines a lower price limit for buybox competition. | string |
| reference_price | ✅ | Offer price including VAT. Eventual shipping costs set in your shipping profile will be added to the sales price. | string |
| reference_currency_code | ✅ | Offer currency as ISO 4217 code. | string |
| stock | ✅ | The quantity available of the item. | integer($int64) |
| grading | ✅ | AA, A, B or C. Please refer to our Quality charta | string |
| warranty | ✅ | Allowed value is M12. M = Months. | string |
| shipping_profile_id | ✅ | ShippingProfile ID can be found in the merchant backend > Shipping profiles section. The chosen ID will be connected to the offer. |
string($int64) |
| taxation | ✅ | The applicable taxation of the item (MARGINAL or GROSS) | string |
| battery_condition | ❌ | State of the battery the offer is sold with (OPTIMAL or NEW). Omitting the field will result in value UNSPECIFIED. | string |
Prices can be defined in any of the supported currencies returned by the CurrencyService/ListCurrencies endpoint. Shipping costs have to be set within your shipping profiles.
The reference prices are the default prices used for all markets if you don’t specify any market offers. They are automatically converted into the respective market's currency if it doesn't match the offer price's currency and we have a localized site for it. The reference_price is only a reference and may be increased by refurbed due to dynamic pricing according to the merchant guide.
If you set a reference_min_price this price will be taken into consideration when calculating the BuyBox and your price could be lowered until your reference_min_price if that would make you win the BuyBox.
<aside> 💡
Learn more: Minimum Price Feature - How does it work and what are the main benefits?
</aside>
When creating an offer you can already create_market_prices by adding the market_code, price, currency_code, and optionally also a market-specific min_price per country if you want to set different prices in the countries you are selling in. Refer to the market offers page for more detail.