HH-123770 отделы работодателей

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).
+
 
 ### Полезные ссылки
 

docs/errors.md

@@ -524,3 +524,9 @@ HTTP code | type | value | описание
 ```
 где `allowed_accounts` содержит массив доступных для этого токена аккаунтов
 Элементы массива аналогичны [результату, выдаваемому в списке рабочих аккаунтов](manager_accounts.md#account-info)
+
+<a name="manager-divisions"></a>
+### Отделы менеджера
+HTTP code | type | value | описание
+----------|------|-------|-----------
+400 | manager_divisions | manager_not_in_division | Менеджер не состоит в отделе. Попросите администратора добавить вас в отдел или [посмотрите доступные отделы](manager_divisions.md#get-manager-divisions)

docs/manager_divisions.md

@@ -0,0 +1,80 @@
+# Отделы менеджера
+
+Менеджер может выполнять действия от лица нескольких отделов. Для взаимодействия с API в контексте определенного
+отдела работодателя нужно использовать соответсвующий отдел.
+У пользователя может быть несколько отделов, один из них является текущим. Какой отдел является текущим можно узнать,
+получив [список отделов менеджера](#get-manager-divisions). Текущий отдела используется, если в качестве авторизации посылать только токен
+(подробнее можно прочитать [здесь](#using-division)).
+
+* [Получение списка отделов пользователя](#get-manager-divisions)
+* [Выбор отдела при запросах](#using-division)
+
+<a name="get-manager-divisions"></a>
+## Получение списка отделов пользователя
+
+### Запрос
+
+```
+GET /manager_divisions/mine
+```
+
+### Ответ
+
+Успешный ответ приходит с кодом `200 OK` и содержит тело:
+
+```json
+{
+    "items": [
+        {
+            "id": "1",
+            "name": "Департамент персонала"
+        },
+        {
+            "id": "2",
+            "name": "Департамент продаж"
+        }
+    ],
+    "current_division_id": "2"
+}
+```
+
+где:
+
+Имя | Тип | Описание
+--- | --- | ------
+items | список | список отделов менеджера
+current_division_id | строка | идентификатор текущего отдела (совпадает со значением переданного в заголовке)
+
+<a name="division-info"></a>
+#### Объект `division`
+
+Имя | Тип | Описание
+--- | --- | ------
+id | строка | идентификатор отдела
+name | строка | название отдела компании
+
+### Ошибки
+
+* `403 Forbidden` — ошибка авторизации (пользователь не является менеджером)
+
+
+<a name="using-division"></a>
+## Выбор отдела при запросах
+
+Для работы под определенным отделом необходимо передать значение `division_id`, полученное из [списка](#get-manager-divisions), в заголовке:
+
+```
+X-Manager-Division-Id: {division_id}
+```
+
+Использовать данный заголовок можно во всех методах, доступных для работодателей.
+
+В заголовке можно передавать `division_id` текущего отдела, который также подразумевается по умолчанию, при отсутсвии заголовка.
+
+
+<a name="errors"></a>
+## Ошибки
+
+* `403 Forbidden` — ошибка авторизации (при запросах с авторизацией не работодателя)
+* `404 Not Found` — отдел с переданным `division_id` не найден
+* [Дополнительные ошибки с описанием причины](/docs/errors.md#manager-divisions).

docs/resumes.md

@@ -234,6 +234,8 @@ paid_services | object | [платные услуги по резюме для 
 
 >!! Внимание произошли изменения в доступе к контактной информации. Прочитайте внимательно информацию про [поконтактный доступ к резюме](payable/resume.md#contact-data)
 
+>!! Внимание! Если в вашей компании используются отделы, то контакт будет списан у [выбранного отдела](manager_divisions.md#using-division).
+
 Для авторизованного автора возвращается
 [более детальная информация](#additional-author-fields), включая тип
 видимости, комментарии модераторов и статус.