Методы для управления кредитами и долгами организации.
Возвращает список кредитов с пагинацией и фильтрацией.
{
"status": true,
"message": "Credits retrieved successfully",
"data": {
"credits": [
{
"id": "d00e8400-e29b-41d4-a716-446655440070",
"name": "Кредит в банке",
"comment": "На развитие бизнеса",
"type": "credit",
"status": "active",
"total_amount": 1000000,
"currency": "RUB",
"interest_rate": 15,
"start_date": "2026-01-01T00:00:00Z",
"end_date": "2027-01-01T00:00:00Z",
"metadata": null,
"created_at": "2026-06-14T12:00:00Z",
"updated_at": "2026-06-14T12:00:00Z",
"counterparty": {
"id": "c00e8400-e29b-41d4-a716-446655440060",
"name": "ООО Ромашка",
"type": "organization",
"status": "active"
}
}
],
"pagination": {
"total": 1,
"page": 1,
"limit": 20,
"pages": 1
}
},
"meta": {
"timestamp": "2026-06-14T12:00:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/fm/credits",
"method": "GET"
}
}Создаёт новый кредит или долг.
{
"status": true,
"message": "Credit created successfully",
"data": {
"id": "d00e8400-e29b-41d4-a716-446655440071",
"name": "Заём от учредителя",
"comment": null,
"type": "debt",
"status": "active",
"total_amount": 500000,
"currency": "RUB",
"interest_rate": 0,
"start_date": "2026-06-14T00:00:00Z",
"end_date": "2026-12-14T00:00:00Z",
"metadata": null,
"created_at": "2026-06-14T12:05:00Z",
"updated_at": "2026-06-14T12:05:00Z",
"counterparty": {
"id": "c00e8400-e29b-41d4-a716-446655440061",
"name": "ИП Иванов",
"type": "person",
"status": "active"
}
},
"meta": {
"timestamp": "2026-06-14T12:05:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/fm/credits",
"method": "POST"
}
}Возвращает информацию о кредите.
{
"status": true,
"message": "Credit retrieved successfully",
"data": {
"id": "d00e8400-e29b-41d4-a716-446655440070",
"name": "Кредит в банке",
"comment": "На развитие бизнеса",
"type": "credit",
"status": "active",
"total_amount": 1000000,
"currency": "RUB",
"interest_rate": 15,
"start_date": "2026-01-01T00:00:00Z",
"end_date": "2027-01-01T00:00:00Z",
"metadata": null,
"created_at": "2026-06-14T12:00:00Z",
"updated_at": "2026-06-14T12:00:00Z",
"counterparty": {
"id": "c00e8400-e29b-41d4-a716-446655440060",
"name": "ООО Ромашка",
"comment": "Поставщик",
"type": "organization",
"status": "active",
"metadata": null,
"created_at": "2026-06-14T12:00:00Z",
"updated_at": "2026-06-14T12:00:00Z"
}
},
"meta": {
"timestamp": "2026-06-14T12:00:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/fm/credits/...",
"method": "GET"
}
}Возвращает список платежей по кредиту.
{
"status": true,
"message": "Credit transactions retrieved successfully",
"data": {
"transactions": [
{
"id": "a00e8400-e29b-41d4-a716-446655440103",
"base_amount": 100000,
"currency": "RUB",
"direction": "expense",
"status": "completed",
"comment": "Платёж по кредиту d00e8400-e29b-41d4-a716-446655440071",
"reverse_to": null,
"created_at": "2026-06-14T12:25:00Z",
"metadata": null,
"employee_id": "a00e8400-e29b-41d4-a716-446655440150",
"employee_first_name": "Иван",
"employee_last_name": "Петров",
"category_id": "b00e8400-e29b-41d4-a716-446655440051",
"category_name": "Кредиты"
}
],
"pagination": {
"total": 1,
"page": 1,
"limit": 20,
"pages": 1
}
},
"meta": {
"timestamp": "2026-06-14T12:30:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/fm/credits/.../transactions",
"method": "GET"
}
}Создаёт платёж по кредиту.
{
"status": true,
"message": "Credit payment created successfully",
"data": {
"id": "a00e8400-e29b-41d4-a716-446655440103",
"base_amount": 100000,
"currency": "RUB",
"direction": "expense",
"status": "completed",
"comment": "Платёж по кредиту d00e8400-e29b-41d4-a716-446655440071",
"reverse_to": null,
"created_at": "2026-06-14T12:25:00Z",
"metadata": null,
"employee_id": "a00e8400-e29b-41d4-a716-446655440150",
"employee_first_name": "Иван",
"employee_last_name": "Петров",
"category_id": "b00e8400-e29b-41d4-a716-446655440051",
"category_name": "Кредиты"
},
"meta": {
"timestamp": "2026-06-14T12:25:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/fm/credits/.../pay",
"method": "POST"
}
}Обновляет данные кредита.
{
"status": true,
"message": "Credit updated successfully",
"data": {
"id": "d00e8400-e29b-41d4-a716-446655440071",
"name": "Заём от учредителя (обновлено)",
"comment": "Беспроцентный заём",
"type": "debt",
"status": "active",
"total_amount": 500000,
"currency": "RUB",
"interest_rate": 0,
"start_date": "2026-06-14T00:00:00Z",
"end_date": "2026-12-14T00:00:00Z",
"metadata": null,
"created_at": "2026-06-14T12:05:00Z",
"updated_at": "2026-06-14T12:10:00Z",
"counterparty": {
"id": "c00e8400-e29b-41d4-a716-446655440061",
"name": "ИП Иванов",
"type": "person",
"status": "active"
}
},
"meta": {
"timestamp": "2026-06-14T12:10:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/fm/credits/...",
"method": "PATCH"
}
}Деактивирует кредит.
{
"status": true,
"message": "Credit deactivated successfully",
"data": {
"id": "d00e8400-e29b-41d4-a716-446655440071",
"name": "Заём от учредителя (обновлено)",
"comment": "Беспроцентный заём",
"type": "debt",
"status": "closed",
"total_amount": 500000,
"currency": "RUB",
"interest_rate": 0,
"start_date": "2026-06-14T00:00:00Z",
"end_date": "2026-12-14T00:00:00Z",
"metadata": null,
"created_at": "2026-06-14T12:05:00Z",
"updated_at": "2026-06-14T12:15:00Z",
"counterparty": {
"id": "c00e8400-e29b-41d4-a716-446655440061",
"name": "ИП Иванов",
"type": "person",
"status": "active"
}
},
"meta": {
"timestamp": "2026-06-14T12:15:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/fm/credits/.../deactivate",
"method": "POST"
}
}Активирует деактивированный кредит.
{
"status": true,
"message": "Credit activated successfully",
"data": {
"id": "d00e8400-e29b-41d4-a716-446655440071",
"name": "Заём от учредителя (обновлено)",
"comment": "Беспроцентный заём",
"type": "debt",
"status": "active",
"total_amount": 500000,
"currency": "RUB",
"interest_rate": 0,
"start_date": "2026-06-14T00:00:00Z",
"end_date": "2026-12-14T00:00:00Z",
"metadata": null,
"created_at": "2026-06-14T12:05:00Z",
"updated_at": "2026-06-14T12:20:00Z",
"counterparty": {
"id": "c00e8400-e29b-41d4-a716-446655440061",
"name": "ИП Иванов",
"type": "person",
"status": "active"
}
},
"meta": {
"timestamp": "2026-06-14T12:20:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/fm/credits/.../activate",
"method": "POST"
}
}