Requesting information about products

200 OK

Up-to-date information about the availability of goods for the transferred basket and the specified delivery region.

How to transfer product data in different situations

Магазин не доставляет заказы в переданный регион или по адресу покупателя (DBS)

Specify empty delivery options: "deliveryOptions": []. In the parameter items for each product, the parameter delivery You don't have to transmit it.

В корзине есть товары, которые магазин не доставляет в переданный регион или по адресу покупателя (DBS)

For such products, specify "delivery": false in the parameter items.

Товар отсутствует в продаже (DBS)

Specify the parameter for the product "count": 0. If all the items from the basket are not on sale, pass the parameter items empty.

Вы получили информацию, что товар отсутствует в продаже

After 10-15 minutes, this offer stops being displayed on the Market by model. DBS until the next update of the data on the service (indexing takes place every 4 hours).

Товара сейчас нет в наличии

Specify the parameter count="0", nested in the parameter items. If all the items from the basket are not on sale, pass the parameter items empty.

Пример

For ease of reading, the sample code is provided in an abbreviated format.

{
  "cart":
  {
    "items":
    [
      {
        "feedId": {int64},
        "offerId": "{string}",
        "count": {int32},
        "delivery": {boolean}
      },
      ...
    ]
  }
}

How to send delivery information to pick-up points (DBS)

Specify in the parameter outlets ids of all pick-up points where the product is already in stock and to which you can deliver the product if it is not there yet. You need to specify all the suitable pick-up points in the region specified in the request in the parameter region (even if the parameter contains an incomplete address: for example, only a city or a district in the region).

If the delivery conditions for different pick-up points differ (for example, the order will be delivered to some points tomorrow, and to others — the day after tomorrow), in the parameter deliveryOptions specify one nested parameter for each group of points with the same conditions and list the appropriate points in each of them.

How to transfer data about digital goods (DBS)

If you have disabled working with the method POST cart, you do not need to transfer data.

Instructions for working with digital goods

What to send as the shipping price (DBS)

The Market has a single delivery rate for customers. The cost of delivery is substituted automatically from the unified tariff schedule. You can transmit any number. — shipping cost data transmitted via the API is not taken into account. Detailed information about the unified tariff is provided in the Help of the Market for sellers.

Date ranges and delivery intervals (DBS)

Specify in the parameters fromDate and toDate, nested in dates, the earliest and latest possible delivery dates, respectively, and in the parameter intervals — dates and (for courier delivery, if possible) delivery intervals, which the user can choose between.

A set of parameters nested in dates, depends on the order delivery method:

• For orders with the courier delivery method ("type": "DELIVERY") either all three parameters should be passed (fromDate, toDate, intervals), or only an early delivery date (fromDate).
• For orders with a pickup delivery method ("type": "PICKUP") only the parameters should be passed fromDate and toDate. Parameter intervals You can't transfer it for such orders.

Пример

For ease of reading, the sample code is provided in an abbreviated format.

What will you convey in your response to POST cart	What the user can choose
"type": "DELIVERY", "dates": { "fromDate": "10-03-2021" }	March 10, 00:00-23:59
"type": "PICKUP", "dates": { "fromDate": "01-03-2021", "toDate": "03-03-2021" }	March 1, 00:00 — March 3, 23:59

{
  "cart": {
    "paymentMethods": [
      "SHOP_PREPAID"
    ],
    "deliveryCurrency": "RUR",
    "items": [
      {
        "feedId": 0,
        "offerId": "example",
        "count": 0,
        "delivery": true,
        "sellerInn": "example"
      }
    ],
    "deliveryOptions": [
      {
        "id": "example",
        "price": 0.5,
        "serviceName": "example",
        "type": "DELIVERY",
        "dates": {
          "fromDate": "23-09-2022",
          "toDate": "23-09-2022",
          "intervals": [
            null
          ]
        },
        "outlets": [
          {}
        ],
        "paymentMethods": [
          "SHOP_PREPAID"
        ]
      }
    ]
  }
}

[
  {
    "date": "23-09-2022",
    "fromTime": "12:00:00",
    "toTime": "12:00:00"
  }
]

{
  "fromDate": "23-09-2022",
  "toDate": "23-09-2022",
  "intervals": [
    {
      "date": "23-09-2022",
      "fromTime": "12:00:00",
      "toTime": "12:00:00"
    }
  ]
}

[
  {
    "code": "example"
  }
]

[
  "SHOP_PREPAID"
]

[
  {
    "id": "example",
    "price": 0.5,
    "serviceName": "example",
    "type": "DELIVERY",
    "dates": {
      "fromDate": "23-09-2022",
      "toDate": "23-09-2022",
      "intervals": [
        {
          "date": "23-09-2022",
          "fromTime": "12:00:00",
          "toTime": "12:00:00"
        }
      ]
    },
    "outlets": [
      {
        "code": "example"
      }
    ],
    "paymentMethods": [
      "SHOP_PREPAID"
    ]
  }
]

[
  {
    "feedId": 0,
    "offerId": "example",
    "count": 0,
    "delivery": true,
    "sellerInn": "example"
  }
]

[
  "SHOP_PREPAID"
]

{
  "paymentMethods": [
    "SHOP_PREPAID"
  ],
  "deliveryCurrency": "RUR",
  "items": [
    {
      "feedId": 0,
      "offerId": "example",
      "count": 0,
      "delivery": true,
      "sellerInn": "example"
    }
  ],
  "deliveryOptions": [
    {
      "id": "example",
      "price": 0.5,
      "serviceName": "example",
      "type": "DELIVERY",
      "dates": {
        "fromDate": "23-09-2022",
        "toDate": "23-09-2022",
        "intervals": [
          {}
        ]
      },
      "outlets": [
        {
          "code": "example"
        }
      ],
      "paymentMethods": [
        "SHOP_PREPAID"
      ]
    }
  ]
}

400 Bad Request

If the store considers the request received from Yandex. Market to be incorrect, the store must return the response status 400 with a description of the reason for the error in the response body. Such responses will be analyzed for violations and flaws of the API on the part of the Market.

500 Internal Server Error

In case of a technical error on the store's side, it should return the response status 500. Stores with a large number of such responses may be disconnected from the Market.