Модели в рамках одной задачи приходят с parentDepartmentExternalId, но не гарантируется корректный порядок пришедших отделов (может идти сначала дочерний отдел для создания, затем его родительский для создания). Необходимо выстроить модели в правильном порядке перед занесением в task#data для корректной обработки задачи.

Метод

POST /api/v1/clients/:clientId/bulkDataSyncTasks

Тело запроса

```
{
    "type": "CLIENT_DEPARTMENTS",
    "data": [
        {
            "syncTypes" : ["DATA_WITH_LEGAL_ENTITY", "DATA_WITH_HEAD_MANAGER"],
            "name": "Bulk Отдел1", 
            "externalId": "bulk1",
            "parentDepartmentExternalId" :"extZp",
			"parentDepartmentId" :"HRL-UUID_1",
            "legalEntityExternalId" : "legalExt2",
            "legalEntityId" : "HRL-UUID_2",
            "headManagerExternalId" : "extManager1",
            "headManagerId" : "HRL-UUID_3"
        },
        {
            "syncTypes" : ["DATA_WITH_LEGAL_ENTITY"],
            "name": "Bulk Отдел2", 
            "externalId": "bulk2",
            "parentDepartmentExternalId" :"bulk1",
            "legalEntityExternalId" : "legalExt1"
        },
        {
            "name": "Bulk Отдел3", 
            "externalId": "bulk3",
            "parentDepartmentExternalId" :"bulk2"
        }
    ]
}
```

В заданном примере отделы на этапе валидации должны выстроиться в правильном порядке - “Отдел2”, “Отдел3”, “Отдел1”, “Пример отдела”. Задача завершится успешно, при этом синхронизация отдела “Пример отдела” завершится со статусом FAILED и данными об ошибке, что родительский отдел не существует по указанному внешнему ID.

headManagerExternalId - ID руководителя отдела во внешней системе (ID сотрудника, назначаемого руководителем)
legalEntityExternalId - ID юрлица во внешней системе
syncTypes - Список типов используемых при синхронизации данных. Допустимые значения в списке DATA_WITH_LEGAL_ENTITY и DATA_WITH_HEAD_MANAGER

Проверки

Проверки при валидации:

Если в списке updateTypes присутствует значение DATA_WITH_HEAD_MANAGER, производится валидация, которая относится к сотруднику:

сотрудник должен существовать по заданному ExternalId Ошибка 13.451.
сотрудник не должен быть уволен. Ошибка 13.461
пользователь сотрудника является подтвержденным. Ошибка 13.119

Если в списке updateTypes присутствует значение DATA_WITH_LEGAL_ENTITY, производится валидация, которая относится к юрлицу:

юрлицо должно существовать по заданному ExternalId. Ошибка 13.306.

Во время выполнения запроса для каждого элемента синхронизации (отдела клиента) выполняется валидация корректности структуры отделов - по указанному ID родительского отдела строится новая структура и проверяется на цикличность. 13.373. В дополнение к проверкам на этапе обработки данных синхронизации, добавлены аналогичные проверки на этапе валидации, учитывающие ранее обработанные элементы:

По указанному ID родительского отдела во внешней системе не существует отдела клиента. 13.355 и 13.356 (для parentDepartmentID и parentDepartmentExternalId)
Если не указан родительский отдел (или null), то считать это попыткой обновления корневого отдела (совпадение externalId). Иначе ошибка - Не указан ID родительского отдела. 13.354
Если указан externalId корневого отдела, то не должен быть указан (или null) родительский. Ошибка - попытка обновить родительский отдел для корневого. 13.358

Переданные данные соответствуют типу данных отдела клиента. (при этом parentDepartmentExternalId не является обязательным полем. В случае отсутствия отдел будет создан/обновлен с корневым отделом в качестве родительского)
Все ID отдела клиента во внешней системе не равны null.
Все названия отделов клиента заданы.
Для каждого отдела клиента ID во внешней системе не равен ID родительского отдела во внешней системе.
Каждый внешний ID модели в данных для синхронизации уникален.
Для каждого элемента ID отдела клиента во внешней системе не равен ID родительского отдела клиента во внешней системе (родительский отдел не указывает на сам отдел).
Тип данных отдела клиента - parentDepartmentExternalId, name, externalId.

Проверки при синхронизации

При создании

Не указан ID родительского отдела во внешней системе.
По указанному ID родительского отдела во внешней системе не существует отдела клиента.

При обновлении

Если не указан родительский отдел (или null), то считать это попыткой обновления корневого отдела (проверить совпадение externalId). Иначе ошибка - не указан родительский отдел.
Если указан externalId корневого отдела, то не должен быть указан (или null) родительский. Ошибка - попытка обновить родительский отдел для корневого.

Логика синхронизации данных отдела

Если список syncTypes пустой или равен null, то обновление legalEntityId и headManagerId в БД не происходит для сохранения обратной совместимости.

Если в списке syncTypes присутствует значение DATA_WITH_LEGAL_ENTITY, то возможны следующие варианты:

ID юрлица задан - происходит привязка/изменение юрлица отдела
ID юрлица равен null - происходит отвязка юрлица от отдела

Если в списке syncTypes присутствует значение DATA_WITH_HEAD_MANAGER, то возможны следующие варианты:

ID сотрудника задан - происходит назначение/изменение руководителя отдела
ID сотрудника равен null - происходит снятие руководителя отдела

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