POST /v2/manual-document/update

Route Info

شرح عملکرد (Functionality)

این مسیر برای ایجاد (add) یا ویرایش (update) یک سند دستی (Manual Document) استفاده می‌شود. روش کار متد بطور خلاصه:

در هر دو حالت، ثبت لاگ در SystemLog انجام می‌شود.

پارامترهای ورودی (JSON Body)

ساختار کلی

{
  "action": "add | update",
  "id": 15,                     // فقط در حالت update
  "date": "1403-05-20",
  "description": "سند دستی",
  "status": 3,
  "currency": 1,
  "currency_fee": 0,
  "sub_serial": null,
  "data": [
    {
      "preference": "colleague-42",
      "moeen": "moeen-18",
      "credit": "0",
      "debit": "250000",
      "description": "توضیحات"
    }
  ],
  "data_delete": [ ... ]         // فقط در حالت update
}

توضیحات پارامترهای کلیدی

خروجی موفق (Success Response)

در حالت ایجاد (add)

{
  "status": true,
  "time": 1718450000,
  "message": "ثبت سند با موفقیت انجام شد. شماره: [3125, 3126]"
}

در حالت ویرایش (update)

{
  "status": true,
  "time": 1718450000,
  "message": "ویرایش سند با موفقیت انجام شد."
}

خروجی خطا (Error Response)

خطا در بازه زمانی بسته مالی

{
  "status": false,
  "time": 1718450000,
  "type": "danger",
  "code": 5007,
  "message": "ثبت و ویرایش سند دستی در بازه زمانی بسته شده امکان پذیر نمی‌باشد..."
}

خطاهای دیتابیس (Insert/Update)

{
  "status": false,
  "time": 1718450000,
  "code": 5006,
  "message": "SQL error message...",
  "trace": [ ... ]
}