Руководство по работе с сервисом для автоматического взаимодействия с ИРУД (стр. 2 )

<result>

<ID_ABN>8ae54718264c3438012655e9b8ae3a5c</ID_ABN>

<STATE>sent</STATE>

</result>

Тег STATE (статус) может содержать одно из следующих значений:

§  created – документ создан / изменен. Создан в ИРУД, но данные еще не переданы на ГПК.

§  success – карта передана на ГПК.

В случае ошибки в процессе приёма или исполнения запроса или в случае не нахождения информации по заданному идентификатору карты метод возвращает описание ошибки или текст исключения.

<?xml version="1.0" encoding="Windows-1251"?>

<result>

<error> Запрос с ID 8ae5472d2aaeaf6f012aaeb37a100001a не найден. </error>

</result>

3.  Метод получения данных регистрационной карты

(IRUCAutoRegServiceInterface_requestRegistrationData)

Метод принимает в качестве входящих параметров:

Логин пользователя (USER_LOGIN) Пароль пользователя (USER_PASS) Идентификатор ДУЦ/СОС (ID_ORG) Идентификатор абонента (ID_ABN)

В качестве ответа метод возвращает данные в виде XML-структуры с данными регистрационной карты в формате пакета автозагрузки. XML будет кодирован в base64.

<?xml version="1.0" encoding="Windows-1251"?>

<return>PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0id2l...6PHy8OD26P8+DQo=</return>

В случае ошибки в процессе приёма или исполнения запроса метод возвращает описание ошибки или текст исключения.

<?xml version="1.0" encoding="Windows-1251"?>

<result>

<error> Абонент не найден. </error>

</result>

4.  Метод получения списка карт, состояние которых было изменено в течении указанного интервала времени

(IRUCAutoRegServiceInterface_requestResultPeriod)

Метод принимает в качестве входящих параметров:

Логин пользователя (USER_LOGIN) Пароль пользователя (USER_PASS) Идентификатор ДУЦ/СОС (ID_ORG) Начало запрашиваемого интервала (DATETIME_START) Конец запрашиваемого интервала (DATETIME_END)

Конец запрашиваемого интервала должен быть больше, чем начало.

Запрашиваемый интервал времени должен составлять не менее 300 и не более 3600 секунд.

В качестве ответа метод возвращает, в виде XML-структуры, список абонентов, состояние обработки которых было изменено в течении запрашиваемого периода.

Информация по абоненту включает в себя:

Присвоенный ИРУД идентификатор карты (ID_PACK) Состояние обработки пакета (STATE):

Тег STATE (статус) может содержать одно из следующих значений:

§  created – документ создан / изменен. Создан в ИРУД, но данные еще не переданы на ГПК.

§  success – карта передана на ГПК.

Приложение 2. Формат пакета автозагрузки версия 2.5.10

Для XML-документа разрешается использовать следующие кодовые страницы: UTF-8, UFT-16 или windows-1251.

Тег <регистрация> – корневой тег XML-документа.

·  Обязательный тег.

·  Разрешается использовать только 1 тег <регистрация> на XML-документ.

·  Атрибуты тега <регистрация>:

№	Атрибут	Обязателен	Формат	Описание
1	xmlns:xsi	да	Только текст: http://www. w3.org/2001/XMLSchema-instance	Пространство имен XML-документа.
2	xsi:noNamespaceSchemaLocation	да	Только текст: картаАвтозагрузкиАбонента. xsd	Схема XML-документа.
3	тип	да	Только текст: картаАвтозагрузкиАбонента	Тип XML-документа.
4	идентификатор	да	Текст не более 50 символов.	Уникальный идентификатор XML-документа.
5	оператор	да	Текст не более 40 символов.	Отпечаток СКП Оператора ИРУЦ, от имени которого создается и подписывается XML-документ.
6	префиксСистемы	да	Текст строго 3 символа.	Идентификатор ДУЦ или СпецОС, в котором создан XML-документ. Идентификатор присваивается в соответствии с перечнем префиксов ДУЦ и СпецОС.
7	дата	да	Текст не более 19 символов по формату: ДД. ММ. ГГГГ ЧЧ:ММ:СС	Дата создания документа.
8	системноеИмя	нет	Текст не более 100 символов.	Зарезервировано. Не используется.

Тег <абонент> – сведения об абоненте.

·  Обязательный тег.

·  Разрешается использовать только 1 тег <абонент> на XML-документ.

·  Атрибуты тега <абонент>:

№	Атрибут	Обязателен	Формат	Описание
	Общие атрибуты для всех типов абонентов
1	действие	нет	Разрешены только такие значения: блокировать разблокировать	Действие, которое будет выполнено при регистрации абонента: ·  блокировать – заблокировать абонента для всех маршрутов, ·  разблокировать – разблокировать абонента для всех маршрутов. Если атрибут не указан, то будет использовано значение по умолчанию – разблокировать.
2	тип	да	Разрешены только такие значения: ЮЛ ИП ФЛ	Тип абонента: ·  ЮЛ – юридическое лицо, ·  ИП – индивидуальный предприниматель, ·  ФЛ – физическое лицо. В зависимости от выбранного типа меняется набор обязательных атрибутов тега <абонент>
3	категория	да	Разрешены только такие значения: НП УП	Категория абонента: ·  НП – налогоплательщик, ·  УП – уполномоченный представитель. В зависимости от выбранной категории меняется набор обязательных атрибутов тега <маршруты>
4	идентификаторАбонента	да	Текст не более 46 символов.	Уникальный идентификатор Абонента.
5	краткоеНаименование	нет	Текст не более 64 символов.	Зарезервировано. Не используется.
	Список атрибутов для типа абонента ЮЛ
6	наименование	да	Текст не более 250 символов.	Наименование ЮЛ (из заявления).
7	инн	да	Ровно 10 цифр.	ИНН НП.
8	огрн	да	Ровно 13 цифр.	Основной государственный регистрационный номер ЮЛ. Если по ОГРН у ДУЦ нет данных, то до 1 января 2012 года разрешается использовать 13 нулей. После 1 января 2013 года все ОГРН, при регистрации новых и внесении изменений в уже имеющихся абонентов, должны быть заменены на реальные данные.
9	окопф	нет	Только цифры.	Код организационно-правовой формы по справочнику ОКОПФ.
10	адрес	да	Текст не более 250 символов.	Адрес нахождения исполнительного органа.
	Список атрибутов для типа абонента ИП
11	фамилия	да	Текст не более 64 символов.	Фамилия ИП.
12	имя	да	Текст не более 64 символов.	Имя ИП.
13	отчество	нет	Текст не более 64 символов.	Отчество ИП.
14	инн	да	Ровно 12 цифр.	ИНН.
15	огрнип	да	Ровно 15 цифр.	Основной государственный регистрационный номер ИП, если его нет, то атрибут не указывать. Если по ОГРНИП у ДУЦ нет данных, то до 1 января 2012 года разрешается использовать 15 нулей. После 1 января 2012 года все ОГРНИП, при регистрации новых и внесении изменений в уже имеющихся абонентов, должны быть заменены на реальные данные.
16	адрес	нет	Текст не более 250 символов.	Адрес нахождения ИП, если его нет, то атрибут не указывать.
	Список атрибутов для типа абонента ФЛ
17	фамилия	да	Текст не более 64 символов.	Фамилия ФЛ.
18	имя	да	Текст не более 64 символов.	Имя ФЛ.
19	отчество	нет	Текст не более 64 символов.	Отчество ФЛ.
20	инн	да	Ровно 12 цифр.	ИНН, если его нет, то атрибут заполнять 12 нулями.
21	адрес	нет	Текст не более 250 символов.	Адрес нахождения ФЛ, если его нет, то атрибут не указывать.

Тег <контакты> – сведения о контактной информации абонента.