Настройка загрузки файлов статистики

Система телеметрии

Настройка системы телеметрии

Для интегрированных систем, таких, как Vendotek (в будущем список систем будет пополняться) настроена возможность более плотной интеграции по API.
Для настроек системы телеметрии, следует перейти по ссылке меню Зета Вендинг → Справочники → Системы телеметрии и нажать «Заполнить из классификатора», чтобы система подгрузила все актуальные поддерживаемые классификаторы, или добавить новый элемент, нажатием на «Создать», и заполнив открывшуюся форму.
Для настроек подключения системы CrestWave необходимо нажать на "Создать" и указать: - Наименование: CrestWave - Имя обработки телеметрии: зв_СистемаТелеметрииCrestWawe - Формат статистики: EVA-DTS - Папка с устройствами: CrestWave (создать, если нет в списке)
После чего, записать карточку и нажать на "Заполнить параметры".
Далее, необходимо приступить к настройке системы, которая используется в Вашей компании, дважды кликнув мышью, например, на Vendotek.
В открывшейся форме настройки системы телеметрии Vendotek верхняя информативная часть заполняется автоматически.
На закладке Параметры необходимо нажать на «Заполнить параметры» для формирования его табличной части с данными:
  • Token - следует ввести ключ, предоставляемый компанией выбранной телеметрии;
  • Адрес сервера - стандартный адрес сервера;
  • Код налогооблажения - установить значение кода в соответствии с данными:
    0 = Общая;
    1 = Упрощенная “доход”;
    2 = Упрощенная “доход минус расход”;
    3 = Единый налог на вмененный доход;
    4 = Единый сельскохозяйственный налог;
    5 = Патентная система налогообложения ;
  • Номер последней ошибки - номер последней ошибки соответственно, полученный в результате обращения регламентного задания к API системы телеметрии, согласно настроенному расписанию, для получения данных в количестве заданного параметра «Размер порций». По окончанию обработки полученных порций в системе будут сформированы документы Неисправность автомата (Зета Вендинг → Документы);
  • Номер последней продажи - номер последней продажи соответственно, полученный в результате обращения регламентного задания к API Vendotek, согласно настроенному расписанию, для получения данных продаж. По окончанию обработки полученных порций в системе будут сформированы документы Продажи по телеметрии (Зета Вендинг → Документы);
  • Номер последней статистики - номер последней статистики соответственно, полученный в результате обращения регламентного задания к API Vendotek, согласно настроенному расписанию, для получения EVADTS файлов статистики;
  • Порт сервера - устанавливается стандартное значение = 80;
  • Размер порции - устанавливается стандартное значение запрашиваемых порций = 1 000 000;
  • Смещение времени от UTC - для московского времени устанавливается значение = 2, для остальных часовых поясов добавлением к значению “2”, отклонение от московского времени;
  • Смещение времени продажи от UTC - устанавливается смещение времени для часового пояса Москвы = -1.
  • Убрать лидирующие нули в идентификаторе банка - устанавливается в зависимости от использования банком нулей в excel отчетности, если используются то = 0, если нет = 1.
На закладке Расписание настраиваются регламентные задания для того, что забор новых данных происходил автоматически, вместо ручного нажатия на кнопку «Запустить».
Рекомендуемые настройки для ввода на закладке Расписание:
  • Загрузка статистики: повторять каждый 1 день, дневное расписание: каждые 120 секунд, чтобы статистики успевали прогружаться и вставать в очередь;
  • Загрузка ошибок: повторять каждые 1 день, дневное расписание: каждые 60 секунд;
  • Загрузка исправленных ошибок: повторять каждый 1 день, дневное расписание: каждые 60 секунд (для Vendotek данная настройка не актуальная, т.к. данная загрузка проходит одним регламентным заданием повсеместно с загрузкой ошибок);
  • Отправка ассортимента: повторять каждый 1 день, дневное расписание: время начала 01:00, т.к. дата изменения ассортимента формируется на следующий день. При необходимости, для того, чтобы отправить ассортимент непосредственно на текущий день, в меню Управление Вендингом следует нажать на «Отправить данные в систему телеметрии».
  • Загрузка продаж: повторять каждый 1 день, раз в день.
Далее, по переходу в меню Запустить, при нажатии на:
→ Получить статистику/ ошибки/ исправленные ошибки/ продажи - будут получены соответствующие запрошенные данные; → Отправить ассортимент - вызовет регламентное задание по отправке ассортимента на текущий момент, только по тем торговым автоматам, где была зарегистрирована замена ассортимента; → Синхронизировать автоматы - произведет связь автоматов Telemetron (не актуально для Vendotek). → Обновить список устройств - будет запущена обработка по загрузке устройств телеметрии из Личного кабинета телеметрии. По завершению обработки, в справочнике Устройства телеметрии (Зета Вендинг → Справочники) будет создан список устройств с уникальными идентификаторами. Также, обновление списка устройств, следует производить, при обновлении TID или добавлении новых устройств.
Устройство телеметрии - это модем с идентификатором, который устанавливается на каждый торговый автомат.
В окне формы "Устройства телеметрии" представлены следующие данные:
  • Наименование - это уникальный код, устанавливаемый из личного кабинета Vendotek (он отображается в его адресной строке);
  • Идентификатор банка = значению TID, присвоенному модему во время его постановки на учет. По умолчанию, когда модем только куплен и не поставлен на учет в банк, значение параметра представляет собой DEF+номер;
  • Серийный номер модема.
После того, как был обновлен список устройств необходимо произвести связь торгового автомата с устройством телеметрии. Для этого, открыв главное меню Управление Вендингом, в разделе Настройка параметров статистики, в строке Устройства телеметрии следует выбрать соответствующее устройство из справочника.
Обратите внимание, что дата и время записи, при связи торгового автомата с устройством телеметрии производится в текущий момент.
В результате чего, по ссылке меню Зета Вендинг → Документы → Автоматически формируемые документы → Установка устройства телеметрии автомату сформируется соответствующий документ на текущую дату. Таким образом, если связь автомата с устройством телеметрии была произведена после, того как были получены сопутствующие документы, необходимо обязательно скорректировать дату создания документа (на более раннюю) для правильной работы системы.
В связи с чем, крайне рекомендуется придерживаться следующего правила при работе с системой телеметрии: 1) сначала произвести все связи в 1С; 2) затем установить все торговый автомат.

Контроль работы системы телеметрии

При работе с системой телеметрии могут встречаться различные ошибки, которые открываются при переходе в меню Перейти:
→ Незагруженные ошибки; → Незагруженные продажи; → Незагруженные статистики;
Все журналы содержат строки с уникальным номером ошибки, наименованием телеметрии и описанием ошибки. При двойном нажатии на строку с ошибкой, открывается форма, в которой можно ознакомиться с более развернутым текстом ошибки.
Также, в каждом из журналов имеется кнопка «Обработать ошибочные записи», которая запускает обработку выделенных (или всех) ошибочных строк.
При правильной работе системы телеметрии все журналы должны быть пустыми!
В связи с чем, прежде всего, следует регулярно проверять и разбирать журналы ошибок, либо настроить для этого соответствующее регламентное задание (Операции → Обработки → Консоль заданий).
Для контроля работы системы телеметрии имеются следующие отчеты (Зета Вендинг → Отчеты → Телеметрия):
1. Сравнение продаж телеметрии и статистик
Как следует из данного раздела, информации о продажах в систему поступают из двух источников - это статистика и телеметрия.
Система телеметрии Vendotek, на текущий момент, передает информацию о продажах в режиме реального времени, т.е. когда они были совершены фактически. Таким образом, при снятии статистики нам известен временной интервал, за который она была снята, и можно легко определить предыдущий файл снятия статистики.
Отчет Сравнение продаж телеметрии и статистик автоматически поднимает все файлы телеметрии за этот период, сопоставляя их друг с другом.
Если ошибок и расхождений не выявлено, значит система работает корректно. При наличии ошибок - следует производить их разбор, например, проверить правильно ли настроен ассортимент.
2. Сравнение данных эквайера и Телеметрии
По результату безналичных продаж от банка эквайера формируются данные по полученным им денежным средствам. Полученные данные вносятся в систему по ссылке меню Зета Вендинг Документы Отчет банка эквайера, который заполняется вручную или путем загрузки excel-файла (xls формата).
В отчете также следует указывать Дату, в соответствии с той, за которую отчитался банк, и заполнять информацию о периоде данных отчета в поле Комментарий.
Отчет Сравнение данных эквайера и Телеметрии по идентификатору связывает данные сумм продаж и выдает расхождения, если таковые имеются.
3. Остатки торговых автоматов с учетом данных телеметрии
Данный отчет берет дату последнего формирования продаж и от этой даты получает все документы продаж телеметрии. Таким образом, отчет формирует данные количества остатков в автоматах, уменьшая остатки ведомости товаров 1С на то количество, которое было продано по телеметрии с момента последней статистики.
Отчет работает и по снекам, и по ингредиентам в рамках номенклатурных групп.

Загрузка статистики с FTP

Прежде всего, следует произвести следующие действия:
1) Написать заявку в соответствующую компанию, в зависимости от оборудования, для настройки выгрузки на FTP; 2) Произвести настройки в системе, по результату получения логина/пароля/адреса сервера;
Чтобы произвести настройки c системами мониторинга необходимо пройти по ссылке меню Зета Вендинг → Настройки → Общие настройки на вкладку Статистика GSM.
на скриншоте представлен порядок настроек загрузки с ftp Kit Vending
3) Произвести связь устройства статистики с торговым автоматом в разделе Настройка параметров статистики.
В случае использования телеметрии Telemetron, уточнить обновлен ли API, т.к. интеграция реализована только по "старому" API (иначе загрузка на FTP).Ни
Ниже представлена таблица для сравнения работы в системе с различными системами телеметрии и какие доработки в отдельности требуются в каждой из них.

Загрузка статистики из файлов

Загрузка файлов статистики Zeta Vending

Файлы статистики Zeta Vending формируются при использовании ТСД, которые позволяют снимать статистики торговых автоматов через DeX разъем (данный разъем монетоприемника имеется у ограниченного парка торговых автоматов).
Обратите внимание, что для работы с данной разновидностью снятия статистики необходимо приобрести специальное ПО.

Загрузка статистики в формате Rheavending

Файлы статистики Rheavending формируются в формате *csv при использовании торговых автоматов данного бренда.

Загрузка файлов статистики EVADTS

Для открытия данной обработки следует пройти по ссылке меню Зета Вендинг → Документы → Загрузка статистики → Загрузка файлов статистики EVADTS.
EVADTS - стандартный формат файла снятия статистики с торгового автомата.
Для работы с данной обработкой, прежде всего, на Вашем компьютере необходимо создать следующие папки:
  1. 1.
    К обработке - папка, куда будут загружаться файлы, полученные с флешки;
  2. 2.
    Не найден автомат - папка, куда будут перемещаться не разобравшиеся файлы;
  3. 3.
    Ошибки - папка, куда будут перемещаться файлы с ошибкой разбора;
  4. 4.
    Архив - папка, куда будут перемещаться разобранные файлы статистики.
В открывшейся форме обработки следует указать путь доступа к ранее созданным папкам.
Для того, чтобы сохранить указанный путь к папкам, нажмите на «Сохранить значение».
Также в верхней части окна имеется возможность установки флагов:
  • Заполнять ответственным оператором - если оператор использует мобильное устройство, установка данного флага не обязательна, т.к. система автоматически будет искать задачу обслуживания торгового автомата с указанием ответственного;
  • Получать дату и время из имени файла - если формируемые файлы статистики имеют в своем наименовании данные о дате и времени, при установке флага, система будет пытаться разобрать эти данные.
Нажмите «Заполнить» и в табличной части обработки отобразятся файлы статистики для разбора из папки «К обработке».
В графу Автомат автоматически будет загружен соответствующий процесс автомата.
При использовании мобильного устройства также автоматически заполняется графа Задача оператора, исходя из даты и времени обслуживания автомата, а также графа ШК мешка инкассации и ответственный оператор соответственно.
При установке оператора вручную следует нажать на «Заполнить оператора» и выбрать его из списка.
В том случае, если Задача оператора вносится вручную, необходимо нажать на «Выбрать» и выбрать задачу из списка, где будут отображены все задачи обслуживания оператора в течении суток, исходя из настроек Зета Вендинг → Настройки → Общие настройки → вкладка Статистика GSM → строка Количество минут для сопоставления задачи.
Выявленные ошибки разбора будут отображены в служебных сообщениях, в нижней части экрана, а также в графе Описание ошибки разбора. При нажатии на «Удалить не найденные», данные файлы статистики можно будет разобрать отдельно, если не нажимать на кнопку - файлы переместятся в папку Не найден автомат.
По итогу разбора, на основании загруженных файлов статистики будут созданы документы Формирование продаж.
Проверить очередность обработки файлов статистики можно по ссылке меню Зета Вендинг → Справочники → Очередь документов обмена. Для того, чтобы система повторно произвела разбор файла, необходимо открыть соответствующий документ в очереди обмена и снять флаг «Выполнена».
Дальнейшая работа с документом Формирование продаж описана здесь.

Загрузка статистики вручную

Прежде всего, в настройках параметров статистики автомата в разделе Настройки для съема статистики ТСД должен быть указан Способ съема - Ручной ввод.
Для ручного снятия статистики, при обслуживании торгового автомата, оператору необходимо запустить на мобильном устройстве приложение Zeta Vending.
В списке меню выбрать «Обслуживание автомата».
Выбрать торговый автомат из списка и перейти в Плановое или Произвольное обслуживание.
На этапе снятия статистики, в табличке мобильного приложения, оператору будет необходимо заполнить данные с монетоприемника по каждому из продуктов торгового автомата (где код в монетоприемнике соответствует коду продукта, установленному в настройки ячеек закладки)
После проведения обмена данными, в 1С будет сформирована запись в справочник статистики автоматов (Зета Вендинг Справочники Статистика автоматов) о снятии статистики при плановом обслуживании оператором.

Автоматическое формирование продаж по загрузке

Данный способ учета статистики применяется крайне редко, а его реализация возможна только для снековых торговых автоматов.
В меню Управление Вендингом следует выбрать необходимый снековый автомат и в его настройках параметров статистики установить флаг «Автоматически формировать продажи по загрузке» (доступ к данному флагу, по умолчанию, отключен). Таким образом, система будет считать, что торговым автоматом было продано ровно столько сколько было загружено ранее.
Важно, чтобы оператор производил снятие статистики выбирая Плановое обслуживание в Android приложении Zeta Vending, т.к. при Произвольном обслуживании теряется связь между загрузкой ассортимента и снятием статистики.