Данный документ прежде всего предназначен специалистам и программистам систем 1С, внедряющим технологию электронных карт Wallet от OSMICards в бизнес-процессы и рабочие конфигурации 1С предприятий и организаций, и использующие для этого модуль ОСМИ для 1С. Подразумевается что специалист 1С уже знаком с концепцией создания, изменения и конфигурирования программ лояльности в продуктах 1С таких как Розница, УТ,УНФ и умеет работать с источниками данных, писать простые SQL запросы в среде 1С для извлечения таких данных как например текущий баланс бонусов и уровней скидок по номеру карты лояльности клиента, настраивать регламентные задания и обладает навыками программирования в 1С, умеет соединять (merge) конфигурации.

В данном документе описана общая концепция сервиса ОСМИ (OSMICards) по работе с электронными картами Wallet. Данный документ не претендует на представление полного и детального описания работы сервиса, но предназначен для специалистов 1С, внедряющих сервис электронных карт ОСМИ в своих организациях, и работающих с сертифицированным модулем ОСМИ для 1С. Затронуты наиболее основные темы электронных карт, необходимые для успешного внедрения сервиса, сама идеология сервиса и настройки модуля, даны примеры настроек для наиболее часто встречающихся ситуаций и продуктов 1С.

Документ не является инструкцией по настройке программы конкретного бизнеса для работы с электронными картами ОСМИ, а только указывает на общие принципы работы сервиса и его взаимодействие с модулем ОСМИ для 1С. 

Каждому созданному в ЛК ОСМИ дизайну присваивается уникальное имя, и обращение к этому дизайну из 1С идет по этому имени. Другое название созданного дизайна с уникальным именем – Шаблон карты. Далее в документе для описания такого дизайна используется термин Шаблон Карты
Шаблон карты можно представить себе как лист бумаги формата А4, у которого есть лицевая и оборотная стороны. Лист бумаги на обоих сторонах разделен на секции. В одной из секций (в нижней зоне лицевой стороны) может быть размещен баркод, если он разрешен к показу и у него есть содержимое, то есть имеется что показывать. Другие секции на лицевой и оборотной стороне называются Полями. Каждое поле предназначено для вывода текстовой информации в определенную позицию карты. Каждое поле имеет Имя (ярлык), по которому можно обращаться к этому полю. У каждого поля есть свойство (Сообщение), которое напрямую влияет будет ли показано всплывающее сообщение на заблокированном экране телефона (его еще не корректно называют пушем) при обновлении содержимого данного поля.

В поля на лицевой стороне карты можно выводить только текстовую информацию. Вывод активных ссылок в поля на лицевой стороне карты не поддерживается. Но можно выводить все существующие эмодзи. Как правильно задать эмодзи в строках 1С для последующего вывода на электронную карту смотри здесь.

В поля на оборотной стороне можно выводить информацию, содержащую эмодзи, активные ссылки на вебсайты, телефоны и адреса. Например нижеследующая строка в поле карты: ‘Посетите <a href=”https://osmicards.com”>наш сайт</a>’ будет выглядеть на карте как ‘Посетите наш сайт’ со встроенной активной ссылкой. Всегда обращайте внимание на двойные кавычки, используемые в такой конструкции.

Так как имена полей (ярлыки) используются для доступа к соответствующему полю, то эти имена полей в шаблоне должны быть уникальны. При доступе к полю, нужно абсолютно точно указывать его название как прописано в шаблоне карты. Например, если в шаблоне карты есть поле «Баланс», то и обратиться к нему из 1С можно только по имени «Баланс». Если же обратиться к нему по имени «баланс» с маленькой буквой «б», то вернется ошибка, так как такого поля в шаблоне карты нет.

Еще следует учитывать тот факт, что при отображении на телефоне, названия полей на лицевой стороне карты всегда переводятся в верхний регистр самим телефоном. То есть если в шаблоне карты поле называется «Владелец» и обращаться к нему из 1С надо с использованием имени поля «Владелец», хотя на телефоне это поле будут показано как ВЛАДЕЛЕЦ. На оборотной стороне карты такого перевода названия поля в верхний регистр не происходит и названия полей всегда отображаются так же, как и в шаблоне карты. 

Если в Личном Кабинете ОСМИ удалить карту с определенным номером, то физически карта не удалится из БД ОСМИ, а просто будет помечена как удаленная. То есть создать еще одну карту с таким же номером в ОСМИ будет невозможно до тех пор, пока помеченная как удаленная карта не будет физически вычищена из БД ОСМИ (делается по запросу в компанию ОСМИ). Сделано это таким образом для того, чтобы было невозможно из ЛК ОСМИ стереть электронную карту с телефона клиента, если она была установлена.

Номер карты ОСМИ не следует путать с номером карты лояльности клиента в 1С или штрихкодом в 1С. Все общение с сервисом ОСМИ идет по номеру карты ОСМИ. Номер карты ОСМИ может состоять из любой комбинации цифр от 0 до 9 и латинских букв. Большие/маленькие буквы в номере карты не различаются. Общая длина номера карты – до 20-ти символов включительно.

Примеры действительных номеров карт: 000001, zz1100000000078, ABCD000EE34
Примеры одинаковых номеров карт: 00AA22123, 00aA22123

Если на электронной карте показывается баркод, то в него можно занести штрихкод карты клиента из 1С. При предъявлении такой электронной карты на кассе и считывании с нее баркода сканером, 1С однозначно определит клиента по считанному содержимому баркода. Чтобы это реализовать, в шаблоне карты в ЛК ОСМИ должно быть указано, что содержание баркода Произвольный Текст, и далее в баркод самой электронной карты, созданной с этого шаблона, нужно будет записать собственно значение штрихкода из 1С. С точки зрения сервиса ОСМИ, содержимое баркода электронной карты – это такое же поле для записи строки, как и другие поля карты. Просто у него специфическое имя поля (barcode). 

В некоторых ситуациях можно настроить 1С так, что штрихкоды клиентов в 1С будут совпадать с номерами карт ОСМИ. Тогда можно упростить запись (вообще от нее отказаться) штрихкода в баркод электронной карты, просто указав в шаблоне карты что содержимое баркода равно серийному номеру карты.
Тогда, при попытке записать другой штрихкод в баркод карты с таким признаком, вернется ошибка и в баркоде карты останется серийный номер карты ОСМИ.
Если нумерация карт ОСМИ и нумерация карт клиентов (штрихкодов) различается, то в этом случае Модуль ОСМИ для 1С использует таблицу соответствий номеров карт ОСМИ номерам штрихкодов 1С. 

Обычно серийный номер карты задается вызывающей стороной. Сервис OSMICards не требует использования какой-либо специфической схемы нумерации и будет работать с любыми номерами карт, если они удовлетворяют правилам формирования номера карты (только латинские буквы и номера от 0 до 9, с общей длиной номера карты не более 20-ти символов).

Имя шаблона карты определяет, что использовать за образец структуры и внешнего вида при создании новой карты. Если в шаблоне, в некоторых полях были заданы так называемые значения по умолчанию, то при создании карты эти данные скопируются в созданную с шаблона карту и далее заживут своей собственной жизнью в карте. Напротив, картинки, названия и количество полей в карте всегда контролируются шаблоном карты и привязаны к нему все время, пока существует карта. То есть, например после создания карты, если в шаблоне карты изменить центральную картинку и название одного поля, то все карты, созданные ранее с этого шаблона, изменят у себя картинку и название данного поля. Это позволяет быстро и легко менять общий дизайн групп карт, не затрагивая индивидуальную информацию в полях карты. Но это требует осторожности при обращении к картам из 1С, поскольку как упоминалось ранее, обращение идет по имени поля, и 1С должна точно знать, как называются поля на карте чтобы выводить туда нужную информацию. 

Если позже в Личном Кабинете сервиса OSMICards, маркетолог/сотрудник изменит название поля в шаблоне карты, то 1С расширение ОСМИ сам по себе об этом не узнает и могут быть проблемы, например с обновлением баланса на карте из 1С. В расширении ОСМИ для 1С есть инструменты, позволяющие уменьшить эффект таких нарушений в синхронизации, но учитывать такую потенциальную проблему необходимо. 

После того как карта с серийным номером была создана в сервисе OSMICards, ее необходимо установить на физический телефон клиента. На телефонах Apple iPhone карта живет в скаченном приложении Wallet на телефон (там же живет Apple Pay). На телефонах системы Андроид карта живет в одном из 4-х возможных приложений, позволяющих работать с электронными картами формата Apple Wallet: WalletUnion, WalletPasses, Pass2U и PassWallet. Все эти приложения доступны из магазина приложений Google Play Store и являются бесплатными. Сервис OSMICards поддерживает все эти приложения и рекомендует WalletUnion.

Если планируется отправлять ссылки на карты клиентам по СМС и/или использовать функцию проверки номера телефона при электронном анкетировании, то у бизнеса должен уже быть в наличии действующий СМС провайдер для отправки СМС, и его параметры необходимо настроить в Личном Кабинете сервиса OSMICards. Сам сервис OSMICards может работать более чем с полусотней СМС провайдеров, но сам СМС провайдером не является.
При получении ссылки на установку карты, клиент должен открыть ее на мобильном телефоне и пройти по ней. Далее процесс зависит от модели телефона (iPhone или Android). 

В случае с iPhone на экране телефона отобразится электронная карта с предложением ее установить (добавить). Если клиент добавит карту, то далее она доступна в приложении Wallet для просмотра и предъявления на кассе.
В случае с Андроид клиенту будет предложено добавить карту либо в одну из четырех установленных программ (см выше), либо автоматически перейти на Google Play, один раз установить приложение и открыть его. Далее карта появится в приложении автоматически. 

 
Обновление содержимого карты произойдет в сервисе OSMICards, в его структурах БД, а далее сервис уже уведомит соответствующие телефоны iPhone или Android, на которых установлена карта, о наличии обновлений для карты. Если карта на телефоне была ранее зарегистрирована на получение автоматических обновлений (все карты по установке на телефон автоматически регистрируются для получения таких обновлений), клиент не отключил позже эту возможность вручную, на телефоне есть Интернет-соединение и при обновлении карты была установлена опция отправки уведомления на телефоны об изменении карты, то телефон обратится к сервису OSMICards за новым содержимым карты. Если карта установлена более чем на одном телефоне, то каждый телефон получит уведомление и обратится к сервису OSMICards за обновлением. 

Но даже если карта в телефоне не зарегистрирована на получение автоматических обновлений, клиент всегда может вручную попробовать обновить карту, протянув ее пальцем вниз на оборотной стороне. Обновленная информация всегда закачивается телефоном с сервиса OSMI целиком, как единый архив данных (формат файла pkpass с электронной подписью) и далее разбирается программой wallet на наличие изменений. Электронная подпись выдается в действующей учетной записи Разработчика Apple бизнеса или индивидуального человека, связанного с бизнесом. Электронная подпись действует 1 (один) год с момента создания и потом ее надо продлевать. Если электронная подпись просрочена, то новая карта не установится на iPhone, ранее установленная карта не сможет обновляться, и не будут формироваться пуши об изменениях данных на экране телефона.

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

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

В рамках сервиса OSMICards важно понимать текущие статусы электронных карт. Статусы карт доступны сервису, и они меняются в сервисе автоматически, в реальном времени. Доступные статусы карт с пояснениями указаны в табличке:

Стандартная работа с картами подразумевает создание карты (статус 1) и установка ее на телефон (переход в статус 2). За время жизни карты возможен неоднократный переход карты из статуса 2 в 3 и из статуса 3 в 2, но переход в статус 1 после его смены невозможен. Перевести карту из статуса 7 в статусы 1 или 2 можно только по запросу в компанию ОСМИ. В терминах сервиса OSMICards карта в статусе 2 называется Активной. 

При соответствующей настройке сервиса и 1С и при возникновении таковой необходимости, появляется возможность получать уведомления об изменении статусов карт в реальном времени прямо в 1С. 

Следует учитывать, что в случае с телефонами на базе Андроид, статус карты в сервисе может искусственно «зависнуть» в статусе 2 даже при отсутствии карты в телефоне. Это происходит в случае, когда клиент удалил само приложение Wallet с телефона со всеми находящимися в нем активными картами. 

Сервис OSMICards представляет собой комплекс решений, предназначенный для создания, управления, распространения и обновления электронных карт стандарта Apple Wallet. Сервис состоит из кластера серверов баз данных и серверов приложений, расположенных в ведущих дата центрах. Сервис берет на себя поддержку необходимых стандартов электронных карт и механизмов доставки пуш сообщений для платформ Apple и Google. С точки зрения бизнеса, использующего сервис, работа с сервисом ведется через стандартные API с использованием номера карты как уникального идентификатора. Все обновления данных карт, создание карт, отправка карт конечным клиентам, сбор статистики – происходят только при использовании номера карты.

Сервис OSMICards не является СРМ системой, и, соответственно, не рассчитывает бонусные баллы и скидки, не хранит номера телефонов и email пользователей карт, историю покупок пользователя и не может ответить на вопрос типа «Сколько бонусных баллов клиент Петр Иванов накопил и потратил за последний месяц». С точки зрения таких бизнес систем как 1С, сервис OSMICards является транспортом и каналом коммуникации с клиентом. В сервисе OSMICards хранится ровно та информация о клиенте, которую бизнес желает вывести на электронную карту. Но даже если с точки зрения бизнеса на карту выводится текущий уровень бонуса из бонусной программы, с точки зрения сервиса OSMICards это не более чем строка цифр, записанная в соответствующую клеточку (поле) карты. Для сервиса эта клеточка не несет смыслового значения «текущий бонус клиента из программы лояльности» а просто строковое поле с полем «Баланс», которое бизнес через API или модуль ОСМИ для 1С обновляет с нужными ему значениями. 

Это следует учитывать при определении задач по настройке программ лояльности для бизнеса в 1С и их последующем решении. Сервис OSMICards интегрируется с уже настроенной и работающей программой лояльности в 1С. Сервис может дополнить существующую программу лояльности некоторыми возможностями, такими как привлечение новых клиентов через автоматически выдаваемые электронные карты и онлайн анкетирование, выдача электронных карт существующим клиентам, отправка транзакционных и маркетинговых пуш сообщений клиентам (см далее в документе), но сервис OSMICards и модуль ОСМИ для 1С не может заменить собой отсутствующую или не до конца настроенную программу лояльности. 

Доступ к сервису OSMICards осуществляется через модуль ОСМИ для 1С и через Личный Кабинет OSMICards.

Доступ к Личному Кабинету осуществляется через Браузер и предназначен для управления некоторыми аспектами сервиса, создание и редактирование шаблонов карт, просмотра некоторой статистики сервиса, оправки маркетинговых пушей и динамических акций и др. Для доступа к Личному Кабинету требуется логин и пароль, выдаваемые компанией ОСМИ. После успешной настройки интеграции с 1С, использование Личного Кабинета существенно сокращается и сводится в основном к подстройке дизайнов карт и работе с маркетинговыми пуш уведомлениями. 

Основной доступ к сервису OSMICards осуществляется через стандартные REST API, используя HTTPS транспорт. Сервис OSMICards предоставляет богатый набор функций API, покрывающий все аспекты работы сервиса и управления электронными картами. Модуль ОСМИ для 1С использует тот же самый REST API для доступа к сервису. Для общения с сервисом OSMICards через API можно использовать либо APIID и APIKEY, либо клиентский сертификат. Оба метода доступа выдаются компанией ОСМИ. 

При установке 1С на платформе Windows, доступ к сервису из 1С осуществляется через компонент ОС WinHTTP. При работе на некоторых устаревших серверных платформах необходимо осуществить дополнительные настройки платформы Windows как описано здесь.

Вся коммуникация с сервисом OSMICards из 1С осуществляется через функции модуля ОСМИ для 1С. “Общие Модули -> ОСМИ_РаботаСAPI” оборачивает некоторые используемые REST вызовы сервиса в 1C процедуры. Все REST команды к сервису в случае успеха возвращают HTTP статусы 200 или 204, и 400 и 404 в случае ошибки. Во всех неуспешных вызовах помимо HTTP статуса возвращается тело ответа в формате json, в котором дается код ошибки и описание ошибки. Модуль ОСМИ для 1С записывает всю успешную и неуспешную коммуникацию между 1С и сервисом в журнал, где ее можно просмотреть (Отчет "Данные с карты").

Как уже ранее упоминалось, в сервисе OSMICards доступны текущие статусы карт. Но также доступны и другие события, происходящие в сервисе. На эти события можно настроить отправку уведомлений. Некоторые наиболее общие уведомления приведены в табличке ниже.

Чтобы уведомление сработало, необходимо на стороне сервиса OSMICards выбрать требуемое событие, и указать адрес URL, куда отправить HTTP запрос о наступлении события. Запрос может быть настроен как HTTP GET, HTTP POST или SOAP, с паролем или без пароля. В запросе передается тип наступившего события и номер карты, для которой это событие наступило. 

Для того, чтобы принять на стороне бизнес-системы такое настроенное в сервисе OSMICards уведомление, необходимо на стороне бизнес-системы настроить слушающий веб сервис с публичным IP адресом и поддержкой выбранного метода GET, POST или SOAP. 

Следует учесть, что можно работать с электронными картами и без настройки уведомлений. Это просто дополнительная возможность сделать обмен между сервисом OSMICards и 1С более эффективным.

Как уже говорилось ранее, для создания карт необходимо указывать требуемый номер карты и шаблон, на базе которого будет создана карта. Это правило всегда остается неизменным. Но сервис OSMICards позволяет автоматизировать процесс создания карт и сделать этот процесс более доступным и удобным для конечного пользователя и в то же время более полезным для бизнеса, выпускающего электронные карты.

Суть подхода в том, что клиенту предлагается отсканировать QR на кассе или пройти по ссылке в социальных сетях на онлайн анкетирование. После заполнения анкеты карта и данные анкеты попадут в бизнес-систему, например в 1С. Система автоматически создает новую карту с номером, определяемым заранее заданными параметрами и на шаблоне, заранее заданным для этого процесса. 

Далее на карте могут быть отображены рабочий баркод, имя и фамилия клиента, размер скидки или уровень бонусов и тд. 

Параметры создания новых карт с таких универсальных QR кодов или ссылок задаются в сервисе ОСМИ в рамках "Регистрационных Кампаний". В параметрах задаются принципы генерации номеров для новых карт и какой шаблон использовать. 

Нумерация для таких автоматически создаваемых карт может задаваться по выбору одним из двух принципов:

• Автоматическая нумерация с увеличением номера карты на 1

• Выбор следующего свободного номера из заранее заданного списка. 

В случае с автоматической нумерацией, в сервисе OSMICards задаются такие параметры как префикс номера карты, количество цифр в номере после префикса и максимальное количество карт. Например, задав префикс карты как 99, 5 цифр после префикса и максимальное количество карт как 9999, номера карт будут создаваться в последовательности 9900001, 9900002, 9900003 и так далее, до номера 9909999 включительно. 

Такой подход открывает отличные возможности для использования разных префиксов карт для разных каналов распространения карт и последующего анализа эффективности данного канала. Например, для карт, устанавливаемых через QR на кассе, можно выделить префикс 90, для карт с Facebook префикс 91, для другого магазина в сети 92 и так далее. Для каждого префикса будет вестись своя нумерация карт и свой счетчик. Карты могут быть настроены создаваться с одного шаблона, но можно задать и разные дизайны (шаблоны), например свой шаблон для каждого из префиксов номеров. 

Подход с автоматической нумерацией карт является наиболее удобным и простым в использовании. Но иногда бизнесу требуется более сложная нумерация карт, где простое увеличение номера карты на 1 работать без дополнительных ухищрений не будет. Например, если требуется, чтобы собственно номера соответствовали стандарту EAN-13 или уже имеется ранее созданный набор номеров, который нужно использовать. В таком случае Маркетинговая кампания создается в режиме работы со списком, а не в автоматическом режиме, и в сервис загружается список номеров карт. Но конечный эффект такой-же, как и при автоматической нумерации карт: в смартфоне клиента оказывается электронная карта с уникальным номером. 

Отличным дополнение для процесса автоматического создания электронных карт, описанным в предыдущем разделе, является онлайн анкетирование. При сканировании QR на анкету пользователю нужно принять согласие с офертой и заполнить поля, настроенными для конкретного бизнеса. Только после успешного заполнения всех требуемых полей анкеты, проверкой номера телефона, указанного в анкете, данные анкеты могут быть временно сохранены в сервисе ОСМИ для дальнейшего скачивания расширением ОСМИ для 1С и обработкой на стороне 1С.

Типичный процесс прохождения анкетирования представлен на рисунке 3. 

Ранее уже говорилось о том, что сервис OSMICards не является CRM системой. То есть анкетные данные клиента сервису не нужны. Сервис сохраняет их сугубо временно, до тех пор, пока 1С не заберет их и не обработает. После успешной обработки данных в 1С, обработчик 1С является ответственным за удаление анкетных данных из сервиса OSMICards. Если обработчик не удалит данные с сервиса, они будут накапливаться с каждой последующей регистрацией и обработчику 1С придется обрабатывать повторные данные.

Регистрационная группа имеет имя и поля для данных, в которые заполняются данные анкеты. Например, набор полей регистрационной группы и соответствующие данные для показанной выше анкеты регистрации, будут выглядеть следующим образом (поля анкеты, где информация не была введена, будут содержать строку «-empty-»: 

• Имя: Петр

• Фамилия: Иванов

• Дата_рождения: 11.11.1985

• Почта: aaa@bb.com

• Город: Москва

• Телефон: 8(916)666-7788

• Телефон_проверен: да

• Оферта_принята: да

• Предложения: да

• Мероприятия: да

• DTS: 2022-01-27 20:48:15

• serialNo: 101259

По получении этих данных, обработчик 1С должен решить, нужно ли создавать нового человека в 1С с новой картой лояльности, или данный человек уже известен системе и стоит только обновить его данные в 1С и привязать новую карту лояльности и тд. Сервис OSMICards в принятии такого решения не участвует. Расширение ОСМИ для 1С дает некоторые рекомендации для обработки входных данных анкеты. Но у каждого бизнеса свои требования и конкретный обработчик анкетных данных должен быть создан и настроен сообразно требованиям бизнеса специалистом 1С бизнеса. 

Расширение - это дополнение для работы с сервисом ОСМИ, которое позволяет держать изменения конфигурации отдельно от самой конфигурации. Расширение ОСМИ позволяет дорабатывать расширяемую конфигурацию без изменения этой конфигурации (в том числе без снятия с поддержки). Расширение ОСМИ подходит для работы с платформой версией не ниже 8.3.18. и работает с конфигурациями Розница от 2.2, УНФ от 1.6 и 3, УТ от 11, также подходит для работы с облачными решениями, такими как 1С Fresh. Расширяемая конфигурация в любой момент может быть изменена, например, в результате обновления, избегая ручной работы по объединению конфигураций.

Для установки и настройки расширения ОСМИ требуется: 

1.  Скачать дистрибутив с расширением и модулями, предоставляемый компанией ОСМИ.
2.  Получить  API ключи доступа, предоставляемые компанией ОСМИ. 

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

1. Приемник – термин, который описывает код, предназначенный для работы с различными внешними данными. В нашем случае прием данных с регистрационной анкеты, создаваемой компанией ОСМИ, при прохождении которой клиент получает электронную карту, или силами разработчиков со стороны заказчика. 

2. Источник – термин, описывающий внешние обработки, служащие для извлечения данных из 1С для последующего отображения на полях электронных карт ОСМИ (данные физ. лиц, данные штрихкода, скидки, бонусы и т.д.). 

3. Событие – термин, обозначающий, какое либо событие в 1С. Такими событиями могут быть закрытие смены, пробитие чека ККМ, изменения справочника физ лица, начисление/списание бонусов и др. 

4. Регламентные задания - механизм, который и позволяет автоматически выполнять процедуры на встроенном языке по расписанию. Например, ежедневно каждые 2 минуты загружать новые регистрационные данные с сервера ОСМИ, обрабатывать маркетинговые акции ежедневно каждые 60 минут, ежедневно каждые 30 секунд проверять обновление карт (начисление/списание бонусов), ежедневно каждые 10 секунд обрабатывать очередь событий. Каждое регламентное задание настраивается индивидуально под задачи заказчика. 

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

Расширение использует роль ОСМИ_Пользователь. Если пользователю с ограниченными правами доступа необходимо работать с расширением - выдавать электронные карты, управлять его параметрами и настройками, то такого пользователя нужно добавить к группе доступа на основе этой роли. Для этого нужно создать новую группу доступа и новый профиль. При создании профиля указать ему роли ОСМИ_Пользователь, Основная роль ОСМИ и ОСМИР_ОсновнаяРоль. После этого нужно добавить в эту группу всех нужных пользователей.

Если в 1С используется гранулированный контроль прав доступа пользователей к запрошенным ресурсам, с использование групп доступа и разделения по записям, то нужно настроить права в 1С таким образом, чтобы у пользователей ранее созданной группы доступа были права на доступы к необходимым ресурсам как расширения ОСМИ, так и требуемым типовым ресурсам 1С. 

После установки основного расширения необходимо в мастере настройки расширения загрузить доп.модули для вашей конфигурации 1С. В разделе "Настройка соединения с сервисом ОСМИ" необходимо нажать кнопку установить модули в открывшемся окне выберите папку соответствующую вашей 1С.

После установки модуля в 1С необходимо заполнить настройки соединения с сервисом ОСМИ в мастере настройки. Это делается с помощью API ключей или с помощью клиентского сертификата для 1С, которые выдаются компанией ОСМИ. Пример заполнения метода соединения с помощью API ключа представлен на рисунке 13.

Далее необходимо установить регламентное задание, для этого перейдите в настройки - "Печатные формы" - "Дополнительные отчеты и обработки" в открывшемся окне нажмите кнопку "Добавить из файла" и выберите файл ОСМИ_ОсновноеРегЗадание.epf. После загрузки регламентного задания настройте расписание исполнения для всех 5 команд. У команды "Очистка событий" можно установить расписание раз в день, а у остальных рекомендуется установить каждый день, каждые 60 сек. Также для каждой команды необходимо выбрать пользователя с достаточными правами для запуска обработки и доступа к нужным справочникам и регистрам.

Данная вкладка находится в "Мастере настроек" и предназначена для настройки отображения данных из 1С на электронных картах.

Перед началом настройки необходимо загрузить список шаблонов карт с сервера ОСМИ. Для этого необходимо нажать на кнопку "Загрузить шаблоны с сервера" (Рис.14). 

Внимание: если во время работы будет изменено поле в шаблоне карты через личный кабинет ОСМИ, например маркетологом, то произойдет ошибка конфигурации и перестанет работать любое обновление всех полей по всем существующим электронным картам. Изменением поля также считается замена верхнего регистра на нижний и наоборот.

Внешний вид электронной карты (шаблон) можно динамически изменять в зависимости от вида дисконтной карты 1С. Если задано соответствие шаблона электронной карты виду дисконтной карты, то, при измении вида дисконтной карты клиента в 1С, его электронная карта в телефоне автоматически изменит внешний вид, перейдя на другой шаблон.

Если в 1С настроен всего один вид дисконтной карты для всех клиентов и смена условий программы лояльности происходит по накопленной сумме продаж, то в таком случае можно настроить смену визуального вида электронной карты (шаблона электронной карты) в зависимости от этой суммы для этого перейдите в расширение OSMICARDS -> "Маркетинг" -> "шаблоны по накопленным продажам" (Рис. 23)

Шаблоны электронных карт в таком случае привязываются к диапазонам сумм накопленных продаж. Нужно задать дипазон значений в парамерах Сумма с и Сумма по и выбрать желаемый шаблон электронной карты. Можно задать несколько диапазонов, каждый со своим шаблоном. Диапазоны не должны перекрываться.

Например, если первый диапазон установлен от 0 до 10000 и второй диапазон установлен от 10000 и без верхней границы, то смена шаблонов карты произойдет, когда сумма продаж станет больше или равна 10000 руб. Если же сумма продаж меньше или равна 9999.99, то будет использоваться первый шаблон.

Анкеты используются для автоматической регистрации клиентов по заполненным анкетным данным. В мастере настройки во вкладке “Анкеты” в настраивается загрузка анкетных данных в 1C.

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

Имя регистрационной группы - заполняется автоматически при загрузке с сервера.

Грузить только найденные - обрабатывать только те анкеты, для которых найдена существующая информационная карта в 1С. В основном используется в схеме с РИБ.

Выбор обработчиков, порядок их исполнения и для каких клиентов использовать (новых или существующих) те или иные подключенные обработчики, зависит от конфигурации 1С. Настройки для 1С с РИБ будут отличаться от настроек для 1С без РИБ.

Идеология и особенности настроек анкеты 1С с РИБ и без РИБ описаны в конце параграфа.

Кнопка "Обновить" загружает список анкет с сервера (не анкетных данных) созданных компанией ОСМИ. В данном примере используется одна анкета. В случае, если используется несколько анкет, то названия этих анкет будут отображаться списком в этом поле (Рис.24).

A.Схема нумерации карт из Сервиса. 

Здесь выбирается регистрационная кампания, которая будет использоваться для генерации серийных номеров электронных карт, когда электронная карта выдается вручную из 1С. Если используется процесс электронного анкетирования, то регистрационная кампания в большинстве случаев будет иметь название «registration». (Рис.30). Также здесь надо указать вид карты.

Данная функция позволяет перед списанием бонусных баллов с электронной карты клиента отправить на его номер телефона код подтверждения по смс. Когда клиент сообщает проверочный код из смс кассиру на списание бонусных баллов, кассир вводит проверочный код в кассовое оборудование и после этого появляется возможность произвести списание бонусных баллов. Этот способ помогает предотвратить возможные махинации со списанием бонусных баллов с чужой электронной карты. (Видео 1).

В настройке без РИБ в 1С уже имеются существующие клиенты с картами. Новые клиенты в 1С основном добавляются через прохождение электронной анкеты, но могут добавляться и вручную штатными средствами 1С. Существующих клиентов тоже рекомендуется пропускать через заполнение электронной анкеты с целью обновления данных в карточке клиента заполенными анкетными данными.

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

Не следование этим правилам может привести к созданию в 1С дубликатов карт и/или владельцев при обработке анкет!

При обработке анкеты принятие решения о том, является ли клиент существующим или новым, принимается по результатам пойска клиента по номеру телефона в 1С.

В данном сценарии обычно настраиваются следующие обработчики (на примере Розница 2.3): 

• Идентификаторы
• Поиск по телефону
• Предобработка
• Создать физ лицо - для новых
• Создать инфокарту - для новых
• Сохранение данных
• Все необходимые обработчики полей анкеты
• Постобработка
• Создать ШК - для новых
• Установить Имя ШК или Установить ФИО - для новых (можно и для существующих)

После завершения обработки анкеты, в случае с новым клиентом создается новое физ лицо и новая инфокарта, и электронная карта, установленная у клиента в телефоне, привязывается к инфокарте 1С. Баркод электронной карты в телефоне обновляется со значением штрихкода инфокарты клиента 1С.

Если в 1С включен механизм автоматического создания инфокарты при предъявлении пластиковой карты на кассе, то тогда настройку обработчиков анкетирования следует делать согласно схеме с РИБ (смотри ниже). 

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

Для того чтобы клиент смог воспользоваться электронной картой сразу после анкетирования, настройки 1С и анкетирования следует задать следующим образом:

• Электронное анкетирование на сервере выдачи электронных карт настраивается на запись в баркод электронной карты нормализованного номера телефона клиента, в виде 7ххххххх.
• 1С конфигурируется в режиме создания новой инфокарты при предъявлении/сканировании карты с неизвестным баркодом на кассе.
• Не создавать заранее инфокарты на сервере 1С.
• Обработчики анкеты настраиваются по схеме:
• Грузить только найденные
• Идентификаторы
• Поиск по телефонуШК
• Поиск по телефону
• Предобработка
• Создать физ лицо - для существующих
• Сохранение данных
• Все необходимые обработчики полей анкеты
• Постобработка
• Не заполнять или Установить Имя ШК или Установить ФИО - для существующих

При таких настройках клиент сразу сможет воспользоваться электронной картой на кассе после прохождения анкетирования. Обработка анкетных данных будет автоматически отложена до завершения обмена в РИБ (Грузить только найденные). Поскольку карта с таким штрихкодом уже гарантированно будет существовать в 1С в момент вызова обработчиков, то все обработчики анкеты выполнятся в заданном порядке. Если у карты уже прикреплен владелец (существующий клиент), то данные владельца обновятся с данными анкеты. Если не прикреплен, то создастся новый владелец из данных анкеты и прикрепится к карте. 

В данном разделе вы можете просмотреть какие были события на сервере ОСМИ с выбранной электронной картой, т.е здесь вы не увидите действия из 1С, связанные с программой лояльности, для этого надо выбрать карту из выпадающего списка либо нажать кнопку "Показать все" (Рис. 32)

В данном разделе вы можете просмотреть какие анкеты были загружены, а также из какой регистрационной группы (Рис. 35)

Для просмотра детальной информации по анкете необходимо кликнуть два раза по номеру группы. В этом модальном окне вы можете просмотреть какие значения загрузились из анкеты, дату загрузки.

Данный отчет показывает, для каких существующих в системе дисконтных карт 1С были выданы электронные карты, и их статусы (Рис. 36)

Значения колонок отчета:

Дисконтная карта

Дисконтная карта клиента 1С. У дисконтной карты 1С может еще не быть соотвествующей электронной карты.

Электронная карта

Серийный номер электронной карты. По этому номеру можно найти карту в Личном Кабинете сервиса.

Создана

Дата и время создания электронной карты в сервисе. Карта могла быть создана как вручную в 1С, так и при заполнении электронной анкеты. По двойному нажатию на карту можно перейти в отчет по статусу электронной карты и посмотреть как она выглядит в телефоне у клиента.

Активных устройств

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

Обновлена на устройстве

Дата и время, когда телефон последний раз загрузил актуальное значение карты из сервиса. Фактически это означает, что до карта отобразила все изменения, включая показы пушей. Это не означает что владелец карты открыл приложение и просмотрел карту. Такая информация в сервисе не доступна. Если карта установлена более чем на одном устройстве, дата и время относятся к самой новой загрузке одного из устройств.

Зарегистрирована для автообновлений

Дата и время самой последней регистрации карты для автообновлений на устройстве или на одном из устройств (если карта стоит на нескольких устройствах).

Обновлена в сервисе

Дата и время обновления карты в сервисе. Следует учитывать, что карта может получить обновления как из 1С, так и из Личного Кабинета сервиса. 

Данная команда актуализирует все электронные карты с информацией из 1С. Эту команду рекомендуется использовать при обновлении глобальных настроек параметров лояльности модуля сервиса, например при изменении диапазонов накопленных продаж, управляющих шаблонами электронных карт, или при обновлении версий внешних обработчиков источников данных. Карты ставятся в очередь на обновление и очередь обрабатывается регламентным заданием сервиса. 

Для удобной работы с маркетинговыми акциями (рассылкой уведомлений)  используется обработка “Планирование маркетинговых акций” (Рис. 37)

В календаре цветами выделены даты с маркетинговыми акциями (каждая акция своим цветом).

В таблице под календарем отображаются список будущих маркетинговых акций (динамических рассылок, пуш сообщений).

Источники

Внешние обработчики, которые «достают» из 1С требуемые данные для заданной инфокарты, для последующего отображения в поле электронной карты. В поставке имеются стандартные обработчики для получения текущего размера скидки, размера бонусов, штрихкода инфокарты, ФИО клиента и тд.

Текущий уровень скидки клиента и уровнь начисления бонусов вычисляется обработчиком (Маркетинг.epf) через создание искусственной транзакции с заданной номенклатурой и номером инфокарты.

Внешние обработчики, которые отвечают за создание физлица и/или контрагента, создание инфокарты, создание штрихкода и тд.

Внешние обработчики, которые отвечают за разбор пришедших данных электронной анкеты клиента и формирование необходимых структур данных для заполнения данных в справочниках физических лиц/контрагентов. Стандартно обрабатываются ФИО, почта, телефон, дата рождения, пол. Для любых других данных анкеты необходимо создать дополнительные внешние обработчики.

Внешние обработчики, которые отвечают за детектирование событий в 1С, могущих повлиять на отображение информации на электронной карте. Например, если на карту выводится имя владельца карты, то обработчик ФизЛицо.epf отрабатывает изменение в справочнике Физических Лиц, и ставит карту в очередь на обновление информации. Аналогично, пробитие чека с предъявленной картой лояльности на кассе, детектируется обработчиком ПробитиеЧекаККМ.epf, и так далее. Список событий, на которые система настроена реагировать, находятся в меню Установленные Модули ОСМИ.

ОСМИ_ОсновноеРегЗадание.epf устанавливается через Дополнительные отчеты и обработки и отвечает за исполнение основных процессов модуля ОСМИ, таких как регулярный импорт и обработку электронных анкет, отработка очереди настроенных событий 1С, отработка очереди обновлений электронных карт, отработка календаря отправки пуш уведомлений, очистка логов.

Для каждого процесса настраивается свое расписание. Типичная настройка – исполнять каждый день, каждые 60 секунд для всех процессов, кроме очистки логов. Очистку логов можно настроить на 1 раз каждую неделю.

Здесь находятся примеры вспомогательных обработчиков, утилит и регламентных заданий, которые можно использовать для выполнения специфических задач или использовать как основу для разработки своих регламентных заданий/обработчиков. 

В модуле объектов внешних обработок всех модулей должна присутствовать экспортная процедура “ОписаниеМодуля” которая возвращает структуру с описанием модуля. В указанной структуре обязательно должны быть определены:

• Назначение - целевая конфигурация модуля. Модуль можно установить только в целевую конфигурацию. Например, можно задать: «розница3 | управлениенебольшойфирмой3 | управлениенебольшойфирмой1»
• Имя - имя модуля, которая будет отображаться пользователю. Пояснение - краткое описание модуля (может быть пустым).
• Версия - версия модуля. Допускаются только точки и цифры. При доработках модулей нужно всегда увеличивать версию, например с «0.4» до «0.5».
• Тип - тип модуля. 

В данном модуле должна быть определена функция “НайтиДанные”, принимающая один параметр - данные анкеты - структура с анкетными данными.

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

Помимо основных данных “ОписаниеМодуля” должно возвращать информацию, описывающую доступные поля текущего модуля.

К приведенному выше коду добавится вот такой кусок: 

“ОписаниеМодуля” в описании должно возвращать имя метаданного, которое является источником описываемого события.

В данном модуле должна быть описана процедура “Сохранить” принимающая три параметра:

Значение - Сохраняемое значение.

ОбъектКарты - объект карты, для которой идет сохранение данных. Ссылка на данную карту уже записана. 

ОбъектФизлица - аналогично объекту карты.

Важно понимать, что значения типа “Дата” передаются как строка 

В момент возникновения события записи документа или справочника проверяется, есть ли установленный в систему модуль, настроенный на это событие. Если да, то оно ставиться в очередь на обработку (создается документ типа “осми_Событие”- не проведенный). Далее регламентное задание обрабатывает данные события (успешно отработанные записываются с проведением).

Во время отработки события могут быть поставлены в очередь на обновление карты: 

Когда к 1С подключен сервис электронных карт и клиентам выдаются электронные карты через анкетирование или в ручном режиме, привязка номеров выданных клиентам электронных карт к дисконтным картам 1С хранится в установленном расширении. Если по каким-то причинам расширение было удалено, то вместе с ним удаляется и привязка электронных карт к дисконтным картам 1С. Сами ранее выданные электронные карты из сервиса не удаляются, только 1С о них ничего больше не знает и, соответственно, не может их обновлять.

Если по каким-то причинам расширение по работе с сервисом электронных карт было удалено из 1С и потом заново установлено, то можно заново привязать ранее выданные электронные карты из сервиса к дисконтным картам 1С. Поиск соответствия и привязка осуществляются по штрихкодам дисконтных карт 1С и штрихкодам электронных карт.

Чтобы заново привязать карты, необходимо построить новую таблицу соответствия карт по кнопке Загрузить с сервера. После этого можно создать на основе созданных данных новое соответствие электронных карт дисконтным картам 1С, нажав кнопку Сохранить связь.

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

Используйте данную возможность только при удалении и новой установке расширения сервиса! При стандартном обновлении расширения сервиса на новую версию, связи между картами не нарушаются и данная операция не требуется! 

Для того, чтобы отправить электронную карту уже существующему в 1С клиенту, необходимо найти карту данного клиента в 1С. В зависимости от конфигурации 1С (Розницы/УТ/УНФ) необходимые опции поиска клиента могут различаться. Далее рассмотрим пример на базе 1С УНФ 3.0:

• Перейдите в "Продажи" - "Дисконтные карты". Здесь вы можете увидеть список дисконтных карт. На нужной карте сделайте двойной клик мыши. 
• В модальном окне нажмите кнопку "Электронные карты" выберите "Создать карту"
• Убедитесь что пришло сообщение о создании карты (или карта уже создана)
• Отправьте карту клиенту по смс или по электронной почте. Контактные данные берутся из справочника физ.лиц/партнеров/контрагентов.

Внимание: Создание карты будет происходить по правилам, настроенным в "Мастере настроек расширения OSMI" - "Прочее" из Схем нумерации карт.

Для того, чтобы получить значения скидки/бонусов/накопленных продаж и т.д, расширение эмулирует продажу или реализацию по выбранной номенклатуре для указанной дисконтной карты 1С. После окончания расчета продажа отменяется до ее завершения и фиксации, поэтому никакие данные в 1С не изменяются.

Для для правильного расчета и отображения значений необходимо выбирать номенклатуру, цена на которую не меняется для разных уровней лояльности и к которой не применяются различные "сезонные/разовые/и т.д" скидки. Задать требуемую номенклатуру и проверить расчет для дисконтной карты можно в форме Мастер Настроек - Устанавливаемые модули, выбрав модуль Маркетинг и нажав кнопку Настройки.