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

Транзакции

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

# Список транзакций

GET
/companies/{id}/modules/fm/transactions

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

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

RESPONSE_DATA:
application/json
transactionsrequired
array
Транзакции
Список транзакций (TransactionDetail[])
paginationrequired
array
pagination

Транзакция

TRANSACTION:
application/json
idrequired
string
ID
Уникальный идентификатор транзакции
base_amountrequired
int
Сумма
Сумма транзакции
currencyrequired
enum
RUB
Валюта
Валюта
directionrequired
enum
incomeexpense
Направление
Направление
statusrequired
enum
pendingcompletedfailedcancelled
Статус
Статус
commentoptional
string
Комментарий
Комментарий к транзакции
reverse_tooptional
string
Сторнирует
ID транзакции, которую сторнирует
created_atrequired
string
Создан
Дата создания (RFC 3339)
metadataoptional
array
Метаданные
Дополнительные данные

Параметры запроса

GET_TRANSACTIONS_PARAMS:
application/json
pageoptional
int
Страница
Номер страницы (по умолчанию 1)
limitoptional
int
Лимит
Записей на странице (по умолчанию 20)
start_dateoptional
string
Начало периода
Начало периода (RFC 3339)
end_dateoptional
string
Конец периода
Конец периода (RFC 3339)
directionoptional
enum
incomeexpense
Направление
Фильтр по направлению
statusoptional
enum
pendingcompletedfailedcancelled
Статус
Фильтр по статусу
category_idoptional
string
ID категории
Фильтр по категории
employee_idoptional
string
ID сотрудника
Фильтр по сотруднику
searchoptional
string
Поиск
Поиск по комментарию

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

200
{
    "status": true,
    "message": "Transactions retrieved successfully",
    "data": {
        "transactions": [
            {
                "id": "a00e8400-e29b-41d4-a716-446655440100",
                "base_amount": 10000,
                "currency": "RUB",
                "direction": "income",
                "status": "completed",
                "comment": "Оплата по счёту #123",
                "reverse_to": null,
                "created_at": "2026-06-14T12:00:00Z",
                "metadata": null,
                "employee_id": "a00e8400-e29b-41d4-a716-446655440150",
                "employee_first_name": "Иван",
                "employee_last_name": "Петров",
                "category_id": "b00e8400-e29b-41d4-a716-446655440050",
                "category_name": "Продажи"
            }
        ],
        "pagination": {
            "total": 1,
            "page": 1,
            "limit": 20,
            "pages": 1
        }
    },
    "meta": {
        "timestamp": "2026-06-14T12:00:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../modules/fm/transactions",
        "method": "GET"
    }
}

# Создание транзакции

POST
/companies/{id}/modules/fm/transactions

Создаёт новую финансовую транзакцию.

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

CREATE_REQUEST:
application/json
base_amountrequired
int
Сумма
Сумма транзакции
currencyrequired
enum
RUB
Валюта
Валюта
directionrequired
enum
incomeexpense
Направление
Направление
employee_idoptional
string
ID сотрудника
Идентификатор сотрудника
commentoptional
string
Комментарий
Комментарий к транзакции
category_idoptional
string
ID категории
Идентификатор категории
statusoptional
enum
pendingcompletedfailedcancelled
Статус
Статус
metadataoptional
array
Метаданные
Дополнительные данные

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

TRANSACTION_DETAIL:
application/json
idrequired
string
ID
Уникальный идентификатор транзакции
base_amountrequired
int
Сумма
Сумма транзакции
currencyrequired
enum
RUB
Валюта
Валюта
directionrequired
enum
incomeexpense
Направление
Направление
statusrequired
enum
pendingcompletedfailedcancelled
Статус
Статус
commentoptional
string
Комментарий
Комментарий к транзакции
reverse_tooptional
string
Сторнирует
ID транзакции, которую сторнирует
created_atrequired
string
Создан
Дата создания (RFC 3339)
metadataoptional
array
Метаданные
Дополнительные данные
employee_idoptional
string
ID сотрудника
Идентификатор сотрудника
employee_first_nameoptional
string
Имя сотрудника
Имя сотрудника
employee_last_nameoptional
string
Фамилия сотрудника
Фамилия сотрудника
category_idoptional
string
ID категории
Идентификатор категории
category_nameoptional
string
Название категории
Название категории

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

201
{
    "status": true,
    "message": "Transaction created successfully",
    "data": {
        "id": "a00e8400-e29b-41d4-a716-446655440101",
        "base_amount": 5000,
        "currency": "RUB",
        "direction": "expense",
        "status": "pending",
        "comment": "Закупка материалов",
        "reverse_to": null,
        "created_at": "2026-06-14T12:05:00Z",
        "metadata": null,
        "employee_id": null,
        "employee_first_name": null,
        "employee_last_name": null,
        "category_id": null,
        "category_name": null
    },
    "meta": {
        "timestamp": "2026-06-14T12:05:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../modules/fm/transactions",
        "method": "POST"
    }
}

# Получение транзакции

GET
/companies/{id}/modules/fm/transactions/{transactionId}

Возвращает детальную информацию о транзакции.

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

TRANSACTION_DETAIL:
application/json
idrequired
string
ID
Уникальный идентификатор транзакции
base_amountrequired
int
Сумма
Сумма транзакции
currencyrequired
enum
RUB
Валюта
Валюта
directionrequired
enum
incomeexpense
Направление
Направление
statusrequired
enum
pendingcompletedfailedcancelled
Статус
Статус
commentoptional
string
Комментарий
Комментарий к транзакции
reverse_tooptional
string
Сторнирует
ID транзакции, которую сторнирует
created_atrequired
string
Создан
Дата создания (RFC 3339)
metadataoptional
array
Метаданные
Дополнительные данные
employee_idoptional
string
ID сотрудника
Идентификатор сотрудника
employee_first_nameoptional
string
Имя сотрудника
Имя сотрудника
employee_last_nameoptional
string
Фамилия сотрудника
Фамилия сотрудника
category_idoptional
string
ID категории
Идентификатор категории
category_nameoptional
string
Название категории
Название категории

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

200
{
    "status": true,
    "message": "Transaction retrieved successfully",
    "data": {
        "id": "a00e8400-e29b-41d4-a716-446655440100",
        "base_amount": 10000,
        "currency": "RUB",
        "direction": "income",
        "status": "completed",
        "comment": "Оплата по счёту #123",
        "reverse_to": null,
        "created_at": "2026-06-14T12:00:00Z",
        "metadata": null,
        "employee_id": "a00e8400-e29b-41d4-a716-446655440150",
        "employee_first_name": "Иван",
        "employee_last_name": "Петров",
        "category_id": "b00e8400-e29b-41d4-a716-446655440050",
        "category_name": "Продажи"
    },
    "meta": {
        "timestamp": "2026-06-14T12:00:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../modules/fm/transactions/...",
        "method": "GET"
    }
}

# Сторнирование транзакции

POST
/companies/{id}/modules/fm/transactions/{transactionId}/reverse

Создаёт обратную транзакцию (сторно) для отмены существующей.

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

TRANSACTION_DETAIL:
application/json
idrequired
string
ID
Уникальный идентификатор транзакции
base_amountrequired
int
Сумма
Сумма транзакции
currencyrequired
enum
RUB
Валюта
Валюта
directionrequired
enum
incomeexpense
Направление
Направление
statusrequired
enum
pendingcompletedfailedcancelled
Статус
Статус
commentoptional
string
Комментарий
Комментарий к транзакции
reverse_tooptional
string
Сторнирует
ID транзакции, которую сторнирует
created_atrequired
string
Создан
Дата создания (RFC 3339)
metadataoptional
array
Метаданные
Дополнительные данные
employee_idoptional
string
ID сотрудника
Идентификатор сотрудника
employee_first_nameoptional
string
Имя сотрудника
Имя сотрудника
employee_last_nameoptional
string
Фамилия сотрудника
Фамилия сотрудника
category_idoptional
string
ID категории
Идентификатор категории
category_nameoptional
string
Название категории
Название категории

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

200
{
    "status": true,
    "message": "Transaction reversed successfully",
    "data": {
        "id": "a00e8400-e29b-41d4-a716-446655440102",
        "base_amount": 10000,
        "currency": "RUB",
        "direction": "expense",
        "status": "completed",
        "comment": "Сторно транзакции a00e8400-e29b-41d4-a716-446655440100",
        "reverse_to": "a00e8400-e29b-41d4-a716-446655440100",
        "created_at": "2026-06-14T12:10:00Z",
        "metadata": null,
        "employee_id": "a00e8400-e29b-41d4-a716-446655440150",
        "employee_first_name": "Иван",
        "employee_last_name": "Петров",
        "category_id": "b00e8400-e29b-41d4-a716-446655440050",
        "category_name": "Продажи"
    },
    "meta": {
        "timestamp": "2026-06-14T12:10:00Z",
        "request_id": "...",
        "path": "/api/v1/companies/.../modules/fm/transactions/.../reverse",
        "method": "POST"
    }
}