Яндекс Доставка API (Доставка по России): POST /api/b2b/platform/offers/create — Создание заявки (получение офферов)

Возвращает варианты доставки (офферы) для заказа. Одинаковые товары передавайте одной позицией с count, иначе будет записано количество 1.

Параметр	Где	Тип	Обяз.	Описание
send_unix	query	boolean	нет	Формат интервалов: true — unix, false — UTC
info.operator_request_id	body	string	нет	ID заказа у отправителя, уникальный
info.comment	body	string	нет	Комментарий
info.merchant_id	body	string	нет	ID мерчанта (если есть зарегистрированные)
source.platform_station.platform_id	body	string	нет	Склад или точка отгрузки
source.interval_utc	body	object	нет	Интервал отгрузки from/to
destination.type	body	string	нет	platform_station (ПВЗ) или custom_location (до двери)
destination.platform_station	body	object	нет	ПВЗ получения
destination.custom_location	body	object	нет	Адрес: latitude, longitude, details (full_address, locality, street, house, room и др.)
destination.interval_utc	body	object	нет	Интервал доставки
items	body	array	да	Товары: count, name, article, billing_details, physical_dims, place_barcode
items[].billing_details.unit_price	body	integer	нет	Цена за единицу, копейки
items[].billing_details.assessed_unit_price	body	integer	нет	Оценочная цена за единицу, копейки
items[].billing_details.nds	body	integer	нет	НДС: 0, 5, 7, 10, 22; без НДС — -1
places	body	array	да	Грузоместа: physical_dims (weight_gross, dx, dy, dz), barcode
billing_info	body	object	нет	Оплата: payment_method, delivery_cost
recipient_info	body	object	нет	Данные получателя
last_mile_policy	body	string	нет	time_interval или self_pickup
forbid_unboxing	body	boolean	нет	Запрет вскрытия упаковки
particular_items_refuse	body	boolean	нет	Разрешён частичный выкуп

Пример ответа:

{
  "offers": [
    {
      "offer_id": "c1b139dbd76b4ee3b39b19180b516119",
      "expires_at": "2021-10-25T15:00:00.000000Z",
      "offer_details": {
        "delivery_interval": {
          "min": "2021-10-25T15:00:00.000000Z",
          "max": "2021-10-25T15:00:00.000000Z",
          "policy": "time_interval"
        },
        "pickup_interval": {},
        "pricing": "192.15 RUB",
        "pricing_commission_on_delivery_payment": "2.2%",
        "pricing_commission_on_delivery_payment_amount": "9.43 RUB",
        "pricing_total": "1400.96 RUB"
      }
    }
  ]
}

Базовые URL

• Боевой: https://b2b-authproxy.taxi.yandex.net
• Тестовый: https://b2b.taxi.tst.yandex.net

Авторизация

Тип: Bearer-токен

Bearer-токен в заголовке Authorization: Bearer <token>. Для продакшена токен берут в личном кабинете в разделе «Профиль»; ID склада отгрузки (platform_station_id) выдаёт коммерческий менеджер.

Для тестового контура в документации даны:

Для корректной работы нужен TLS 1.2 и выше с шифрами по стандарту PCI DSS v4.

Нюансы

• Основной поток — двухшаговый: offers/create возвращает офферы с ограниченным сроком (expires_at), заявка создаётся только после offers/confirm.
• Суммы в товарах передаются в копейках, вес — в граммах, габариты — в сантиметрах.
• Для destination заполняется либо platform_station (ПВЗ), либо custom_location (доставка до двери) в соответствии с type.
• operator_request_id должен быть уникальным для каждого заказа.
• В тестовом контуре используйте тестовый токен и тестовый склад из документации; продакшен-ID склада выдаёт менеджер.

Сценарии с этим методом

• Создать заказ: выбрать вариант доставки и подтвердить

---

Если этого недостаточно — официальная документация: https://yandex.ru/support/delivery-profile/ru/api/other-day/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/yandex-delivery.md