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

POST /cart

Передает магазину список товаров в корзине покупателя и запрашивает актуальную информацию по товарам в корзине:

• наличие товаров;

• опции, даты и интервалы доставки, доступные для указанной корзины товаров и региона;

• доступные способы оплаты.

URL ресурса:

https://<URL_запроса>/cart

Структура данных в теле запроса приведена ниже. Порядок следования параметров не гарантируется.

{
  "cart":
  {
    "businessId": {int64},
    "currency": "{enum}",
    "deliveryCurrency": "{enum}",
    "delivery":
    {
      "estimated": {boolean},
      "region":
      {
        "id": {int32}, 
        "name": "{string}",
        "type": "{enum}",
        "parent":
        {
          "id": {int32}, 
          "name": "{string}",
          "type": "{enum}", 
          "parent":
          {
            ...
          }
        }
      },
      "address":
      { 
        "country": "{string}", 
        "city": "{string}", 
        "subway": "{string}", 
        "street": "{string}", 
        "house": "{string}", 
        "block": "{string}", 
        "floor": "{string}"
      }
    },
    "items":
    [
      {
        "feedId": {int64},
        "offerId": "{string}",
        "count": {int32}, 
        "offerName": "{string}",
        "feedCategoryId": "{string}",
        "fulfilmentShopId": {int64}        
      },
      ...
    ]
  }
}

Описание параметров:

Особенности передачи данных по товарам

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

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

В корзине присутствуют товары, которые магазин не доставляет в указанный регион либо по указанному адресу

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

Товар отсутствует в продаже (товара нет в наличии и не поставляется на заказ)

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

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

Товара нет в наличии на данный момент, но он поставляется на заказ

Укажите в параметре count доступное для заказа количество товара.

Особенности передачи данных по пунктам самовывоза

Укажите в параметре outlets идентификаторы всех пунктов самовывоза, в которых товар уже есть в наличии и в которые вы можете доставить товар, если его там еще нет. Нужно указать все подходящие пункты самовывоза в регионе, указанном в запросе в параметре region (в том числе в случае, если параметр содержит неполный адрес: например, только город или район в области).

Если условия доставки для разных пунктов самовывоза отличаются (например, в одни пункты заказ будет доставлен завтра, а в другие — послезавтра), в параметре deliveryOptions укажите по одному вложенному параметру для каждой группы пунктов с одинаковыми условиями и в каждом из них перечислите подходящие пункты. Подробнее см. в разделе Примеры.

Особенности передачи данных для цифровых заказов

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

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

Пример

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

{
  ...
  "deliveryOptions":
  [
    {
      "id": "{string}",
      "price": 0,
      "serviceName": "Доставка на электронную почту",
      "type": "DIGITAL",
      "dates": {
        "fromDate": "{date}",
       },
      "paymentMethods": [
        "YANDEX",
        "APPLE_PAY",
        "GOOGLE_PAY",
        "TINKOFF_CREDIT",
        "TINKOFF_INSTALLMENTS",
        "SBP"
      ]
    }
  ],
  ... 
}

Особенности передачи цены доставки

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

Особенности передачи данных по диапазону дат и интервалам доставки

Укажите в параметрах 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

Что вы передадите в ответе на 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

Структура ответных данных:

{
  "cart": 
  {
    "deliveryCurrency": "{enum}",
    "deliveryOptions":
    [
      {
        "id": "{string}",
        "price": {double},
        "serviceName": "{string}",
        "type": "{enum}",
        "dates":
        {
          "fromDate": "{date}",
          "toDate": "{date}",
          "intervals":
          [
            {
              "date": "{date}",
              "fromTime": "{time}",
              "toTime": "{time}"
             },
             ...
          ]
        },
        "outlets":
        [
          {
            "code": "{string}"
          }, 
          ...
        ],
        "paymentMethods":
        [
          "{enum}",
          ...
        ]
      },
      ...
    ],   
    "items":
    [
      {
        "feedId": {int64},
        "offerId": "{string}",
        "delivery": {boolean},
        "count": {int32}
        "sellerInn": "{string}"
      },
      ...
    ],
    "paymentMethods":
    [
      "{enum}",
      ...
    ]
  }
}

Описание параметров:

Магазин может вернуть следующие статусы ответов:

Запрос от Маркета:

POST /cart

Тело POST-запроса:

{
  "cart":
  {
    "businessId": 8085591,
    "currency": "RUR",
    "deliveryCurrency": "RUR",
    "delivery":
    {
      "region":
      {
        "id": 213,
        "name": "Москва",
        "type": "CITY",
        "parent":
        {
          "id": 1,
          "name": "Москва и Московская область",
          "type": "SUBJECT_FEDERATION",
          "parent":
          {
            "id": 3,
            "name": "Центральный федеральный округ",
            "type": "COUNTRY_DISTRICT",
            "parent":
            {
              "id": 225,
              "name": "Россия",
              "type": "COUNTRY"
            }
          }
        }
      },
      "address":
      {
        "country": "Россия",
        "city": "Москва",
        "subway": "Проспект Вернадского",
        "street": "Ленинский проспект",
        "house": "90",
        "floor": "6"
      }
    },
    "items":
    [
      {
        "feedId": 12345,
        "offerId": "4609283881",
        "offerName": "Чайник электрический 100 W",
        "feedCategoryId": "35",
        "fulfilmentShopId": 1234567,
        "count": 1
      },
      {
        "feedId": 12346,
        "offerId": "4607632101",
        "offerName": "Тостер",
        "feedCategoryId": "35",
        "fulfilmentShopId": 1234567,
        "count": 1
      }
    ]
  }
}

Ответ магазина:

HTTP/1.1 200 OK
...

{
  "cart":
  {
    "deliveryCurrency": "RUR",
    "deliveryOptions":
    [
      {
        "id": "1",
        "price": 100,
        "serviceName": "DPD",
        "type": "DELIVERY",
        "dates":
        {
          "fromDate": "15-09-2020",
          "toDate": "17-09-2020",
          "intervals":
          [
            {
              "date": "15-09-2020",
              "fromTime": "09:00",
              "toTime": "21:00"
            },
            {
              "date": "16-09-2020",
              "fromTime": "09:00",
              "toTime": "21:00"
            },
            {
              "date": "17-09-2020",
              "fromTime": "09:00",
              "toTime": "21:00"
            }
          ]
        }
      },
      {
        "price": 0,
        "serviceName": "PickPoint",
        "type": "PICKUP", 
        "dates":
        {
          "fromDate": "15-09-2020",
          "toDate": "18-09-2020"
        },
        "outlets":
        [
          {
            "code": "9"
          },
          {
            "code": "10"
          },
          {
            "code": "12"
          }
        ]
      },
      {
        "price": 0,
        "serviceName": "PickPoint",
        "type": "PICKUP", 
        "dates":
        {
          "fromDate": "16-09-2020",
          "toDate": "19-09-2020"
        },
        "outlets":
        [
          {
            "code": "11"
          }
        ]
      }
    ],
    "items": 
    [
      {
        "feedId": 12345,
        "offerId": "4609283881",
        "delivery": true,
        "count": 1,
        "sellerInn ": "0123456789" 
      },
      {
        "feedId": 12346,
        "offerId": "4607632101",
        "delivery": true,
        "count": 1,
        "sellerInn ": "0123456789" 
      }
    ],
    "paymentMethods":
    [
      "YANDEX",
      "CARD_ON_DELIVERY",
      "CASH_ON_DELIVERY",
      "TINKOFF_CREDIT",
      "TINKOFF_INSTALLMENTS",
      "SBP"
    ]
  }
}