Outofbox.54-FZ : Файл конфигурации
Все доступные для изменения параметры находятся в файле config.xml. Некоторые параметры можно изменять через веб-интерфейс.
Пример конфигурации:
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<config>
<server>
<url>http://0.0.0.0:8080/</url>
<origin>*</origin>
</server>
<pull>
<url></url>
<period>10</period>
<payment_method>1</payment_method>
<ignore_ssl_errors>false</ignore_ssl_errors>
</pull>
<devices>
<device key="default">
<type>atol</type>
<parameters>
<model>61</model>
<port>3</port>
<baudrate>115200</baudrate>
<VAT>none</VAT>
</parameters>
</device>
</devices>
</config>
Блок server
В этом блоке указывается конфигурация встроенного веб-сервера, на котором будет доступно API и веб-интерфейс.
| Переменная | Описание |
|---|---|
| url |
URI, на котором будет стартовать веб-сервер. Здесь можно указать схему, IP и порт. Ниже указаны примеры с описаниями различных вариантов. Проконсультируйтесь с системным администратором для выбора наиболее подходящего для вас варианта http://0.0.0.0:8080/ – Веб-сервер принимает все соединения со всех сетевых интерфейсов. Доступ к серверу доступен как с локального компьютера через http://localhost:8080/ или http://127.0.0.1:8080/, так и из других компьютеров в сети http://localhost:8080/ или http://127.0.0.1:8080/ – Веб-сервер будет принимать соединения только с локального компьютера, доступ из сети недоступен Если указать https вместо http, то сервер запускается в режиме защищенных подключений. Это бывает необходимо в определенных случаях и требует дополнительных настроек, таких как назначение DNS имени для кассового аппарата и установка https сертификатов. Напишите в службу технической поддержки для уточнения деталей. |
| origin | При указании данного параметра веб-сервер будет добавлять http хидер Allow-Origin для ограничения списка доступных хостов для работы. * означает доступ со всех url |
Блок pull
Настройки конфигурации запроса чеков с удаленного сервера. В данном блоке можно настроить URL удаленного сервера для запроса списка чеков, а также периодичность опроса и другие параметры. Если параметра url пустой, то опрос вообще не начинается и касса работает только с теми чеками, что были переданы ей на фискализацию явными API запросами
| Переменная | Описание |
|---|---|
| url | URL опрашиваемого веб-сервера. Данная ссылка должна отдавать список чеков в соответствии с API для интернет-магазинов |
| period | Период опроса в секундах |
| payment_method | Номер способа оплаты по-умолчанию для чеков с удаленного сервера. Если в чеках не указан явно способ оплаты, то будет использоваться данный. |
| ignore_ssl_errors |
В случае, если API интернет-магазина работает через защищенное соединение https и есть какие-то проблемы с обработкой сертификатов (к примеру, данный сертификат не добавлен в систему), то можно указать здесь true, тогда все ошибки https будут игнорироваться. Внимание! Используйте данную опцию на свой страх и риск! |
Блок devices
Здесь указывается список подключенных к системе устройств. Возможно указывать несколько блоков device с разным key для подключения нескольких устройств.
Внутри блока device следует указать тип устройства и его параметры.
На данный момент поддерживается несколько типов:
mock
Виртуальная ККМ для тестирования без отправки данных куда бы то ни было. Все чеки пишутся в файлы формата txt в каталог receipts.
Обязательных параметров для данного типа нет, поэтому блок parameters может быть пустым.
Данный тип поддерживает эмуляцию ошибок для отладки различных ситуаций.
atol
ККМ от АТОЛ. Поддерживается вся линейка устройств АТОЛ с поддержкой 54-ФЗ
Для данного типа обязательно указывать модель устройства, используемый порт для связи, а также скорость обмена.
Доступные параметры:
| Тип | Описание | Обязателен? |
|---|---|---|
| model |
Модель аппарата АТОЛ. Каждая модель имеет свой уникальный номер. Номер модели можно узнать на странице Поддерживаемые устройства |
Да |
| port | Порт, к которому подключен кассовый аппарат. Указывается в зависимости от типа операционной системы. В среде Windows здесь должна быть цифра, соответствующая номеру COM порта в системе. Например, если ККМ после подключения доступен через COM порт COM11, то в данный параметр следует занести цифру 11 <port>11</port> В среде Linux сюда следует указать строку TTY и записать в параметр port_tty_suffix наименование порта TTY, например: ttyACM0, то есть конфиг должен выглядеть примерно так <port>TTY</port> <port_tty_suffix>ttyACM0</port_tty_suffix> |
Да |
| baudrate | Скорость обмена с ККМ | Да |
| receipt_image_number | Номер изображения в памяти ККМ, которое будет печататься в начале чека | Нет |
| VAT |
Вид налогобложения позиций по-умолчанию. Каждая позиция чека может иметь информацию о виде налогобложения, но для небольших организаций вид налогобожения чеков будет всегда одинаковым. Поэтому для упрощения формата обмена данными по API можно указать вид налогообложения по-умолчанию.
|
Нет |