Приложение 2. Спецификация сервиса по работе с поставщиком данных льготных категорий

Приложение 2

Спецификация
сервиса по работе с поставщиком данных льготных категорий

1. Описание электронного сервиса

Наименование	Сервис, предоставляющий информацию о наличии записи в реестре поставщиков данных по льготным категориям
Назначение	Сервис предназначен для подтверждения наличии записи в реестре поставщиков данных по льготным категориям
Область применения	Интеграция ведомственных систем поставщиков данных по льготным, категориям с ЕЦС

2. Операции (методы) электронного сервиса

Электронный сервис обеспечивает обмен данными ведомственных систем поставщиков данных по льготным категориям с ЕЦС. Электронный сервис включает метод, обеспечивающий приём запроса из ЕЦС и формирование ответа в виде реестра отобранных граждан.

Обработчик	Назначение
Обработчик на стороне поставщика данных по льготным категориям	Принимает электронное сообщение с идентификатором операции и уточняющим параметром "дата".
Наименование:	Возвращает один из результатов обработки;
Получение списка граждан для реестра карт	- Ошибка получения реестра технического свойства;
ЕЦС	- Реестр отобранных граждан; - Граждане не найдены;

3. Описание входных параметров

Код параметра	Описание параметра	Обяз.	Тип	Комментарий
dateStart	Дата проверки		Date	dd.mm.yyyyy

4. Описание выходных параметров

N	Название поля	Описание параметра	Обяз.	Тип
1	Id	Номер записи в реестре	+	String
2	Pku	Номер карточки учета		String
3	id_family	Номер семьи		String
4	family_status	Статус в семье		String
5	Famil	Фамилия гражданина	+	String
6	Imja	Имя гражданина	+	String
7	Otch	Отчество гражданина		String
8	Drog	Дата рождений гражданина	+	Date
9	pasp_kod	удостоверяющего личность (ДУЛ)		String
10	pasp_name	Наименование документа, удостоверяющего личность (ДУЛ)		String
11	pasp_seria	Серия ДУЛ		String
12	pasp_number	Номер ДУЛ		String
13	pasp_kwid	Кем выдан ДУЛ		String
14	pasp_dat	Дата выдачи ДУЛ		Date
15	pasp_podr	Код подразделения, выдавшего ДУЛ		String
16	Nasp	Населенный пункт адреса регистрации		String
17	Ylic	Улица адреса регистрации		String
18	Ndom	Номер дома		String
19	Nkorp	Номер корпуса		String
20	Nkw	Номер квартиры		String
21	DB_kod	Код района		String
22	DB_nkod	Наименование района		String
23	ReestrPUItem	Список льготных категорий	+	Комплексный тип
24	SNILS	СНИЛС	+	String

Поле ReestrPUItem состоит из следующих полей:

N	Код параметра	Описание параметра	Обяз.	Тип
1	PU_nkod	Наименование льготной категории	+	String
2	PU_kod	Код льготной категории	+	String
3	PU_datStart	Дата начала действия признака учета	+	Date
4	PU_datEnd	Дата окончания действия признака учета		Date

5. Коды возвратов

Код возврата	Условия возникновения
<faultcode>soap: Server</faultcode>	Общая неработоспособность сервиса. Подробную информацию можно взять из поля faultstring
<GelReestrSocCardResult> <HasError>true</FIasError>	Данный код возврата соответствует ситуации, когда при обработке запроса произошла ошибка.
<ErrorMessage> Ошибка параметра "дата": invalid date Данная строка не распознана как действительное значение DateTime. Обнаружено неизвестное слово, начинающееся с индекса: 0.</ErrorMessage> </GetReestrSocCardResult>	Дополнительную информацию можно взять из поля ErrorMessage

6. Контрольный пример

Запрос без ошибок

<soapenv: Envelope xmIns:soapenv="htip://schemas.xm.lsoap.org/soap/envelope/" xmlns:soc="http://socit.ru/"> <soapenv:Header/> <soapenv:Body> <soc:GetReestrSocCard> <soc:dateStart></soc:dateStart> </soc: GetReestrSocCard> </soapenv:Body> </soapenv:Envelope>

Ответ на запрос в случае успешного выполнения

Примечание: для удобства представления в документе бинарные данные в ответе сокращены.