Skip to main content
#P1627

POST /v2/redis-accounting/save-document

Save

1. Overview

Document

این روت مسئول ثبتاندپوینت یک سند حسابداری را در هسته حسابداری Redis ذخیره می‌کند. عملیات شامل ایجاد Hash سند، ساخت ایندکس‌های زمانی و حسابداری، و به‌روزرسانی مانده‌ها در سه سطح گروه/کل/حساب است. سند شامل مبالغ بدهکار/بستانکار، تاریخ شمسی، تاریخ میلادی، گروه/کل/معین/تفضیلی، و توضیحات است.

این Endpointمتد هستهٔستون فقرات سیستم حسابداری است.Redis تمام مانده‌های حساب‌ها از همین مسیر به‌روزمحسوب می‌شوند.شود.

2. Request SchemaOverview

POST




URL: /v2/redis-accounting/save-document


Method: POST


Auth: Bearer Token (Required)


Content-Type: application/json

Request Body

 Schema
FieldTypeRequiredDescription
serialintegeroptionalشماره سریال سند. اگر ارسال نشود، سیستم خودش تولید می‌کند.
descriptionstringyesشرح سند
jalaliDatestringyesتاریخ شمسی با فرمت YYYY-MM-DD (الزامی)
debtornumberoptionalمبلغ بدهکار (پیش‌فرض: 0)
creditornumberoptionalمبلغ بستانکار (پیش‌فرض: 0)
groupintegeryesشناسه گروه حسابداری
generalintegeryesشناسه کل
accountintegeryesشناسه معین
subsidiaryintegeryesشناسه تفضیلی
datetimestringoptionalتاریخ‌زمان میلادی (اگر ارسال نشود، now() استفاده می‌شود)

Request Example

{
  "serial": number,120,
  "description": string,"خرید قطعات",
  "jalaliDate": "YYYY-MM-DD"1403-09-01",
  "debtor": number,250000,
  "creditor": number,0,
  "group": number,10,
  "general": number,101,
  "account": number,1011,
  "subsidiary": number,
  "datetime": "YYYY-MM-DD HH:MM:SS" (optional)1011003
}

3.Response Validation Rules(Success)

  • →required,→required,string
  • jalaliDate
    • →→numeric,max
    FieldTypeDescription
    statusbooleanوضعیت نهایی ذخیره سند
    idintegerشناسه سند ایجادشده در Redis
    serial integer سریال integerاختصاص
  • descriptionداده‌شده
    		•
    time float مدت required,زمان formatاجرای /^[0-9]{4}-[0-9]{2}-[0-9]{2}$/عملیات
  • debtor/creditor(ms)
    		•
    9999999999999
  • group/general/account/subsidiary → required, integer
  • datetime → optional → converted to Carbon

4. Controller Flow

  1. ورودی validate می‌شود.
  2. jalaliDate → تبدیل به میلادی با Jalalian::fromFormat
  3. اگر debtor یا creditor وجود نداشته باشد → 0
  4. datetime اگر وجود نداشت → now()
  5. صدا زدن RedisAccountingService::saveDocument()
  6. برگشت خروجی با:
{
  "status": true,
  "serial": {computed_serial},120,
  "id": {doc_id},934221,
  "time": {execution_time_ms}1.78
}

Response
(Validation

Error)

{
  "status": false,
"message": "خطا در اعتبارسنجی", "errors": { "jalaliDate": [ "The jalaliDate must match YYYY-MM-DD" ] } }

Response (Server Error)

{
  "status": false,
  "message": "خطا در ذخیره سند",
  "trace": [...]
}

Internal Redis Architecture

KeyTypeDescription
accounting:doc:{id}Hashاطلاعات کامل سند ذخیره‌شده
accounting:docs:by_datetimeSortedSetمرتب‌سازی تمام اسناد بر اساس timestamp
accounting:docs:group:{groupId}Setایندکس اسناد گروه
accounting:docs:general:{generalId}Setایندکس سطح کل
accounting:docs:account:{accountId}Setایندکس سطح معین
accounting:docs:subsidiary:{subsidiaryId}Setایندکس سطح تفضیلی

Process Flow

Receive Request
↓
Validate Input
↓
Convert Jalali → Gregorian
↓
Normalize Debtor/Creditor
↓
Generate Serial (if needed)
↓
Create Hash & Indexes in Redis
↓
Update Balances
↓
Return Final Response
Back to top