> 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С-Битрикс: Управление сайтом

В этом разделе описаны возможности, способы и настройка интеграции с системой управления сайтом «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="https://600673903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MRLRewlfPAN4AhSHhzD%2Fuploads%2FtDDLiAFjQ6N5d3QYBgkr%2Fimage.png?alt=media&amp;token=1bce2a29-a334-4047-a035-7042e5cab0ee" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://600673903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MRLRewlfPAN4AhSHhzD%2Fuploads%2F8nCAL5NIBUiV9S9dfObx%2Fimage.png?alt=media&amp;token=69511ae5-b2b0-476f-9493-881cea22b208" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

![](https://600673903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MRLRewlfPAN4AhSHhzD%2Fuploads%2FJT9NmqbrPPzbwm3rIaCR%2Fimage.png?alt=media\&token=f9a13814-8ca6-4ba7-87fb-8517dda792b9)

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

<figure><img src="https://600673903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MRLRewlfPAN4AhSHhzD%2Fuploads%2FFbrKRBAvvSZQz1XfHKVP%2Fimage.png?alt=media&amp;token=db94980f-fb36-4a48-99bf-d4212ca41835" alt=""><figcaption></figcaption></figure>

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

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

![](https://600673903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MRLRewlfPAN4AhSHhzD%2Fuploads%2FXVZlaQPYUYFbMn9R6n5W%2Fimage.png?alt=media\&token=035331e5-c037-470f-9712-f19d44048760)

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

<figure><img src="https://600673903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MRLRewlfPAN4AhSHhzD%2Fuploads%2FzdoaFkdnBB8AbNtyzBL6%2Fimage.png?alt=media&amp;token=7fca50cb-4cd5-42b8-a8a4-9d1d0dffc060" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://600673903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MRLRewlfPAN4AhSHhzD%2Fuploads%2FCYQaS6junhGzPz0Vy81M%2Fimage.png?alt=media&amp;token=524d6351-0cb5-4f53-94e3-c6a93874dce3" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://600673903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MRLRewlfPAN4AhSHhzD%2Fuploads%2F731c4alHIlVh281SqBow%2Fimage.png?alt=media&amp;token=28534f07-1b8e-4402-8d5a-db50d29a8cc5" alt=""><figcaption></figcaption></figure>

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

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

![](https://600673903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MRLRewlfPAN4AhSHhzD%2Fuploads%2FDPbXPm9F0PiApTxSvapI%2Fimage.png?alt=media\&token=b884b708-af7f-4698-ab9a-5c6cad112424)

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

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

![](https://600673903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MRLRewlfPAN4AhSHhzD%2Fuploads%2FluBxmARlngoZLW73ad2u%2Fimage.png?alt=media\&token=edcc97d5-70af-4c87-9cc5-ae1a9198680c)

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

<figure><img src="https://600673903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MRLRewlfPAN4AhSHhzD%2Fuploads%2FIJeG6CsyJkQ9isi13Box%2Fimage.png?alt=media&amp;token=609a4fb3-925b-478d-a429-aeb407f92a03" alt=""><figcaption></figcaption></figure>

![](https://600673903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MRLRewlfPAN4AhSHhzD%2Fuploads%2F2HdTdpFg8V7R4MxvBh3z%2Fimage.png?alt=media\&token=a45020ba-08f2-4a30-9879-94c0b5f07901)

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

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

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

![](https://600673903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MRLRewlfPAN4AhSHhzD%2Fuploads%2FQNqLCBNNpNhn7bFsYcsH%2Fimage.png?alt=media\&token=93a37f5b-3f33-42e9-b7c4-0e950ca79c34)

![](https://600673903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MRLRewlfPAN4AhSHhzD%2Fuploads%2FlX7dc9O1udo3cF8akQ9n%2Fimage.png?alt=media\&token=fe2d5ac8-2721-4a0e-8233-835231bb69ea)

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

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

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

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

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

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

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

![](https://600673903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MRLRewlfPAN4AhSHhzD%2Fuploads%2FryjVNrnhRluXtKwql9bZ%2Fimage.png?alt=media\&token=e9458aa8-8249-4bad-89c4-96ad5e9362bc)

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

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

![](https://600673903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MRLRewlfPAN4AhSHhzD%2Fuploads%2FbVZMlLgpbZFd3IeycCTN%2Fimage.png?alt=media\&token=1e75b4bc-7d11-477f-a8be-41c3b2c22002)

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

![](https://600673903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MRLRewlfPAN4AhSHhzD%2Fuploads%2FDqQ6ikgRJIXXXpL7aNej%2Fimage.png?alt=media\&token=54ddd9ec-bec3-46eb-abc9-7a555a6dee6b)

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

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

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