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

УСТАНОВКА

1. Загрузите решение через Маркетплейс и установите его в административном разделе, в списке установленных решений. Для ручной установки поместите каталог ozhogov.pickup в /bitrix/modules/ozhogov.pickup/ и установите модуль через тот же раздел.
2. Проверьте требования: PHP 8.2+, main 20.0.0+ и установленный sale. СУБД — MySQL 5.7+, MariaDB 10.3+ либо PostgreSQL с main 23.900.900+.
3. Установщик создаёт таблицы, копирует компоненты и скрипты, регистрирует обработчики заказа и агент очистки. Для существующих типов плательщика с группой свойств создаётся строковое необязательное свойство PICKUP_POINT. Для типа без группы или добавленного после установки создайте группу и активное строковое необязательное свойство вручную. Уже существующее свойство с этим кодом не заменяется.

СПРАВОЧНИК И НАСТРОЙКИ

1. Магазин → Пункты выдачи: заведите активные пункты вручную или через «Загрузка списком». Заполните город, адрес, часы работы, возможности, срок и стоимость выдачи. Для карты и расстояния укажите широту и долготу.
2. Пределы пункта задаются в кг, см и см³. Ноль означает отсутствие соответствующего ограничения. Для проверки посылки заполните параметры товаров: каталог хранит вес в граммах и размеры в миллиметрах.
3. Настройки → Настройки продукта → Настройки модулей → Пункты выдачи: проверьте город, радиус, число результатов, проверку ограничений, чтение веса и размеров, код свойства заказа, журналы и срок хранения.
4. Порог бесплатной выдачи задаётся от суммы текущей корзины, 0 отключает его. Порог меняет цену в виджете; стоимость доставки в заказе настройте отдельно.
5. Выдайте сотрудникам права на pickup: R — просмотр, W — управление. Дополнительно учитываются права на Интернет-магазин и доступ к заказам.

ВИДЖЕТ В ОФОРМЛЕНИИ

1. Встройте компонент ozhogov:pickup.widget в шаблон оформления рядом с выбором доставки. Автоматической вставки в шаблон нет.
2. В INPUT_NAME укажите имя поля вашей формы. Для штатной формы пример — ORDER_PROP_123, где 123 — числовой ID свойства PICKUP_POINT текущего типа плательщика. ORDER_PROP_PICKUP_POINT не заменяет ID свойства. При смене типа плательщика используйте его ID.
3. Поле виджета должно находиться внутри формы и передаваться при оформлении; не дублируйте имя поля. Виджет заполняет скрытое поле и отправляет событие change. Для собственного шаблона проверьте реакцию формы и динамическое обновление после смены доставки.
4. При пустом INPUT_NAME выбор остаётся в сессии, и обработчик нового заказа подставляет его в уже существующее свойство по коду. Отсутствующее свойство обработчик не создаёт. При изменении кода свойства в настройках создайте соответствующее свойство для каждого типа плательщика.
5. Показывайте виджет для доставки в пункт. При смене на курьерскую доставку очистите поле и сессионный выбор через BX.ajax.runAction('ozhogov:pickup.api.pickup.forget', { data: {} }). Дождитесь ответа перед оформлением.
6. Для карты включите её в настройках и SHOW_MAP. Сайт должен подключить JavaScript API Яндекс.Карт с ключом магазина и предоставить window.ymaps к инициализации виджета. Штатная отрисовка OSM не реализована. Без карты используйте SHOW_MAP=N.
7. Для отдельной страницы адресов подключите ozhogov:pickup.list. Он показывает справочник, не выбирает пункт и не учитывает корзину. Для композитного режима поместите персональный виджет в динамическую область либо исключите его из общей закэшированной разметки.

CSV

Файл — до 8 МБ, до 5000 записей за загрузку. Административная форма принимает UTF-8 и преобразует Windows-1251. Выберите разделитель: точка с запятой, запятая или табуляция. Первая запись — заголовок; достаточно title или address, но рекомендуются code, city и address. Типы kind: P — ПВЗ, B — постамат, S — магазин. Многострочные поля и значения с разделителем заключайте в двойные кавычки.

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

ПРОВЕРКА ПОСЛЕ УСТАНОВКИ

Проверьте поиск, фильтры, расписания и карту; выберите пункт и оформите заказ для каждого типа плательщика. Убедитесь, что PICKUP_POINT содержит код пункта и выбор связан с заказом в отчёте. После увеличения корзины сверх предела или отключения выбранного пункта новый заказ на витрине должен выдать ошибку. Проверьте цену ниже, на границе и выше порога, оформление после входа гостя и переход на курьерскую доставку.

ОБНОВЛЕНИЕ И УДАЛЕНИЕ

При обновлении через Маркетплейс updater.php копирует новые компоненты, JS/CSS и административные обёртки в общие каталоги сайта. При ручном обновлении замените файлы модуля и перенесите install/components в /bitrix/components, install/js в /bitrix/js, файлы install/admin в /bitrix/admin. Проверьте свои изменения в шаблонах перед заменой и очистите кэш при необходимости.

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

Подробные PHP-примеры подключения и команды проверок находятся в README модуля.

Техническая поддержка решения оказывается разработчиком в течение срока действия лицензии.

— Электронная почта: nm.ozhogov@ya.ru
— Время ответа: в рабочие дни, в течение 48 часов с момента обращения.
— Часовой пояс: UTC+3 (Москва).

Чтобы вопрос решился с первого письма, приложите: название и версию решения, редакцию 1С-Битрикс и версию главного модуля, версии PHP и базы данных, адрес страницы, на которой воспроизводится проблема, последовательность действий для её повторения и снимок экрана с сообщением об ошибке. Если ошибка попала в журнал событий сайта, приложите запись из него.

В поддержку можно обращаться с вопросами по установке, настройке и обновлению решения, по совместимости с другими решениями и по ошибкам в его работе. Доработка решения под требования конкретного проекта в поддержку не входит и обсуждается отдельно.