Конфигурирование модуля ЕГАИС

Обращение к серверам ЕГАИС для передачи информации об обороте алкогольной продукции осуществляется через транспортный модуль.

Подключение транспортного модуля Egais возможно при наличии идентификатора модуля, данных о размещении плагина и других параметрах. Для указания параметров транспортного модуля необходимо создать файл с расширением .xml, например, egais.xml, в директории /linuxcash/cash/conf/plugins.

...

Egais

...

Уникальное наименование модуля

...

Конфигурирование модуля ЕГАИС

Обращение к серверам ЕГАИС для передачи информации об обороте алкогольной продукции осуществляется через транспортный модуль.

Подключение транспортного модуля Egais возможно при наличии идентификатора модуля, данных о размещении плагина и других параметрах. Для указания параметров транспортного модуля необходимо создать файл с расширением .xml, например, egais.xml, в директории /linuxcash/cash/conf/plugins.

<objects>
    <object id="Egais" plugin="/linuxcash/cash/plugins/libEgais.so

...

Полный путь до плагина

...

<objects>
    <object id="Egais" plugin="/linuxcash/cash/plugins/libEgais.so" >" >
        <property name="address">
           <value>http://127.0.0.1:58080/xml</value>
        <property name="address">
           <value>http://127.0.0.1:8082/xml</value>
       <</property>
		<property name="addressNonExcise">
           <value>http://127.0.0.1:8084/xml</value>
       </property>
       <property name="timeout">
          <value>30</value>
       </property>
    </object>
</objects>

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

Настройка модуля ЕГАИС

...

...

• true
• false

...

...
<property name="address">
<value>http://127.0.0.1:58080/xml?type=ChequeV3</value>
</property>
...

...
<property name="address">
<value>http://127.0.0.1:58080/xml?type=ChequeV4</value>
</property>
...

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

Настройка модуля ЕГАИС

Параметры взаимодействия с модулем УТМ задаются в конфигурационном файле /linuxcash/cash/conf/ncash.ini в секции [EGAIS]:

[EGAIS]
; Настройки плагина ЕГАИС

; Включение проверки ЕГАИС
; По умолчанию false
;enable = false

; Маска для проверки штрих-кода Pdf417 акцизной марки
; По умолчанию "([1-9]\d{2}|\d([1-9]\d|\d[1-9])){2}([1-9]\d{7}|\d([1-9]\d{6}|\d([1-9]\d{5}|\d([1-9]\d{4}|\d([1-9]\d{3}|\d([1-9]\d{2}|\d([1-9]\d|\d[1-9])))))))(0[1-9]|1[0-2])(1[8-9]|[2-9][0-9])([1-9]\d{2}|\d([1-9]\d|\d[1-9]))[0-9A-Z]{129}|\d\d[a-zA-Z0-9]{21}\d[0-1]\d[0-3]\d{10}[a-zA-Z0-9]{31}|[0-9]{40}"
;barcodeMask = "([1-9]\d{2}|\d([1-9]\d|\d[1-9])){2}([1-9]\d{7}|\d([1-9]\d{6}|\d([1-9]\d{5}|\d([1-9]\d{4}|\d([1-9]\d{3}|\d([1-9]\d{2}|\d([1-9]\d|\d[1-9])))))))(0[1-9]|1[0-2])(1[8-9]|[2-9][0-9])([1-9]\d{2}|\d([1-9]\d|\d[1-9]))[0-9A-Z]{129}|\d\d[a-zA-Z0-9]{21}\d[0-1]\d[0-3]\d{10}[a-zA-Z0-9]{31}|[0-9]{40}"
 
; Включить сканирование доп. штрих-кода DataMatrix
; По умолчанию false
; enableAdditionalBarcode = false

; Маска для проверки штрих-кода DataMatrix акцизной марки
; По умолчанию "^(1[0-9]{2}-[0-9]{30}|2[0-9]{2}-[0-9]{29}|0000000)$"
; additionalBarcodeMask = "^(1[0-9]{2}-[0-9]{30}|2[0-9]{2}-[0-9]{29}|0000000)$
 
; Проверять алкокод акцизной марки
; По умолчанию false
; checkAlcoCode = false
  
;Отправлять в качестве номеров документа и кассы значения из ФН
; По умолчанию true
; sendFnInfo = true

; Контролировать АМ при инвентаризации
; По умолчанию false
; useExciseMarkInInventory = false

Использование УТМ активируется параметром enable:

• при значении true модуль ЕГАИС включен;,
• при значении false модуль ЕГАИС отключен.

В целях дополнительного контроля может быть использован дополнительный штрих-код акцизной марки (DataMatrix). Необходимость сканирования дополнительного штрих-кода акцизной марки задается параметром enableAddtitionalBarcode:

• при значении true программа программа запрашивает сканирование дополнительного штрих-кода акцизной кода акцизной марки после того, как считана акцизная марка;
• при значении false считывание дополнительного штрих-кода акцизной марки не требуется.

...

При продаже и возврате алкогольной продукции доступна проверка алкокода акцизной марки в БД Dictionaries таблице Alcocode. Для проверки алкокода в БД используется параметр checkAlcoCode:

• при значении true выполняется проверка наличия алкокода акцизной марки. При отсутствии данных товар не может быть реализован,  на на экран выводится сообщение "Данная продукция недопустима к продаже";
• при значении false наличие алкокода акцизной марки не проверяется.

Данные алкокода записываются в товарную позицию в БД Documents таблицу goodsitem Goodsitem.

Согласно требованиям законодательства определен перечень сведений передаваемых в ЕГАИС:

• в реквизите номер кассы передавать реквизит (ФН) – номер фискального накопителя;,
• в реквизите номер чека передавать № ФД – номер фискального документа.

Выбор реквизитов документа для отправки в ЕГАИС определяется параметром sendFnInfo:

• при значении true номер номер фискального документа и номер фискального накопителя;,
• при значении false программный номер документа и серийный номер ФР.

Инвентаризация алкогольной продукции может проводиться как для простого учета товаров, так и для ведения в БД кассовой программы списка акцизных марок, разрешенных к продаже. Порядок проведения инвентаризации алкогольной продукции определяется параметром useExciseMarkInInventory в конфигурационном файле /linuxcash/cash/conf/ncash.ini в секции [EGAIS].:

• при значении true работа с алкогольным товаром осуществляется аналогично операциям в чеке продажи: при добавлении и сторнировании товара требуется считывание штрих-кода акцизной марки, запрещено применение модификаторов количества;модификатора "Количество",
• при значении false порядок добавления и сторнирования акцизного алкоголя аналогичен работе с обычными товарами.

При закрытии документа инвентаризации в БД Dictionaries в таблице excisemarkwhite таблице Excisemarkwhite для каждой акцизной позиции создается запись, в которой указывается пара штрих-код товара и акцизная марка. По полученному в результате инвентаризации "белому" списку будет производиться проверка акцизных марок при продаже алкоголя.

...

При переходе к версии протокола ЕГАИС 3.0 может возникнуть потребность осуществлять разные проверки для разных масок акцизных марок, например, для "старых" акцизных марок проверять наличие алкокода, а для "новых" - – проверять "белый список". В этом случае для каждой маски акцизной марки создается отдельная секция в секции [EGAIS] в параметре barcodeMask указываются все маски акцизных марок, а в секциях [EGAIS.N] (где N - – номер по порядку) , в которой указываются правила поведения. указывается параметр barcodeMask с необходимой маской акцизной марки и набором настроек, которые будут применены к акцизным маркам данного вида. Таким образом применение настроек для каждой секции зависит от вида акцизной марки.

Возможность выделения параметра в отдельную секцию указана в таблице:

...

Пример разделения настроек приведен ниже:

[EGAIS]
;
; Настройки плагина ЕГАИС
;

; Включение проверки ЕГАИС
; По умолчанию false
enable = true

; Отправлять в качестве номеров документа и кассы значения из ФН
; По умолчанию true
;sendFnInfo = true

; Контролировать АМ при инвентаризации
; По умолчанию false
;useExciseMarkInInventory = false

; Отправлять чек в ЕГАИС перед безналичной оплатой
; По умолчанию false
;sendEgaisBeforeCashlessPayment = false
 
[EGAIS.1]
; Маска для проверки штрих-кода Pdf417 акцизной марки
barcodeMask = "\d\d[a-zA-Z0-9]{21}\d[0-1]\d[0-3]\d{10}[a-zA-Z0-9]{31}"

; Включить сканирование доп штрих-кода DataMatrix
; По умолчанию false
enableAdditionalBarcode = true

; Маска для проверки штрих-кода DataMatrix акцизной марки
; По умолчанию "^(1[0-9]{2}-[0-9]{30}|2[0-9]{2}-[0-9]{29}|0000000)$"
additionalBarcodeMask = "^(1[0-9]{2}-[0-9]{30}|2[0-9]{2}-[0-9]{29}|0000000)$"

; Проверять алкокод акцизной марки
; По умолчанию false
;checkAlcoCode = false

; Проверять соответствие алкокода акцизной марки коду товара
; По умолчанию false
;checkTmcAlcoCode = false

; Проверять акцизные марки на кассе
; По умолчанию false
enableExciseMarkVerifyLocal = true

; Проверять акцизные марки на сервере
; По умолчанию false
;enableExciseMarkVerify = false

; URL сервера проверки акцизных марок
; Для работы с КС используется следующий URL "http://'IP-адрес КС':8080/CSrest/rest/sales/exciseMark/status"
; По умолчанию http://localhost:8080
;exciseMarkVerifyUrl = "http://localhost:8080"

; Таймаут обращения к серверу проверки акцизных марок в секундах
; По умолчанию 30
;exciseMarkVerifyTimeout = 30

; Игнорировать ошибки обращения к серверу проверки акцизных марок
; По умолчанию true
;ignoreExciseMarkVerifyErrors = true
 
[EGAIS.2]
; Маска для проверки штрих-кода Pdf417 акцизной марки
barcodeMask = "[a-zA-Z0-9]{150}"

; Включить сканирование доп штрих-кода DataMatrix
; По умолчанию false
;enableAdditionalBarcode = false

; Маска для проверки штрих-кода DataMatrix акцизной марки
; По умолчанию "^(1[0-9]{2}-[0-9]{30}|2[0-9]{2}-[0-9]{29}|0000000)$"
;additionalBarcodeMask = "^(1[0-9]{2}-[0-9]{30}|2[0-9]{2}-[0-9]{29}|0000000)$"

; Проверять алкокод акцизной марки
; По умолчанию false
;checkAlcoCode = false

; Проверять соответствие алкокода акцизной марки коду товара
; По умолчанию false
;checkTmcAlcoCode = false

; Проверять акцизные марки на кассе
; По умолчанию false
;enableExciseMarkVerifyLocal = false

; Проверять акцизные марки на сервере
; По умолчанию false
enableExciseMarkVerify = true

; URL сервера проверки акцизных марок
; Для работы с КС используется следующий URL "http://'IP-адрес КС':8080/CSrest/rest/sales/exciseMark/status"
; По умолчанию http://localhost:8080
exciseMarkVerifyUrl = "http://192.169.1.100:8080"

; Таймаут обращения к серверу проверки акцизных марок в секундах
; По умолчанию 30
exciseMarkVerifyTimeout = 30

; Игнорировать ошибки обращения к серверу проверки акцизных марок
; По умолчанию true
ignoreExciseMarkVerifyErrors = false

...

При обращении к транспортному модулю ЕГАИС модулю ЕГАИС касса передает дополнительные параметры для идентификации торгового объекта:  ИННИНН, КПП,  адресадрес,  наименованиенаименование.  Параметры Параметры идентификации торгового объекта задаются в БД или конфигурационном файле  Dictionaries таблицы Shop или конфигурационном файле /linuxcash/cash/conf/ncash.ini в секции [Shop].

Источник настроек магазина (ИНН, КПП, адрес, название) определяется параметром paramsSource, который задается в конфигурационном файле /linuxcash/cash/conf/ncash.ini в в секции [Shop].При загрузке кассы значение inn, kpp, address транспортный модуль ЕГАИС получает из базы данных :

• при значении default настройки магазина будут получены из БД кассы, при их отсутствии будут использованы данные

...

• из

...

• файла ncash.ini:
  
  • при продаже алкогольной продукции через 1 транспортный модуль атрибуты магазина могут быть заданы на кассе или на КС
  ;
  • ,
  • при продаже алкогольных товаров через 2 УТМ атрибуты магазина задаются только на КС,
• при значении db настройки магазина будут получены из БД кассы,
• при значении config настройки магазина будут получены из конфигурационного файла /linuxcash/cash/conf/ncash.

...

• ini.

[Shop]
; Настройки магазина

; Источник настроек магазина (ИНН, КПП, адрес, название)
; default – по умолчанию, база данных и конфигурационный файл
; db – база данных
; config – конфигурационный файл
;paramsSource = default

; ИНН магазина
; По умолчанию ""
;inn = "1111111111"
 
; КПП магазина
; По умолчанию ""
;kpp = "111111111"
 
; Адрес магазина
; По умолчанию ""
;address = "Барнаул, прул. Калинина,116/44"
 
; Название магазина
; По умолчанию ""
;name = "Ритейл Сервис"

Печать информации из ЕГАИС на чеке выполняется на основании шаблона egais.xml. 

<?xml version="1.0" encoding="UTF-8"?>
<!-- Шаблон чека ЕГАИС.-->
<report name = "egais" type="document" cached="true" title="Чек продажи ЕГАИС">
<br/><text align="center" fillsymbol=" " maxwidth="all">$shop.name$</text><br/>
<text align="left" fillsymbol=" " maxwidth="all">ИНН: $shop.inn$</text>
<text align="centerright" fillsymbol=" " maxwidth="all">$shop.name$<>КПП: $shop.kpp$</text><br/>
<text align="left" fillsymbol=" " maxwidth="all">ИНН>КАССА: $shop$cash.inn$<code$</text>
<text align="right" fillsymbol=" " maxwidth="all">КПП>СМЕНА: $shop$shift.kpp$<num$</text><br/>
<text align="left" fillsymbol=" " maxwidth="all">КАССА>ЧЕК: $cash$document.code$<num$</text>
<text align="right" fillsymbol=" " maxwidth="all">СМЕНА: $shift.num$</text><br/>
<text align="left" fillsymbol=" " maxwidth="all">ЧЕК: $document.num$</text>
<text align="right" fillsymbol=" " maxwidth="all">ДАТА: </text>
<var name="time_beg" dateformat="d2-mm-yyyy hh:mi"/><br/><br/>
<printer op="barcode" type="QR" barcode='$url_egais$'/><br/><br/>
<extvar name="url_egais" width="-1" quoted="false"/><br/>
<extvar name="signature_egais" width="-1" quoted="false"/><br/><br/>   
</report>

Продажа алкогольной продукции

При формировании чека для отправки в ЕГАИС указывается дата и время добавления первой алкогольной позиции.

Программа запрещает добавление товара в чек, если акцизная марка этого товара была зарегистрирована ранее или товар с такой акцизной маркой был продан. 

Товары с акцизной маркой

Для регистрации продажи алкогольного товара с акцизной маркой в ЕГАИС в свойствах товара устанавливается признак "Необходима регистрация в ЕГАИС". Опционально для алкогольной продукции указывается объем. Указание данных признаков поддерживают форматы AIF и дополнение формата Штрих-М.

Каждая акцизная марка имеет уникальный двумерный штрих-код, поэтому количество товаров с акцизной маркой в товарной позиции изменять нельзя, оно может равняться только 1 при выполнении любых кассовых операций.

Добавление акцизного алкоголя

...

">ДАТА: </text>
<var name="time_beg" dateformat="d2-mm-yyyy hh:mi"/><br/><br/>
<printer op="barcode" type="QR" barcode='$url_egais$'/><br/><br/>
<extvar name="url_egais" width="-1" quoted="false"/><br/>
<extvar name="signature_egais" width="-1" quoted="false"/><br/><br/>   
</report>

Продажа алкогольной продукции

При формировании чека для отправки в ЕГАИС указывается дата и время добавления первой алкогольной позиции.

Программа запрещает добавление товара в чек, если акцизная марка этого товара была зарегистрирована ранее или товар с такой акцизной маркой был продан. 

Товары с акцизной маркой

Для регистрации продажи алкогольного товара с акцизной маркой в ЕГАИС в свойствах товара устанавливается признак "Необходима регистрация в ЕГАИС". Опционально для алкогольной продукции указывается объем. Указание данных признаков поддерживают форматы AIF и дополнение формата Штрих-М.

Каждая акцизная марка имеет уникальный двумерный штрих-код, поэтому в товарной позиции может быть не более 1 единицы товара. Применение модификатора "Количество" к позиции с маркированным товаром запрещено.

Добавление акцизного алкоголя

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

...

1. Последовательным сканированием штрих-кода товара и штрих-кода акцизной марки.
2. Сканированием штрих-кода акцизной марки. При добавлении товара проверяется наличие акцизной марки в "белом" списке:
   
   • если акцизная марка найдена в списке, то товар добавится в чек,
   • если для акцизной марки найдено несколько штрих-кодов товара, то на экран будет выведено сообщение "Акцизной марке соответствует несколько штрих-кодов. Сканируйте штрих-код":
     • при сканировании верного штрих-кода товара, товар добавляется в чек продажи,
     • при сканировании несоответствующего штрих-кода товара, на экран будет выведена ошибка "Штрих-код '<отсканированный_штрих_код>' не соответствует акцизной марке", товар в чек не добавляется,
   • если акцизная марка не найдена в списке, то на экран будет выведена ошибка "По акцизной марке товар не найден. Сканируйте штрих-код", товар в чек не добавится. Товар можно добавить в чек по последовательному считыванию штрих-кода товара и штрих-кода акцизной марки.
3. Последовательным сканированием штрих-кода товара и штрих-кода акцизной марки.
4. Сканированием штрих-кода акцизной марки (настраивается с помощью правил разбора штрих-кода). При добавлении товара проверяется наличие акцизной марки в "белом" списке:
   
   • если акцизная марка разрешена к продаже, то товар добавится в чек;
   • если акцизная марка не найдена в списке, то на экран будет выведена ошибка "По акцизной марке товар не найден. Сканируйте штрих-код", товар в чек не добавится. Товар можно добавить в чек по последовательному считыванию штрих-кода товара и штрих-кода акцизной марки.
5. Последовательным сканированием штрих-кода товара и вводом серийного номера акцизной марки, если штрих-код акцизной марки поврежден.

...

1. вводом серийного номера акцизной марки, если штрих-код акцизной марки поврежден.

Возможность добавления алкогольной продукции по серийному номеру в чек задается параметром useSerialNumber в конфигурационном файле /linuxcash/cash/conf/ncash.ini в секции [EGAIS]:

• при значении параметра true в диалоге сканирования акцизной марки будет осуществлена возможность добавления алкогольной продукции по серийному номеру,
  
• при значении параметра false при добавлении товара в чек на экран будет выведен диалог сканирования акцизной марки.

При вводе серийного номера происходит запрос к БД Dictionaries таблице Excisemarkwhite для осуществления поиска акцизной марки по серийному номеру и типу акцизной марки "ALCOHOL":

• если марка найдена, то в чек добавляется первый найденный товар по введенному серийному номеру,
• если марка не найдена, то на экран будет выведено диалоговое окно "Акцизная марка не найдена. Введите серийный номер акцизной марки". Товар не будет добавлен в чек при отказе от операции.

Кассовое ПО Artix позволяет запрещать добавление алкогольной продукции в чек последовательным сканированием штрих-кода товара и штрих-кода акцизной марки. Способ добавления алкоголя в чек, определяется параметром addAlcoholOnlyByExciseMark, который задается в конфигурационном файле /linuxcash/cash/conf/ncash.ini в секции  в секции [EGAIS]:

...

:

• при значении параметра false при добавлении товара в чек на экран будет выведен диалог сканирования акцизной марки.

При вводе серийного номера происходит запрос к БД Dictionaries таблице Excisemarkwhite для осуществления поиска акцизной марки по серийному номеру и типу акцизной марки "ALCOHOL":

• если марка найдена, то в чек добавляется первый найденный товар по введенному серийному номеру;
• если марка не найдена, то на экран будет выведено диалоговое окно "Акцизная марка не найдена. Введите серийный номер акцизной марки". Товар не будет добавлен в чек при отказе от операции.

...

• true добавление алкогольных товаров в чек может быть осуществлено только сканированием штрих-кода акцизной марки. При добавлении алкоголя последовательным сканированием штрих-кода товара и штрих-кода акцизной марки на экран будет выведено предупреждение "Алкоголь разрешено добавлять только по акцизной марке",
• при значении параметра false добавление алкогольных товаров в чек может быть осуществлено любым способом, описанным выше. 

В кассовом ПО Artix реализована проверка доступности сервера ЕГАИС при добавлении алкогольной продукции в чек продажи/возврата или при выборе алкогольной позиции в чеке возврата по чеку продажи. Проверка регулируется параметром checkEgaisAvailableBeforeAddPosition в конфигурационном файле /linuxcash/cash/conf/ncash.ini в секции  в секции [EGAIS]:

• при значении параметра true добавление алкогольных товаров в чек может быть осуществлено только сканированием штрих-кода акцизной марки. При добавлении алкоголя последовательным сканированием штрих-кода товара и штрих-кода акцизной марки на экран будет выведено предупреждение "Алкоголь разрешено добавлять только по акцизной марке".
• при значении параметра false добавление алкогольных товаров в чек может быть осуществлено любым способом, описанным выше. 

...

• :
  • если сервер недоступен, то на экран будет выведено предупреждение "Сервер ЕГАИС недоступен",
  • если сервер доступен, то алкогольная продукция будет добавлена в чек.
    
• при значении параметра false:
  • если сервер недоступен, то при закрытии чека на экран будет выведена ошибка "Ошибка соединения с сервером ЕГАИС. Сторнируйте алкогольную продукцию",
  • если сервер доступен, то алкогольная продукция будет добавлена в чек.

Кассовое ПО Artix позволяет устанавливать для алкогольной продукции минимальную розничную цену равную цене товара, если МРЦ не задана, регулируется параметром setMinRetailPrice в конфигурационном файле /linuxcash/cash/conf/ncash.ini в секции [EGAIS]:

• при значении параметра true:
  • если сервер недоступен, то на экран будет выведено предупреждение "Сервер ЕГАИС недоступен";
  • если сервер доступен, то алкогольная продукция будет добавлена в чек;
    
  при значении параметра false:
• если сервер недоступен, то при закрытии чека на экран будет выведена ошибка "Ошибка соединения с сервером ЕГАИС. Сторнируйте алкогольную продукцию";
если сервер доступен, то алкогольная продукция будет добавлена в чек если для алкогольной продукции минимальная розничная цена не задана, то МРЦ будет равна цене товара,
• при значении false для алкогольной продукции будет использоваться минимальная розничная цена, заданная в БД или равная значению параметра minRetailPrice.

[EGAIS]
...
; Использовать серийный номер для получения акцизной марки из БД
; По умолчанию false
;useSerialNumber = false
 
; Добавлять алкоголь только по акцизной марке
; По умолчанию false
;addAlcoholOnlyByExciseMark = false

; Проверять доступность ЕГАИС перед добавлением позиции
; По умолчанию false
;checkEgaisAvailableBeforeAddPosition = false

; Устанавливать для позиции минимальную розничную цену равной цене, если минимальная розничная цена не задана
; По умолчанию false
;setMinRetailPrice = false

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

...

Товары без акцизной марки

В целях организации электронного журнала учета алкогольной продукции обеспечена возможность формировать и отправлять в ЕГАИС данные об алкогольной продукции, не имеющей акцизную марку. Данные чека при закрытии передаются на сервер ЕГАИС отдельным запросом. Результаты запроса к серверу ЕГАИС сохраняются в БД и на печать не выводятся.

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

Сторнирование алкогольных товаров осуществляется в основном режиме без запроса на считывание акцизной марки.

...

• при оплате чека наличными обращение к транспортному модулю всегда осуществляется после внесения оплаты и перед регистрацией продажи в фискальном регистраторе;,
• при оплате чека по безналу порядок выполнения действий определяется настройками кассовой программы.

...

• при значении параметра true факт продажи алкогольной продукции будет направлен в ЕГАИС до проведения безналичной оплаты;,
• при значении параметра false факт продажи алкоголя направляется в ЕГАИС после проведения безналичной оплаты. Значение по умолчанию. При добавлением оплаты чека через банковский терминал осуществляется дополнительная проверка доступа к транспортному модулю с целью снижения рисков возникновения ситуации, при которой после оплаты пропадает связь с сервером ЕГАИС. 

[EGAIS]
...
; Отправлять чек в ЕГАИС перед безналичной оплатой. По умолчанию false
; sendEgaisBeforeCashlessPayment = false

...

• если сообщение от ЕГАИС может быть интерпритированно кассой, то оно отобразится на экране кассира;,
• если интерпритация сообщения невозможна, то на экран будет выведена ошибка "Ошибка обращения к ЕГАИС. Сторнируйте алкогольную продукцию".

...

Если проверка завершается неудачей - – закрытие чека блокируется, в этом случае необходимо вернуться к списку товаров и удалить алкогольную продукцию.

При добавлении в чек алкогольного товара, у которого не указан один из обязательных параметров, на экран будет выведено сообщение "Ошибка добавления алкоголя в чек. Не заполнены обязательные поля товара". Такой товар нельзя добавить в чек.

В случае возникновения ошибок при:

...

Отмена продажи алкогольной продукции

Отмена продажи в ЕГАИС отправляется при:

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

Отмена в ЕГАИС регистрируется как возврат.

...

• проверку на факт продажи/возврата алкоголя с акцизной маркой;,
• проверку статуса акцизной марки (зарезервирована, продана и т.д.);,
• проверку акцизной марки в "белом" списке (акцизные марки, разрешенные к продаже).

В соответствии с устройством сети проверка акцизных марок может быть выполнена:

• на кассе и на сервере - – для больших сетей, включающих N-е количество магазинов под управлением кассового сервера;,
• на кассе - – для небольших торговых объектов, не оборудованные кассовыми серверами.

...

• если товар с соотвествующей акцизной маркой не был продан, то его разрешено добавлять в чек продажи;,
• если такой товар был продан, то его разрешено добавлять в чек возврата.

...

Структура сети без кассовых серверов (только кассы)

Помимо проверки акцизных марок в данных о продажах в кассовой программе можно настроить проверку "белого" списка акцизных марок (списка акцизных марок, разрешенных к продаже). "Белый" список акцизных марок может быть сформирован при приемке ТТН на кассе или проведении инвентаризации, а также с помощью сервисов обмена выгружен на кассу из товароучетной системы.

Проверка акцизных марок в "белом" списке в БД кассовой программы задается параметром enableExciseMarkVerifyLocal в конфигурационном файле /linuxcash/cash/conf/ncash.ini в секции [EGAIS]:

• при значении параметра значении параметра true проверка акцизной марки осуществляется в БД Dictionaries в таблице excisemarkwhite Excisemarkwhite:
  при последовательном сканировании штрих-кода товара и штрих-кода акцизной марки:
  
  • если акцизная марка найдена в списке, и штрих-код товара соответствует товара соответствует штрих-коду акцизной марки, то товар добавляется в чек продажи;,
  • если акцизная марка найдена в списке, а штрих-код товара отсутствует, то товар добавляется в чек продажи;,
  • если акцизная если акцизная марка найдена в списке, но штрих-код товара не соответствует штрих-коду акцизной марки, то на экран выводится экран выводится ошибка "Акцизная марка не соответствует штрих-коду", товар в чек не добавляется;,
  • если акцизная марка отсутствует в списке, то на экран выводится ошибка экран выводится ошибка "Товар с такой акцизной маркой запрещен к продаже", товар в чек не добавляется.
  при сканировании штрих-кода акцизной марки:
  • если акцизная марка найдена в списке, то товар добавляется в чек продажи,
  • если для акцизной марки найдено несколько штрих-кодов товара, то на экран будет выведено сообщение "Акцизной марке соответствует несколько штрих-кодов. Сканируйте штрих-код":
    • при сканировании верного штрих-кода товара, товар добавляется в чек продажи
    ;
    • ,
    • при сканировании несоответствующего штрих-кода товара, на экран будет выведена ошибка "Штрих-код '<отсканированный_штрих_код>' не соответствует акцизной марке", товар в чек не добавляется,
  • если акцизная марка отсутствует в списке, то на экран выводится сообщение об ошибке "Товар с такой акцизной маркой запрещен к продаже", товар в чек не добавляется.,
• при значении параметра значении параметра false проверка акцизной марки в "белом" списке не выполняется.

После проверки акцизной марки в "белом" списке настройками программы может быть предусмотрена проверка соответствия алкокода акцизной марки коду товара в БД Dictionaries в таблице tmcalcocode Tmcalcocode. Для проверки используется параметр checkTmcAlcoCode в конфигурационном файле /linuxcash/cash/conf/ncash.ini в секции [EGAIS]:

• при значении параметра значении параметра true:
  • если enableExciseMarkVerifyLocal = false, то алкокод проверяться не будет;,
  • если enableExciseMarkVerifyLocal = true и акцизная марка найдена в "белом" списке, то проверка соответствия кода товара и алкокода не выполняется;,
  • если checkTmcAlcoCode = true и акцизная марка не найдена в "белом" списке, то выполняется проверка соответствия кода товара и алкокода;,
• при значении параметра значении параметра false проверка соответствия кода товара и алкокода выполняться не будет.

В таблице tmcalcocode Tmcalcocode одному коду товара может соответствовать несколько алкокодов.

[EGAIS]
...
  
; Проверять акцизные марки на кассе (по умолчанию false)
; enableExciseMarkVerifyLocal = false
; Проверять соответствие алкокода акцизной марки коду товара
; По умолчанию false
; checkTmcAlcoCode = false

...

Проверка регистрации акцизных марок при продаже/возврате производится по умолчанию в рамках всех смен, данные о которых хранятся на кассе. Кассовое ПО позволяет дополнительно осуществлять контроль продажи/возврата акцизного алкоголя в рамках магазина или торговой сети. Информация о зарегистрированных ранее акцизных марках хранится на сервере торгового предприятия. Проверка акцизных марок на сервере задается при помощи параметра enableExciseMarkVerify:

• при значении параметра параметра true осуществляется осуществляется проверка зарегистрированных акцизных марок на сервере;,
• при значении параметра параметра false контроль акцизных марок в рамках магазина (торговой сети) не производится.

...

• url сервера, где хранятся данные об акцизных марках, - – exciseMarkVerifyUrl;,
• таймаут подключения к серверу - – exciseMarkVerifyTimeout.

Настройками программы можно разрешать или запрещать продажу/возврат акцизного алкоголя при возникновении ошибок обращения к серверу. Возможность игнорирования возникающих ошибок определяется параметром ignoreExciseMarkVerifyErrors:

• при значении параметра параметра true в в случае возникновения ошибок подключения к серверу они игнорируются, продажа/возврат акцизного алкоголя осуществляется без проверки акцизной марки на сервере;при значении параметра false в случае возникновения ошибок подключения к серверу продажа товара не может быть выполнена. На экран кассира выводится сообщение о том, что акцизная марка не может быть проверенаакцизной марки на сервере,
• при значении параметра false в случае возникновения ошибок подключения к серверу продажа товара не может быть выполнена. На экран кассира выводится сообщение о том, что акцизная марка не может быть проверена.

Параметры проверки статусов акцизных марок и их резервирования задаются в задаются в секции EGAIS конфигурационного файла /linuxcash/cash/conf/ncash.ini.

[EGAIS]
...

; Проверять акцизные марки на сервере (по умолчанию false)
; enableExciseMarkVerify = false

; URL сервера проверки акцизных марок (по умолчанию http://localhost:8080)
; exciseMarkVerifyUrl = "http://localhost:8080" 

; Таймаут обращения к серверу проверки акцизных марок в секундах(по умолчанию 30 сек)
; exciseMarkVerifyTimeout =  30

; Игнорировать ошибки обращения к серверу проверки акцизных марок (по умолчанию true)
; ignoreExciseMarkVerifyErrors = true

Статус акцизной марки может принимать следующие значения: 

• 0 - – Марка не зарегистрирована в БД;,
• 1 - – Товар с такой маркой продан;,
• 2 - – Товар с такой маркой возвращен;,
• 3 - – Марка зарезервирована в чеке продажи;,
• 4 - – Марка снята с резерва в чеке продажи;,
• 5 - – Марка зарезервирована в чеке возврата (чеке возврата по чеку продажи);,
• 6 - – Марка снята с резерва в чеке возврата (чеке возврата по чеку продажи);,
• 7 - – Акцизная марка отсутствует в списке разрешенных к продаже;,
• 8 - – Связка кода и алкокода товара отсутствует;,
• 9 - – Товар отсутствует на остатке;,
• 10 - – Штрих-код для проверки в списке в списке акцизных марок, разрешенных к разрешенных к продаже, не передан;,
• 11 - – Соответствие акцизной марки и штрих-кода в списке в списке акцизных марок, разрешенных к разрешенных к продаже,  не не найдено;,
• 12 - – Магазин для проверки остатков не остатков не найден;,
• 13 - – Штрих-код для проверки остатков не заполнен;,
• 14 - – Код товара для проверки остатков не заполнен;,
• 15 - – Справочник остатков для товара, по которому проверяем остатки, заполнен не корректно;,
• Любое другое значение - – неизвестный статус акцизной марки.

...

• получение статуса акцизной марки из данных о продажах;,
• если в данных о продажах акцизная марка не найдена, то выполняется проверка в справочнике статусов акцизных марок;,
• если продажа разрешена или акцизная марка не обнаружена, то проверяется справочник акцизных марок, разрешенных к продаже.

...

• получение статуса акцизной марки из данных о продажах;,
• если в продажах акцизная марка не найдена, то марка проверяется в справочнике статусов акцизных марок;,
• если акцизная марка найдена в справочнике, то на кассу передается статус из справочника;,
• если в справочнике марка не найдена, то на кассу передается справочник из документов продаж.

...

• в режиме онлайн (по REST-запросу) - – резервирование акцизной марки;,
• в режиме оффлайн (через очередь Artix-Queue) - – снятие с резерва акцизной марки (сторнирование), после закрытия чека перевод в статус "продана", "возвращена".

...

Если акцизная марка была поставлена в резерв, т.е. уже была добавлена в чек, то такой товар в чек не может быть добавлен. После осуществления продажи/возврата акцизная марка позиции снимается с резерва и переходит в статус, соответствующий выполненной операции - – продана/возвращена. Снятие резерва с акцизной марки выполняется также при сторнировании товарной позиции из документа. 

...