О чём раздел

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

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


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

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

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

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

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

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

Цель


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

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



API-методы

Примечания

1

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

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

или

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

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

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

  • Заявителю

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

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

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

2

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

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

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

Тело запроса

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


Ответ

{
  "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) Кадровик получает справочник отделов GDOC

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

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

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

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

2

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

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



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


API-методы

Примечания

1

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

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

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

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

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

2

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

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



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


API-методы

Примечания

1

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

 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"

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

Тело запроса

{
  "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
}


Ответ

{
    "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 - комментарий оставленный при отклонении


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

Предусловие

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


API-методы

Примечания

1

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

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

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

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

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

2

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

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

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

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

3

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

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

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

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

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

{}


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

4

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

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

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

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

{}


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

5

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

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

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

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

 

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


API-методы

Примечания

1

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

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

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

Тело запроса

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


Ответ

{
    "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) Кадровик берёт заявление в работу (становиться ответственным) ADDON

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

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

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

Тело запроса

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

 Параметры:

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

Ответ

{
    "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 

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

Тело запроса

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

 Параметры:

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

Ответ

{
    "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
        }
    }
}

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

Тело запроса

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

Параметры:

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

Ответ

{
    "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
        }
    }
}

Предыдущий раздел

03. Кадровик. Основные процессы: Формирование и контроль Документооборота

Следующий раздел

06. Сценарии использования HRlink Сотрудником

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

  • No labels