REST API DropCat: загрузка МЧД из узла ФНС
POST /requestPoaByNumber
Метод предназначен для загрузки МЧД на платформу из узла ФНС.
Формат запроса
Запрос следует отправлять с помощью метода POST.
/requestPoaByNumber
? [id_type= <тип идентификатора>]
& [org_id= <идентификатор>]
Параметры запроса
| Параметр | Пример значения | Описание | Тип параметра | Тип данных |
|---|---|---|---|---|
| id_type* | gln |
Тип идентификатора организации. Принимает значения: gln или fns. |
query | string |
| org_id* | 2000000009994 | Идентификатор запроса организации-инициатора запроса. | query | string |
* Обязательный параметр.
В теле запроса передается json с массивом МЧД, которые должны быть добавлены на платформу из узла ФНС.
Ключи json
| Параметр | Пример значения | Описание |
|---|---|---|
| poanumber* | cccdedd0-270a-4e8f-bf32-9c6cdb07e9c | Номер машиночитаемой доверенности (МЧД), подтверждающей полномочия подписанта |
| representativeInn* | 5646464644 | ИНН доверенного лица |
| principalInn | 1233468333 | ИНН доверителя |
*Обязательный параметр.
Формат ответа
Если запрос был обработан без ошибок, API отвечает кодом 200.
Если запрос вызвал ошибку, возвращается подходящий код ответа, а тело ответа содержит описание ошибки.
URL запроса
https://dapi-preprod.ediweb.ru/edi/api/v1.1/requestPoaByNumber?id_type=gln&org_id=1234567654321
Тело ответа
{"poaInfos":
[{"state":"Направлен запрос на скачивание МЧД из узла ФНС","poaNumber":"33336e24-0621-41d7-a55d-59e7c96a3515"},
{"state":"Направлен запрос на скачивание МЧД из узла ФНС","poaNumber":"2222e24-0621-41d7-a55d-59e7c96a3515"},
{"state":"Активный","poaNumber":"0b516e24-0621-41d7-a30d-59e7c96a3418"},
{"state":"Направлен запрос на скачивание МЧД из узла ФНС","poaNumber":"11116e24-0621-41d7-a365-59e7c96a3518"}],
"correlationId":"960be840-14b4-4f50-beca-b3b4fc826824"}
Для уточнения статуса загрузки МЧД необходимо вызвать метод повторно. При успешной загрузке статус по МЧД из "Направлен запрос на скачивание МЧД из узла ФНС" перейдет в "Активный".
HTTP код ответа
200
Заголовки ответа
{
"connection": "keep-alive",
"content-encoding": "gzip",
"content-length": "282",
"content-type": "text/plain; charset=UTF-8",
"date": "Thu, 29 Jan 2026 15:00:52 GMT",
"request_uuid": "56789f94-2cb7-4120-bd1a-c0a1f7af4278",
"server": "nginx"
}