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

The store does not deliver orders to the transferred region or to the buyer's address (DBS)

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

There are items in the basket that the store does not deliver to the transferred region or to the buyer's address (DBS)

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

The product is not available for sale (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.

You have received information that the product is out of stock

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).

The product is currently out of stock

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

Example

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 transfer 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.

Example

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": "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"
                ]
            }
        ]
    }
}

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 API violations and flaws 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.