Руководство по работе с сервисом для автоматического взаимодействия с ИРУД
2013
Оглавление
1. Общее описание сервиса для взаимодействия с ИРУД.. 3
2. Описание методов сервиса. 4
2.1. Регистрация абонента в ИРУД.. 4
2.2. Получение результата регистрации абонента в ИРУД.. 5
2.3. Получение данных об абоненте. 5
2.4. Получение списка абонентов, состояние которых было изменено. 6
Приложение 1. Требования к протоколу автоматического взаимодействия АИС Спецоператоров и ИРУД в процессе регистрации новых абонентов и внесения изменений в существующие записи абонентов. 7
1. Метод регистрации абонентов. 7
2. Метод получения результата обработки карты.. 9
3. Метод получения данных регистрационной карты.. 10
4. Метод получения списка карт, состояние которых было изменено в течении указанного интервала времени. 11
Приложение 2. Формат пакета автозагрузки версия 2.5.10. 13
Приложение 3. WSDL-описание SOAP-сервисов автозагрузки ИРУД.. 20
1. Общее описание сервиса для взаимодействия с ИРУД
Автоматическое взаимодействие обеспечивается через WEB-сервис, доступный по протоколу https, и позволяющий обмениваться сообщениями по протоколу SOAP, с аутентификацией по:
- Сертификату оператора; Комбинации логина и пароля; Идентификатору ДУЦ (СОС), в данные абонентов которого вносятся изменения (данные абонентов которого запрашиваются).
Безопасность обеспечивается с помощью протокола WSS SOAP Message Security.
Адрес SOAP-сервисов автозагрузки ИРУД:
https://irud.gpk.nalog.ru:8733/IRUCWS/IRUCAutoRegService
WSDL-описание SOAP-сервисов автозагрузки ИРУД можно загрузить по этому адресу:
https://irud. gpk. nalog. ru:8733/IRUCWS/IRUCAutoRegService? wsdl
Описание также приведено в Приложении 3.
Реализованы следующие методы сервиса:
· Метод регистрации абонентов.
· Метод получения результата обработки карты.
· Метод получения данных регистрационной карты.
· Метод получения списка карт, состояние которых было изменено в течении указанного интервала времени.
2. Описание методов сервиса
2.1. Регистрация абонента в ИРУД
Оператор ИРУД формирует пакет автозагрузки и отправляет его в ИРУД посредством СОАП-сервиса.
Пакет представляет собой отдельный XML-файл закодированный в формате BASE64. Также прикладывается электронная подпись, но в данный момент проверка подписи не осуществляется и её наличие не требуется.
В одном пакете может содержаться только одна регистрационная карта абонента.
Производимые операции:
· Регистрация новой карты
· Изменение существующей карты
В ИРУД над пакетом осуществляется форматно-логический контроль: осуществляется проверка соответствия XSD-схеме, проверяются логические соотношения. Если нет ошибок, то на основании этого пакета в ИРУД формируется карта регистрации абонента (или в уже имеющуюся карту вносятся изменения), карте присваивается идентификатор, и далее все статусы и результаты обработки будут касаться этой карты.
Данные в карте заполняются по пакету, если что-то зарегистрированное ранее было удалено из пакета, то и в карте оно удаляется.
Факт передачи данных об абоненте на ГПК Оператор ИРУД так же получает посредством СОАП-сервисов.
Более подробно о работе СОАП-сервисов см. «Приложение 1. Требования к протоколу автоматического взаимодействия АИС Спецоператоров и ИРУД в процессе регистрации новых абонентов и внесения изменений в существующие записи абонентов».
2.2. Получение результата регистрации абонента в ИРУД
Оператор ИРУД формирует запрос с указанием идентификатора карты, присвоенного при регистрации абонента в ИРУД, и отправляет его в ИРУД посредством СОАП-сервиса.
В ИРУД осуществляется поиск абонента по идентификатору карты. Если абонент был найден в ИРУД, то возвращается текущий статус карты. Если абонент не был найден, то возвращается сообщение о не нахождении абонента.
Более подробно о работе СОАП-сервисов см. «Приложение 1. Требования к протоколу автоматического взаимодействия АИС Спецоператоров и ИРУД в процессе регистрации новых абонентов и внесения изменений в существующие записи абонентов».
2.3. Получение данных об абоненте
Оператор ИРУД формирует запрос с указанием идентификатора абонента, информацию по которому необходимо получить, и отправляет его в ИРУД посредством СОАП-сервиса.
В ИРУД осуществляется поиск абонента по его идентификатору. Если абонент был найден в ИРУД, то формируется пакет, содержащий информацию об абоненте. Пакет представляет собой отдельный XML-файл, закодированный в формате BASE64. Если абонент не был найден, то возвращается сообщение о не нахождении абонента.
Более подробно о работе СОАП-сервисов см. «Приложение 1. Требования к протоколу автоматического взаимодействия АИС Спецоператоров и ИРУД в процессе регистрации новых абонентов и внесения изменений в существующие записи абонентов».
2.4. Получение списка абонентов, состояние которых было изменено
Оператор ИРУД формирует запрос с указанием временного интервала, за который необходима информация об отредактированных картах абонентов, и отправляет его в ИРУД посредством СОАП-сервиса.
В ИРУД осуществляется выборка карт абонентов со статусом ‘изменен’ за указанный интервал времени. В качестве результата по каждому абоненту возвращается его идентификатор и текущий статус карты.
Более подробно о работе СОАП-сервисов см. «Приложение 1. Требования к протоколу автоматического взаимодействия АИС Спецоператоров и ИРУД в процессе регистрации новых абонентов и внесения изменений в существующие записи абонентов».
Приложение 1. Требования к протоколу автоматического взаимодействия АИС Спецоператоров и ИРУД в процессе регистрации новых абонентов и внесения изменений в существующие записи абонентов
1. Метод регистрации абонентов
(IRUCAutoRegServiceInterface_registrationPackage)
Метод принимает в качестве входящих параметров:
- Логин пользователя (USER_LOGIN) Пароль пользователя (USER_PASS) Идентификатор ДУЦ/СОС (ID_ORG) Указание производимой операции (IS_NEW):
- Регистрация новой карты Изменение существующей карты
На состав пакета и содержание регистрационной карты накладываются следующие ограничения:
- В одном пакете может содержаться только одна регистрационная карта абонента (Идентификатор абонента, ID_ABN, задается ДУЦ/СОС)
USER_LOGIN - Логин оператора, осуществляющего регистрацию абонента;
USER_PASS - Пароль оператора, осуществляющего регистрацию абонента;
ID_ORG - Идентификатор ДУЦ/СОС, чей оператор осуществляет регистрацию абонента;
IS_NEW – Признак регистрации карты нового абонента. Значение данного параметра на характер обработки карты не влияет. Поэтому может заполняться произвольно (либо true, либо false). При любом заполнении данного параметра обработка карты осуществляется по одному сценарию: ищется абонент в БД, если он найден то осуществляется модификация карты, в противном случае происходит регистрация новой карты абонента.
PACK_DATA - XML закодированный в формате BASE64. Имеет структуру, описанную в Приложении 2 “Формат пакета автозагрузки версия 2.5.10”.
Пакет будет проверен и если нет ошибок, то на основании этого пакета в ИРУД формируется карта (или в уже имеющуюся карту вносятся изменения) и далее все статусы и результаты обработки будут касаться этой карты.
PACK_SIGN – отсоединенная подпись PKCS#7 кодированная в формате BASE64.
Подпись формируется следующим алгоритмом:
1. Из XML файл-а (PACK_DATA) вычисляется хэш по алгоритму ГОСТ Р 34.11-94.
2. Полученный хэш кодируется в Base64.
3. Base64 данные переводятся в текст в кодировке UTF-16LE.
4. Из полученного текста создается отсоединенная подпись PKCS#7.
В качестве ответа метод возвращает в виде XML-структуры следующие параметры:
- Присвоенный ИРУД идентификатор пакета (ID_PACK). Этот идентификатор соответствует идентификатору созданной (или измененной) карты в ИРУД. Используя этот идентификатор всегда можно получить статус обработки пакета, а если пакет прошел все проверки и для него создана (или изменена) карты, то и статус карты. Дата и время приема пакета по локальному времени ИРУД (DATETIME_RECEIVEPACKET)
<?xml version="1.0" encoding="Windows-1251"?>
<result>
<ID_PACK>8ae54718264c3438012655e9b8ae3a5c</ID_PACK>
<RECEIVEPACKET>28.02.2010 12:12:13</RECEIVEPACKET>
</result>
В случае ошибки в процессе приёма запроса метод возвращает код ошибки и описание ошибки или текст исключения.
<?xml version="1.0" encoding="Windows-1251"?>
<result>
<ID_ABN>402825dc2724a5d8012724a5dfb40001</ID_ABN>
<STATE>error</STATE>
<MESSAGE> Текст ошибки</MESSAGE>
</result>
2. Метод получения результата обработки карты
(IRUCAutoRegServiceInterface_requestResult)
Метод принимает в качестве входящих параметров:
- Логин пользователя (USER_LOGIN) Пароль пользователя (USER_PASS) Идентификатор ДУЦ/СОС (ID_ORG) Присвоенный ИРУД идентификатор карты (ID_PACK)
В качестве ответа метод возвращает в виде XML-структуры следующие параметры:
- Идентификатор абонента (ID_ABN) Состояние обработки пакета (STATE):
<?xml version="1.0" encoding="Windows-1251"?>
|
Из за большого объема этот материал размещен на нескольких страницах:
1 2 3 4 |
