# Яндекс Доставка 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 | нет | Разрешён частичный выкуп |

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

```json
{
  "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://mcp-everything.ru/integrations/yandex-delivery/scenarios/sozdat-zakaz-vybrat-variant-dostavki.md)

---

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