Перейти к содержимому
HallifyРазработчикамПоиск по документации
Открыть Hallify
Разделы

Вакансии

Подать заявку на публичную вакансию

POST/workforce/careers/postings/{publicSlug}/apply

После проверки актуального уведомления о персональных данных и доступности вакансии атомарно создаёт кандидата, заявку, начальную историю этапа APPLIED, сессию кандидата и запись аудита. Повторный ключ подачи возвращает существующую заявку, если исходная транзакция уже завершилась. Подача публичная; дальнейший доступ защищён возвращённым токеном кандидата.

Авторизация

Учётная запись Hallify не требуется. Соблюдайте предварительные условия и ограничения этого метода.

Руководство по подключению

Параметры

publicSlugПуть · Обязательно

Стабильный публичный slug опубликованной вакансии. Не является ключом кандидата.

string
Полное определение
{
  "type": "string",
  "example": "example"
}

Тело запроса

Обязательно

После проверки актуального уведомления о персональных данных и доступности вакансии атомарно создаёт кандидата, заявку, начальную историю этапа APPLIED, сессию кандидата и запись аудита.

application/json

PublicCandidateApplicationDto
Полное определение
{
  "$ref": "#/components/schemas/PublicCandidateApplicationDto"
}

Ответы

201Созданная заявка на этапе APPLIED, токен кабинета кандидата и срок его действия.
PublicApplicationCreatedDto
Полное определение
{
  "$ref": "#/components/schemas/PublicApplicationCreatedDto"
}
Пример ответа · 201 · application/json
{
  "application": {
    "id": "0120f0fe-6880-47e8-895d-c092d269cdd1",
    "requisitionTitle": "Example title",
    "currentStage": {
      "id": "f97fe865-5ff8-488a-8fab-9e27e748514c",
      "code": "EXAMPLE",
      "name": "Example name",
      "category": "APPLIED",
      "isTerminal": true,
      "sortOrder": 1,
      "revision": 1
    },
    "status": "ACTIVE",
    "appliedAt": "2026-01-15T12:00:00.000Z",
    "updatedAt": "2026-01-15T13:00:00.000Z",
    "revision": 1,
    "canWithdraw": true
  },
  "candidatePortalToken": "synthetic-example-credential",
  "candidatePortalTokenExpiresAt": "2026-12-31T18:00:00.000Z"
}

Схемы

PublicCandidateApplicationDto

После проверки актуального уведомления о персональных данных и доступности вакансии атомарно создаёт кандидата, заявку, начальную историю этапа APPLIED, сессию кандидата и запись аудита.

submissionKeyОбязательно

UUID Hallify для submissionKey.

string · uuid
Полное определение
{
  "type": "string",
  "format": "uuid",
  "description": "UUID Hallify для `submissionKey`.",
  "example": "e8d3f2b3-bd92-4056-8aa4-7c77fa2f8e4b"
}
firstNameОбязательно

Понятное человеку значение firstName. Ограничения: максимальная длина 120.

string
Полное определение
{
  "type": "string",
  "maxLength": 120,
  "description": "Понятное человеку значение `firstName`. Ограничения: максимальная длина 120.",
  "example": "Example"
}
lastNameОбязательно

Понятное человеку значение lastName. Ограничения: максимальная длина 120.

string
Полное определение
{
  "type": "string",
  "maxLength": 120,
  "description": "Понятное человеку значение `lastName`. Ограничения: максимальная длина 120.",
  "example": "User"
}
preferredNameНеобязательно

Понятное человеку значение preferredName. Ограничения: максимальная длина 120. Null означает отсутствие записанного значения в этом представлении.

string · null
Полное определение
{
  "type": "string",
  "maxLength": 120,
  "nullable": true,
  "description": "Понятное человеку значение `preferredName`. Ограничения: максимальная длина 120. Null означает отсутствие записанного значения в этом представлении.",
  "example": "Example name"
}
emailОбязательно

Адрес электронной почты email. Ограничения: максимальная длина 254.

string · email
Полное определение
{
  "type": "string",
  "maxLength": 254,
  "description": "Адрес электронной почты `email`. Ограничения: максимальная длина 254.",
  "format": "email",
  "example": "user@example.test"
}
phoneНеобязательно

Номер телефона phone. Ограничения: максимальная длина 32. Null означает отсутствие записанного значения в этом представлении.

string · null
Полное определение
{
  "type": "string",
  "maxLength": 32,
  "nullable": true,
  "description": "Номер телефона `phone`. Ограничения: максимальная длина 32. Null означает отсутствие записанного значения в этом представлении.",
  "example": "+995555000000"
}
coverLetterНеобязательно

Сопроводительное письмо coverLetter. Ограничения: максимальная длина 20000. Null означает отсутствие записанного значения в этом представлении.

string · null
Полное определение
{
  "type": "string",
  "maxLength": 20000,
  "nullable": true,
  "description": "Сопроводительное письмо `coverLetter`. Ограничения: максимальная длина 20000. Null означает отсутствие записанного значения в этом представлении.",
  "example": "example"
}
sourceНеобязательно

Классификация происхождения источника source. Ограничения: максимальная длина 120. Null означает отсутствие записанного значения в этом представлении.

string · null
Полное определение
{
  "type": "string",
  "maxLength": 120,
  "nullable": true,
  "description": "Классификация происхождения источника `source`. Ограничения: максимальная длина 120. Null означает отсутствие записанного значения в этом представлении.",
  "example": "example"
}
privacyNoticeVersionОбязательно

Версия уведомления о персональных данных privacyNoticeVersion.

string
Полное определение
{
  "type": "string",
  "default": "2026-07-28",
  "description": "Версия уведомления о персональных данных `privacyNoticeVersion`.",
  "example": "2026-07-28"
}
Полное определение
{
  "type": "object",
  "properties": {
    "submissionKey": {
      "type": "string",
      "format": "uuid",
      "description": "UUID Hallify для `submissionKey`.",
      "example": "e8d3f2b3-bd92-4056-8aa4-7c77fa2f8e4b"
    },
    "firstName": {
      "type": "string",
      "maxLength": 120,
      "description": "Понятное человеку значение `firstName`. Ограничения: максимальная длина 120.",
      "example": "Example"
    },
    "lastName": {
      "type": "string",
      "maxLength": 120,
      "description": "Понятное человеку значение `lastName`. Ограничения: максимальная длина 120.",
      "example": "User"
    },
    "preferredName": {
      "type": "string",
      "maxLength": 120,
      "nullable": true,
      "description": "Понятное человеку значение `preferredName`. Ограничения: максимальная длина 120. Null означает отсутствие записанного значения в этом представлении.",
      "example": "Example name"
    },
    "email": {
      "type": "string",
      "maxLength": 254,
      "description": "Адрес электронной почты `email`. Ограничения: максимальная длина 254.",
      "format": "email",
      "example": "user@example.test"
    },
    "phone": {
      "type": "string",
      "maxLength": 32,
      "nullable": true,
      "description": "Номер телефона `phone`. Ограничения: максимальная длина 32. Null означает отсутствие записанного значения в этом представлении.",
      "example": "+995555000000"
    },
    "coverLetter": {
      "type": "string",
      "maxLength": 20000,
      "nullable": true,
      "description": "Сопроводительное письмо `coverLetter`. Ограничения: максимальная длина 20000. Null означает отсутствие записанного значения в этом представлении.",
      "example": "example"
    },
    "source": {
      "type": "string",
      "maxLength": 120,
      "nullable": true,
      "description": "Классификация происхождения источника `source`. Ограничения: максимальная длина 120. Null означает отсутствие записанного значения в этом представлении.",
      "example": "example"
    },
    "privacyNoticeVersion": {
      "type": "string",
      "default": "2026-07-28",
      "description": "Версия уведомления о персональных данных `privacyNoticeVersion`.",
      "example": "2026-07-28"
    }
  },
  "required": [
    "submissionKey",
    "firstName",
    "lastName",
    "email",
    "privacyNoticeVersion"
  ],
  "description": "После проверки актуального уведомления о персональных данных и доступности вакансии атомарно создаёт кандидата, заявку, начальную историю этапа APPLIED, сессию кандидата и запись аудита.",
  "example": {
    "submissionKey": "e8d3f2b3-bd92-4056-8aa4-7c77fa2f8e4b",
    "firstName": "Example",
    "lastName": "User",
    "email": "user@example.test",
    "privacyNoticeVersion": "2026-07-28"
  }
}
PublicApplicationCreatedDto

Созданная заявка на этапе APPLIED, токен кабинета кандидата и срок его действия.

applicationОбязательно

Заявка кабинета кандидата, вложенная в поле application ответа о создании публичной заявки.

allOf
Полное определение
{
  "allOf": [
    {
      "$ref": "#/components/schemas/CandidatePortalApplicationDto"
    }
  ],
  "description": "Заявка кабинета кандидата, вложенная в поле application ответа о создании публичной заявки.",
  "example": {
    "id": "0120f0fe-6880-47e8-895d-c092d269cdd1",
    "requisitionTitle": "Example title",
    "currentStage": {
      "id": "f97fe865-5ff8-488a-8fab-9e27e748514c",
      "code": "EXAMPLE",
      "name": "Example name",
      "category": "APPLIED",
      "isTerminal": true,
      "sortOrder": 1,
      "revision": 1
    },
    "status": "ACTIVE",
    "appliedAt": "2026-01-15T12:00:00.000Z",
    "updatedAt": "2026-01-15T13:00:00.000Z",
    "revision": 1,
    "canWithdraw": true
  }
}
candidatePortalTokenОбязательно

Ключ кабинета кандидата, показываемый один раз. Сохраняется только его хеш.

string
Полное определение
{
  "type": "string",
  "description": "Ключ кабинета кандидата, показываемый один раз. Сохраняется только его хеш.",
  "example": "synthetic-example-credential"
}
candidatePortalTokenExpiresAtОбязательно

Срок действия токена кабинета кандидата; после этого момента токен отклоняется.

string · date-time
Полное определение
{
  "type": "string",
  "description": "Срок действия токена кабинета кандидата; после этого момента токен отклоняется.",
  "format": "date-time",
  "example": "2026-12-31T18:00:00.000Z"
}
Полное определение
{
  "type": "object",
  "properties": {
    "application": {
      "allOf": [
        {
          "$ref": "#/components/schemas/CandidatePortalApplicationDto"
        }
      ],
      "description": "Заявка кабинета кандидата, вложенная в поле application ответа о создании публичной заявки.",
      "example": {
        "id": "0120f0fe-6880-47e8-895d-c092d269cdd1",
        "requisitionTitle": "Example title",
        "currentStage": {
          "id": "f97fe865-5ff8-488a-8fab-9e27e748514c",
          "code": "EXAMPLE",
          "name": "Example name",
          "category": "APPLIED",
          "isTerminal": true,
          "sortOrder": 1,
          "revision": 1
        },
        "status": "ACTIVE",
        "appliedAt": "2026-01-15T12:00:00.000Z",
        "updatedAt": "2026-01-15T13:00:00.000Z",
        "revision": 1,
        "canWithdraw": true
      }
    },
    "candidatePortalToken": {
      "type": "string",
      "description": "Ключ кабинета кандидата, показываемый один раз. Сохраняется только его хеш.",
      "example": "synthetic-example-credential"
    },
    "candidatePortalTokenExpiresAt": {
      "type": "string",
      "description": "Срок действия токена кабинета кандидата; после этого момента токен отклоняется.",
      "format": "date-time",
      "example": "2026-12-31T18:00:00.000Z"
    }
  },
  "required": [
    "application",
    "candidatePortalToken",
    "candidatePortalTokenExpiresAt"
  ],
  "description": "Созданная заявка на этапе APPLIED, токен кабинета кандидата и срок его действия.",
  "example": {
    "application": {
      "id": "0120f0fe-6880-47e8-895d-c092d269cdd1",
      "requisitionTitle": "Example title",
      "currentStage": {
        "id": "f97fe865-5ff8-488a-8fab-9e27e748514c",
        "code": "EXAMPLE",
        "name": "Example name",
        "category": "APPLIED",
        "isTerminal": true,
        "sortOrder": 1,
        "revision": 1
      },
      "status": "ACTIVE",
      "appliedAt": "2026-01-15T12:00:00.000Z",
      "updatedAt": "2026-01-15T13:00:00.000Z",
      "revision": 1,
      "canWithdraw": true
    },
    "candidatePortalToken": "synthetic-example-credential",
    "candidatePortalTokenExpiresAt": "2026-12-31T18:00:00.000Z"
  }
}
CandidatePortalApplicationDto

Своя заявка в конечном состоянии отзыва с обновлённой ревизией и сохранёнными материалами подачи.

idОбязательно

UUID Hallify для id.

string · uuid
Полное определение
{
  "type": "string",
  "format": "uuid",
  "description": "UUID Hallify для `id`.",
  "example": "0120f0fe-6880-47e8-895d-c092d269cdd1"
}
requisitionTitleОбязательно

Название заявки на подбор requisitionTitle.

string
Полное определение
{
  "type": "string",
  "description": "Название заявки на подбор `requisitionTitle`.",
  "example": "Example title"
}
currentStageОбязательно

Этап подбора, вложенный в поле currentStage заявки кандидата.

allOf
Полное определение
{
  "allOf": [
    {
      "$ref": "#/components/schemas/RecruitingStageDto"
    }
  ],
  "description": "Этап подбора, вложенный в поле currentStage заявки кандидата.",
  "example": {
    "id": "f97fe865-5ff8-488a-8fab-9e27e748514c",
    "code": "EXAMPLE",
    "name": "Example name",
    "category": "APPLIED",
    "isTerminal": true,
    "sortOrder": 1,
    "revision": 1
  }
}
statusОбязательно

Текущий статус жизненного цикла status; допустимые значения: ACTIVE, OFFERED, HIRED, REJECTED, WITHDRAWN.

string
Полное определение
{
  "type": "string",
  "enum": [
    "ACTIVE",
    "OFFERED",
    "HIRED",
    "REJECTED",
    "WITHDRAWN"
  ],
  "description": "Текущий статус жизненного цикла `status`; допустимые значения: ACTIVE, OFFERED, HIRED, REJECTED, WITHDRAWN.",
  "example": "ACTIVE"
}
appliedAtОбязательно

Время события appliedAt.

string · date-time
Полное определение
{
  "type": "string",
  "description": "Время события `appliedAt`.",
  "format": "date-time",
  "example": "2026-01-15T12:00:00.000Z"
}
updatedAtОбязательно

Время события updatedAt.

string · date-time
Полное определение
{
  "type": "string",
  "description": "Время события `updatedAt`.",
  "format": "date-time",
  "example": "2026-01-15T13:00:00.000Z"
}
revisionОбязательно

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

integer
Полное определение
{
  "type": "integer",
  "description": "Монотонно возрастающая ревизия `revision` для оптимистичного контроля конкурентных изменений.",
  "example": 1
}
offerНеобязательно

Вложенные сведения offer. Null означает отсутствие записанного значения в этом представлении.

object · null
Полное определение
{
  "nullable": true,
  "type": "object",
  "description": "Вложенные сведения `offer`. Null означает отсутствие записанного значения в этом представлении.",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "description": "UUID Hallify для `id`.",
      "example": "dfa73755-b161-462c-87aa-7f0d20d8a424"
    },
    "status": {
      "type": "string",
      "enum": [
        "DRAFT",
        "SENT",
        "ACCEPTED",
        "DECLINED",
        "EXPIRED",
        "WITHDRAWN",
        "CONVERTED"
      ],
      "description": "Текущий статус жизненного цикла `status`; допустимые значения: DRAFT, SENT, ACCEPTED, DECLINED, EXPIRED, WITHDRAWN, CONVERTED.",
      "example": "DRAFT"
    },
    "legalEntity": {
      "allOf": [
        {
          "$ref": "#/components/schemas/RecruitingReferenceItemDto"
        }
      ],
      "description": "Справочный элемент подбора, вложенный в поле legalEntity предложения кандидату.",
      "example": {
        "id": "ba0372fd-c434-407b-8ec5-0634b02050cc",
        "name": "Example name"
      }
    },
    "venue": {
      "allOf": [
        {
          "$ref": "#/components/schemas/RecruitingReferenceItemDto"
        }
      ],
      "description": "Справочный элемент подбора, вложенный в поле venue предложения кандидату.",
      "example": {
        "id": "ba0372fd-c434-407b-8ec5-0634b02050cc",
        "name": "Example name"
      }
    },
    "department": {
      "nullable": true,
      "type": "object",
      "description": "Вложенные сведения `department`. Null означает отсутствие записанного значения в этом представлении.",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid",
          "description": "UUID Hallify для `id`.",
          "example": "e6112f96-9ef5-48fb-82cf-4187a8ce329c"
        },
        "name": {
          "type": "string",
          "description": "Понятное человеку значение `name`.",
          "example": "Example name"
        },
        "code": {
          "type": "string",
          "nullable": true,
          "description": "Стабильный код `code` для классификации или идентификации. Null означает отсутствие записанного значения в этом представлении.",
          "example": "EXAMPLE"
        }
      },
      "required": [
        "id",
        "name"
      ],
      "example": {
        "id": "e6112f96-9ef5-48fb-82cf-4187a8ce329c",
        "name": "Example name"
      }
    },
    "jobProfile": {
      "nullable": true,
      "type": "object",
      "description": "Вложенные сведения `jobProfile`. Null означает отсутствие записанного значения в этом представлении.",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid",
          "description": "UUID Hallify для `id`.",
          "example": "66c21fb4-4f9b-4f13-817d-088bf2bee5ca"
        },
        "name": {
          "type": "string",
          "description": "Понятное человеку значение `name`.",
          "example": "Example name"
        },
        "code": {
          "type": "string",
          "nullable": true,
          "description": "Стабильный код `code` для классификации или идентификации. Null означает отсутствие записанного значения в этом представлении.",
          "example": "EXAMPLE"
        }
      },
      "required": [
        "id",
        "name"
      ],
      "example": {
        "id": "66c21fb4-4f9b-4f13-817d-088bf2bee5ca",
        "name": "Example name"
      }
    },
    "classification": {
      "type": "string",
      "enum": [
        "EMPLOYEE",
        "CONTRACTOR",
        "INTERN",
        "APPRENTICE"
      ],
      "description": "Допустимые значения `classification`: EMPLOYEE, CONTRACTOR, INTERN, APPRENTICE.",
      "example": "EMPLOYEE"
    },
    "contractType": {
      "type": "string",
      "enum": [
        "FULL_TIME",
        "PART_TIME",
        "FIXED_TERM",
        "CASUAL",
        "SEASONAL",
        "ON_CALL"
      ],
      "description": "Допустимые значения `contractType`: FULL_TIME, PART_TIME, FIXED_TERM, CASUAL, SEASONAL, ON_CALL.",
      "example": "FULL_TIME"
    },
    "startDate": {
      "type": "string",
      "description": "Календарная дата `startDate` в формате ISO 8601 YYYY-MM-DD без подразумеваемого времени суток.",
      "format": "date",
      "example": "2026-01-15"
    },
    "compensationAmount": {
      "type": "string",
      "nullable": true,
      "description": "Десятичная денежная величина `compensationAmount`, сериализованная строкой в валюте поля `compensationCurrency`. Ноль означает записанную сумму, а не отсутствие значения. Null означает отсутствие записанного значения в этом представлении.",
      "example": "1.00"
    },
    "compensationCurrency": {
      "type": "string",
      "nullable": true,
      "description": "Код валюты ISO 4217 в `compensationCurrency` для денежных значений этого представления. Null означает отсутствие записанного значения в этом представлении.",
      "example": "GEL"
    },
    "compensationPeriod": {
      "type": "string",
      "enum": [
        "HOURLY",
        "DAILY",
        "WEEKLY",
        "MONTHLY",
        "ANNUAL",
        null
      ],
      "nullable": true,
      "description": "Допустимые значения `compensationPeriod`: HOURLY, DAILY, WEEKLY, MONTHLY, ANNUAL. Null означает отсутствие записанного значения в этом представлении.",
      "example": "HOURLY"
    },
    "terms": {
      "type": "string",
      "description": "Условия `terms`.",
      "example": "example"
    },
    "expiresAt": {
      "type": "string",
      "nullable": true,
      "description": "Время события `expiresAt`. Null означает отсутствие записанного значения в этом представлении.",
      "format": "date-time",
      "example": "2026-12-31T18:00:00.000Z"
    },
    "revision": {
      "type": "integer",
      "description": "Монотонно возрастающая ревизия `revision` для оптимистичного контроля конкурентных изменений.",
      "example": 1
    },
    "canRespond": {
      "type": "boolean",
      "description": "Может ли вызывающая сторона ответить на предложение кандидату.",
      "example": true
    }
  },
  "required": [
    "id",
    "status",
    "legalEntity",
    "venue",
    "classification",
    "contractType",
    "startDate",
    "terms",
    "revision",
    "canRespond"
  ],
  "example": {
    "id": "dfa73755-b161-462c-87aa-7f0d20d8a424",
    "status": "DRAFT",
    "legalEntity": {
      "id": "ba0372fd-c434-407b-8ec5-0634b02050cc",
      "name": "Example name"
    },
    "venue": {
      "id": "ba0372fd-c434-407b-8ec5-0634b02050cc",
      "name": "Example name"
    },
    "classification": "EMPLOYEE",
    "contractType": "FULL_TIME",
    "startDate": "2026-01-15",
    "terms": "example",
    "revision": 1,
    "canRespond": true
  }
}
canWithdrawОбязательно

Может ли вызывающая сторона отозвать заявку кандидата.

boolean
Полное определение
{
  "type": "boolean",
  "description": "Может ли вызывающая сторона отозвать заявку кандидата.",
  "example": true
}
Полное определение
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "description": "UUID Hallify для `id`.",
      "example": "0120f0fe-6880-47e8-895d-c092d269cdd1"
    },
    "requisitionTitle": {
      "type": "string",
      "description": "Название заявки на подбор `requisitionTitle`.",
      "example": "Example title"
    },
    "currentStage": {
      "allOf": [
        {
          "$ref": "#/components/schemas/RecruitingStageDto"
        }
      ],
      "description": "Этап подбора, вложенный в поле currentStage заявки кандидата.",
      "example": {
        "id": "f97fe865-5ff8-488a-8fab-9e27e748514c",
        "code": "EXAMPLE",
        "name": "Example name",
        "category": "APPLIED",
        "isTerminal": true,
        "sortOrder": 1,
        "revision": 1
      }
    },
    "status": {
      "type": "string",
      "enum": [
        "ACTIVE",
        "OFFERED",
        "HIRED",
        "REJECTED",
        "WITHDRAWN"
      ],
      "description": "Текущий статус жизненного цикла `status`; допустимые значения: ACTIVE, OFFERED, HIRED, REJECTED, WITHDRAWN.",
      "example": "ACTIVE"
    },
    "appliedAt": {
      "type": "string",
      "description": "Время события `appliedAt`.",
      "format": "date-time",
      "example": "2026-01-15T12:00:00.000Z"
    },
    "updatedAt": {
      "type": "string",
      "description": "Время события `updatedAt`.",
      "format": "date-time",
      "example": "2026-01-15T13:00:00.000Z"
    },
    "revision": {
      "type": "integer",
      "description": "Монотонно возрастающая ревизия `revision` для оптимистичного контроля конкурентных изменений.",
      "example": 1
    },
    "offer": {
      "nullable": true,
      "type": "object",
      "description": "Вложенные сведения `offer`. Null означает отсутствие записанного значения в этом представлении.",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid",
          "description": "UUID Hallify для `id`.",
          "example": "dfa73755-b161-462c-87aa-7f0d20d8a424"
        },
        "status": {
          "type": "string",
          "enum": [
            "DRAFT",
            "SENT",
            "ACCEPTED",
            "DECLINED",
            "EXPIRED",
            "WITHDRAWN",
            "CONVERTED"
          ],
          "description": "Текущий статус жизненного цикла `status`; допустимые значения: DRAFT, SENT, ACCEPTED, DECLINED, EXPIRED, WITHDRAWN, CONVERTED.",
          "example": "DRAFT"
        },
        "legalEntity": {
          "allOf": [
            {
              "$ref": "#/components/schemas/RecruitingReferenceItemDto"
            }
          ],
          "description": "Справочный элемент подбора, вложенный в поле legalEntity предложения кандидату.",
          "example": {
            "id": "ba0372fd-c434-407b-8ec5-0634b02050cc",
            "name": "Example name"
          }
        },
        "venue": {
          "allOf": [
            {
              "$ref": "#/components/schemas/RecruitingReferenceItemDto"
            }
          ],
          "description": "Справочный элемент подбора, вложенный в поле venue предложения кандидату.",
          "example": {
            "id": "ba0372fd-c434-407b-8ec5-0634b02050cc",
            "name": "Example name"
          }
        },
        "department": {
          "nullable": true,
          "type": "object",
          "description": "Вложенные сведения `department`. Null означает отсутствие записанного значения в этом представлении.",
          "properties": {
            "id": {
              "type": "string",
              "format": "uuid",
              "description": "UUID Hallify для `id`.",
              "example": "e6112f96-9ef5-48fb-82cf-4187a8ce329c"
            },
            "name": {
              "type": "string",
              "description": "Понятное человеку значение `name`.",
              "example": "Example name"
            },
            "code": {
              "type": "string",
              "nullable": true,
              "description": "Стабильный код `code` для классификации или идентификации. Null означает отсутствие записанного значения в этом представлении.",
              "example": "EXAMPLE"
            }
          },
          "required": [
            "id",
            "name"
          ],
          "example": {
            "id": "e6112f96-9ef5-48fb-82cf-4187a8ce329c",
            "name": "Example name"
          }
        },
        "jobProfile": {
          "nullable": true,
          "type": "object",
          "description": "Вложенные сведения `jobProfile`. Null означает отсутствие записанного значения в этом представлении.",
          "properties": {
            "id": {
              "type": "string",
              "format": "uuid",
              "description": "UUID Hallify для `id`.",
              "example": "66c21fb4-4f9b-4f13-817d-088bf2bee5ca"
            },
            "name": {
              "type": "string",
              "description": "Понятное человеку значение `name`.",
              "example": "Example name"
            },
            "code": {
              "type": "string",
              "nullable": true,
              "description": "Стабильный код `code` для классификации или идентификации. Null означает отсутствие записанного значения в этом представлении.",
              "example": "EXAMPLE"
            }
          },
          "required": [
            "id",
            "name"
          ],
          "example": {
            "id": "66c21fb4-4f9b-4f13-817d-088bf2bee5ca",
            "name": "Example name"
          }
        },
        "classification": {
          "type": "string",
          "enum": [
            "EMPLOYEE",
            "CONTRACTOR",
            "INTERN",
            "APPRENTICE"
          ],
          "description": "Допустимые значения `classification`: EMPLOYEE, CONTRACTOR, INTERN, APPRENTICE.",
          "example": "EMPLOYEE"
        },
        "contractType": {
          "type": "string",
          "enum": [
            "FULL_TIME",
            "PART_TIME",
            "FIXED_TERM",
            "CASUAL",
            "SEASONAL",
            "ON_CALL"
          ],
          "description": "Допустимые значения `contractType`: FULL_TIME, PART_TIME, FIXED_TERM, CASUAL, SEASONAL, ON_CALL.",
          "example": "FULL_TIME"
        },
        "startDate": {
          "type": "string",
          "description": "Календарная дата `startDate` в формате ISO 8601 YYYY-MM-DD без подразумеваемого времени суток.",
          "format": "date",
          "example": "2026-01-15"
        },
        "compensationAmount": {
          "type": "string",
          "nullable": true,
          "description": "Десятичная денежная величина `compensationAmount`, сериализованная строкой в валюте поля `compensationCurrency`. Ноль означает записанную сумму, а не отсутствие значения. Null означает отсутствие записанного значения в этом представлении.",
          "example": "1.00"
        },
        "compensationCurrency": {
          "type": "string",
          "nullable": true,
          "description": "Код валюты ISO 4217 в `compensationCurrency` для денежных значений этого представления. Null означает отсутствие записанного значения в этом представлении.",
          "example": "GEL"
        },
        "compensationPeriod": {
          "type": "string",
          "enum": [
            "HOURLY",
            "DAILY",
            "WEEKLY",
            "MONTHLY",
            "ANNUAL",
            null
          ],
          "nullable": true,
          "description": "Допустимые значения `compensationPeriod`: HOURLY, DAILY, WEEKLY, MONTHLY, ANNUAL. Null означает отсутствие записанного значения в этом представлении.",
          "example": "HOURLY"
        },
        "terms": {
          "type": "string",
          "description": "Условия `terms`.",
          "example": "example"
        },
        "expiresAt": {
          "type": "string",
          "nullable": true,
          "description": "Время события `expiresAt`. Null означает отсутствие записанного значения в этом представлении.",
          "format": "date-time",
          "example": "2026-12-31T18:00:00.000Z"
        },
        "revision": {
          "type": "integer",
          "description": "Монотонно возрастающая ревизия `revision` для оптимистичного контроля конкурентных изменений.",
          "example": 1
        },
        "canRespond": {
          "type": "boolean",
          "description": "Может ли вызывающая сторона ответить на предложение кандидату.",
          "example": true
        }
      },
      "required": [
        "id",
        "status",
        "legalEntity",
        "venue",
        "classification",
        "contractType",
        "startDate",
        "terms",
        "revision",
        "canRespond"
      ],
      "example": {
        "id": "dfa73755-b161-462c-87aa-7f0d20d8a424",
        "status": "DRAFT",
        "legalEntity": {
          "id": "ba0372fd-c434-407b-8ec5-0634b02050cc",
          "name": "Example name"
        },
        "venue": {
          "id": "ba0372fd-c434-407b-8ec5-0634b02050cc",
          "name": "Example name"
        },
        "classification": "EMPLOYEE",
        "contractType": "FULL_TIME",
        "startDate": "2026-01-15",
        "terms": "example",
        "revision": 1,
        "canRespond": true
      }
    },
    "canWithdraw": {
      "type": "boolean",
      "description": "Может ли вызывающая сторона отозвать заявку кандидата.",
      "example": true
    }
  },
  "required": [
    "id",
    "requisitionTitle",
    "currentStage",
    "status",
    "appliedAt",
    "updatedAt",
    "revision",
    "canWithdraw"
  ],
  "description": "Своя заявка в конечном состоянии отзыва с обновлённой ревизией и сохранёнными материалами подачи.",
  "example": {
    "id": "0120f0fe-6880-47e8-895d-c092d269cdd1",
    "requisitionTitle": "Example title",
    "currentStage": {
      "id": "f97fe865-5ff8-488a-8fab-9e27e748514c",
      "code": "EXAMPLE",
      "name": "Example name",
      "category": "APPLIED",
      "isTerminal": true,
      "sortOrder": 1,
      "revision": 1
    },
    "status": "ACTIVE",
    "appliedAt": "2026-01-15T12:00:00.000Z",
    "updatedAt": "2026-01-15T13:00:00.000Z",
    "revision": 1,
    "canWithdraw": true
  }
}
RecruitingStageDto

Упорядоченный этап процесса подбора с категорией и правилами конечного состояния.

idОбязательно

UUID Hallify для id.

string · uuid
Полное определение
{
  "type": "string",
  "format": "uuid",
  "description": "UUID Hallify для `id`.",
  "example": "f97fe865-5ff8-488a-8fab-9e27e748514c"
}
codeОбязательно

Стабильный код code для классификации или идентификации.

string
Полное определение
{
  "type": "string",
  "description": "Стабильный код `code` для классификации или идентификации.",
  "example": "EXAMPLE"
}
nameОбязательно

Понятное человеку значение name.

string
Полное определение
{
  "type": "string",
  "description": "Понятное человеку значение `name`.",
  "example": "Example name"
}
categoryОбязательно

Допустимые значения category: APPLIED, SCREENING, INTERVIEW, ASSESSMENT, OFFER, HIRED, REJECTED, WITHDRAWN.

string
Полное определение
{
  "type": "string",
  "enum": [
    "APPLIED",
    "SCREENING",
    "INTERVIEW",
    "ASSESSMENT",
    "OFFER",
    "HIRED",
    "REJECTED",
    "WITHDRAWN"
  ],
  "description": "Допустимые значения `category`: APPLIED, SCREENING, INTERVIEW, ASSESSMENT, OFFER, HIRED, REJECTED, WITHDRAWN.",
  "example": "APPLIED"
}
isTerminalОбязательно

True, если этап подбора конечный и кандидат не переходит с него дальше автоматически.

boolean
Полное определение
{
  "type": "boolean",
  "description": "True, если этап подбора конечный и кандидат не переходит с него дальше автоматически.",
  "example": true
}
sortOrderОбязательно

Целочисленная позиция сортировки sortOrder; меньшие значения идут первыми.

integer
Полное определение
{
  "type": "integer",
  "description": "Целочисленная позиция сортировки `sortOrder`; меньшие значения идут первыми.",
  "example": 1
}
revisionОбязательно

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

integer
Полное определение
{
  "type": "integer",
  "description": "Монотонно возрастающая ревизия `revision` для оптимистичного контроля конкурентных изменений.",
  "example": 1
}
Полное определение
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "description": "UUID Hallify для `id`.",
      "example": "f97fe865-5ff8-488a-8fab-9e27e748514c"
    },
    "code": {
      "type": "string",
      "description": "Стабильный код `code` для классификации или идентификации.",
      "example": "EXAMPLE"
    },
    "name": {
      "type": "string",
      "description": "Понятное человеку значение `name`.",
      "example": "Example name"
    },
    "category": {
      "type": "string",
      "enum": [
        "APPLIED",
        "SCREENING",
        "INTERVIEW",
        "ASSESSMENT",
        "OFFER",
        "HIRED",
        "REJECTED",
        "WITHDRAWN"
      ],
      "description": "Допустимые значения `category`: APPLIED, SCREENING, INTERVIEW, ASSESSMENT, OFFER, HIRED, REJECTED, WITHDRAWN.",
      "example": "APPLIED"
    },
    "isTerminal": {
      "type": "boolean",
      "description": "True, если этап подбора конечный и кандидат не переходит с него дальше автоматически.",
      "example": true
    },
    "sortOrder": {
      "type": "integer",
      "description": "Целочисленная позиция сортировки `sortOrder`; меньшие значения идут первыми.",
      "example": 1
    },
    "revision": {
      "type": "integer",
      "description": "Монотонно возрастающая ревизия `revision` для оптимистичного контроля конкурентных изменений.",
      "example": 1
    }
  },
  "required": [
    "id",
    "code",
    "name",
    "category",
    "isTerminal",
    "sortOrder",
    "revision"
  ],
  "description": "Упорядоченный этап процесса подбора с категорией и правилами конечного состояния.",
  "example": {
    "id": "f97fe865-5ff8-488a-8fab-9e27e748514c",
    "code": "EXAMPLE",
    "name": "Example name",
    "category": "APPLIED",
    "isTerminal": true,
    "sortOrder": 1,
    "revision": 1
  }
}
RecruitingReferenceItemDto

Справочная запись подбора, вложенная в коллекцию или агрегат Workforce.

idОбязательно

UUID Hallify для id.

string · uuid
Полное определение
{
  "type": "string",
  "format": "uuid",
  "description": "UUID Hallify для `id`.",
  "example": "ba0372fd-c434-407b-8ec5-0634b02050cc"
}
nameОбязательно

Понятное человеку значение name.

string
Полное определение
{
  "type": "string",
  "description": "Понятное человеку значение `name`.",
  "example": "Example name"
}
codeНеобязательно

Стабильный код code для классификации или идентификации. Null означает отсутствие записанного значения в этом представлении.

string · null
Полное определение
{
  "type": "string",
  "nullable": true,
  "description": "Стабильный код `code` для классификации или идентификации. Null означает отсутствие записанного значения в этом представлении.",
  "example": "EXAMPLE"
}
Полное определение
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "description": "UUID Hallify для `id`.",
      "example": "ba0372fd-c434-407b-8ec5-0634b02050cc"
    },
    "name": {
      "type": "string",
      "description": "Понятное человеку значение `name`.",
      "example": "Example name"
    },
    "code": {
      "type": "string",
      "nullable": true,
      "description": "Стабильный код `code` для классификации или идентификации. Null означает отсутствие записанного значения в этом представлении.",
      "example": "EXAMPLE"
    }
  },
  "required": [
    "id",
    "name"
  ],
  "description": "Справочная запись подбора, вложенная в коллекцию или агрегат Workforce.",
  "example": {
    "id": "ba0372fd-c434-407b-8ec5-0634b02050cc",
    "name": "Example name"
  }
}

Hallify использует обязательные cookies и опциональную аналитику.

Обязательные cookies поддерживают вход, язык и тему. Аналитика выключена, пока вы явно ее не разрешите.