Перейти к основному содержимому

SendFnsRegistrationMessage

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

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

POST /SendFnsRegistrationMessage

Параметры запроса

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

Заголовки запроса

Тело запроса

Тело запроса должно содержать список сертификатов, представленный структурой 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 — отправляет заявление участника ЭДО для указанного ящика

Оцените материал страницы

Нашли ошибку или столкнулись с проблемой?

СКБ Контурс 1988 года