«Яндекс Доставка: расчёт, выбор ПВЗ на карте, заявки и отслеживание» от разработчика «Яндекс Логистика»

Установка:
1. Установите решение через «Marketplace ? Установить решение».
2. Мастер установки проведёт по трём шагам: OAuth-токен и режим
  (тестовый/боевой) ? адрес забора ? завершение. Автоматически создаются:
  служба доставки с двумя профилями, служебные свойства заказа, фоновый агент
  опроса статусов и таблицы модуля.

Настройка — «Магазин ? Настройки ? Модули ? Яндекс Доставка ? Настройки»:
• Подключение: OAuth-токен, тестовый/боевой контур, ключ Яндекс Карт.
• Фильтр пунктов выдачи.
• Чекаут: коды свойств ПВЗ и ID тега для кастомных шаблонов оформления.
• Бизнес-правила: способ оплаты, статус автосоздания заявки, интервал опроса,
 наценка, округление, блокировка без ПВЗ.
• Статусы заказа: сопоставление статусов заявки со статусами заказа.
• Соединение и кэш: таймауты и TTL кэша расчётов.

Адреса забора и вызов курьера — «Магазин ? Яндекс Доставка ? Адреса забора».

В кабинете Яндекс Доставки виден номер заказа магазина
• Раньше в колонке «Номер заказа» кабинета стоял служебный ключ модуля вида yd-121909-226975, и заявку приходилось сопоставлять с заказом вручную. Теперь туда уходит номер заказа магазина — тот же, что видит покупатель и что напечатан в документах.
• В настройках модуля («Бизнес-правила» ? «Номер заказа для Яндекс Доставки») можно выбрать, что именно передавать: номер заказа магазина (по умолчанию), внутренний ID заказа или прежний служебный ключ — если вы уже сопоставляете заявки по нему.
• Настройка действует на новые заявки; у ранее созданных номер в кабинете остаётся прежним.
• Служебный «Идентификатор заявки» (в кабинете — «ID в Доставке») выдаёт сама Яндекс Доставка, и заменить его номером заказа нельзя: по нему работают отслеживание, этикетка, акт и отмена. В карточке заявки теперь показаны оба номера рядом.
Кнопка «Создать заявку» честно показывает результат
• Раньше после нажатия всегда появлялось зелёное «Готово. Создано заявок: 0; пропущено: 0» — и когда заявка создалась, и когда Яндекс Доставка отказала. Неудачное создание выглядело как успешное, а причину приходилось искать в таблице заявок ниже на странице.
• Теперь счётчики показывают реальный результат, а отказ выводится красным сообщением с текстом ошибки и номером отгрузки. Если отгрузок несколько, видно и сколько заявок создалось, и что именно не прошло.
• Если в заказе нет отгрузок Яндекс Доставки, модуль так и пишет, вместо «Создано: 0».
Несозданная заявка больше не теряется молча
• Модуль создаёт заявку сам, когда заказ переходит в статус из настройки «Бизнес-правила» ? «Создавать заявку при статусе заказа». Раньше при отказе Яндекс Доставки (не заполнен телефон покупателя, не настроен модуль, временная ошибка сервиса) заказ просто менял статус — заявки не было, и менеджер узнавал об этом, только если сам открывал карточку заявки.
• Теперь каждый такой отказ попадает в журнал событий Битрикса («Настройки» ? «Инструменты» ? «Журнал событий»), тип события — «Яндекс Доставка: не создана заявка». В записи видно номер заказа, статус, номер отгрузки и текст ошибки от Яндекс Доставки.
• Отдельной записью отмечается и другой молчаливый случай: заказ дошёл до нужного статуса, но отгрузок с профилями модуля в нём нет, поэтому заявки не будет.
Заказ из нескольких товаров больше не упирается в лимит пункта выдачи
• Модуль по-прежнему объявляет заказ одним отправлением — так доставка дешевле, и для обычных заказов ничего не меняется.
• Раньше, если такое отправление не проходило в ограничения пункта выдачи, все пункты просто становились недоступны для выбора: заказ из двух коробок по 13 кг доставить было нельзя, хотя каждая коробка в ограничения проходит.
• Теперь в этом случае модуль автоматически пересчитывает заказ по коробкам — по одной на позицию — и предлагает доставку по её реальной стоимости. Цена вырастет только там, где иначе доставки не было бы вообще.
• Тот же порядок работает и при создании заявки, поэтому заявка уходит в Яндекс Доставку в той же конфигурации коробок, по которой покупателю посчитали доставку.
• Свою упаковку по-прежнему можно задать вручную в карточке заявки — она приоритетнее автоматической. Кнопка «Автораспределить (1 коробка = вся корзина)» собирает всё в одну коробку, как модуль делает сам; новая кнопка «По коробке на товар» раскладывает заказ по позициям — для заказов, которые одним местом в ограничения пункта не проходят. Бесплатная доставка — бесплатная и на карте пунктов выдачи
• Виджет выбора ПВЗ учитывает скидки на доставку из «Правил работы с корзиной» (в том числе «Бесплатная доставка от суммы заказа»). Раньше на карте показывался тариф Яндекс Доставки, а после выбора пункта корзина обнуляла стоимость — покупатель видел две разные цены.
• При нулевой стоимости в карточке пункта пишется «бесплатно» вместо «0 RUB».
• Изменения бизнес-правил модуля и правил корзины применяются в виджете сразу, без ожидания истечения кэша цены.
Боевой режим по умолчанию
• Тестовый режим («Подключение» ? «Тестовый режим») больше не включён по умолчанию: новая установка сразу работает с боевым контуром Яндекс Доставки. У уже установленных магазинов режим не меняется — действует сохранённая настройка.
Заказ с самовывозом из ПВЗ оформляется при обязательном «Адресе доставки»
• Раньше при выбранном пункте выдачи кнопка «Далее» на оформлении заказа могла отвечать «Заполните обязательное поле "Адрес доставки"»: поле для самовывоза скрыто, а проверка обязательности у большинства магазинов включена. Теперь адрес выбранного пункта записывается в «Адрес доставки» сам — он же попадает в заказ и документы; при переключении на курьера подставленный адрес убирается.
• Карта пунктов выдачи открывается на городе покупателя и без ключа Яндекс Карт: восстановлена передача координат города в виджет.Настройки больше не теряются при переустановке модуля
• При удалении модуля появился шаг подтверждения с включённой галкой «Сохранить данные модуля»: токен и настройки подключения, адреса забора, маппинг статусов заказа и история заявок остаются в системе. Раньше данные удалялись всегда, из-за чего обновление через «удалить ? установить» обнуляло все настройки магазина.
• Повторная установка поверх сохранённых данных подхватывает их без повторной настройки.
Вызов курьера на забор
• Исправлена ошибка «missing required field 'parameters'» при вызове курьера: в запрос добавлен обязательный блок параметров груза.
• В форме вызова курьера появились поля «Объём, м?», «Вес, кг» и признак «Нужны грузчики» — они передаются в Яндекс Доставку.Оформление заказа
• Пока покупатель не указал город или адрес, у курьерской доставки показывается подсказка «Укажите город или адрес доставки» вместо «Сервис расчёта временно недоступен»; убраны заведомо невалидные запросы к API при каждом пересчёте.
• Поле «Адрес доставки» больше не остаётся скрытым после переключения с самовывоза на курьерскую или другую доставку — в том числе на нестандартных шаблонах оформления заказа.
• Новая настройка «Код свойства: местоположение» (таб «Чекаут») — из какого свойства заказа брать город покупателя для карты пунктов выдачи. Пусто — автоопределение, как раньше.
• Точность расчёта: обновлённый расчёт стоимости с учётом способа оплаты заказа теперь доезжает и до магазинов, обновившихся пакетом с версии 0.7.6.
Карта пунктов выдачи
• Карта открывается в городе, выбранном покупателем на оформлении заказа, — теперь и без настроенного API-ключа Яндекс Карт (для крупных городов координаты встроены в модуль).
• Карта больше не запрашивает точки без границ области — это могло исчерпать память сервера на хостингах с типичными лимитами.
Доступ и диагностика
• Новая вкладка «Доступ» в настройках модуля: право на модуль можно выдать группе пользователей (просмотр или полный доступ) — менеджеры магазина работают с заявками Яндекс Доставки без полных прав администратора.
• Лог обращений к API: в каждой записи — идентификатор запроса (trace_id) для обращения в поддержку Яндекс Доставки; новая опция «Детальный лог» дополняет записи телами запросов и ответов с маскированием персональных данных покупателей.
• В заявке Яндекс Доставке передаётся идентификатор модуля — источник заказа виден в статистике Яндекс Доставки.Примерка и частичный выкуп на оформлении заказа
• Покупатель может отметить примерку и частичный выкуп — под выбранным пунктом выдачи или под стоимостью курьерской доставки. Выбор уходит в заявку Яндекс Доставки.
• В пунктах выдачи опции показываются только там, где они действительно доступны.
Способ оплаты — по каждому заказу
• Новая настройка «Постоплатные платёжные системы» (таб «Бизнес-правила»): отметьте платёжные системы, при которых покупатель платит при получении. Способ оплаты в заявке определяется по конкретному заказу: оплачен — «оплачено заранее», не оплачен с постоплатной платёжной системой — «постоплата при получении». Ничего не отмечено — работает глобальная настройка, как раньше.
• При постоплате пункты выдачи, не принимающие оплату при получении, скрываются с карты всегда — раньше покупатель мог выбрать такую точку, и заказ не оформлялся.
• Если постоплатные платёжные системы настроены, карта и стоимость доставки подстраиваются под платёжную систему, выбранную покупателем на оформлении заказа.
Виджет выбора пункта выдачи
• Операторы и типы точек, скрытые в настройках модуля, больше не показываются в фильтрах виджета.
• Появилась настройка, позволяющая убрать из виджета ненужные группы фильтров.
• Карточка пункта выдачи больше не выходит за пределы карты — длинное описание сворачивается.Исправление выбора точки самопривоза
• В списке точек сдачи теперь показываются сортировочные центры Яндекс Доставки, а не только пункты выдачи.
• Сортировочные центры выводятся в начале списка и помечены типом «Сортировочный центр».