Яндекс.Доставка #
Яндекс.Доставка — это сервис, с которым вы сможете организовать любые перевозки легко и просто.
Чем хороша интеграция с Яндекс.Доставка?
- позволяет показывать стоимость Экспресс Доставки в корзине;
- перед отправкой заказа вы можете рассчитать стоимость услуги;
- вы можете отправить в доставку один заказ или сразу несколько;
- доступна опция «Оплата курьеру картой»;
- после создания заявки на доставку вы можете отслеживать статусы доставки, а при необходимости — посмотреть номер телефона курьера;
- если у вас еще нет кабинета партнера Яндекс.Доставка, вы можете отправить заявку прямо из Модуля.
Подключение учётной записи Яндекс.Доставка к ApiShip #
Что-бы подключить СД Яндекс.Доставка, необходимо:
- Заключить договор с СД Яндекс.Доставка.
- Создать подключение в ЛК ApiShip.
Заключение договора с Яндекс.Доставка #
Если у Вас уже есть договор с СД Яндекс.Доставка, перейдите к пункту создания подключения в ЛК Apiship.
Для создания договора с СД Яндекс.Доставка необходимо:
- Перейти на официальный сайт: https://dostavka.yandex.ru/.
- Нажать на кнопку “Подключиться” на верхней панели сайта.

- В открывшемся окне необходимо заполнить предложенные поля, нажать на кнопку “Отправить”. Яндекс свяжется с Вами для заключения договора.

- После заключения договора необходимо перейти в ЛК Яндекс.Доставка для получения специального API-токена, который в дальнейшем пригодятся для подключения СД в ЛК ApiShip.
Создание подключения в ЛК Apiship #
Для создания подключения в ЛК ApiShip необходимо:
- Войти в свою учетную запись ApiShip.
- Перейти в раздел «Службы доставки» в левой навигационной панели.

- Выбрать СД Яндекс.Доставка в списке.

- В открывшемся окне заполнить все поля, которые будут вам предложены для заполнения.

Параметры подключения представлены в таблице ниже.
| Параметр подключения | Обязательный | Описание |
|---|---|---|
| Название | нет | Название подключения. |
| Токен | да | Специальный API-токен, доступный в ЛК Яндекс.Доставка. |
| Автоподтверждение | нет | Данный параметр позволяет ApiShip автоматически подтверждать заказ, как только найдется курьер. Если параметр выключен, заказ должен подтверждать клиент. Максимальное время ожидания подтверждения — 15 минут. |
| ИНН | да | ИНН продавца товара интернет-магазина. |
| Идентификатор склада | нет | Необходим для доставки в другие города. Запрашивается в ТП Яндекс или у менеджера. |
| Формат генерации ярлыков | нет | Количество ярлыков. |
| Префикс ШК | нет | Префикс штрих-кодов, если они не были переданы в запросе. Вы должны согласовать его с менеджером в Яндекс Доставке |
| Услуга reDelivery | нет | Разрешает создавать заказы в неактивные ПВЗ. Будет выполнена автоматическая переадресация в ближайший ПВЗ |
Процесс отгрузки заказов в точку самопривоза (самостоятельная отгрузка) #
- Магазин принимает заказ на сайте от клиента
- Магазин присваивает произвольный barcode упаковки с заказом
- Магазин создаёт заявку Яндекс Доставка для заказа, отгруженного в точку самопривоза. В order > pointInId указывается ID точки самопривоза
- Магазин упаковывает и маркирует заказы
- Магазин скачивает 2 экземпляра Акта Приема-Передачи (АПП)
- До 14:00 представитель магазина приезжает в ПВЗ отгрузки с заказами, АПП, доверенностью от магазина и паспортом
- На ПВЗ принимают заказы и подписывают АПП
- У магазина остается 1 экземпляр подписанного АПП
Как подключить Яндекс.Доставку
Яндекс.Доставка – это сервис, с помощью которого вы можете доставлять товары вашим клиентам.
Подключив доставку вам больше не нужно будет нанимать курьеров, а ваши менеджеры смогут вызывать машину прямо из сделки. Вы будете в курсе статуса доставки, когда машина с товаром выехала, где находится и когда заказ будет доставлен.
Как настроить работу Яндекс.Доставки
Для настройки откройте раздел Центр продаж > Доставка.

Выберите сервис Яндекс.Доставка.


Ссылки для регистрации в зонах .kz и .by
- Чтобы использовать сервис на порталах зоны .kz, переходите по ссылке для регистрации. Если у вас есть личный кабинет, переходите по ссылке для входа и настройки.
- Чтобы использовать сервис на порталах зоны .by, переходите по ссылке для регистрации. Если у вас есть личный кабинет, переходите по ссылке для входа и настройки.
Заполните заявку на подключение компании к сервису.

Когда вы отправите заявку с вами свяжется менеджер сервиса и поможет заключить договор.
После того как вы заключите договор вам на почту придет письмо с данными для входа в личный кабинет сервиса.
В личном кабинете сервиса откройте вкладку Профиль.

Нажмите кнопку Получить токен для API.

Скопируйте полученный токен.

В Битрикс24 введите токен и нажмите кнопку Сохранить.

После сохранения вам будет доступен сервис Яндекс.Доставка.

Если изменились условия использования сервиса или слетела авторизация, то вам нужно обновить синхронизацию. Нажмите на значок Яндекс.Доставка и выберите пункт Редактировать Яндекс.Доставка. В открывшемся окне заново впишите и сохраните ваш токен.

Ответы на вопросы по работе с Яндекс.Доставкой
Ошибка: Убедитесь, что у вас заключен договор с Яндекс.Доставка.
- Проверьте ваш договор с сервисом, для работы с Яндекс.Доставкой в Битрикс24 необходимо иметь кабинет корпоративного клиента Яндекс.Доставки и заключить логистический договор.
Ошибка: неверный токен или не рассчитывается стоимость доставки.
В этих случаях вам нужно проверить:
-
Личный кабинет сервиса, возможно, вы указали токент от другого сервиса. Личный кабинет Яндекс.Доставки выглядит так.

Для активации аккаунта нужно пополнить баланс с расчетного счета вашей организации на 1000 рублей.
Менялся пароль от личного кабинета Яндекс.Доставки, теперь не работает доставка.
Если вы поменяли пароль от личного кабинета сервиса, вам нужно:
-
1. Снова получить токен на стороне сервиса.

-
2. Заново подключить доставку в вашем Битрикс24. Для этого нажмите на значок Яндекс.Доставка и выберите пункт Редактировать Яндекс.Доставку. В открывшемся окне заново впишите и сохраните ваш токен.

Как посмотреть какие тарифы вам доступны?
Чтобы увидеть доступные тарифы, откройте соответствующую вкладку в кабинете сервиса.

Возникли проблемы с доставкой, доставили не по адресу или проблема с водителем.
Для решения проблемы вам нужно написать обращение в поддержку Яндекс.Доставки. В обращении укажите:
-
1. Название вашей компании.
-
2. id заявки — можно посмотреть в карточке заказа.


Когда обращение будет готово, отправьте его по адресу logistics@taxi.yandex.ru
Подробнее о том как работать с доставкой и оплатой, вы можете прочитать в статьях:
- Как работать с Яндекс.Доставкой
- Как принимать оплату и оформлять доставку в карточке сделки
- Настройка коробки для подключения Яндекс.Доставки
Яндекс.Еда
Система r_keeper Delivery поддерживает интеграцию с агрегатором доставки Яндекс Еда (Я.Еда).
Для интеграции необходимо:
- Убедиться в наличии лицензий:
- R-Keeper модуль Delivery_Base
- R-Keeper модуль Delivery_Filial
- R-Keeper модуль XML-интерфейс для WSA ПО
- R-Keeper модуль Интерфейс к r_keeper Delivery
- R-Keeper модуль Интерфейс к Яндекс.Еде
- Настроить и включить интеграцию на стороне r_k Delivery
- Заключить договор с Я.Еда
- Отправить заявку на интеграцию через личный кабинет Яндекс.Еда Партнеры. Для этого прейдите в раздел Поддержка > Интеграция > Подключение интеграции.
Подробнее о настройке интеграции на стороне Яндекс. Еды читайте в отдельной статье.
При возникновении проблем с интеграцией поставьте ресторан на паузу. В противном случае заведение может попасть в бан, так как будут приходить заказы, а вы их не сможете увидеть и обработать.
Для отключения интеграции в приложении Яндекс Еда Партнеры перейдите в раздел Поддержка > Интеграция.
Настройка интеграции
Для включения интеграции необходимо настроить меню и заведение, а также заключить договор с Я.Еда. Для этого:
- Авторизуйтесь в r_k Office
- Нажмите на кнопку слева от логотипа r_keeper в левом верхнем углу

В открывшемся окне нажмите на иконку r_k Delivery. Вы попадете в административную панель r_keeper Delivery - Перейдите в меню Интеграции / Яндекс.Еда >Яндекс.Еда
- Откроется окно для настройки интеграции с информацией:
- О работе интеграции — при первом входе будет информация, что интеграция не работает
- Краткая инструкция о настройке перед началом получения заказов
- Требования к меню.
- Ниже выберите:
- Настроенное представление меню, которое будет доступно пользователям Я.Еда
- Заведение, которое вы хотите подключить. Можно выбрать несколько
- Нажмите на кнопку Включить
Появится инструкция, как настроить передачу заказов из Яндекс.Еды. Сделайте необходимые действия:
- Получите и активируйте лицензию WSClient
- В приложении Яндекс Еда Партнеры перейдите в раздел Поддержка > Интеграция > Подключение интеграции.
- Оставьте заявку на подключение интеграции, указав код лицензии WSClient
- Дождитесь звонка от Яндекс.Еды и тестового заказа. После проведения тестового заказа интеграция включится автоматически.
- Откроется страница для заключения договора с Я.Еда
- Если у вас нет договора с агрегатором, нажмите на кнопку У меня нет договора.
Откроется страница с заключением договора на стороне Яндекс Еды - Если у вас уже есть подписанный договор, нажмите на кнопку Я заключил договор

- Если у вас нет договора с агрегатором, нажмите на кнопку У меня нет договора.
- При нажатии на кнопку Я заключил договор появится информационное окно, что заявка отправлена. Нажмите на кнопку Хорошо.

Готово, интеграция настроена. Если все прошло успешно, статус интеграции сменится на Работает.
Выбор представления меню
В разделе интеграции выберите, какое представление меню будет доступно для доставки через Яндекс Еду.
Требования к меню
Технические требования к фотографии блюда:
- Фотография должна быть сохранена в формате JPEG и весить не более 9 Мб
- Минимальное разрешение фотографии меню — 800х600 пикселей
- Минимальное разрешение главной фотографии — 1600х1200 пикселей
- Ориентация — горизонтальная
- Фото должно быть четкое.
Рекомендации к фотографии:
- Фотография должна быть вашей
- На фотографии должен отсутствовать алкоголь
- Проверьте, что фото соответствует позиции в меню.
Подробнее о требованиях и рекомендациях к фотографиям читайте в гайдбуке Яндекс Еды.

- Название блюда написано грамотно, без сокращений, кавычек и точек. Примеры:
- Неправильно:
Салат «Оливье»
Картофель, калбаса «Докторская», горошик конс., морковь, соус «Майонез», сол. огурец - Правильно:
Салат Оливье
Картофель, колбаса докторская, горошек консервированный, морковь, майонез, соленый огурец
- Неправильно:
- Изображение блюда
- Описание блюда
- Указаны вес, калорийности и БЖУ.
В карточке блюда за вес отвечает поле Порция. Значение может быть указано двумя способами:- Порционное блюдо с весом из справочника Меню в r_keeper.
В этом случае настройки Порций становятся доступны после включения параметраПорционные/Весовые Блюда в меню Настройки > Параметры и перезапуска менеджерской станции. - Штучное блюдо с весом, указанном в карточке блюда в представлении меню r_k Delivery.
Обратите внимание: вес штучному блюду может быть указан только в представлении, созданном для Яндекс.Еды.
- Порционное блюдо с весом из справочника Меню в r_keeper.
Обратите внимание: если у блюда не будут соблюдены технические требования к фотографии и карточке блюда, ваше меню не пройдет модерацию в Яндекс.Еде, и вы не сможете запуститься.
Новое меню
Перед созданием нового меню в r_k Delivery убедитесь, что блюда для будущего меню подходят к требованиям Я.Еды. Чтобы создать меню для Яндекс Еды:

- В разделе Категория заказа для загрузки меню нажмите кнопку Создать новое меню или Создать меню на основе существующего
- Откроется окно создания нового представления меню. Введите название нового меню, затем нажмите на кнопку со стрелкой в правой части поля:
Откроется окно меню
- Чтобы отредактировать название меню, нажмите на карандаш, который появляется при наведении справа от названия
- Добавьте группу в меню, нажав на кнопку +Группа . По умолчанию она будет называться Новая группа
- Отредактируйте название группы. Сначала нажмите на карандаш справа от названия группы, а затем поставьте курсор в поле ввода и введите новое название
- Добавьте в группу блюдо. Для этого в правой части экрана нажмите кнопку +Блюдо
- Начните вводить название, и система предложит подходящие блюда из загруженных с кассы. Выберите нужное блюдо из списка
- Перейдите в карточку блюда, нажав на его название. Добавьте фотографию, описание и вес порции.

Обратите внимание! Система автоматически проверяет меню на соответствие требованиям:
- Если элемент создан с ошибками, в с группой, в которое входит блюдо, появится желтый треугольный знак, а само блюдо будет подсвечено светло-оранжевым. Чтобы узнать, какие ошибки обнаружены, наведите на восклицательный знак курсор мыши или раскройте группу, чтобы увидеть блюдо с ошибками.
- В строке блюда при ошибках может быть указано Нет фото,Нет описания или Порция не заполнена.
- В правом верхнем углу экрана появится кнопка Всего несоответствий с указанием количества ошибок.
Устраните ошибки, чтобы продолжить настройку интеграции.
Меню отобразится в настройках интеграции.
Выбор меню
Для интеграции можно выбрать существующее меню. Эта опция позволяет не дублировать меню и использовать одно представление для нескольких заведений в корпорации. Для загрузки существующего меню :

- На странице интеграции в разделе Меню нажмите кнопку Настроить меню
- В выпадающем списке выберите пункт Выбрать другое меню Я.Еда: Откроется окно с иконками меню для Яндекс Еды
- Выберите нужное меню. Выбрать можно только один вариант
- Нажмите кнопку Продолжить.
В окне интеграции будет отображаться выбранное меню.
Меню на основе существующего
Вы можете создать меню на основе существующих в корпорации. Для этого выполните следующие действия :

- На странице интеграции в разделе Меню нажмите кнопку Настроить меню
- В выпадающем списке выберите пункт Создать меню на основе существующего. Откроется окно с иконками всех представлений меню в корпорации
- Выберите нужное меню, поставив на нем флажок. Выбрать можно только один вариант
- Нажмите кнопку Продолжить.
Система создаст клон представления и откроется режим редактирования меню.Вы можете изменить название. Сначала нажмите на карандаш справа от названия группы, а затем поставьте курсор в поле ввода и введите новое название
- Подготовьте представление. Перейдите в группы, обозначенные желтым знаком и устраните ошибки
- Нажмите кнопку Опубликовать меню для заведений.
Меню отобразится в окне настроек интеграции.
Представление меню, созданное любым из этих способов, можно редактировать, удалить или заменить на другое. В этом же окне нажмите кнопку Представление меню и выберите нужный пункт.
Автоматическое упрощение
Автоматическое упрощение позволяет быстро адаптировать меню для Яндекс Еды.
Чтобы воспользоваться автоматическим упрощением, выполните следующие действия:

- В режиме создания или редактирования меню выберите группу, которую следует упростить или все группы
- Нажмите на кнопку Автоматическое упрощение в правой части экрана
- Откроется окно выбора вариантов:
- При нажатии на левый вариант все блюда из вложенных групп будут опубликованы в одной группе первого уровня
- При нажатии на правый вариант все вложенные группы сохранятся и станут группами первого уровня.
Чтобы увидеть визуализацию упрощения, наведите курсор мыши на любой из вариантов - Чтобы удалить пустые группы, поставьте флажок в поле Удалить пустые группы
- Нажмите кнопку Продолжить
- После успешного упрощения в левом нижнем углу появится всплывающее сообщение Меню обновлено.
Как работает интеграция
После завершения настроек в заведении на Яндекс Еде будет доступно нужное меню. Интеграция работает следующим образом:
- Пользователь создает заказ в Яндекс Еде
- Заказ поступает в интерфейс заведения r_k Delivery с пометкой Я.Еда. Обновление страницы не требуется: заказ появится автоматически со звуковым уведомлением.
Для работы с заказами вы можете включить или выключить автоматическое подтверждение, а также настроить правила подтверждения заказов. Для этого:
- В административной панели r_k Delivery перейдите в меню Настройки
- В поле Обработка заказов установите переключатель в один из режимов:
- Используются правила — можно добавлять/изменять правила в блоке Правило подтверждения заказа. Заказы, которые удовлетворяют этим правилам, будут переведены в статус Подтвержден. Заказы не удовлетворяющие правилам остаются в статусе Новый. При других состояниях правила будут заблокированы.
Правило подтверждения заказов
- Тип оплаты — в ыберите из списка нужный тип оплаты
- Сумма заказа — задайте ограничение на максимальную/минимальную сумму заказа
- Количество доставок — задайте количество успешных доставок гостя, после которых можно доверять его заказам.

Затем заказ повторяет обычный путь: передается на кухню, а потом к курьеру.
После того, как заказ доставлен, он будет отображаться в списке Завершенные.
При работе с собственными курьерами зона доставки должна совпадать с зоной доставки, указанной при регистрации в Яндекс.Еде, чтобы полученные заказы не отменялись автоматически.
Валюты
В интеграции есть возможность выбрать валюту. Для этого необходимо настроить на кассе еще одну нефискальную валюту с наименованием, например, Яндекс.Еда.
Чтобы добавить валюту, выполните следующие действия:

- В административной панели r_k Delivery перейдите в раздел Заведения
- В строку поиска введите код объекта и перейдите в карточку объекта
- Перейдите в раздел Валюта и оплата. Добавьте нужную валюту, указав GUID валют.
GUID валюты можно посмотреть в менеджерской станции:- Перейдите в меню Деньги и выберите пункт Валюты
- В дереве слева выберите нужную валюту и скопируйте ее GUID
- Вставьте GUID в нужное поле в административной панели r_k Delivery
- Нажмите Сохранить.
Если заказы будут доставлять курьеры Яндекс.Еды, необходимо настроить нефискальную валюту.
Как работать с Яндекс.Доставкой
Работая со сделкой, выберите доставку с помощью сервиса Яндекс.Доставка и укажите в карточке адрес. Сервис отправит к вам курьера, курьер заберет товар и доставит его по указанному адресу.
Как работать с Яндекс.Доставкой
Переходите в раздел CRM > Сделки.

Вы можете работать с доставкой двумя способами:
Откройте карточку сделки и нажмите кнопку Принять оплату.

В пункте доставка отметьте Яндекс.Доставка.
Выберите подходящий тариф и нужные опции:

- Курьер – подойдёт для доставки небольших вещей и документов, весом до 10 кг.
- Экспресс – доставку производит курьер на автомобиле, тариф подойдёт для товаров весом до 20 кг.
- Грузовой – для доставки крупных товаров, весом до 1400 кг.
Тариф влияет на расчётную стоимость доставки.
Далее укажите Где забрать товар. После первой оплаты этот адрес сохранится и будет автоматически добавлен при следующей доставке.

Также вы можете настроить реквизиты вашей компании, тогда при первой оплате адрес вашей компании будет добавлен в поле. Подробнее о том как добавить реквизиты читайте в статье Как добавить реквизиты своей компании?
В поле адрес клиента вы можете вписать подробный адрес и указать номер квартиры, офиса или домофона.

Адрес клиента можно указать во время работы со сделкой. В поле Адрес нажмите подробно и впишите нужные данные, в этом случае информация с адресом автоматически добавится в доставку.

После этого нажмите кнопку Рассчитать.

Сервис рассчитает примерную стоимость доставки.

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

Когда вы настроите параметры доставки, нажмите кнопку Отправить.

Для корректной работы сервиса у ответственного за сделку сотрудника должны быть указаны почта и номер телефона.

Доставка появится в карточке сделки. После того как клиент оплатит товар, вы можете Заказать доставку.

Когда сервис подберёт курьера, вы можете сделать звонок водителю или отменить доставку.

Курьеры не принимают оплату. Оплата за услуги доставки происходит на стороне сервиса в вашем личном кабинете.
Как организовать доставку без оплаты
Чтобы организовать доставку товара без оплаты, вы можете использовать специальный режим. Для этого находясь в сделке, нажмите Принять оплату или используйте кнопку Доставка.

В открывшемся окне выберите режим Только доставка.

Затем укажите параметры доставки и нажмите кнопку Оформить.

После этого вы можете вызвать доставку из сделки.

Ответы на вопросы по работе с Яндекс.Доставкой
Ошибка: Убедитесь, что у вас заключен договор с Яндекс.Доставка.
- Проверьте ваш договор с сервисом, для работы с Яндекс.Доставкой в Битрикс24 необходимо иметь кабинет корпоративного клиента Яндекс.Доставки и заключить логистический договор.
Ошибка: неверный токен или не рассчитывается стоимость доставки.
В этих случаях вам нужно проверить:
-
Личный кабинет сервиса, возможно, вы указали токент от другого сервиса. Личный кабинет Яндекс.Доставки выглядит так.

Для активации аккаунта нужно пополнить баланс с расчетного счета вашей организации на 1000 рублей.
Менялся пароль от личного кабинета Яндекс.Доставки, теперь не работает доставка.
Если вы поменяли пароль от личного кабинета сервиса, вам нужно:
-
1. Снова получить токен на стороне сервиса.

-
2. Заново подключить доставку в вашем Битрикс24. Для этого нажмите на значок Яндекс.Доставка и выберите пункт Редактировать Яндекс.Доставку. В открывшемся окне заново впишите и сохраните ваш токен.

Как посмотреть какие тарифы вам доступны?
Чтобы увидеть доступные тарифы, откройте соответствующую вкладку в кабинете сервиса.

Возникли проблемы с доставкой, доставили не по адресу или проблема с водителем.
Для решения проблемы вам нужно написать обращение в поддержку Яндекс.Доставки. В обращении укажите:
-
1. Название вашей компании.
-
2. id заявки — можно посмотреть в карточке заказа.


Когда обращение будет готово, отправьте его по адресу logistics@taxi.yandex.ru
Подробнее о том как работать с доставкой и оплатой, вы можете прочитать в статьях: