Документация для версии POS-Интеллект 5.4. Документация на другие версии также доступна.

Предыдущая страница Описание протокола XML  Контрольный пакет Следующая страница

Данный протокол позволяет производителям кассового ПО добавить возможность сопряжения с системой контроля кассовых операций POS-Интеллект, если данные о кассовых операциях отсылаются в виде XML пакетов. Данный формат позволяет передавать любое количество значимых параметров в систему и удобным образом организовать их отображение на видеоизображении и сохранение в базе транзакций.

XML пакет имеет основной тэг <TransactionBlock>. На каждую кассовую операцию в Интеллект отсылается отдельный xml пакет. Каждый такой пакет должен иметь начальный тег <TransactionBlock> и конечный </TransactionBlock>. Таким образом, каждая операция на кассовом узле имеет свое представление в виде XML пакета. Пример отосланного пакета показан на рисунке.

Все параметры представляются в виде текста. Для чисел можно использовать точку или запятую для отделения дробной части. Преобразования к нужному типу происходят автоматически.

Кассовая программа должна отсылать эти данные на любой TCP, UDP или RS232 порт (указывается в настройках). Для каждой кассы используется отдельный порт.

В случае использования TCP протокола необходимо предусмотреть автоматическое  восстановление связи в случае разрыва.

Обязательные тэги xml-пакета:

  1.   FunctionNumber – номер функции.
  2.  TransactionTimestamp (условно обязательный тег) – время события, заданное в формате yyyy-mm-ddThh:nn:ss.fff. Указывается в часовом поясе UTC+0. Если тэг TransactionTimestamp отсутствует в пакете, в базу данных записывается не время события, а время прихода пакета.
    Использованы следующие обозначения:
    yyyy – год в виде четырехзначного числа.
    mm – месяц, в диапазоне от 01 до 12.
    dd – день месяца, в диапазоне от 01 до 31.
    hh – час в 24-часовом формате от 00 до 23.
    nn – минуты, в диапазоне от 00 до 59.
    ss – секунды, в диапазоне от 00 до 59.
    fff – тысячные доли секунды (миллисекунды) в значении даты и времени.

Элементы XML пакета необходимо обязательно отделять разделителями строк (следующие подряд символы 0xD, 0xA). Это удобнее делать на этапе отладки системы (при использовании утилиты xml_test.exe, см. Конфигурирование файла настроек xml_titles.txt).

Общее число параметров может быть любым. В названии параметров не должно быть пробелов. Приходящие данные отображаются на экране в виде титров и записываются в базу для последующего анализа.

Для настроек служит файл Intellect\Modules\Pos\xml_titles.txt (см. раздел Формат файла настроек xml_titles.txt).

Все полученные данные записываются в таблицы POS_LOG_MASTER и POS_LOG_DETAIL.

По умолчанию база данных чеков называется pos, используется СУБД MS SQL Server 2008.

  • No labels