Передача данных обеспечивается сервисом cashboxservice ("Программная кассовая система «Цифровые Кассы»"). 

Начиная с версии 2.6.279 в чеках возврата и в чеках возврата по чекам продажи доступен возврат нескольких позиций.

Установка сервиса

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

aptitude install cashboxservice

После установки пакета стартует сервис jar-kassa, который работает с токеном СКО для СККО и принимает REST-запросы на порт 22222.

Настройки приложения расположены в /opt/CashboxService/app.properties.

Сертификаты расположены в /root/.avpki/.

Подключение принтера чеков и настройка драйвера

В "ПКС «Цифровые Кассы»" используются следующие типы оплат:

  • 0 – наличная (cash),
  • 1 – безналичная (card),
  • любое другое значение – другая (other).

Подключение принтера чеков и программного "ПКС «Цифровые Кассы»" осуществляется в Сервисном меню через Менеджер оборудования.

Для подключения необходимо последовательно выполнить следующие действия:

  1. Указать принтер чеков или ФР для осуществления печати чеков:

  2. Добавить драйвер "ПКС «Цифровые Кассы»":

  3. Настроить параметры драйвера:
    23-ПКС _Цифровые кассы_. Настройка параметров драйвера.png
    • Номер ФР – порядковый номер ККМ.
    • Принтер – ранее подключенный принтер чеков или ФР для печати документов и отчетов.
    • Порт – порт, на котором работает сервис.
    • Имя пользователя – имя пользователя для доступа к сервису.
    • ПИН-код – пин-код для доступа к сервису.
    • Отправка чека на эл. почту – возможность отправлять чек на адрес покупателя.
      При значении параметра: 
      • выкл (поведение по умолчанию) – чек не отправляется на адрес покупателя,
      • вкл – чек отправляется на адрес покупателя при включенном плагине customerAddress.
    • Оптимизация закрытия чеков – возможность оптимизации закрытия чека.
      При значении параметра: 
      • выкл (поведение по умолчанию) – запрос nextChequeNumber отправляется в ФР дважды: перед закрытием чека и после закрытия,
      • вкл – запрос nextChequeNumber отправляется в ФР только перед закрытием чека.
    • Отправка чеков без адреса электронной почты – возможность отправлять указанные чеки в ПКС «Цифровые Кассы». 
      При значении параметра:
      • Не отправлять (поведение по умолчанию) – отправляются чеки продажи только с адресом покупателя,
      • Отправлять все чеки – отправляются все чеки продажи,
      • Отправлять зеленые чеки – отправляются зеленые чеки.

Для немаркированного весового товара с заданным кодом национального классификатора могут быть применены правила преобразования строки NTIN в GTIN.

Подробнее об этом можно прочитать в разделе "Передача кодов маркировок в ПКС "Цифровые Кассы" (Беларусь)".

Передача реквизитов в ФР 

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

  • для товаров – в таблице tmc в поле paymentobject,
  • для сертификатов – в таблице certificate в поле paymentobject.

Поле paymentobject может принимать следующие значения:

При наличии в чеке более одной позиции с paymentobject=10 будет выведена ошибка «Ошибка ФР: Превышено количество позиций в чеке».

Значение

Описание

0/1/nullТовар
4Услуга
10Платеж (выплата) или Аванс

Аннулирование документов

Для аннулирования чека продажи в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/documentannulation.ini должен быть активирован плагин. Подробнее об этом можно прочитать в разделе "Аннулирование документов". 

Аннулирование возможно при одновременном выполнении следующих условий:

  • документ является чеком продажи,
  • документ является последним в текущей смене.

При аннулировании не последнего документа в смене будет выведена ошибка:

При закрытии сообщения об ошибке аннулирование документа не будет выполнено. 

Возврат чека по UID

В кассовом ПО Artix добавлена возможность поиска документа-основания по UID для возврата по чеку продажи. Подробнее об этом можно прочитать в разделе "Возврат по чеку". 

При закрытии чека UID чека продажи будет записан в поле frdoccopy таблицы Document в БД Documents. 

Заполнение полей в БД Documents таблице Kkm

При закрытии смены в БД Documents таблицу Kkm будут записаны поля:

  • sumprotectedbeg со значением incomeBalance, полученным в ответе на запрос xReport при открытии смены,
  • sumprotectedend со значением incomeBalance, полученным в ответе на запрос xReport при закрытии смены,
  • sumcashbeg со значением cashIn, полученным в ответе на запрос xReport при открытии смены,

  • sumgain со значением вычисленным по формуле:

    sumgain = saleSum – moneyBackSum – rollbackSum

    Значения saleSum, moneyBackSum, rollbackSum получены  в ответе на запрос xReport при закрытии смены,

  • paymentname с возможными значениями:
    • "НАЛИЧНЫМИ",
    • "БЕЗНАЛИЧНЫМИ",
    • "ДРУГОЙ ТИП ОПЛАТЫ".
  • shiftnumkkm со значением reportNumber, полученным в ответе на запрос xReport при открытии смены.
  • No labels