Core employees

Создать карточку сотрудника

Учётная запись необязательна; роль и логин меняются в настройках кабинета, а не здесь. Реквизиты (inn, bank_bic, bank_account, phone, email, notes) без права core.employee_requisites:write не сохраняются. Контрагент сотрудника здесь не заводится — он появляется при приёме в штат. Если в «Команде» уже есть действующая карточка с той же рабочей почтой, телефоном или ИНН, ответ — 409 с кодом core.employee.duplicate и списком duplicates; повтор с allow_duplicate=true заводит карточку осознанно. Карточку без доступа заводит и кадровик с одним правом «Приглашать сотрудников» (settings.invite:write) без записи справочников. affiliation external или guest требует organization_contact_id; гость (guest) — подрядчик «только где участник», места тарифа не занимает.

post/api/v1/core/employees

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/core/employees
  • 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

Headers

X-Tenantstring required

Slug выбранного кабинета; кабинет не является юрлицом

Request body

OR
OR
OR

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.