С 31 декабря push-API методы будут недоступны. С 1 октября они могут работать нестабильно.

Запросы, с помощью которых нужно передавать информацию:

Чтобы получать информацию о заказах, подключите 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",
                "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

Корзина.

CartDTO

Корзина.

Name

Description

businessId

Type: integer<int64>

Идентификатор кабинета.

buyer

Type: object

Информация о покупателе.

Параметры id, lastName, firstName и middleName возвращаются, только если вы работаете по модели DBS.

currency

Type: CurrencyType

Валюта, в которой указаны цены на товары в заказе.

Принимает значение RUR — российский рубль.

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

Информация о доставке.

deliveryCurrency

Type: CurrencyType

Только для модели DBS

Валюта, в которой указаны цены на товары в заказе.

Принимает значение RUR — российский рубль.

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[]

Товары в корзине.

CurrencyType

Коды валют:

  • RUR — российский рубль.
  • UAH — украинская гривна.
  • BYR — белорусский рубль.
  • KZT — казахстанский тенге.
  • UZS — узбекский сум.

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

Информация о доставке.

Name

Description

address

Type: DeliveryAddressWithoutPersonalDataDTO

Только для модели DBS

Адрес доставки. Передается, если покупатель уже указал адрес на Маркете.
Адрес.

estimated

Type: boolean

Только для модели DBS

Признак, который показывает, что дата доставки по заказу не подтверждена. Передается для товаров на заказ с долгим сроком доставки (31–60 дней). Окончательную дату доставки нужно передать Маркету в течение 7 дней с даты оформления заказа в запросе PUT v2/campaigns/{campaignId}/orders/{orderId}/delivery/date.

region

Type: ShopRegionDTO

Регион доставки.

CartItemDTO

Товары в корзине.

Name

Description

count

Type: integer

Количество единиц товара.

feedCategoryId

Type: string

Идентификатор категории, указанный в каталоге.

В ответе магазин не должен передавать этот идентификатор. Оставьте его пустым.

feedId

Type: integer<int64>

Идентификатор каталога товаров.

В ответе магазин должен указать тот же идентификатор.

fulfilmentShopId

Type: integer<int64>

Только для модели DBS

Идентификатор поставщика товара.

Чтобы узнать его, войдите в кабинет продавца на Маркете и нажмите на его название. Идентификатор указан в поле ID магазина в строке нужного склада.

id

Type: integer<int64>

Идентификатор товара в корзине.

offerId

Type: string

Идентификатор вашего товарного предложения для определенного товара. Описание поля в Справке Маркета для продавцов

Min length: 1

Max length: 255

Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

offerName

Type: string

Только для модели DBS

Название товара.

partnerWarehouseId

⦸

Type: string

Только для модели FBS

Идентификатор склада в системе магазина, на который сформирован заказ.

price

⦸

Type: number<decimal>

Цена товара в валюте заказа без учета вознаграждения продавцу за скидки по промокодам, купонам и акциям (параметр subsidy).

promos

Type: OrderItemPromoDTO[]

Информация о вознаграждениях продавцу за скидки на товар по промокодам, купонам и акциям.

shopSku

Type: string

Ваш SKU — идентификатор товара в вашей системе.

Правила использования SKU:

  • У каждого товара SKU должен быть свой.

  • Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге.

SKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте в Справке Маркета для продавцов.

Что такое SKU и как его назначать

Min length: 1

Max length: 255

Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

subsidy

⦸

Type: number<decimal>

Общее вознаграждение продавцу за все скидки на товар:

  • по промокодам;
  • по купонам;
  • по баллам Плюса;
  • по акциям.

warehouseId

Type: integer<int64>

Только для модели FBS

Идентификатор склада на Маркете.

DeliveryAddressWithoutPersonalDataDTO

Адрес доставки. Передается, если параметр type имеет значение DELIVERY.

Name

Description

apartment

Type: string

Номер квартиры или офиса.

block

Type: string

Корпус или строение.

city

Type: string

Город или населенный пункт.

Обязательный параметр.

country

Type: string

Страна.

Необязательный параметр, если выбрана доставка заказа в пункт выдачи Маркета.

district

Type: string

Район.

entrance

Type: string

Номер подъезда.

entryphone

Type: string

Код домофона.

floor

Type: string

Этаж.

house

Type: string

Номер дома или владения.

Обязательный параметр.

lat

Type: number<decimal>

Широта.

Параметр указывается, если покупатель выбрал доставку заказа в брендированный пункт выдачи Маркета.

Не гарантируем заполнение, так как это опциональное поле.

lon

Type: number<decimal>

Долгота.

Параметр указывается, если покупатель выбрал доставку заказа в брендированный пункт выдачи Маркета.

Не гарантируем заполнение, так как это опциональное поле.

notes

Type: string

Примечание к адресу. Например, Вход со двора.

Параметр указывается, если покупатель выбрал доставку заказа в брендированный пункт выдачи Маркета.

outletPhones

Type: string[]

Телефоны пункта выдачи в формате 8 812 123-45-67 890 (890 — добавочный).

Параметр указывается, если покупатель выбрал доставку заказа в брендированный пункт выдачи Маркета.

postcode

Type: string

Почтовый индекс.

Указывается, если выбрана доставка почтой (delivery type=POST).

schedule

Type: ShopOutletScheduleItemDTO[]

Расписание работы пункта выдачи.

Параметр указывается, если покупатель выбрал доставку заказа в брендированный пункт выдачи Маркета.
Расписание работы точки продаж.

street

Type: string

Улица.

subway

Type: string

Станция метро.

ShopRegionDTO

Регион доставки.

Name

Description

name*

Type: string

Название региона.

type*

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

id

Type: integer<int64>

Идентификатор региона.

parent

Type: ShopRegionDTO

Информация о родительском регионе.

Указываются родительские регионы до уровня страны.

OrderItemPromoDTO

Информация о вознаграждениях продавцу за скидки на товар по промокодам, купонам и акциям.

Name

Description

type*

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

marketPromoId

Type: string

Идентификатор акции в рамках соглашения на оказание услуг по продвижению сервиса между Маркетом и продавцом.

subsidy

Type: number<decimal>

Вознаграждение продавцу от Маркета за товар, проданный в рамках акции.

ShopOutletScheduleItemDTO

Расписание работы точки продаж.

Name

Description

fromDay*

Type: DayOfWeekType

День недели, в который пункт выдачи начинает работать:

  • MONDAY — понедельник.
  • TUESDAY — вторник.
  • WEDNESDAY — среда.
  • THURSDAY — четверг.
  • FRIDAY — пятница.
  • SATURDAY — суббота.
  • SUNDAY — воскресенье.

Обязательный параметр.

Enum: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY

fromTime*

Type: string

Время начала работы пункта выдачи. Формат времени: 24-часовой, ЧЧ:ММ.

Обязательный параметр.

Min length: 1

toDay*

Type: DayOfWeekType

День недели, в который пункт выдачи заканчивает работать:

  • MONDAY — понедельник.
  • TUESDAY — вторник.
  • WEDNESDAY — среда.
  • THURSDAY — четверг.
  • FRIDAY — пятница.
  • SATURDAY — суббота.
  • SUNDAY — воскресенье.

Обязательный параметр.

Enum: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY

toTime*

Type: string

Время окончания работы пункта выдачи. Формат времени: 24-часовой, ЧЧ:ММ.

Обязательный параметр.

Min length: 1

ShopRegionType

Тип региона:

  • CITY_DISTRICT — район города.

  • CITY — крупный город.

  • CONTINENT — континент.

  • COUNTRY_DISTRICT — федеральный округ.

  • COUNTRY — страна.

  • REGION — регион.

  • METRO_STATION — станция метро.

  • MONORAIL_STATION — станция монорельса.

  • OVERSEAS_TERRITORY — отдельная территория какого-либо государства, расположенная в другой части света (например, Ангилья, Гренландия, Бермудские острова и т. д.).

  • SECONDARY_DISTRICT — район города второго уровня (например, для ВАО Москвы районами второго уровня являются Измайлово, Новокосино, Перово и т. д.).

  • SETTLEMENT — поселение.

  • SUBJECT_FEDERATION — субъект федерации.

  • SUBJECT_FEDERATION_DISTRICT — район субъекта федерации.

  • VILLAGE — город.

  • SUBURB — пригород.

  • OTHER — неизвестный регион.

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

Тип скидки:

  • DIRECT_DISCOUNT — прямая скидка, которую устанавливает продавец или Маркет.

  • BLUE_SET — комплекты.

  • BLUE_FLASH — флеш-акция.

  • MARKET_COUPON — скидка по промокоду Маркета.

  • MARKET_PROMOCODE — скидка по промокоду магазина.

  • MARKET_BLUE — скидка на Маркете.

  • CHEAPEST_AS_GIFT — самый дешевый товар в подарок.

  • CASHBACK — кешбэк.

  • SPREAD_DISCOUNT_COUNT — скидка за количество одинаковых товаров.

  • SPREAD_DISCOUNT_RECEIPT — скидка от суммы чека.

  • DISCOUNT_BY_PAYMENT_TYPE — прямая скидка при оплате картой Плюса.

  • PERCENT_DISCOUNT — прямая скидка в процентах.

  • DCO_EXTRA_DISCOUNT — дополнительная скидка, необходимая для расчета субсидии от Маркета.

  • UNKNOWN — неизвестный тип.

Устаревшие типы:

  • 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

День недели:

  • MONDAY — понедельник.
  • TUESDAY — вторник.
  • WEDNESDAY — среда.
  • THURSDAY — четверг.
  • FRIDAY — пятница.
  • SATURDAY — суббота.
  • SUNDAY — воскресенье.

Type

Description

DayOfWeekType

Enum: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY

Responses

200 OK

Актуальные данные о доступности товаров для переданной корзины и указанного региона доставки.

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

Укажите пустые опции доставки: "deliveryOptions": []. В параметре items для каждого товара параметр delivery передавать необязательно.

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

Для таких товаров укажите "delivery": false в параметре items.

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

Укажите для товара параметр "count": 0. Если все товары из корзины отсутствуют в продаже, передайте параметр items пустым.

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

Через 10–15 минут это предложение перестает отображаться на Маркете по модели DBS до следующего обновления данных на сервисе (индексация происходит каждые 4 часа).

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

Укажите параметр count="0", вложенный в параметр items. Если все товары из корзины отсутствуют в продаже, передайте параметр items пустым.

Пример

Для удобства чтения пример кода приведен в сокращенном формате.

{
  "cart":
  {
    "items":
    [
      {
        "feedId": {int64},
        "offerId": "{string}",
        "count": {int32},
        "delivery": {boolean}
      },
      ...
    ]
  }
}
Как передавать информацию о доставке в пункты самовывоза (DBS)

Укажите в параметре outlets идентификаторы всех пунктов самовывоза, в которых товар уже есть в наличии и в которые вы можете доставить товар, если его там еще нет. Нужно указать все подходящие пункты самовывоза в регионе, указанном в запросе в параметре 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"
}

10 марта, 00:00–23:59

 
"type": "PICKUP",
"dates":
{
  "fromDate": "01-03-2021",
  "toDate": "03-03-2021"
}

1 марта, 00:00 — 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

Корзина.

CartResponseDTO

Name

Description

deliveryCurrency

Type: CurrencyType

Только для модели DBS

Валюта, в которой указаны цены на товары в заказе.

Принимает значение RUR — российский рубль.

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[]

Только для модели DBS

Опции доставки, доступные для корзины.

items

Type: CartResponseItemDTO[]

Товары в корзине.

paymentMethods

Type: OrderPaymentMethodType[]

Способ оплаты заказа:

  • Значения, если выбрана оплата при оформлении заказа ("paymentType": "PREPAID"):

    • YANDEX — банковской картой.

    • APPLE_PAY — Apple Pay.

    • GOOGLE_PAY — Google Pay.

    • CREDIT — в кредит.

    • TINKOFF_CREDIT — в кредит в Тинькофф Банке.

    • TINKOFF_INSTALLMENTS — рассрочка в Тинькофф Банке.

    • EXTERNAL_CERTIFICATE — подарочным сертификатом (например, из приложения «Сбербанк Онлайн»).

    • SBP — через систему быстрых платежей.

    • B2B_ACCOUNT_PREPAYMENT — заказ оплачивает организация.

  • Значения, если выбрана оплата при получении заказа ("paymentType": "POSTPAID"):

    • CARD_ON_DELIVERY — банковской картой.

    • BOUND_CARD_ON_DELIVERY — привязанной картой при получении.

    • BNPL_BANK_ON_DELIVERY — супер Сплитом.

    • BNPL_ON_DELIVERY — Сплитом.

    • CASH_ON_DELIVERY — наличными.

    • B2B_ACCOUNT_POSTPAYMENT — заказ оплачивает организация после доставки.

  • UNKNOWN — неизвестный тип.

Значение по умолчанию: 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

Наименование службы доставки. Обязательный параметр. Максимальная длина: 50 символов.

dates

Type: CartResponseDeliveryDatesDTO

Диапазон дат доставки. Максимальное количество дат — 7.

Max items: 7

id

Type: string

Идентификатор опции доставки, присвоенный магазином. Если идентификатор указан, он будет передан обратно магазину в запросе POST order/accept. Максимальная длина: 50 символов.

outlets

Type: CartResponseOutletDTO[]

Пункты самовывоза. Указывается, если выбран самовывоз ("type": "PICKUP"). Укажите в параметре outlets идентификаторы всех пунктов самовывоза. Если вы укажете несуществующие идентификаторы пунктов самовывоза, то опция доставки проигнорируется и ее идентификатор не придет в запросе POST order/accept.

paymentMethods

Type: OrderPaymentMethodType[]

Способ оплаты заказа:

  • Значения, если выбрана оплата при оформлении заказа ("paymentType": "PREPAID"):

    • YANDEX — банковской картой.

    • APPLE_PAY — Apple Pay.

    • GOOGLE_PAY — Google Pay.

    • CREDIT — в кредит.

    • TINKOFF_CREDIT — в кредит в Тинькофф Банке.

    • TINKOFF_INSTALLMENTS — рассрочка в Тинькофф Банке.

    • EXTERNAL_CERTIFICATE — подарочным сертификатом (например, из приложения «Сбербанк Онлайн»).

    • SBP — через систему быстрых платежей.

    • B2B_ACCOUNT_PREPAYMENT — заказ оплачивает организация.

  • Значения, если выбрана оплата при получении заказа ("paymentType": "POSTPAID"):

    • CARD_ON_DELIVERY — банковской картой.

    • BOUND_CARD_ON_DELIVERY — привязанной картой при получении.

    • BNPL_BANK_ON_DELIVERY — супер Сплитом.

    • BNPL_ON_DELIVERY — Сплитом.

    • CASH_ON_DELIVERY — наличными.

    • B2B_ACCOUNT_POSTPAYMENT — заказ оплачивает организация после доставки.

  • UNKNOWN — неизвестный тип.

Значение по умолчанию: 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>

Стоимость доставки в валюте заказа. C 1 июля 2021 вводятся единые тарифы на доставку для покупателей. Стоимость доставки будет одинакова независимо от того, кто доставляет заказ: Маркет или сам продавец. Она подставится автоматически из единой тарифной сетки. Данные о стоимости доставки, переданные через API, не будут учитываться. При этом все так же необходимо передавать Маркету информацию о сроках доставки. Подробнее в Справке Маркета для продавцов

type

Type: OrderDeliveryType

Способ доставки заказа:

  • DELIVERY — курьерская доставка.

  • PICKUP — самовывоз.

  • POST — почта.

  • DIGITAL — для цифровых товаров.

  • UNKNOWN — неизвестный тип.

Enum: DELIVERY, PICKUP, POST, DIGITAL, UNKNOWN

CartResponseItemDTO

Name

Description

count

Type: integer

Количество товара, которое доступно для заказа.

Какое значение передавать:

В запросе в параметре count Маркет отправляет количество товара, которое необходимо покупателю.

В зависимости от наличия верните:

  • Необходимое покупателю количество товара или больше — если товара с избытком.

  • Доступное количество товара — если его меньше, чем необходимо покупателю. Информация в корзине обновится, покупатель сможет оформить заказ только с тем количеством товара, которое есть в наличии.

  • 0 — если товар закончился. Купить его не получится.

Если вы подключали через поддержку опцию игнорирования остатков, верните любое значение, в том числе 0. Покупатель оформит заказ с тем количеством товара, которое указано в корзине.

delivery

Type: boolean

Только для модели DBS

Доставка товара в указанный в запросе регион:

  • false — товар не доставляется в указанный регион.
  • true — значение по умолчанию, товар доставляется в указанный регион.

feedId

Type: integer<int64>

Идентификатор каталога товаров.

Нужно указать тот же идентификатор, что и в запросе от Маркета.

offerId

Type: string

Ваш SKU — идентификатор товара в вашей системе.

Правила использования SKU:

  • У каждого товара SKU должен быть свой.

  • Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге.

SKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте в Справке Маркета для продавцов.

Что такое SKU и как его назначать

Min length: 1

Max length: 255

Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

sellerInn

Type: string

Только для модели DBS

ИНН продавца товара.

OrderPaymentMethodType

Способ оплаты заказа:

  • Значения, если выбрана оплата при оформлении заказа ("paymentType": "PREPAID"):

    • YANDEX — банковской картой.

    • APPLE_PAY — Apple Pay.

    • GOOGLE_PAY — Google Pay.

    • CREDIT — в кредит.

    • TINKOFF_CREDIT — в кредит в Тинькофф Банке.

    • TINKOFF_INSTALLMENTS — рассрочка в Тинькофф Банке.

    • EXTERNAL_CERTIFICATE — подарочным сертификатом (например, из приложения «Сбербанк Онлайн»).

    • SBP — через систему быстрых платежей.

    • B2B_ACCOUNT_PREPAYMENT — заказ оплачивает организация.

  • Значения, если выбрана оплата при получении заказа ("paymentType": "POSTPAID"):

    • CARD_ON_DELIVERY — банковской картой.

    • BOUND_CARD_ON_DELIVERY — привязанной картой при получении.

    • BNPL_BANK_ON_DELIVERY — супер Сплитом.

    • BNPL_ON_DELIVERY — Сплитом.

    • CASH_ON_DELIVERY — наличными.

    • B2B_ACCOUNT_POSTPAYMENT — заказ оплачивает организация после доставки.

  • UNKNOWN — неизвестный тип.

Значение по умолчанию: 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>

Ближайшая возможная дата доставки.

Формат даты: ДД-ММ-ГГГГ.

Дата должна быть не ранее текущей даты и не позднее 31 календарного дня от текущей даты.

Example: 23-09-2022

intervals

Type: CartResponseDeliveryIntervalDTO[]

Список возможных дат и интервалов времени доставки в указанный день. В параметре можно указать до 7 интервалов для каждой даты. Параметр обязателен для курьерской доставки ("type": "DELIVERY"). Необходимо указывать вместе с параметрами toDate и fromDate.

Max items: 7

toDate

Type: string<date-dd-MM-yyyy>

Самая поздняя дата доставки. Формат: ДД-ММ-ГГГГ. Дата должна быть не ранее даты, указанной в параметре fromDate,и не позднее 31 календарного дня от текущей даты. Если параметр toDate не указан, то единственно возможной датой доставки считается дата, указанная в параметре fromDate.

Example: 23-09-2022

CartResponseOutletDTO

Name

Description

code*

Type: string

Идентификатор пункта самовывоза, присвоенный магазином.

Если указан несуществующий идентификатор, такой пункт самовывоза не выводится покупателю при оформлении заказа.

OrderDeliveryType

Способ доставки заказа:

  • DELIVERY — курьерская доставка.

  • PICKUP — самовывоз.

  • POST — почта.

  • DIGITAL — для цифровых товаров.

  • UNKNOWN — неизвестный тип.

Type

Description

OrderDeliveryType

Enum: DELIVERY, PICKUP, POST, DIGITAL, UNKNOWN

CartResponseDeliveryIntervalDTO

Name

Description

fromTime*

Type: string<time>

Начало интервала времени доставки. Обязательный параметр. Формат времени: 24-часовой, ЧЧ:ММ. В качестве минут всегда должно быть указано 00 (исключение — 23:59). Максимальное значение: 21:00.

toTime*

Type: string<time>

Конец интервала времени доставки. Обязательный параметр. Формат времени: 24-часовой, ЧЧ:ММ. В качестве минут всегда должно быть указано 00 (исключение — 23:59). Максимальное значение: 23:59.

date

Type: string<date-dd-MM-yyyy>

Возможная дата доставки.

Формат даты: ДД-ММ-ГГГГ.

Example: 23-09-2022

400 Bad Request

Если магазин считает запрос, поступающий от Маркета, некорректным, магазин должен вернуть статус ответа 400 с описанием причины ошибки в теле ответа. Такие ответы будут анализироваться на предмет нарушений и недоработок API со стороны Маркета.

500 Internal Server Error

В случае технической ошибки на стороне магазина он должен вернуть статус ответа 500. Магазины с большим количеством таких ответов могут быть отключены от Маркета.

No longer supported, please use an alternative and newer version.