API подсудности и подведомственности — Документация

Контуры

Тестовый

https://test.api.${URL}.ru/v3/${TARGET}?access-token=${TOKEN}

Продакшен

https://api.${URL}.ru/v3/${TARGET}?access-token=${TOKEN}

Эндпоинты

Параметр	Значение	Описание
`${URL}`	—	Домен в сети Интернет (предоставляется по запросу)
`${TOKEN}`	—	Уникальный идентификатор доступа (предоставляется по запросу)
`${TARGET}`	`ms-ssp`	Единый запрос: мировой судья + федеральный суд + ССП
	`ms`	Определение подсудности мирового судьи
	`rs`	Определение подсудности федерального суда
	`ssp`	Определение подведомственности ССП

Логика работы

1

Первый запрос

Отправляете адрес должника на Endpoint#1 и получаете id задачи.

2

Второй запрос

Отправляете полученный id на Endpoint#2 и получаете статус задачи.

3

Проверка готовности

Если is_completed = 0 — результат ещё не готов, нужно повторить запрос позже.

Если is_completed = 1 — финальный ответ готов.

Первый запрос: передача адреса

Отправляется на Endpoint#1

Поле	Тип	Описание
`id`	string	Обязательное. Идентификатор записи на стороне пользователя
`address`	string	Обязательное. Потовый адрес одной строкой
`is_auto`	boolean	Флаг для получения результата только автоматической обработки (`1` или `0`, по умолчанию `0` - с ожиданием ручной доработки)

Пример запроса

{
  "id": "debt_id",
  "address": "Волгоградская обл, г Волгоград, ул им генерала Штеменко, д 8, кв 24",
  "is_auto": 1
}

Пример ответа

{
  "id": 3682318
}

Второй запрос: получение результата

Отправляется на Endpoint#2

Поле	Тип	Описание
`id`	string	Обязательное. `id` задачи из первого ответа

Пример запроса

{
  "id": 3682318
}

Статусы ответа

Поле	Значения
`is_started`	`0` — обработка не началась, `1` — обработка началась
`is_completed`	`0` — обработка не завершена, `1` — ответ готов

Статус: ожидание обработки

{
  "is_started": 0,
  "is_completed": 0,
  "request": { ... },
  "response": null
}

Статус: в обработке

{
  "is_started": 1,
  "is_completed": 0,
  "request": { ... },
  "response": null
}

Статус: готово (успех)

{
  "is_started": 1,
  "is_completed": 1,
  "request": { ... },
  "response": {
    "ms_name": "Судебный участок № 101 ...",
    "ms_code": "34MS0119",
    "rs_name": "Краснооктябрьский районный суд ...",
    "rs_code": "34RS0005",
    "ssp_name": "Краснооктябрьское РОСП",
    "ssp_code": "34SSP40",
    "ms_address_name": "400078, обл Волгоградская, г Волгоград, ...",
    "ms_tel": "73-12-79",
    "ssp_tel": "+7(844)2 76-52-67",
    ...
  }
}

Поля финального ответа

Содержатся в объекте response, когда is_completed = 1.

Мировой суд

ms_code — код участка
ms_name — полное наименование
ms_postal_code — почтовый индекс
ms_address_name — почтовый адрес
ms_tel — телефон
ms_email — email
ms_ej — ссылка на ЭП
ms_ifns — код ИФНС
ms_oktmo — ОКТМО

Федеральный суд

rs_code — код суда
rs_name — полное наименование
rs_address_name_postindex — почтовый индекс
rs_address_name — почтовый адрес
rs_tel — телефон
rs_email — email
rs_ej — ссылка на ЭП
rs_ifns — код ИФНС
rs_oktmo — ОКТМО

Служба приставов

ssp_code — код подразделения
ssp_code_2 — краткий код
ssp_name — наименование
ssp_postal_code — почтовый индекс
ssp_address — почтовый адрес
ssp_tel — телефон
ssp_email — email
ssp_level — уровень

Реквизиты для уплаты госпошлины

В успешном ответе также возвращаются платёжные реквизиты ФНС для мирового и федерального суда.

Поле	Описание
`ms_fns_payment_rec`	Получатель платежа
`ms_fns_inn`	ИНН получателя
`ms_fns_kpp`	КПП получателя
`ms_fns_bank_ufk`	Банк получателя
`ms_fns_bik_tofk`	БИК
`ms_fns_acc_eks`	Корреспондентский счёт
`ms_fns_acc_kozn`	Номер казначейского счёта
`ms_kbk_2`	КБК

Для федерального суда поля аналогичны, но с префиксом rs_ вместо ms_.

Если адрес не найден

Когда адрес неполный или не существует, все поля ответа заполняются значением null, а status_address содержит код ошибки.

{
  "is_started": 1,
  "is_completed": 1,
  "request": { ... },
  "response": {
    "client_id": "debt_id",
    "client_address": "Волгоградская обл",
    "status_address": "NotComplete",
    "ms_code": null,
    "rs_code": null,
    "ssp_code": null,
    ...
  }
}

Получить доступ

Для получения токена и подключения к API свяжитесь с нами.

Связаться