Методы для управления контрагентами организации.
Возвращает список контрагентов с пагинацией и фильтрацией.
{
"status": true,
"message": "Counterparties retrieved successfully",
"data": {
"counterparties": [
{
"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"
}
],
"pagination": {
"total": 1,
"page": 1,
"limit": 20,
"pages": 1
}
},
"meta": {
"timestamp": "2026-06-14T12:00:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/fm/counterparties",
"method": "GET"
}
}Создаёт нового контрагента.
{
"status": true,
"message": "Counterparty created successfully",
"data": {
"id": "c00e8400-e29b-41d4-a716-446655440061",
"name": "ИП Иванов",
"comment": null,
"type": "person",
"status": "active",
"metadata": null,
"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/fm/counterparties",
"method": "POST"
}
}Возвращает информацию о контрагенте.
{
"status": true,
"message": "Counterparty retrieved successfully",
"data": {
"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/counterparties/...",
"method": "GET"
}
}Обновляет данные контрагента.
{
"status": true,
"message": "Counterparty updated successfully",
"data": {
"id": "c00e8400-e29b-41d4-a716-446655440061",
"name": "ИП Иванов (обновлено)",
"comment": "Поставщик материалов",
"type": "person",
"status": "active",
"metadata": null,
"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/fm/counterparties/...",
"method": "PATCH"
}
}Деактивирует контрагента.
{
"status": true,
"message": "Counterparty deactivated successfully",
"data": {
"id": "c00e8400-e29b-41d4-a716-446655440061",
"name": "ИП Иванов (обновлено)",
"comment": "Поставщик материалов",
"type": "person",
"status": "inactive",
"metadata": null,
"created_at": "2026-06-14T12:05:00Z",
"updated_at": "2026-06-14T12:15:00Z"
},
"meta": {
"timestamp": "2026-06-14T12:15:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/fm/counterparties/.../deactivate",
"method": "POST"
}
}Активирует деактивированного контрагента.
{
"status": true,
"message": "Counterparty activated successfully",
"data": {
"id": "c00e8400-e29b-41d4-a716-446655440061",
"name": "ИП Иванов (обновлено)",
"comment": "Поставщик материалов",
"type": "person",
"status": "active",
"metadata": null,
"created_at": "2026-06-14T12:05:00Z",
"updated_at": "2026-06-14T12:20:00Z"
},
"meta": {
"timestamp": "2026-06-14T12:20:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/fm/counterparties/.../activate",
"method": "POST"
}
}