Skip to main content
#P1626

POST /v2/redis-accounting/save-manual-document

Save Manual Document

این اندپوینت یک سند دستی (Manual Document) را از دیتابیس بارگذاری کرده و ردیف‌های آن را در Redis ذخیره می‌کند. این عملیات زمانی استفاده می‌شود که بخواهیم وضعیت یک سند دستی در Redis بازسازی یا هماهنگ‌سازی شود.

Request Overview

URL: /v2/redis-accounting/save-manual-document
Method: POST
Auth: Bearer Token (Required)
Content-Type: application/json

Request Body Schema

Field Type Required Description
id integer yes شناسه سند دستی (manual_documents.id)

Request Example

{
  "id": 9234
}
  

Response (Success)

Field Type Description
success boolean وضعیت انجام عملیات
message string پیام وضعیت ذخیره
data.manual_document_id integer شناسه سندی که پردازش شد
data.success boolean نتیجه واقعی ذخیره‌سازی از سرویس
data.message string پیام بازگشتی از سرویس ذخیره‌سازی
{
  "success": true,
  "message": "Saved 3 documents to Redis",
  "data": {
    "success": true,
    "message": "Saved 3 documents to Redis",
    "manual_document_id": 9234
  }
}
  

Response (Validation Error)

{
  "success": false,
  "message": "خطا در اعتبارسنجی",
  "errors": {
    "id": [
      "The id field is required"
    ]
  }
}
  

Response (Server Error)

{
  "success": false,
  "message": "خطا در ذخیره سند: <error details>"
}
  

Process Flow

Receive Request (id)
Validate id
Load Manual Document Details
Loop over balance rows
saveDocument(...) for each row
Return result with saved count