Яндекс.Доставка

Яндекс.Доставка — внешние курьеры по запросу. Нямбот интегрируется с Яндекс.Доставкой (dostavka.yandex.ru): когда заказ готов к выдаче, Нямбот сам вызывает курьера Яндекса, ведёт статусы доставки и показывает клиенту трекинг. Свой штат курьеров держать не нужно — платишь только за фактические доставки.

Что даёт интеграция:

Курьер по запросу — Нямбот ставит заявку Яндексу автоматически, как только заказ готов.
Статусы и трекинг — статус курьера (ищем → назначен → забрал → в пути → доставлен) виден в СРМ и в приложении «Команда», а клиенту приходит ссылка на трекинг.
Без штата курьеров — нет ФОТ, простоев и ответственности за персонал. Платишь Яндексу за заказ.

Кто платит за доставку. Доставку оплачиваешь ты — напрямую Яндексу по своему договору. Клиенту стоимость доставки Яндекса не показывается: Нямбот только вызывает и ведёт курьера.

Что потребуется#

Аккаунт в Яндекс.Доставке (dostavka.yandex.ru) с расчётным счётом и подтверждённым договором.
API-токен Яндекс.Доставки (получается в кабинете, см. шаг 2).
Торговая точка в Нямботе с заполненным адресом (она же — точка, откуда курьер забирает заказ).
Примерно 15–20 минут на настройку.

Шаг 1. Зарегистрируй аккаунт Яндекс.Доставки#

Открой dostavka.yandex.ru и зарегистрируй аккаунт (юрлицо/ИП, контакты, город).
Добавь расчётный счёт и подтверди договор — без этого API-токен не выдаётся.
Пополни баланс для оплаты доставок.

Шаг 2. Получи API-токен#

API-токен — это «ключ» для доступа Нямбота к твоим заявкам на курьера.

В кабинете Яндекс.Доставки открой раздел «Интеграции».
В блоке «Активируйте интеграцию» нажми «Получить токен» (кнопка доступна только после добавления расчётного счёта и подтверждения договора).
Скопируй токен сразу — он понадобится в СРМ на шаге 3.

Токен — это доступ к заявкам за твой счёт. Храни его в безопасном месте и никому не передавай. В Нямботе токен хранится в зашифрованном виде и после сохранения показывается только маской.

Шаг 3. Подключи Яндекс.Доставку в СРМ#

В СРМ открой раздел «Интеграции» → вкладку «Доставка».
На карточке Яндекс.Доставка нажми «Подключить».
Торговые точки — выбери одну или несколько ТТ, для которых включаешь курьеров Яндекса. Один токен привязывается сразу ко всем выбранным точкам — оплата всё равно идёт с одного кабинета Яндекса, отдельную интеграцию на каждую ТТ заводить не нужно.
API-токен — вставь токен из шага 2.
Тип курьера — выбери «Авто-подбор» (по умолчанию Нямбот сам подберёт по расстоянию и весу), «Пеший» или «Авто».
Вызов курьера — выбери режим:
- Вручную (по умолчанию) — курьера вызывает Админ в приложении «Команда»: сначала Нямбот показывает цену доставки от Яндекса, и только после подтверждения курьер выезжает. Безопасно: реальный вызов и списание — только по осознанному клику.
- Автоматически — Нямбот сам ставит заявку, как только заказ переходит в «Готов к доставке». Удобно, но помни: это реальный курьер и списание без показа цены — включай осознанно.
Нажми «Проверить» — Нямбот проверит токен.
Нажми «Сохранить».

После сохранения выбранные ТТ переходят в режим доставки Яндексом. Назначение своего курьера для этих точек скрывается — курьера теперь ведёт Яндекс.

В карточке подключения (режим редактирования) есть виджет «Проверка себестоимости»: введи адрес — Нямбот покажет ориентировочную цену, расстояние и время подачи. Это проверка без вызова курьера.

Как это работает в заказах#

Клиент оформляет курьерский заказ как обычно.
Повар/администратор доводит заказ до статуса «Готов к доставке». Дальше зависит от режима вызова курьера (шаг 3.6):
- Вручную (по умолчанию) — Админ нажимает «Вызвать курьера». Нямбот запрашивает у Яндекса цену этой доставки и показывает её на кнопке: «Заказать за N ₽» или «Отказаться». Пока не нажал «Заказать» — курьер не вызван и деньги не списаны. Это даёт выбрать: заказать курьера Яндекса или доставить заказ другим способом.
- Автоматически — Нямбот сам ставит заявку Яндексу в этот момент (без показа цены).
В блоке «Доставка Яндекс» (в СРМ и в приложении «Команда») видно всё по текущей доставке:
- статус заявки с подсказками процесса: «Получаем цену…» (Яндекс считает стоимость), «Ищем курьера…» (заявка подтверждена, курьер ещё назначается), затем «Курьер назначен» → «В пути» → «Доставлен»;
- стоимость доставки: до подтверждения показывается «Оценка стоимости» (цена оффера Яндекса), а после того как курьер поехал — «Итоговая стоимость» (фактическая, её Яндекс может уточнить). Подпись меняется вместе с суммой, поэтому если цена изменилась (например, оценка была в час пик, а списание — по факту), это видно, а не «подменяется» молча;
- после назначения курьера — имя курьера, транспорт (пеший/авто/вело + модель, номер и цвет машины), время подачи курьера и время доставки, а также ссылка на трекинг;
- кнопка «Позвонить курьеру» — по ней Нямбот запрашивает у Яндекса защищённый (подменный) номер и даёт позвонить. Кнопка появляется только после назначения курьера. Номер временный — поэтому запрашивается в момент звонка, а не хранится.
Ссылку на трекинг видят и ты, и клиент — но в разные моменты. Ты (в СРМ и в приложении «Команда») — сразу как курьер назначен: в блоке «Доставка Яндекс» появляется ссылка «Открыть трекинг». Клиент — в сообщении бота, когда заказ переходит в статус «В пути» (курьер забрал заказ): к уведомлению добавляется ссылка «Отследить курьера на карте». По ссылке видно курьера на карте и примерное время прибытия; стоимость доставки клиенту там не показывается.
Статусы заказа проставляются сами. Когда курьер забрал заказ, Нямбот автоматически переводит заказ в «В пути», а когда курьер доставил — в «Доставлен». Это происходит по уведомлениям Яндекса — вручную статус менять не нужно ни в СРМ, ни в «Команде»; клиент тоже получает уведомление о каждом шаге. Ручное вмешательство нужно только если доставка сорвалась (см. п. 6).
Если нужно — «Отменить заявку» или «Вызвать заново» (если курьер не нашёлся). Отмена до того, как курьер забрал заказ, — бесплатна, после — может быть платной; Нямбот определяет это по данным Яндекса. Отказ от ещё не подтверждённого вызова (на шаге с ценой) — всегда бесплатный.

Отмена самого заказа тоже отменяет заявку на курьера — отдельно отменять не нужно.

Если курьер Яндекса не нашёлся или заявку отменили, статус заказа не переводится автоматически — заказ остаётся «Готов к доставке», а Админу приходит алерт. В этом случае в «Команде» открывается ручная смена статуса, чтобы довести заказ вручную (перевызвать курьера или выдать иначе).

Для клиента: трекинг доставки#

Когда курьер забрал заказ и он перешёл в статус «В пути», клиент получает в боте (Telegram / MAX) уведомление со ссылкой «Отследить курьера на карте». По ней видно курьера на карте и примерное время прибытия. Стоимость доставки Яндекса клиенту на этой странице не показывается. Отдельных действий от клиента не требуется — статусы обновляются сами.

Раньше клиента (до «В пути») — ссылку на трекинг видишь только ты: в СРМ (карточка заказа → блок «Доставка Яндекс» → «Открыть трекинг») и в приложении «Команда», как только курьер назначен. Клиенту ссылка уходит именно в момент «В пути», чтобы он не открывал пустую карту, пока курьер ещё едет за заказом.

Один токен на несколько точек#

При подключении можно выбрать сразу несколько ТТ — один токен привязывается ко всем выбранным. Это удобно, потому что доставка по ним всё равно оплачивается с одного кабинета Яндекса. Отсюда важные следствия:

Смена токена действует на все ТТ этого кабинета. Если поменять токен у одной точки, он поменяется у всех, привязанных к тому же токену. Отдельно для каждой вводить не нужно.
Нужны разные ключи для разных точек? Это значит разные кабинеты Яндекса. Подключай такие точки отдельными действиями: нажми «Подключить Яндекс.Доставку», выбери только нужные ТТ и вставь их токен. Так у тебя будет, например, один токен на две точки и другой — на третью.
Каждой точке свой ключ — подключай их по одной, каждый раз со своим токеном.

Если кабинет Яндекса один (один токен) — все точки правильно работают на нём, делить ничего не нужно.

Таблица доставки сгруппирована по кабинетам. В «Интеграции → Доставка» каждый кабинет (токен) показан отдельной карточкой, а под ним — список привязанных к нему ТТ. Так сразу видно, какие точки работают на каком токене.

Перенести точку в другой кабинет. Если ТТ подключена не к тому кабинету, её можно перенести без удаления и повторной настройки: в строке точки нажми «Переместить» и выбери кабинет-получатель. Настройки привязки (тип курьера, режим вызова) сохранятся. Перенос доступен, только если есть второй подходящий кабинет.

Как отключить или сменить токен#

Отключить ТТ от Яндекса — в «Интеграции → Доставка» открой точку, сними «Активно» или удали подключение. Точка вернётся к своим курьерам (остальные ТТ этого кабинета продолжат работать).
Сменить токен — открой любую ТТ этого кабинета в «Интеграции → Доставка», вставь новый токен и нажми «Проверить». Токен хранится один раз на кабинет, поэтому смена применяется сразу ко всем ТТ, привязанным к нему — вводить новый токен для каждой точки не нужно. Старый токен отзови в кабинете Яндекса.
Если токен утёк — сразу отзови его в кабинете Яндекса (он перестанет работать), выпусти новый и обнови в СРМ (одной сменой на весь кабинет).

Полезно знать#

Только точки Нямбота. Подключить Яндекс.Доставку можно к ТТ, которыми доставку ведёт Нямбот. Для точек под iiko/R-keeper курьера вызывает сама POS-система.
Адрес ТТ обязателен. Без адреса и координат точки забора заявка не поставится — заполни адрес ТТ в настройках.
Название и ориентир для курьера. В настройках ТТ (блок «Локация») есть два необязательных поля — «Название заведения для курьера» и «Ориентир для курьера». Адрес на карте может выглядеть обезличенно (просто дом на проспекте), а название вроде «Бурый рис» и подсказка «вход со двора, с торца дома на пандусе» помогают курьеру быстро найти заведение и не заплутать. Если название не заполнить — берётся название торговой точки.
Что курьер реально видит на точке забора. Курьер надёжно видит комментарий к точке забора, поэтому Нямбот склеивает оба поля в одну подпись: «Заведение: Бурый рис, Ориентир: вход со двора, с торца дома на пандусе» — она показывается у курьера под адресом. А в строке «Отправитель» Яндекс показывает имя администратора, который оформил вызов курьера (например «Дом Мамиев»), — это контакт для звонка/СМС-подтверждения, а не название заведения. Поэтому узнаваемое имя заведения и попадает именно в комментарий.
Адрес доставки передаётся курьеру полностью. Подъезд, этаж и квартиру клиента Нямбот передаёт Яндексу отдельными полями (не только в комментарии) — курьер видит их в своём приложении структурно. Состав и вес заказа тоже уходят честно: вес позиций и их стоимость берутся из меню.
Контакт для курьера на точке — телефон админа. Когда курьер приезжает за заказом, он звонит админу торговой точки (тому, кто отдаёт заказ), поэтому у сотрудника-Администратора ТТ должен быть заполнен телефон в правильном формате (с кодом страны, например +7 900 000-00-00). Свой номер у самой торговой точки указывать не обязательно — если его нет, контактом станет телефон админа. Если ни у админа, ни у ТТ нет корректного телефона, Яндекс отклонит вызов курьера.
Цена в пик. В часы пик цена доставки у Яндекса выше — это нормально. Клиенту она не показывается, ты видишь себестоимость в карточке заказа.
Тип курьера. «Авто-подбор» сам выбирает пеший/авто по расстоянию и весу заказа; при необходимости можно зафиксировать тип вручную.