Интеграция. 1С: Розница

Прямая интеграция с 1С: Розница при помощи модуля PRIME HILL для 1C: Розница

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

Модуль PH для 1С: Розница — Россия

Скачать

Модуль PH для 1С: Розница — Казахстан

Скачать

Обработки для модуля PH для 1С: Розница

Скачать

# Общее

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

Возможные варианты акций:

  • Дисконтная (скидки)
  • Дисконтная накопительная (скидка 5% — от 0 рублей, скидка 10% — от 100 рублей)
  • Бонусная
  • Бонусная накопительная (кэшбэк 5% — от 0 рублей, кэшбэк 10% — от 100 рублей)
  • Ранговые программы (временное применение повышенного уровня, который необходимо поддерживать, соблюдая условия программы лояльности)
  • Депозитные системы
  • Сертификаты
  • Акции «1+1»
  • Акции «товар в подарок»
Любые акции могут иметь ограничения в применении на определенные категории/товары.

В рамках интеграции доступны все возможные комбинации взаимодействия с клиентом при построении сценариев программы лояльности PRIME HILL.

Электронные карты PRIME HILL позволяют создавать защищенные баркоды карт, при чекине гостя через 2D сканер или через код с клавиатуры. Под защищенными баркодами подразумевается зашифрованный в баркод или выведенный в карту токен карты, который обновляется с заданной периодичностью и/или после каждой транзакции.

# Требования

  • Платформа 1С версии 8.3.15 и новее;
  • Конфигурация 1С: Розница версии 2.3.2.28 и новее;
  • Лицензия модуль PH для 1С: Розница — приобретается в PRIME HILL;
  • Исходящий доступ в Интернет без прокси на внешние адреса к портам 80 и 443 (http и https);
  • Оборудование для приема карт – 2D сканер (не обязательны, но желательны для удобства).

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

Интеграционный модуль PH для 1С:Розница состоит из нескольких компонентов:

  • Расширение для конфигурации

и обработок, которые работают в режиме регламентных заданий для взаимодействия с сервером PRIME HILL

  • Выгрузка новых клиентов в PH — Отправляет в PH новых клиентов при заведении их в 1С.
  • Загрузка видов карт лояльности — Загружает с сервера PH виды (макеты) карт для проведения сопоставления.
  • Обмен данными PH — Необходим при наличии РИБ. Проводит синхронизацию карт между базами, для быстрой доставки информации о транзакциях по картам в PH.
  • Загрузка клиентов из PH — Обновляет данные в 1С по клиентам и загружает новых клиентов из PH
  • Обновление внешних инструментов интеграции — Загружает с сервера PH новые версии обработок если такие есть.
  • Очистка журнала взаимодействий с PH — очищает журнал взаимодействия, чтобы не занимал место.
  • Синхронизация транзакций с PH — отправляет в PH транзакции по клиенткам и получает из PH транзакции проведенные в других системах учета или в самом PH (например начисление/списание бонусов)

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

  • Откройте 1С в режиме тонкого клиента под пользователем с правами администратора
  • Откройте Сервис и настройкиНастройкиПараметры → Установите галочку в поле Отображать команду «Все функции» → Нажмите Ок
  • Откройте Сервис и настройки → Откройте раздел Все функции → СтандартныеУправление расширениями конфигурации
  • В открывшемся окне нажмите кнопку Добавить → Выберите файл Модуль интеграции PH.cfe
  • Для расширения
    • Установите статус — активно
    • Безопасный режим — выключен
    • Защита от опасных действий — выключена
    • Установите галочку «Используется в РИБ» если расширение используется в РИБ
    • Установите галочку в поле «Использовать основные роли»

# Установка обработок

  • Откройте вкладку АдминистрированиеПечатные формы, отчеты и обработки → Установите галочку в поле Дополнительные отчеты и обработки
  • Откройте вкладку Администрирование → Нажмите Настройки Настройки навигации Важное Переместите пункт Дополнительные отчеты и обработки из доступных команд в выбранные команды → Нажмите Ок
  • АдминистрированиеДополнительные отчеты и обработки → Нажмите Добавить из файла → добавьте обработки:
    • Выгрузка новых клиентов в PH
    • Загрузка видов карт лояльности
    • Обмен данными PH — только если используется РИБ
    • Загрузка клиентов из PH
    • Обновление внешних инструментов интеграции
    • Очистка журнала взаимодействий с PH
    • Синхронизация транзакций с PH

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

# Настройка прав пользователей

  • Откройте АдминистрированиеНастройки пользователей и правПрофили групп доступаСоздать → Создаем два новых профиля
    • Для настройки PRIME HILL создаем профиль Администратор PH, установив ему роль Администрирование Prime Hill
    • Для использования PRIME HILL создаем профиль Пользователь PH, установив ему роль Базовые права Prime Hill
  • Откройте АдминистрированиеНастройки пользователей и правГруппы доступаСоздать → Создаем две новые группы
    • Для настройки PRIME HILL создаем группу Администратор PH, установив ему профиль Администратора PH, в которую добавляем всех сотрудников, которые смогут администрировать PH
    • Для использования PRIME HILL создаем группу Пользователь PH, установив ему профиль Пользователь PH, в которую добавляем всех сотрудников, которые смогут использовать PH
  • Перезапустите 1С
  • Проверьте, что в меню появился раздел PRIME HILL, если раздел не появился выполните действия из FAQ

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

  • Откройте раздел PRIME HILLНастройка соединения
  • Укажите адрес сервера и API Token`ы
    • В поле токена указывает токен группы магазинов. По этому токену будут отправляться аккумулированные транзакции из 1с
    • В списке магазинов указываются токены для каждого магазина
  • Нажмите Проверить статусы токенов

# Настройка сопоставлений видов карт PH и 1С

  • Откройте АдминистрированиеПечатные формы, отчеты и обработкиДополнительные отчеты и обработки → Откройте обработку Загрузка видов карт лояльности
  • Нажмите Выполнить, чтобы макеты загрузились из PRIME HILL прямо сейчас.
  • Откройте PRIME HILLСоответствие видов карт лояльности.
  • В открывшемся списке заполните сопоставления по каждому макету PRIME HILL
    • Вид дисконтной карты — это вид дисконтной карты, который будет присваиваться новой карте созданной из PH. По этому виду дисконтной карты должна быть настроена скидка в 1С.
    • Бонусная программа лояльности — это бонусная программа, которая будет присваиваться новой карте созданной из PH. По этой программе будет выводится бонусы в PH и в случае начисления бонусов со стороны PH они будут начислены на эту программу.
    • Группа карт — группа дисконтных карт, можно указать для удобства сортировки карты. Все карты сопоставленные с PH будут добавлены в выбранную группу.
    • Группа физ. лиц — группа физ, можно указать для удобства сортировки физ. лиц. Все клиенты сопоставленные с PH будут добавлены в выбранную группу.

# Создание видов карт в 1С

  • Откройте Маркетинг → Виды дисконтных карт → Создать → Укажите наименование вида дисконтных карт→ Сохранить

# Настройка скидки

  • Откройте Администрирование → Маркетинг → Скидки, наценки, ограничения → Установите галочку Скидки, наценки и ограничения продаж
  • Откройте МаркетингСкидка (Наценки, ограничения) → Нажмите Создать
    • Укажите Тип скидки: Процент → Укажите Размер скидки: нужный вам процент скидки → Укажите Область предоставления: В документе → При необходимости укажите сегмент номенклатуры, по которому будет применяться скидка →
    • Перейдите на вкладку Условия предоставления → Нажмите + → Вы выпадающем списке нажмите + → Укажите Условие предоставления: По типу получателяТип получателя: Дисконтная карта → Нажмите + → В выпадающем списке выберите один из ранее созданных видов карт, который соответствует этой скидке → Нажмите Записать и закрыть в условиях предоставления → Нажмите Записать и закрыть в создании скидки
  • Создайте остальные скидки

# Настройка бонусов

  • Откройте Администрирование → Маркетниг → Скидки, наценки, ограничения → Установите галочку Скидки, наценки и ограничения продаж Установите галочку Бонусные программы лояльности
  • Откройте МаркетингСкидка (Наценки, ограничения) → Нажмите Создать
    • Укажите Тип скидки: Начислить бонусные баллы процентом от суммы → Укажите Размер скидки: нужный вам процент начисления бонусов → Укажите Область предоставления: В документе → При необходимости укажите сегмент номенклатуры, с которого будут начисляться бонусы
    • Перейдите на вкладку Параметры бонусной программы → В поле бонусная программа лояльности нажмите + → В открывшемся окне Укажите наименование бонусной программыУкажите Вид программы лояльности: Бонусный сервис 1С-Розница (для конфигураций 1С-Рарус) → Укажите Максимальный процент оплаты → При необходимости укажите сегмент, который можно оплачивать бонусами → нажмите Записать и закрыть
    • Перейдите на вкладку Условия предоставления → Нажмите + → Вы выпадающем списке нажмите + → Укажите Условие предоставления: По типу получателяТип получателя: Дисконтная карта → Нажмите + → В выпадающем списке выберите один из ранее созданных видов карт, который соответствует этой бонусной карте → Нажмите Записать и закрыть в условиях предоставления → Нажмите Записать и закрыть в создании скидки
  • Создайте остальные скидки

# Настройка загрузки карт из PH в 1C

  • Откройте АдминистрированиеДополнительные обработки и отчеты → Откройте обработку Загрузка клиентов из PH
  • Нажмите Выполнить, чтобы карты и клиенты загрузились из PRIME HILL прямо сейчас.
  • Откройте PRIME HILLЖурнал взаимодействия с PRIME HILL → Убедитесь, что нет ошибок при загрузке клиентов. Если выявлены ошибки устраните их следуя рекомендациям из журнала или FAQ.
  • Установите Расписание на загрузку карт и клиентов. Рекомендуем устанавливать частоту синхронизации раз в минуту.
    • При использовании РИБ расписание для этой обработки нужно установить только в центральной базе.

# Настройка синхронизации транзакций

  • Откройте АдминистрированиеДополнительные обработки и отчеты → Откройте обработку Синхронизация транзакций с PH
  • Выберете обработку Синхронизировать транзакции и аккумулированные данные в автоматическом режиме → нажмите Выполнить, чтобы синхронизировать транзакции и аккумулированные данные по клиентам прямо сейчас.
  • Откройте PRIME HILLЖурнал взаимодействия с PRIME HILL → Убедитесь, что нет ошибок при импорте и экспорте транзакций. Если выявлены ошибки устраните их следуя рекомендациям из журнала или FAQ.
  • Установите Расписание на синхронизацию транзакций. Рекомендуем устанавливать частоту синхронизации раз в минуту.
    • Для РИБ в центральной базе включите на регулярное выполнение обработку Синхронизировать транзакции и аккумулированные данные в автоматическом режиме в базах магазинов включите обработку Синхронизировать транзакции в автоматическом режиме.
    • Для баз без РИБа включите обработку Синхронизировать транзакции и аккумулированные данные в автоматическом режиме.

# Настройка автообновления обработок

  • Откройте АдминистрированиеДополнительные обработки и отчеты → Откройте обработку Обновление внешних инструментов интеграции
  • Установите Расписание на проверку обновлений. Рекомендуем устанавливать частоту синхронизации раз в сутки.

# Настройка очистки журнала

  • Откройте АдминистрированиеДополнительные обработки и отчеты → Откройте обработку Очистка журнала взаимодействий с PH
  • Установите Расписание на проверку обновлений. Рекомендуем устанавливать частоту синхронизации раз в 3-7 дней.

# Настройка импорта клиентов в PH из 1С

  • Откройте АдминистрированиеДополнительные обработки и отчеты → Откройте обработку Выгрузка новых клиентов в PH
  • Нажмите Выполнить, чтобы отправить всех не синхронизированных клиентов из 1С в PH.
  • Откройте PRIME HILLЖурнал взаимодействия с PRIME HILL → Убедитесь, что нет ошибок при отправке клиентов. Если выявлены ошибки устраните их следуя рекомендациям из журнала или FAQ.
  • Установите Расписание на отправку клиентов в PH, если планируется создание клиентов через 1С. Рекомендуем устанавливать частоту синхронизации раз в минуту.

# Настройка обмена данными модуля для РИБ

  • В центральной базе откройте PRIME HILL → Настройки обмена данными → Установите галочки Дополнительные свойства, Соответствие видов карт лояльности, Соответствие владельцев карт → Нажмите Сохранить 
  • В центральной базе откройте PRIME HILL → Участники обмена данными → Добавьте к обмену все базы
    • Код — произвольный код, являющийся идентификатором базы. Важно сохранить код базы при настройке каждой из баз.
    • Наименование — наименование базы для идентификации
    • Каталог обмена — путь к папке в облачном хранилище, через которое будет происходить обмен
    • Принадлежность — магазин к которому принадлежит база

Пример заполнения для ЦБ:

  • В базе магазина откройте PRIME HILL → Участники обмена данными → Добавьте к обмену все базы
    • Код — произвольный код, являющийся идентификатором базы. Важно сохранить код базы при настройке каждой из баз.
    • Наименование — наименование базы для идентификации
    • Каталог обмена — путь к папке в облачном хранилище, через которое будет происходить обмен
    • Принадлежность — магазин к которому принадлежит база

Пример заполнения для магазина:

  • Откройте АдминистрированиеДополнительные обработки и отчеты → Откройте обработку Выгрузка новых клиентов в PH
  • Установите Расписание для обработки Выполнение получения и отправки данных. Рекомендуем устанавливать частоту синхронизации раз в минуту.

# Настройка маркетинговых акций

  • В центральной базе откройте Маркетинг → Маркетинговые акцииСоздать

Укажите название акции в заголовке, нажмите на  «+» кликните в пустое поле →  Показать все

В левой половине выбрать магазины, в которых будут применяться созданные скидки и бонусы, в правой — какие именно именно скидки и бонусы будут применены в выбранном магазине → Провести и закрыть

# FAQ

Не появился раздел PRIME HILL после настройки прав

В некоторых версий 1С наблюдается баг, после которого в меню не появляются разделы из расширений конфигурации. Чтобы раздел PRIME HILL отобразился откройте конфигурацию в режиме конфигуратора → АдминистрированиеПользователи → Щелкните дважды по пользователю → Прочее → Установите галочки Администрирование Prime Hill и Базовые права Prime Hill