Core employees

Частично изменить карточку сотрудника

Nullable-ссылки и employed_at можно явно очистить значением null. Реквизиты (inn, bank_bic, bank_account, phone, email, notes) без права core.employee_requisites:write не применяются, хранимые значения остаются прежними.

patch/api/v1/core/employees/{id}

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/core/employees/{id}
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Api-Key
    • OAuth 2 (authorization code, authorization URL https://erp.akeda.ru/oauth2/authorize, token URL https://erp.akeda.ru/oauth2/token, scopes: akeda:delegate)
    • HTTP bearer

Request body

full_namestring
first_namestring
last_namestring
middle_namestring
positionstring nullable
position_idstring uuid nullable
company_idstring uuid nullable
departmentstring
department_idstring uuid nullable

Подразделение — элемент справочника departments; null — вне оргструктуры

locationstring
phonestring
emailstring
user_idinteger nullable
manager_employee_idstring uuid nullable

Не задаётся: руководителя вычисляет оргструктура. Новое значение отклоняется кодом core.employee.manager_derived, прежнее пропускается

employed_atstring date nullable
is_activeboolean
notesstring
innstring

Применяется только с правом core.employee_requisites:write

bank_bicstring

Применяется только с правом core.employee_requisites:write

bank_accountstring

Применяется только с правом core.employee_requisites:write

affiliation'own' | 'external' | 'guest'

Смена принадлежности. Внешнему и гостю нужна организация, иначе 400 core.employee.affiliation_invalid. Принятого в штат внешним или гостем не сделать — 409 core.employee.external_hired. Перевод гостя с доступом в own или external занимает место тарифа: мест нет — 409 core.employee.seat_limit

organization_contact_idstring uuid nullable

Контрагент-организация внешнего участника; null снимает ссылку

Response

Обновлённая карточка

idstring uuid required
full_namestring required
first_namestring required
last_namestring required
middle_namestring required
positionstring required
position_idstring uuid nullable required
position_labelstring required
company_idstring uuid nullable required
company_namestring required
departmentstring required
locationstring required
manager_employee_idstring uuid nullable required

Руководитель из оргструктуры: руководитель подразделения сотрудника, а у самого руководителя — руководитель выше по дереву. Пересчитывается при любом изменении структуры

manager_namestring required
phonestring required

Пусто у чужой карточки без права core.employee_requisites:read

emailstring required

Пусто у чужой карточки без права core.employee_requisites:read

user_idinteger nullable required
usernamestring required
role_namestring required
employed_atstring required

Date or empty string

is_activeboolean required
notesstring required

Пусто у чужой карточки без права core.employee_requisites:read

has_photoboolean required
created_atstring date-time required
updated_atstring date-time required
innstring

ИНН для выплаты; пусто у чужой карточки без права core.employee_requisites:read

bank_bicstring

БИК банка выплаты; пусто у чужой карточки без права core.employee_requisites:read

bank_accountstring

Счёт или карта выплаты; пусто у чужой карточки без права core.employee_requisites:read

affiliation'own' | 'external' | 'guest' required

own — свой человек кабинета, external — внешний участник: интегратор, аутсорс; guest — гость-подрядчик: видит только задачи, чаты и папки, куда его позвали, места тарифа не занимает. Внешний и гость не стоят в оргструктуре и штате и руководителем не выбираются

organization_contact_idstring uuid nullable required

Контрагент-организация, от которой пришёл внешний участник

organization_namestring required

Название организации внешнего участника

Changes

No recorded changes to this operation across all 1 revision of this API.