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

Работа с сотрудниками

В одном ящике могут работать одновременно несколько сотрудников. Возможности работы с сотрудниками в API Диадока описаны ниже.

к сведению

Добавление, обновление и удаление сотрудников доступно только администраторам ящика.

Добавление сотрудника

Чтобы добавить сотрудника в ящик, используйте метод CreateEmployee.

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

POST /CreateEmployee?boxId={{boxid}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Content-Type: application/json; charset=utf-8
Accept: application/json

Пример тела запроса метода CreateEmployee:

{
"Credentials": {
"Login": {
"Login": "email@example.com",
"FullName": {
"LastName": "Иванов",
"FirstName": "Иван",
"MiddleName": "Иванович"
}
}
},
"Position": "Бухгалтер",
"CanBeInvitedForChat": false,
"Permissions": {
"UserDepartmentId": "00000000-0000-0000-0000-000000000000",
"IsAdministrator": false,
"DocumentAccessLevel": "DepartmentAndSubdepartments",
"Actions": [
{ "Name": "CreateDocuments", "IsAllowed": true },
{ "Name": "DeleteRestoreDocuments", "IsAllowed": true },
{ "Name": "SignDocuments", "IsAllowed": true },
{ "Name": "AddResolutions", "IsAllowed": false },
{ "Name": "RequestResolutions", "IsAllowed": false },
{ "Name": "ManageCounteragents", "IsAllowed": true }
]
}
}

Изменение настроек сотрудника

Обновление данных сотрудника

Получить актуальную информацию о сотруднике можно с помощью метода GetEmployee.

Чтобы обновить данные сотрудника, используйте метод UpdateEmployee. Метод позволяет изменить следующие свойства сотрудника:

  • должность,
  • подразделение,
  • доступ к текущему ящику,
  • перечень подразделений, с которыми можно работать,
  • набор прав,
  • возможность получать сообщения во встроенном чате веб-интерфейса.

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

POST /UpdateEmployee?boxid={{boxid}}&userid={{userid}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Content-Type: application/json; charset=utf-8
Accept: application/json

Пример тела запроса метода UpdateEmployee:

{
"Permissions": {
"DocumentAccessLevel": {
"DocumentAccessLevel": "SelectedDepartments"
},
"SelectedDepartments": {
"SelectedDepartmentIds": [
"b651ed54-04d8-4ca8-99b5-960fba733147",
]
},
},
"Position": {
"Position": "Главный бухгалтер"
}
}

Управление правами сотрудника

Набор прав сотрудника задается списком действий в виде структур EmployeeAction: в поле Name — идентификатор действия, а в поле IsAllowed — признак, разрешено ли оно сотруднику. Список возможных значений Name приведен в структуре EmployeeAction.

Чтобы выдать или отозвать право, передайте нужное действие в методах:

Пример тела запроса метода UpdateEmployee:

{
"Permissions": {
"Department": {
"DepartmentId": "11c8276b-815f-4191-adea-c0f884429624"
},
"IsAdministrator": {
"IsAdministrator": true
},
"Actions": [
{ "Name": "ManageCounteragents", "IsAllowed": true },
{ "Name": "SignDocuments", "IsAllowed": false }
]
},
"CanBeInvitedForChat": {
"CanBeInvitedForChat": true
}
}

Получить информацию о правах сотрудника можно с помощью методов:

Подписание документов сертификатом «Госключ»

Чтобы сотрудник мог подписывать документы сертификатом «Госключ» физического лица, передайте значение UseGoskey в поле Name структуры EmployeeAction. В структуре OrganizationUserPermissions этому праву соответствует поле CanUseGoskeyFL.

Подписание документов сертификатом «Госключ» методом DssSign (V2) доступно только при установленном праве. Параметр includeGoskeyCertificates метода GetMyCertificates влияет на работу метода только в случае, если у авторизованного пользователя в указанном ящике установлено это право.

Если отключить право «Использовать УКЭП Госключ» (UseGoskey) сотруднику, у которого сертификат «Госключ» был выбран сертификатом по умолчанию, то сертификат «Госключ» перестанет быть сертификатом по умолчанию. Пока право отозвано, метод GetMyCertificates не возвращает сертификаты «Госключ» независимо от параметра includeGoskeyCertificates. Когда право снова будет включено, все сертификаты «Госключ» вернутся со значением IsDefault = false.

Создание и отправка платежек в банки

Чтобы сотрудник мог создавать и отправлять платежки в банки в веб-интерфейсе Диадока, передайте значение CreatePaymentOrders в поле Name структуры EmployeeAction. В структуре OrganizationUserPermissions этому праву соответствует поле CanCreatePaymentOrders.

к сведению

Через API можно только получать и управлять правом сотрудника CreatePaymentOrders: создание и отправка платежек доступны в веб-интерфейсе Диадока.

Работа с МЧД сотрудника

Инструкция по работе с доверенностями сотрудника приведена в разделе Работа с МЧД сотрудника. Изменять настройки МЧД сотрудника может сам сотрудник или администратор ящика.

Подписка сотрудника на почтовые уведомления

Сотрудник может получать уведомления на почту о новых документах, результатах согласования, приглашениях от контрагентов и прочих событиях в Диадоке. Виды событий для подписки перечислены в структуре Subscription. Получить информацию о текущих подписках сотрудника можно с помощью метода GetSubscriptions.

Чтобы изменить подписки сотрудника, используйте метод UpdateSubscriptions. Изменять подписки сотрудника может сам сотрудник или администратор ящика.

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

POST /UpdateSubscriptions?boxId={{boxId}}&userId={{userId}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Content-Type: application/json; charset=utf-8
Accept: application/json

Пример тела запроса метода UpdateSubscriptions:

{
"Subscriptions": [
{ "Id": "NewIncomingDocuments", "IsSubscribed": "true" },
{ "Id": "News", "IsSubscribed": "false" }
]
}

Удаление сотрудника

Чтобы удалить сотрудника, используйте метод DeleteEmployee.

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

POST /DeleteEmployee?boxid={{boxid}}&userid={{userid}} HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
Accept: application/json

Получение информации о сотруднике

С помощью следующих методов можно получить информацию:

  • GetEmployee — о конкретном сотруднике организации;
  • GetEmployees — обо всех сотрудниках организации;
  • GetEmployeesByExternalId — о сотрудниках с указанным идентификатором учетной записи в системе SSO-провайдера;
  • GetMyEmployee — о текущем сотруднике, от имени которого вызывается метод;
  • GetSubscriptions — о подписках сотрудника на почтовые уведомления.

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

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

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