GetOrganizationUsers (V2)
Возвращает список всех пользователей организации.
Обратите внимание, что метод возвращает не сотрудников организации, а именно пользователей — то есть только учетные записи, прошедшие регистрацию в Кабинете клиента. При этом сотрудники организации, учетная запись которых не была зарегистрирована, в ответе метода не вернутся.
Чтобы получить список всех сотрудников, используйте метод GetEmployees.
GET /V2/GetOrganizationUsers
Параметры запроса
boxId— идентификатор ящика организации в формате GUID.
Заголовки запроса
Authorization— данные, необходимые для авторизации.
Коды ответа
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) — возвращает список всех пользователей организации