Программный ФР Webkassa поддерживает следующие операции:

• закрытие чеков:
  • продажи,
  • возврата,
  • возврата по чеку продажи,
  • внесения,
  • выема.
• печать отчетов:
  • x-отчет,
  • x-отчет по отделам,
  • z-отчет.

Операции выполняются посредством отправки запросов к удаленному сервису Webkassa.

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

Подключение принтера чеков и настройка драйвера Webkassa осуществляется в Сервисном меню через Менеджер оборудования.

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

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

2. Добавить драйвер Webkasssa:
    

3. Настроить параметры драйвера:
   
   • Номер ФР – порядковый номер ККМ.
   • Принтер – ранее подключенный принтер чеков или ФР для печати документов и отчетов.
   • Адрес – адрес сервиса Webkassa.
   • Таймаут – таймаут ожидания ответа от сервиса Webkassa (в секундах).
   • Логин пользователя из Webkassa – логин для доступа к сервису.
   • Пароль пользователя из Webkassa – пароль для доступа к сервису.
     
   • Уникальный номер кассы – заводской номер кассы.
     
   • Ключ для взаимодействия с сервисом Webkassa – ключ, который передается в запросах к сервису.

Настройка

Настройка соотнесения налогов

Соотнесение налогов осуществляется посредством настройки секции [HW.FR.TaxMapping] в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/fr.ini.

[HW.FR.2.TaxMapping]
; соотнесение налогов
0=1
100=2

Для работы с Webkassa на кассе должны быть добавлены следующие типы налогов (см. БД Dictionaries таблицу Vat поле type):

• 1 – НДС 0%,
• 2 – НДС 12%.

В свойствах товара должен быть указан один из двух налогов (см. БД Dictionaries таблицу Tmc).

Настройка соотнесения типов оплаты

Соотнесение типов оплат осуществляется посредством настройки секции [HW.FR.PayAccordance] в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/fr.ini.

[HW.FR.2.PayAccordance]
; соотнесение типов оплаты
0=1
1=2
4=4

Для работы с Webkassa на кассе должны быть добавлены следующие типы оплат (см. БД Dictionaries таблицу Valut поле type):

• 1 – наличные,
• 2 – банковская карта,
• 4 – мобильные.

Настройка соотнесения отделов

Соотнесение отделов, к которым привязаны товары в кассовой программе и в ФР, осуществляется посредством настройки секции [HW.FR.DepartMapping] в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/fr.ini.

[HW.FR.2.DepartMapping]
; Соотнесение логических и фискальных отделов для ФР
; <Номер отдела ФР> = <Номер отдела в кассе>
1=1
2=2

Настройка соотнесения единиц измерения товара

Соотнесение единиц измерения товаров осуществляется посредством настройки секции [HW.FR.UnitsMapping] в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/fr.ini.

[HW.FR.UnitsMapping]
; соотнесение единиц измерения товара
1=796
3=166

Для работы с Webkassa на кассе должны быть добавлены следующие единицы измерения (см. БД Dictionaries таблицу Units поле code):

• 1 – штуки,
• 3 – килограммы.

Настройка соотнесения символов казахского алфавита

Соотнесение символов казахского алфавита осуществляется посредством настройки секции [HW.FR.SymbolsMapping] в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/fr.ini.

[HW.FR.SymbolsMapping]
;
; Соотнесение символов кодовой страницы Windows-1251 и символов казахского алфавита
; <Символ кодовой страницы Windows-1251 в Unicode> = <Символ казахского алфавита>

; соотнесение символов
408 = Ә
458 = ә
404 = Ғ
454 = ғ
40C = Қ
45C = қ
405 = Ң
455 = ң
490 = Ө
491 = ө
40E = Ұ
45E = ұ
40B = Һ
45B = һ
407 = Ү
457 = ү

Шаблоны документов

Для формирования чеков продажи используется шаблон webkassa_sale.xml, чеков возврата, чеков возврата по чеку продажи – webkassa_back.xml, для чеков внесения – webkassa_moneyin.xml, для чеков выема – webkassa_moneyout.xml,  для x-отчетов – webkassa_xreport.xml, для x-отчетов по отделам – webkassa_xreportdept.xml, для z-отчетов – webkassa_zreport.xml. 

Если в БД сохранены валюты или единицы измерения со значениями кодов, отличными от описанных выше, то для корректной печати чека необходимо внести изменения в шаблоны webkassa_sale.xml, webkassa_back.xml:

• для валюты с соответствующим кодом изменить значение valcode:

  Пример для валюты с кодом 1 - наличные

  <select query="SELECT valcode, 
          sum(moneyitem.sumb) sumb 
          FROM documents.moneyitem WHERE documentid = $document.id$ AND moneyitem.opcode = 70 and valcode = 1 GROUP BY valcode">
      <text align="left">Қолма-қол/Наличные:</text><var align="right" name="sumb" numberformat=".2" maxwidth="all"/><br/>
  </select>

• для кода единицы измерения изменить значение параметра value в условии:

  Пример для единицы измерения с кодом 1 - штуки

  <if var="measure" op="eq" value="1">
      <var name="bquant" numberformat=".0" padding="3"/><text> дана/шт * </text>
  <else/>
      <var name="bquant" numberformat=".3" padding="3"/><text> кг/кг * </text>
  </if>

Подробнее о редактировании шаблонов можно прочитать в разделе "Движок отчетов".

Чеки продажи и возврата

Для ФР Webkassa поддержана возможность закрывать чеки со скидками, наценками и маркированными товарами, передавать в чеке ИНН/БИН и адрес покупателя.

Передача ИНН/БИН покупателя

Для передачи ИИН/БИН в запросах к сервису Webkassa необходимо:

1. Активировать плагин customerInn в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/customerInn.ini в секции [plugins].

   Наименование	Тип данных	Возможные значения	Описание	Примечания
   customerInn	строковый	on off	Плагин для ввода ИНН покупателя	По умолчанию off

   [plugins]
   ; Плагин для ввода ИНН покупателя
   ;customerInn = off

2. В утилите администрирования Yuki на клавишу настроить действие "Добавить ИНН покупателя" с командой COMMAND_CUSTOMER_INN. О настройке действий подробнее можно прочитать в разделе "Настройка действий".
3. В утилите администрирования Yuki добавить команду COMMAND_CUSTOMER_INN в список команд для выбранных ролей. О настройке ролей подробнее можно прочитать в разделе "Пользователи и роли".

4. Для печати ИИН/БИН покупателя в чеке добавить запрос на получение ИНН/БИН из БД в шаблон отчета webkassa_sale.xml – для продажи и webkassa_back.xml – для возврата:

   <select query="SELECT nopdfurlegais FROM document WHERE documentid = $document.id$ and nopdfurlegais is not null and nopdfurlegais != ''">
   	<text fillsymbol="-" maxwidth="all"/><br/>
   	<text align="left">ИИН:</text><var align="right" name="nopdfurlegais" maxwidth="all"/><br/>
   	<text fillsymbol="-" maxwidth="all"/><br/>
   </select>

   Подробнее о редактировании шаблонов можно прочитать в разделе "Движок отчетов".

При нажатии на клавишу с командой COMMAND_CUSTOMER_INN на экран будет выведен диалог для ввода ИИН. Допустимое значение: 12-значный номер. При вводе корректного ИИН значение сохраняется в БД Documents в таблицу Document в поле nopdfurlegais и в БД Documents в таблицу Client в поле inn.

Передача адреса покупателя

В качестве адреса покупателя в запросах к сервису Webkassa могут быть переданы следующие значения:

• адрес электронной почты,
• номер телефона.

Для передачи адреса покупателя необходимо активировать и настроить плагин customerAddress. Подробнее об этом можно прочитать в разделе "Отправка чека на адрес покупателя".

Для печати адреса покупателя в чеке необходимо добавить запрос на получение адреса из БД в шаблон отчета webkassa_sale.xml – для продажи и webkassa_back.xml – для возврата:

<select query="SELECT customeraddress FROM document WHERE documentid = $document.id$ and customeraddress is not null and customeraddress != ''">
    <text fillsymbol="-" maxwidth="all"/><br/>
    <text align="left">Адрес покупателя:</text><var align="right" name="customeraddress" maxwidth="all"/><br/>
    <text fillsymbol="-" maxwidth="all"/><br/>
</select>

Подробнее о редактировании шаблонов можно прочитать в разделе "Движок отчетов".

Проверка счетчиков в смене и в ФР

Если включена проверка счетчиков в смене и в ФР при закрытии смены, то при расхождении сумм пользователю необходимо подтвердить закрытие смены с расхождением сумм, либо отменить закрытие смены.