GetOrganization¶
-
GET
/GetOrganization
¶ Query Parameters: - orgId – идентификатор организации; может отсутствовать
- boxId – идентификатор ящика; может отсутствовать
- fnsParticipantId – идентификатор участника электронного документооборота; может отсутствовать
- inn – ИНН организации; может отсутствовать
- kpp – КПП организации; может отсутствовать
Request Headers: - Authorization – необходимые данные для авторизации
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.