Since April 1, 2025, the method has stopped working for the FBS and Express models.

For the DBS model: disable this feature in your account by clicking on the name of your business in the lower—left corner and going to the page Modules and APIs to the tab Receiving requests from Yandex.Market and activate the option Do not use the POST cart method.

Requests to use to transmit information:

About the leftovers — PUT campaigns/{campaignId}/offers/stocks.
About the store's points of sale — GET campaigns/{campaignId}/outlets.

To receive information about orders, enable API notifications. How to do it

Requesting information about products

The market verifies that the goods that the customer has put in the basket are available in the store. Information about the possibility of delivery and available payment methods is also requested from DBS stores.

Response time: 5.5 seconds.

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",
                "parent": {
                    "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
        },
        "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: CartDTO

Basket.

CartDTO

Basket.

Name	Description
businessId	Type: integer<int64> Cabinet ID.
buyer	Type: object Information about the buyer. Parameters `id`, `lastName`, `firstName` and `middleName` they are returned only if you use the DBS model.
currency	Type: CurrencyType The currency in which the prices of the goods in the order are indicated. Takes the value `RUR` — the Russian ruble. Enum: `RUR`, `USD`, `EUR`, `UAH`, `AUD`, `GBP`, `BYR`, `BYN`, `DKK`, `ISK`, `KZT`, `CAD`, `CNY`, `NOK`, `XDR`, `SGD`, `TRY`, `SEK`, `CHF`, `JPY`, `AZN`, `ALL`, `DZD`, `AOA`, `ARS`, `AMD`, `AFN`, `BHD`, `BGN`, `BOB`, `BWP`, `BND`, `BRL`, `BIF`, `HUF`, `VEF`, `KPW`, `VND`, `GMD`, `GHS`, `GNF`, `HKD`, `GEL`, `AED`, `EGP`, `ZMK`, `ILS`, `INR`, `IDR`, `JOD`, `IQD`, `IRR`, `YER`, `QAR`, `KES`, `KGS`, `COP`, `CDF`, `CRC`, `KWD`, `CUP`, `LAK`, `LVL`, `SLL`, `LBP`, `LYD`, `SZL`, `LTL`, `MUR`, `MRO`, `MKD`, `MWK`, `MGA`, `MYR`, `MAD`, `MXN`, `MZN`, `MDL`, `MNT`, `NPR`, `NGN`, `NIO`, `NZD`, `OMR`, `PKR`, `PYG`, `PEN`, `PLN`, `KHR`, `SAR`, `RON`, `SCR`, `SYP`, `SKK`, `SOS`, `SDG`, `SRD`, `TJS`, `THB`, `TWD`, `BDT`, `TZS`, `TND`, `TMM`, `UGX`, `UZS`, `UYU`, `PHP`, `DJF`, `XAF`, `XOF`, `HRK`, `CZK`, `CLP`, `LKR`, `EEK`, `ETB`, `RSD`, `ZAR`, `KRW`, `NAD`, `TL`, `UE`
delivery	Type: CartDeliveryDTO Delivery information.
deliveryCurrency	Type: CurrencyType Only for the DBS model The currency in which the prices of the goods in the order are indicated. Takes the value `RUR` — the Russian ruble. Enum: `RUR`, `USD`, `EUR`, `UAH`, `AUD`, `GBP`, `BYR`, `BYN`, `DKK`, `ISK`, `KZT`, `CAD`, `CNY`, `NOK`, `XDR`, `SGD`, `TRY`, `SEK`, `CHF`, `JPY`, `AZN`, `ALL`, `DZD`, `AOA`, `ARS`, `AMD`, `AFN`, `BHD`, `BGN`, `BOB`, `BWP`, `BND`, `BRL`, `BIF`, `HUF`, `VEF`, `KPW`, `VND`, `GMD`, `GHS`, `GNF`, `HKD`, `GEL`, `AED`, `EGP`, `ZMK`, `ILS`, `INR`, `IDR`, `JOD`, `IQD`, `IRR`, `YER`, `QAR`, `KES`, `KGS`, `COP`, `CDF`, `CRC`, `KWD`, `CUP`, `LAK`, `LVL`, `SLL`, `LBP`, `LYD`, `SZL`, `LTL`, `MUR`, `MRO`, `MKD`, `MWK`, `MGA`, `MYR`, `MAD`, `MXN`, `MZN`, `MDL`, `MNT`, `NPR`, `NGN`, `NIO`, `NZD`, `OMR`, `PKR`, `PYG`, `PEN`, `PLN`, `KHR`, `SAR`, `RON`, `SCR`, `SYP`, `SKK`, `SOS`, `SDG`, `SRD`, `TJS`, `THB`, `TWD`, `BDT`, `TZS`, `TND`, `TMM`, `UGX`, `UZS`, `UYU`, `PHP`, `DJF`, `XAF`, `XOF`, `HRK`, `CZK`, `CLP`, `LKR`, `EEK`, `ETB`, `RSD`, `ZAR`, `KRW`, `NAD`, `TL`, `UE`
items	Type: CartItemDTO[] Items in the shopping cart.

CurrencyType

Currency codes:

RUR — the Russian ruble.
UAH — the Ukrainian hryvnia.
BYR — Belarusian ruble.
KZT — Kazakhstani tenge.
UZS — Uzbek sum.

Type

Description

CurrencyType

Enum: RUR, USD, EUR, UAH, AUD, GBP, BYR, BYN, DKK, ISK, KZT, CAD, CNY, NOK, XDR, SGD, TRY, SEK, CHF, JPY, AZN, ALL, DZD, AOA, ARS, AMD, AFN, BHD, BGN, BOB, BWP, BND, BRL, BIF, HUF, VEF, KPW, VND, GMD, GHS, GNF, HKD, GEL, AED, EGP, ZMK, ILS, INR, IDR, JOD, IQD, IRR, YER, QAR, KES, KGS, COP, CDF, CRC, KWD, CUP, LAK, LVL, SLL, LBP, LYD, SZL, LTL, MUR, MRO, MKD, MWK, MGA, MYR, MAD, MXN, MZN, MDL, MNT, NPR, NGN, NIO, NZD, OMR, PKR, PYG, PEN, PLN, KHR, SAR, RON, SCR, SYP, SKK, SOS, SDG, SRD, TJS, THB, TWD, BDT, TZS, TND, TMM, UGX, UZS, UYU, PHP, DJF, XAF, XOF, HRK, CZK, CLP, LKR, EEK, ETB, RSD, ZAR, KRW, NAD, TL, UE

CartDeliveryDTO

Delivery information.

Name	Description
address	Type: DeliveryAddressWithoutPersonalDataDTO Only for the DBS model The delivery address. It is transmitted if the buyer has already specified the address on the Market. Address.
estimated	Type: boolean Only for the DBS model A flag that indicates that the delivery date for the order has not been confirmed. It is transmitted for products on order with a long delivery time (31-60 days). The final delivery date must be sent to Yandex.Market within 7 days from the date the order was placed in the request. PUT campaigns/{campaignId}/orders/{orderId}/delivery/date.
region	Type: ShopRegionDTO The delivery region.

CartItemDTO

Items in the shopping cart.

Name	Description
count	Type: integer The number of product units.
feedCategoryId	Type: string The ID of the category specified in the folder. The store should not transmit this identifier in the response. Leave it empty.
feedId	Type: integer<int64> ID of the product catalog. The store must specify the same identifier in the response.
fulfilmentShopId	Type: integer<int64> Only for the DBS model The product supplier's ID. To find out, log in to the seller's account on the Market and click on its name. The ID is specified in the field Store ID in the row of the desired warehouse.
id	Type: integer<int64> The ID of the product in the shopping cart.
offerId	Type: string The ID of your product offer for a specific product. Description of the field in the Help of the Market for sellers Min length: `1` Max length: `255` Pattern: `^(?=.\S.)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$`
offerName	Type: string Only for the DBS model Product name.
partnerWarehouseId	Type: string This parameter is deprecated. Don't use it. Only for the FBS model The ID of the warehouse in the partner's system that the order was placed for.
price	Type: number<decimal> The price of the product in the order currency, excluding remuneration to the partner for discounts on promo codes, coupons and promotions (parameter `subsidy`).
promos	Type: OrderItemPromoDTO[] Information about partner rewards for product discounts using promo codes, coupons, and promotions.
shopSku	Type: string Your SKU is the product identifier in your system. SKU Usage Rules: Each product must have its own SKU. An already set SKU cannot be released and reused for another product. Each product should receive a new identifier that has never been used in your catalog before. The SKU of the product can be changed in the seller's account on the Market. Read about how to do this. in the Help of the Market for sellers. What is a SKU and how to assign it Min length: `1` Max length: `255` Pattern: `^(?=.\S.)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$`
subsidy ⦸	Type: number<decimal> This parameter is deprecated. Don't use it. The total remuneration to the partner for all discounts on the product: by promo codes; by coupons; by Plus points; on shares.
warehouseId	Type: integer<int64> Only for the FBS model The ID of the warehouse on the Market.

DeliveryAddressWithoutPersonalDataDTO

The delivery address. Passed if the parameter type it matters DELIVERY.

Name	Description
apartment	Type: string Apartment or office.
block	Type: string A building or building.
city	Type: string A city or locality. Required parameter.
country	Type: string A country. Required parameter.
district	Type: string District.
entrance	Type: string Entrance.
entryphone	Type: string The intercom code.
floor	Type: string Floor.
house	Type: string A house or a possession. Required parameter.
lat	Type: number<decimal> Width. This parameter is specified if the customer has chosen to deliver the order to a branded Market pick-up point. We do not guarantee that it will be filled in, as this is an optional field.
lon	Type: number<decimal> Longitude. This parameter is specified if the customer has chosen to deliver the order to a branded Market pick-up point. We do not guarantee that it will be filled in, as this is an optional field.
notes	Type: string A note to the address. For example, `Entrance from the courtyard`. This parameter is specified if the customer has chosen to deliver the order to a branded Market pick-up point.
outletPhones	Type: string[] Phone numbers of the pick-up point in the format `8 812 123-45-67 890` (`890` — extension). This parameter is specified if the customer has chosen to deliver the order to a branded Market pick-up point.
postcode	Type: string Postal code. Indicated if mail delivery is selected (`delivery type=POST`).
schedule	Type: ShopOutletScheduleItemDTO[] The opening hours of the pick-up point. This parameter is specified if the customer has chosen to deliver the order to a branded Market pick-up point. The opening hours of the point of sale.
street	Type: string Street.
subway	Type: string The metro station.

ShopRegionDTO

The delivery region.

Name	Description
name*	Type: string The name of the region.
type*	Type: ShopRegionType The type of region. Enum: `OTHER`, `CITY_DISTRICT`, `CITY`, `CONTINENT`, `COUNTRY_DISTRICT`, `COUNTRY`, `REGION`, `METRO_STATION`, `MONORAIL_STATION`, `OVERSEAS_TERRITORY`, `SECONDARY_DISTRICT`, `SETTLEMENT`, `SUBJECT_FEDERATION`, `SUBJECT_FEDERATION_DISTRICT`, `VILLAGE`, `SUBURB`
id	Type: integer<int64> ID of the region.
parent	Type: ShopRegionDTO Information about the parent region. Parent regions are specified up to the country level.

OrderItemPromoDTO

Information about partner rewards for product discounts using promo codes, coupons, and promotions.

Name	Description
type*	Type: OrderPromoType The type of discount. Enum: `DIRECT_DISCOUNT`, `BLUE_SET`, `BLUE_FLASH`, `GENERIC_BUNDLE`, `MARKET_COUPON`, `MARKET_PROMOCODE`, `MARKET_BLUE`, `MARKET_COIN`, `PRICE_DROP_AS_YOU_SHOP`, `SECRET_SALE`, `CHEAPEST_AS_GIFT`, `CASHBACK`, `SPREAD_DISCOUNT_COUNT`, `SPREAD_DISCOUNT_RECEIPT`, `DISCOUNT_BY_PAYMENT_TYPE`, `PERCENT_DISCOUNT`, `DCO_EXTRA_DISCOUNT`, `UNKNOWN`
marketPromoId	Type: string The identifier of the promotion within the framework of the agreement for the provision of services for the promotion of the service between the Market and the partner.
subsidy	Type: number<decimal> Reward a partner from Yandex. Market for an item sold as part of the promotion.

ShopOutletScheduleItemDTO

The opening hours of the point of sale.

Name	Description
fromDay*	Type: DayOfWeekType The day of the week on which the pick-up point starts working: `MONDAY` — Monday. `TUESDAY` "Tuesday." `WEDNESDAY` — Wednesday. `THURSDAY` — Thursday. `FRIDAY` — Friday. `SATURDAY` "Saturday." `SUNDAY` — Sunday. Required parameter. Enum: `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY`, `SUNDAY`
fromTime*	Type: string The start time of the pick-up point. Time format: 24-hour, `HH:MM`. Required parameter. Min length: `1`
toDay*	Type: DayOfWeekType The day of the week on which the pick-up point stops working: `MONDAY` — Monday. `TUESDAY` "Tuesday." `WEDNESDAY` — Wednesday. `THURSDAY` — Thursday. `FRIDAY` — Friday. `SATURDAY` "Saturday." `SUNDAY` — Sunday. Required parameter. Enum: `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY`, `SUNDAY`
toTime*	Type: string The end time of the pick-up point. Time format: 24-hour, `HH:MM`. Required parameter. Min length: `1`

ShopRegionType

Type of region:

CITY_DISTRICT — the area of the city.
CITY — a large city.
CONTINENT — the continent.
COUNTRY_DISTRICT — the federal district.
COUNTRY — country.
REGION — region.
METRO_STATION — the metro station.
MONORAIL_STATION — monorail station.
OVERSEAS_TERRITORY — a separate territory of a state located in another part of the world (for example, Anguilla, Greenland, Bermuda, etc.).
SECONDARY_DISTRICT — the second-level city district (for example, for the Moscow Autonomous District, the second-level districts are Izmailovo, Novokosino, Perovo, etc.).
SETTLEMENT — settlement.
SUBJECT_FEDERATION — the subject of the Federation.
SUBJECT_FEDERATION_DISTRICT — district of the subject of the federation.
VILLAGE — the city.
SUBURB — the suburbs.
OTHER — unknown region.

Type	Description
ShopRegionType	Enum: `OTHER`, `CITY_DISTRICT`, `CITY`, `CONTINENT`, `COUNTRY_DISTRICT`, `COUNTRY`, `REGION`, `METRO_STATION`, `MONORAIL_STATION`, `OVERSEAS_TERRITORY`, `SECONDARY_DISTRICT`, `SETTLEMENT`, `SUBJECT_FEDERATION`, `SUBJECT_FEDERATION_DISTRICT`, `VILLAGE`, `SUBURB`

OrderPromoType

Discount type:

DIRECT_DISCOUNT — direct discount, which is set by the seller or the Market.
BLUE_SET — kits.
BLUE_FLASH — flash promotion.
MARKET_COUPON — discount on the promo code of the Market.
MARKET_PROMOCODE — discount on the store's promo code.
MARKET_BLUE — discount on the Market.
CHEAPEST_AS_GIFT — the cheapest item as a gift.
CASHBACK — cashback.
SPREAD_DISCOUNT_COUNT — discount for the number of identical items.
SPREAD_DISCOUNT_RECEIPT — discount on the amount of the receipt.
DISCOUNT_BY_PAYMENT_TYPE — direct discount when paying with a Plus card.
PERCENT_DISCOUNT — direct percentage discount.
DCO_EXTRA_DISCOUNT — an additional discount required to calculate the subsidy from the Market.
UNKNOWN — unknown type.

Obsolete types:

GENERIC_BUNDLE.
MARKET_COIN.
PRICE_DROP_AS_YOU_SHOP.
SECRET_SALE.

Type	Description
OrderPromoType	Enum: `DIRECT_DISCOUNT`, `BLUE_SET`, `BLUE_FLASH`, `GENERIC_BUNDLE`, `MARKET_COUPON`, `MARKET_PROMOCODE`, `MARKET_BLUE`, `MARKET_COIN`, `PRICE_DROP_AS_YOU_SHOP`, `SECRET_SALE`, `CHEAPEST_AS_GIFT`, `CASHBACK`, `SPREAD_DISCOUNT_COUNT`, `SPREAD_DISCOUNT_RECEIPT`, `DISCOUNT_BY_PAYMENT_TYPE`, `PERCENT_DISCOUNT`, `DCO_EXTRA_DISCOUNT`, `UNKNOWN`

DayOfWeekType

Day of the week:

MONDAY — Monday.
TUESDAY "Tuesday."
WEDNESDAY — Wednesday.
THURSDAY — Thursday.
FRIDAY — Friday.
SATURDAY "Saturday."
SUNDAY — Sunday.

Type	Description
DayOfWeekType	Enum: `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY`, `SUNDAY`

Responses

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 shopping cart 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 according to the DBS model until the next data update on the service (indexing occurs 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 basket 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 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 — the 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

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: CartResponseDTO

Basket.

CartResponseDTO

Name	Description
deliveryCurrency	Type: CurrencyType Only for the DBS model The currency in which the prices of the goods in the order are indicated. Takes the value `RUR` — Russian ruble. Enum: `RUR`, `USD`, `EUR`, `UAH`, `AUD`, `GBP`, `BYR`, `BYN`, `DKK`, `ISK`, `KZT`, `CAD`, `CNY`, `NOK`, `XDR`, `SGD`, `TRY`, `SEK`, `CHF`, `JPY`, `AZN`, `ALL`, `DZD`, `AOA`, `ARS`, `AMD`, `AFN`, `BHD`, `BGN`, `BOB`, `BWP`, `BND`, `BRL`, `BIF`, `HUF`, `VEF`, `KPW`, `VND`, `GMD`, `GHS`, `GNF`, `HKD`, `GEL`, `AED`, `EGP`, `ZMK`, `ILS`, `INR`, `IDR`, `JOD`, `IQD`, `IRR`, `YER`, `QAR`, `KES`, `KGS`, `COP`, `CDF`, `CRC`, `KWD`, `CUP`, `LAK`, `LVL`, `SLL`, `LBP`, `LYD`, `SZL`, `LTL`, `MUR`, `MRO`, `MKD`, `MWK`, `MGA`, `MYR`, `MAD`, `MXN`, `MZN`, `MDL`, `MNT`, `NPR`, `NGN`, `NIO`, `NZD`, `OMR`, `PKR`, `PYG`, `PEN`, `PLN`, `KHR`, `SAR`, `RON`, `SCR`, `SYP`, `SKK`, `SOS`, `SDG`, `SRD`, `TJS`, `THB`, `TWD`, `BDT`, `TZS`, `TND`, `TMM`, `UGX`, `UZS`, `UYU`, `PHP`, `DJF`, `XAF`, `XOF`, `HRK`, `CZK`, `CLP`, `LKR`, `EEK`, `ETB`, `RSD`, `ZAR`, `KRW`, `NAD`, `TL`, `UE`
deliveryOptions	Type: CartResponseDeliveryOptionDTO[] Only for the DBS model Delivery options available for the shopping cart.
items	Type: CartResponseItemDTO[] Items in the shopping cart.
paymentMethods	Type: OrderPaymentMethodType[] Order payment method: Values if payment is selected at checkout (`"paymentType": "PREPAID"`): `YANDEX` — by bank card. `APPLE_PAY` — Apple Pay. `GOOGLE_PAY` — Google Pay. `CREDIT` — on credit. `TINKOFF_CREDIT` — on credit at Tinkoff Bank. `TINKOFF_INSTALLMENTS` — installments at Tinkoff Bank. `EXTERNAL_CERTIFICATE` — a gift certificate (for example, from the Sberbank Online application). `SBP` — through the fast payment system. `B2B_ACCOUNT_PREPAYMENT` — the organization pays for the order. Values if payment is selected upon receipt of the order (`"paymentType": "POSTPAID"`): `CARD_ON_DELIVERY` — by bank card. `BOUND_CARD_ON_DELIVERY` — linked bank card upon receipt. `BNPL_BANK_ON_DELIVERY` — super Split. `BNPL_ON_DELIVERY` — Split. `CASH_ON_DELIVERY` — in cash. `B2B_ACCOUNT_POSTPAYMENT` — the order is paid for by the organization after delivery. `UNKNOWN` — unknown type. Default value: `CASH_ON_DELIVERY`. Enum: `SHOP_PREPAID`, `BANK_CARD`, `YANDEX_MONEY`, `CASH_ON_DELIVERY`, `CARD_ON_DELIVERY`, `BOUND_CARD_ON_DELIVERY`, `BNPL_BANK_ON_DELIVERY`, `BNPL_ON_DELIVERY`, `YANDEX`, `APPLE_PAY`, `EXTERNAL_CERTIFICATE`, `CREDIT`, `INSTALLMENT`, `GOOGLE_PAY`, `TINKOFF_CREDIT`, `SBP`, `TINKOFF_INSTALLMENTS`, `B2B_ACCOUNT_PREPAYMENT`, `B2B_ACCOUNT_POSTPAYMENT`, `UNKNOWN`

CartResponseDeliveryOptionDTO

Name	Description
serviceName*	Type: string The name of the delivery service. Required parameter. Maximum length: 50 characters.
dates	Type: CartResponseDeliveryDatesDTO The range of delivery dates. The maximum number of dates is 7. Max items: `7`
id	Type: string The delivery option ID assigned by the store. If the ID is specified, it will be passed back to the store in the request. POST order/accept. Maximum length: 50 characters.
outlets	Type: CartResponseOutletDTO[] Pick-up points. Indicated if pickup is selected (`"type"`: `"PICKUP"`). Specify in the parameter `outlets` ids of all pick-up points. If you specify non-existent pick-up point IDs, the delivery option will be ignored and its ID will not be included in the request. POST order/accept.
paymentMethods	Type: OrderPaymentMethodType[] Order payment method: Values if payment is selected at checkout (`"paymentType": "PREPAID"`): `YANDEX` — by bank card. `APPLE_PAY` — Apple Pay. `GOOGLE_PAY` — Google Pay. `CREDIT` — on credit. `TINKOFF_CREDIT` — on credit at Tinkoff Bank. `TINKOFF_INSTALLMENTS` — installments at Tinkoff Bank. `EXTERNAL_CERTIFICATE` — a gift certificate (for example, from the Sberbank Online application). `SBP` — through the fast payment system. `B2B_ACCOUNT_PREPAYMENT` — the organization pays for the order. Values if payment is selected upon receipt of the order (`"paymentType": "POSTPAID"`): `CARD_ON_DELIVERY` — by bank card. `BOUND_CARD_ON_DELIVERY` — linked bank card upon receipt. `BNPL_BANK_ON_DELIVERY` — super Split. `BNPL_ON_DELIVERY` — Split. `CASH_ON_DELIVERY` — in cash. `B2B_ACCOUNT_POSTPAYMENT` — the order is paid for by the organization after delivery. `UNKNOWN` — unknown type. Default value: `CASH_ON_DELIVERY`. Enum: `SHOP_PREPAID`, `BANK_CARD`, `YANDEX_MONEY`, `CASH_ON_DELIVERY`, `CARD_ON_DELIVERY`, `BOUND_CARD_ON_DELIVERY`, `BNPL_BANK_ON_DELIVERY`, `BNPL_ON_DELIVERY`, `YANDEX`, `APPLE_PAY`, `EXTERNAL_CERTIFICATE`, `CREDIT`, `INSTALLMENT`, `GOOGLE_PAY`, `TINKOFF_CREDIT`, `SBP`, `TINKOFF_INSTALLMENTS`, `B2B_ACCOUNT_PREPAYMENT`, `B2B_ACCOUNT_POSTPAYMENT`, `UNKNOWN`
price	Type: number<decimal> The cost of delivery in the currency of the order. Starting from July 1, 2021, uniform shipping tariffs will be introduced for customers. The shipping cost will be the same regardless it depends on who delivers the order: the Market or the seller himself. It will be substituted automatically from a single tariff schedule. Shipping cost data transmitted via the API will not be taken into account. However, it is still necessary to provide the Market with information about the delivery time. For more information, see the Yandex.Market Help for Sellers
type	Type: OrderDeliveryType Order delivery method: `DELIVERY` — courier delivery. `PICKUP` — pickup. `POST` — mail. `DIGITAL` — for digital goods. `UNKNOWN` — unknown type. Enum: `DELIVERY`, `PICKUP`, `POST`, `DIGITAL`, `UNKNOWN`

CartResponseItemDTO

Name	Description
count	Type: integer The quantity of the product that is available for order. What is the value to transmit: In the request in the parameter `count` The market sends the quantity of goods that the buyer needs. Depending on availability, please return: The quantity of goods required by the buyer or more — if there is an excess of goods. The available quantity of the product is if it is less than the required quantity for the buyer. The information in the shopping cart will be updated, and the buyer will be able to place an order only with the quantity of goods that is available. `0` — if the product is out of stock. You won't be able to buy it. If you enabled the option to ignore balances through support, return any value, including `0`. The buyer will place an order with the quantity of the product specified in the shopping cart.
delivery	Type: boolean Only for the DBS model Delivery of the product to the region specified in the request: `false` — the product is not being delivered to the specified region. `true` — default value, the product is delivered to the specified region.
feedId	Type: integer<int64> ID of the product catalog. You need to specify the same identifier as in the request from Yandex.Market.
offerId	Type: string Your SKU is the product identifier in your system. SKU Usage Rules: Each product must have its own SKU. An already set SKU cannot be released and reused for another product. Each product should receive a new identifier that has never been used in your catalog before. The SKU of the product can be changed in the seller's account on the Market. Read about how to do this. in the Help of the Market for sellers. What is a SKU and how to assign it Min length: `1` Max length: `255` Pattern: `^(?=.\S.)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$`
sellerInn	Type: string Only for the DBS model INN of the seller of the product.

OrderPaymentMethodType

Order payment method:

Values if payment is selected at checkout ("paymentType": "PREPAID"):
- YANDEX — by bank card.
- APPLE_PAY — Apple Pay.
- GOOGLE_PAY — Google Pay.
- CREDIT — on credit.
- TINKOFF_CREDIT — on credit at Tinkoff Bank.
- TINKOFF_INSTALLMENTS — installments at Tinkoff Bank.
- EXTERNAL_CERTIFICATE — a gift certificate (for example, from the Sberbank Online application).
- SBP — through the fast payment system.
- B2B_ACCOUNT_PREPAYMENT — the organization pays for the order.
Values if payment is selected upon receipt of the order ("paymentType": "POSTPAID"):
- CARD_ON_DELIVERY — by bank card.
- BOUND_CARD_ON_DELIVERY — linked bank card upon receipt.
- BNPL_BANK_ON_DELIVERY — super Split.
- BNPL_ON_DELIVERY — Split.
- CASH_ON_DELIVERY — in cash.
- B2B_ACCOUNT_POSTPAYMENT — the order is paid for by the organization after delivery.
UNKNOWN — unknown type.

Default value: CASH_ON_DELIVERY.

Type	Description
OrderPaymentMethodType	Enum: `SHOP_PREPAID`, `BANK_CARD`, `YANDEX_MONEY`, `CASH_ON_DELIVERY`, `CARD_ON_DELIVERY`, `BOUND_CARD_ON_DELIVERY`, `BNPL_BANK_ON_DELIVERY`, `BNPL_ON_DELIVERY`, `YANDEX`, `APPLE_PAY`, `EXTERNAL_CERTIFICATE`, `CREDIT`, `INSTALLMENT`, `GOOGLE_PAY`, `TINKOFF_CREDIT`, `SBP`, `TINKOFF_INSTALLMENTS`, `B2B_ACCOUNT_PREPAYMENT`, `B2B_ACCOUNT_POSTPAYMENT`, `UNKNOWN`

CartResponseDeliveryDatesDTO

Name	Description
fromDate	Type: string<date-dd-MM-yyyy> The nearest possible delivery date. Date format: `DD-MM-YYYY`. The date must be no earlier than the current date and no later than 31 calendar days from the current date. Example: `23-09-2022`
intervals	Type: CartResponseDeliveryIntervalDTO[] A list of possible delivery dates and time intervals on the specified day. The parameter can specify up to 7 intervals for each date. This parameter is required for courier delivery (`"type"`: `"DELIVERY"`). Must be specified along with the parameters `toDate` and `fromDate`. Max items: `7`
toDate	Type: string<date-dd-MM-yyyy> The latest delivery date. Format: `DD-MM-YYYY`. The date must be no earlier than the date specified in the parameter. `fromDate`,and no later than 31 calendar days from the current date. If the parameter `toDate` if not specified, then the only possible delivery date is the date specified in the parameter `fromDate`. Example: `23-09-2022`

CartResponseOutletDTO

Name

Description

code*

Type: string

The pick-up point ID assigned by the store.

If a non-existent identifier is specified, such a pick-up point is not displayed to the buyer when placing the order.

OrderDeliveryType

Order delivery method:

DELIVERY — courier delivery.
PICKUP — pickup.
POST — mail.
DIGITAL — for digital goods.
UNKNOWN — unknown type.

Type	Description
OrderDeliveryType	Enum: `DELIVERY`, `PICKUP`, `POST`, `DIGITAL`, `UNKNOWN`

CartResponseDeliveryIntervalDTO

Name	Description
fromTime*	Type: string<time> The beginning of the delivery time interval. Required parameter. Time format: 24-hour, `HH:MM`. The minutes should always be specified `00` (exception — `23:59`). Maximum value: `21:00`.
toTime*	Type: string<time> The end of the delivery time interval. Required parameter. Time format: 24-hour, `HH:MM`. The minutes should always be specified `00` (exception — `23:59`). Maximum value: `23:59`.
date	Type: string<date-dd-MM-yyyy> Possible delivery date. Date format: `DD-MM-YYYY`. Example: `23-09-2022`

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.

Requesting information about products

Request

Body

CartDTO

CurrencyType

CartDeliveryDTO

CartItemDTO

DeliveryAddressWithoutPersonalDataDTO

ShopRegionDTO

OrderItemPromoDTO

ShopOutletScheduleItemDTO

ShopRegionType

OrderPromoType

DayOfWeekType

Responses

200 OK

Body

CartResponseDTO

CartResponseDeliveryOptionDTO

CartResponseItemDTO

OrderPaymentMethodType

CartResponseDeliveryDatesDTO

CartResponseOutletDTO

OrderDeliveryType

CartResponseDeliveryIntervalDTO

400 Bad Request

500 Internal Server Error

Was the article helpful?