> For the complete documentation index, see [llms.txt](https://help.pluscards.ru/plus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.pluscards.ru/plus/integracii/bitriks-edit-site.md).

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

{% hint style="info" %}
&#x20;Проверить работу модуля можно на [демо-сайте](https://bitrix-demo.pluscards.ru/).
{% endhint %}

## Подготовка

1. Создайте новую интеграцию для сайта в Pluscards «**Настройки**» — «**Интеграции**».
2. Создайте пригласительную ссылку для регистрации новых пользователей через виджет на сайте. Создать ссылку можно в кабинете Pluscards в разделе «**Настройки**» — «**Пригласительные ссылки**».

## **Установка и настройка модуля**

### **Установка модуля**

Вариант 1:

1. Перейти по ссылке на решение <https://marketplace.1c-bitrix.ru/solutions/pluscardsru.site/>.
2. Нажать кнопку «**Установить**».

Вариант 2:

1. Зайти раздел «**Администрирование сайта**».&#x20;
2. Перейти в раздел «**Marketplace**» и найти решение «**Интеграция с Pluscards**».
3. Установить решение.

Вариант 3:

Перейти по ссылке <Адрес Вашего сайта>/bitrix/admin/update\_system\_partner.php?addmodule=pluscardsru.site

### **Настройка модуля**

Перейдите в «**Настройки**» — «**Настройки продукта**» — «**Настройки модулей**» — «**Интеграция с Pluscards**».

<figure><img src="/files/HuI6R8bn5Io67wa5ZAmw" alt=""><figcaption></figcaption></figure>

#### Настройка подключения

* **Токен авторизации**: Скопируйте API-ключ новой интеграции в Pluscards «**Настройки**» — «**Интеграции**», которую создали на этапе подготовки.
* **Тестовый сервер**: переключение между Рабочим/Тестовым контуром. Если тестовый сервер включен, то через виджет на сайте нельзя будет войти в программу лояльности.
* **Уровень логирования**: минимальный уровень логирования. Клик по названию настройки ведет на просмотр таблицы логов модуля.
* **Активность**: параметр доступности модуля. При выключенном параметре компоненты будут отображаться только для администраторов сайта. При включенном компоненты будут отображаться для всех пользователей сайта.
* **Ссылка на регистрацию в программе лояльности**: пригласительная ссылка на регистрацию. Вставьте в это поле ссылку, которую создали ранее на этапе подготовки.

<figure><img src="/files/SpU7LxzCSLs9qyobQq4F" alt=""><figcaption></figcaption></figure>

#### Обработка заказа

* **Тип поля товара используемый в интеграции**: поле номенклатуры, по которому будет происходить идентификация товара в системе Pluscards.
* **Режим начисления бонусов**: после оплаты – начисление бонусов по заказу будет производиться после полной оплаты заказа. По статусу заказа – начисление бонусов по заказу будет производиться при изменении статуса заказа, указанный в настройках.
* **Статус заказа, при котором обрабатывается бонусная операция**: статус заказа при котором будет производится бонусная операция начисления по заказу.
* **Начисление при ошибке списания**: при включенной настройке в случае ошибки списания бонусов при создании заказа будет производится операция начисления согласно настройкам.
* **При ошибке обработки бонусной операции перевести заказ в статус**: перевод заказа в указанный статус при ошибке списания бонусов. При выбранной операции начисления статус заказа не изменяется.

### **Настройка отображения виджета Pluscards на сайте**

#### ***Компонент на странице корзины***

1. Перейдите на страницу корзины (/personal/cart/index.php).
2. Нажмите «**Изменить страницу**».
3. Добавьте компонент «**PlusCards. Информация о пользователе**».

![](/files/UN07RAYHCvnzX2GqE7Fn)

4\. Дважды кликните на компонент и в настройках установите «**Режим отображения**» на «**В корзине**».

<figure><img src="/files/brEZhWvjvqtVIaZAJFI0" alt=""><figcaption></figcaption></figure>

#### ***Компонент на странице кабинета пользователя***

1. Перейдите на страницу личного кабинета пользователя (/personal/index.php).
2. Нажмите «**Изменить страницу**».
3. Добавьте компонент «**PlusCards. Информация о пользователе**».<br>

![](/files/PiMTzM47g1p4mmYteayR)

4\. Дважды кликните на компонент и в настройках компонента установить «**Режим отображения**» в личном кабинете пользователя.

<figure><img src="/files/JGvyAmp1rt8fRzgXN2Cw" alt=""><figcaption></figcaption></figure>

#### ***Правила работы с корзиной***

1. Откройте «**Маркетинг**» — «**Товарный маркетинг**» — «**Правила работы с корзиной**» — «**Правила работы с корзиной**».
2. Нажмите на кнопку «**Добавить правило**».

<figure><img src="/files/02fngPvC3i3YiCpnSxTR" alt=""><figcaption></figcaption></figure>

В общих параметрах правила укажите:

* **Название**: Pluscards.
* **Приоритет применимости**: выставите в зависимости от текущих настроек правил работы с корзиной. Важно, чтобы данное правило применялось на корзину всегда. Мы рекомендуем указать приоритет 100.
* Отключите пункт «**Прекратить применение скидок на текущем уровне приоритетов**».
* Отключите пункт «**Прекратить дальнейшее применение правил**».

<figure><img src="/files/o5gphrOuC23Rah8ZyKCC" alt=""><figcaption></figcaption></figure>

На вкладке «**Действия и условия**»:

* Примените условия платформы Pluscards.

![](/files/9Qtfq5SWk6sD9hQ47mbk)

На вкладке «**Ограничения**»:

* Выберите в списке «**\[2] Все пользователи (в том числе неавторизованные)**».

![](/files/JQafDy0TKyNKNDytl5yj)

Проверьте, что отсутствуют правила блокирующие данную скидку:

<figure><img src="/files/epZ6p3SsbAG1EW9dLzuD" alt=""><figcaption></figcaption></figure>

![](/files/3979gNlkcttWTt1zR82z)

## **Административная часть модуля**

### **Отображение информации по обработке заказа в Pluscards**

В заказе в имеется раздел «**PlusCards**», в котором отображается информация о бонусной операции по заказу.

![](/files/mgEaegZtJYbS3CrvAdDh)

![](/files/j3DEONShAtNTAQ3YAvB7)

* Дата создания – дата создания обработки заказа.
* Дата обновления – дата обновления обработки заказа.
* Статус – статус обработки.
* Клиент – ID карты лояльности клиента .
* Тип бон. операции – выбранная пользователем бон. операция.
* Величина бон. операции – рассчитанная величина бон. операции.
* Оплата бонусами – сумма заказа в руб. оплаченная бонусами при списании  бонусов.
* Корзина изменена – признак изменения корзины после создания заказа.
* ID продажи – ID продажи зафиксированной в Pluscards.
* Комментарий – Комментарии к обработке заказа.
* Действия:&#x20;
  * Открыть логи – открывает таблицу логов модуля с фильтрацией по данному заказу.

### **Отмена и удаление заказа**

В случае удаления или отмены заказа:

* Зафиксированная продажа в Pluscards будет удалена. Бонусная операция по продаже – откатывается.
* Статус: DELETED.
* В комментарий пишется ID продажи и дата удаления.

## **Клиентская часть модуля**

### **Корзина пользователя**

1\. Перейдите в корзину. Под корзиной отображается компонент с авторизацией в бонусной системе Pluscards:\
&#x20;

![](/files/APaXXhmryTLidAH0totr)

2\. Если Вы не зарегистрированы в программе лояльности компании – нажмите кнопку «**Зарегистрировать**».

3\. Если Вы зарегистрированы в программе лояльности компании – введите номер телефона и дождитесь входящего звонка (FlashCall). Введите последние 4 цифры номера входящего звонка.

![](/files/e4MsIuHJHFyge2BUQYIf)

4\. После успешной авторизации в виджете отобразится информация по бонусной системе с возможностью выбора бонусной операции списание/начисление. Так же на корзину применяются дисконтные настроенные скидки на товары.<br>

![](/files/NYPEVRNLXW9ANK6qeBE1)

5\. Выберите бонусную операцию и нажмите «**Оформить заказ**».

6\. В случае если выбрана операция списания – бонусы спишутся сразу и списанные бонусы учитываются  в виде скидки к заказу.

7\. Если было выбрано действие «**Начислить**», то в зависимости от настроек модуля: после успешной оплаты или после того как статус заказа перейдет в статус соответствующий настройке «**Статус заказа, при котором фиксируется бонусная операция**» – будет произведена бонусная операция начисления.
