POST /v2/accounting/connections/view

Route Info 

 

 

 

 

 Method 

 Endpoint 

 Controller 

 

 

 POST 

 /v2/accounting/connections/view 

 AccountingController@viewConnection 

 

 

 

 

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

 این مسیر برای نمایش جزئیات کامل یک Connection استفاده می‌شود. در این متد، نوع اتصال بررسی می‌شود و در صورتی که اتصال از نوع leger_account باشد، عملیات زیر انجام می‌شود: 

 

 

 فراخوانی تابع داخلی ledgerAccounts() برای استخراج تمامی آیتم‌های مرتبط با Connection. 

 گردآوری تراکنش‌ها از جداول مختلف شامل:

 

 pays 

 factor_items 

 check_operations 

 announcements 

 financial_pasts (افتتاحیه) 

 

 

 تولید آرایه یکپارچه شامل رکوردهای مالی، چک‌ها، رفرنس‌ها، اعلان‌ها و اسناد مرتبط. 

 مرتب‌سازی نهایی نتایج بر اساس تاریخ شمسی. 

 

 

 خروجی شامل لیست نهایی اسناد (Bills) است که برای نمایش جزئیات دفاتر حسابداری استفاده می‌شود. 

 

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

 {

 "connection_id": 42

}

 

 

 

 connection_id : شناسه اتصال موردنظر جهت نمایش اسناد. 

 

 

 خروجی (Response) 

 موفق (Success) 

 {

 "status": true,

 "time": 1718450000,

 "data": [

 { ... ledger items ... }

 ]

}

 

 فیلد data شامل آرایه‌ای از تمام آیتم‌های دفتر حساب (Ledger) است. هر آیتم شامل فیلدهای: 

 

 

 serial_id 

 serial 

 datetime 

 credit 

 debit 

 description (html/text) 

 details (documents/title/type) 

 relationship 

 communications 

 

 

 خطاها (Errors) 

 این مسیر مدیریت خطای اختصاصی ندارد. 

 

 

 در صورتی که connection_id یافت نشود، مقدار $connection تهی شده و اجرای کد ممکن است خطای سیستمی ایجاد کند. 

 در صورت بروز خطای پایگاه داده، خطای عمومی سرور برگردانده می‌شود.