Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt
Info
titleО чём раздел

 Под обработкой заявления подразумевается:

  1. Получение списка Заявлений
    1. Общий список
    2. Список по фильтрам
  2. Получение данных одного Заявления
    1. Интерпретация состояния Заявления
    2. Получение файлов Заявления: печатная форма, подписываемый файл, архив КЭДО
  3. Обработка Заявления Кадровым Специалистом
    1. Заявление обработано
    2. Смена Ответственного
    3. Отклонение Заявления

Table of Contents

Tip
titleЦель

...

Note
titleПредусловие

...

Обработка Заявлений



Info

Заявление - кадровый документ, подписание которого инициировано Работником

  • Работа с реестром Заявлений

  • Работа с Заявлением

В данном разделе описывается функционал по отношению к Кадровику.

Описание возможностей Сотрудника по работе с заявлениями указаны в

1. Сценарии работы Кадровика с Шаблонами заявлений

Info

Пример файла шаблона заявления можно скачать ниже.

В файле шаблона заявления переменные оформляются следующим образом:

<<[имя_переменной]>>

  • Для переменных типа дата, доступно указание формата даты, например - <<[dateVacation]:"dd.MM.yyyy">>

  • имя переменной определяется:

    • При создании шаблона заявления

    • При обновлении шаблона заявления

Expand
titleПример файла шаблона заявления

View file
nameШаблон заявления (пример).docx
page05. Кадровик. Основные процессы: Обработка Заявлений
spaceWIKI
height150

(warning) для понимания процесса работы с Заявлениями рекомендуется изучить раздел [Заявление]

Кадровик получает реестр Заявлений по конкретному заявителю/согласующему

Tip
titleЦель


Подготовить справочник Шаблонов Заявлений, которыми сможет воспользоваться Сотрудник при подаче Заявлений.

К подготовке можно отнести актуализацию - корректировку имён шаблонов и видимость для Сотрудника при подаче


Сценарий

Действия и API-метод

Примечания

1. Кадровый работник обновляет файл шаблона действующего заявления

Предусловия

  1. шаблон заявления создан через службу поддержки

  2. есть идентификатор шаблона заявления

    1. список Шаблонов Заявлений

    2. GET /api/v1/applicationTypes

  3. есть список системных полей (единый для всех шаблонов заявлений), которые можно использовать для настройки файла шаблона (подставлять в необходимые места шаблона)

    1. список системных полей

    2. GET /api/v1/applicationTypeFields/system

Цель - актуализировать файл шаблона

  • общий файл

  • файл шаблона для конкретного ЮЛ

1) Получение файла шаблона заявления


API-методы

Примечания

1

1) Кадровик получает данные сотрудника по ID в своей ИС

Status
subtletrue
colourYellow
titleGdoc

 GET /api/v1/clients/:clientId/employees/:externalId/externalId 

или

Кадровик получает данные ФЛ по СНИЛС

Status
subtletrue
colourYellow
titleGdoc

 

GET /api/v1/clients/:clientId/

applicationTypes

2) Кадровик загружает заранее подготовленный файл шаблона Заявления

users/:

applicationTypeId/templateFile

snils/snils 

Цель данного шага - получить идентификатор сотрудника в системе HRL, по которому требуется получить список заявлений, как по:

  • Заявителю

  • Согласующему

Идентификатор Сотрудника в HRL смотрим в  employee -> legalEntities -> employeeId 

В случае, если в системе Клиента хранится связка идентификаторов Сотрудника HRL и идентификаторов в ИС Клиента, то данный шаг можно пропустить

2

POST /api/v1

/files

Полученный идентификатор файла будет передаваться в следующем методе

Для каждого ЮЛ может быть свой файл шаблона заявления (см. схему)

/clients/:clientId/applicationGroups/hrRegistry 

Expand
titleПояснения к методу Получения реестра Заявлений

 POST

3) Кадровик заменяет идентификатор файла на новый шаблон

PUT

/api/v1/

applicationTypes/:applicationTypeId

Данный метод позволяет:

  1. Загрузить новый файл шаблона заявления

  2. Активировать/Деактивировать шаблон заявления

  3. Обновить состав пользовательских полей в шаблоне

  4. Обновить имя шаблона

2. Кадровик обновляет параметры загруженного Шаблона Заявления

Предусловие - есть идентификатор шаблона заявления

Цель - актуализировать информацию в шаблоне заявления:

  • сделать шаблон видимым/скрытым для сотрудников

  • обновить имя шаблона

PUT /api/v1/applicationTypes/:applicationTypeId

2. Сценарии работы Кадровика с поданными Заявлениями

clients/:clientId/applicationGroups/hrRegistry 

Тело запроса

Markdown
```
{ 
  "applicationTypeIds": [],
  "applicationDateFrom": null,
  "applicationDateTo": null,
  "employeeIds": [],
  "applicationApproverStatuses": [],
  "employeeApplicationApproverIds": [],
  "clientDepartmentIds": [],
  "hrManagerStatuses": [],
  "hrManagerIds": [],
  "legalEntityIds": [],
  "applicationCreatedDateFrom": null,
  "applicationCreatedDateTo": null,
  "limit": 10,
  "offset": 0
}
```


Ответ

Markdown
```
{
  "result": true,
  "applicationGroups": 
  [
    {
      "id": "1446daf2-5a3f-437b-993b-0ae3cf674a0c",
      "creator": {
        "id": "543b9eb4-23e7-46da-8f7f-5fd823b844fd",
        "lastName": "Иванов",
        "firstName": "Иван",
        "patronymic": "Иванович"
      },
      "applicationType": {
        "id": "6bee04bd-2eca-4566-8c4e-8406666fb561",
        "name": "Заявление из файла"
      },
      "date": "2022-03-30",
      "number": "81",
      "externalId": null,
      "signedDate": "2022-03-30T11:11:54.138672Z",
      "convertedDate": "2022-03-30T11:09:34.817972Z",
      "applications": 
      [
        {
          "id": "2674a871-51c8-418d-993e-a6e57df00905",
          "legalEntity": {
            "name": "Testing",
            "shortName": "Testing",
            "externalId": null,
            "id": "147eb30f-ce91-45a9-b026-112e5ea6ace0"
          },
          "employee": {
            "id": "d450decc-892b-4cfd-8f4e-9437bd34f35a",
            "externalId": null,
            "lastName": "Иванов",
            "firstName": "Иван",
            "patronymic": "Иванович",
            "position": {
              "id": "2e5915aa-c595-4025-813a-296ebd3af654",
              "name": "Разработчик"
            },
            "clientDepartment": {
              "id": "c3aaee68-08e9-455b-b72b-8a2adce2ad82",
              "name": "Корневой отдел"
            }
          },
          "employeeApprover": {
            "id": "f5a1e31d-c5f2-4f76-a2fe-c43ae54479de",
            "externalId": null,
            "lastName": "Березин",
            "firstName": "Алексей",
            "patronymic": "Владимирович",
            "position": {
              "id": "2e5915aa-c595-4025-813a-296ebd3af654",
              "name": "Разработчик"
            },
            "approvalRejectionDate": null
          },
          "hrManager": {
            "clientUserId": "bd4b1bc0-1a51-465c-8b6e-db7d37339f63",
            "lastName": "Березин",
            "firstName": "Алексей",
            "patronymic": "Михайлович",
            "position": null
          },
          "originalFile": {
            "id": "69b75202-851d-479a-9fbc-8bbbe45f4b44",
            "name": "sample.pdf"
          },
          "convertedFile": {
            "id": "1f8e90ae-abbb-41cc-bef1-30c5ba59c747",
            "name": "sample.pdf"
          },
          "pendingSigningInfo": {
            "signatureType": "CLOUD_NQES",
            "redirectUrl": "www.trudvsem.ru/…"
          },
          "externalId": null,
          "signedDate": "2022-03-30T11:11:54.138001Z",
          "convertedDate": "2022-03-30T11:09:34.817274Z",
          "lastSignedDate": "2020-11-08T11:17:11.123987Z",
          "printFormUpdatedDate": "2020-11-08T11:18:11.123987Z",
          "approverApprovedDate": "2022-03-30T11:14:37.221106Z",
          "approverRejectedDate": null,
          "approverRejectionComment": null,
          "hrClaimedDate": null,
          "hrProcessedDate": null,
          "hrRejectedDate": null,
          "hr Rejection Comment": null
        }
      ],
      "templateFieldData": {
        "userFields": [
          {
            "label": "Дата начала отпуска",
            "sortOrder": 0,
            "substitutionKey": "dateFrom",
            "value": "2022-06-03",
            "fieldType": "DATE",
            "required": true
          }
        ],
        "systemFields": [
          {
            "label": "Заявитель: Фамилия в родительном падеже",
            "sortOrder": 1,
            "substitutionKey": "creatorLastName",
            "value": "Иванов",
            "fieldType": "STRING",
            "required": true
          }
        ]
       },
       "createdDate": "2022-03-30T11:09:33.237948Z"
    }
  ]
}
```


Кадровик получает реестр Заявлений по отделу Заявителя


API-методы

Примечания

1

1) Кадровик получает справочник отделов

Status
subtletrue
colourYellow
titleGdoc

 GET /api/v1/clients/:clientId/departments 

Идентификатор Сотрудника в HRL смотрим в  clientDepartments -> id 

Цель данного шага - получить идентификатор отдела в HRL

В случае, если в системе Клиента хранится связка идентификаторов Отдела HRL и идентификаторов в ИС Клиента, то данный шаг можно пропустить

2

2) Кадровик получает список Заявлений по отделам заявителя

Status
subtletrue
colourYellow
titleGdoc

 POST /api/v1/clients/:clientId/applicationGroups/hrRegistry 



Кадровик получает реестр Заявлений по конкретному ЮЛ


API-методы

Примечания

1

1) Кадровик получает справочник Юрлиц

Status
subtletrue
colourYellow
titleGdoc

 GET /api/v1/clients/:clientId/legalEntities 

 Идентификатор Юрлица в HRL смотрим в  legalEntities -> id 

Цель данного шага - получить идентификатор отдела в HRL

В случае, если в системе Клиента хранится связка идентификаторов Юрица HRL и идентификаторов в ИС Клиента, то данный шаг можно пропустить

2

2) Кадровик получает список Заявлений по Юрлицам

Status
subtletrue
colourYellow
titleGdoc

 POST /api/v1/clients/:clientId/applicationGroups/hrRegistry 



Кадровик получает все данные по Заявлениям с учётом всех фильтров


API-методы

Примечания

1
  • Кадровик получает список Заявлений в соответствии с фильтрами

    Status
    subtletrue
    colourRed
    titleaddon

 POST /api/v2/clients/:clientId/applicationGroups/getHrRegistry 

Возможные фильтры:

  • applicationTypeIds - Фильтр по ID типов заявлений

Тип: array of strings
Формат: uuid
Обязательное?: Нет
Пример:["6bee04bd-2eca-4566-8c4e-8406666fb561", "57cc65df-d969-4764-ad86-13ede9667f3e" ]

  • applicationDateFrom - Левая граница диапазона фильтра по дате заявления

Тип: string

Формат: date
Обязательное?: Нет
Пример:"2022-05-17"

  • applicationDateTo - Правая граница диапазона фильтра по дате заявления

Тип: string

Формат: date
Обязательное?: Нет
Пример:"2022-05-17"

  • applicationCreatedDateFrom - Левая граница диапазона фильтра по моменту загрузки заявления в HR-Link

Тип: string
Формат: datetime
Обязательное?: Нет
Примеры:

"2021-01-01T11:02:20.675436+03"

"2021-01-01T00:00:00.000000+03"

"2019-05-12T21:49:46.650Z"

  • applicationCreatedDateTo - Правая граница диапазона фильтра по моменту загрузки заявлений в HR-Link

Тип: string
Формат: datetime
Обязательное?: Нет
Пример:

"2021-01-01T11:02:20.675436+03"

"2021-01-01T00:00:00.000000+03"

"2019-05-12T21:49:46.650Z"

  • employeeIds - Фильтр по сотрудникам-подписантам и наблюдателям, хотя бы один из которых должен быть в заявлении

Тип: array of strings
Формат: uuid
Обязательное?: Нет
Пример:[ "0b7b1fe5-e592-4673-918d-03cb04d561eb",

"d94ddcb0-f339-451e-b58d-0dc76de78640" ]

  • clientDepartmentIds - Фильтр по ID отделов клиента, к которым должны относиться заявления сотрудников

Тип: array of strings
Формат: uuid
Обязательное?: Нет
Пример:[ "4d4cb78f-33ff-4110-8e92-0895d165b2dd",

"d94ddcb0-f339-451e-b58d-0dc76de78640" ]

  • legalEntityIds - Фильтр по юрлицам заявлений

Тип: array of strings
Формат: uuid
Обязательное?: Нет
Пример:[ "cafd6cef-68a0-433b-8eed-8c285fb588a9",

"8c37ca37-f4db-4567-b4c1-f4e8993f22c4" ]

  • applicationStatuses - Фильтр по статусу заявления сотрудника

Тип: array of strings

Допустимые значения:

  • "REJECTED" - отклонено кем-то из подписантов
  • "SIGNED" - подписано/согласовано всеми участниками
  • "AWAITING_MY_SIGNING" - ожидает подписания текущего авторизованного пользователя
  • “AWAITING_OTHERS_SIGNING” - ожидает подписания другого участника

(warning) ДЛЯ получения реестра заявлений Кадровиком → "AWAITING_MY_SIGNING"

Expand
titleПояснения к методу Получения реестра Заявлений

 POST /api/v1/clients/:clientId/applicationGroups/hrRegistry 

Тело запроса

Markdown
```
{
  "applicationTypeIds": [“6bee04bd-2eca-4566-8c4e-8406666fb561”],
  "applicationDateFrom": null,
  "applicationDateTo": null,
  "applicationCreatedDateFrom": null,
  "applicationCreatedDateTo": null,
  "employeeIds": [],
  "clientDepartmentIds": [],
  "legalEntityIds": [],
  "applicationStatuses": ["AWAITING_OTHERS_SIGNING", "AWAITING_MY_SIGNING"],
  "limit": 10,
  "offset": 0
}
```


Ответ

Markdown
```
{
    "result": true,
    "applicationGroups": [
        {
            "id": "b4d6b679-24ee-467e-8218-843de84d9a72",
            "creator": {
                "id": "75f41a29-90e3-4a4b-b0f1-1d3e24bb1737",
                "lastName": "Шелест",
                "firstName": "Леонид",
                "patronymic": null
            },
            "applicationType": {
                "id": "6bee04bd-2eca-4566-8c4e-8406666fb561",
                "name": "Заявление из файла"
            },
            "date": "2023-05-05",
            "number": "11",
            "templateFieldData": {
                "userFields": [],
                "systemFields": []
            },
            "externalId": null,
            "createdDate": "2023-05-05T08:29:28.646922Z",
            "route": {
                "id": "cda50259-4d69-4b33-a653-9bb02c5e291f",
                "name": "Согласующий 1 > Согласующий 2 > Кадровик",
                "templateId": "7d518d9f-bbdf-4720-aca1-b161c8a55c72",
                "stages": [
                    {
                        "id": "8a7b1fa1-7fe9-47ec-863f-428d7d8ac42c",
                        "indexNumber": 0,
                        "type": "SIGNING",
                        "completenessCondition": "ALL",
                        "participants": [
                            {
                                "id": "a9acd357-7c87-407d-ac60-3c99a26d813a",
                                "type": "EMPLOYEE",
                                "actionType": "SIGNING",
                                "signingType": "ANY_APPLICABLE",
                                "placeholder": null,
                                "required": true,
                                "multipleSigners": false
                            }
                        ],
                        "responsibleEnabled": false,
                        "canDeleteBeforeStageCompleted": false
                    },
                    {
                        "id": "0ad2c5cc-1112-4495-837a-7ea01f2da61c",
                        "indexNumber": 1,
                        "type": "SIGNING",
                        "completenessCondition": "ALL",
                        "participants": [
                            {
                                "id": "5fdd98f4-e082-433f-a8d1-7e1e49ae7c75",
                                "type": "SELECTABLE_EMPLOYEE",
                                "actionType": "APPROVING",
                                "signingType": "SES",
                                "placeholder": null,
                                "required": true,
                                "multipleSigners": false
                            }
                        ],
                        "responsibleEnabled": false,
                        "canDeleteBeforeStageCompleted": true
                    },
                    {
                        "id": "02853add-64b9-40a8-9746-8d95ce031e38",
                        "indexNumber": 2,
                        "type": "SIGNING",
                        "completenessCondition": "ALL",
                        "participants": [
                            {
                                "id": "ebd6098b-186f-435a-9e77-3689b75c546c",
                                "type": "SELECTABLE_EMPLOYEE",
                                "actionType": "APPROVING",
                                "signingType": "SES",
                                "placeholder": null,
                                "required": true,
                                "multipleSigners": false
                            }
                        ],
                        "responsibleEnabled": false,
                        "canDeleteBeforeStageCompleted": false
                    },
                    {
                        "id": "f66883cc-3736-427a-94a2-80687d56f5cf",
                        "indexNumber": 3,
                        "type": "SIGNING",
                        "completenessCondition": "ALL",
                        "participants": [
                            {
                                "id": "d6848ad5-c159-459e-997b-68854d918eac",
                                "type": "ROLE",
                                "actionType": "PROCESSING",
                                "signingType": "SES",
                                "placeholder": null,
                                "systemRole": {
                                    "id": "21c4a2d9-2451-41b1-84e3-cc0b7ad73277",
                                    "key": "HR",
                                    "name": "Кадровик"
                                },
                                "required": true,
                                "multipleSigners": false
                            }
                        ],
                        "responsibleEnabled": true,
                        "canDeleteBeforeStageCompleted": false
                    }
                ]
            },
            "applications": [
                {
                    "id": "1c3d3897-22d4-431e-a2c0-240d1133ffcd",
                    "legalEntity": {
                        "name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ПИРОЖОК\"",
                        "shortName": "ООО Пирожок",
                        "externalId": "DAX_legal_entity_example_1",
                        "id": "3b0c872a-2551-4725-8928-2f91e711dd8b"
                    },
                    "originalFile": {
                        "id": "cb0bf613-a5e1-4a6e-81d3-7884b8f33a9f",
                        "name": "123-Страница 3.drawio.pdf"
                    },
                    "fileId": "7986e689-fc31-4c7b-8b84-3bce16b3f759",
                    "externalId": null,
                    "fileProcessedDate": "2023-05-05T08:29:29.952514Z",
                    "fileConversionFailedDate": null,
                    "deletedDate": null,
                    "rejectedDate": null,
                    "docflowFinishedDate": null,
                    "signers": [
                        {
                            "id": "eab4d138-ed80-41c0-b88a-0433275bf656",
                            "lastName": "Шелест",
                            "firstName": "Леонид",
                            "patronymic": null,
                            "participantId": "a9acd357-7c87-407d-ac60-3c99a26d813a",
                            "signingOrder": 0,
                            "clientUserId": "75f41a29-90e3-4a4b-b0f1-1d3e24bb1737",
                            "employee": {
                                "id": "b45a1ecb-bd10-46f0-aad4-5aa7b1127229",
                                "externalId": "DAX_employee_example_5",
                                "position": {
                                    "id": "c4eeea4e-a4e8-4b5b-b42a-cd714306e6f2",
                                    "name": "Тимлид"
                                },
                                "department": {
                                    "id": "694b9b22-125d-4d11-abce-e3ee050c8d09",
                                    "name": "Юридический отдел"
                                }
                            },
                            "signingAvailabilityDate": null,
                            "madeDecision": true,
                            "signedDate": "2023-05-05T08:29:56.413268Z",
                            "signingInfo": null,
                            "rejectedDate": null,
                            "rejectionComment": null
                        },
                        {
                            "id": "885dfee8-e60b-4db8-a8f0-ca06285a992d",
                            "lastName": "А",
                            "firstName": "Б",
                            "patronymic": "В",
                            "participantId": "5fdd98f4-e082-433f-a8d1-7e1e49ae7c75",
                            "signingOrder": 1,
                            "clientUserId": "275d0011-0522-4b86-b270-6292482e4b64",
                            "employee": {
                                "id": "320999f7-fd71-449b-86a3-c6fa33ec6fd8",
                                "externalId": null,
                                "position": {
                                    "id": "5bed72c8-bd70-42fb-8e01-98d48509fc6c",
                                    "name": "Главный инженер"
                                },
                                "department": {
                                    "id": "2144e90f-6046-4ded-99bd-4d58a066973c",
                                    "name": "Корневой отдел"
                                }
                            },
                            "signingAvailabilityDate": "2023-05-05T08:29:56.414428Z",
                            "madeDecision": false,
                            "signedDate": null,
                            "signingInfo": null,
                            "rejectedDate": null,
                            "rejectionComment": null
                        },
                        {
                            "id": "d5a5224e-e49d-44eb-9b1b-7959963aaae0",
                            "lastName": "Дмитриева",
                            "firstName": "Яна",
                            "patronymic": "Спартаковна",
                            "participantId": "ebd6098b-186f-435a-9e77-3689b75c546c",
                            "signingOrder": 2,
                            "clientUserId": "5e5055ec-1d9e-4c35-ac2d-4c86b5b9c099",
                            "employee": {
                                "id": "55ec6d94-9fd2-454a-8661-80effee170c4",
                                "externalId": "09018100-e8c0-11ec-8d81-005056a6884a",
                                "position": {
                                    "id": "2c8b2c1b-26a0-4183-9ab6-2cf7288724d4",
                                    "name": "Эксперт"
                                },
                                "department": {
                                    "id": "2a54d760-9016-420b-8a83-720d297f2911",
                                    "name": "Сектор дежурной службы"
                                }
                            },
                            "signingAvailabilityDate": null,
                            "madeDecision": false,
                            "signedDate": null,
                            "signingInfo": null,
                            "rejectedDate": null,
                            "rejectionComment": null
                        },
                        {
                            "id": "ccbda9e3-d674-41ed-8ded-d06f1c120cfe",
                            "lastName": null,
                            "firstName": null,
                            "patronymic": null,
                            "participantId": "d6848ad5-c159-459e-997b-68854d918eac",
                            "signingOrder": 3,
                            "clientUserId": null,
                            "employee": null,
                            "signingAvailabilityDate": null,
                            "madeDecision": false,
                            "signedDate": null,
                            "signingInfo": null,
                            "rejectedDate": null,
                            "rejectionComment": null
                        }
                    ],
                    "responsibles": [],
                    "lastSignedDate": "2023-05-05T08:29:56.413268Z",
                    "printFormUpdatedDate": "2023-05-05T08:30:01.036201Z",
                    "version": 4,
                    "eventDates": []
                }
            ],
            "attachments": [],
            "version": 3
        },
	...
}
```
  • applicationGroups[].createdDate - дата создания заявления
  • applicationGroups[].route - данные о маршруте заявления
  • applicationGroups[].route.stages - данные об этапах маршрута
  • applicationGroups[].route.stages[].participants - данные об участниках маршрута
  • applicationGroups[].route.stages[].participants.id - идентификатор участника
  • applicationGroups[].route.stages[].participants.type - тип участника
  • applicationGroups[].route.stages[].participants.systemRole - если участник это роль Кадровик, то будет информация о системной роли
  • applicationGroups[].route.applications[].fileProcessedDate - дата формирования файла заявления
  • applicationGroups[].route.applications[].deletedDate - дата удаления заявления Сотрудником (Заявителем)
  • applicationGroups[].route.applications[].rejectedDate - дата отклонения заявления
  • applicationGroups[].route.applications[].docflowFinishedDate - дата завершения (проставляется если: обработка завершена, заявление отклонено, заявление удалено Заявителем)
  • applicationGroups[].route.applications[].lastSignedDate - дата последнего подписания
  • applicationGroups[].route.applications[].eventDates - Если в настройке шаблона определено поле, которое является Значимой датой Заявления, то при подаче заявления это поле заполняется соответственно требованиям настроек шаблона Заявления
  • applicationGroups[].route.applications[].signers[].employee - данные сотрудника подписанта. метчинг с участником через participantId
  • applicationGroups[].route.applications[].signers[].signingAvailabilityDate - дата, когда заявление стало доступным для просмотра конкретному участнику маршрута согласования
  • applicationGroups[].route.applications[].signers[].madeDecision - дата принятия решения конкретным участником маршрута согласования
  • applicationGroups[].route.applications[].signers[].signedDate - дата подписания конкретным участником маршрута согласования
  • applicationGroups[].route.applications[].signers[].rejectedDate - дата отклонения конкретным участником маршрута согласования
  • applicationGroups[].route.applications[].signers[].rejectionComment - комментарий оставленный при отклонении


Кадровик получает данные конкретного заявления (метаданные, файлы и архив)

Note
titleПредусловие

У Клиента есть идентификатор Группы Заявлений и идентификатор Заявления


API-методы

Примечания

1

1) Кадровик получает данные заявления по ID в HRL

Status
subtletrue
colourYellow
titleGdoc

 GET /api/v1/clients/:clientId/applicationGroups/:applicationGroupId 

На метаданные заявления содержат в себе:

  • Данные Заявителя и Согласующего

  • Данные Заявления: Группа, Дата, Номер

2

2) Кадровик получает печатную форму заявления с оттиском

Status
subtletrue
colourYellow
titleGdoc

 GET /api/v1/clients/:clientId/applications/:applicationId/printFormFile 

Печатная форма заявления может быть использована для отображения.

В случае, если Кадровику достаточно метаданных, полученных из заявления, то шаг с получением файла заявления можно пропустить

3

3) Кадровик получаетфайл Заявления, который подписан Сотрудником

Status
subtletrue
colourRed
titleaddon

 GET /api/v1/clients/:clientId/applications/:applicationId/convertedFile 

Получение файла, который подписывался имеет смысл, если процессы клиента предполагают дальнейшее подписание этого файла в какой-либо внешней системе

Expand
titleПояснения к методу Получения файла Заявления

 GET /api/v1/clients/:clientId/applications/:applicationId/convertedFile 

Тело запроса - пустое

Markdown
```
{}
```


Ответ - бинарные данные файла заявления в формате PDF/A, который был получен в результате конвертации файла заявления

4

3) Кадровик получаетдополнительные файлы, приложенные Сотрудником при подаче Заявления

Status
subtletrue
colourRed
titleaddon

 GET /api/v1/clients/:clientId/applicationGroups/:applicationGroupId/attachments/:attachmentId 

Expand
titleПояснения к методу Получения вложений к заявлению

 GET /api/v1/clients/:clientId/applicationGroups/:applicationGroupId/attachments/:attachmentId 

Тело запроса - пустое

Markdown
```
{}
```


Ответ - бинарные данные файла заявления в формате PDF/A, который был получен в результате конвертации файла заявления

5

5) Кадровик получает архив КЭДО по Заявлению 

Status
subtletrue
colourYellow
titleGdoc

 GET /api/v1/clients/:clientId/applications/:applicationId/archive 

Архив КЭДО включает в себя:

  1. Сконвертированный файл, который подписывался
  2. Печатная Форма (ПФ) с оттиском электронной подписи
  3. Описание электронного документа XML файл
  4. Протокол КЭДО (входит в архив, только если его скачивает Кадровый специалист)
  5. Файлы подписей - может быть 1 или несколько файлов. Файл подписи ПЭП Госуслуги представлен в виде zip архива.

 

Кадровик обрабатывает Заявление


API-методы

Примечания

1

1) Кадровик оставляет комментарий к заявлению, видимый всем участникам 

Status
subtletrue
colourRed
titleaddon

 POST /api/v1/clients/:clientId/applications/:applicationId/comments 

Expand
titleПояснения к методу Добавлению общего комментария к Заявлению

 POST /api/v1/clients/:clientId/applicationGroups/hrRegistry 

Тело запроса

Markdown
```
{
	"message": "тестовый комментарий"
}
```


Ответ

Markdown
```
{
    "result": true,
    "comment": {
        "id": "399aeaca-f663-427f-89f8-61d3d50c365a",
        "version": 1,
        "user": {
            "lastName": "Шелест",
            "firstName": "Леонид",
            "patronymic": null,
            "userId": "240a8b5e-9e2e-42a7-8977-160da4be05db"
        },
        "message": "тестовый комментарий",
        "createdDate": "2023-12-12T19:29:19.217659Z"
    }
}
```
2

2) Кадровик берёт заявление в работу (становиться ответственным)

Status
subtletrue
colourRed
titleaddon

 POST /api/v1/clients/:clientId/applications/:applicationId/responsibles 

Данный шаг может быть пропущен, если у Клиента после получения заявления сразу выносится решение от Кадровика и не требуется вести учёт того, какие заявления находятся в работе в моменте.

Expand
titleПояснения к методу Определения ответственного

 POST /api/v1/clients/:clientId/applicationGroups/hrRegistry 

Тело запроса

Markdown
```
{
    "participantId": "272e75ed-601d-4996-bb47-158133deed33",
    "version": 1
}
```

 Параметры:

  • :applicationId = идентификатор заявления
  • participantId - идентификатор участника, отклонившего заявления (обязательное)
  • version - версия заявления (может быть = null)

Ответ

Markdown
```
{
    "result": true,
    "application": {
        "id": "5d27e80d-7217-4e5c-9d1a-b9b6d52e5ed2",
        "legalEntity": {
            "name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ПИРОЖОК\"",
            "shortName": "ООО Пирожок",
            "externalId": "DAX_legal_entity_example_1",
            "id": "3b0c872a-2551-4725-8928-2f91e711dd8b"
        },
        "fileId": "856c7213-baba-469c-b54d-9fa25b4a57c9",
        "externalId": null,
        "fileProcessedDate": "2023-11-03T14:14:55.268688Z",
        "fileConversionFailedDate": null,
        "deletedDate": null,
        "rejectedDate": null,
        "docflowFinishedDate": null,
        "signers": [
            {
                "id": "17a310be-fe76-4047-a566-c9c8c3c1770b",
                "lastName": "Шелест",
                "firstName": "Леонид",
                "patronymic": null,
                "participantId": "5bdcd2cc-7624-41ca-800d-209fb8fbbe50",
                "signingOrder": 0,
                "clientUserId": "75f41a29-90e3-4a4b-b0f1-1d3e24bb1737",
                "employee": {
                    "id": "94166eb2-0488-40dc-9f97-dd48ec6d074a",
                    "externalId": null,
                    "position": {
                        "id": "e6c011d2-7719-40d8-a44f-25c32ef8b68d",
                        "name": "Юрист"
                    },
                    "department": {
                        "id": "694b9b22-125d-4d11-abce-e3ee050c8d09",
                        "name": "Юридический отдел"
                    }
                },
                "signingAvailabilityDate": null,
                "madeDecision": true,
                "signedDate": "2023-11-03T14:15:33.864954Z",
                "signingInfo": null,
                "rejectedDate": null,
                "rejectionComment": null
            },
            {
                "id": "15802e52-902b-4f5c-bc8e-1ddb4fbbc3ba",
                "lastName": "Борисов",
                "firstName": "Константин",
                "patronymic": "Валерьевич",
                "participantId": "387305de-f2b7-42fb-8d02-ceb2f21d1511",
                "signingOrder": 1,
                "clientUserId": "a7a9b445-86ac-4903-aa5b-aae6da57341c",
                "employee": {
                    "id": "3bc996b7-5167-4878-a897-0320a3d69fd1",
                    "externalId": null,
                    "position": {
                        "id": "8aa2834a-466f-4f4d-8693-8c32fcb40c31",
                        "name": "Менеджер"
                    },
                    "department": {
                        "id": "112af4c1-ef5e-4c94-9c0a-60928bbf4d3b",
                        "name": "Руководство"
                    }
                },
                "signingAvailabilityDate": "2023-11-03T14:15:33.868863Z",
                "madeDecision": true,
                "signedDate": "2023-11-30T07:25:13.722409Z",
                "signingInfo": null,
                "rejectedDate": null,
                "rejectionComment": null
            },
            {
                "id": "c08eb89b-d6a3-4bcb-8687-c4c51ec6120c",
                "lastName": "Шелест",
                "firstName": "Леонид",
                "patronymic": null,
                "participantId": "351e915f-ed4f-4fb4-be12-ebae4ec81dad",
                "signingOrder": 2,
                "clientUserId": "75f41a29-90e3-4a4b-b0f1-1d3e24bb1737",
                "employee": {
                    "id": "7f363dab-34b4-4714-8a7f-3b0ad9979a97",
                    "externalId": "DAX_employee_example_6",
                    "position": {
                        "id": "e6c011d2-7719-40d8-a44f-25c32ef8b68d",
                        "name": "Юрист"
                    },
                    "department": {
                        "id": "694b9b22-125d-4d11-abce-e3ee050c8d09",
                        "name": "Юридический отдел"
                    }
                },
                "signingAvailabilityDate": "2023-11-30T07:25:13.731948Z",
                "madeDecision": false,
                "signedDate": null,
                "signingInfo": null,
                "rejectedDate": null,
                "rejectionComment": null
            }
        ],
        "responsibles": [
            {
                "id": "868937aa-e7dd-4b7a-abdd-ebfa9c4377d6",
                "lastName": "Шелест",
                "firstName": "Леонид",
                "patronymic": null,
                "signerId": "c08eb89b-d6a3-4bcb-8687-c4c51ec6120c",
                "clientUserId": "75f41a29-90e3-4a4b-b0f1-1d3e24bb1737",
                "employee": {
                    "id": "7f363dab-34b4-4714-8a7f-3b0ad9979a97",
                    "externalId": "DAX_employee_example_6",
                    "position": {
                        "id": "e6c011d2-7719-40d8-a44f-25c32ef8b68d",
                        "name": "Юрист"
                    },
                    "department": {
                        "id": "694b9b22-125d-4d11-abce-e3ee050c8d09",
                        "name": "Юридический отдел"
                    }
                }
            }
        ],
        "lastSignedDate": null,
        "printFormUpdatedDate": null,
        "version": 6,
        "eventDates": [],
        "group": {
            "id": "f5685728-133a-4537-90cc-dadc0ce4eb40",
            "externalId": null,
            "version": 4
        }
    }
}
```
3

3) Кадровик принимает решение по заявлению:

 POST /api/v1/clients/:clientId/applications/:applicationId/signBySes 

 PUT /api/v1/clients/:clientId/applications/:applicationId/reject 

Expand
titleПояснения к методу Согласования

 POST /api/v1/clients/:clientId/applications/:applicationId/signBySes 

Тело запроса

Markdown
```
{
    "participantId": "272e75ed-601d-4996-bb47-158133deed33",
    "version": 1
}
```

 Параметры:

  • :applicationId = идентификатор заявления
  • participantId - идентификатор участника, отклонившего заявления (обязательное)
  • version - версия заявления (может быть = null или не передаваться вообще)

Ответ

Markdown
```
{
    "result": true,
    "application": {
        "id": "bee4e294-ff2a-4244-85ad-978d830818d4",
        "legalEntity": {
            "name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ИННОВАЦИИ В УПРАВЛЕНИИ КАД111РАМИ\"",
            "shortName": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ИННОВАЦИИ В УПРАВЛЕНИИ КАД111РАМИ\"",
            "externalId": "5",
            "id": "def5f07e-b16d-4842-96b1-b52dee593882"
        },
        "originalFile": {
            "id": "7beb24f0-a328-4555-8c38-6f40f4016a85",
            "name": "QA.jpg"
        },
        "fileId": "d6980ca5-18b9-4111-a898-f63324827147",
        "externalId": null,
        "fileProcessedDate": "2021-09-09T14:36:10.479437Z",
        "fileConversionFailedDate": null,
        "deletedDate": null,
        "rejectedDate": null,
        "docflowFinishedDate": "2023-12-12T19:38:21.581077Z",
        "signers": [
            {
                "id": "873c84d7-c635-4e33-80f3-491f2d89ed04",
                "lastName": "Шелест",
                "firstName": "Леонид",
                "patronymic": null,
                "participantId": "5bdcd2cc-7624-41ca-800d-209fb8fbbe50",
                "signingOrder": 0,
                "clientUserId": "75f41a29-90e3-4a4b-b0f1-1d3e24bb1737",
                "employee": {
                    "id": "4d6be620-662d-4f5f-aac8-55146543bb0a",
                    "externalId": null,
                    "position": {
                        "id": "86bb1c0d-75a0-4a8d-9f3e-f3efea67a6a7",
                        "name": "Начальник отдела"
                    },
                    "department": null
                },
                "signingAvailabilityDate": "2021-09-09T14:36:10.479437Z",
                "madeDecision": true,
                "signedDate": "2021-09-09T14:36:48.980368Z",
                "signingInfo": null,
                "rejectedDate": null,
                "rejectionComment": null
            },
            {
                "id": "78a5599d-045a-4804-a4ab-5f46eac84d90",
                "lastName": "Ом",
                "firstName": "Ном",
                "patronymic": "Номович",
                "participantId": "387305de-f2b7-42fb-8d02-ceb2f21d1511",
                "signingOrder": 1,
                "clientUserId": "e5a49f51-1d72-4b58-9262-4ef9105121b3",
                "employee": {
                    "id": "becf8cb2-c952-46c8-8d67-f50b770bd443",
                    "externalId": null,
                    "position": {
                        "id": "f9d3609f-c546-4c2e-91cd-8f67670ea977",
                        "name": "Руководитель"
                    },
                    "department": null
                },
                "signingAvailabilityDate": "2021-09-09T14:36:48.980368Z",
                "madeDecision": true,
                "signedDate": "2021-09-09T14:45:29.271164Z",
                "signingInfo": null,
                "rejectedDate": null,
                "rejectionComment": null
            },
            {
                "id": "92cbe8eb-7dd3-4f41-a35f-655ee370ff2e",
                "lastName": "Шелест",
                "firstName": "Леонид",
                "patronymic": null,
                "participantId": "351e915f-ed4f-4fb4-be12-ebae4ec81dad",
                "signingOrder": 2,
                "clientUserId": "75f41a29-90e3-4a4b-b0f1-1d3e24bb1737",
                "employee": {
                    "id": "4d6be620-662d-4f5f-aac8-55146543bb0a",
                    "externalId": null,
                    "position": {
                        "id": "86bb1c0d-75a0-4a8d-9f3e-f3efea67a6a7",
                        "name": "Начальник отдела"
                    },
                    "department": null
                },
                "signingAvailabilityDate": "2021-09-09T14:45:29.271164Z",
                "madeDecision": true,
                "signedDate": "2023-12-12T19:38:21.578724Z",
                "signingInfo": null,
                "rejectedDate": null,
                "rejectionComment": null
            }
        ],
        "responsibles": [
            {
                "id": "251d666e-ff8c-441f-842a-d9bf3ab83198",
                "lastName": "Шелест",
                "firstName": "Леонид",
                "patronymic": null,
                "signerId": "92cbe8eb-7dd3-4f41-a35f-655ee370ff2e",
                "clientUserId": "75f41a29-90e3-4a4b-b0f1-1d3e24bb1737",
                "employee": {
                    "id": "4d6be620-662d-4f5f-aac8-55146543bb0a",
                    "externalId": null,
                    "position": {
                        "id": "86bb1c0d-75a0-4a8d-9f3e-f3efea67a6a7",
                        "name": "Начальник отдела"
                    },
                    "department": null
                }
            }
        ],
        "lastSignedDate": null,
        "printFormUpdatedDate": null,
        "version": 6,
        "eventDates": [],
        "group": {
            "id": "6646d81f-b537-4225-9007-0ab4c2ed1034",
            "externalId": null,
            "version": 4
        }
    }
}
```
Expand
titleПояснения к методу Отклонения

 PUT /api/v1/clients/:clientId/applications/:applicationId/reject 

Тело запроса

Markdown
```
{
    "participantId": "272e75ed-601d-4996-bb47-158133deed33",
    "comment": "причина отклонения",
    "version": 1
}
```

Параметры:

  • :applicationId = идентификатор заявления
  • comment - комментарий с причиной отклонения заявления
  • participantId - идентификатор участника, отклонившего заявления (обязательное)
  • version - версия заявления, необязательный параметр (можно исключить)

Ответ

Markdown
```
{
    "result": true,
    "application": {
        "id": "5d27e80d-7217-4e5c-9d1a-b9b6d52e5ed2",
        "legalEntity": {
            "name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ПИРОЖОК\"",
            "shortName": "ООО Пирожок",
            "externalId": "DAX_legal_entity_example_1",
            "id": "3b0c872a-2551-4725-8928-2f91e711dd8b"
        },
        "fileId": "856c7213-baba-469c-b54d-9fa25b4a57c9",
        "externalId": null,
        "fileProcessedDate": "2023-11-03T14:14:55.268688Z",
        "fileConversionFailedDate": null,
        "deletedDate": null,
        "rejectedDate": "2023-12-12T19:37:18.883981Z",
        "docflowFinishedDate": "2023-12-12T19:37:18.883981Z",
        "signers": [
            {
                "id": "17a310be-fe76-4047-a566-c9c8c3c1770b",
                "lastName": "Шелест",
                "firstName": "Леонид",
                "patronymic": null,
                "participantId": "5bdcd2cc-7624-41ca-800d-209fb8fbbe50",
                "signingOrder": 0,
                "clientUserId": "75f41a29-90e3-4a4b-b0f1-1d3e24bb1737",
                "employee": {
                    "id": "94166eb2-0488-40dc-9f97-dd48ec6d074a",
                    "externalId": null,
                    "position": {
                        "id": "e6c011d2-7719-40d8-a44f-25c32ef8b68d",
                        "name": "Юрист"
                    },
                    "department": {
                        "id": "694b9b22-125d-4d11-abce-e3ee050c8d09",
                        "name": "Юридический отдел"
                    }
                },
                "signingAvailabilityDate": null,
                "madeDecision": true,
                "signedDate": "2023-11-03T14:15:33.864954Z",
                "signingInfo": null,
                "rejectedDate": null,
                "rejectionComment": null
            },
            {
                "id": "15802e52-902b-4f5c-bc8e-1ddb4fbbc3ba",
                "lastName": "Борисов",
                "firstName": "Константин",
                "patronymic": "Валерьевич",
                "participantId": "387305de-f2b7-42fb-8d02-ceb2f21d1511",
                "signingOrder": 1,
                "clientUserId": "a7a9b445-86ac-4903-aa5b-aae6da57341c",
                "employee": {
                    "id": "3bc996b7-5167-4878-a897-0320a3d69fd1",
                    "externalId": null,
                    "position": {
                        "id": "8aa2834a-466f-4f4d-8693-8c32fcb40c31",
                        "name": "Менеджер"
                    },
                    "department": {
                        "id": "112af4c1-ef5e-4c94-9c0a-60928bbf4d3b",
                        "name": "Руководство"
                    }
                },
                "signingAvailabilityDate": "2023-11-03T14:15:33.868863Z",
                "madeDecision": true,
                "signedDate": "2023-11-30T07:25:13.722409Z",
                "signingInfo": null,
                "rejectedDate": null,
                "rejectionComment": null
            },
            {
                "id": "c08eb89b-d6a3-4bcb-8687-c4c51ec6120c",
                "lastName": "Шелест",
                "firstName": "Леонид",
                "patronymic": null,
                "participantId": "351e915f-ed4f-4fb4-be12-ebae4ec81dad",
                "signingOrder": 2,
                "clientUserId": "75f41a29-90e3-4a4b-b0f1-1d3e24bb1737",
                "employee": {
                    "id": "7f363dab-34b4-4714-8a7f-3b0ad9979a97",
                    "externalId": "DAX_employee_example_6",
                    "position": {
                        "id": "e6c011d2-7719-40d8-a44f-25c32ef8b68d",
                        "name": "Юрист"
                    },
                    "department": {
                        "id": "694b9b22-125d-4d11-abce-e3ee050c8d09",
                        "name": "Юридический отдел"
                    }
                },
                "signingAvailabilityDate": "2023-11-30T07:25:13.731948Z",
                "madeDecision": true,
                "signedDate": null,
                "signingInfo": null,
                "rejectedDate": "2023-12-12T19:37:18.883981Z",
                "rejectionComment": "123"
            }
        ],
        "responsibles": [
            {
                "id": "868937aa-e7dd-4b7a-abdd-ebfa9c4377d6",
                "lastName": "Шелест",
                "firstName": "Леонид",
                "patronymic": null,
                "signerId": "c08eb89b-d6a3-4bcb-8687-c4c51ec6120c",
                "clientUserId": "75f41a29-90e3-4a4b-b0f1-1d3e24bb1737",
                "employee": {
                    "id": "7f363dab-34b4-4714-8a7f-3b0ad9979a97",
                    "externalId": "DAX_employee_example_6",
                    "position": {
                        "id": "e6c011d2-7719-40d8-a44f-25c32ef8b68d",
                        "name": "Юрист"
                    },
                    "department": {
                        "id": "694b9b22-125d-4d11-abce-e3ee050c8d09",
                        "name": "Юридический отдел"
                    }
                }
            }
        ],
        "lastSignedDate": null,
        "printFormUpdatedDate": null,
        "version": 7,
        "eventDates": [],
        "group": {
            "id": "f5685728-133a-4537-90cc-dadc0ce4eb40",
            "externalId": null,
            "version": 5
        }
    }
}
```


Поиск документации

Livesearch
spaceKeyWIKI
sizelarge

Порядок действий

API-метод

Примечания

1. Кадровик получает реестр Заявлений по конкретному заявителю/согласующему

Предусловие - в системе Клиента нет идентификатора Сотрудника HRL и используются только идентификаторы своей системы

1) Кадровик получает данные сотрудника по ID в своей ИС

GET /api/v1/clients/:clientId/employees/:externalId/externalId

Идентификатор Сотрудника в HRL смотрим в employee -> legalEntities -> employeeId

или

Кадровик получает данные ФЛ по СНИЛС

GET /api/v1/clients/:clientId/users/:snils/snils

Цель данного шага - получить идентификатор сотрудника в системе HRL, по которому требуется получить список заявлений, как по:

  • Заявителю

  • Согласующему

В случае, если в системе Клиента хранится связка идентификаторов Сотрудника HRL и идентификаторов в ИС Клиента, то данный шаг можно пропустить

2) Кадровик получает список Заявлений

POST /api/v1/clients/:clientId/applicationGroups/hrRegistry

Подробнее смотри примеры методов получения заявлений и определения состояния заявлений в разделе https://hr-link.atlassian.net/wiki/spaces/HRLIN/pages/666075304/04.#1.-%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%80%D0%B5%D0%B5%D1%81%D1%82%D1%80%D0%B0-%D0%97%D0%B0%D1%8F%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B9

2. Кадровик получает реестр Заявлений по отделу Заявителя

Предусловие - в системе Клиента нет идентификатора Отдела HRL и используются только идентификаторы своей системы

1) Кадровик получает справочник отделов

GET /api/v1/clients/:clientId/departments

Идентификатор Сотрудника в HRL смотрим в clientDepartments -> id

Цель данного шага - получить идентификатор отдела в HRL

В случае, если в системе Клиента хранится связка идентификаторов Отдела HRL и идентификаторов в ИС Клиента, то данный шаг можно пропустить

2) Кадровик получает список Заявлений по отделам заявителя

POST /api/v1/clients/:clientId/applicationGroups/hrRegistry

Подробнее смотри примеры методов получения заявлений и определения состояния заявлений в разделе https://hr-link.atlassian.net/wiki/spaces/HRLIN/pages/666075304/04.#1.-%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%80%D0%B5%D0%B5%D1%81%D1%82%D1%80%D0%B0-%D0%97%D0%B0%D1%8F%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B9

3. Кадровик получает реестр Заявлений по конкретному ЮЛ

Предусловие - в системе Клиента нет идентификатора Отдела HRL и используются только идентификаторы своей системы

1) Кадровик получает справочник Юрлиц

GET /api/v1/clients/:clientId/legalEntities

Идентификатор Юрлица в HRL смотрим в legalEntities -> id

Цель данного шага - получить идентификатор отдела в HRL

В случае, если в системе Клиента хранится связка идентификаторов Юрица HRL и идентификаторов в ИС Клиента, то данный шаг можно пропустить

2) Кадровик получает список Заявлений по Юрлицам

POST /api/v1/clients/:clientId/applicationGroups/hrRegistry

Подробнее смотри примеры методов получения заявлений и определения состояния заявлений в разделе https://hr-link.atlassian.net/wiki/spaces/HRLIN/pages/666075304/04.#1.-%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%80%D0%B5%D0%B5%D1%81%D1%82%D1%80%D0%B0-%D0%97%D0%B0%D1%8F%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B9

4. Кадровик получает все данные по Заявлениям с учётом всех фильтров

Цель - получить список заявлений по произвольному набору фильтров

POST /api/v1/clients/:clientId/applicationGroups/hrRegistry

Подробнее смотри примеры методов получения заявлений и определения состояния заявлений в разделе https://hr-link.atlassian.net/wiki/spaces/HRLIN/pages/666075304/04.#1.-%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%80%D0%B5%D0%B5%D1%81%D1%82%D1%80%D0%B0-%D0%97%D0%B0%D1%8F%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B9

5. Кадровик получает данные конкретного заявления (метаданные, файлы и архив)

Предусловие - по одному из сценариев выше есть идентификатор заявления

1) Кадровик получает данные заявления по ID в HRL

GET /api/v1/clients/:clientId/applicationGroups/:applicationGroupId

На метаданные заявления содержат в себе:

  • Данные Заявителя и Согласующего

  • Данные Заявления: Группа, Дата, Номер

2) Кадровик получает:

GET /api/v1/clients/:clientId/applications/:applicationId/printFormFile

  • файл, который подписан

GET /api/v1/clients/:clientId/applications/:applicationId/convertedFile

GET /api/v1/clients/:clientId/applications/:applicationId/archive

Печатная форма заявления может быть использована для отображения.

В случае, если Кадровику достаточно метаданных, полученных из заявления, то шаг с получением файла заявления можно пропустить

На данный момент метод получения, подписываемого файла заявления, не оформлен в API-документации see-no-evil monkey

6. Кадровик обрабатывает Заявление

Предусловие - по одному из сценариев выше есть идентификатор заявления

  • кадровик получает реестр заявлений, ожидающих обработки Кадровиком

1) Кадровик берёт заявление в работу

PUT /api/v1/clients/:clientId/applications/:applicationId/participants/hr/claim

Данный шаг может быть пропущен, если у Клиента после получения заявления сразу выносится решение от Кадровика и не требуется вести учёт того, какие заявления находятся в работе в моменте.

2) Кадровик принимает решение по заявлению:

PUT /api/v1/clients/:clientId/applications/:applicationId/participants/hr/process

PUT /api/v1/clients/:clientId/applications/:applicationId/participants/hr/reject

Поиск документации

LivesearchspaceKeyWIKI