从12月31日开始,push API方法将不可用。 从10月1日起,它们可能不稳定。
用于传输信息的请求:
- 关于剩菜 — PUT v2/campaigns/{campaignId}/offers/stocks.
- 关于商店的销售点 — GET v2/campaigns/{campaignId}/outlets.
要接收有关订单的信息,请启用API通知。 怎么做
索取有关产品的资料
市场验证客户放入篮子的商品是否在商店中可用。 在 DBS-商店也被要求提供有关交货可能性和可用付款方式的信息。
响应时间:5.5秒。
Request
POST
/cart
Body
application/json
{
"cart": {
"businessId": 0,
"currency": "RUR",
"deliveryCurrency": "RUR",
"buyer": {
"id": "string",
"lastName": "string",
"firstName": "string",
"middleName": "string",
"type": "PERSON"
},
"delivery": {
"region": {
"id": 0,
"name": "string",
"type": "OTHER"
},
"address": {
"country": "string",
"postcode": "string",
"city": "string",
"district": "string",
"subway": "string",
"street": "string",
"house": "string",
"block": "string",
"entrance": "string",
"entryphone": "string",
"floor": "string",
"apartment": "string",
"lat": 0,
"lon": 0,
"notes": "string",
"outletPhones": [
"string"
],
"schedule": [
{
"fromDay": "MONDAY",
"toDay": "MONDAY",
"fromTime": "string",
"toTime": "string"
}
]
},
"estimated": false,
"outlet": {
"code": "string"
}
},
"items": [
{
"id": 0,
"feedId": 0,
"offerId": "string",
"feedCategoryId": "string",
"offerName": "string",
"price": 0,
"subsidy": 0,
"count": 0,
"shopSku": "string",
"warehouseId": 0,
"partnerWarehouseId": "string",
"fulfilmentShopId": 0,
"promos": [
{
"type": "DIRECT_DISCOUNT",
"subsidy": 0,
"marketPromoId": "string"
}
]
}
]
}
}
|
Name |
Description |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
cart* |
Type: object
篮子。 |
Responses
200 OK
关于转移的篮子和指定的交货区域的货物可用性的最新信息。
- 如何在不同情况下传输产品数据
-
商店不将订单交付到转移的地区或买方的地址(DBS)
指定空传递选项:
"deliveryOptions":[]. 在参数中items对于每个产品,参数delivery你不必传送它。篮子里有商店没有送到转移地区或买家地址的物品(DBS)
对于此类产品,请指定
"delivery": false在参数中items.该产品不可出售(DBS)
指定产品的参数
"count": 0. 如果篮子中的所有物品都没有出售,请传递参数items空的。您已收到产品缺货的信息
10-15分钟后,此优惠停止按型号在市场上显示。 DBS 直到服务上的数据的下一次更新(索引每4小时进行一次)。
该产品目前缺货
指定参数
计数="0",嵌套在参数中items. 如果篮子中的所有物品都没有出售,请传递参数items空的。例子:
为便于阅读,示例代码以缩写格式提供。
{ "cart": { "items": [ { "feedId": {int64}, "offerId": "{string}", "count": {int32}, "delivery": {boolean} }, ... ] } } - 如何将派递资料传送至提货点(DBS)
-
在参数中指定
outlets产品已有库存的所有提货点的id,如果产品尚未存在,您可以将产品交付给该提货点。 您需要在参数中指定请求中指定的区域中的所有合适的拾取点region(即使参数包含一个不完整的地址:例如,只有一个城市或地区)。如果不同的提货点的交货条件不同(例如,订单将在明天交付到某些点,而其他点 — 后天),在参数
deliveryOptions为具有相同条件的每组点指定一个嵌套参数,并在每组点中列出适当的点。 - 如何传输有关数字商品的数据(DBS)
-
如果您已禁用使用该方法
POST cart,则不需要传输数据。 - 寄什么作为运费(DBS)
-
市场对客户有单一的交货率。 交付成本自动从统一的关税表中取代. 您可以传输任何数字。 — 不考虑通过API传输的运费数据。 提供了有关统一关税的详细信息 在市场对卖家的帮助.
- 日期范围和交货间隔(DBS)
-
在参数中指定
fromDate和toDate,嵌套在dates,最早和最晚的可能交货日期,分别,并在参数intervals— 日期和(如果可能的话,为快递递送)递送间隔, 用户可以选择.一组嵌套在
dates,取决于订单交付方式:- 以速递派递方式订购(
"type": "DELIVERY")要么所有三个参数都应该传递(fromDate,toDate,intervals),或只有提前交货日期(fromDate). - 对于具有提货送货方式的订单(
"type": "PICKUP")只应传递参数fromDate和toDate. 参数intervals你不能为这样的订单转移它。
例子:
为便于阅读,示例代码以缩写格式提供。
你会在你的回应传达什么
POST cart用户可以选择什么
"type": "DELIVERY", "dates": { "fromDate": "10-03-2021" }3月10日00:00-23:59
"type": "PICKUP", "dates": { "fromDate": "01-03-2021", "toDate": "03-03-2021" }3月1日00:00 — 3月3日23:59
- 以速递派递方式订购(
Body
application/json
{
"cart": {
"paymentMethods": [
"SHOP_PREPAID"
],
"deliveryCurrency": "RUR",
"items": [
{
"feedId": 0,
"offerId": "string",
"count": 0,
"delivery": false,
"sellerInn": "string"
}
],
"deliveryOptions": [
{
"id": "string",
"price": 0,
"serviceName": "string",
"type": "DELIVERY",
"dates": {
"fromDate": "23-09-2022",
"toDate": "23-09-2022",
"intervals": [
{
"date": "23-09-2022",
"fromTime": "string",
"toTime": "string"
}
]
},
"outlets": [
{
"code": "string"
}
],
"paymentMethods": [
"SHOP_PREPAID"
]
}
]
}
}
|
Name |
Description |
||||||||
|
cart* |
Type: object
|
400 Bad Request
如果商店考虑从Yandex收到的请求。 如果不正确,商店必须返回响应状态400,其中包含响应正文中错误原因的描述。 这些回应将被分析为API违规和市场上的缺陷。
500 Internal Server Error
如果商店一侧出现技术错误,它应该返回响应状态500。 具有大量此类响应的商店可能与市场脱节。
No longer supported, please use an alternative and newer version.