Файл: Инструкция по работе с утилитой конвертации csvфайлов с данными о фактах назначения в xmlфайлы.docx
ВУЗ: Не указан
Категория: Не указан
Дисциплина: Не указана
Добавлен: 10.01.2024
Просмотров: 412
Скачиваний: 51
ВНИМАНИЕ! Если данный файл нарушает Ваши авторские права, то обязательно сообщите нам.
| |
| |
Единая государственная информационная система социального обеспечения (ЕГИССО) Инструкция по работе с утилитой конвертации CSV-файлов с данными о фактах назначения в XML-файлы | |
| |
| |
| |
| |
| |
| |
| |
| |
| |
Москва 2019 |
Содержание
1Введение 3
1.1Область применения 3
1.2Краткое описание возможностей 3
1.3Требования к ПО 3
2Подготовка данных для конвертации 4
2.1Подготовка csv-файла 4
2.2Формат CSV-файла 4
2.3Правила заполнения блоков «Сведения о получателе» и «Сведения о лице, являющимся основанием для возникновения права» 11
3Конвертация файлов 14
4Проверка успешной передачи данных в ЕГИССО 18
-
Введение
-
Область применения
-
Данная инструкция предназначена для пользователей «Утилиты конвертации CSV-файлов с данными о фактах назначения в XML-файлы» (далее — утилита). В ней содержится информация, необходимая при эксплуатации утилиты.
-
Краткое описание возможностей
Утилита выполняет следующие функции:
-
конвертирует CSV-файл в XML-файл; -
проводит валидацию XML-файла на соответствие схеме 10.06.S; -
сохраняет результаты конвертации и валидации в протокол обработки.
-
Требования к ПО
Для работы с утилитой требуется платформа Java 6.45 и выше.
-
Подготовка данных для конвертации
-
Подготовка csv-файла
-
Чтобы подготовить CSV-файл на портале ЕГИССО:
-
Зайдите в кабинет поставщика информации. -
Перейдите в раздел «Реестр МСЗ». -
Выгрузите перечень локальных мер и соответствующих им категорий из реестра ЛМСЗ с идентификаторами, которые были присвоены им в ЕГИССО.
Рисунок 1 — Портал ЕГИССО. Кнопка «Выгрузить» |
-
В полученной выгрузке выберите требуемые сочетания локальных МСЗ и категорий получателей.
Рисунок 2 — Пример выгрузки реестра ЛМСЗ |
-
Сформируйте файл с фактами назначения в формате CSV с указанием идентификаторов мер и категорий из полученной выгрузки ЛМСЗ.
-
Формат CSV-файла
-
Символ разделитель – «;» (точка с запятой). -
Кодировка – Windows 1251 (кириллица windows). -
Поле «пол» – строго «М» или «Ж». -
Поле «Признак использования критериев нуждаемости при назначении МСЗ» – «Да» или «Нет». -
Дата – в формате ДД.ММ.ГГГГ. -
Текстовые значения не должны содержать символа «;» – это вызовет ошибку при обработке файла. -
Для дробных значений (например, сумма выплаты) разделителем должна быть запятая. -
Суммы должны быть указаны слитно, без разделителей разрядов ("2000,15" это правильно, "2 000.15" это неправильно). -
Код типа документа должен содержать одно из следующих значений:
-
"01" – Вид на жительство; -
"02" – Временное удостоверение личности гражданина РФ по форме 2П; -
"03" – Паспорт гражданина РФ; -
"04" – Паспорт иностранного гражданина; -
"05" – Свидетельство о рождении; -
"06" – Удостоверение беженца; -
"07" – Удостоверение личности военнослужащего РФ; -
"08" – Иные документы.
-
Серия и номер для разных типов документов должны иметь соответствующий документу формат (например: паспорт РФ – серия «9999», номер «999999»). -
Поле «Код формы предоставления из справочника форм предоставления КМСЗ» должен иметь одно из значений:
-
"01" – Денежная; -
"02" – Натуральная; -
"03" – Льготы; -
"04" – Услуги.
-
Для каждой формы предоставления должны быть заполнены поля в зависимости от формы:
-
Денежная форма:
-
Сумма;
-
Натуральная форма:
-
Количество; -
Код единицы измерения; -
Сумма-эквивалент;
-
Льгота:
-
Количество; -
Код единицы измерения; -
Признак монетизации; -
Сумма-эквивалент;
-
Услуга:
-
Количество; -
Код единицы измерения; -
Сумма-эквивалент.
-
Количество фактов назначения в файле – не более 5000.
Структура полей загружаемого файла:
№ | Описание поля | Имя поля | Тип данных | Обязательность заполнения |
1 | Тип записи | RecType | Перечислимое значение (Fact, Reason, Criteria) | Обязательно. Если поле заполнено значением Fact, то все последующие значения относятся к факту назначения. После строки с типом Fact может быть указано от 0 до N строк с типом Reason. Строка с таким типом содержит информацию о дополнительном родственнике, являющемся основанием для назначения меры. Criteria - строка вставляется после строки Fact для случая, если критериев > 1 |
2 | Идентификатор модифицируемого факта назначения | assignmentFactUuid | uuid | Обязательно, если Тип записи: AlterationBasedOnRecalculation, AlterationBasedOnDeathOrMovingRecalculation, TerminationBasedOnRecalculation, TerminationBasedOnIneligibility, DuplicatesInvalidation, ErrorsInvalidation, AlterationBasedOnPreviousErrors, TerminationBasedOnEndOfRight, TerminationBasedOnEndOfValidityPeriod |
Сведения о локальных МСЗ и категориях | | |||
3 | Идентификатор назначенной МСЗ | LMSZID | uuid | Обязательно |
4 | Идентификатор локальной категории получателей МСЗ | categoryID | uuid | Обязательно |
5 | Код ОНМСЗ, осуществившего назначение | ONMSZCode | Строка(11) | Обязательно |
6 | Код поставщика, если ЛМСЗ была загружена не текущим поставщиком данных | LMSZProviderCode | Строка(11) | Необязательно |
7 | Код поставщика (указывается, если факт был загружен не текущим поставщиком данных) | providerCode | Строка(11) | Необязательно |
Сведения о получателе | Обязательно | |||
8 | СНИЛС | SNILS_recip | Строка(11) | Обязательно |
9 | Фамилия | FamilyName_recip | Строка(100) | Обязательно |
10 | Имя | Name_recip | Строка(100) | Обязательно |
11 | Отчество | Patronymic_recip | Строка(100) | Необязательно. При заполнении более одного слова ставится пробел (код символа 32) |
12 | Пол | Gender_recip | Перечислимое значение (М, Ж) | Обязательно |
13 | Дата рождения | BirthDate_recip | Дата | Обязательно |
14 | Тип документа | doctype_recip | Строка(2) | Необязательно |
15 | Серия | doc_Series_recip | Строка(20) | Условно обязательный (заполняется если указан Тип документа п.14) |
16 | Номер | doc_Number_recip | Строка(25) | Условно обязательный (заполняется если указан Тип документа п.14) |
17 | Дата выдачи | doc_IssueDate_recip | Дата | Условно обязательный (заполняется если указан Тип документа п.14) |
18 | Кем выдан | doc_Issuer_recip | Строка(200) | Условно обязательный (заполняется если указан Тип документа п.14) |
Сведения о лице, являющимся основанием для возникновения права | Необязательно | |||
19 | СНИЛС | SNILS_reason | Строка(11) | Обязательно, если заполняется группа полей «Сведения о лице, являющимся основанием для возникновения права» |
20 | Фамилия | FamilyName_reason | Строка(100) | Обязательно, если заполняется группа полей «Сведения о лице, являющимся основанием для возникновения права» |
21 | Имя | Name_reason | Строка(100) | Обязательно, если заполняется группа полей «Сведения о лице, являющимся основанием для возникновения права» |
22 | Отчество | Patronymic_reason | Строка(100) | Необязательно. При заполнении более одного слова ставится пробел (код символа 32) |
23 | Пол | Gender_reason | Перечислимое значение (М, Ж) | Обязательно, если заполняется группа полей «Сведения о лице, являющимся основанием для возникновения права» |
24 | Дата рождения | BirthDate_reason | Дата | Обязательно если заполняется группа полей «Сведения о лице, являющимся основанием для возникновения права» |
25 | Тип документа | doctype_reason | Строка(2) | Необязательно |
26 | Серия | doc_Series_reason | Строка(20) | Обязательно, если заполнено «Тип документа» (п.25) |
27 | Номер | doc_Number_reason | Строка(25) | Обязательно, если заполнено «Тип документа» (п.25) |
28 | Дата выдачи | doc_IssueDate_reason | Дата | Обязательно, если заполнено «Тип документа» (п.25) |
29 | Кем выдан | doc_Issuer_reason | Строка(200) | Обязательно, если заполнено «Тип документа» (п.25) |
Сведения о сроках действия назначения | Обязательно | |||
30 | Дата принятия решения о назначении | decision_date | Дата | Обязательно |
31 | Дата начала действия назначения | dateStart | Дата | Обязательно |
32 | Дата окончания действия назначения | dateFinish | Дата | Необязательно |
Критерии нуждаемости | Обязательно | |||
33 | Признак использования критериев нуждаемости при назначении МСЗ | usingSign | Логический | Обязательно |
34 | Критерии нуждаемости | criteria | Строка(200) | Необязательно |
35 | Код критерия нуждаемости | criteriaCode | Строка(10) | Обязательно, если у назначаемой МСЗ в реестре локальных МСЗ указаны критерии нуждаемости |
Cведения о фактах назначения | Обязательно | |||
36 | Код формы предоставления из справочника форм предоставления КМСЗ | FormCode | Строка | Обязательно |
37 | Размер (Количество, Сумма) | amount | Денежный тип | Обязательно, если Форма предоставления = 01-Денежная, 02-Натуральная, 03-Льготы, 04-Услуга |
38 | Код единицы измерения по справочнику ЕГИССО | measuryCode | Строка(2) | Обязательно, если Форма предоставления = 02-Натуральная, 03-Льготы, 04-Услуга |
39 | Признак монетизации | monetization | Логический | Обязательно:
|
40 | Содержание | content | Строка(200) | Необязательно |
41 | Комментарий | comment | Строка(200) | Необязательно |
42 | Сумма-эквивалент | equivalentAmount | Денежный тип | Обязательно, если Форма предоставления = 02-Натуральная, 03-Льготы, 04-Услуга |
Пример заполнения csv-файла:
RecType;assignmentFactUuid;LMSZID;categoryID;ONMSZCode;LMSZProviderCode;providerCode;SNILS_recip;FamilyName_recip;Name_recip;Patronymic_recip;Gender_recip;BirthDate_recip;doctype_recip;doc_Series_recip;doc_Number_recip;doc_IssueDate_recip;doc_Issuer_recip;SNILS_reason;FamilyName_reason;Name_reason;Patronymic_reason;Gender_reason;BirthDate_reason;doctype_reason;doc_Series_reason;doc_Number_reason;doc_IssueDate_reason;doc_Issuer_reason;decision_date;dateStart;dateFinish;usingSign;criteria;criteriaCode;FormCode;amount;measuryCode;monetization;content;comment;equivalentAmount Fact;;55100243-3354-DC46-A823-E42841172162;C3AAB821-6E99-864B-87E7-5BF10F939B8F;0001.092003;0001.092005;;11111111145;Иванов;Иван;Иванович;М;21.04.1939;03;4000;198756;02.09.2014;ОУФМС РОССИИ ПО Г.СЕВАСТОПОЛЮ В ГАГАРИНСКОМ РАЙОНЕ;;;;;;;;;;;;31.12.2014;01.01.2015;;Да;;1001;01;1111,11;;Нет;;;100 Reason;;;;;;;;;;;;;;;;;;14651393567;Фамилия;Имя;Отчество;М;20.05.1964;03;4000;198756;02.09.2011;ОУФМС РОССИИ ПО Г.СЕВАСТОПОЛЮ В ГАГАРИНСКОМ РАЙОНЕУ;;;;;;;;;;;;; Criteria;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;1002;;;;;;; AlterationBasedOnRecalculation;5baa88bc-1d92-48c2-9e78-c2fff7c8c2d2;;;;;0001.092001;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4444,44;;;;; AlterationBasedOnDeathOrMovingRecalculation;5baa88bc-1d92-48c2-9e78-c2fff7c8c2d3;;;;;0001.092005;;;;;;;;;;;;;;;;;;;;;;;;;27.08.2019;;;;;1111,11;;;;; Fact;;55100243-3354-DC46-A823-E42841172162;C3AAB821-6E99-864B-87E7-5BF10F939B8F;0001.092003;;;04588388409;Фамилия;Имя;Отчество;М;21.04.1939;03;4000;198756;02.09.2014;ОУФМС РОССИИ ПО Г.СЕВАСТОПОЛЮ В ГАГАРИНСКОМ РАЙОНЕ;;;;;;;;;;;;31.12.2014;01.01.2015;;ДА;;;02;2222,222;22;Нет;content2;comment2;200 Reason;;;;;;;;;;;;;;;;;;69642141018;Фамилия;Имя;Отчество;М;20.05.1964;03;4000;198756;02.09.2011;ОУФМС РОССИИ ПО Г.СЕВАСТОПОЛЮ В ГАГАРИНСКОМ РАЙОНЕУ;;;;;;;;;;;;; Reason;;;;;;;;;;;;;;;;;;03991455490;Фамилия;Имя;Отчество;М;20.05.1964;03;1780;198756;02.11.2015;ОУФМС РОССИИ ПО Г.СЕВАСТОПОЛЮ В ГАГАРИНСКОМ РАЙОНЕц;;;;;;;;;;;;; TerminationBasedOnRecalculation;5baa88bc-1d92-48c2-9e78-c2fff7c8c2d5;;;;;0001.092005;;;;;;;;;;;;;;;;;;;;;;;;;27.08.2019;;;;;;;;;; TerminationBasedOnIneligibility;5baa88bc-1d92-48c2-9e78-c2fff7c8c2d6;;;;;0001.092005;;;;;;;;;;;;;;;;;;;;;;;;;27.08.2019;;;;;;;;;; Fact;;55100243-3354-DC46-A823-E42841172162;C3AAB821-6E99-864B-87E7-5BF10F939B8F;0001.092003;;;20572531540;Фамилия;Имя;Отчество;М;21.04.1939;03;4000;198756;02.09.2014;ОУФМС РОССИИ ПО Г.СЕВАСТОПОЛЮ В ГАГАРИНСКОМ РАЙОНЕ;;;;;;;;;;;;31.12.2014;01.01.2015;;Нет;;;03;2222,22;333;Да;content3;comment3;3000,3 Reason;;;;;;;;;;;;;;;;;;29670251704;Фамилия;Имя;Отчество;М;20.05.1964;03;4000;198756;02.09.2011;ОУФМС РОССИИ ПО Г.СЕВАСТОПОЛЮ В ГАГАРИНСКОМ РАЙОНЕс;;;;;;;;;;;;; Reason;;;;;;;;;;;;;;;;;;14016869650;Фамилия;Имя;Отчество;М;20.05.1964;03;4000;198756;02.11.2015;ОУФМС РОССИИ ПО Г.СЕВАСТОПОЛЮ В ГАГАРИНСКОМ РАЙОНЕч;;;;;;;;;;;;; Reason;;;;;;;;;;;;;;;;;;17825261893;Фамилия;Имя;Отчество;М;20.05.1964;03;4000;198756;02.11.2015;ОУФМС РОССИИ ПО Г.СЕВАСТОПОЛЮ В ГАГАРИНСКОМ РАЙОНЕя;;;;;;;;;;;;; Fact;;55100243-3354-DC46-A823-E42841172162;C3AAB821-6E99-864B-87E7-5BF10F939B8F;0001.092003;0001.092004;;31447425255;Фамилия;Имя;Отчество;М;21.04.1939;03;4000;198756;02.09.2014;ОУФМС РОССИИ ПО Г.СЕВАСТОПОЛЮ В ГАГАРИНСКОМ РАЙОНЕ;;;;;;;;;;;;31.12.2014;01.01.2015;;да;;1001;04;3333,33;4444;нет;content4;comment4;4000,44 DuplicatesInvalidation;5baa88bc-1d92-48c2-9e78-c2fff7c8c2d6;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ErrorsInvalidation;5baa88bc-1d92-48c2-9e78-c2fff7c8c2d6;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; AlterationBasedOnPreviousErrors;5baa88bc-1d92-48c2-9e78-c2fff7c8c2d4;55100243-3354-DC46-A823-E42841172163;C3AAB821-6E99-864B-87E7-5BF10F939B8F;0001.092004;0001.092005;0001.092005;18369482119;Фамилия;Имя;Отчество;М;21.04.1940;03;4001;198757;02.09.2015;ОУФМС РОССИИ ПО Г.СЕВАСТОПОЛЮ В ГАГАРИНСКОМ РАЙОНЕ;18369482119;Фамилия;Имя;Отчество;Ж;21.04.1940;03;1781;145679;02.09.2015;ОУФМС РОССИИ ПО Г.СЕВАСТОПОЛЮ В ГАГАРИНСКОМ РАЙОНЕ;31.12.2015;01.01.2016;;да;;1002;04;3334,33;4445;НЕТ;content5;comment5;4001,44 TerminationBasedOnEndOfRight;5baa88bc-1d92-48c2-9e78-c2fff7c8c2d4;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;27.08.2019;;;;;;;;;; TerminationBasedOnEndOfValidityPeriod;5baa88bc-1d92-48c2-9e78-c2fff7c8c2d4;;;;;0001.092005;;;;;;;;;;;;;;;;;;;;;;;;;27.08.2019;;;;;;;;;; |
-
Правила заполнения блоков «Сведения о получателе» и «Сведения о лице, являющимся основанием для возникновения права»
-
Если получатель и лицо, являющееся основанием для возникновения права (далее — лицо-основание), один и тот же человек, не заполняйте поля блока «Сведения о лице, являющимся основанием для возникновения права». -
Поля, относящиеся к блоку «Сведения о лице, являющимся основанием для возникновения права»:
-
СНИЛС(SNILS_reason); -
Фамилия (FamilyName_reason); -
Имя (Name_reason); -
Отчество (Patronymic_reason); -
Пол (Gender_reason); -
Дата рождения (BirthDate_reason); -
Тип документа (doctype_reason); -
Серия (doc_Series_reason); -
Номер (doc_Number_reason); -
Дата выдачи (doc_IssueDate_reason); -
Кем выдан (doc_Issuer_reason).
-
Если получатель и лицо-основание являются разными людьми и лицо-основание представлено в единственном числе, в полях блока «Сведения о лице, являющимся основанием для возникновения права» укажите сведения о лице-основании. -
Если в факте назначения требуется перечислить сведения о нескольких физических лицах-основания, информацию о факте назначения представьте в следующем виде:
-
Основная информация о факте назначения указывается в записи, заполненной в соответствии с п. 3.1.3. При этом в поле «Тип записи» (RecType) должно быть указано значение «Fact».
-
Если получатель является лицом-основанием (например, при назначении меры на малоимущую семью, в состав которой входит получатель), не заполняйте поля блока «Сведения о лице, являющимся основанием для возникновения права». -
Если получатель не является лицом-основанием (например, при назначении выплаты в связи с рождением 3-го ребенка), в блоке «Сведения о лице, являющимся основанием для возникновения права» укажите сведения об одном из лиц-оснований, отличным от лица-получателя.
-
Сведения о каждом дополнительном лице-основание указываются отдельной записью, следующей за записью, содержащей основные данные. В записи о дополнительных лицах заполняются следующие поля:
-
поле «Тип записи» (RecType) – должно быть указано значение «Reason»; -
поля блока «Сведения о лице, являющимся основанием для возникновения права»; -
во всех остальных полях указываются пустые значения.
-
Если в факте назначения требуется указать несколько критериев нуждаемости, информацию о факте назначения представьте в следующем виде: