Skip to content

Latest commit

 

History

History
321 lines (285 loc) · 11.6 KB

vacancy_requests.md

File metadata and controls

321 lines (285 loc) · 11.6 KB

Работа с заявками

Получние списка схем заявки на вакансию

GET /account/{account_id}/account_vacancy_request

Пример ответа:

{
    "items": [
        {
            "schema": {
                "position": {
                    "type": "string",
                    "title": "Должность",
                    "required": true,
                    "order": 1,
                    "id": 1,
                    "value": null,
                    "key": "position"
                },
                "company": {
                    "type": "string",
                    "title": "Отдел, подразделение",
                    "required": false,
                    "order": 2,
                    "id": 2,
                    "value": null,
                    "key": "company"
                },
                "money": {
                    "type": "string",
                    "title": "Зарплата",
                    "required": false,
                    "order": 3,
                    "id": 3,
                    "value": null,
                    "key": "money",
                    "delimiter": true
                },
                "hard_skills": {
                    "type": "text",
                    "title": "Профессиональные качества кандидата",
                    "required": true,
                    "order": 4,
                    "id": 4,
                    "value": null,
                    "key": null
                },
                "soft_skills": {
                    "type": "text",
                    "title": "Личностные качества кандидата",
                    "required": true,
                    "order": 5,
                    "id": 5,
                    "value": null,
                    "key": null,
                    "delimiter": true
                },
                "comment": {
                    "type": "text",
                    "title": "Комментарии",
                    "required": false,
                    "order": 6,
                    "id": 6,
                    "value": null,
                    "key": null
                }
            },
            "id": 1,
            "name": "Тестовая",
            "attendee_hint": "",
            "attendee_required": null,
            "active": true
        }
    ]
}
Путь Описание
id Идентификатор схемы заявки
name Название схемы
attendee_required Флаг наличия поля "Отправить на согласование" при создании заявки (null –– поле отсутствует, false —— поле необязательное, true —— поле обязательное)
attendee_hint Подсказка под полем "Отправить на согласование"
active Флаг активности схемы
schema Описание полей схемы

Получение схемы заявки на вакансию

GET /account/{account_id}/account_vacancy_request/{account_vacancy_request_id}

Получение списка заявок на вакансию

GET /account/{account_id}/vacancy_request

Также, можно передать параметр ?vacancy_id={vacancy_id} с идентификатором вакансии для получения заявок, которые были взяты в работу по вакансии.

Пример ответа:

{
    "items": [
        {
            "status": "approved",
            "account": 1,
            "account_vacancy_request": 1,
            "created": "2018-07-10T14:50:21+03:00",
            "states": [],
            "account_info": {
                "id": 1,
                "name": "Main",
                "email": "[email protected]"
            },
            "position": "position",
            "id": 10,
            "files": [
                {
                    "id": 42,
                    "name": "Снимок экрана 2021-02-01 в 00.00.00.png",
                    "content_type": "image/png",
                    "url": "https://store.huntflow.ru/uploads/f/f/h/ffhov94xuqytbl16u8b9l3oeewdjpyoc.png"
                }
            ]
        },
        {
            "status": "approved",
            "account": 1,
            "account_vacancy_request": 1,
            "created": "2018-07-10T14:50:03+03:00",
            "states": [],
            "account_info": {
                "id": 1,
                "name": "Main",
                "email": "[email protected]"
            },
            "position": "position",
            "id": 9
        },
        {
            "status": "approved",
            "account": 3,
            "account_vacancy_request": 1,
            "created": "2018-07-10T12:26:00+03:00",
            "states": [],
            "account_info": {
                "id": 3,
                "name": "Recruiter Pavel",
                "email": "[email protected]"
            },
            "position": "Менеджер",
            "id": 7
        },
        {
            "status": "rejected",
            "account": 1,
            "account_vacancy_request": 1,
            "created": "2018-07-10T12:25:42+03:00",
            "states": [
                {
                    "status": "PENDING",
                    "changed": null,
                    "email": "[email protected]",
                    "reason": null,
                    "order": 1,
                    "id": 1
                },
                {
                    "status": "APPROVED",
                    "changed": "2018-07-11 12:56:30",
                    "email": "[email protected]",
                    "reason": null,
                    "order": 2,
                    "id": 2
                },
                {
                    "status": "REJECTED",
                    "changed": "2018-07-11 13:00:09",
                    "vacancy_request": 13,
                    "email": "[email protected]",
                    "reason": "Позиция закрыта",
                    "order": 3,
                    "id": 3
                },
            ],
            "account_info": {
                "id": 1,
                "name": "Main",
                "email": "[email protected]"
            },
            "position": "Директор",
            "id": 6
        }
    ]
}
Путь Описание
status Статус заявки
account Идентификатор пользователя, создавшего заявку
account_vacancy_request Идентификатор схемы заявки
created Дата и время создания заявки
states[].status Статус согласования
states[].changed Дата и время последнего изменения согласования
states[].email Email, по которому была отправлена заявка на согласование
states[].reason Причина отказа
states[].order Порядковый номер согласования
states[].id Идентификатор согласования
account_info.id Идентификатор пользователя, создавшего заявку
account_info.name Имя пользователя, создавшего заявку
account_info.email Email пользователя, создавшего заявку
position Название позиции
id Идентификатор заявки
files[].id Идентификатор файла, прикрепленного к заявке на вакансию
files[].name Имя файла
files[].content_type Тип файла
files[].url Ссылка на файл

Статусы заявки

Название Описание
pending Ожидание
approved Согласовано
rejected Отказано

Получение заявки на вакансию

GET /account/{account_id}/vacancy_request/{vacancy_request_id}

Создание заявки на вакансию

POST /account/{account_id}/vacancy_request

Пример запроса:

{
    "account_vacancy_request": 1
    "position": "Директор",
    "money": "25000",
    "hard_skills": "Опыт руководства производством не менее 80 лет",
    "soft_skills": "Коммуникабельность, целеустремленность, стрессоустойчивость",
    "comment": "ASAP",
    "files": [1, 2, 3]
}

Пример запроса с согласованием заявки:

{
    "account_vacancy_request": 1,    
    "position": "Директор",
    "money": "25000",
    "hard_skills": "Опыт руководства производством не менее 80 лет",
    "soft_skills": "Коммуникабельность, целеустремленность, стрессоустойчивость",
    "comment": "ASAP",
    "attendees": [
        {
            "email": "[email protected]",
            "displayName": "Ivanov Ivan"
        },
        {
            "email": "[email protected]",
            "displayName": "Petrov Petr"
        }
    ]
}

Поле attendees[].displayName опционально. Заявка будет отправлена сначала первому согласующему, а после подтверждения – второму.

account_vacancy_request – идентификатор формы заявки на вакансию, которую можно получить здесь.

files - список файлов, прикрепленных к вакансии (загрузка файлов)

Допускается два варианта передачи полей справочников (в том числе подразделений):

{
...
    "dictionary_field": 42,
...
}
  • Использовать значение foreign, указанное при создании справочника, например:
{
...
    "dictionary_field": {"foreign": "field_foreign_value"},
...
}

В данном случае, для корректной работы необходимо, чтобы в рамках одного словаря не было полей с повторяющимся значением foreign.

Взятие заявки в работу

Заявка берется в работу путем создания вакансии по этой заявке с указанием идентификатора заявки в поле vacancy_request.