# Создать группу документов HRlink

export default function Layout(props) {
  const { OpenAPIPage } = props.components ?? {};
  return (
    <>
      {props.children}
      ## Создать группу документов HRlink

`POST /api/v1/integrations/hrlink/documents/groups`

**Авторизация:** dpop или oauth2: `integration:write`

**Тело запроса** (`application/json`, обязательное): HrlinkCreateDocumentGroup
- `creatorExternalId`: string — Внешний идентификатор создателя
- `creatorId`: string — Создатель в HRlink
- `documents`: массив HrlinkCreateDocument, обязательное — Документы группы
  - `date`: string — Дата документа
  - `deadlineDayCount`: integer, nullable — Срок подписания в днях
  - `employeeExternalIds`: массив string — Внешние идентификаторы сотрудников
  - `employeeIds`: массив string — Сотрудники-подписанты
  - `externalId`: string — Внешний идентификатор документа
  - `fileExternalId`: string — Внешний идентификатор файла
  - `fileId`: string, обязательное — Файл платформы, отправляемый в HRlink
  - `headManagerExternalId`: string — Внешний идентификатор руководителя
  - `headManagerId`: string — Руководитель-подписант
  - `headManagerLegalEntityExternalId`: string, nullable
  - `headManagerLegalEntityId`: string, nullable
  - `legalEntityExternalId`: string — Внешний идентификатор юрлица
  - `legalEntityId`: string — Юрлицо в HRlink
  - `notice`: string — Примечание для подписантов
  - `number`: string — Номер документа
  - `participants`: массив HrlinkParticipant — Участники маршрута (для ROUTE)
    - `employeeExternalId`: string — Внешний идентификатор сотрудника
    - `employeeId`: string — Сотрудник в HRlink
    - `id`: string, обязательное — Идентификатор участника маршрута
  - `relatedEntities`: массив HrlinkShortEntity — Связанные документы и заявления
    - `externalId`: string — Внешний идентификатор
    - `id`: string — Идентификатор в HRlink
    - `type`: HrlinkEntityType — Тип сущности HRlink: документ или заявление
  - `routeTemplateExternalId`: string — Внешний идентификатор шаблона маршрута
  - `routeTemplateId`: string — Шаблон маршрута подписания
  - `signingOrder`: HrlinkSigningOrder — Порядок подписания: руководитель/сотрудник первым, только один из них или по маршруту
  - `sourceDocumentExternalId`: string
  - `sourceDocumentId`: string
  - `typeId`: string — Тип документа в HRlink
  - `watcherClientDepartmentIds`: массив string — Подразделения-наблюдатели
  - `watcherExternalIds`: массив string — Внешние идентификаторы наблюдателей
  - `watcherIds`: массив string — Наблюдатели
- `name`: string, обязательное — Название группы документов

**Ответы**

- `200` — Создано (`application/json`, HrlinkGenericResponse)
- `400` — Некорректный запрос: не прошла валидация параметров или тела (`application/problem+json`, ProblemDetails)
- `401` — Токен отсутствует, недействителен или истёк (`application/problem+json`, ProblemDetails)
- `403` — Недостаточно прав или scope (`application/problem+json`, ProblemDetails)

    </>
  );
}