www.webchek.com.ua
Руководство к
“ВебЧек : программный регистратор
расчетных операций (ПРРО)”
Введение 3
Технические требования 3
Программный регистратор расчетных операций (ПРРО)
www.webchek.com.ua
Основные требования 4
Введение
Программный регистратор расчетных операций поддерживает работу в семействе программ Microsoft
Windows (минимум Windows 7) с любыми языками программирования и средствами разработки,
поддерживающими технологию COM. Например: Microsoft Visual C++, Microsoft Visual Basic,
Microsoft Visual Fox Pro, Microsoft Visual C#, Microsoft Office с VBA (Excel, Word, Access и др.),
Visual Basic Script, Delphi, C++ Builder, 1С Предприятие и другие.
При работе ПРРО поддерживаются следующие операции:
● Формирование документов открытия и закрытия смены;
● Формирование фискальных чеков;
● Формирование фискальных чеков возврата;
● Формирование фискальных отчетов о текущем состоянии расчетов;
● Получение текущего состояние ПРРО;
● Печать чеков внесения/выемки денежных средств;
● Печать чеков , X Z отчетов из встроенной базы ПРРО;
Технические требования
“ВебЧек ПРРО” функционирует на компьютерах с современными операционными системами Microsoft с
установленными актуальными обновлениями для систем безопасности.
Основные требования
Процессор с минимальной тактовой частотой от 2 ГГц;
Оперативная память от 2 GB;
Свободное место на жестком диске от 300 mb
Версия Microsoft .NET Framework выше 4.7
Для работы на терминальных серверах Windows Server требуется наличие полных прав для
пользователей на папку C:\ProgramData\WebCheck\
Программный регистратор расчетных операций (ПРРО)
www.webchek.com.ua
https://tax.gov.ua/baneryi/programni-rro/video-lessons/
https://tax.gov.ua/media-tsentr/novini/440649.html
Тестирование ПРРО
Тестовый фискальный номер : 7000000512
Оператор : 1111111111
Видео как подключить
При тестировании для тестового и рабочего фискального сервера , могут использоваться разные ключи
ЭЦП.
Gmail
Настройки аккаунта для отправки чеков выполняется командой ShoweMailSettings(string XML)
Программный регистратор расчетных операций (ПРРО)
www.webchek.com.ua
WebCheck
|_Archive (хранение отчетов смены в электронном виде , в разрезе ФН/Год)
|_DB ( содержит базы данных хранения период итогов, смен, операторов, оффлайн сессий )
|_Keys (сертификаты и ключи ЭЦП)
|_Lic (лицензионные ключи для платных версий ПО)
Программный регистратор расчетных операций (ПРРО)
www.webchek.com.ua
вызов функции OfflinetoOnline(string XML) выполняется отправка одного чека. Для реализации
процедуры отправки всех чеков созданных в режиме оффлайн , применяется следующий алгоритм:
циклом вызывается процедура OfflinetoOnline , пока значение OfflineCount (ответ функции
GetCurrentStatus ) не будет равно 0. После этого регистратор автоматически перейдет в
режим онлайн и значение флага оффлайн будет равно 0 : Offline = 0 (ответ функции
GetCurrentStatus )
Инициализация
VARIANT_BOOL Initialization (string XML)
Назначение: Инициализация работы ПРРО c заданным фискальным номером, функция
производит проверку заполнения обязательных параметров ПРРО, подключение базы,
обновление диапазона офлайн номеров (см. Работа в OFFLINE режиме)
Параметры: Строка XML
Пример передаваемого XML :
<InputParameters>
<Parameters FN="7000000000"/> FN фискальный номер выданный налоговой
</InputParameters>
<OutputParameters>
<Parameters
Err="0"
TIN="34554362"
FN="7000000001"
version="0.9.0.0 demo"
license="30.12.2019"
OfflineCount="0"
Offline="0"
RegionSeparator="comma"/>
</OutputParameters>
<OutputParameters>
<Parameters
Err="0"
FN="1000000001"
ShiftNumber="1"
LocalCheckNumber="0"
Cashier="Сідороренко Василь Леонідович"/>
</OutputParameters>
Программный регистратор расчетных операций (ПРРО)
www.webchek.com.ua
LocalCheckNumber string 2
Номер последнего чека в текущей смене
(нумерация чеков в пределе одной
смены)
Открыть смену
VARIANT_BOOL OpenShift (string XML)
Назначение: Открыть смену для указанного фискального номера и оператора.
Ограничения: Нельзя в течении смены использовать разных операторов.
Параметры: Строка XML
Пример передаваемого XML :
<InputParameters>
<Parameters
FN="7000000000" - FN фискальный номер выданный налоговой
OperatorID="1111111111"/> - ИНН оператора, указывается при вводе нового
фискального номера или форме работы с операторами (см. разд)
</InputParameters>
<OutputParameters>
<Parameters
Err="0"
ShiftNumber ="1" - локальный номер смены
FN="7000000001" /> - фискальный номер
</OutputParameters>
Чек Продажи/Возврата
VARIANT_BOOL FiscalReceipt (string XML)
Назначение: При выполнении данной функции , выполняется формирование , подпись,
отправка чека на сервер фискальной службы. В результате выполнения в атрибут CheckID
передается фискальный номер чека , полученный после регистрации на сервере налоговой.
Проверить чек можно по ссылке: https://cabinet.tax.gov.ua/cashregs/check?id={НОМЕРЧЕКА,
например wFwnzEZPpow }&date={ДАТА ЧЕКА , например 20200206}
Ограничения:
● регистрация чека выполняется только в открытой смене
Параметры: Строка XML
Программный регистратор расчетных операций (ПРРО)
www.webchek.com.ua
<Check
Number="4" - локальный номер чека в пределах смены
FN="7000000001" - фискальный номер регистратора
TaxNum="111111111" - фискальный номер чека
OperationType="1" - тип операции 0-продажа/1-возврат
uuid="f27d042b-e7bd-11e9-80e7-001b2171617e" уникальный номер чека в Вашей
учетной системе
>
<L
email="ssukhenko@ttt.ua" - email для отправки чека
UP1="первая строка до блока товаров"
UP2="вторая строка до блока товаров"
UP3="n строка до блока товаров"
DN1="первая строка после блока товаров"
DN2="вторая строка после блока товаров"
DN3="n строка после блока товаров"
/>
<Goods>
<Good Code="00059" Name="Банан" Quantity="1.000" Price="22.5" Sum="21.37"
TaxRate="1" />
<Good
Code="00060" - код товара в Вашей учетной системе
Name="Банан" - наименование товара
Quantity="1.000" -количество товара
Price="31.38" - цена товара
Sum="31.38" - сумма товара
TaxRate="2" - ставка налога
/>
</Goods>
<Payments>
Программный регистратор расчетных операций (ПРРО)
www.webchek.com.ua
</Check>
<OutputParameters>
<Parameters
Err="0"
FN="7000000511"
CheckID="wFwnzEZPpow" - фискальный номер чека выдан налоговой, после регистрации
чека на фискальном сервере налоговой
Программный регистратор расчетных операций (ПРРО)
www.webchek.com.ua
/>
</OutputParameters>
Команда возвращает XML , аналогичный XML для команды ReportZ (см. ниже)
При ShowPintForm=1 (см. описание Settings.ini) для этого фискального номера будет выведена форма
печати X-отчета ПРРО.
Ограничения: Нет.
ОФФЛАЙН: Да.
Параметры: Строка XML
Пример передаваемого XML :
<InputParameters>
<Parameters FN="7000000000"
Operatorid = "1111111111"
/>- FN фискальный номер регистратора по которому выполняется закрытие смены
</InputParameters>
Служебный Внос/Вынос
VARIANT_BOOL CashInOut (string XML)
Назначение: Команда служебного вноса и выноса наличных денежных средств в ПРРО.
Программный регистратор расчетных операций (ПРРО)
www.webchek.com.ua
<OutputParameters>
<Parameters
Err="0"
FN="700000001" - локальный номер смены
CheckID="wFwnzEZPpow" /> - фискальный номер
</OutputParameters>
</E>
</C>
<TS>20200228142755</TS>
</DAT>
котором ссылкой на чек на сайте налоговой, на скрине ниже представлен пример формы :
Примеры использования :
ShowPrintByCheckFn() - вызов без параметров печать последнего чека
ShowPrintByCheckFn(“Z”) - печать последнего Z отчета
Программный регистратор расчетных операций (ПРРО)
www.webchek.com.ua
<OutputParameters>
<Parameters Err='0' TIN='34554362' FN='7000000511' RegionSeparator='comma'
versionDLL='0.6.3.0' license='free' >
<taxobjects>
<taxobject FN='7000000511' ID='1' INN='3455436222' ORGNAME='Тестовий
платник 3' POINTADDR='м.Київ, вул.Радищева,3' POINTNAME='Магазин ВебЧек' TIN='34554362'
/>
</taxobjects>
<operators>
<Operator ID='1' INN='1111' KEYPASS='tect3'
KEYPATH='C:\ProgramData\WebCheck\Keys\Key-6.dat' OPERATORNAME='Чеков С.А.' />
</operators>
<taxes>
<tax id='1' EXCISE='0' NAME='А' TAXPRC='20' />
<tax id='2' EXCISE='0' NAME='Б' TAXPRC='0' />
<tax id='3' EXCISE='0' NAME='В' TAXPRC='7' />
</taxes>
<payforms>
Программный регистратор расчетных операций (ПРРО)
www.webchek.com.ua
1001 Фискального Номера XXXXXXXXX в базе нет Создать новый ПРРО см.
ShowWizardNewPro
12 Ошибка при обработке товаров в чеке, проверьте цену Не указана цена или
или сумму. сумма в товаре.
13 Общая сумма чека отличается от суммы всех товаров. Проверить общую сумму
чека по товарам и по
формам оплаты.
14
15
17
18
на папку
C:\ProgramData\WebCheck
21
22
23
24
25
26
27
28
29
30
33
34
35
36
37
38
39
40
41
42
Программный регистратор расчетных операций (ПРРО)
www.webchek.com.ua
43
60 Символы, которые
Описание В XML используется запрещенный символ необходимо удалить
из наименования
(запрещены к
использованию на
сервере налоговой):
& <> ' "`
[Global]
WWW=https://www.webchek.com.ua/
4 АЦСК АТ КБ "ПРИВАТБАНК”
5 АЦСК АТ"УКРСИББАНК"
6 АЦСК ІДД ДФС
Порт 80
Порт 80
Порт 80
АЦСК MASTERKEY
Программный регистратор расчетных операций (ПРРО)
www.webchek.com.ua
Порт 80
Порт 80
Порт 80
АЦСК Україна
Сервер uakey.com.ua
TSP
Порт 80
Сервер http://uakey.com.ua/services/ocsp/
OCSP
Порт 80
Сервер uakey.com.ua
CMP
Порт 80
Порт 80
Порт 80
Порт 80
АЦСК Приватбанк
Программный регистратор расчетных операций (ПРРО)
www.webchek.com.ua
Порт 80
Порт 80
CMP Сервер
Порт 80
включен / 0-Выключен
При необходимости можно для каждого ПРРО сделать индивидуальный логотип. Для этого надо в
папку /LOGO графические файлы с именами фискальных номеров, которые были Вами получены в
налоговой, например:
4000035601.png, 4000035602.png, 4000035603.png и т.д.
Программный регистратор расчетных операций (ПРРО)
www.webchek.com.ua
Особенности релизов 1C :
При открытии смены/закрытии смены выводит ошибку :
в модуле ПодключаемоеОборудованиеУниверсальныйДрайверКлиент
Если РевизияИнтерфейса > 2004 Тогда // Версия стандарта 2.5 (ОФД 1.1)
заменить на
Если РевизияИнтерфейса < 2004 Тогда // Версия стандарта 2.5 (ОФД 1.1)