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

# Save Manual Document

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

## Request Overview

<div class="api-docs" id="bkmrk-url%3A-%2Fv2%2Fredis-accou"><div class="endpoint-info"><div>**URL:** `/v2/redis-accounting/save-manual-document`</div><div>**Method:** <span class="method-post">POST</span></div><div>**Auth:** Bearer Token (Required)</div><div>**Content-Type:** application/json</div></div></div>## Request Body Schema

<div class="api-docs" id="bkmrk-field-type-required-"><table class="schema-table"><thead><tr><th>Field</th><th>Type</th><th>Required</th><th>Description</th></tr></thead><tbody><tr><td>`id`</td><td>integer</td><td>yes</td><td>شناسه سند دستی **(manual\_documents.id)**</td></tr></tbody></table>

</div>## Request Example

```
{
  "id": 9234
}
  
```

## Response (Success)

<div class="api-docs" id="bkmrk-field-type-descripti"><table class="schema-table"><thead><tr><th>Field</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>`success`</td><td>boolean</td><td>وضعیت انجام عملیات</td></tr><tr><td>`message`</td><td>string</td><td>پیام وضعیت ذخیره</td></tr><tr><td>`data.manual_document_id`</td><td>integer</td><td>شناسه سندی که پردازش شد</td></tr><tr><td>`data.success`</td><td>boolean</td><td>نتیجه واقعی ذخیره‌سازی از سرویس</td></tr><tr><td>`data.message`</td><td>string</td><td>پیام بازگشتی از سرویس ذخیره‌سازی</td></tr></tbody></table>

</div>```
{
  "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

<div class="api-docs" id="bkmrk-receive-request-%28id%29"><div class="flowchart"><div class="flow-item">Receive Request (id)</div><div class="flow-arrow">↓</div><div class="flow-item">Validate id</div><div class="flow-arrow">↓</div><div class="flow-item">Load Manual Document Details</div><div class="flow-arrow">↓</div><div class="flow-item">Loop over balance rows</div><div class="flow-arrow">↓</div><div class="flow-item">saveDocument(...) for each row</div><div class="flow-arrow">↓</div><div class="flow-item">Return result with saved count</div></div></div>