Запрос информации о товарах

Модель FBS: не используйте метод POST cart. Эта возможность отключена.

Модель DBS:

  • Если вы продаете цифровые товары, обязательно прочтите инструкцию.
  • Если вы не продаете цифровые товары, не используйте метод POST cart. Отключите эту возможность в кабинете — в левом нижнем углу нажмите на название своего бизнеса, перейдите на страницу Настройки API во вкладку Получение запросов от Маркета и активируйте опцию Не использовать метод POST cart.

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

Маркет проверяет, что товары, которые покупатель сложил в корзину, есть в наличии в магазине. У 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

Type

Description

cart*

CartDTO

Корзина.

CartDTO

Корзина.

Name

Type

Description

businessId

integer<int64>

Идентификатор бизнеса-аккаунта.

currency

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

deliveryCurrency

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

buyer

object

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

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

delivery

CartDeliveryDTO

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

items

CartItemDTO[]

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

CurrencyType

Коды валют. Возможные значения:

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

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

Type

Description

region

ShopRegionDTO

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

address

DeliveryAddressWithoutPersonalDataDTO

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

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

estimated

boolean

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

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

CartItemDTO

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

Name

Type

Description

id

integer<int64>

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

feedId

integer<int64>

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

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

offerId

string

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


Min length: 1
Max length: 80

feedCategoryId

string

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

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

offerName

string

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

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

price

number<decimal>

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

Для отделения целой части от дробной используется точка.

subsidy

number<decimal>

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

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

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

count

integer

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

shopSku

string

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

Разрешена любая последовательность длиной до 80 знаков. В нее могут входить английские и русские буквы, цифры и символы . , / \ ( ) [ ] - = _

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

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

  • SKU товара нельзя менять — можно только удалить товар и добавить заново с новым SKU.

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

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


Min length: 1
Max length: 80

warehouseId

integer<int64>

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

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

partnerWarehouseId

string

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

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

Внимание

Параметр устарел, временно поддерживается, но не доступен для ввода и редактирования.

fulfilmentShopId

integer<int64>

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

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

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

promos

OrderItemPromoDTO[]

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

ShopRegionDTO

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

Name

Type

Description

id

integer<int64>

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

name*

string

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

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

parent

ShopRegionDTO

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

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

DeliveryAddressWithoutPersonalDataDTO

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

Name

Type

Description

country

string

Страна.

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

postcode

string

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

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

city

string

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

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

district

string

Район.

subway

string

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

street

string

Улица.

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

house

string

Дом или владение.

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

block

string

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

entrance

string

Подъезд.

entryphone

string

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

floor

string

Этаж.

apartment

string

Квартира или офис.

lat

number<decimal>

Широта.

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

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

lon

number<decimal>

Долгота.

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

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

notes

string

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

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

outletPhones

string[]

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

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

schedule

ShopOutletScheduleItemDTO[]

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

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

OrderItemPromoDTO

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

Name

Type

Description

type*

OrderPromoType

Тип скидки.


Enum: DIRECT_DISCOUNT, BLUE_SET, BLUE_FLASH, GENERIC_BUNDLE, MARKET_COUPON, MARKET_PROMOCODE, MARKET_DEAL, MARKET_BLUE, MARKET_PRIME, YANDEX_PLUS, BERU_PLUS, MARKET_COIN, YANDEX_EMPLOYEE, LIMITED_FREE_DELIVERY_PROMO, FREE_DELIVERY_THRESHOLD, MULTICART_DISCOUNT, PRICE_DROP_AS_YOU_SHOP, FREE_DELIVERY_FOR_LDI, FREE_DELIVERY_FOR_LSC, SECRET_SALE, FREE_PICKUP, CHEAPEST_AS_GIFT, CASHBACK, SUPPLIER_MULTICART_DISCOUNT, SPREAD_DISCOUNT_COUNT, SPREAD_DISCOUNT_RECEIPT, ANNOUNCEMENT_PROMO, DISCOUNT_BY_PAYMENT_TYPE, PERCENT_DISCOUNT, DCO_EXTRA_DISCOUNT, EMPTY_PROMO, BLOCKING_PROMO, UNKNOWN

subsidy

number<decimal>

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

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

marketPromoId

string

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

Параметр передается, только если параметр type=MARKET_DEAL.

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

ShopOutletScheduleItemDTO

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

Name

Type

Description

fromDay*

DayOfWeekType

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

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

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


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

toDay*

DayOfWeekType

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

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

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


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

fromTime*

string

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

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


Min length: 1

toTime*

string

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

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


Min length: 1

OrderPromoType

Тип скидки:

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

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

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

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

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

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

  • YANDEX_PLUS — бесплатная доставка за Яндекс.Плюс.

  • YANDEX_EMPLOYEE — бесплатная доставка по определенным адресам.

  • LIMITED_FREE_DELIVERY_PROMO — бесплатная доставка по какому-то ограниченному предложению.

  • FREE_DELIVERY_THRESHOLD — бесплатная доставка по достижении определённой суммы заказа.

  • MULTICART_DISCOUNT — скидка за то, что оформлена мультикорзина.

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

  • FREE_DELIVERY_FOR_LSC — бесплатная доставка за то, что одна из корзин в мультикорзине крупногабаритная.

  • FREE_PICKUP — бесплатная доставка в ПВЗ.

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

  • CASHBACK — кэшбэк.

  • SUPPLIER_MULTICART_DISCOUNT — скидка за доставку.

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

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

  • ANNOUNCEMENT_PROMO — информационная акция, скидка не применяется к товарам.

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

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

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

  • EMPTY_PROMO — скрытые промокоды.

  • BLOCKING_PROMO — блокирующее промо.

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

Эти типы неактуальные (могут быть выведены из эксплуатации в любой момент), не используйте их:

  • GENERIC_BUNDLE.

  • MARKET_DEAL.

  • MARKET_PRIME.

  • MARKET_COIN.

  • BERU_PLUS.

  • PRICE_DROP_AS_YOU_SHOP.

  • SECRET_SALE.

Type

Description

OrderPromoType

Enum: DIRECT_DISCOUNT, BLUE_SET, BLUE_FLASH, GENERIC_BUNDLE, MARKET_COUPON, MARKET_PROMOCODE, MARKET_DEAL, MARKET_BLUE, MARKET_PRIME, YANDEX_PLUS, BERU_PLUS, MARKET_COIN, YANDEX_EMPLOYEE, LIMITED_FREE_DELIVERY_PROMO, FREE_DELIVERY_THRESHOLD, MULTICART_DISCOUNT, PRICE_DROP_AS_YOU_SHOP, FREE_DELIVERY_FOR_LDI, FREE_DELIVERY_FOR_LSC, SECRET_SALE, FREE_PICKUP, CHEAPEST_AS_GIFT, CASHBACK, SUPPLIER_MULTICART_DISCOUNT, SPREAD_DISCOUNT_COUNT, SPREAD_DISCOUNT_RECEIPT, ANNOUNCEMENT_PROMO, DISCOUNT_BY_PAYMENT_TYPE, PERCENT_DISCOUNT, DCO_EXTRA_DISCOUNT, EMPTY_PROMO, BLOCKING_PROMO, 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)

В ответе на запрос от Маркета укажите следующие значения для параметров, вложенных в deliveryOptions:

  • Тип доставки "type": "DIGITAL". Это единственный доступный тип доставки для цифровых товаров.
  • Дата доставки – текущий день (параметр fromDate, вложенный в dates).
  • Наименование службы доставки – «Доставка на электронную почту» (параметр serviceName).
  • Способ оплаты – предоплата (YANDEX, APPLE_PAY, GOOGLE_PAY, TINKOFF_CREDIT, TINKOFF_INSTALLMENTS, SBP).
Пример

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

{
  ...
  "deliveryOptions":
  [
    {
      "id": "{string}",
      "price": 0,
      "serviceName": "Доставка на электронную почту",
      "type": "DIGITAL",
      "dates": {
        "fromDate": "{date}",
      },
      "paymentMethods": [
        "YANDEX",
        "APPLE_PAY",
        "GOOGLE_PAY",
        "TINKOFF_CREDIT",
        "TINKOFF_INSTALLMENTS",
        "SBP"
      ]
    }
  ],
  ...
}
Что передавать в качестве цены доставки (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

Type

Description

cart*

CartResponseDTO

Корзина.

CartResponseDTO

Name

Type

Description

paymentMethods

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 — банковской картой.

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

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

Значение по умолчанию: CASH_ON_DELIVERY.

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


Enum: SHOP_PREPAID, BANK_CARD, YANDEX_MONEY, CASH_ON_DELIVERY, CARD_ON_DELIVERY, YANDEX, APPLE_PAY, EXTERNAL_CERTIFICATE, CREDIT, INSTALLMENT, GOOGLE_PAY, TINKOFF_CREDIT, SBP, TINKOFF_INSTALLMENTS, B2B_ACCOUNT_PREPAYMENT, B2B_ACCOUNT_POSTPAYMENT, UNKNOWN

deliveryCurrency

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

CartResponseItemDTO[]

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

deliveryOptions

CartResponseDeliveryOptionDTO[]

Только для модели 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 — банковской картой.

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

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

Значение по умолчанию: CASH_ON_DELIVERY.

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

Type

Description

OrderPaymentMethodType

Enum: SHOP_PREPAID, BANK_CARD, YANDEX_MONEY, CASH_ON_DELIVERY, CARD_ON_DELIVERY, YANDEX, APPLE_PAY, EXTERNAL_CERTIFICATE, CREDIT, INSTALLMENT, GOOGLE_PAY, TINKOFF_CREDIT, SBP, TINKOFF_INSTALLMENTS, B2B_ACCOUNT_PREPAYMENT, B2B_ACCOUNT_POSTPAYMENT, UNKNOWN

CartResponseItemDTO

Name

Type

Description

feedId

integer<int64>

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

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

offerId

string

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


Min length: 1
Max length: 80

count

integer

Количество товара, которое доступно для заказа. Необязательно указывать точное количество, но важно указать то количество, которое гарантированно доступно для заказа. Если товара нет в наличии, то необходимо указывать 0.

delivery

boolean

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

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

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

sellerInn

string

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

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

CartResponseDeliveryOptionDTO

Name

Type

Description

id

string

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

price

number<decimal>

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

serviceName*

string

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

type

OrderDeliveryType

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

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

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

  • POST — почта.

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

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


Enum: DELIVERY, PICKUP, POST, DIGITAL, UNKNOWN

dates

CartResponseDeliveryDatesDTO

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

outlets

CartResponseOutletDTO[]

Пункты самовывоза. Указывается, если выбран самовывоз ("type": "PICKUP"). Укажите в параметре outlets идентификаторы всех пунктов самовывоза.

paymentMethods

OrderPaymentMethodType[]

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

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

Возможные значения, если выбрана оплата при оформлении заказа ("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 — банковской картой.

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

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

Значение по умолчанию: CASH_ON_DELIVERY.


Enum: SHOP_PREPAID, BANK_CARD, YANDEX_MONEY, CASH_ON_DELIVERY, CARD_ON_DELIVERY, YANDEX, APPLE_PAY, EXTERNAL_CERTIFICATE, CREDIT, INSTALLMENT, GOOGLE_PAY, TINKOFF_CREDIT, SBP, TINKOFF_INSTALLMENTS, B2B_ACCOUNT_PREPAYMENT, B2B_ACCOUNT_POSTPAYMENT, UNKNOWN

OrderDeliveryType

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

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

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

  • POST — почта.

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

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

Type

Description

OrderDeliveryType

Enum: DELIVERY, PICKUP, POST, DIGITAL, UNKNOWN

CartResponseDeliveryDatesDTO

Name

Type

Description

fromDate

string<date-dd-MM-yyyy>

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


Example: 23-09-2022

toDate

string<date-dd-MM-yyyy>

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


Example: 23-09-2022

intervals

CartResponseDeliveryIntervalDTO[]

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

CartResponseOutletDTO

Name

Type

Description

code*

string

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

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

CartResponseDeliveryIntervalDTO

Name

Type

Description

date

string<date-dd-MM-yyyy>

Возможная дата доставки. Формат даты: ДД-ММ-ГГГГ.


Example: 23-09-2022

fromTime*

string<time>

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

toTime*

string<time>

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

400 Bad Request

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

500 Internal Server Error

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