SendFnsRegistrationMessage

Отправляет заявление участника ЭДО для указанного ящика.

Подробнее о заявлении участника ЭДО — в статье.

POST /SendFnsRegistrationMessage

Query Parameters:

• boxId – идентификатор ящика организации в формате GUID.

Request Headers:

• Authorization – данные, необходимые для авторизации.

Request Body:

Тело запроса должно содержать список сертификатов, представленный структурой FnsRegistrationMessageInfo:

message FnsRegistrationMessageInfo
{
    repeated bytes Certificates = 1;
}

• Certificates — список новых сертификатов, которые ранее не были зарегистрированы в ФНС, сериализованные в массивы байтов в DER-кодировке.

Status Codes:

• 200 OK – операция успешно завершена.

• 400 Bad Request – данные в запросе имеют неверный формат или отсутствуют обязательные параметры.

• 401 Unauthorized – в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.

• 402 Payment Required – у указанного ящика закончилась подписка на API.

• 403 Forbidden – доступ к ящику с предоставленным авторизационным токеном запрещен.

• 405 Method Not Allowed – используется неподходящий HTTP-метод.

• 409 Conflict – в свойствах организации не указаны ОГРН, код ИФНС, код региона.

• 500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.

В заявлении будут отправлены все действующие сертификаты, которые были добавлены ранее, и сертификаты, переданные в поле FnsRegistrationMessageInfo.Certificates.

Данные для заявления в ФНС будут взяты из реквизитов организации.

Метод не позволяет отправить заявление для тестовой организации.

Примеры использования

Пример HTTP-запроса:

POST /SendFnsRegistrationMessage?boxId={{boxId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: DiadocAuth ddauth_api_client_id={{client_id}}, ddauth_token={{auth_token}}
Accept: application/json; charset=utf-8
Content-Type: application/json

Пример тела запроса:

{
    "Certificates": [
        "MIIIyjCCCHegAwIBAgIRAdD...Brfw=="
    ]
}

---

См. также

Методы для работы с организациями:

• GetBox — возвращает данные ящика по указанному идентификатору

• GetMyOrganizations — возвращает список организаций, к которым пользователь имеет доступ

• GetOrganization — возвращает данные организации по указанному идентификатору

• GetOrganizationFeatures — возвращает список дополнительных функций организации

• GetOrganizationsByInnKpp — возвращает данные организации по ИНН

• GetOrganizationsByInnList (V2) — возвращает список организаций и их статус партнерства по списку ИНН

• GetResolutionRoutes — возвращает список всех неудаленных включенных маршрутов согласования для указанного ящика

• Register — находит или создает в Диадоке организацию по сертификату и добавляет владельца сертификата в сотрудники этой организации

• RegisterConfirm — подтверждает владение закрытым ключом сертификата для регистрации в организацию

• SendFnsRegistrationMessage — отправляет заявление участника ЭДО для указанного ящика