Создать юрлицо
POST/api/v1/clients/:clientId/legalEntities
Описание метода
Создаёт новое юридическое лицо для клиента.
Поле externalId опциональное — заполните его, чтобы в других методах API обращаться к юрлицу по IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. во внешней системе, а не по HRlink-IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях..
Валидации запроса
- Тело запроса задано.
- Клиент существует, не удалён, и к нему относится пользователь, выполняющий операцию.
- Пользователь клиента имеет право
LEGAL_ENTITIES_CREATE. - Если задан руководитель юрлица — IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. пользователя клиента задан и пользователь существует.
- Все реквизиты юрлица корректны.
- Если задан регион — указан корректно.
- Если задан
externalId— такой IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. в клиенте ещё не занят. - Если задана головная организация (
parentLegalEntityIdилиparentLegalEntityExternalId) — ЮЛ существует, принадлежит клиенту, у пользователя есть правоLEGAL_ENTITIES_UPDATEк нему.
Request
Responses
- 200
- 400
- 401
- 403
- 429
Успешная операция.
Ошибка при валидации данных запроса.
Запрос не аутенифицирован.
Для заданного пользователя доступ к ресурсу запрещен.
Превышен разрешенный лимит запросов за период.