Our product categories group together products of certain types that are sold on refurbed. All categories are created by refurbed’s Listing Team.
A product contains only general data of a device like e.g. dimensions or weight. Every product is related to a category. A product can have multiple variants (instances). Every product has its own unique internal id, the product_id. The product_id is currently only relevant for bid creation (Buyback). All products are created by refurbed’s Listing Team.
An instance is a variant of a product. The instance holds all specific variant data e.g. attributes like color or storage size, but also images and identifiers like MPN or GTINs. Every instance has its own unique internal id, the instance_id. All existing instances (product variants) can be found in our product catalogue. All instances are created by refurbed’s Listing Team.
An offer holds all relevant selling data, like prices, stock, currency, grade, etc. The main offer identifier is the SKU which the seller assigns. The SKU is related to an instance’s instance_id.
Products that do not exist yet in our product catalogue can be requested by using our listing template and sending the product data to the Listing team.
<aside> 💡 Providing additional identifiers like GTIN and/or MPN is beneficial for easier offer creation later.
</aside>
Offers can be created by providing the specific selling data, like prices, stock, currency, grade, etc. as well as your SKU as a main reference. To create an offer this data must be related to an instance in our product catalogue, this can be done by referring to our instance_id or, if available, a GTIN or MPN.
GetInstance / BatchGetInstances)All services and operations concerning instances must be called with InstanceService in the URL followed by the command/operation.
https://api.refurbed.com/refb.merchant.v1.InstanceService/GetInstance