Инструкция пользователя
Промокоды24: скидки в сделках и на сайте
Что делает приложение
«Промокоды24» добавляет на портал Битрикс24 промокоды со скидкой там, где штатных промокодов нет — в сделках CRM и на странице сайта.
Приложение состоит из трёх частей:
- Панель акций. Отдельный экран приложения, где заводятся промокоды и правила к ним: тип и размер скидки, срок действия, минимальная сумма, охват по товарам и воронкам, лимиты применений. Там же видна статистика: сколько раз код применяли, на какую сумму, в каких сделках.
- Поле «Промокод» в карточке сделки. Менеджер вводит код прямо в карточке, приложение проверяет правила и само записывает скидку в сделку. Сумма сделки пересчитывается штатным механизмом Битрикса, поэтому счёт, документы и отчёты видят ту же цифру, что и менеджер.
- Витрина для сайта. Блок «Товары и промокод» для конструктора Сайтов24 и CRM-форм. Посетитель выбирает товары из каталога портала, вводит промокод, видит итог со скидкой и оставляет заявку. В CRM появляется контакт и сделка с товарами и уже проставленной скидкой.
Кому подходит
- Менеджерам по продажам. Применить скидку в сделке по коду из рассылки или звонка, не считая её вручную и не правя цены построчно.
- Маркетологам. Завести акцию с правилами и сроком, ограничить число применений, потом посмотреть, сколько раз кодом воспользовались и на какую сумму дали скидок.
- Администратору портала. Установить приложение, выдать права, разместить витрину на странице сайта.
Приложение рассчитано на компании, которые продают через сделки CRM с товарными позициями или с суммой сделки, а каталог товаров ведут на портале.
Что приложение даёт
- Скидка по коду попадает в сделку штатным способом: в товарных строках заполняются поля скидки, сумму сделки Битрикс пересчитывает сам.
- Правила акции проверяются до применения: срок, минимальная сумма, воронка, охват, лимиты. Менеджер видит отказ с причиной, а не неверную сумму.
- Применения считаются и не теряются: общий лимит, лимит на клиента и одноразовость работают и в карточке сделки, и на сайте.
- Заявка с сайта приходит в CRM уже посчитанной: контакт, сделка, товарные строки со скидкой, расшифровка расчёта в комментарии.
Установка и что появляется на портале
Приложение ставится из Маркетплейса на портал. После установки оно само создаёт всё, что нужно для работы.
| Что создаётся | Где это видно |
|---|---|
| Три хранилища данных приложения: «Промокоды24: акции», «Промокоды24: витрины», «Промокоды24: применения» | Данные портала; наполняются через панель приложения |
| Пользовательский тип поля «Промокод» | В списке типов полей портала |
| Поле «Промокод» в карточке сделки | Карточка сделки, а также фильтр и колонка в списке сделок |
| Блок «Товары и промокод» в разделе «Магазин» | Конструктор Сайтов24 и CRM-форм |
| Подписки на события портала: удаление приложения, обновление приложения, удаление и изменение сделки | Внутренние обработчики, настройка не требуется |
Шаги установки независимы: если какой-то из них не прошёл (например, на портале нет нужного раздела), остальные всё равно выполняются.
Что требуется от администратора
- Установить приложение и подтвердить запрошенные права. Приложению нужны доступы к CRM, к хранилищу данных приложения, к Сайтам24, к каталогу товаров, к встройкам, к интернет-магазину, к мессенджеру и к данным пользователей.
- Убедиться, что в карточке сделки появилось поле «Промокод». Поле создаётся автоматически; если оно не появилось, повторная установка приложения создаёт его заново, не затрагивая уже заведённые акции.
- Заполнить каталог товаров портала, если акции или витрина должны работать по конкретным товарам и разделам.
- Для витрины на сайте — разместить блок на странице и вставить в него адрес витрины (см. раздел «Витрина на сайте»).
Удаление приложения с портала не стирает акции, витрины и журнал применений: они остаются в хранилищах данных портала. При повторной установке всё возвращается на место.
Панель приложения
Панель открывается из раздела «Приложения» портала. В шапке показан текущий тариф и ссылка на поддержку. Экран разделён на две вкладки: «Промокоды» и «Витрины для сайта».
Вкладка «Промокоды»
Список акций в виде таблицы: код и название, размер скидки, срок, число применений (при заданном лимите — в виде «3 из 10»), сумма выданных скидок. Отключённые акции помечены словом «отключён».
Рядом с заголовком видно, сколько активных акций занято из доступных по тарифу. Для каждой строки есть три действия: статистика, изменение, удаление.
Кнопка «Создать промокод» открывает форму акции. Если лимит активных акций по тарифу исчерпан, кнопка недоступна и рядом появляется подсказка: выключите ненужную акцию или перейдите на PRO.
Поля формы акции
| Поле | Что означает |
|---|---|
| Код | Сам промокод, который называют клиенту. Приводится к верхнему регистру, пробелы по краям убираются. Код должен быть уникальным на портале, до 64 символов. |
| Название акции | Пояснение для своих: показывается в списке и в подсказке менеджеру. Необязательное. |
| Тип скидки | «Процент» — скидка в процентах от стоимости подходящих позиций. «Фиксированная сумма» — скидка в рублях, распределяется между подходящими позициями пропорционально их стоимости. |
| Размер скидки | Число больше нуля. Для процента — не больше 100. Фиксированная скидка не может превысить стоимость подходящих позиций. |
| Минимальная сумма заказа | Код не применится, если сумма меньше указанной. Пусто — без ограничения. |
| Действует с / по | Границы срока. Пустые границы означают «бессрочно», в списке так и пишется. Дата окончания не может быть раньше даты начала. |
| Лимит применений, всего | Сколько раз кодом могут воспользоваться все клиенты вместе. Пусто — без лимита. |
| Лимит на одного клиента | Сколько раз кодом может воспользоваться один и тот же клиент. Пусто — без лимита. Поле блокируется, если включена одноразовость. |
| Одноразовый | Один клиент может применить код только раз. Это то же, что лимит на клиента, равный единице. |
| Не суммируется | Код не применится, если в сделке уже есть скидка. Защищает от двойной скидки на уже удешевлённые позиции. |
| Активен | Выключенная акция не применяется нигде и не занимает место в лимите тарифа. Выключение — способ убрать акцию из работы, не теряя её настройки и статистику. |
| Охват по товарам | «Все товары» — скидка считается от всей суммы. «Разделы каталога» — только позиции из отмеченных разделов. «Отдельные товары» — только отмеченные товары. Списки разделов и товаров подтягиваются из каталога портала. |
| Воронки сделок | Отметьте воронки, в которых код работает. Если не отмечено ничего, код действует во всех воронках. |
Статистика акции
Кнопка со значком диаграммы открывает окно статистики по коду:
- три показателя сверху: число применений, сумма выданных скидок, выручка со скидкой;
- журнал применений: дата и время, сделка, источник («витрина» или «карточка сделки»), сумма до скидки, скидка, сумма к оплате.
Если код ещё не применяли, окно так и сообщает.
Вкладка «Витрины для сайта»
Список витрин карточками. В каждой карточке — название, краткий состав («весь каталог», «раздел каталога» или число выбранных товаров), пометка «отключена» для неактивной витрины, кнопки изменения и удаления.
Главное в карточке — адрес виджета. Это тот адрес, который вставляется в настройку блока на странице сайта. Рядом кнопка «Копировать».
Удаление витрины сопровождается предупреждением: вставленный на сайт блок перестанет работать.
Поля формы витрины
| Поле | Что означает |
|---|---|
| Заголовок витрины | Показывается посетителю над списком товаров и подставляется в название созданной сделки. |
| Что показывать | «Выбранные товары» — только отмеченные позиции, в том же порядке, в каком они отмечены. «Раздел каталога» — активные товары выбранного раздела. «Весь каталог» — все активные товары портала. |
| Раздел | Раздел каталога; поле появляется для режима «Раздел каталога». |
| Товары витрины | Список товаров с ценами; отмеченные увидит посетитель. Поле появляется для режима «Выбранные товары». |
| Воронка | В какую воронку попадёт сделка по заявке. «По умолчанию» — воронка портала по умолчанию. |
| Стадия | Стадия внутри выбранной воронки. «Первая стадия» — стадия по умолчанию. Список стадий зависит от выбранной воронки. |
| Ответственный | Сотрудник, на которого запишется сделка. «Не назначать» — ответственного проставит сам Битрикс. |
| Ссылка на политику обработки данных | Ссылка под галочкой согласия в форме заявки. |
| Сообщение после отправки | Текст, который посетитель увидит вместо формы после успешной отправки. Если не заполнено, показывается «Заявка принята.». |
| Витрина активна | Отключённая витрина для посетителя не существует: страница по её адресу не покажет товары. |
Работа в карточке сделки
Поле «Промокод» находится в карточке сделки. Оно работает самостоятельно: переводить карточку в режим редактирования и нажимать «Сохранить» не нужно, скидку в сделку записывает само приложение.
Применение промокода
- Откройте сохранённую сделку. В поле «Промокод» введите код и нажмите «Применить» (или клавишу Enter).
- Приложение проверит правила акции и состав сделки.
- При успехе поле показывает применённый код и строку «Скидка: … → к оплате: …», а сумма сделки пересчитывается.
- При отказе поле показывает причину: истёк срок, не та воронка, не набрана минимальная сумма, исчерпан лимит и так далее.
Как считается скидка:
- Если в сделке есть товарные строки — скидка проставляется в них штатными полями скидки, и сумму сделки Битрикс пересчитывает сам. Ставка НДС, единица измерения и порядок строк сохраняются.
- Если товарных строк нет — уменьшается сама сумма сделки.
- Если сумма сделки проставлена вручную — скидка считается от этой суммы, товарные строки в этом режиме справочные и не трогаются.
Повторно применить код поверх уже применённого нельзя: приложение ответит «К сделке уже применён промокод …. Сначала уберите его». Это защита от двойной скидки на уже удешевлённых позициях.
Подбор подходящего кода
Если менеджер не помнит код, под полем есть ссылка «Подобрать промокод». По нажатию приложение показывает акции, которые подходят к этой сделке прямо сейчас — с учётом срока, воронки, охвата, лимитов и несуммируемости. Для каждой строки видно: код, название, размер скидки и итоговую сумму.
Нажатие на строку подставляет код в поле — остаётся нажать «Применить». Выбранный из списка код не может потом отказаться применяться: список считается той же проверкой, что и применение.
Подбор просматривает до ста активных акций и показывает не больше десяти, начиная с самой выгодной. Он запускается только по нажатию, а не при открытии карточки.
Снятие промокода
Рядом с применённым кодом есть ссылка «убрать». По ней приложение:
- возвращает ценам товарных строк исходный вид и обнуляет скидку в них (для сделки без позиций — восстанавливает сумму, записанную в журнале применений);
- очищает поле «Промокод»;
- возвращает применение в лимит акции: код снова доступен этому клиенту и другим.
Поле в списке сделок
Поле «Промокод» выведено в фильтр и в колонку списка сделок, поэтому сделки с конкретным кодом можно отобрать, не открывая карточки.
Витрина на сайте
Как создать и разместить
- В панели приложения откройте вкладку «Витрины для сайта» и нажмите «Создать витрину». Заполните состав товаров и настройки сделки, сохраните.
- Скопируйте адрес виджета из карточки витрины.
- В конструкторе Сайтов24 или CRM-формы добавьте на страницу блок «Товары и промокод» (раздел блоков «Магазин»).
- В настройках блока вставьте скопированный адрес в параметр «Адрес виджета». Там же настраивается высота блока.
- Опубликуйте страницу.
Пока адрес не вставлен, блок показывает подсказку: витрина ещё не настроена, создайте её в приложении и вставьте адрес в настройку блока. На одной странице можно разместить несколько блоков с разными витринами — у каждой витрины свой адрес.
Что видит посетитель
- Заголовок витрины и список товаров с ценами и кнопками количества.
- Поле «Промокод» с кнопкой «Применить» и сообщением о результате проверки.
- Итоги: «Сумма», «Скидка» (строка появляется только при скидке), «К оплате». Итог пересчитывается при каждом изменении количества.
- Поля заявки: имя, телефон, email (необязательно), галочка согласия на обработку персональных данных со ссылкой на политику, если она указана.
- Кнопка «Оформить».
Цены всегда берутся из каталога портала: со страницы передаются только товар и количество, поэтому подменить цену в браузере нельзя.
Что происходит при отправке заявки
- Проверяются обязательные поля: хотя бы один товар, имя, телефон и согласие на обработку персональных данных. Без согласия заявка не отправляется.
- Если в поле был введён промокод и он перестал подходить (например, изменился состав корзины), заявка не оформляется молча по полной цене — посетитель получает сообщение с причиной.
- Приложение ищет контакт по телефону, затем по email. Найденный контакт переиспользуется, иначе создаётся новый.
- Создаётся сделка: название «<заголовок витрины> от <дата и время>», выбранные в витрине воронка, стадия и ответственный, валюта — рубли. В комментарий сделки попадает расшифровка: промокод, сумма без скидки, скидка, сумма к оплате.
- В сделку записываются товарные строки со скидкой.
- Посетителю показывается сообщение об успехе — текст из настройки витрины или «Заявка принята.».
Повторное нажатие кнопки или повтор запроса из-за обрыва связи не создаёт вторую сделку: заявка оформляется один раз. Если сделку создать не удалось, применение промокода возвращается в лимит, а посетитель может повторить отправку.
Промокод из витрины попадает и в поле «Промокод» карточки, и в комментарий сделки, а скидка уже стоит в товарных строках. Поэтому заявка с сайта в карточке выглядит так же, как применённая менеджером: код виден в списке сделок, его можно убрать, а повторно применить поверх — нельзя.
Лимиты и учёт применений
| Правило | Как работает |
|---|---|
| Общий лимит | Считает все применения акции. Когда лимит исчерпан, код перестаёт применяться: «Лимит применений промокода исчерпан». |
| Лимит на клиента | Считает применения одного и того же клиента. Клиент опознаётся по телефону или почте — тем же, по которым витрина ищет дубль контакта, поэтому код, погашенный на сайте, учитывается и в карточке сделки. Сам телефон и почта при этом не сохраняются: в журнал пишется необратимый отпечаток. |
| Одноразовый код | Частный случай лимита на клиента, равного единице. Сообщение при отказе: «Промокод одноразовый и уже был использован». |
| Одновременные применения | Последний остаток лимита не могут занять двое: проверка и списание выполняются последовательно по конкретному коду. |
| Провал сделки | Если сделку перевели в стадию с семантикой «проиграна», применение возвращается в лимит акции. |
| Удаление сделки | Применение возвращается в лимит акции. |
| Снятие кода в карточке | Применение возвращается в лимит акции, если оно не вернулось раньше. |
| Возврат сделки в работу | Место в лимите заново не занимается: возврат односторонний. |
Записи журнала при возврате не удаляются — они помечаются возвращёнными. В списке акций такие применения больше не считаются, а в журнале окна статистики строка остаётся видна, и итоги этого окна её учитывают. Поэтому счётчик применений в списке и число применений в окне статистики могут расходиться — на столько, сколько применений вернулось в лимит.
Тарифы
| Тариф | Что доступно |
|---|---|
| Бесплатный | До 3 активных промокодов одновременно. |
| Пробный период | 14 дней без ограничения на число активных промокодов. |
| PRO | Без ограничения на число активных промокодов. |
Тарифом ограничено только количество активных акций. Поле «Промокод» в карточке сделки, подбор кодов, витрины, блок для сайта и статистика работают на всех тарифах без ограничений.
Как считается лимит:
- Место в лимите занимают только активные акции. Выключенные хранятся без ограничений — это архив, а не работа.
- Включение ранее выключенной акции занимает место так же, как создание новой.
- Панель показывает счётчик «активных N из M» и блокирует кнопку создания при достижении лимита. Проверка повторяется на стороне приложения: при попытке обойти блокировку приходит отказ «На текущем тарифе доступно активных промокодов: N. Выключите ненужные акции или перейдите на PRO».
- Если сервис тарифов временно недоступен, приложение действует по бесплатному тарифу: 3 активных промокода.
Где хранятся данные
Клиентские данные хранятся на самом портале, в хранилищах данных приложения:
| Что | Где |
|---|---|
| Промокоды и правила акций | Хранилище «Промокоды24: акции» на портале |
| Витрины | Хранилище «Промокоды24: витрины» на портале |
| Журнал применений | Хранилище «Промокоды24: применения» на портале |
| Контакты и сделки | Штатная CRM портала |
| Товары и цены | Штатный каталог портала |
На стороне вендора остаются только служебные данные, без содержания клиента: токены доступа к порталу, служебные очереди и журналы обращений, а также кратковременная отметка об отправленной заявке, чтобы одно и то же обращение не создало две сделки.
Персональных данных нет даже в журнале применений. Лимит «на клиента» считается по необратимому отпечатку телефона или почты: его достаточно, чтобы узнать повторное применение, но восстановить по нему контакт нельзя. Имя, телефон и почта из заявки попадают только в контакт CRM на портале клиента.
Удаление приложения гасит доступ к порталу, но не удаляет акции, витрины и журнал: они остаются у клиента.
Что приложение не делает
- Не работает в лидах, счетах, предложениях и смарт-процессах. Поле «Промокод» создаётся только в сделке.
- Не заменяет правила корзины интернет-магазина. Это отдельный механизм Битрикса, приложение его не настраивает и не читает.
- Не складывает два промокода в одной сделке. Применённый код нужно сначала убрать.
- Не рассылает уведомления. Ни в колокольчик, ни на почту, ни в чат.
- Не выгружает акции и журнал применений в файл. Статистика смотрится в панели.
- Не поддерживает другие валюты в витрине. Сделка по заявке с сайта создаётся в рублях.
- Не рассылает и не генерирует коды пачками. Каждая акция заводится вручную, один код на акцию.
Ограничения, о которых нужно знать
- Блок витрины на опубликованной странице облачного портала вживую не проверялся. Конструктор Сайтов24 обрабатывает содержимое блоков санитайзером контента, и на коробочном портале он ломает встраиваемый кадр. Обход предусмотрен, но на облачном портале не подтверждён. До проверки считайте размещение блока на странице сайта непроверенным сценарием.
- Отправка заявки из витрины вживую не проверялась. Логика создания контакта, сделки и товарных строк написана и защищена от повторов, но на реальном портале не прогонялась.
- Охват «Разделы каталога» в сделке действует только на товары каталога. Раздел приложение определяет само — по товару в позиции сделки. Позиция, набранная в сделке руками, без привязки к товару каталога, раздела не имеет и под такой код не попадёт.
- Сделка без товарных строк попадает только под охват «Все товары». Сделка, у которой есть лишь сумма, представляется одной позицией без привязки к товару.
- Флаг «не суммируется» не распространяется на акционные цены каталога в витрине. Он смотрит только на скидки, уже проставленные в сделке.
- Лимит на клиента опирается на первый телефон контакта. Если у контакта несколько номеров, а на сайте клиент оставил не первый, применения из двух каналов не свяжутся и лимит в этом случае не сработает.
- Промокод применяется только к сохранённой сделке. В новой несохранённой карточке поле сообщает: «Сначала сохраните сделку — скидку нужно к чему-то применить».
- Правки в справочниках портала доходят до приложения с небольшой задержкой: разделы каталога, воронки, стадии, сотрудники и состав витрины кэшируются на несколько минут. Правка самой акции применяется сразу — поле в карточке сделки видит новые правила без задержки.
- Если удалить акцию и завести код с тем же текстом заново, прежние записи журнала по этому коду сохраняются: они будут показаны как применения нового кода, и лимит на клиента по ним продолжит действовать. Общий счётчик применений при этом начинается с нуля.
- Витрина показывает до 200 активных товаров, в одной заявке — до 50 позиций. Частота обращений к публичной витрине ограничена, при слишком частых запросах страница временно перестаёт отвечать.
- Список для подбора ограничен: просматривается до ста активных акций, показывается до десяти.
Сообщения об отказе и что они означают
| Сообщение | Причина |
|---|---|
| Промокод не найден. | Такого кода на портале нет; проверьте написание. |
| Промокод отключён. | Акция существует, но снят флаг «Активен». |
| Промокод ещё не действует, начало — … | Не наступила дата начала акции. |
| Срок действия промокода истёк … | Прошла дата окончания акции. |
| Промокод не действует в этой воронке. | Сделка в воронке, которой нет в списке акции. |
| Промокод действует при заказе от … | Сумма меньше минимальной суммы заказа. |
| Промокод не суммируется с другими скидками, а в сделке уже есть скидка … | Включён флаг «Не суммируется», а в товарных строках уже стоит скидка. |
| Лимит применений промокода исчерпан. | Выбран общий лимит акции. |
| Промокод одноразовый и уже был использован. | Этот клиент уже применял одноразовый код. |
| Достигнут лимит применений этого промокода для вас. | Выбран лимит на клиента. |
| Промокод не распространяется на выбранные товары. | Ни одна позиция не попала под охват акции. |
| В сделке нет ни позиций, ни суммы — добавьте товары или сумму. | Скидку не к чему применить. |
| К сделке уже применён промокод …. Сначала уберите его. | Попытка применить код поверх действующего. |
| Такой промокод уже есть. | Код с таким текстом уже заведён на портале. |
| Процент скидки не может быть больше 100. | Ошибка в поле размера скидки. |
| Дата окончания не может быть раньше начала. | Ошибка в сроке действия. |
| На текущем тарифе доступно активных промокодов: … | Исчерпан лимит тарифа на активные акции. |
Результат работы приложения
- В сделках CRM появляется рабочий механизм промокодов: менеджер вводит код, приложение проверяет правила и само проставляет скидку, сумма сделки пересчитывается штатно и попадает в счета и отчёты без ручной правки.
- У маркетолога есть управляемые акции со сроком, охватом и лимитами и журнал, по которому видно, сколько раз кодом воспользовались и на какую сумму дали скидок.
- Все акции, витрины и журнал применений остаются на портале клиента, а персональные данные в журнал не попадают.