Карты лояльности

← Оглавление

Карта лояльности — это «пропуск» клиента в программу: пластиковая карта или виртуальная карта в телефоне с уникальным номером и штрихкодом. Кассир сканирует карту, и платформа сразу понимает, кто перед ним: начисляет бонусы на счёт клиента, учитывает его уровень и персональные акции. В отличие от подарочной карты, денег на карте лояльности нет. Карта только указывает на профиль клиента, а бонусы, уровень и история покупок хранятся в самом профиле.

Работа с картами разнесена по двум пунктам меню:

• «Карты лояльности» (группа «Основное») — реестр всех карт организации: поиск по номеру, статусы, привязка к клиентам, блокировка и перевыпуск. Это рабочее место оператора.
• «Программы карт» (группа «Маркетинг») — какими бывают карты: формат номера и вид штрихкода. Здесь же тиражи — выпуск партий пластика для типографии.

Зачем это бизнесу#

• Быстрая идентификация на кассе. Скан штрихкода занимает секунду, и гостю не нужно диктовать телефон при очереди. Ошибок и неловких пауз становится меньше.
• Пластик или виртуальная карта — на выбор клиента. Гостям без смартфона выдают пластик из тиража, остальным — виртуальную карту без печати и доставки.
• Учёт каждой карты. По любому номеру видно, выдана ли карта, кому и когда, лежит ли она в запасе или списана. Тираж для типографии выгружается файлом, каждая выгрузка записывается в журнал.
• Потерянная карта — не потерянные бонусы. Карту блокируют или перевыпускают за минуту. Бонусы и история остаются в профиле клиента, и новая карта сразу ведёт в тот же профиль.
• Защита от злоупотреблений. Номер карты уникален навсегда: утерянную или списанную карту нельзя вернуть в оборот или выдать другому человеку. Случайные номера практически невозможно подобрать перебором.

Основные понятия#

Программа карт#

Программа описывает вид карты: из чего состоит номер (префикс, длина, контрольная цифра), каким кодом он напечатан на карте и как разбивается на группы при показе. Программ может быть несколько — например, основная карта сети и отдельная карта для партнёров. Подробно — в разделе «Программы карт».

Одна программа есть у каждой организации всегда — системная «Внешние карты» (код DEFAULT). В неё попадают номера, пришедшие извне: карты, напечатанные сторонней типографией, номера, указанные при создании клиента, введённые кассой или оператором. Подробно — в подразделе «Системная программа «Внешние карты»».

Носитель#

Номер и штрихкод#

• Номер уникален в организации навсегда. Двух карт с одинаковым номером не бывает. Номер утерянной, заменённой или списанной карты повторно не выпускается.
• Номера, которые генерирует платформа, состоят только из цифр и не начинаются с нуля. Обычно последняя цифра — контрольная: если при ручном вводе ошиблись в одной цифре, платформа сразу ответит «Неверная контрольная цифра», а не будет искать несуществующую карту.
• Отображаемый номер разбивается по маске программы на группы, например 9900 1234 5678 9017. Пробелы и дефисы нужны только для удобства чтения: при поиске, сканировании и вводе их можно ставить или не ставить.
• Штрихкод или QR-код содержит только номер карты. Ни имени, ни телефона клиента в нём нет.
• Сканер работает в любой раскладке. USB-сканер «печатает» номер как клавиатура. Если на компьютере включена русская раскладка, буквы во внешних номерах исказятся — админ-панель сама вернёт их на место.

Статусы карты#

Обычный путь пластиковой карты: «Новая» (в запасе) → «Активна» (выдана клиенту) → при необходимости «Заблокирована» или «Утеряна» → «Заменена» после перевыпуска. Виртуальная карта появляется сразу «Активной».

У заблокированных, утерянных, заменённых и списанных карт сохраняется причина: «По просьбе клиента», «Утеря», «Кража», «Повреждение», «Мошенничество», «Замена на новую», «Другое» и две системные — «Клиент удалён» и «Тираж отменён». В таблицах причина всплывает подсказкой при наведении на статус.

Кнопки действий платформа показывает сама — по статусу карты и вашей роли (см. «Кто что может»). У карты удалённого клиента действий нет совсем.

Реестр карт#

Пункт меню «Карты лояльности» открывает реестр: все карты организации во всех программах и статусах. Заголовок страницы — «Карты лояльности», подзаголовок — «Реестр карт: поиск, статусы и операции». В правом верхнем углу — кнопки перехода «Программы» и «Тиражи» (их видят роли с доступом к этим страницам).

Фильтры над таблицей:

Фильтры сохраняются в адресе страницы, поэтому ссылку на отфильтрованный реестр можно отправить коллеге. Кнопка «Сбросить фильтры» снимает их все разом. Из карточки тиража реестр открывается с фильтром по этому тиражу: над таблицей появляется тег «Тираж: ‹название›», крестик на теге снимает фильтр.

Колонки таблицы:

В крайней правой колонке — меню «⋮» с действиями, доступными карте сейчас: «Привязать к клиенту», «Разблокировать», «Перевыпустить», «Заблокировать», «Отметить утерянной», «Отвязать», «Списать». Щелчок по строке открывает карточку карты. Сверху стоят самые новые карты; внизу — счётчик «Всего: N» и постраничная навигация, по умолчанию по 20 карт на страницу.

На скриншоте реестр отфильтрован по «Привязка: Привязана», поэтому в нём только карты, выданные клиентам. Карты из запаса со статусом «Новая» этот фильтр скрывает. Все видимые карты — программы «Основная», с номерами вида 9900 …. Сверху виртуальные карты Алишера Каримова и Зарины Ахмедовой, ниже — пластик. Большинство карт «Активны», у Рустама Назарова карта «Утеряна», у Дмитрия Козлова — «Заблокирована».

Кроме карт «Основной» в демо-организации есть внешние карты — номера от DEMO-0001 до DEMO-0010, указанные при создании первых десяти клиентов. Они созданы раньше остальных и поэтому стоят в конце списка: быстрее всего найти их фильтром «Программа» или поиском DEM.

Поиск по карте#

Карту можно найти и не заходя в реестр. В шапке админ-панели на любой странице есть значок сканера — кнопка «Поиск по карте». Она открывает окно с полем «Отсканируйте карту или введите номер»: отсканируйте карту или наберите номер и нажмите Enter. Номер ищется целиком, в любом написании — с пробелами и дефисами или без.

Кнопки зависят от вашей роли: например, «Создать клиента с этой картой» видят только те, кто может добавлять клиентов. У карты без клиента в других статусах, например списанной, остаётся только «Открыть карту».

После каждого поиска поле очищается и снова готово к сканированию. Это удобно, когда нужно проверить стопку карт подряд.

Карточка карты#

Щелчок по номеру в реестре, на вкладке «Карты» клиента или кнопка «Открыть карту» в поиске открывают карточку карты.

Шапка. Заголовок — номер карты по маске, под ним — программа и носитель («Основная · Пластик»). Стрелка ← возвращает в реестр. Справа — статус и кнопки действий: первые два доступных действия показаны кнопками, остальные собраны в меню «Действия». У активной карты это обычно «Перевыпустить» и «Заблокировать», а в меню — «Отметить утерянной» и «Отвязать».

Изображение карты. Слева — схематичная карта: название программы, штрихкод или QR-код и номер. Кнопка «Показать код» открывает код крупно, чтобы его можно было считать сканером прямо с экрана. Подсказка в окне напоминает: «Штрихкод с экрана читают только сканеры-имиджеры, лазерный сканер его не прочитает».

Блок «Сведения» справа:

Если карта больше не обслуживается, над изображением появляется пояснение. У заменённой карты — «Карта заменена новой картой и к использованию не возвращается» со ссылкой на новую карту. У списанной — «Карта списана и к использованию не возвращается». У карты удалённого клиента — «Карта заблокирована из-за удаления клиента: разблокировка и перевыпуск недоступны, номер не освобождается».

История#

Под карточкой — таблица «История»: все события карты, новые сверху.

История отвечает на спорные вопросы вида «почему у клиента не работает карта»: видно, кто, когда и по какой причине её заблокировал или заменил.

На скриншоте — пластиковая карта 9900 0634 6391 1172 программы «Основная» из «Демо-тиража», выданная Гулнозе Хамидовой. Её история читается снизу вверх. Сначала «Привязка»: её выполнила «Система» при заполнении демо-данных. Затем «Блокировка» с причиной «По просьбе клиента». И наконец «Разблокировка» с комментарием «Карта нашлась», которую выполнил сотрудник — в колонке «Кто» стоит «Пользователь». Карта снова «Активна», поэтому в шапке кнопки «Перевыпустить» и «Заблокировать» и меню «Действия».

Другой пример из демо-данных: у Зарины Ахмедовой пластиковая карта отмечена утерянной и перевыпущена виртуальной. В истории старой карты — «Привязка», «Утеря» и «Замена» со ссылкой на новую, а сама карта в статусе «Заменена».

Привязка карты к клиенту#

Привязать к клиенту можно только свободную карту в статусе «Новая». Окно привязки открывается тремя путями: пункт «Привязать к клиенту» в меню «⋮» реестра, одноимённая кнопка в шапке карточки карты или в окне «Поиск по карте».

Окно называется «Привязать карту ‹номер›». В поле «Клиент» (подсказка «Имя, телефон или почта») начните вводить имя, телефон или почту и выберите клиента из списка. Под полем появится сводка лимита: «Активных карт: N, без ограничения», если лимит не задан, или «Активных карт: N из M».

На скриншоте окно открыто из карточки свободной карты 9900 6775 1030 4204 программы «Основная» из «Демо-тиража». Карта в статусе «Новая», поэтому в шапке кнопки «Привязать к клиенту» и «Списать», а история пока пуста: «Событий пока нет». Карту привязывают к Севаре Исмаиловой. Активных карт у неё нет, а лимит в демо-организации не задан, поэтому под полем — «Активных карт: 0, без ограничения». Внизу окна — кнопки «Отмена» и «Привязать к клиенту». Если клиент уже держит максимум активных карт, рядом стоит тег «лимит достигнут», кнопка «Привязать к клиенту» неактивна, а подсказка объясняет: «Лимит активных карт клиента достигнут: сначала отвяжите или заблокируйте другую карту». Лимит задаётся в настройках организации (см. «Лимит карт на клиента»).

После привязки карта становится «Активной», в колонке «Привязана» появляется дата, а в истории — событие «Привязка». С этого момента касса узнаёт клиента по скану карты.

Если привязка не прошла, причина показывается прямо в окне, над формой:

• «Карта уже привязана к другому клиенту» — карту успели выдать, пока окно было открыто;
• «Достигнут лимит активных карт клиента» — клиенту выдали другую карту параллельно;
• «Клиент занят другой операцией, повторите через несколько секунд» — например, с его профилем как раз идёт объединение дублей. Нажмите «Повторить».

Другие способы выдать карту:

• С вкладки «Карты» в карточке клиента — кнопка «Выдать карту»: по номеру или скану либо как виртуальную карту программы (см. ниже).
• При создании клиента — поле «Номер карты» в форме нового клиента (см. «Клиенты»). Если номер занят или карта не может быть выдана, ошибка появится у поля: «Карта уже привязана к другому клиенту», «Карту нельзя привязать: она заблокирована, утеряна, заменена или списана», «Неверная контрольная цифра».
• На кассе — при первой покупке нового гостя по карте из запаса (см. «Как карта работает на кассе»).

Перевыпуск#

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

Окно «Перевыпустить карту ‹номер›» спрашивает:

• Причина (обязательно) — «Утеря», «Кража», «Повреждение», «Замена на новую» или «Другое». Для «Другое» обязателен комментарий.
• Комментарий — до 255 символов.
• Новая карта — переключатель из двух вариантов:
  • «По номеру или скану» — отсканируйте или введите номер новой карты, например пластика из запаса. Под полем сразу видно, подходит ли номер: «Карта свободна», «Карта привязана к другому клиенту», «Карту нельзя привязать: ‹статус›», «Номера нет в реестре; он будет зарегистрирован как внешняя карта», «Неверная контрольная цифра». Если номер не подходит, кнопка «Перевыпустить» неактивна;
  • «Виртуальная» — выберите программу, и платформа сама выпустит новую виртуальную карту.

После перевыпуска старая карта получает статус «Заменена», новая становится «Активной». В обеих карточках появляются ссылки «Заменена на» и «Заменяет». Если перевыпуск запущен из карточки карты, вы сразу попадёте в карточку новой карты.

Лимит карт при замене активной карты не проверяется: число активных карт клиента не меняется. Замена заблокированной или утерянной карты добавляет клиенту активную карту, поэтому проходит обычную проверку лимита.

Блокировка и разблокировка#

Блокировка временно выключает карту: на кассе она перестаёт приниматься, но остаётся привязанной к клиенту. В окне «Заблокировать карту ‹номер›» предупреждение «Карта перестанет приниматься на кассе до разблокировки», обязательная причина («По просьбе клиента», «Утеря», «Кража», «Повреждение», «Мошенничество», «Другое») и комментарий до 255 символов. Для «Другое» комментарий обязателен.

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

Разблокировка — кнопка «Разблокировать» у заблокированной карты. Окно спрашивает только комментарий. Карта снова становится «Активной», поэтому разблокировка проверяет лимит активных карт клиента, как и выдача новой. Карту, заблокированную из-за удаления клиента, разблокировать нельзя.

Утеря, отвязка и списание#

«Отметить утерянной» — для активной или заблокированной карты. Окно спрашивает только комментарий и предупреждает: «Карта не вернётся к использованию; её можно будет только перевыпустить». В отличие от блокировки, это решение окончательное.

«Отвязать» — снимает активную карту с клиента. Причина необязательна («По просьбе клиента» или «Другое»), предупреждение зависит от носителя:

• пластиковая и внешняя карта — «Карта вернётся в запас и сможет быть выдана другому клиенту»: она снова становится «Новой»;
• виртуальная карта — «Виртуальная карта после отвязки будет списана»: без владельца она не имеет смысла.

«Списать» — только для свободной карты в статусе «Новая»: брак при печати, повреждённый пластик в запасе. Причина необязательна («Повреждение» или «Другое»), предупреждение — «Списание необратимо; номер не будет выпущен повторно». Списывают карты только администраторы.

Программы карт#

Пункт меню «Программы карт» — справочник видов карт. Заголовок страницы — «Программы карт», подзаголовок — «Форматы номеров и коды карт лояльности».

Список программ#

В правом верхнем углу — кнопки «Создать программу» и «Тиражи», а переход «Реестр карт» собран в меню «Действия». Над таблицей — фильтр «Статус»: «Активна» или «В архиве».

Меню «⋮» в строке: «Редактировать», «Тиражи программы» (список тиражей с фильтром по этой программе), «Карты программы» (реестр с фильтром по программе) и «В архив» или «Вернуть из архива». Пункты собираются по вашей роли.

На скриншоте четыре программы:

• DEFAULT «Внешние карты» с тегом «Системная» и форматом «Внешние номера · Code128» — 10 карт;
• MAIN «Основная» — «Случайная · 16 цифр · префикс 9900 · Luhn · Code128», пример 9900 1234 5678 9017, 52 карты;
• CORP «Корпоративная» — «Последовательная · 13 цифр · префикс 2701 · EAN-13», 130 карт;
• PILOT «Пилот в Юнусабаде» — «Случайная · 12 цифр · префикс 55 · Luhn · QR-код», ни одной карты, статус «В архиве».

Заполнение демо-данными создаёт первые две; «Корпоративная» и архивный «Пилот» заведены для примера.

Создание программы#

Кнопка «Создать программу» открывает страницу «Новая программа карт». Слева — три блока полей, справа — «Предпросмотр»: изображение карты с примером номера и кодом, которое меняется прямо по мере ввода. Подпись под ним напоминает: «Пример. Номер не резервируется». Если параметры несовместимы, вместо примера появляется предупреждение «Исправьте параметры нумерации, чтобы увидеть пример» со списком того, что не так.

Если выбран EAN-13, длина номера фиксируется на 13 цифрах, контрольная цифра — EAN-13, а префикс должен начинаться с 2 и содержать от 2 до 6 цифр. Платформа предупреждает: «Префикс 20–29 — диапазон GS1 для внутреннего использования. Он не должен пересекаться с префиксами весового товара на кассах, иначе касса примет карту за товар». Уточните у поставщика кассы, какие префиксы заняты весовым товаром, до печати тиража.

На скриншоте заполняется программа STAFF «Карты сотрудников»: последовательная нумерация, префикс 7700, длина номера 12 цифр, контрольная цифра Luhn. Предпросмотр справа сразу показывает, как будет выглядеть номер такой карты.

Внизу страницы — кнопки «Отмена» и «Создать». Новая программа сразу «Активна»: под неё можно выпускать тиражи и виртуальные карты.

Редактирование#

Пункт «Редактировать» открывает ту же форму с заголовком «Редактирование программы карт». Код показан только для чтения. Пока в программе нет ни одной карты и ни одного тиража, остальные поля можно менять свободно. После первого выпуска способ нумерации, префикс, длина и контрольная цифра блокируются, и форма поясняет: «Нумерацию нельзя изменить: в программе есть карты или тиражи». Иначе уже напечатанный пластик перестал бы соответствовать программе. Название и маска по-прежнему меняются, а символика — только между Code128 и QR-кодом: у программы с EAN-13 она закреплена.

Если ничего не изменилось, после нажатия «Сохранить» платформа ответит «Изменений нет».

Статусы программы: архив#

У программы два статуса: «Активна» и «В архиве». Удалить программу нельзя, её можно только отправить в архив.

«В архив» — после подтверждения «Новые карты в программе выпускаться не будут. Уже выпущенные карты продолжат работать». Тираж или виртуальную карту в архивной программе выпустить нельзя, но её карты по-прежнему находятся сканером, привязываются, блокируются и перевыпускаются. «Вернуть из архива» снова делает программу активной.

Системная программа «Внешние карты»#

Программа с кодом DEFAULT создаётся автоматически и всегда есть в списке с тегом «Системная». Номера в ней не генерируются: она собирает внешние номера. Когда оператор выдаёт клиенту карту с номером, которого нет в реестре, или касса присылает такой номер при регистрации нового гостя, номер регистрируется здесь как карта с носителем «Внешняя» и сразу привязывается к клиенту.

У системной программы меняется только название. Форма поясняет: «Системная программа внешних номеров: в неё попадают номера, пришедшие извне. Изменить можно только название». Тиражи для неё не выпускаются.

Архив системной программы — способ запретить «самодельные» карты. Подтверждение предупреждает: «Неизвестные номера перестанут регистрироваться: касса и админка будут отклонять карты, которых нет в реестре. Уже зарегистрированные карты продолжат работать». Делайте так, когда все карты сети выпускаются тиражами через платформу и любой номер вне реестра — ошибка или попытка подделки.

Тиражи#

Тираж — партия пластиковых карт одной программы. Платформа генерирует номера, вы выгружаете их файлом для типографии, а напечатанные карты лежат в запасе со статусом «Новая», пока их не выдадут клиентам.

Список тиражей#

Страница «Тиражи» открывается кнопкой «Тиражи» со страниц программ и реестра. Подзаголовок — «Выпуск пластиковых карт и выгрузка для типографии». Стрелка ← возвращает к программам. В правом верхнем углу — кнопки «Выпустить тираж» и «Реестр карт». Над таблицей — фильтры по программе и статусу.

Меню «⋮»: «Открыть», «Выгрузить CSV» (у готового тиража), «Возобновить» (у тиража с ошибкой) и «Отменить тираж». Пока в списке есть генерирующийся тираж, страница сама обновляется каждые несколько секунд.

На скриншоте три тиража:

• «Бизнес-центр «Пойтахт»» программы CORP на 120 карт, «Готов», одна выгрузка;
• «Пробная партия» той же программы на 10 карт, «Отменён», выгрузок нет;
• «Демо-тираж» программы MAIN на 50 карт, «Готов», одна выгрузка. Его создаёт заполнение демо-данными.

У «Корпоративной» нумерация последовательная, поэтому у её тиражей в колонке «Диапазон» видны первый и последний номер, например 2701000000110 – 2701000001308. У «Основной» нумерация случайная, и у «Демо-тиража» в этой колонке прочерк.

Выпуск тиража#

Кнопка «Выпустить тираж» открывает мастер «Выпуск тиража» из двух шагов.

Шаг «Параметры».

• Программа — только активные программы, которые генерируют номера. Если таких нет, мастер предложит «Создать программу».
• Количество — от 1 до 100 000 карт, по умолчанию 1 000.
• Название — например «Тираж, октябрь 2026»: по нему тираж ищут в списке и в карточке карты.
• Комментарий — до 500 символов: номер заказа в типографии, адрес доставки, ответственный.

Кнопка «Далее» переходит к проверке.

Шаг «Проверка» — предпросмотр номеров. Платформа показывает, хватит ли номеров, ничего при этом не резервируя:

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

При случайной нумерации платформа намеренно занимает лишь небольшую долю всех возможных номеров (по умолчанию 10 %), чтобы номер карты нельзя было подобрать перебором. Поэтому «Доступно» заметно меньше «Ёмкости». Если номеров не хватает, появляется ошибка «Свободных номеров недостаточно для этого количества. Уменьшите количество или выберите другую программу», и кнопка выпуска неактивна.

Кнопка «Выпустить N карт» создаёт тираж. Мастер закрывается, появляется сообщение «Тираж создан, генерация запущена», и открывается карточка тиража. Номера генерируются в фоне: страницу можно закрыть, генерация продолжится на сервере. Повторное нажатие из-за сбоя связи второй тираж не создаст.

Карточка тиража#

Шапка — название тиража, под ним программа с кодом, справа — статус и кнопки действий. Стрелка ← возвращает к списку тиражей.

Под шапкой — ключевые цифры: «Количество», «Сгенерировано» с процентом и «Выгрузок».

• Пока тираж генерируется или остановился с ошибкой, виден блок «Генерация»: круговой индикатор и подпись «N из M». Карточка обновляется сама, а по окончании появляется сообщение «Генерация тиража завершена». Если генерация остановилась, блок покажет «Генерация остановлена с ошибкой» и причину.
• Блок «Карты тиража» — шесть счётчиков по статусам: сколько карт ещё «Новые», сколько «Активны», «Заблокированы», «Утеряны», «Заменены» и «Списаны». Кнопка «Открыть в реестре» открывает реестр с фильтром по этому тиражу.
• Справа — «Сведения»: программа, диапазон номеров (для последовательной нумерации), комментарий, «Создал» (короткий идентификатор сотрудника), даты «Создан», «Завершён», «Последняя выгрузка» и ID.

На скриншоте — тираж «Бизнес-центр «Пойтахт»» программы «Корпоративная (CORP)» в статусе «Готов». В шапке кнопки «Выгрузить CSV» и «Отменить тираж». В плитках: «Количество» 120, «Сгенерировано» 120 (100 %), «Выгрузок» 1. Блока «Генерация» нет — тираж уже готов. В блоке «Карты тиража» — 119 «Новых» карт и одна «Списанная»: ни одна карта ещё не выдана, одну списали из запаса. В «Сведениях» — диапазон номеров и комментарий «Карты для сотрудников компаний-арендаторов».

Выгрузка для типографии#

Кнопка «Выгрузить CSV» доступна у тиража в статусе «Готов». Подтверждение напоминает: «Файл будет содержать все номера тиража (N карт). Выгрузка записывается в журнал». Файл loyalty-cards-‹ID тиража›.csv в кодировке UTF-8 корректно открывается в Excel. Колонки файла:

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

Отмена и возобновление#

«Отменить тираж» доступно в любом статусе, кроме «Отменён», в том числе во время генерации. Подтверждение предупреждает: «Карты тиража в статусе «Новая» будут списаны. Выданные клиентам карты не изменятся. Отмену нельзя отменить». Списанные так карты получают причину «Тираж отменён». Отменяют тираж, если типография потеряла файл, напечатала брак или заказ не состоялся.

«Возобновить» — у тиража в статусе «Ошибка». Генерация продолжается с того места, где остановилась: уже созданные номера не дублируются. Такой статус тираж получает, например, если сервер перезапустили посреди генерации.

Вкладка «Карты» в карточке клиента#

В карточке клиента есть вкладка «Карты» — все карты этого клиента во всех статусах (см. «Клиенты» → «Вкладка «Карты»»). Над таблицей — сводка «Активных карт: N из M» (или «Активных карт: N, без ограничения») и кнопка «Выдать карту». В таблице — номер со ссылкой на карточку карты, программа, носитель, статус, дата привязки, значок «Показать код» и меню «⋮» с действиями. Заменённые и списанные карты показаны бледнее.

Кнопка «Выдать карту» открывает окно «Выдать карту клиенту» с переключателем «Новая карта»:

• «По номеру или скану» — номер карты из запаса или внешний номер. Под полем сразу видно, подходит ли номер: «Карта свободна», «Карта уже привязана к этому клиенту», «Карта привязана к другому клиенту» со ссылкой «Открыть клиента» и так далее. Скан только заполняет поле: чтобы выдать карту, нажмите «Выдать»;
• «Виртуальная» — выберите программу, и платформа выпустит клиенту виртуальную карту с новым номером. Сообщение — «Виртуальная карта выпущена».

Если лимит исчерпан, кнопка «Выдать карту» неактивна, а подсказка объясняет: «Достигнут лимит активных карт: N из M. Заблокируйте или отвяжите карту либо увеличьте лимит в настройках организации».

У клиента может быть несколько карт одновременно. В демо-организации у Алишера Каримова две активные карты — внешняя DEMO-0001 и виртуальная карта программы «Основная». А у Дилнозы Юсуповой к собственной DEMO-0002 добавилась пластиковая карта её дубля: при объединении профилей все карты переходят в главный профиль, и в истории такой карты появляется событие «Перенос при слиянии» (см. «Клиенты» → «Объединение дублей»).

Лимит карт на клиента#

По умолчанию число карт у клиента не ограничено. Администратор организации может задать лимит в разделе «Настройки», карточка «Карты лояльности», поле «Лимит активных карт на клиента» — от 1 до 100; пустое поле означает «без ограничения» (см. «Настройки»).

Как работает лимит:

• Считаются только активные карты клиента по всем программам. Заблокированные, утерянные, заменённые и списанные не в счёт.
• Проверяется при каждом переходе карты в «Активна»: привязке, выдаче виртуальной карты, разблокировке и перевыпуске заблокированной или утерянной карты. Замена активной карты лимит не проверяет.
• Уменьшение лимита не трогает выданные карты. Если у клиента уже больше карт, чем новый лимит, они продолжают работать. Новые выдачи будут отклоняться, пока активных карт не станет меньше лимита.
• Объединение дублей лимит не проверяет. Все карты поглощённого профиля переходят в главный, даже если их становится больше лимита. Сводка на вкладке «Карты» тогда покажет тег «лимит превышен».

Как карта работает на кассе#

Касса передаёт номер карты в заказ — в любом написании, с пробелами и дефисами или без. Дальше всё зависит от состояния карты:

Подробнее о регистрации гостей на кассе — в разделе «Заказы».

Касса или мобильное приложение могут работать с картами и напрямую, через API интеграций. Проверка скана — POST /v1/api/loyalty-cards/resolve. Скан передаётся в теле запроса, номер — в любом написании, а в ответе приходят карта, её статус, признак привязки и идентификатор клиента. Для остальных операций тоже есть запросы: привязка карты — POST /v1/api/loyalty-cards/bind, выпуск виртуальной карты — POST /v1/api/loyalty-cards/issue-virtual, блокировка — POST /v1/api/loyalty-cards/{id}/block. Ключу интеграции нужны права «Карты лояльности: чтение» и «Карты лояльности: запись» (см. «Интеграции»).

О событиях с картами можно получать уведомления во внешние системы. В каталоге событий подписки есть «Карта лояльности привязана к клиенту», «Карта лояльности отвязана от клиента», «Карта лояльности заблокирована или утеряна», «Карта лояльности разблокирована» и «Карта лояльности заменена» (см. «Вебхуки»). При перевыпуске приходят два события: о замене старой карты и о привязке новой.

Кто что может#

Реестр ссылается на персональные карточки клиентов, поэтому доступ к нему такой же, как к разделу «Клиенты»: маркетологу он не показывается. Программы и тиражи — справочные данные без персональных сведений. Маркетолог настраивает виды карт, а выпуск тиража и выгрузку номеров для типографии оставляют администраторам: файл содержит все номера карт. Оператор видит названия программ и тиражей в списках и фильтрах, но без ссылок на их страницы.

Лимит карт на клиента в разделе «Настройки» меняет только Администратор организации.

← Оглавление