Skip to main content
#P1595

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 تهی شده و اجرای کد ممکن است خطای سیستمی ایجاد کند.
  • در صورت بروز خطای پایگاه داده، خطای عمومی سرور برگردانده می‌شود.