Price Models¶
Each advertisement has a price model which determines the type of transaction the seller would like to perform. Model type must be specified for each price model. It should have one of the allowed values.
There are some price models which have required and optional fields. And there are price models without any additional fields. In the documentation below, if a field is not mentioned in a model specific field table then it is not allowed. Note that ‘modelType’ is mandatory for all price models (and not mentioned in a field tables.)
The following table lists the valid price model types and their descriptions.
| Price model types | Description |
|---|---|
| fixed | Seller requests fixed price |
| bidding | Seller requests bidding |
| to be discussed | Price needs to be discussed between seller and buyer |
| by request | Price is given on request |
| trade | Item can be traded for another item |
| see description | Information about price is available in the item description |
| buy it now | Item can be bought directly from Marktplaats |
| reserved | The item has been reserved |
fixed¶
Seller requests fixed price.
| field | type | constraints | default | Req | W | U |
|---|---|---|---|---|---|---|
| askingPrice | long | non-negative | yes | yes | yes | |
| retailPrice | long | non-negative, only writeable with retail_price privilege | no | no | no |
askingPrice
The price in cents which seller asks for an item.
retailPrice
The retail price of the item in cents. Only writable and updateable when the client has outlet privilege.
...
"priceModel" : {
"modelType" : "fixed",
"askingPrice" : 1550
}
...
bidding¶
Seller requests bidding. Leave both minimalBid and askingPrice empty if you do not want to specify an asking price. but still allow bidding
| field | type | constraints | default | Req | W | U |
|---|---|---|---|---|---|---|
| minimalBid | int | non negative | no | yes | yes | |
| askingPrice | int | non negative | no | yes | yes | |
| retailPrice | long | non-negative, only writeable with retail_price privilege | no | no | no |
minimalBid
The minimum bid accepted by a seller. The minimal bid is set to the askingPrice if it is missing. If minimalBid is provided, it is also required to specify an askingPrice.
askingPrice
The asking price for an item. If askingPrice is not provided, the displayed price on the website will be ‘bieden’. If minimalBid is provided, it is also mandatory to provide an askingPrice.
retailPrice
The retail price of the item in cents. Only writable and updateable when the client has retail_price privilege.
...
"priceModel" : {
"modelType" : "bidding",
"minimalBid" : 2000,
"askingPrice" : 5550,
"retailPrice" : 6000
}
...
to be discussed¶
Price needs to be discussed between seller and buyer.
...
"priceModel" : {
"modelType" : "to be discussed"
}
...
by request¶
Seller provides price by a request.
...
"priceModel" : {
"modelType" : "by request"
}
...
see description¶
Information about price is available in the item description
...
"priceModel" : {
"modelType" : "see description"
}
...
buy it now¶
Item can be bought directly from Marktplaats. May only be used by selected sellers.
| field | type | constraints | default | Req | W | U |
|---|---|---|---|---|---|---|
| askingPrice | long | non-negative | yes | yes | yes | |
| shippingCosts | long | non-negative | no | yes | yes | |
| retailPrice | long | non-negative, only writeable with retail_price privilege | no | no | no |
askingPrice
The price in cents which seller asks for an item.
shippingCosts
The price in cents which seller asks for shipping an item.
retailPrice
The retail price of the item in cents. Only writable and updateable when the client has retail_price privilege.
...
"priceModel" : {
"modelType" : "buy it now",
"askingPrice" : 5550,
"shippingCosts" : 695
}
...
reserved¶
The item has been reserved, meaning that in principle the item has been sold to a buyer.
...
"priceModel" : {
"modelType" : "reserved"
}
...
Field errors¶
| field | error code | error value | description |
|---|---|---|---|
| priceModel.retailPrice | input-invalid | It is only allowed to set or update the retailPrice when the user has retail_price privileges. | |
| priceModel.type | input-invalid | A required price model type is missing | |
| priceModel.askingPrice | input-not-allowed | The asking price is not allowed for the selected model type | |
| priceModel.minimalBid | input-not-allowed | The minimal bid is not allowed for the selected model type | |
| priceModel.type | input-not-allowed | “buy it now” | User is not allowed to use this model type |
| priceModel.shippingCosts | input-too-low | The specified shipping costs are too low | |
| priceModel.askingPrice | input-too-short | The specified asking price is too short | |
| priceModel.minimalBid | input-too-short | The specified asking price is too short | |
| priceModel.type | invalid-field-value | “fixed|bidding|trade|see description|by request|to be discussed|buy it now|reserved” | Model type doesn’t contain any of the allowed values |
| priceModel.askingPrice | invalid-input | The required asking price field is missing | |
| priceModel.askingPrice | invalid-input | The required asking price field is missing | |
| priceModel.minimalBid | value-too-high | The minimal bid is too high (it is higher then the asking price) |