Provides various services for communication between OneQrew partners and traders.
Request prices and/or availabilities
Prices and/or availabilities for one or more items can be requested by providing a list of items.
POST
JSON
/supply/api/v1/items/prices-and-availabilities
Requests
| Description | Example |
|---|---|
|
Content-Type:
application/json
|
{
"onlyAvailabilitiesPreferred": false,
"onlyPricesPreferred": false,
"zipCode": "12345",
"country": "DE",
"items": [
{
"position": 1,
"itemNumber": "1235678",
"quantity": 1,
"unit": "PCE"
},
{
"position": 2,
"itemNumber": "87654321",
"quantity": 100,
"unit": "MTR"
},
{
"position": 3,
"itemNumber": "234567",
"quantity": 0.5,
"unit": "KGM"
}
]
}
|
Responses
| Description | Example |
|---|---|
|
200
Content-Type:
application/json
|
{
"success": true,
"error": false,
"items": [
{
"position": 1,
"itemNumber": "1235678",
"price": 40.0,
"pricePerUnit": 40.0,
"priceScales": [
{
"quantity": 100,
"pricePerUnit": 38.0
},
{
"quantity": 1000,
"pricePerUnit": 34.0
}
],
"stockInfo": "IN_STOCK",
"stockQuantity": 1000,
"unit": "PCE"
},
{
"position": 2,
"itemNumber": "87654321",
"price": 20.0,
"pricePerUnit": 20.0,
"stockInfo": "LOW_STOCK",
"stockQuantity": 50,
"unit": "MTR"
},
{
"position": 3,
"itemNumber": "234567",
"error": true,
"message": "The item number '234567' is unknown"
}
]
}
|
|
400
Missing parameter or malformed request
Content-Type:
application/json
|
{
"success": false,
"error": true,
"message": "The parameter {missingParameter} must be filled."
}
|
|
401
Authentication required but none provided
Content-Type:
application/json
|
|
|
403
Invalid authentication or missing permission
Content-Type:
application/json
|
|
|
404
Resource not found
Content-Type:
application/json
|
|
|
405
Incorrect request method, e.g. GET instead of POST
Content-Type:
application/json
|
|
|
500
Unexpected server-side error
Content-Type:
application/json
|
Request prices and availabilities for use in baskets
Prices and availabilities for one or more items can be requested by providing a list of items.
POST
JSON
/supply/api/v1/basket/prices-and-availabilities
Requests
| Description | Example |
|---|---|
|
Content-Type:
application/json
|
{
"zipCode": "12345",
"country": "DE",
"orderMethod": "order",
"shippingMethod": "pickup",
"pickupSite": "2270",
"items": [
{
"position": 1,
"itemNumber": "1235678",
"quantity": 90,
"priceQuantity": 1,
"unit": "PCE"
},
{
"position": 2,
"itemNumber": "1235678",
"quantity": 10,
"priceQuantity": 1,
"unit": "PCE"
},
{
"position": 3,
"itemNumber": "87654321",
"quantity": 100,
"priceQuantity": 100,
"unit": "MTR"
},
{
"position": 4,
"itemNumber": "234567",
"quantity": 0.5,
"priceQuantity": 0.5,
"unit": "KGM"
}
]
}
|
Responses
| Description | Example |
|---|---|
|
200
Content-Type:
application/json
|
{
"success": true,
"error": false,
"items": [
{
"position": 1,
"itemNumber": "1235678",
"price": 3420.0,
"pricePerUnit": 38.0,
"priceScales": [
{
"quantity": 100,
"pricePerUnit": 38.0
},
{
"quantity": 1000,
"pricePerUnit": 34.0
}
],
"stockInfo": "IN_STOCK",
"stockQuantity": 1000,
"unit": "PCE"
},
{
"position": 2,
"itemNumber": "1235678",
"price": 380.0,
"pricePerUnit": 38.0,
"priceScales": [
{
"quantity": 100,
"pricePerUnit": 38.0
},
{
"quantity": 1000,
"pricePerUnit": 34.0
}
],
"stockInfo": "IN_STOCK",
"stockQuantity": 1000,
"unit": "PCE"
},
{
"position": 3,
"itemNumber": "87654321",
"price": 20.0,
"pricePerUnit": 20.0,
"stockInfo": "LOW_STOCK",
"stockQuantity": 50,
"unit": "MTR"
},
{
"position": 4,
"itemNumber": "234567",
"error": true,
"message": "The item number '234567' is unknown"
}
],
"netSum": 3820.00,
"costPositions": [
{
"itemNumber": "S",
"price": 9.5,
"shortText": "Kleinstauftrag-Zuschlag"
}
],
"basketMessages": [
{
"messageLevel": "WARNING",
"message": "Diese Bestellung überschreitet Ihr aktuell freies Limit. Diese Bestellung wird intern geprüft und nicht sofort ausgeführt."
}
]
}
|
|
400
Missing parameter or malformed request
Content-Type:
application/json
|
{
"success": false,
"error": true,
"message": "The parameter {missingParameter} must be filled."
}
|
|
401
Authentication required but none provided
Content-Type:
application/json
|
|
|
403
Invalid authentication or missing permission
Content-Type:
application/json
|
|
|
404
Resource not found
Content-Type:
application/json
|
|
|
405
Incorrect request method, e.g. GET instead of POST
Content-Type:
application/json
|
|
|
500
Unexpected server-side error
Content-Type:
application/json
|