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

GetOrganizationUsers (V2)

Возвращает список всех пользователей организации.

Обратите внимание, что метод возвращает не сотрудников организации, а именно пользователей — то есть только учетные записи, прошедшие регистрацию в Кабинете клиента. При этом сотрудники организации, учетная запись которых не была зарегистрирована, в ответе метода не вернутся.

Чтобы получить список всех сотрудников, используйте метод GetEmployees.

GET /V2/GetOrganizationUsers

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

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

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

Коды ответа

  • 200 — операция успешно завершена.
  • 400 — данные в запросе имеют неверный формат или отсутствуют обязательные параметры.
  • 401 — в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.
  • 402 — у указанного ящика закончилась подписка на API.
  • 403 — доступ к ящику с предоставленным авторизационным токеном запрещен.
  • 404 — не найден ящик с указанным идентификатором.
  • 405 — используется неподходящий HTTP-метод.
  • 429 — превышено ограничение на количество запросов в единицу времени.
  • 500 — при обработке запроса возникла непредвиденная ошибка.

Тело ответа

Тело ответа содержит список всех пользователей организации, представленный структурой OrganizationUsersList.

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

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

GET /V2/GetOrganizationUsers?boxId={{boxId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json

Пример тела ответа:

{
"CurrentUserId": "6dc8c481-7cec-4675-8fd3-711cbe752eaa",
"Users": [
{
"Id": "6dc8c481-7cec-4675-8fd3-711cbe752eaa",
"Name": "Иванов Иван Иванович",
"Permissions": {
"AuthorizationPermission": {
"IsBlocked": false
},
"CanAddResolutions": false,
"CanCreateDocuments": true,
"CanDeleteRestoreDocuments": true,
"CanManageCounteragents": true,
"CanRequestResolutions": false,
"CanSendDocuments": false,
"CanSignDocuments": true,
"DocumentAccessLevel": "DepartmentAndSubdepartments",
"IsAdministrator": false,
"JobTitle": "Директор",
"SelectedDepartmentIds": [
],
"UserDepartmentId": "00000000-0000-0000-0000-000000000000"
},
"Position": "Директор"
},
{
"Id": "4b5a02e7-1b9a-4d97-8dc7-1c7eed1ccbfc",
"Name": "Петров Виктор Викторович",
"Permissions": {
"AuthorizationPermission": {
"IsBlocked": false
},
"CanAddResolutions": true,
"CanCreateDocuments": true,
"CanDeleteRestoreDocuments": true,
"CanManageCounteragents": true,
"CanRequestResolutions": true,
"CanSendDocuments": false,
"CanSignDocuments": false,
"DocumentAccessLevel": "DepartmentAndSubdepartments",
"IsAdministrator": true,
"JobTitle": "Главный бухгалтер",
"SelectedDepartmentIds": [
],
"UserDepartmentId": "17969b71-a3a1-4484-a4f0-5091931afc3d"
},
"Position": "Главный бухгалтер"
}
]
}

См. также

Инструкции:

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

  • GetBox — возвращает данные ящика по указанному идентификатору
  • GetMyOrganizations — возвращает список организаций, в которых пользователь является сотрудником
  • GetOrCreateRoamingOrganizationByFnsParticipantId — находит или создает роуминговую организацию по идентификатору участника ЭДО
  • GetOrganization — возвращает данные организации по указанному идентификатору
  • GetOrganizationFeatures — возвращает список дополнительных функций организации
  • GetOrganizationsByInnKpp — возвращает данные организации по ИНН
  • GetOrganizationsByInnList (V2) — возвращает список организаций и их статус партнерства по списку ИНН
  • GetOrganizationsByForeignTaxpayerCode — возвращает данные организации по коду иностранного налогоплательщика
  • GetResolutionRoutes — возвращает список всех неудаленных включенных маршрутов согласования для указанного ящика
  • Register — находит или создает в Диадоке организацию по сертификату и добавляет владельца сертификата в сотрудники этой организации
  • RegisterConfirm — подтверждает владение закрытым ключом сертификата для регистрации в организацию
  • SearchFnsParticipants — ищет участников ЭДО в роуминге по ИНН, КПП или идентификатору участника ЭДО
  • SendFnsRegistrationMessage — отправляет заявление участника ЭДО для указанного ящика

Методы для работы с пользователями:

  • GetMyUser (V2) — возвращает данные текущего авторизованного пользователя
  • GetOrganizationUsers (V2) — возвращает список всех пользователей организации

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

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

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