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 можно указать вид налогообложения по-умолчанию.

  • none – НДС не облагается
  • vat0 – НДС 0%
  • vat10 – НДС 10%
  • vat18 – НДС 18%
Нет
Работает на системе OUTOFBOX.RU