Payments¶

Система согласования платежей с цепочками апруверов.

Возможности¶

Создание заявок на оплату
Цепочки согласования
Статусы: pending → approved → paid / rejected
Загрузка документов
Уведомления

Статусы¶

pending   → Ожидает согласования
approved  → Согласован (можно оплачивать)
rejected  → Отклонён
paid      → Оплачен

API¶

Получить платежи¶

GET /api/payments
GET /api/payments?status=pending
GET /api/payments?myApprovals=true  // Только мои согласования

Создать платёж¶

POST /api/payments
Content-Type: multipart/form-data

deal: 123
amount: 50000
currency: KZT
supplier: "ТОО Поставщик"
description: "Оплата за материалы"
invoiceNumber: "СФ-001"
dueDate: "2024-12-15"
priority: high
customApprovers: [2, 5]  // JSON массив ID
files: [invoice.pdf]

Согласовать¶

POST /api/payments/:id/approve
{
  "comment": "Согласовано"
}

Отклонить¶

POST /api/payments/:id/reject
{
  "reason": "Превышен лимит бюджета"
}

Отметить оплаченным¶

POST /api/payments/:id/mark-paid

Цепочка согласования¶

{
  "id": 1,
  "amount": 50000,
  "status": "pending",
  "approvalChain": [
    {
      "order": 0,
      "status": "approved",
      "approver": { "firstName": "Менеджер" },
      "comment": "ОК"
    },
    {
      "order": 1,
      "status": "pending",
      "approver": { "firstName": "Директор" }
    }
  ]
}

Платёж становится approved когда все в цепочке согласовали.

Unread Count¶

GET /api/payments/unread-count

// Response
{ "unreadCount": 3 }  // Платежи ожидающие моего согласования