Файл: Инструкция по работе с утилитой конвертации 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



  1. Введение

    1. Область применения


Данная инструкция предназначена для пользователей «Утилиты конвертации CSV-файлов с данными о фактах назначения в XML-файлы» (далее — утилита). В ней содержится информация, необходимая при эксплуатации утилиты.
    1. Краткое описание возможностей


Утилита выполняет следующие функции:

  • конвертирует CSV-файл в XML-файл;

  • проводит валидацию XML-файла на соответствие схеме 10.06.S;

  • сохраняет результаты конвертации и валидации в протокол обработки.
    1. Требования к ПО


Для работы с утилитой требуется платформа Java 6.45 и выше.

  1. Подготовка данных для конвертации

    1. Подготовка csv-файла


Чтобы подготовить CSV-файл на портале ЕГИССО:

  1. Зайдите в кабинет поставщика информации.

  2. Перейдите в раздел «Реестр МСЗ».

  3. Выгрузите перечень локальных мер и соответствующих им категорий из реестра ЛМСЗ с идентификаторами, которые были присвоены им в ЕГИССО.




Рисунок 1 — Портал ЕГИССО. Кнопка «Выгрузить»




  1. В полученной выгрузке выберите требуемые сочетания локальных МСЗ и категорий получателей.



Рисунок 2 — Пример выгрузки реестра ЛМСЗ




  1. Сформируйте файл с фактами назначения в формате CSV с указанием идентификаторов мер и категорий из полученной выгрузки ЛМСЗ.
    1. Формат CSV-файла


  1. Символ разделитель – «;» (точка с запятой).

  2. Кодировка – Windows 1251 (кириллица windows).

  3. Поле «пол» – строго «М» или «Ж».

  4. Поле «Признак использования критериев нуждаемости при назначении МСЗ» – «Да» или «Нет».

  5. Дата – в формате ДД.ММ.ГГГГ.

  6. Текстовые значения не должны содержать символа «;» – это вызовет ошибку при обработке файла.

  7. Для дробных значений (например, сумма выплаты) разделителем должна быть запятая.

  8. Суммы должны быть указаны слитно, без разделителей разрядов ("2000,15" это правильно, "2 000.15" это неправильно).

  9. Код типа документа должен содержать одно из следующих значений:

  1. "01" – Вид на жительство;

  2. "02" – Временное удостоверение личности гражданина РФ по форме 2П;

  3. "03" – Паспорт гражданина РФ;

  4. "04" – Паспорт иностранного гражданина;

  5. "05" – Свидетельство о рождении;

  6. "06" – Удостоверение беженца;

  7. "07" – Удостоверение личности военнослужащего РФ;

  8. "08" – Иные документы.

  1. Серия и номер для разных типов документов должны иметь соответствующий документу формат (например: паспорт РФ – серия «9999», номер «999999»).

  2. Поле «Код формы предоставления из справочника форм предоставления КМСЗ» должен иметь одно из значений:

  1. "01" – Денежная;

  2. "02" – Натуральная;

  3. "03" – Льготы;

  4. "04" – Услуги.

  1. Для каждой формы предоставления должны быть заполнены поля в зависимости от формы:

  1. Денежная форма:

  • Сумма;

  1. Натуральная форма:

  • Количество;

  • Код единицы измерения;

  • Сумма-эквивалент;


  1. Льгота:

  • Количество;

  • Код единицы измерения;

  • Признак монетизации;

  • Сумма-эквивалент;

  1. Услуга:

  • Количество;

  • Код единицы измерения;

  • Сумма-эквивалент.

  1. Количество фактов назначения в файле – не более 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

Логический

Обязательно:

  • если Форма предоставления = 03-Льготы, то значение должно быть - Да;

  • если Форма предоставления = 01-Денежная, 02-Натуральная, 04-Услуга, то значение должно быть - Нет

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;;;;;;;;;;

    1. Правила заполнения блоков «Сведения о получателе» и «Сведения о лице, являющимся основанием для возникновения права»


  1. Если получатель и лицо, являющееся основанием для возникновения права (далее — лицо-основание), один и тот же человек, не заполняйте поля блока «Сведения о лице, являющимся основанием для возникновения права».

  2. Поля, относящиеся к блоку «Сведения о лице, являющимся основанием для возникновения права»:

  • СНИЛС(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).

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

  2. Если в факте назначения требуется перечислить сведения о нескольких физических лицах-основания, информацию о факте назначения представьте в следующем виде:

  1. Основная информация о факте назначения указывается в записи, заполненной в соответствии с п. 3.1.3. При этом в поле «Тип записи» (RecType) должно быть указано значение «Fact».

  1. Если получатель является лицом-основанием (например, при назначении меры на малоимущую семью, в состав которой входит получатель), не заполняйте поля блока «Сведения о лице, являющимся основанием для возникновения права».

  2. Если получатель не является лицом-основанием (например, при назначении выплаты в связи с рождением 3-го ребенка), в блоке «Сведения о лице, являющимся основанием для возникновения права» укажите сведения об одном из лиц-оснований, отличным от лица-получателя.

  1. Сведения о каждом дополнительном лице-основание указываются отдельной записью, следующей за записью, содержащей основные данные. В записи о дополнительных лицах заполняются следующие поля:

  1. поле «Тип записи» (RecType) – должно быть указано значение «Reason»;

  2. поля блока «Сведения о лице, являющимся основанием для возникновения права»;

  3. во всех остальных полях указываются пустые значения.

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