Просмотров: 25342 (Статистика ведётся с 06.02.2017)
Татьяна Старкова
Сложность урока:
3 уровень - средняя сложность. Необходимо внимание и немного подумать.
1
2
3
4
5
Недоступно в редакциях:
Старт, Стандарт

После того, как драйвера установлены, можно переходить непосредственно к интеграции кассы с магазином.

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

  • Скачайте и запустите файл установки приложения 1С-Битрикс.Кассы (BxDTO).

    Важно! Приложение 1С-Битрикс.Кассы (BxDTO) версии 2.x использует новое поколение драйверов АТОЛ - ДККТ10 (вместо DTO9), реализована поддержка ФФД 1.05 и ФФД 1.1.
    Для работы новой версии требуется обновление модуля sale до версии 18.5.7 или выше.

  • Выполните установку вместе с простыми указаниями мастера:

  • Откройте папку C:\Program Files (x86)\BxDTO\bin (если использовался путь установки по умолчанию). Под Linux папка /usr/bin/BxDTO-from-svc.sh.SAMPLE.
  • Переименуйте BxDTO-from-svc.bat.SAMPLE в BxDTO-from-svc.bat.
  • Откройте файл BxDTO-from-svc.bat на редактирование.

    Примечание: редактор должен быть запущен от имени администратора.

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

    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

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

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

  • Измените номер 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.

    Для одного юридического лица, имеющего на одной лицензии два интернет-магазина, можно настроить одну кассу.
    Для двух юр. лиц нужно ставить две кассы и настраивать их работу через ограничения (чтобы одна касса не брала чеки второй).

    Под 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 &
    
  • Измените URL сайта магазина, с которого будут приниматься чеки. Для этого:
    • Откройте административный раздел вашего сайта.
    • нажмите кнопку Подключить ККМ к интернет-магазину, расположенную внизу страницы Магазин > Кассы ККМ,

      либо

      нажмите кнопку Сгенерировать ссылку, расположенную на странице Магазин > Кассы ККМ > Список касс.
    • Вставьте ваш URL в файле.
    Важно! Технически приложение поддерживает работу с несколькими магазинами на одном ядре. Однако, вы должны уточнить юридическую сторону данного вопроса у вашего бухгалтера или юриста. Возможно, потребуется отдельная касса на каждый магазин.
  • Сохраните изменения в файле.
  • В контекстном меню файла BxDTO-from-svc.bat нажмите Открыть. Появятся консольные окна по числу настроенных в bat-файле процессов.

    Если в этих окнах нет сообщений об ошибках, то в административном разделе сайта появится список подключенных касс ( Магазин > Кассы ККМ > Список касс):

    Нажмите на рисунок, чтобы увеличить

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

Для подключенной через приложение кассы выполните следующие действия:

  • Откройте форму ее редактирования.
  • Установите флаг активности для кассы.
  • Обработчик не меняйте, он должен быть 1С-Битрикс.Кассы.
  • Выберите ОФД, с которым вы заключили договор.

    Если вашего ОФД нет в списке, то выберите значение Другой . Все будет работать корректно, кроме ссылки Посмотреть на странице списка чеков.
  • Введите название кассы.
  • Обязательно укажите марку вашей ККМ (на текущий момент - только Атол).
  • В поле Внешний идентификатор кассы значение устанавливается автоматически при подключении (это номер вашей ККМ).
  • Важно! Не отмечайте опцию Используется офлайн, если касса работает только на интернет-магазин.
    Если касса стоит в оффлайн магазине и также используется для интернет-магазина, то опцию отметьте.Закрывать смену при этом обязательно нужно вручную кассиром в оффлайн магазине. Открытие смены будет выполняться автоматически с первым чеком из интернет-магазина. Если первый чек создается в оффлайн магазине, то смена открывается кассиром вручную.
  • На закладке Ограничения в случае необходимости составьте ограничения по использованию кассы. Ограничения могут быть по компаниям и платежным системам (составляются аналогично ограничениям для служб доставки).
  • Обязательно заполните поле Email . На email, указанный в этом поле, будут приходить уведомления о проблемах с печатью чеков.
  • На закладке Настройки укажите только время закрытия смены и печати z-отчета , остальные параметры устанавливаются автоматически из кассы при подключении.

    Важно! С 1 января 2019 года на территории России изменяется ставка НДС. Поэтому необходимо отредактировать старую ставку 18%, заменив название и значение на 20%. Кроме того, проверьте ставку в настройках кассы. Создавать новую ставку нецелесообразно, поскольку значение ставки придется менять вручную во всех товарах.

    Примечание: не рекомендуется вручную изменять настройки оплат и ставок НДС Значения полей в пункте "Настройки ставок НДС"
    (указана информация на начало 2019г.,
    актуальную информацию смотрите на сайте производителя
    вашего торгового оборудования):

    «none» – без НДС;
    «vat0» – НДС по ставке 0%;
    «vat10» – НДС чека по ставке 10%;
    «vat18» – НДС чека по ставке 18%;
    «vat110» – НДС чека по расчетной ставке 10/110;
    «vat118» – НДС чека по расчетной ставке 18/118;
    «vat20» – НДС чека по ставке 20%;
    «vat120» – НДС чека по расчетной ставке 20/120.

    С 01.02.2019 00:00 при отправке ставки vat18 или
    vat118 в чеках приход и расход сервис будет
    возвращать ошибку IncomingValidationException с
    текстом: "Передана некорректная ставка налога. С
    01.02.2019 ставки НДС 18 и 18/118 не могут
    использоваться в чеках sell(приход) и buy(расход)".
    , это может привести к неправильной работе кассы. Если вам все же нужно откорректировать соответствия ставок и оплат, то:
    • откройте программу Тест драйверов;
    • перейдите к форме Настройка свойств > Параметры оборудования;
    • посмотрите номера ставок НДС на закладке Налоги, а номера оплат - на закладке Оплата;
    • вернитесь в административный раздел сайт и вставьте значения в соответствующие поля оплат и ставок НДС ;

    Обратите внимание, если вы не являетесь плательщиком НДС, то значение ставки Без НДС [0%] должно совпадать со значением Без НДС [по умолчанию].

  • На закладке Настройки ОФД опцию Тестовый режим работы ОФД следует отмечать, если вы приобрели специальную тестовую кассу. Если у вас обычная касса, то в таком случае опция значения не имеет, данные всегда будут уходить в ОФД. Кроме того, для следующих двух ОФД на данной закладке имеется по дополнительному полю:
    • ОФД ЯРУС - в поле Ключ безопасности введите ключ, сгенерированный в личном кабинете ОФД.
    • OFD.RU - в поле ИНН укажите ИНН продавца.
  • Сохраните настройки кассы.

Настройка платежных систем

Обязательно установите флаг Разрешить печать чеков в настройках тех платежных систем, для которых должна выполняться печать чеков.

Если для платежной системы печать чеков выполняться не должна, например, для банковских переводов, то опцию оставьте неотмеченной.

Запуск приложения 1С-Битрикс.Кассы в режиме системной службы

Работу приложения 1С-Битрикс.Кассы можно переключить в режим системной службы. Для этого:

  • Остановите все запущенные процессы (закройте консольные окна).
  • Установите службу BxDTO-svc (запустите C:\Program Files (x86)\BxDTO\bin\install_svc.bat в режиме администратора).
  • Запустите службу BxDTO-svc из диспетчера служб Windows (Панель управления > Администрирование > Службы).

    Примечание: если после запуска файла служба не появилась в списке, попробуйте запустить файл install_svc.bat с помощью командной строки с правами администратора .

В результате запустятся все те же процессы, которые настроены в BxDTO-from-svc.bat, но в режиме служб - без видимых окон. Служба по умолчанию устанавливается в режиме ручного запуска. Если необходимо, чтобы программа 1С-Битрикс.Кассы запускалась при старте Windows, необходимо настроить режим запуска BxDTO-svc в диспетчере служб Windows.
Под Linux для установки службы выполнить в консоли:

systemctl enable bxdto.service
systemctl start bxdto.service

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

Журналы работы служб 1С-Битрикс.Кассы ведутся в каталоге C:\ProgramData\Bitrix\BxDTO\1.0 в подкаталоге log. Там же в подкаталоге db или db/<очередь> находятся базы данных очередей.

Журналы запуска службы bxdto.service под Linux можно получить командой journalctl -u bxdto.service. После запуска службы процессы BxDTO ведут журналы в каталоге /log, если перед запуском не установлен другой текущий каталог. Базы данных очередей в каталоге /db.

При запуске BxDTO не-службой и не-администратором в каталоге установки по умолчанию C:\Program Files (x86)\BxDTO (недоступном для записи без повышения полномочий), журналы работы ведутся в каталоге C:\Users\\AppData\Local\VirtualStore\Program Files (x86)\BxDTO\bin\log либо C:\Users\\AppData\Roaming\Bitrix\BxDTO\1.0\log.

Журналы работы драйверов DTO9 ведутся в каталоге C:\Windows\System32\config\systemprofile\AppData\Roaming\ATOL\drivers9\logs\ (либо C:\Windows\SysWOW64\config\systemprofile\AppData\Roaming\ATOL\drivers9\logs\ в 32-битном варианте) при запуске BxDTO службой либо в C:\Users\\AppData\Roaming\ATOL\drivers9\logs\ при запуске не-службой.

Журналы работы драйверов ДККТ10 ведутся в каталоге C:\Windows\System32\config\systemprofile\AppData\Roaming\ATOL\drivers10\logs\ (либо C:\Windows\SysWOW64\config\systemprofile\AppData\Roaming\ATOL\drivers10\logs\ в 32-битном варианте) при запуске BxDTO службой либо в C:\Users\\AppData\Roaming\ATOL\drivers10\logs\ при запуске не-службой.

Журналы работы службы Ethernet over USB (EoU) ведутся в каталоге C:\ProgramData\ATOL\EoU\logs. Под Linux - в /var/log/EoU.

Со стороны магазина работоспособность конфигурации определяется в административном разделе по списку подключенных ККМ. Если ККМ зарегистрирована в ФНС и настроена на отправку данных в ОФД, то состояние ККМ будет также отображаться на сервере ОФД.

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



1


Курсы разработаны в компании «1С-Битрикс»