GetOrganization

GET /GetOrganization
Query Parameters:
 
  • orgId – идентификатор организации; может отсутствовать
  • boxId – идентификатор ящика; может отсутствовать
  • fnsParticipantId – идентификатор участника электронного документооборота; может отсутствовать
  • inn – ИНН организации; может отсутствовать
  • kpp – КПП организации; может отсутствовать
Request Headers:
 
Status Codes:
  • 200 OK – операция успешно завершена
  • 400 Bad Request – данные в запросе имеют неверный формат или отсутствуют обязательные параметры
  • 401 Unauthorized – в запросе отсутствует HTTP-заголовок Authorization, или в этом заголовке содержатся некорректные авторизационные данные
  • 404 Not Found – организация с указанным идентификатором не найдена в справочнике
  • 405 Method Not Allowed – используется неподходящий HTTP-метод
  • 500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка

В строке запроса должен присутствовать только один из следующих четырёх параметров: orgId, boxId, fnsParticipantId или inn. При этом kpp учитывается только в случае, если запрос осуществляется с указанием inn.

В случае поиска по ИНН метод возвращает ответ, только если найдена одна организация, при том, что в Диадоке может быть несколько ящиков с указанным ИНН. Для поиска ящиков по ИНН рекомендуем пользоваться методом GetOrganizationsByInnKpp

в случае поиска по ИНН и КПП, если организация с таким КПП не найдена, то метод вернет головную организацию с указанным ИНН.

В теле ответа содержится структура Organization.