1С-Битрикс: Управление сайтом

Модуль для интернет-магазина

На модерации

Модуль проходит модерацию в Маркетплейсе 1С-Битрикс. Публичное скачивание пока недоступно. Ниже приведена документация для уже установленной тестовой версии.

Нужны актуальный Битрикс в UTF-8, PHP 8.2+, модули «Интернет-магазин» и «Торговый каталог». Windows-1251 не поддерживается. Поддерживаются заказы авторизованных покупателей в рублях и один выбранный сайт на установку модуля.

Бонусная карта и оформление виджетов

Откройте «Магазин → ДАБонус → Кабинет покупателя и блок заказа». Во вкладках «Карта в кабинете» и «Виджет в заказе» независимо настраиваются расположение, тема, тексты, цвета, размеры и состав информации. Предпросмотр показывает результат до сохранения, схема — место блока на странице. Блок заказа можно разместить над формой, под формой или под итоговой суммой. По умолчанию используются страницы /personal/ и /personal/order/make/.

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

Перед сохранением нажмите «Открыть на сайте»: в новой вкладке откроется настоящая страница магазина с текущим оформлением виджета. Черновик виден только администратору в его сессии 15 минут; покупатели видят сохранённые настройки. В предпросмотре используются пример карты и отключённые кнопки бонусных действий. После изменения настроек откройте его заново. Для проверки виджета заказа добавьте товар в корзину, чтобы на странице была форма оформления.

Во вкладке «Регистрация и вход» выберите создание карты через аккаунт магазина без телефона и рассылок либо регистрацию по телефону с обязательным подтверждением через SMS. В первом случае карта закрепляется за аккаунтом 1С-Битрикс, произвольный телефон из профиля не используется для её поиска. Во втором карта создаётся только после ввода правильного кода; SMS действует 10 минут. SMS-провайдер настраивается в «Коммуникации → Уведомления».

Существующую карту можно подключить по ранее заданному паролю бонусного кабинета или по одноразовому коду. Для автоматической отправки используются «Коммуникации → Уведомления»; на сайте видны доступные каналы и результат отправки. Без рассылок сотрудник открывает «Клиенты → карточка покупателя → Код доступа к карте» и после проверки владельца передаёт ему 6 цифр. Код действует 15 минут. После подключения достаточно обычного входа в магазин.

Товары и скорость обмена

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

Для полной сверки используйте «Товары и категории → Передать каталог заново». Эта кнопка передаёт только каталог; клиенты загружаются в отдельном разделе «Клиенты». Счётчики показывают подтверждённую передачу, ожидание и ошибки. Пока обмен не завершён, повторная выгрузка недоступна. В панели ДАБонус рядом с подключением видны количество принятых товаров и категорий и время последнего обмена. Изменения напрямую в базе данных в обход событий Битрикса не отслеживаются.

Где управлять программой

Кнопки «Настроить начисления», «Настроить списания» и «Клиенты и бонусы» открывают нужные разделы панели ДАБонус. В магазине откройте «Магазин → ДАБонус → Обмен с ДАБонус». Заказы отделены от каталога и клиентов. Найдите заказ по номеру, имени, телефону или email покупателя и нажмите «Проверить»: внутренний ID не нужен. Показаны и заказы, которые ещё не передавались. Ошибочные отправки можно повторить отдельной кнопкой.

Как загрузить клиентскую базу

Из Битрикса: откройте «Магазин → ДАБонус → Клиенты». Выберите покупателей с заказами или также зарегистрированных на подключённом сайте без заказов и нажмите «Загрузить клиентов в ДАБонус». Передаются имя, телефон и email; администраторы и неактивные аккаунты исключены. Для пользователей без заказов учитывается сайт регистрации, указанный в Битриксе.

Загрузка выполняется в фоне независимо от каталога. Счётчик «Загружено» увеличивается после подтверждения ДАБонус. Повторный запуск обновляет существующие карточки; импорт не начисляет бонусы и не отправляет сообщения. Для фоновой работы нужны включённый обмен и штатные агенты Битрикса.

Из Excel/CSV: в панели ДАБонус откройте «Клиенты → Загрузить клиентов». Скачайте шаблон, заполните файл и проверьте предпросмотр перед применением. В этом же разделе можно отдельно обновить поля существующих карточек и их теги.

Начисления и возвраты

Бонусы начисляются после полной оплаты; при необходимости задайте дополнительный статус заказа. Для полного возврата сначала верните денежную часть штатным способом платёжной системы и сохраните результат в Битриксе. Затем оформите возврат бонусного платежа через платёжную систему ДАБонус, сохраните и отмените заказ.

Возврат на внутренний денежный счёт Битрикса для бонусов недоступен. Очередь сначала отменяет начисление за продажу, затем возвращает бонусную оплату. Дождитесь обработки очереди и сверьте баланс ДАБонус. Для неоплаченного заказа достаточно отмены.

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

Проверки перед запуском

Проверьте начисление, бонусную оплату и доплату, неверный код, повторный запрос, потерю связи и отмену. Настройте агенты Битрикса через cron и проверьте журнал модуля. Завершите ожидающие возвраты перед удалением модуля.

Передаются имя, телефон и email покупателя, товары, суммы и статусы заказов. Обмен использует HTTPS с api.dabonus.ru и требует согласия администратора. Ключ подключения покупателю не передаётся.