SendFnsRegistrationMessage
Отправляет заявление участника ЭДО для указанного ящика.
Подробнее о заявлении участника ЭДО — в статье.
POST /SendFnsRegistrationMessage
Параметры запроса
boxId— идентификатор ящика организации в формате GUID.
Заголовки запроса
Authorization— данные, необходимые для авторизации.
Тело запроса
Тело запроса должно содержать список сертификатов, представленный структурой FnsRegistrationMessageInfo:
message FnsRegistrationMessageInfo {
repeated bytes Certificates = 1;
}
Certificates— список новых сертификатов, которые ранее не были зарегистрированы в ФНС, сериализованные в массивы байтов в DER-кодировке.
Коды ответа
200— операция успешно завершена.400— данные в запросе имеют неверный формат или отсутствуют обязательные параметры.401— в запросе отсутствует HTTP-заголовокAuthorizationили в этом заголовке содержатся некорректные авторизационные данные.402— у указанного ящика закончилась подписка на API.403— доступ к ящику с предоставленным авторизационным токеном запрещен.405— используется неподходящий HTTP-метод.409— в свойствах организации не указаны ОГРН, код ИФНС, код региона.415— тип содержимого запроса не поддерживается.429— превышено ограничение на количество запросов в единицу времени.500— при обработке запроса возникла непредвиденная ошибка.
В заявлении будут отправлены все действующие сертификаты, которые были добавлены ранее, и сертификаты, переданные в поле FnsRegistrationMessageInfo.Certificates.
Данные для заявления в ФНС будут взяты из реквизитов организации.
Метод не позволяет отправить заявление для тестовой организации.
Примеры использования
Пример HTTP-запроса:
POST /SendFnsRegistrationMessage?boxId={{boxId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Content-Type: application/json; charset=utf-8
Accept: application/json
Пример тела запроса:
{
"Certificates": [
"MIIIyjCCCHegAwIBAgIRAdD...Brfw=="
]
}
См. также
Методы для работы с организациями:
- GetBox — возвращает данные ящика по указанному идентификатору
- GetMyOrganizations — возвращает список организаций, в которых пользователь является сотрудником
- GetOrCreateRoamingOrganizationByFnsParticipantId — находит или создает роуминговую организацию по идентификатору участника ЭДО
- GetOrganization — возвращает данные организации по указанному идентификатору
- GetOrganizationFeatures — возвращает список дополнительных функций организации
- GetOrganizationsByInnKpp — возвращает данные организации по ИНН
- GetOrganizationsByInnList (V2) — возвращает список организаций и их статус партнерства по списку ИНН
- GetOrganizationsByForeignTaxpayerCode — возвращает данные организации по коду иностранного налогоплательщика
- GetResolutionRoutes — возвращает список всех неудаленных включенных маршрутов согласования для указанного ящика
- Register — находит или создает в Диадоке организацию по сертификату и добавляет владельца сертификата в сотрудники этой организации
- RegisterConfirm — подтверждает владение закрытым ключом сертификата для регистрации в организацию
- SearchFnsParticipants — ищет участников ЭДО в роуминге по ИНН, КПП или идентификатору участника ЭДО
- SendFnsRegistrationMessage — отправляет заявление участника ЭДО для указанного ящика