KronclAPI
Мои приложения
Введение
Публичные методы
Аккаунт
Компания
Базовые действия
Хранилище
Тарификация
Участники
Логи
Документы
Поддержка
Персонал (HRM)
POST Отчёт
Должности
GET Список
POST Создать
GET Карточка
PATCH Обновить
DELETE Удалить
Сотрудники
Аналитика
Финансы (FM)
Клиенты (CRM)
Склад (WM)
Сделки (DM)
Создать приложение
Документация API платформы. Последняя сборка v1.5.30

Должности

Методы для управления должностями в организации.

# Список должностей

GET
/companies/{id}/modules/hrm/positions

Возвращает список должностей с пагинацией.

Структура ответа

RESPONSE_DATA:
application/json
positionsrequired
array
Должности
Список должностей (Position[])
paginationrequired
array
pagination

Должность

POSITION:
application/json
idrequired
string
ID
Уникальный идентификатор должности
namerequired
string
Название
Наименование должности
descriptionoptional
string
Описание
Описание должности
permissionsrequired
array
Разрешения
Список кодов разрешений (string[])
created_atrequired
string
Создана
Дата создания (RFC 3339)
updated_atrequired
string
Обновлена
Дата последнего обновления (RFC 3339)

Примеры ответов

200
{
    "status": true,
    "message": "Positions retrieved successfully",
    "data": {
        "positions": [
            {
                "id": "ff0e8400-e29b-41d4-a716-446655440140",
                "name": "Менеджер",
                "description": "Работа с клиентами и сделками",
                "permissions": ["crm.clients", "dm.deals.create"],
                "created_at": "2026-04-24T00:20:54Z",
                "updated_at": "2026-06-14T00:00:00Z"
            }
        ],
        "pagination": {
            "total": 1,
            "page": 1,
            "limit": 20,
            "pages": 1
        }
    },
    "meta": {
        "timestamp": "2026-06-14T12:00:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../modules/hrm/positions",
        "method": "GET"
    }
}

# Создание должности

POST
/companies/{id}/modules/hrm/positions

Создаёт новую должность с набором разрешений.

Структура запроса

CREATE_REQUEST:
application/json
namerequired
string
Название
Наименование должности
descriptionoptional
string
Описание
Описание должности
permissionsoptional
array
Разрешения
Список кодов разрешений (string[])

Структура ответа

POSITION:
application/json
idrequired
string
ID
Уникальный идентификатор должности
namerequired
string
Название
Наименование должности
descriptionoptional
string
Описание
Описание должности
permissionsrequired
array
Разрешения
Список кодов разрешений (string[])
created_atrequired
string
Создана
Дата создания (RFC 3339)
updated_atrequired
string
Обновлена
Дата последнего обновления (RFC 3339)

Примеры ответов

201
{
    "status": true,
    "message": "Position created successfully",
    "data": {
        "id": "ff0e8400-e29b-41d4-a716-446655440141",
        "name": "Бухгалтер",
        "description": null,
        "permissions": ["fm.transactions.create", "fm.analysis"],
        "created_at": "2026-06-14T12:05:00Z",
        "updated_at": "2026-06-14T12:05:00Z"
    },
    "meta": {
        "timestamp": "2026-06-14T12:05:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../modules/hrm/positions",
        "method": "POST"
    }
}

# Получение должности

GET
/companies/{id}/modules/hrm/positions/{positionId}

Возвращает одну должность по идентификатору.

Структура ответа

POSITION:
application/json
idrequired
string
ID
Уникальный идентификатор должности
namerequired
string
Название
Наименование должности
descriptionoptional
string
Описание
Описание должности
permissionsrequired
array
Разрешения
Список кодов разрешений (string[])
created_atrequired
string
Создана
Дата создания (RFC 3339)
updated_atrequired
string
Обновлена
Дата последнего обновления (RFC 3339)

Примеры ответов

200
{
    "status": true,
    "message": "Position retrieved successfully",
    "data": {
        "id": "ff0e8400-e29b-41d4-a716-446655440140",
        "name": "Менеджер",
        "description": "Работа с клиентами и сделками",
        "permissions": ["crm.clients", "dm.deals.create"],
        "created_at": "2026-04-24T00:20:54Z",
        "updated_at": "2026-06-14T00:00:00Z"
    },
    "meta": {
        "timestamp": "2026-06-14T12:00:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../modules/hrm/positions/...",
        "method": "GET"
    }
}

# Обновление должности

PATCH
/companies/{id}/modules/hrm/positions/{positionId}

Обновляет данные должности. Все поля опциональны.

Структура запроса

UPDATE_REQUEST:
application/json
nameoptional
string
Название
Новое наименование
descriptionoptional
string
Описание
Новое описание
permissionsoptional
array
Разрешения
Новый список кодов разрешений (string[])

Структура ответа

POSITION:
application/json
idrequired
string
ID
Уникальный идентификатор должности
namerequired
string
Название
Наименование должности
descriptionoptional
string
Описание
Описание должности
permissionsrequired
array
Разрешения
Список кодов разрешений (string[])
created_atrequired
string
Создана
Дата создания (RFC 3339)
updated_atrequired
string
Обновлена
Дата последнего обновления (RFC 3339)

Примеры ответов

200
{
    "status": true,
    "message": "Position updated successfully",
    "data": {
        "id": "ff0e8400-e29b-41d4-a716-446655440141",
        "name": "Старший бухгалтер",
        "description": "Полный доступ к финансам",
        "permissions": ["fm.transactions.create", "fm.analysis", "fm.counterparties"],
        "created_at": "2026-06-14T12:05:00Z",
        "updated_at": "2026-06-14T12:10:00Z"
    },
    "meta": {
        "timestamp": "2026-06-14T12:10:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../modules/hrm/positions/...",
        "method": "PATCH"
    }
}

# Удаление должности

DELETE
/companies/{id}/modules/hrm/positions/{positionId}

Удаляет должность. Связанные сотрудники не удаляются, но теряют разрешения от этой должности.

Примеры ответов

200
{
    "status": true,
    "message": "Position deleted successfully",
    "data": {},
    "meta": {
        "timestamp": "2026-06-14T12:15:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../modules/hrm/positions/...",
        "method": "DELETE"
    }
}