|
|
|
| Единая государственная информационная система социального обеспечения (ЕГИССО)
Инструкция по работе с утилитой конвертации 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
| Логический
| Обязательно:
если Форма предоставления = 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;;;;;;;;;;
| Правила заполнения блоков «Сведения о получателе» и «Сведения о лице, являющимся основанием для возникновения права» Если получатель и лицо, являющееся основанием для возникновения права (далее — лицо-основание), один и тот же человек, не заполняйте поля блока «Сведения о лице, являющимся основанием для возникновения права». Поля, относящиеся к блоку «Сведения о лице, являющимся основанием для возникновения права»:
СНИЛС(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»; поля блока «Сведения о лице, являющимся основанием для возникновения права»; во всех остальных полях указываются пустые значения.
Если в факте назначения требуется указать несколько критериев нуждаемости, информацию о факте назначения представьте в следующем виде:
Основная информация о факте назначения указывается в записи, заполненной в соответствии с п. 3.1.3. При этом в поле «Тип записи» (RecType) должно быть указано значение «Fact». Сведения о каждом дополнительном критерии нуждаемости указываются отдельной записью, следующей за записью, содержащей основные данные. В записи о критериях нуждаемости заполняются следующие поля:
поле «Тип записи» (RecType) – должно быть указано значение «Criteria»; поля блока «Критерии нуждаемости»; во всех остальных полях указываются пустые значения.
Конвертация файлов Чтобы сконвертировать данные поставщиков из формата CSV в формат XML:
Распакуйте архив, содержащий утилиту. Запустите приложение «Конвертация CSV файлов».Откроется диалоговое окно:
Рисунок 3 — Диалоговое окно утилиты «Конвертация CSV файлов»
| В диалоговом окне все поля обязательны для заполнения.
| Укажите код поставщика данных в формате «####», например, «0001».
Рисунок 4 — Заполнение поля о коде поставщика данных
|
Укажите папку с исходными CSV-файлами:
нажмите на кнопку , расположенную рядом с полем «Выберите папку с исходными CSV-файлами»; в открывшемся окне выберите нужную папку. Для поиска нужной папки, воспользуйтесь следующими кнопками:
- поиск с помощью проводника; - стандартные операции win-окна для поиска папки:
- переход на уровень выше; - переход в домашнюю папку; - создание новой папки; - отображение элементов в виде списка; - детальное отображение элементов в виде списка.
нажмите на кнопку «Open».
Рисунок 5 — Выбор папки с исходными CSV файлами
| Убедитесь, что папка не заархивирована. Если папка заархивирована, необходимо её разархивировать.
| Аналогичным образом заполните поле «Выберите папку для сохранения XML-файлов». Нажмите на кнопку «Запуск». Запуститься конвертация файлов.
По завершению проверки отображаются:
краткий протокол, где указывается:
количество успешно отработанных файлов; количество файлов с ошибками; общее количество файлов;
«Журнал обработки», где отображается полный список файлов с результатами проверки.
Рисунок 6 — Результат обработки файлов
|
Более подробная информация по обработке файлов и их ошибках содержится в файле протокола проверки (имя файла <Дата проверки>_<Код Поставщика>_popdlog.csv), который формируется в папке, откуда запускалась утилита.
Чтобы проверить успешность передачи файлов в ЕГИССО:
Подпишите XML-файл. Перейдите в Кабинет поставщика информации. Подробнее см. в Руководстве пользователя ЕГИССО, раздел «Кабинет поставщика информации». Перейдите в раздел «Загрузка подписанных XML-файлов».
Рисунок 7 — Загрузка подписанных XML файлов
|
Выберите файлы в полях «XML файл с данными» и «Файл с ЭЦП». Размер загружаемых файлов не должен превышать 20 Мбайт. Нажмите на кнопку «Начать загрузку файлов». Убедитесь, что появилось сообщение об успешной загрузки пакета. Перейдите в раздел «Журнал «История взаимодействия»:
Рисунок 8 — Журнал «История взаимодействия»
|
Чтобы найти протокол загрузки пакета, заполните поля и нажмите на кнопку «Найти» Убедитесь, что все записи загружены без ошибок:
Рисунок 9 — Журнал «История взаимодействия»
| |