⚠️ This section of the documentation is still work in progress and will improve as our services ripe
The supplybox is a mechanism to determine the best bid for a customer. Bids will automatically compete in the refurbed supplybox with other bids from other merchants for the same device/grade configuration. The highest price will win the supplybox (in the future the performance rating will also be factored in) and be shown to the customer if the entered data of the device matches the bid.
All services and operations concerning the offers must be called with BuybackSupplyboxService in the URL followed by the command/operation.
E.g.: https://api.refurbed.com/refb.merchant.v1.BuybackSupplyboxService/ListBuybackSupplyboxes
All calls must be done using POST method.
Read (ListBuybackSupplyboxes)
To list all your bids with supplybox information you need to call ListBuybackSupplyboxes. The supplybox provides you with every single market-specific price of your bids including information to compete with others.
Supplybox state
The state displays the different possible states of the bid’s supplybox state. Below you can find a list of these states and what they mean:
| State | Description |
|---|---|
| WON | Bid currently has the Supplybox. |
| ELIGIBLE | Bid currently not winning the supplybox, but could with a better price. |
| INELIGIBLE | Cannot win the supplybox, e.g. because refurbed's supplybox protection for this product is enabled and the offer's stock is too low. |
Supplybox competition information
| Field | Description |
|---|---|
| merchant_price | The price the merchant is willing to pay for this product and grading. If the merchant is winning the supplybox this will be equal to winning_price. |
| winning_price | The price that is currently winning the supplybox. |
| suggested_price | The price the merchant needs to bid in order to win the supplybox. This field is empty if the merchant has won the supplybox or if the bid is ineligible. |
| price_diff | The absolute difference between the current and suggested bid prices. This field is empty if the merchant has won the supplybox or if the bid is ineligible. |
To change a market-specific bid price you need to refer to that market's market_bid_id, which is also exposed here.