Задать вопрос
Интеграция Штрих-М: Кассир 5 с HEADO
Общее описание этапов по подключению к сервису HEADO и описание интеграции с Штрих-М

Порядок задач по техническому подключению и разворачиванию ПО HEADO:
  1. Получить ключи (Auth_Key);
  2. Обеспечить доступность сервиса HEADO;
  3. Синхронизировать время и проверить часовой пояс;
  4. Настройка Штрих-М (версия 5.1.5.х);
  5. Установить ПО HEADO;
  6. Сверка продаж
Версия от 2022-11-15
Описание интеграции
Интеграция реализована через файловое взаимодействие ПО «HEADO» с Штрих-М при помощи запроса (файл-флаг) и ответа на запрос(отчет по продажам). Для этого на каждой кассе настраивается Штрих-М и указывается каталог обмена с ПО «HEADO» (обычно один и тотже кассовый компьютер)
  • Для настройки подключения, необходимо получить уникальный ключ доступа (Auth_Key) для каждого кассового компьютера;
  • ПО «HEADO» формирует файл-флаг (по умолчанию «sales_flag.txt») в каталоге обмена с запросом на получение данных о продажах;
  • ПО «Штрих-М» считывает созданный файл-флаг и формирует файл отчета с
    продажами, а файл-флаг удаляет (параметр настраиваемый);
ВАЖНО: Из-за особенностей штатного файлового обмена штрих-м с внешними система, необходимо учесть след.моменты:
  • если на ПК закончится место на жестком диске, то файлы отчетов для обмена не смогут формироваться и это приведет к расхождениям показателей.
  • При появлении новых продаж в отчете, ПО «HEADO» формирует пакет с данными в очередь на отправку (%programfiles%\GiftomanKKMSuite\data\chuncked_queue) и отправляет в облако HEADO (api.heado.ru). Если api.heado.ru недоступно по 80 и 443 портам, то данные в облако будут отправлены при возобновлении его доступности, а очередь на отправку очистится;
ВАЖНО: При переустановке ПО необходимо проверить директорию очереди данных на отправку и убедиться, что папка пуста. В случае наличия файлов, необходимо выполнить резервную копию папки очереди данных для их восстановления после переустановки ПО.
  • В облаке поступившая информация обрабатывается ядром системы HEADO. После обработки данных, информация о достигнутых KPI доступна по следующим каналам: продавцам через ПО «HEADO», руководителям через личный кабинет (web,мобильное приложение IOS/Android)
ВАЖНО: Если торговому предприятию необходимо настроить показатели в системе HEADO для отслеживания продаж по определенным категориям товаров (группы,классификаторы товаров, доп.текстовые метки), то необходимо реализовать выгрузку дополнительного номенклатурного справочника товаров с категориями, необходимыми для настройки показателей.
1. Получить ключи (Auth_Key)
Необходимо добавить торговые точки и все кассы на них для получения уникальных Auth_Key/AccessKey (ключи доступа для установки ПО HEADO на кассы).
Добавление торговых точек/касс производится одним из способов:
  • Самостоятельно через личный кабинет при наличии доступа с правами администратора;
  • Через менеджера HEADO/Партнёра
При желании установить ПО HEADO на ПК управляющего торговой точки, необходимо использовать Auth_Key привязанного к данной торговой точке.
2. Обеспечить доступность сервиса HEADO
API HEADO должен быть доступен по 80 и 443 портам с рабочей места подключенного подключенного к сервису HEADO. Описание проверки доступности портов доступно по ссылке
3. Синхронизировать время и проверить часовой пояс
Необходимо синхронизировать время и проверить часовой пояс на каждой кассе.
Требования по синхронизации доступно по ссылке
4. Настройка Штрих-М (версия 5.1.5.х)
Для настройки кассы подключите к ней клавиатуру и мышь
4.1 Скачайте файл ВыгрузкаHEADO.epf в папку «\ExtFiles\LogicalModules»
4.2 Находясь в меню «Супервизор» нажмите кнопку «Настройка». (см.Рисунок 1)
Рисунок 1.
4.3 Выберите вкладку «LogicalModules»(МодулиЛогики)
4.3.1 В открывшей вкладке выберите «Выгрузка_HEADO»
4.3.2 Поставьте флаг «Включить выгрузку в HEADO», укажите пути обмена с названиями файлов флага/отчета и укажите время опроса файлов «Период опроса файл-флага, с»
4.3.3 Примените и сохраните настройки
Пример настроек cм. Рисунок. 2
Рисунок 2.
4.4 Настройка способа открытия смены
4.4.1 В меню "Настройка" выберите вкладку «Оборудование»
4.4.2 На вкладке "Оборудование", нажмите на кнопку «Настройка ККМ»
4.4.3 В открывшемся окне, найдите раздел «Способ открытия смены» и измените на «При входе в режим регистрации или перед первым закрытием чека»
4.4.4 Примените и сохраните настройки
Установка ПО «HEADO»
1. Скачать подходящий инсталлятор, последней версии
2. Скопируйте credentials.ini в папку, где сохранен инсталлятор
3. Запустите инсталлятор
4. В появившемся окне, нажмите на кнопку «Next»
5. В появившемся окне, нажмите на кнопку «Install».
6. В появившемся окне, поставьте галочку «Launch Midservice» и нажмите кнопку «Finish»
7. В появившемся окне командной строки, дождитесь установки и запуск службы Midservice.exe
ВАЖНО: Для установки ПО «HEADO» требуется получить credentials.ini, который содержит специальный ключ доступа (Auth_Key/Access Key) с типом терминала "Административный". Не рекомендуется использовать более одной копии ПО с одним и тем же ключом одновременно.
6. Сверка продаж
При развертывании сервиса HEADO на каждой торговой точке требуется проведение сверки данных для избежания расхождений между отчетами торговой системы и HEADO.
Требования по сверке данных и рекомендации описаны по ссылке
Made on
Tilda