diff --git a/docs/employer_vacancies.md b/docs/employer_vacancies.md
index 91947d01..f2cd2d04 100644
--- a/docs/employer_vacancies.md
+++ b/docs/employer_vacancies.md
@@ -23,6 +23,7 @@
## Возможные варианты публикации вакансий у текущего менеджера
Метод нужен, чтобы понять, может ли менеджер публиковать вакансии и какие типы вакансий ему доступны. Возвращает все возможные типы публикации.
+>!! Внимание! Если в вашей компании используются отделы, то будут возвращены возможные варианты публикации [выбранного отдела](manager_divisions.md#using-division).
### Запрос
@@ -140,6 +141,8 @@ publications[].areas_url | string | URL на список регионов, в
* все вакансии проходят ручную модерацию.
* в течение нескольких минут после публикации вакансия станет доступна в поиске.
+>!! Внимание! Если в вашей компании используются отделы, то вакансия будет опубликована от лица [выбранного отдела](manager_divisions.md#using-division).
+
### Полезные ссылки
@@ -575,6 +578,8 @@ Cоставные поля (например, `salary`, `contacts`, `specializat
валюты в зарплате, необходимо передавать также и значения зарплаты, а
для изменения специализации необходимо передать полный список.
+>!! Внимание! При редактировании вакансии будет указан [выбранный отдел](manager_divisions.md#using-division).
+
### Поля доступные для редактирования
Имя | Описание
diff --git a/docs/errors.md b/docs/errors.md
index 254000f1..f333f892 100644
--- a/docs/errors.md
+++ b/docs/errors.md
@@ -524,3 +524,9 @@ HTTP code | type | value | описание
```
где `allowed_accounts` содержит массив доступных для этого токена аккаунтов
Элементы массива аналогичны [результату, выдаваемому в списке рабочих аккаунтов](manager_accounts.md#account-info)
+
+
+### Отделы менеджера
+HTTP code | type | value | описание
+----------|------|-------|-----------
+400 | manager_divisions | manager_not_in_division | Менеджер не состоит в отделе. Попросите администратора добавить вас в отдел или [посмотрите доступные отделы](manager_divisions.md#get-manager-divisions)
diff --git a/docs/manager_divisions.md b/docs/manager_divisions.md
new file mode 100644
index 00000000..2983690a
--- /dev/null
+++ b/docs/manager_divisions.md
@@ -0,0 +1,85 @@
+# Отделы менеджера
+
+Менеджер может выполнять действия от лица нескольких отделов. Для взаимодействия с API в контексте определенного
+отдела работодателя нужно использовать соответсвующий отдел.
+У пользователя может быть несколько отделов, один из них является текущим. Какой отдел является текущим можно узнать,
+получив [список отделов менеджера](#get-manager-divisions). Текущий отдела используется, если в качестве авторизации посылать только токен
+(подробнее можно прочитать [здесь](#using-division)).
+
+* [Получение списка отделов пользователя](#get-manager-divisions)
+* [Выбор отдела при запросах](#using-division)
+
+
+## Получение списка отделов пользователя
+
+### Запрос
+
+```
+GET /manager_divisions/mine
+```
+
+### Ответ
+
+Успешный ответ приходит с кодом `200 OK` и содержит тело:
+
+```json
+{
+ "found": 2,
+ "page": 0,
+ "pages": 1,
+ "per_page": 2,
+ "items": [
+ {
+ "id": "1",
+ "name": "Департамент персонала"
+ },
+ {
+ "id": "2",
+ "name": "Департамент продаж"
+ }
+ ],
+ "current_division_id": "2"
+}
+```
+
+где:
+
+Имя | Тип | Описание
+--- | --- | ------
+items | список | список отделов менеджера
+current_division_id | строка | идентификатор текущего отдела (совпадает со значением переданного в заголовке)
+
+
+#### Объект `division`
+
+Имя | Тип | Описание
+--- | --- | ------
+id | строка | идентификатор отдела
+name | строка | название отдела компании
+
+### Ошибки
+
+* `403 Forbidden` — ошибка авторизации (пользователь не является менеджером)
+* `404 Not Found` — нет отделов у менеджера
+
+
+
+## Выбор отдела при запросах
+
+Для работы под определенным отделом необходимо передать значение `division_id`, полученное из [списка](#get-manager-divisions), в заголовке:
+
+```
+X-Manager-Division-Id: {division_id}
+```
+
+Использовать данный заголовок можно во всех методах, доступных для работодателей.
+
+В заголовке можно передавать `division_id` текущего отдела, который также подразумевается по умолчанию, при отсутсвии заголовка.
+
+
+
+## Ошибки
+
+* `403 Forbidden` — ошибка авторизации (при запросах с авторизацией не работодателя)
+* `404 Not Found` — отдел с переданным `division_id` не найден
+* [Дополнительные ошибки с описанием причины](/docs/errors.md#manager-divisions).
diff --git a/docs/resumes.md b/docs/resumes.md
index de68bc1d..2c81cf4c 100644
--- a/docs/resumes.md
+++ b/docs/resumes.md
@@ -234,6 +234,8 @@ paid_services | object | [платные услуги по резюме для
>!! Внимание произошли изменения в доступе к контактной информации. Прочитайте внимательно информацию про [поконтактный доступ к резюме](payable/resume.md#contact-data)
+>!! Внимание! Если в вашей компании используются отделы, то контакт будет списан у [выбранного отдела](manager_divisions.md#using-division).
+
Для авторизованного автора возвращается
[более детальная информация](#additional-author-fields), включая тип
видимости, комментарии модераторов и статус.
diff --git a/docs/vacancies.md b/docs/vacancies.md
index 5eb69c86..516cd439 100644
--- a/docs/vacancies.md
+++ b/docs/vacancies.md
@@ -386,7 +386,10 @@ suitable_resumes_url | string | Подходящие резюме на вака
"id": "marketing",
"name": "Маркетинг"
},
- "can_upgrade_billing_type": true
+ "can_upgrade_billing_type": true,
+ "division": {
+ "id": "123"
+ }
}
```
@@ -399,6 +402,8 @@ can_upgrade_billing_type | логический | Можно ли улучшит
В объекте `manager` — информация о менеджере, который разместил данную вакансию.
+В объекте `division` — информация об отделе, от которого размещена данная вакансия.
+
В объекте `branded_template` — информация об используемом в вакансии
[брендированном шаблоне](employer_vacancy_branded_templates.md).