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

Исправления после обратной связи по версии 0.7.13

• Карта ПВЗ использует местоположение покупателя вместо города склада. Для городов без координат в Битриксе добавлено серверное определение через API Яндекс Доставки с проверкой города и региона по адресам ПВЗ и кешированием. Если API недоступен или город неоднозначен, сохраняется резервное определение центра в карте.

• Исправлено сохранение групповых прав доступа в новых версиях ядра Битрикса после кнопок «Сохранить» и «Применить».

• Ненулевую наценку нельзя сохранить с типом «Нет»: форма просит явно выбрать процент или фиксированную сумму.

• Собственные склады исключены из выбора пункта самопривоза. Добавлена проверка сохранения и ранее сохранённых настроек: неверный источник не отправляется в расчёт, на странице складов показана подсказка выбрать реальный пункт сдачи.

• При смене города оформления ранее выбранный ПВЗ, его адрес и опции сбрасываются, чтобы заказ не остался привязан к пункту в прежнем городе. Обычный пересчёт корзины в том же городе сохраняет выбор.

Исправлено: страница оформления заказа пустела после выбора пункта выдачи

• Если свойство «Адрес доставки» привязано только к курьерским службам (шаблон не выводит его для самовывоза — так бывает, например, в шаблонах 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) для обращения в поддержку Яндекс Доставки; новая опция «Детальный лог» дополняет записи телами запросов и ответов с маскированием персональных данных покупателей.

• В заявке Яндекс Доставке передаётся идентификатор модуля — источник заказа виден в статистике Яндекс Доставки.

Примерка и частичный выкуп на оформлении заказа

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

• В пунктах выдачи опции показываются только там, где они действительно доступны.

Способ оплаты — по каждому заказу

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

• При постоплате пункты выдачи, не принимающие оплату при получении, скрываются с карты всегда — раньше покупатель мог выбрать такую точку, и заказ не оформлялся.

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

Виджет выбора пункта выдачи

• Операторы и типы точек, скрытые в настройках модуля, больше не показываются в фильтрах виджета.

• Появилась настройка, позволяющая убрать из виджета ненужные группы фильтров.

• Карточка пункта выдачи больше не выходит за пределы карты — длинное описание сворачивается.

Исправление выбора точки самопривоза

• В списке точек сдачи теперь показываются сортировочные центры Яндекс Доставки, а не только пункты выдачи.

• Сортировочные центры выводятся в начале списка и помечены типом «Сортировочный центр».