Установка приложения и подключение кассы к магазину

1. Скачайте и запустите файл установки приложения 1С-Битрикс.Кассы (BxDTO) 32-битная версия BxDTO может работать на Windows XP, 7, 8.x, 10, Windows Server 2003, 2012, 2016, 2019.
   
   64-битная версия BxDTO может работать с Windows 7, 8.x, 10 и Windows Server 2012, 2016, 2019, Linux Ubuntu 18, Centos 7. .
   Важно! Приложение 1С-Битрикс.Кассы (BxDTO) версии 2.x использует новое поколение драйверов АТОЛ - ДККТ10 (вместо DTO9), реализована поддержка ФФД 1.05 и ФФД 1.1.
   Для работы новой версии требуется обновление модуля sale до версии 18.5.7 или выше.

2. Выполните установку вместе с простыми указаниями мастера .
3. Откройте папку C:\Program Files\BxDTO\bin (если использовался путь установки по умолчанию). Под Linux папка /usr/bin/BxDTO-from-svc.sh.SAMPLE.
4. Переименуйте BxDTO-from-svc.bat.SAMPLE в BxDTO-from-svc.bat.
5. Теперь нужно изменить и запустить файл BxDTO-from-svc.bat.
   Файл с расширением .bat (пакетный файл) — текстовый файл, содержащий последовательность команд, предназначенных для исполнения командным интерпретатором. Командный интерпретатор — интерпретатор команд операционной системы, обеспечивающий интерфейс для взаимодействия пользователя с функциями системы. При открытии такого файла будут автоматически выполнены все перечисленные в файле команды.

   Изначально файл под Windows выглядит так:

   echo Start >> bxdto-svc.log
   start BxDTO.exe --worker --kkm-port 3 --print --name "Fprint22" --log
   start BxDTO.exe --dispatcher --url http://192.168.2.3/bitrix/tools/sale_check_print.php?hash=2b0a11437fe3439d55f55c93c22f8129 --name "Fprint22" --log

   Файл под Linux выглядит так:

   #!/bin/bash
   
   nohup /usr/bin/BxDTO --worker --print --name "Fprint22" --log &
   nohup /usr/bin/BxDTO --dispatcher --url http://192.168.2.3/bitrix/tools/sale_check_print.php?hash=2b0a11437fe3439d55f55c93c22f8129 --name "Fprint22" --log &
   

   При открытии файла запускаются два экземпляра процесса BxDTO в разных режимах: dispatcher и worker:

   • dispatcher взаимодействует с сайтом магазина, направляя полученные чеки в очередь на печать;
   • worker взаимодействует с ККТ, беря из очереди чеки, направленные на печать заданной (при формировании чека на сайте) ККМ.

   Команды и параметры в файле

   С помощью перечисленных в файле команд запускаются два экземпляра процесса 1С-Битрикс.Кассы в разных режимах dispatcher и worker: Команды и параметры dispatcher Взаимодействует с сайтом магазина, направляет полученные чеки в очередь на печать. worker Взаимодействует с ККТ, берёт из очереди чеки, направленные на печать заданной (при формировании чека на сайте) ККМ. name Произвольный (в кодировке ASCII), передаётся на сервер вместе с другими параметрами подключенных касс, кроме того имя используется для разделения протоколов работы (логов) разных процессов. Каждая ККМ имеет уникальный заводской серийный номер, он автоматически считывается worker-процессами с подключенных ККМ и передаётся на сервер dispatcher-процессом. Именно заводской номер ККМ используется для идентификации ККМ при передаче чека на обработку в заданную ККМ. --mq имя_очереди Если использовать этот параметр, то очередей тоже может быть несколько. В каждой очереди может быть свой dispatcher-процесс со своим URL и worker-процессы со своим набором ККМ. Соответственно в BxDTO-from-svc.bat может быть произвольное число строк start BxDTO. kkm-port Указание порта, к которому подключена ККМ --kkm-usb VID:PID (для Linux версии) Используется в версии под Linux вместо --kkm-port, если /dev/ttyACM* возвращают ошибку "порт занят". Так называемый "чистый usb". Для поиска VID:PID USB-порта, на котором подключилась касса, надо в linux-консоли запустить lsusb. Пример вывода: Bus 001 Device 005: ID 0c45:64ad Microdia Bus 001 Device 004: ID 0bda:0129 Realtek Semiconductor Corp. RTS5129 Card Reader Controller Bus 001 Device 012: ID 0cf3:0036 Atheros Communications, Inc. Bus 001 Device 013: ID 24ae:2000 Bus 001 Device 002: ID 8087:8000 Intel Corp. Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub Bus 003 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub Bus 002 Device 003: ID 2912:0005 Bus 002 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub Предпоследнее устройство с ID 2912:0005 (безымянное) - это как раз АТОЛ (у всех атоловских устройств должно быть 0x2912, а PID может отличаться). В опциях воркера BxDTO так и пишем: --kkm-usb 2912:0005. При поиске проблем пригодятся логи атоловских драйверов: ~/.atol/drivers9/logs. print Опция указанная в worker-процессе конкретной ККМ включает печать всех полученных чеков. Без этой опции чеки записываются во внутренний ФН в ККМ и визуально их контролируются по сайту магазина (где по обработанным чекам должны появляться правильные данные для QR-кодов, если ККМ фискализирована), по сайту ОФД, а также копии чеков будут отправляться на E-mail покупателей. log Включает логирование в C:\ProgramData\Bitrix\BxDTO\1.0 в подкаталоге \log. Там же в подкаталоге \db или db/<очередь> находятся базы данных очередей. url URL сайта магазина, с которого будут приниматься чеки insecure Позволяющая отключать проверку сертификата сервера, которая с версии 1.1.18 включена по умолчанию. watchdog Dispatcher и worker с этой опцией будут обновлять watchdog в своих циклах, а служба BxDTO-svc мониторить их и останавливаться в случае, если хотя бы один watchdog устарел. Если в диспетчере служб Windows настроить BxDTO-svc на автоматический перезапуск при сбоях, то при аварийных завершениях или зависаниях dispatcher'а или worker'а служба BxDTO-svc будет перезапускаться и перезапускать BxDTO-from-svc.bat. kkm-protocol 2 Позволяет переключить BxDTO в режим совместимости со старой версией протокола АТОЛ.

   Измените номер COM-порта на соответствующий для вашей ККМ (тот, который указывали на этапе проверки связи с ККТ). ККМ может быть подключено несколько, на разных COM-портах или разных сетевых размещениях (IP, работа по VLAN), в этом случае должно быть запущено несколько worker-процессов, по одному для каждого порта:

   echo Start >> bxdto-svc.log
   start BxDTO.exe --worker --kkm-port 3 --print --name "Fprint22" --log
   start BxDTO.exe --worker --kkm-port 7 --name "Atol42FS" --log
   start BxDTO.exe --worker --kkm-ip-port 5555 --kkm-ip-addr 192.168.2.125 --name "Fprint22net" --print --log 
   start BxDTO.exe --dispatcher --url http://192.168.2.3/bitrix/tools/sale_check_print.php?hash=2b0a11437fe3439d55f55c93c22f8129 --name "Fprint22" --log
   

   Примечание: Если --kkm-port не указывать, то драйвер самостоятельно найдет порт ККМ, подключенной по USB. При подключении ККМ через Ethernet нужно указать IP-адрес и номер TCP-порта ККМ в параметрах --kkm-ip-addr, --kkm-ip-port.
   
   Для одного юридического лица, имеющего на одной лицензии два интернет-магазина, можно настроить одну кассу Технически BxDTO может печатать на одной кассе чеки с двух магазинов. Нужно указать два процесса dispatcher с ссылками на два магазина. . Однако, вы должны уточнить юридическую сторону данного вопроса у вашего бухгалтера или юриста. Возможно, потребуется отдельная касса на каждый магазин.
   Для двух юр. лиц нужно ставить две кассы и настраивать их работу через ограничения (чтобы одна касса не брала чеки второй).

   Измените URL сайта магазина, с которого будут приниматься чеки. Для этого:

   • Откройте административный раздел вашего сайта.
   • Нажмите кнопку Подключить ККМ к интернет-магазину , расположенную внизу страницы Магазин > Кассы , либо нажмите кнопку Сгенерировать ссылку (Магазин > Кассы > Список касс).
   • Вставьте ваш URL в файле.

   Если Вы хотите работать только с электронными чеками (без печати физических чеков) – удалите опцию --print Если ККМ поддерживает печать на чековой ленте и указана опция --print в worker-процессе этой ККМ, то все полученные чеки должны распечатываться. Без опции --print чеки записываются во внутренний ФН в ККМ. Визуально контролируйте их по сайту магазина (где по обработанным чекам должны появляться правильные данные для QR-кодов, если ККМ фискализирована) и по сайту ОФД. Копии чеков также отправляются на E-mail покупателей.
   
   Подробнее... . Электронные чеки будут отправляться клиенту и в ФНС Данные будут отправляться в Федеральную налоговую службу (ФНС) через оператора фискальных данных (ОФД). , но физически печататься не будут.

   Сохраните изменения в файле (под Linux после редактирования файла выполните chmod +x BxDTO-from-svc.sh).

   Примечание: если файл не сохраняется и выводится сообщение «Отказано в доступе», то сохраните его в папку «Документы» или на рабочий стол, а затем скопируйте в нужное расположение (по умолчанию C:\Program Files\BxDTO\bin), так как система защищает "Program Files" от изменений.

6. Откройте файл BxDTO-from-svc.bat (под Linux запустите отредактированный файл BxDTO-from-svc.bat на выполнение). Появятся консольные окна по числу настроенных в bat-файле процессов.
   
   Если в этих окнах нет сообщений об ошибках, то в административном разделе сайта появится список подключенных касс ( Магазин > Кассы > Список касс):
   
   

Итак, Вы установили приложение и подключили кассу. Изучите следующий урок В уроке описаны следующие процессы:

- Настройка кассы;

- Запуск в режиме системной службы;

- Мониторинг работы приложения и кассы;

- Совместное использование BxDTO и других ККТ-программ.

Подробнее... и настройте кассу (а также можете переключить работу BxDTO в режим системной службы, чтобы все процессы, которые настроены в BxDTO-from-svc.bat, запускались автоматически и без видимых окон).

  Документация по теме

• Список касс