Проект

Общее

Профиль

UCRP - Universal cash-register protocol

UCRP - это универсальный протокол для контрольно-кассовой техники, реализованный в кассовой программе GBS.Market.

Использование этого протокола позволяет интегрировать любую кассу с GBS.Market, разработав (или заказав разработку) "Модуль коммуникации"

Описание протокола

Поддержка

Связаться по вопросам интеграции можно по электронной почте
Группа в Телеграм для обсуждения: https://t.me/+JLyBYWbr7l1mNzJi

Схема обмена

Протокол представляет собой описание схемы обмена данными между GBS.Market

Модуль коммуникации

Для того чтобы реализовать интеграцию с кассой, необходимо разработать "Модуль коммуникации" (далее МК). Под таким модулем подразумевается программа или служба, которая на себя берет роль обмена данными между GBS.Market и драйвером/API самой кассы.

Принцип работы модуля коммуникации

  • GBS.Market отправляет команды по описанному протоколу в формате JSON через http-запрос методом POST на адрес и порт, который прослушивается МК
  • МК прослушивает запросы на определенном порту (например, localhost:1234), куда GBS.Market отправляет запросы
  • МК отправляет команду в драйвер/API кассы, согласно документации по интеграции с кассой
  • МК ожидает ответ о выполнении операции на кассе
  • МК отправляет в GBS.Market ответ по описанному протоколу

Таким образом, модуль коммуникации должен:

  • с одной стороны соответствовать UCRP-протоколу
  • с другой стороны соответствовать протоколу обмена с драйвером/API кассы

Печать чеков

Печать чеков при использовании UCRP может быть реализована тремя разными способами:

Чек печатает касса

Если касса является физическим устройством со встроенным принтером чеков, то печать чеков может осуществляться самой кассой.

Чек печатает GBS.Market

Если касса - это программное решение, то печать чеков (и других документов) может выполняться средствами GBS.Market на подключенном принтере чеков.

Чек печатает "Модуль коммуникации"

Печать чеков может быть реализована на стороне "Модуля коммуникации".