docs: verify FSSP datasets and mappings

This commit is contained in:
Aleksandr Meshchryakov
2026-10-05 15:17:11 +02:00
parent 10611b1d96
commit fb6f59338e
7 changed files with 113 additions and 0 deletions

34
docs/sources/fssp.md Normal file
View File

@@ -0,0 +1,34 @@
# ФССП: два открытых набора
Проверено 5 октября 2026 напрямую на официальном сайте и по meta.csv.
| Набор | Паспорт | Последний файл | Структура | Размер |
| --- | --- | --- | --- | --- |
| Общедоступные ИП юрлиц | https://opendata.fssp.gov.ru/7709576929-iplegallist | data-20261005T0655-structure-20260820T2100.csv | 17 колонок, 20260820T2100 | 1 971 503 738 байт |
| Оконченные ИП юрлиц | https://opendata.fssp.gov.ru/7709576929-iplegallistcomplete | data-20261005T0704-structure-20220620T2006.csv | 16 колонок, 20220620T2006 | 2 724 199 089 байт |
HTTP 206/Content-Range подтверждает размеры и чтение первых 4096 байт обоих inputs. Полное скачивание и checksums ещё требуют завершения dev-приёмки. UTF-8, CSV comma/quoted multiline. Разрешённый HTTPS host: opendata.fssp.gov.ru. Паспорта скачиваются по <dataset>/meta.csv; актуальный файл выбирается по verified data timestamp, не порядку links. Максимальный размер каждого файла 4 GiB (4 294 967 296 байт), паспорт/структура 1 MiB; при превышении явный отказ.
## Mapping
Официальные structure CSV и обезличенные meta CSV сохранены в tests/fixtures/fssp. Обе версии используют общие названия полей должника, адресов, номера/даты ИП, сводного ИП, типа/даты/номера/предмета документа, предмета исполнения, отдела/адреса отдела, Debtor TIN и TIN of the organization collector.
- The name of the debtor → debtor_name; Address of the debtor organization → debtor_legal_address (исходный смысл «Адрес организации-должника» сохраняется в raw); Actual address → debtor_actual_address.
- The number of enforcement proceeding → proceeding_number; Date of the institution of proceeding → initiated_on/record_date; The number of the consolidated enforcement proceedings → consolidated_proceeding_number.
- The executive document type/date/number → document_type/document_date/document_number; The object of executive documents → document_subject_raw (не issuer); The object of the execution → subject.
- Amount due → claim_amount; Debt remaining balance → debt_amount/amount (signed Decimal); только общий набор.
- Date, complete IP reason → termination_raw и при распознавании terminated_on/article/part/point; только набор оконченных ИП. Суммы в нём отсутствуют и равны null, не нулю.
- Departments of bailiffs → department_name; Address of departments of bailiff → department_address.
- Debtor TIN → debtor_inn/exact canonical organization; TIN of the organization collector → creditor_inn. Ведущие нули сохраняются; контрольная цифра юридического ИНН проверяется.
General status unknown. Completed status ended обоснован областью паспорта: пункты 3/4 части 1 статьи 46 и пункты 6/7 части 1 статьи 47. Конкретное основание не заполняется из общей области — только из raw поля.
## Пересечение и идентичность
Identity: Debtor TIN + номер ИП, UUID5 существующего publisher. Одинаковое наблюдение дедуплицируется. Для одного ИП в обоих наборах оконченный набор имеет приоритет только если дата его публикации >= общей; сохранить оба наблюдения/provenance. Это более конкретная подтверждённая область, а не вывод из имени файла. Конфликт внутри одного набора или более новая общая запись против окончания блокирует общий publish. Ничего не выбирать по порядку обхода.
## Режим работы
Server download → raw artifacts → canonical staging batches <=500 → aggregate manifest → один атомарный publish. Строки вне реестра считаются без staging. Некорректный ИНН/неоднозначность — quarantine. Две выгрузки обязательны, отказ одной сохраняет прошлый snapshot. CSV payload: origin_kind=open_data_csv, queried_inn=null, amount=debt_amount, record_date=initiated_on. Unknown/missing поля nullable; warnings сохраняются.
Frontend/read-only соответствует контракту Глеба; item code fssp_inn_search, источник последний. Новое расписание disabled. Отсутствует пользовательский upload/file URL. Реальные dev counts/checksums/time/peak RSS и API/export acceptance будут добавлены после выполнения.

18
tests/fixtures/fssp/ended-meta.csv vendored Normal file
View File

@@ -0,0 +1,18 @@
property,value
standardversion,Методические рекомендации 4.0
identifier,7709576929-iplegallistcomplete
title,"Исполнительные производства в отношении юридических лиц, оконченные в соответствии с пунктами 3 и 4 части 1 статьи 46 и пунктами 6 и 7 части 1 статьи 47 Федерального закона от 2 октября 2007 г. № 229-ФЗ «Об исполнительном производстве»"
description,"Набор открытых данных, содержащий общедоступные сведения, необходимые для осуществления задач по принудительному исполнению судебных актов, актов других органов и должностных лиц (в отношении юридических лиц)"
creator,ФССП России
created,20160726
modified,20261005
subject,"Оконченные исполнительные производства в отношении юридических лиц, открытые данные, ФССП России, банк данных исполнительных производств"
format,csv
provenance,Обновление набора данных
valid,20220620
data-20261003T0712-structure-20220620T2006,https://opendata.fssp.gov.ru/7709576929-iplegallistcomplete/data-20261003T0712-structure-20220620T2006.csv
data-20261004T0708-structure-20220620T2006,https://opendata.fssp.gov.ru/7709576929-iplegallistcomplete/data-20261004T0708-structure-20220620T2006.csv
data-20261005T0704-structure-20220620T2006,https://opendata.fssp.gov.ru/7709576929-iplegallistcomplete/data-20261005T0704-structure-20220620T2006.csv
structure-20160926T1504,https://opendata.fssp.gov.ru/7709576929-iplegallistcomplete/structure-20160926T1504.csv
structure-20200401T1655,https://opendata.fssp.gov.ru/7709576929-iplegallistcomplete/structure-20200401T1655.csv
structure-20220620T2006,https://opendata.fssp.gov.ru/7709576929-iplegallistcomplete/structure-20220620T2006.csv
1 property value
2 standardversion Методические рекомендации 4.0
3 identifier 7709576929-iplegallistcomplete
4 title Исполнительные производства в отношении юридических лиц, оконченные в соответствии с пунктами 3 и 4 части 1 статьи 46 и пунктами 6 и 7 части 1 статьи 47 Федерального закона от 2 октября 2007 г. № 229-ФЗ «Об исполнительном производстве»
5 description Набор открытых данных, содержащий общедоступные сведения, необходимые для осуществления задач по принудительному исполнению судебных актов, актов других органов и должностных лиц (в отношении юридических лиц)
6 creator ФССП России
7 created 20160726
8 modified 20261005
9 subject Оконченные исполнительные производства в отношении юридических лиц, открытые данные, ФССП России, банк данных исполнительных производств
10 format csv
11 provenance Обновление набора данных
12 valid 20220620
13 data-20261003T0712-structure-20220620T2006 https://opendata.fssp.gov.ru/7709576929-iplegallistcomplete/data-20261003T0712-structure-20220620T2006.csv
14 data-20261004T0708-structure-20220620T2006 https://opendata.fssp.gov.ru/7709576929-iplegallistcomplete/data-20261004T0708-structure-20220620T2006.csv
15 data-20261005T0704-structure-20220620T2006 https://opendata.fssp.gov.ru/7709576929-iplegallistcomplete/data-20261005T0704-structure-20220620T2006.csv
16 structure-20160926T1504 https://opendata.fssp.gov.ru/7709576929-iplegallistcomplete/structure-20160926T1504.csv
17 structure-20200401T1655 https://opendata.fssp.gov.ru/7709576929-iplegallistcomplete/structure-20200401T1655.csv
18 structure-20220620T2006 https://opendata.fssp.gov.ru/7709576929-iplegallistcomplete/structure-20220620T2006.csv

17
tests/fixtures/fssp/ended-structure.csv vendored Normal file
View File

@@ -0,0 +1,17 @@
"english field name","field name","russian description","english description","format","unique","required","length","The number of digits after the decimal point","Relationship with another table (table name and field communications)"
"The name of the debtor","Должник","Наименование юридического лица","The name of the debtor","Текстовое","нет","нет","256 символов",,
"Address of the debtor organization","Адрес","Адрес организации - должника","Address of the debtor organization","Текстовое","нет","нет","256 символов",,
"Actual address of the debtor organization","Фактический адрес","Фактический адрес организации должника","Actual address of the debtor organization","Текстовое","нет","нет","256 символов",,
"The number of enforcement proceeding","Номер исполнительного производства","Номер исполнительного производства","The number of enforcement proceeding","Текстовое","нет","нет","256 символов",,
"Date of the institution of proceeding","Дата возбуждения","Дата возбуждения исполнительного производства","Date of the institution of proceeding","Текстовое","нет","нет","256 символов",,
"The number of the consolidated enforcement proceedings","Номер сводного исполнительного производства","Номер сводного производства по взыскателю или должнику","The number of the consolidated enforcement proceedings","Текстовое","нет","нет","256 символов",,
"The executive document type","Тип исполнительного документа","Тип исполнительного документа","The executive document type","Текстовое","нет","нет","11 символов",,
"Date of the executive document","Дата исполнительного документа","Дата исполнительного документа","Date of the executive document","Текстовое","нет","нет","256 символов",,
"The number of executive document","Номер исполнительного документа","Номер исполнительного документа","The number of executive document","Текстовое","нет","нет","256 символов",,
"The object of executive documents","Требования исполнительного документа","Требования исполнительного документа","The object of executive documents","Текстовое","нет","нет","256 символов",,
"The object of the execution","Предмет исполнения","Предмет исполнения","The object of the execution","Текстовое","нет","нет","256 символов",,
"Date, complete IP reason","Дата, причина окончания или прекращения ИП (статья, часть, пункт основания)","Текстовое","Date, complete IP reason","Текстовое","нет","нет","256 символов",,
"Departments of bailiffs","Отдел судебных приставов","Наименование отдела","Departments of bailiffs","Текстовое","нет","нет","256 символов",,
"Address of departments of bailiff","Адрес отдела судебных приставов","Адрес отдела судебных приставов","Address of departments of bailiff","Текстовое","нет","нет","256 символов",,
"Debtor taxpayer identification number","Идентификационный номер налогоплательщика должника","Идентификационный номер налогоплательщика должника","Debtor taxpayer identification number","Текстовое","нет","нет","256 символов",,
"Taxpayer identification number of the organization collector","Идентификационный номер налогоплательщика взыскателя-организации","Идентификационный номер налогоплательщика взыскателя-организации","Taxpayer identification number of the organization collector","Текстовое","нет","нет","256 символов",,
1 english field name field name russian description english description format unique required length The number of digits after the decimal point Relationship with another table (table name and field communications)
2 The name of the debtor Должник Наименование юридического лица The name of the debtor Текстовое нет нет 256 символов
3 Address of the debtor organization Адрес Адрес организации - должника Address of the debtor organization Текстовое нет нет 256 символов
4 Actual address of the debtor organization Фактический адрес Фактический адрес организации должника Actual address of the debtor organization Текстовое нет нет 256 символов
5 The number of enforcement proceeding Номер исполнительного производства Номер исполнительного производства The number of enforcement proceeding Текстовое нет нет 256 символов
6 Date of the institution of proceeding Дата возбуждения Дата возбуждения исполнительного производства Date of the institution of proceeding Текстовое нет нет 256 символов
7 The number of the consolidated enforcement proceedings Номер сводного исполнительного производства Номер сводного производства по взыскателю или должнику The number of the consolidated enforcement proceedings Текстовое нет нет 256 символов
8 The executive document type Тип исполнительного документа Тип исполнительного документа The executive document type Текстовое нет нет 11 символов
9 Date of the executive document Дата исполнительного документа Дата исполнительного документа Date of the executive document Текстовое нет нет 256 символов
10 The number of executive document Номер исполнительного документа Номер исполнительного документа The number of executive document Текстовое нет нет 256 символов
11 The object of executive documents Требования исполнительного документа Требования исполнительного документа The object of executive documents Текстовое нет нет 256 символов
12 The object of the execution Предмет исполнения Предмет исполнения The object of the execution Текстовое нет нет 256 символов
13 Date, complete IP reason Дата, причина окончания или прекращения ИП (статья, часть, пункт основания) Текстовое Date, complete IP reason Текстовое нет нет 256 символов
14 Departments of bailiffs Отдел судебных приставов Наименование отдела Departments of bailiffs Текстовое нет нет 256 символов
15 Address of departments of bailiff Адрес отдела судебных приставов Адрес отдела судебных приставов Address of departments of bailiff Текстовое нет нет 256 символов
16 Debtor taxpayer identification number Идентификационный номер налогоплательщика должника Идентификационный номер налогоплательщика должника Debtor taxpayer identification number Текстовое нет нет 256 символов
17 Taxpayer identification number of the organization collector Идентификационный номер налогоплательщика взыскателя-организации Идентификационный номер налогоплательщика взыскателя-организации Taxpayer identification number of the organization collector Текстовое нет нет 256 символов

3
tests/fixtures/fssp/ended.csv vendored Normal file
View File

@@ -0,0 +1,3 @@
The name of the debtor,Address of the debtor organization,Actual address of the debtor organization,The number of enforcement proceeding,Date of the institution of proceeding,The number of the consolidated enforcement proceedings,The executive document type,Date of the executive document,The number of executive document,The object of executive documents,The object of the execution,"Date, complete IP reason",Departments of bailiffs,Address of departments of bailiff,Debtor TIN,TIN of the organization collector
АО Тестовая организация,"Москва, улица Тестовая, 1","Москва, офис 2
этаж 3",123/26/77001-ИП,01.10.2026,100/26/77001-СД,Исполнительный лист,30.09.2026,001-A,Взыскание сбора,Иные взыскания,02.10.2026 ст. 46 ч. 1 п. 3,Тестовый отдел,"Москва, Тестовая, 2",7707083893,7704228075
1 The name of the debtor Address of the debtor organization Actual address of the debtor organization The number of enforcement proceeding Date of the institution of proceeding The number of the consolidated enforcement proceedings The executive document type Date of the executive document The number of executive document The object of executive documents The object of the execution Date, complete IP reason Departments of bailiffs Address of departments of bailiff Debtor TIN TIN of the organization collector
2 АО Тестовая организация Москва, улица Тестовая, 1 Москва, офис 2 этаж 3 123/26/77001-ИП 01.10.2026 100/26/77001-СД Исполнительный лист 30.09.2026 001-A Взыскание сбора Иные взыскания 02.10.2026 ст. 46 ч. 1 п. 3 Тестовый отдел Москва, Тестовая, 2 7707083893 7704228075

20
tests/fixtures/fssp/general-meta.csv vendored Normal file
View File

@@ -0,0 +1,20 @@
property,value
standardversion,Методические рекомендации 4.0
identifier,7709576929-iplegallist
title,Общедоступные сведения банка данных исполнительных производств в отношении юридических лиц
description,"Набор открытых данных, содержащий общедоступные сведения, необходимые для осуществления задач по принудительному исполнению судебных актов, актов других органов и должностных лиц (в отношении юридических лиц)"
creator,ФССП России
created,20140325
modified,20261005
subject,"Исполнительные производства в отношении юридических лиц, открытые данные, ФССП России, банк данных исполнительных производств"
format,csv
provenance,Обновление набора данных
valid,20260820
data-20261003T0703-structure-20260820T2100,https://opendata.fssp.gov.ru/7709576929-iplegallist/data-20261003T0703-structure-20260820T2100.csv
data-20261004T0659-structure-20260820T2100,https://opendata.fssp.gov.ru/7709576929-iplegallist/data-20261004T0659-structure-20260820T2100.csv
data-20261005T0655-structure-20260820T2100,https://opendata.fssp.gov.ru/7709576929-iplegallist/data-20261005T0655-structure-20260820T2100.csv
structure-20160201T0712,https://opendata.fssp.gov.ru/7709576929-iplegallist/structure-20160201T0712.csv
structure-20170203T1400,https://opendata.fssp.gov.ru/7709576929-iplegallist/structure-20170203T1400.csv
structure-20200401T1649,https://opendata.fssp.gov.ru/7709576929-iplegallist/structure-20200401T1649.csv
structure-20220620T1936,https://opendata.fssp.gov.ru/7709576929-iplegallist/structure-20220620T1936.csv
structure-20260820T2100,https://opendata.fssp.gov.ru/7709576929-iplegallist/structure-20260820T2100.csv
1 property value
2 standardversion Методические рекомендации 4.0
3 identifier 7709576929-iplegallist
4 title Общедоступные сведения банка данных исполнительных производств в отношении юридических лиц
5 description Набор открытых данных, содержащий общедоступные сведения, необходимые для осуществления задач по принудительному исполнению судебных актов, актов других органов и должностных лиц (в отношении юридических лиц)
6 creator ФССП России
7 created 20140325
8 modified 20261005
9 subject Исполнительные производства в отношении юридических лиц, открытые данные, ФССП России, банк данных исполнительных производств
10 format csv
11 provenance Обновление набора данных
12 valid 20260820
13 data-20261003T0703-structure-20260820T2100 https://opendata.fssp.gov.ru/7709576929-iplegallist/data-20261003T0703-structure-20260820T2100.csv
14 data-20261004T0659-structure-20260820T2100 https://opendata.fssp.gov.ru/7709576929-iplegallist/data-20261004T0659-structure-20260820T2100.csv
15 data-20261005T0655-structure-20260820T2100 https://opendata.fssp.gov.ru/7709576929-iplegallist/data-20261005T0655-structure-20260820T2100.csv
16 structure-20160201T0712 https://opendata.fssp.gov.ru/7709576929-iplegallist/structure-20160201T0712.csv
17 structure-20170203T1400 https://opendata.fssp.gov.ru/7709576929-iplegallist/structure-20170203T1400.csv
18 structure-20200401T1649 https://opendata.fssp.gov.ru/7709576929-iplegallist/structure-20200401T1649.csv
19 structure-20220620T1936 https://opendata.fssp.gov.ru/7709576929-iplegallist/structure-20220620T1936.csv
20 structure-20260820T2100 https://opendata.fssp.gov.ru/7709576929-iplegallist/structure-20260820T2100.csv

View File

@@ -0,0 +1,18 @@
"field name","english description","russian description","format"
"The name of the debtor","The name of the debtor","Наименование юридического лица","string"
"Address of the debtor organization","Address of the debtor organization","Адрес организации - должника","string"
"Actual address of the debtor organization","Actual address of the debtor organization","Фактический адрес организации должника","string"
"The number of enforcement proceeding","The number of enforcement proceeding","Номер исполнительного производства","string"
"Date of the institution of proceeding","Date of the institution of proceeding","Дата возбуждения исполнительного производства","date"
"The number of the consolidated enforcement proceedings","The number of the consolidated enforcement proceedings","Номер сводного производства по взыскателю или должнику","string"
"The executive document type","The executive document type","Тип исполнительного документа","string"
"Date of the executive document","Date of the executive document","Дата исполнительного документа","date"
"The number of executive document","The number of executive document","Номер исполнительного документа","string"
"The object of executive documents","The object of executive documents","Требования исполнительного документа","string"
"The object of the execution","The object of the execution","Предмет исполнения","string"
"Amount due","Amount due","Сумма долга","number"
"Debt remaining balance","Debt remaining balance","Остаток непогашенной задолженности","number"
"Departments of bailiffs","Departments of bailiffs","Наименование отдела","string"
"Address of departments of bailiff","Address of departments of bailiff","Адрес отдела судебных приставов","string"
"Debtor TIN","Debtor taxpayer identification number","Идентификационный номер налогоплательщика должника","string"
"TIN of the organization collector","Taxpayer identification number of the organization collector","Идентификационный номер налогоплательщика взыскателя-организации","string"
1 field name english description russian description format
2 The name of the debtor The name of the debtor Наименование юридического лица string
3 Address of the debtor organization Address of the debtor organization Адрес организации - должника string
4 Actual address of the debtor organization Actual address of the debtor organization Фактический адрес организации должника string
5 The number of enforcement proceeding The number of enforcement proceeding Номер исполнительного производства string
6 Date of the institution of proceeding Date of the institution of proceeding Дата возбуждения исполнительного производства date
7 The number of the consolidated enforcement proceedings The number of the consolidated enforcement proceedings Номер сводного производства по взыскателю или должнику string
8 The executive document type The executive document type Тип исполнительного документа string
9 Date of the executive document Date of the executive document Дата исполнительного документа date
10 The number of executive document The number of executive document Номер исполнительного документа string
11 The object of executive documents The object of executive documents Требования исполнительного документа string
12 The object of the execution The object of the execution Предмет исполнения string
13 Amount due Amount due Сумма долга number
14 Debt remaining balance Debt remaining balance Остаток непогашенной задолженности number
15 Departments of bailiffs Departments of bailiffs Наименование отдела string
16 Address of departments of bailiff Address of departments of bailiff Адрес отдела судебных приставов string
17 Debtor TIN Debtor taxpayer identification number Идентификационный номер налогоплательщика должника string
18 TIN of the organization collector Taxpayer identification number of the organization collector Идентификационный номер налогоплательщика взыскателя-организации string

3
tests/fixtures/fssp/general.csv vendored Normal file
View File

@@ -0,0 +1,3 @@
The name of the debtor,Address of the debtor organization,Actual address of the debtor organization,The number of enforcement proceeding,Date of the institution of proceeding,The number of the consolidated enforcement proceedings,The executive document type,Date of the executive document,The number of executive document,The object of executive documents,The object of the execution,Amount due,Debt remaining balance,Departments of bailiffs,Address of departments of bailiff,Debtor TIN,TIN of the organization collector
АО Тестовая организация,"Москва, улица Тестовая, 1","Москва, офис 2
этаж 3",123/26/77001-ИП,01.10.2026,100/26/77001-СД,Исполнительный лист,30.09.2026,001-A,Взыскание сбора,Иные взыскания,250.00,-12.50,Тестовый отдел,"Москва, Тестовая, 2",7707083893,7704228075
1 The name of the debtor Address of the debtor organization Actual address of the debtor organization The number of enforcement proceeding Date of the institution of proceeding The number of the consolidated enforcement proceedings The executive document type Date of the executive document The number of executive document The object of executive documents The object of the execution Amount due Debt remaining balance Departments of bailiffs Address of departments of bailiff Debtor TIN TIN of the organization collector
2 АО Тестовая организация Москва, улица Тестовая, 1 Москва, офис 2 этаж 3 123/26/77001-ИП 01.10.2026 100/26/77001-СД Исполнительный лист 30.09.2026 001-A Взыскание сбора Иные взыскания 250.00 -12.50 Тестовый отдел Москва, Тестовая, 2 7707083893 7704228075