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

Исправлено: страница оформления заказа пустела после выбора пункта выдачи
• Если свойство «Адрес доставки» привязано только к курьерским службам (шаблон не выводит его для самовывоза — так бывает, например, в шаблонах Aspro), после выбора пункта на карте вся форма оформления пропадала с экрана. Теперь форма остаётся на месте, а адрес пункта записывается только в поле адреса, которое шаблон действительно вывел.
• Поле «Адрес доставки» при выбранном самовывозе скрывается только своей строкой: соседние поля и форма заказа больше не прячутся ни на каком шаблоне.

Уведомления админ-страниц модуля
• Уведомления после действий в админ-разделе модуля («заявка создана», «склад сохранён») передаются через сессию, а не через адресную строку, и привязаны к своему действию: при работе в нескольких вкладках сообщение не теряется, не показывается в соседней вкладке и не перезаписывается следующим действием.

• Обновление само докопирует исправленный скрипт чекаута в /bitrix/js/yandekslogistika.delivery/; переустанавливать модуль не нужно.

Устранены замечания автоматической проверки безопасности Маркетплейса
• Пункт выдачи, выбранный покупателем, теперь проверяется на сервере перед сохранением заказа и перед созданием заявки: точка должна существовать в Яндекс Доставке и проходить фильтры виджета магазина (операторы, типы точек, примерка, постоплата, способ оплаты заказа). Подставить в форму заказа произвольный ID точки больше нельзя — покупатель увидит ошибку и выберет другой пункт.
• Опции получения, скрытые от покупателя («Не показывать покупателю опции»), решает сервер по настройкам «по умолчанию», а не значение из формы заказа: включить скрытую примерку или частичный выкуп через POST нельзя. Учтена связка API «частичный выкуп подразумевает примерку»: скрытая примерка не включается через частичный выкуп, а при скрытой и не разрешённой по умолчанию примерке частичный выкуп тоже скрывается.
• Ручная упаковка грузомест из карточки заявки сохраняется с подписью и сверяется с корзиной заказа: подставить состав, вес или габариты коробок через форму оформления заказа нельзя, неподписанное значение игнорируется и заявка собирается по корзине. Упаковку, заданную вручную до обновления, нужно сохранить в карточке заявки заново.
• Страница карты пунктов выдачи открывается только по подписанному токену, который сервер выдаёт при показе плитки доставки на оформлении заказа. Токен привязан к сеансу покупателя: скопированный в другой браузер он не работает. Режим выбора точки самопривоза (данные магазина) доступен только сотруднику с правом на модуль.
• Расчёт цены по точке на карте считается только для корзины текущего покупателя (параметры берутся из его сеанса, а не из адреса запроса), поэтому подобрать стоимость для произвольных веса и суммы нельзя.
• Ограничение частоты запросов к карте и расчёту цены считается на сеанс покупателя, по IP и на сайт в кэше ядра, а не в сессии. Добавлена настройка «Лимит вызовов API из виджета ПВЗ в сутки» («Соединение и кэш», по умолчанию 20 000): при исчерпании виджет отдаёт только закэшированные ответы и не расходует квоту токена магазина.
• Обновление само докопирует обновлённый скрипт чекаута в /bitrix/js/yandekslogistika.delivery/; переустанавливать модуль не нужно.

Кнопка «Выбрать пункт самовывоза» открывает карту и при уже выбранном профиле самовывоза
• На шаблонах оформления заказа, где описание способа доставки выводится внутри самой плитки (список с переключателями), кнопка срабатывала только пока профиль «Самовывоз из ПВЗ / Постамата» ещё не выбран. После выбора профиля клик по кнопке шаблон перехватывал как повторный выбор той же доставки, и карта не открывалась. Теперь кнопка открывает карту пунктов в обоих случаях.
• Обновление само докопирует исправленный скрипт чекаута в /bitrix/js/yandekslogistika.delivery/; переустанавливать модуль не нужно.
Текст и оформление призыва «Выберите пункт выдачи…» настраиваются
• В настройках модуля («Чекаут» → «Текст призыва выбрать пункт выдачи» и «CSS-стиль призыва») можно заменить подсказку, которая показывается в плитке самовывоза, пока пункт не выбран, и её оформление. Пустые поля — прежние текст и красный полужирный стиль.

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

Настройки больше не теряются при переустановке модуля
• При удалении модуля появился шаг подтверждения с включённой галкой «Сохранить данные модуля»: токен и настройки подключения, адреса забора, маппинг статусов заказа и история заявок остаются в системе. Раньше данные удалялись всегда, из-за чего обновление через «удалить → установить» обнуляло все настройки магазина.
• Повторная установка поверх сохранённых данных подхватывает их без повторной настройки.
Вызов курьера на забор
• Исправлена ошибка «missing required field 'parameters'» при вызове курьера: в запрос добавлен обязательный блок параметров груза.
• В форме вызова курьера появились поля «Объём, м³», «Вес, кг» и признак «Нужны грузчики» — они передаются в Яндекс Доставку.

Оформление заказа
• Пока покупатель не указал город или адрес, у курьерской доставки показывается подсказка «Укажите город или адрес доставки» вместо «Сервис расчёта временно недоступен»; убраны заведомо невалидные запросы к API при каждом пересчёте.
• Поле «Адрес доставки» больше не остаётся скрытым после переключения с самовывоза на курьерскую или другую доставку — в том числе на нестандартных шаблонах оформления заказа.
• Новая настройка «Код свойства: местоположение» (таб «Чекаут») — из какого свойства заказа брать город покупателя для карты пунктов выдачи. Пусто — автоопределение, как раньше.
• Точность расчёта: обновлённый расчёт стоимости с учётом способа оплаты заказа теперь доезжает и до магазинов, обновившихся пакетом с версии 0.7.6.
Карта пунктов выдачи
• Карта открывается в городе, выбранном покупателем на оформлении заказа, — теперь и без настроенного API-ключа Яндекс Карт (для крупных городов координаты встроены в модуль).
• Карта больше не запрашивает точки без границ области — это могло исчерпать память сервера на хостингах с типичными лимитами.
Доступ и диагностика
• Новая вкладка «Доступ» в настройках модуля: право на модуль можно выдать группе пользователей (просмотр или полный доступ) — менеджеры магазина работают с заявками Яндекс Доставки без полных прав администратора.
• Лог обращений к API: в каждой записи — идентификатор запроса (trace_id) для обращения в поддержку Яндекс Доставки; новая опция «Детальный лог» дополняет записи телами запросов и ответов с маскированием персональных данных покупателей.
• В заявке Яндекс Доставке передаётся идентификатор модуля — источник заказа виден в статистике Яндекс Доставки.

Примерка и частичный выкуп на оформлении заказа
• Покупатель может отметить примерку и частичный выкуп — под выбранным пунктом выдачи или под стоимостью курьерской доставки. Выбор уходит в заявку Яндекс Доставки.
• В пунктах выдачи опции показываются только там, где они действительно доступны.
Способ оплаты — по каждому заказу
• Новая настройка «Постоплатные платёжные системы» (таб «Бизнес-правила»): отметьте платёжные системы, при которых покупатель платит при получении. Способ оплаты в заявке определяется по конкретному заказу: оплачен — «оплачено заранее», не оплачен с постоплатной платёжной системой — «постоплата при получении». Ничего не отмечено — работает глобальная настройка, как раньше.
• При постоплате пункты выдачи, не принимающие оплату при получении, скрываются с карты всегда — раньше покупатель мог выбрать такую точку, и заказ не оформлялся.
• Если постоплатные платёжные системы настроены, карта и стоимость доставки подстраиваются под платёжную систему, выбранную покупателем на оформлении заказа.
Виджет выбора пункта выдачи
• Операторы и типы точек, скрытые в настройках модуля, больше не показываются в фильтрах виджета.
• Появилась настройка, позволяющая убрать из виджета ненужные группы фильтров.
• Карточка пункта выдачи больше не выходит за пределы карты — длинное описание сворачивается.

Исправление выбора точки самопривоза
• В списке точек сдачи теперь показываются сортировочные центры Яндекс Доставки, а не только пункты выдачи.
• Сортировочные центры выводятся в начале списка и помечены типом «Сортировочный центр».