Клиентское по эсчф ндс. Руководство пользователя

Скачать 158.81 Kb.

Название	Клиентское по эсчф ндс. Руководство пользователя
Тип	Руководство пользователя

rykovodstvo.ru > Руководство эксплуатация > Руководство пользователя

Клиентское ПО ЭСЧФ НДС. Руководство пользователя

(редакция от 28.06.2016)

2016

Аннотация 3

Подготовка рабочего места 4

Комплект абонента и действующий сертификат 4

Доверие Корневому УЦ МНС 4

Программное обеспечение для пакетной обработки счёт-фактур 5

Работа через интерфейс ActiveX 6

Установка ActiveX компонента EInvVatService_setup.exe 6

Предварительная настройка переменных окружения в файле env.bat 6

Параметры подключения 6

Входные и выходные каталоги по умолчанию 6

Каталоги с дополнительной информацией 6

Параметры авторизации 6

Параметры подключения через прокси 7

Процедура подписания счет-фактуры с помощью Active X 9

Запуск командной строки и смена текущего каталога 9

Для отправителя ЭСЧФ 10

Вызов signAndUploadDir.bat 10

Вызов updateStatusOutDir.bat 10

Для получателя ЭСЧФ 10

Вызов receive2Dir.bat 10

Вызов signAndUploadRecvDir.bat 10

Вызов updateStatusRecvDir.bat 10

Сообщения об ошибках ActiveX 12

Работа через интерфейс Java 13

Среда исполнения программ Java 13

Предварительная настройка переменных окружения в файле env.bat 13

Настройка среды исполнения Java 13

Настройка AvJCEProv 13

Параметры подключения 13

Параметры подключения через прокси 14

Входные и выходные каталоги по умолчанию 14

Процедура подписания счет-фактуры в среде Java 15

Запуск командной строки и смена текущего каталога 15

Для отправителя ЭСЧФ 16

Вызов signAndUploadDir.bat 16

Вызов updateStatusOutDir.bat 16

Для получателя ЭСЧФ 16

Вызов receive2Dir.bat 16

Вызов signAndUploadRecvDir.bat 16

Вызов updateStatusRecvDir.bat 16

Сообщения об ошибках Java 17

Аннотация

Программное обеспечение предназначено для автоматизированной пакетной обработки файлов электронных счёт-фактур по НДС и их передачи на портал электронных счёт-фактур.

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

Комплект ПО включает два программных интерфейса:

компонент ActiveX EInvVatService, для использования в программах ОС Windows.
библиотека avedocclient.jar, для использования в среде исполнения программ Java.

ВНИМАНИЕ! Программное обеспечение, использование которого описано в данной инструкции, находится в стадии активной разработки. Рекомендуем во время использования не реже одного раза в две недели обновлять комплект программ и документацию к ним.

Подготовка рабочего места

Для того, чтобы получить возможность автоматизировать подписание электронных счетов-фактур потребуется:

Комплект абонента и действующий сертификат

Пользователь должен являться абонентом хотя бы одной из инфраструктур открытого ключа:

РУП «Информационно-издательского центра по налогам и сборам»

и (или)

РУП «Национального центр электронных услуг» (ГосСУОК)

На рабочем месте должен быть корректно установлен соответствующий комплект абонента AvPKISetup, поставляемый Удостоверяющим центром на диске. Сертификат должен быть действующим, списки отозванных сертификатов — актуальными.

Т.к. ПО находится в стадии активной разработки, мы рекомендуем обновлять комплект абонента по ссылкам, размещённым на сайте avest.by:

Для РУП ИИЦ: http://www.avest.by/crypto/download/AvPKISetup_IIC_(AvToken_AvPass).zip
Для РУП НЦЭУ: http://www.avest.by/crypto/download/AvPKISetup_NCES_(AvToken_AvPass).zip

Руководство по установке комплекта абонента AvPKISetup находится в архиве в папке ..\doc. Рекомендуем ознакомится с ним перед установкой.

ВНИМАНИЕ! Для корректной работы xml-документов в ОС Windows Server 2003 потребуется установка Службы Microsoft Core XML Services (MSXML) 6.0 с пакетом обновления 1 (SP1), доступная по ссылке на сайте Microsoft:

https://www.microsoft.com/ru-RU/download/details.aspx?id=6276

Доверие Корневому УЦ МНС

Так как издателем сертификата сервера vat.gov.by является Министерство по налогам и сборам РБ, то корневой сертификату этого удостоверяющего центра должен быть обязательно помещён в справочник доверенных УЦ ОС Windows.

Установка доверия происходит автоматически, после установки одного из комплектов AvPKISetup, размещённых на сайте avest.by. Если по какой-то причине, установка доверия не состоялась, следует проделать следующие действия:

Запустить персональный менеджер сертификатов Авест с авторизацией по действующему сертификату.
Перейти в справочник «Сертификаты», найти среди сертификатов «Корневой удостоверяющий центр» с серийным номером «40E2 BD6E 9314 788D 0000 0001», при просмотре карточки открытого ключа которого можно увидеть, что он выпущен организацией «Министерство по налогам и сборам РБ».
Установить ему доверие, как показано на рисунке:

Программное обеспечение для пакетной обработки счёт-фактур

Скачайте архив с ПО для пакетной обработки электронных счёт-фактур. Это архив вида eInvVat.zip. Его нужно распаковать в любую удобную вам папку на компьютере. Например в:

c:\Avest\eInvVat

Внутри папки находятся подкаталоги и файлы пакетной обработки. В зависимости от выбранного интерфейса, потребуется провести дополнительную настройку среды.

Работа через интерфейс ActiveX

Установка ActiveX компонента EInvVatService_setup.exe

Компонент EInvVatService_setup.exe находится в ранее распакованном архиве с ПО для пакетной обработки электронных счёт-фактур:

c:\Avest\eInvVat\install

Запустите установку этого файла. Убедитесь, что ваш антивирус не блокирует установку компонента.

ВНИМАНИЕ:

Если вы получили обновление архива eInvVat, обязательно обновите компонент EInvVatService_setup.exe, поставляемый с архивом.

Предварительная настройка переменных окружения в файле env.bat

Для работы с компонентом ActiveX потребуется настроить переменные среды. Они находятся в файле env.bat по пути:

c:\Avest\eInvVat\simpleapp\vbs

Файл env.bat нужно открыть для редактирования в каком-нибудь текстовом редакторе, например, в notepad.exe.

Параметры подключения

Содержит URL, по которому будет происходить отправка подписанных файлов счёт-фактур (по умолчанию используется https://ws.vat.gov.by:443/InvoicesWS/services/InvoicesPort).

Входные и выходные каталоги по умолчанию

in - каталог исходных счетов-фактур

out - каталог подписанных и отправленных счетов-фактур

recv - каталог поступивших счетов-фактур

Каталоги с дополнительной информацией

src - программы на Visual Basic Script

xsd - XSD схемы для проверки структуры счета-фактуры

Параметры авторизации

Настройка этих параметров позволяет:

Осуществить выбор сертификата по УНП. Для настройки уберите rem и впишите требуемый УНП, например:

set UNP=199999999

Либо можно выбрать сертификата по идентификатору открытого ключа (значение их поля «Идентификатор ключа субъекта» в сертификате):

Для настройки уберите rem и впишите требуемый идентификатор открытого ключа (без пробелов), например:

set PUBLIC_KEY_ID=40D0C8DA3AB10ED832810FB4337FFB73A7009E0C

Также можно указать пароль к личному ключу.

Внимание! пароль будет прописан в явном виде:

set PASSWORD=

Параметры подключения через прокси

В файле env.bat можно задать параметры подключения к proxy. По умолчанию все параметры закомментированы.

Если требуется соединяться по proxy без авторизации, то следует раскомментировать только строки PROXY_TYPE, PROXY_URL и PROXY_PORT и заполнить их сведениями о proxy-соединении, например:

set PROXY_TYPE=1

set PROXY_URL=10.0.1.50

set PROXY_PORT=3128

А если требуется соединиться по proxy с авторизацией, то все строки нужно раскомментировать и заполнить сведениями, например:

set PROXY_TYPE=1

set PROXY_URL=10.0.1.50

set PROXY_PORT=3128

set PROXY_USER=user1

set PROXY_PASS=password

Если вносились какие-то изменения, обязательно сохраните их перед тем, как закрыть файл. Можно переходить к разделу «Процедура подписания счет-фактуры с помощью Active X»

Процедура подписания счет-фактуры с помощью Active X

Для того, чтобы подписать счёт-фактуру электронно-цифровой подписью, потребуется помесить в каталог \in файл счёт-фактуры в формате (с расширением) *.xml.

Подписание файла счёт-фактуры производится с помощью одного из файлов пакетной обработки в командной строке.

Для отправителя ЭСЧФ:

signAndUploadDir.bat — подписание и отправка на портал счетов-фактур из каталога in, подписанные счета-фактуры помещаются в папку out. Может вызываться с параметром -d для удаления входных файлов после обработки.

updateStatusOutDir.bat — проверка статусов счетов-фактур в папке out.

Для получателя ЭСЧФ:

receive2Dir.bat - получение поступивших счетов-фактур в папку recv.
signAndUploadRecvDir.bat — добавление второй подписи и отправка на сервис счетов-фактур из папки recv.
updateStatusRecvDir.bat — проверка статусов счетов-фактур в папке recv.

Запуск командной строки и смена текущего каталога

Для того, чтобы запустить такой файл, нужно открыть: «Пуск» — «Выполнить» или нажать сочетание клавиш Win+R, написать слово «cmd» и нажать «ОК»:

Откроется командная строка. Далее нужно будет сменить текущий каталог на тот, в который вы ранее распаковали архив eInvVat.zip (путь к каталогу, который содержит пробелы следует обрамить двойными кавычками). Команда для доступа к файлу пакетной обработки будет выглядеть так:

cd c:\Avest\eInvVat\simpleapp\vbs

После того, как в качестве текущего выбран каталог, в котором находятся файлы пакетной обработки, можно вызывать их для подписи и отправки подготовленных файлов счёт-фактур в виде *.xml.

Предварительно нужно разместить в каталоге \in исходных счёт-фактур файлы, которые будут подписываться и отправляться на веб-сервис. Каталоги \out и \recv заполнятся сами, после соответствующих вызовов.

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

Для ActiveX выбор сертификата будет происходить через GUI:

Для отправителя ЭСЧФ

Вызов signAndUploadDir.bat

Подписание и отправка на портал счетов-фактур из каталога in, подписанные счета-фактуры помещаются в папку out.

Этот файл пакетной обработки может вызываться с параметром -d для удаления входных файлов после обработки.

Вызов updateStatusOutDir.bat

Проверка статусов счетов-фактур в папке out.

Для получателя ЭСЧФ

Вызов receive2Dir.bat

Получение поступивших счетов-фактур в папку recv.

Вызов signAndUploadRecvDir.bat

Добавление второй подписи и отправка на сервис счетов-фактур из папки recv.

Вызов updateStatusRecvDir.bat

Проверка статусов счетов-фактур в папке recv.

Сообщения об ошибках ActiveX

В файле env.bat неправильно указан URL сервера или URL недоступен:

Авторизация успешна

Подключение к https://vat.gov.by:4443/InvoicesWS/services/InvoicesPort

Ошибка подключения: Ошибка HTTP

Socket Error # 11004 (Код 0xE82A0187)

В файле env.bat указан неправильный порт:

Авторизация успешна

Подключение к https://vat.gov.by:44443/InvoicesWS/services/InvoicesPort

Ошибка подключения: Ошибка HTTP

Socket Error # 10060

Connection timed out. (Код 0xE82A0187)

В файле env.bat неправильно указан путь к каталогу с xml счёт-фактурами:

Авторизация успешна

Подключение к https://vat.gov.by:4443/InvoicesWS/services/InvoicesPort

Подключение успешно

c:\eInvVat\simpleapp\vbs\src\signAndUploadDir.vbs(125, 3) Ошибка выполнения Microsoft VBScript: Путь не найден

Работа через интерфейс Java

Среда исполнения программ Java

Установите среду исполнения программ Java 32-х разрядную версию. Следует установить версию Java не ниже jdk-8u60-windows-i586.exe, инсталлятор доступен на сайте Oracle.

http://download.oracle.com/otn-pub/java/jdk/8u91-b15/jdk-8u91-windows-i586.exe

Установка Java проходит по умолчанию.

Предварительная настройка переменных окружения в файле env.bat

Для работы в среде исполнения программ Java потребуется настроить переменные среды. Они находятся в файле env.bat по пути:

c:\Avest\eInvVat\simpleapp\java

Файл env.bat нужно открыть для редактирования в каком-нибудь текстовом редакторе, например, в notepad.exe.

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

Файл env.bat нужно будет отредактировать в зависимости от того, по какому пути у вас установлена java, например:

Настройка AvJCEProv

Содержит путь к установленному AvJCEProv. Путь установки данного ПО, по умолчанию, для ОС Windows любой разрядности:

c:\Program Files\Avest\AvJCEProv

Этот путь и прописан в настройке по умолчанию. Если на вашем компьютере ПО AvJCEProv установлено по другому пути, то параметр SET AV_JCEPROV_PATH= нужно соответственно отредактировать.