Описание методов API сервиса МЧД.МИГ24
Авторизация
Общее
Асинхронные методы работы с сервисом
AWAIT_SENDING_TO_CPRR - ОЖИДАНИЕ ПЕРЕДАЧИ ЗАПРОСА
SEND_TO_CPRR - ЗАПРОС ПЕРЕДАН
SEND_TO_CPRR_ERROR - ОШИБКА ПРИЕМА ЗАПРОСА
PROCESSING - ОЖИДАНИЕ ПОДТВЕРЖДЕНИЯ
REJECTED- ОТКАЗ В РЕГИСТРАЦИИ
CREATED - ЗАРЕГИСТРИРОВАНА
ACTIVE - ДЕЙСТВУЕТ
REVOKED - ДЕЙСТВИЕ ПРЕКРАЩЕНО
EXPIRED - ДЕЙСТВИЕ ИСТЕКЛО
UNDEFINED - НЕОПРЕДЕЛЕН
ResponseId - Идентификатор ответа
RequestId - Идентификатор запроса
CreationDateTime - Дата и время UTCв формате [yyyy-MM-dd HH:mm:ss.ffffff]
RequestType - Тип запроса: Mchd, Revocation, GetStatus
HttpCode - Код ответа из ЦПРР
ErrorMessage - Ошибка из ЦПРР
MchdNumber - Номер МЧД
MchdStatus - Статус ответа
MchdStatusRus - Статус ответа на русском языке
ContentType - Тип контента (application/zip)
MchdFileId - Идентификатор файла архив МЧД
IsDeleted - Отмечен удаленным из очереди ответов
Методы работы со справочниками (полномочия)
Создание/загрузка МЧД в сервисе, в том числе через json
Подписание МЧД
Получить xml-файл доверенности - /api/m4d/{mchdInfoId}/xml
Возвращается xml-файл МЧДОтмена (отзыв) МЧД
Сформировать и получить xml-файл отзыва подписанной доверенности -/api/revocate/{mchdInfoId}/xml
Для формирования xml необходимо предоставление дополнительных данных. пример
Загрузить подпись sig для отмены МЧД - /api/revocate/sig
mchdInfoId - идентификатор МЧД в сервисе
Подпись отмены (отзыва) МЧД:
Шаг 1 - Передача сертификата КЭП подписанта и данных для отмены, получение хеша xml файла отмены МЧД для подписания - /api/revocate/signature/step1 примерРабота с реестром МЧД сервиса
userId - необязательны Id пользователя, создавшего МЧД. Если userId пустой, то используется ID пользователя из авторизации
Получить список всех подписанных МЧД по СНИЛС уполномоченного лица - /api/signed/{snils}
Возвращается массив данных - метод требует отдельного разрешения для использования
Получить список всех МЧД по ОГРН (ОГРНИП) доверителя - /api/mchd-infos/ogrn/{ogrn}
Возвращается массив данных - метод требует отдельного разрешения для использованияРабота существующей МЧД
Копировать МЧД - /api/m4d/{mchdInfoId}/copy
Возвращается идентификатор mchdInfoId на новую (копию) МЧД
МЧД помечается как удаленная и не показывается при просмотре. Удаление подписанной МЧД не допускается.
Обновить (изменить) тип системы хранения существующей МЧД - /api/m4d/update-storage-type
Изменение места хранения МЧД:
Изменение возможно только для неподписанной МЧД.
Получить информацию о файлах МЧД - /api/m4d/{mchdInfoId}/files-info
Возвращает список файлов, сформированных по данной МЧД (xml, sig, pdf)
Получить zip-архив файлов МЧД - /api/m4d/{mchdInfoId}/archive
Возвращается zip-архив файлов МЧДПолучить xml-файл МЧД - /api/m4d/{mchdInfoId}/xml
Возвращается xml-файл МЧДВзаимодействие с ИСХ ЦПРР ФНС
Отправить МЧД в ЦПРР ФНС /api/fns/send/{mchdInfoId}?validate=true
validate - с проверкой xml по xsd-схеме
email - Email для получения уведомления о результатах отмены.
Получить информацию о статусе и сроке действия МЧД в ЦПРР ФНС - /api/fns/check/{mchdNumber}/info
Если необходимо для номера использовать символы типа "/", то используется метод - /api/fns/check/info?number={mchdNumber}
Возвращается массив сведений.Получить информацию о полномочиях и статусе МЧД из ЦПРР ФНС
/api/fns/check-powers/{mchdNumber}/{issuerInn}Получить статус доверенности из ЦПРР ФНС и обновить его в списке МЧД
/api/fns/sync/{mchdInfoId}ОЖИДАНИЕ ПОДТВЕРЖДЕНИЯ - PROCESSING
ОТКАЗ В РЕГИСТРАЦИИ - REJECTED
ЗАРЕГИСТРИРОВАНА - CREATED
ДЕЙСТВУЕТ- ACTIVE
ДЕЙСТВИЕ ПРЕКРАЩЕНО - REVOKED
ДЕЙСТВИЕ ИСТЕКЛО - EXPIRED
Не подписана - Unsigned
Подписание не завершено - Draft
На подписании - OnRemoteSigning
Подписана - Signed
Отправлена в ЦПРР ФНС - FnsMchdSent
Ошибка при отправке в ЦПРР ФНС - FnsMchdSentError
Загружена в ЦПРР ФНС - FnsMchdLoaded
Ожидание отзыва - FnsRevocationSent
Ошибка отзыва - FnsRevocationSentError
Удалена - Deleted
{
"MchdNumber": "14ec653c-96c2-4331-8cae-4a37878a2ed3",
"StatusRus": "АКТИВНА",
"StatusEng": "ACTIVE",
"StatusDate": "26.04.2024","Powers": [ "02 - Представление отчетности", "03 - Получение документов в налоговом органе", "17 - Подписывать заявление на зачет/возврат налога", "21 - Подписывать документы (информацию)", "22 - Представлять документы (информацию)" ] }
{
"MchdNumber": "a7179ad5-c0c0-4e66-a63d-74c5910dbeaf",Взаимодействие с ИСХ МИГ24
Получить информацию о статусе и сроке действия МЧД в ИСХ МИГ24 - /api/mig24/check/info?number={mchdNumber}
Возвращается массив сведений.Получить информацию о полномочиях и статусе МЧД из ИСХ МИГ24
/api/mig24/check-powers/{mchdNumber}/{issuerInn}Возвращается массив сведений.
Загрузка МЧД в ИСХ МИГ24:
Проведение проверок использования МЧД
История изменений
Примеры интеграций
Протокол API ЦПРР ФНС