Files
mostovik-backend/docs/sources/fssp.md
2026-10-05 15:17:11 +02:00

5.4 KiB
Raw Blame History

ФССП: два открытых набора

Проверено 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. Паспорта скачиваются по /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 будут добавлены после выполнения.