АПИ для поиска в ФССП

21 час назад

СУДиДЕЛО.рф

4 минут

АПИ для поиска в ФССП позволяет искать исполнительные производства по ИНН организации, номеру производства, исполнительному документу, данным физического или юридического лица. Можно сохранять параметры поиска, повторно выполнять запросы, просматривать историю и выгружать результаты в Excel.

В веб-приложении этим возможностям соответствует страница /FsspServicePage — «Поиск в ФССП». Здесь можно выполнить самостоятельный поиск без предварительного добавления организации в мониторинг. Работа с уже накопленными результатами мониторинга описана отдельно: «АПИ для ФССП: мониторинг организаций».

Подключение и API KEY

Получите API KEY пользователя в разделе «Интеграция — API» системы СУДиДЕЛО. Инструкция: «Открытое API системы СУДиДЕЛО». Базовый адрес: https://api-sudodelo.torkndgov.ru. Схемы запросов и ответов доступны в Swagger, раздел FsspSearch.

Во всех методах ниже передавайте apiKey в строке запроса. Для POST с телом укажите Content-Type: application/json. Имена JSON-полей записываются в camelCase. Храните ключ на сервере интеграции и исключайте его из публичных ссылок и журналов.

Общая схема работы

Выберите способ поиска и при необходимости получите справочники регионов и типов документов.
Выполните разовый поиск и проверьте поле error в ответе.
Для повторных проверок сохраните параметры запроса.
Выполните сохранённый запрос, получите идентификатор запуска и откройте его результаты.
При необходимости скачайте результаты запуска в Excel.

1. Справочники регионов и типов документов

GET /api/FsspSearch/regions?apiKey=YOUR_API_KEY
GET /api/FsspSearch/document-types?apiKey=YOUR_API_KEY

Каждый метод возвращает JSON-массив элементов: value — строковый код для передачи в поисковый запрос, text — подпись для пользователя. Для regionId и idType используйте значения из справочников, а не отображаемые названия.

2. Разовый поиск

Следующие методы возвращают результат без создания сохранённого запроса и истории запусков. В каждом примере замените условные значения реальными поисковыми реквизитами и своим API KEY. Параметры numberPage и pageSize для этих методов не предусмотрены.

По ИНН юридического лица

GET /api/FsspSearch/organization?apiKey=YOUR_API_KEY&inn=ИНН_ОРГАНИЗАЦИИ

Передайте 10-значный ИНН организации. Пример curl:

curl --fail --get "https://api-sudodelo.torkndgov.ru/api/FsspSearch/organization" \
  --data-urlencode "apiKey=YOUR_API_KEY" \
  --data-urlencode "inn=ИНН_ОРГАНИЗАЦИИ"

Также доступен POST-вариант передачи ИНН в JSON:

POST /api/FsspSearch/inn?apiKey=YOUR_API_KEY
Content-Type: application/json

{"inn":"ИНН_ОРГАНИЗАЦИИ"}

В текущей реализации оба маршрута обращаются к поиску организации. Для поиска физического лица по персональным данным используйте метод individual, описанный ниже.

По номеру исполнительного производства

POST /api/FsspSearch/ip-number?apiKey=YOUR_API_KEY
Content-Type: application/json

{"ipNumber":"НОМЕР_ИСПОЛНИТЕЛЬНОГО_ПРОИЗВОДСТВА"}

ipNumber — номер ИП в формате источника, например 12345/26/77001-ИП. Это иллюстрация формата, а не запрос к конкретному производству.

По исполнительному документу

POST /api/FsspSearch/document?apiKey=YOUR_API_KEY
Content-Type: application/json

{
  "regionId":"КОД_РЕГИОНА",
  "idNumber":"НОМЕР_ДОКУМЕНТА",
  "idType":"КОД_ТИПА_ДОКУМЕНТА",
  "idIssuer":"НАИМЕНОВАНИЕ_ВЫДАВШЕГО_ОРГАНА"
}

idNumber обозначает номер исполнительного документа; regionId — территориальный орган; idType — тип документа; idIssuer — орган, выдавший документ. В модели API последние три поля допускают null; для точного поиска укажите известные реквизиты.

По физическому лицу

POST /api/FsspSearch/individual?apiKey=YOUR_API_KEY
Content-Type: application/json

{
  "regionId":"КОД_РЕГИОНА",
  "lastName":"ФАМИЛИЯ",
  "firstName":"ИМЯ",
  "patronymic":"ОТЧЕСТВО",
  "birthDate":"ДД.ММ.ГГГГ"
}

lastName — фамилия; firstName — имя; patronymic — отчество; birthDate — дата рождения строкой в формате дд.мм.гггг. Регион, имя, отчество и дата рождения допускают null в модели запроса. Указывайте известные данные для уточнения совпадений.

По наименованию юридического лица

POST /api/FsspSearch/legal-entity?apiKey=YOUR_API_KEY
Content-Type: application/json

{
  "regionId":"КОД_РЕГИОНА",
  "companyName":"НАЗВАНИЕ_ОРГАНИЗАЦИИ",
  "address":"АДРЕС_ОРГАНИЗАЦИИ"
}

companyName — наименование должника (не менее трёх символов); regionId и address уточняют поиск и допускают null в модели API.

3. Поля ответа разового поиска

Все методы разового поиска возвращают JSON-объект. Поля верхнего уровня обозначают:

inn — ИНН, если он присутствует в ответе источника;
records — массив найденных записей;
columnHeaders — заголовки колонок, если переданы источником;
error — текст ошибки; проверяйте его даже при HTTP 200.

Каждый элемент records содержит строковые ячейки cell1–cell8. Их типовое назначение: должник, адрес, дата возбуждения, номер ИП, исполнительный документ, дата документа, номер документа, предмет исполнения. При отображении учитывайте columnHeaders и формат конкретного ответа источника.

Дополнительно доступны objectOfExecutiveDocuments (требования документа), objectExecution (предмет исполнения), amountPaid (сумма), departments (отдел приставов), addressDepartments (его адрес). Эти поля могут быть пустыми; суммы и даты передаются строками.

Непустое error означает ошибку поиска, а не отсутствие исполнительных производств. Пустой records без ошибки означает отсутствие найденных записей по заданным условиям; проверьте точность поисковых реквизитов.

4. Сохранить поисковый запрос

Поле name задаёт понятное пользователю название запроса, а целочисленное поле searchType выбирает один из пяти способов поиска. Ниже для каждого типа приведены назначение, параметры и пример вызова API сохранения запроса.

Все примеры используют POST /api/FsspSearch/saved-queries?apiKey=YOUR_API_KEY и JSON-тело. Команды curl записаны для Bash. Замените YOUR_API_KEY и значения-заполнители своими данными. Коды регионов и типов документов берите из справочников /api/FsspSearch/regions и /api/FsspSearch/document-types.

Успешное сохранение возвращает карточку с fsspSearchQueryId. Этот идентификатор используйте как {id} в методе выполнения. Само сохранение не запускает поиск; общий пример выполнения приведён после пяти типов.

4.1. По ИНН организации — searchType = 1

Используйте для повторной проверки юридического лица по 10-значному ИНН. Поле inn содержит ИНН организации. Сохранённый запрос выполняет тот же вид поиска, что GET /api/FsspSearch/organization.