Подключение IKKM Offline к «1С:Розница»

Работа iKKM в режиме ККМ Offline – это осуществление периодического обмена данных с конфигурациями"1С:Предприятия". Такие кассы удобны для использования в небольших удаленных торговых точках. При этом не требуется оснащение таких точек еще какой-либо вычислительной техникой, а в IKKM можно выгрузить базу товаров,  дополнение  можно подключить сканер штрих кода. С этим нехитрым набором удаленная касса будет укомплектована всем необходимым, согласно современным стандартам. 

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

Установка необходимого ПО на ПК

ПО поставляется в архивном файле iKKMExchange, который можно скачать на этой странице по ссылке выше.

Архив содержит запускаемый модуль iKKMExchange.exe и запускаемый сценарий createINI.bat

ШАГ 1  

Распаковываем папку "iKKMExchange" , которая лежит в скачанном архиве в любое удобное для Вас место на компьютере. 

ШАГ 2

Находим в папке файл createINI.bat и запускаем его.   При запуске createINI.bat, в этой же папке создается файл Settings.ini с начальными настройками. Изменить параметры запуска возможно, изменив файл createINI.bat и перезапустив приложение iKKMExchange.exe, или непосредственно изменив файл Settings.ini. 

Если открыть файл settings.ini в блокноте, то увидим следующий небольшой набор настроек:

Надпись "Log":"off" ответственна за ведение журнала логов работы приложения (по умолчанию выключено, "on"-включено).

"RecNumLim":2500 - максимальное количество SKU в базе товаров (по умолчанию 2500 товаров).

"IPPort":8082 - порт взаимодействия приложения с системой 1С. ( после выбора нужного порта, параметр порта будет указываться в настройках на самом аппарате iKKM далее в процессе настройки)

После проведенных изменений сохраняем файл. 

ВАЖНО

Обратите внимание также на конец строки настроек:

"Cash":0, "Bank":1, "Tara":2, "Credit": 3 - это важные параметры обмена, которые должны совпадать с соответствующими  значениями настроек на стороне 1С. 

Cash-признак приема наличных средств, за признаком после ":" следует цифра, идентифицирующая признак в системе. 

Bank- признак приема платежа по карточке банка.

Tara- признак приема тары (вариант расчета, как в советское время: сдал бутылки-получил скидку) Этот признак можно использовать,например, в целях дискаунта, скидки, в качестве части системы лояльности и т.д.

Credit- признак кредита. 

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

 

ШАГ 3 

Запускаем файл iKKMExchange.exe двойным щелчком.  

При успешном запуске iKKMExchange.exe в панели задач появится значок iKKM оранжевого цвета.

Проведение необходимых настроек на стороне аппарата iKKM

ШАГ 4

Настраиваем IKKM, как показано на видео ниже.

 

Согласно видеоруководству, в аппарате на вкладке "Обмен данными" переходим по кнопке "Соединение" в окно "Настройка соединения".   Ссылка в строке "Справочник товаров HTTP" должна начинаться с ip-адреса и порта персонального компьютера с 1С системой (ПК с которым планируется взаимодейтсвие кассового аппарата).  При этом нужно указать порт, выбранный ранее в файле настройки settings.ini  (напомним, что по умолчанию указан порт 8082).

Таким образом формат записи будет следующий:

ip адрес вашего ПК: порт указанный в settings.ini/GetPriceList     

Например, готовая строка будет выглядеть так: 192.168.0.11:8082/GetPriceList. 

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

Аналогичным образом поступаем со строкой "Журнал документов HTTP"

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

ШАГ 5  

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

Шаг 6

iKKMExchange обменивается данными (REST API) с кассовыми аппаратами iKKM и контролирует папки обмена файлами с 1С. 

Обмен данными со стороны 1С для каждого кассового аппарата привязывается также к  папке конкретного аппарата.

ШАГ 7 

 Для успешного обмена данными необходимо из 1С выгрузить данные со списком номенклатуры. При выгрузке номенклатуры в папке создается также файл настроек для обмена Settings.xml.

Обратите внимание, Если файл настроек Settings.xml будет отсутствовать в папке - обмен данными будет приводить к ошибке.

Папка обмена данными с кассовым аппаратом содержит принятые файлы сменной информации в формате JSON , обработанные файлы 1С и последний файл обмена со списком номенклатуры.

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

Настройка на стороне 1С

ШАГ 8

Первым делом, нам необходимо завести новое правило обмена с подключаемым оборудованием. Переходим в раздел "Администрирование"-"Подключаемое оборудование".

В открывшемся окне проверяем установлена ли галочка напротив "Обмен с подключаемым оборудованием",  затем переходим по ссылке "Правила обмена с подключаемым оборудованием".

 

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

Во вкладке "Отбор", нужно выбрать по каким параметрам будет отбираться товар со склада, например, на фото ниже список товара будет состоять из всех товаров, оставшихся на указанном складе и для которых проставлена цена. 

Переходим на вкладку "Прайс-лист", в котором видим незаполненную табличную часть. 

Нажимаем на кнопку "Обновить", после чего табличная часть заполнится  списком товаров по отбору. Этот список товаров в дальнейшем будет уходить на кассовый аппарат. 

Обратите внимание на столбец SKU, это коды товаров, которые в дальнейшем помогут быстро выбрать нужную позицию номенклатуры на кассовом аппарате. Если у всех ,либо у некоторых товаров не выставлен код SKU, его нужно сгенерировать, нажав на "Сгенерировать SKU".

После всех этапов настройки, нажимаем "Записать и закрыть".

ШАГ 9

После создания правила обмена, создаем подключаемое оборудование, к которому будет применяться это правило обмена.

Возвращаемся к ранее открытому окну "Настройка подключаемого оборудования" и переходим по ссылке "Подключаемое оборудование".

В открывшемся окне "Подключение и настройка оборудования", выбираем тип оборудования "ККМ Offline", далее "Создать", в открывшемся окне указываем драйвер оборудования "1С:ККМ Offline".  Можно (но не обязательно)  указать серийный номер аппарата в соответствующей графе. Важно выставить нужное правило обмена в соответствующей графе (то, что было создано нами ранее в предыдущем шаге). После внесения всех изменений, нажимаем "Записать и закрыть". В табличной части окна появилось новое наименование. 

Далее в этом же окне нажимаем кнопку "Настроить".  Откроется  окно с дополнительными параметрами настройки ККМ Offlinе.

Выбираем версию формата обмена (на момент написания статьи актуальной версией является 1.6).

В пути к каталогу выгрузки указываем путь к папке с серийным номером аппарата, находящейся в iKKMExchange папке.

"Каталог выгрузки" указывается по тому же пути ,что и "каталог загрузки".

В графе "Имя файла настроек" прописываем Settings.

В "Маске файла прайс-листа" - PriceList.

"Имя файла отчета о продажах"- SalesReport.

Нажимаем "Записать и закрыть".

ШАГ 10

Следующим этапом  надо синхронизировать признаки команд кассового аппарата ,прописанные ранее в файле Settings.ini папки iKKMExchange с  соответствующими настройками в 1С.

Для этого переходим  в раздел "НСИ"-"Кассы ККМ".

Нажимаем кнопку "Создать".  

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

Желательно (но не обязательно)  указать серийный номер аппарата (2).

В строке "Подключаемое оборудование" (3), выбираем созданный ранее ККМ Offline.

В строке "Соответствие видов оплаты" (4), выбираем из выпадающего списка нужный, либо создаем его заново. 

В открывшемся окне конкретного соответствия вида оплаты  необходимо присвоить те же кодовые значения, что были указаны ранее в Settings.ini, как показано на рисунке (6).

Нажимаем "Записать и закрыть".

ШАГ 11

Теперь можно перейти в раздел "Продажи"-"Обмен с подключаемым оборудованием" и проверить выгрузку товаров из 1С в папку iKKMExchange.

Если все шаги выполнены правильно, то при выборе правильного Склада (указанного при регистрации подключаемого оборудования ранее), выбора правильного правила выгрузки, в табличной части появится доступный для взаимодействия ККМ Offline ( по сути, это папка-посредник iKKMExchange).

Нажимаем кнопку "Выгрузить".

После завершения процесса выгрузки товаров, в папке с серийным номером Вашего кассового аппарата (в папке iKKMExchange/серийный номер), появились файлы взаимообмена.  

При открытии файла settings.xml в блокноте, можно увидеть коды обмена кассового аппарата, которые были выставлены в настройках ранее.

Если у Вас установлена последняя версия "1С:Розницы" в окне "Обмен с подключенным оборудованием", Вам будет доступна функция автоматического обмена.