Пример создания bridge (http api - tcp) для ККТ "Касса №1" ("К1-Ф")

17.03.19

Интеграция - WEB-интеграция

Пример создания bridge (http api - tcp) для ККТ "Касса №1" ("К1-Ф"). Данная статья будет полезна интеграторам, программистам, тем кто работает (интегрирует, разрабатывает) различное ТО либо железки. Версия и релиз технологической платформы не имеет значения.

Пример создание http сервера для работы с различным торговым оборудованием.

В статье рассматривается пример для фр - ККТ "Касса №1" ("К1-Ф").

Задача:

Есть bitrix-сайт(1С Битрикс). Подключили эквайринг СБ, купили фр К1-Ф, нужно связать.

 

Отступление:

1. Да я знаю, что эквайринг СБ совместно с ГК Атол предоставляет возможность пробивать чеки.(Проектировал не я, что имеем, то имеем (bitrix-сайт, php-модуль для СБ, всё это на хостинге, с одной стороны, и с другой где-то в офисе воткнута в сеть К1-Ф)).

2. Хотя и у К1-Ф есть web админка, я не нашел доков по http методам, искал здесь:

http://www.kassa.astralnalog.ru/docs, http://v8.1c.ru/to/k1f/, на сайте производителя, итс и тд.

3. Да я знаю, как можно сделать в модуле php get/post и тд, сделано все таки разделение: php пишет в базу об оплате, python читает, при добавлении новых пробивает чек. Отслеживание происходит через запрос в бд источника с передачей в параметре последнего ид, и дальнейшего прохода по выборке для пробития. 

 

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

1. Создание эмулятора интерфейса команд ФР (нужен для теста, и вообще понять какой формат обмена)

2. Создание Web(HTTP) сервера для работы c ФР (фактически проксирование с HTTP на TCP, + некоторая инкапсуляция методов для работы, об этом ниже)

3. Разработка клиентской части (пример чтения таблиц mysql(источник на стороне хоста), пример пробития, пример записи результата в sql lite(приемник на стороне офиса))

 

Шаг 0. Протокол обмена ФР.

Обмен с ФР проходит по TCP(ФР - TCP сервер), по заданному формату. Формат - JSON(UTF-8), структура сообщения - первые 4 байта длина сообщения, с 5-го - сообщение.

Структура команд будет описана ниже.

 

Шаг 1. Эмулятор ФР.

 
 main.py

TCP сервер, описание по основным моментам делал в прошлой статье.

 
 protocol.py

 RESPONSE - соответствие имя команды - структура ответа. Формирование сообщения к отправке делается так:

message = message.encode('utf-8')

len_message = len(message)
    
len_message = len_message.to_bytes(OFSSET, byteorder='big', signed=True)

return len_message + bytes(message)

to_bytes - инт в байт с учетом оффсета(у нас 4 первых из протокола)

len_message + bytes(message) - само сообщение в байтах.

От производителя шла утилита работы.

Пример работы:

 

Шаг 2. HTTP апи сервер.

В качестве web сервера используется flask описание по основным моментам делал в прошлой статье.

 
 main.py
 
 server/__init__.py
 
 server/conf.py

SERVER = ('192.168.1.99', 49152) - адрес\порт фр

LOGIN = 'LOGIN' - по дефолту admin
PASSWORD = 'PASSWORD'  - по дефолту 12
CON_PASSWORD = 'CON_PASSWORD' - меняется в админке

OPER_LIST - массив реализованных операций фр

 
 server/view.py

Енд поинты апи.

Итак, перед тем как отправить команду на фр(например пробитие чека) нужно:

1. Установить tcp соединение ("физическое соединение")

2. Получить ключ сеанса ("логическое соединение", установить сессию)

3. Выполнить команду (пробитие чека)

4. Разорвать, закрыть сессию ("логическое соединение")

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

Для пробития чека, этап(3) (метод в коде "make_payment") логически выглядит как:

1. Получить статус фр

2. Если смена превысила 24 час, тогда закрыть

3. Если смена не открыта, тогда открыть

4. Открыть чек

5. Добавить позиции

6. Закрыть чек

при этом все выполняется в рамках одной сессии.

make_payment - принимает в теле пост запроса структуру JSON (о ней ниже).

 
 server/fisc_reg_exchange.py

Дозаполнение полей, приведение к формату для работы с ФР, ну типа (d['paymentFormCode'] = data['payment_form_code'] и тд).

TCP клиент:

 sock = socket.socket()
 sock.connect(SERVER)

+ код для формирования сообщения.

 
 client_sample.py

Пример для тестов(клиент)

Пример работы:

 

Шаг 3. Клиент.

 
 main.py

connection = pymysql/sqlite3.connect(... - установка соединения с базой источником

res = cursor.execute(query_text, ) - выполнение запроса

cursor.executemany('INSERT INTO operations values (?,?,?,?)', rows) - вставка в базу приемник

остальное было выше

 
 operations.db.sql

Структура базы приемника

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

 

 
 start.sh

 

Так же возможно писать не в tcp порт, а на пример в com, в pipe, в блочное устройство(файл в терминах linux)

К1-Ф python http web ККТ Касса№1 api ФР

См. также

WEB-интеграция Администрирование веб-серверов Платные (руб)

Веб-портал обеспечивает удобный доступ к конфигурации 1С:ITIL(ИТИЛ), 1С:ITILIUM, Управление IT-отделом 8 через интернет с любого устройства посредством браузера, увеличивая эффективность работы пользователей и снижая нагрузку на сервер. Быстрая инсталляция портала за пару часов, удобный и интуитивно понятный интерфейс и безопасность данных помогут упростить работу с порталом и ускорить выполнение бизнес-процессов компании.

128000 руб.

19.12.2023    2604    3    0    

10

WEB-интеграция Анализ продаж Системный администратор Программист Пользователь Платформа 1С v8.3 1С:ERP Управление предприятием 2 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х Управленческий учет Платные (руб)

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

60000 руб.

07.05.2019    34682    68    45    

27

Оптовая торговля Розничная торговля WEB-интеграция 1С:Управление торговлей 10 1С:Управление производственным предприятием 1С:Управление нашей фирмой 1.6 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 Платные (руб)

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

57600 руб.

26.11.2024    2376    2    2    

4

Сайты и интернет-магазины WEB-интеграция Системный администратор Программист Пользователь Платформа 1С v8.3 1C:Бухгалтерия 1С:Управление торговлей 11 Автомобили, автосервисы Россия Управленческий учет Платные (руб)

Интеграционный модуль обмена между конфигурацией Альфа Авто 5 и Альфа Авто 6 и порталом AUTOCRM. Данный модуль универсален. Позволяет работать с несколькими обменами AUTOCRM разных брендов в одной информационной базе в ручном и автоматическом режиме.

36000 руб.

03.08.2020    19078    22    22    

19

WEB-интеграция Программист Платформа 1С v8.3 Бухгалтерский учет 1С:Бухгалтерия 3.0 Бытовые услуги, сервис Платные (руб)

Внешняя обработка разрабатывалась для загрузки документов из Ветменеджер в 1С: Бухгалтерия 3.0

12000 руб.

02.02.2021    18845    54    50    

30

WEB-интеграция Программист Бизнес-аналитик Платформа 1С v8.3 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 1С:Розница 3.0 Оптовая торговля, дистрибуция, логистика ИТ-компания Платные (руб)

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

14400 руб.

20.12.2024    848    4    1    

5

WEB-интеграция Программист Руководитель проекта Платформа 1С v8.3 1C:Бухгалтерия 1С:Франчайзи, автоматизация бизнеса Платные (руб)

Расширение значительно упрощает написание API на 1С. Веб программисты получают простой и понятный доступ к 1С. Описание API создаётся автоматически и представляется в виде удобном как для человека, так и для программной обработки.

24000 руб.

27.09.2024    4067    3    2    

4

Обмен с ГосИС WEB-интеграция Бухгалтер Пользователь Платформа 1С v8.3 Управляемые формы 1С:Комплексная автоматизация 1.х 1С:Бухгалтерия 2.0 1С:Управление торговлей 10 1С:Управление производственным предприятием 1С:Управление нашей фирмой 1.6 1С:Бухгалтерия государственного учреждения 1С:Документооборот 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х Платные (руб)

Обработка является альтернативой механизму, разработанному фирмой 1С и заполняющему реквизиты контрагента по ИНН или наименованию. Не требуется действующей подписки ИТС. Вызывается как внешняя дополнительная обработка, т.е. используется, непосредственно, из карточки контрагента. Заполнение по ИНН или наименованию реквизитов контрагента по данным сайта ФНС (egrul.nalog.ru) для БП 2.0, БП 3.0, БГУ 1.0, БГУ 2.0, УТ 10.3, УТ 11.x, КА 1.1, КА 2.x, УПП 1.x, ERP 2.x, УНФ 1.5, УНФ 1.6, УНФ 3.0, ДО 2.1

2400 руб.

28.04.2016    93039    191    217    

343
Комментарии
Подписаться на ответы Инфостарт бот Сортировка: Древо развёрнутое
Свернуть все
1. user1416875 01.06.20 13:35 Сейчас в теме
Добрый день!
Хотел задать пару вопросов по данной интеграции, есть способ с Вами связаться?
2. пользователь 09.11.22 11:13
Сообщение было скрыто модератором.
...
3. user2122459 14.01.25 23:04 Сейчас в теме
Очень полезная, спасибо большое, но для будущего пожалуйста для сокращённый название напишите один разок его полный название, это будет очень приятно и удобно, :) Я новый по 1с системы и раз 5-6 ходил по поисковик на этом посте
Оставьте свое сообщение