# GET /v2/wallet/balance

<div id="bkmrk-" style="direction: rtl; font-family: Vazir,Tahoma; text-align: justify; line-height: 1.85;"></div>### Route Info

<div id="bkmrk-method-endpoint-cont" style="direction: rtl; font-family: Vazir,Tahoma; text-align: justify; line-height: 1.85;"><div><table border="1" style="width: 100%; margin: auto; border-collapse: collapse; text-align: center; border: 1px solid #ddd;"><tbody><tr style="background: #f4f4f4; font-weight: bold;"><td style="padding: 10px;">Method</td><td style="padding: 10px;">Endpoint</td><td style="padding: 10px;">Controller</td></tr><tr><td style="direction: ltr; padding: 10px;">GET</td><td style="direction: ltr; padding: 10px;">/v2/wallet/balance</td><td style="direction: ltr; padding: 10px;">AccountingController@balanceWallet</td></tr></tbody></table>

</div></div>### شرح عملکرد (Functionality)

این متد وظیفه محاسبه تراز کیف پول (Wallet) را بر عهده دارد. بر اساس کدهای فعلی، این متد **صرفاً موجودی کیف پول شعبه (ERP)** را محاسبه می‌کند.

<div id="bkmrk-%D9%85%D9%86%D8%B7%D9%82-%D9%85%D8%AD%D8%A7%D8%B3%D8%A8%D9%87%3A-%D8%AC%D9%85%D8%B9-%D8%B3%D8%AA%D9%88" style="direction: rtl; font-family: Vazir,Tahoma; text-align: justify; line-height: 1.85;">- **منطق محاسبه:** جمع ستون‌های `credit` (بستانکار) و `debit` (بدهکار) از جدول `wallet`.
- **فیلترها:**
    - رکوردهایی که `status` آن‌ها برابر 2 (احتمالا حذف شده/لغو شده) نباشد.
    - فیلد `operator_type` برابر با **'erp'** باشد (ثابت در کد).
    - فیلد `branch` برابر با شناسه ارسالی (یا شناسه شعبه توکن جاری) باشد.
- **تشخیص ماهیت (Diagnosis):** سیستم به صورت خودکار وضعیت تراز را به یکی از سه حالت `creditor` (بستانکار/مثبت)، `debtor` (بدهکار/منفی) یا `neutral` (بی‌حساب/صفر) تعیین می‌کند.

</div>### پارامترهای ورودی (Query String)

```
?type=office       // (بلااستفاده) به دلیل باگ داخلی نادیده گرفته می‌شود
&id=101            // (اختیاری) شناسه شعبه. اگر ارسال نشود از توکن کاربر خوانده می‌شود
```

<div id="bkmrk--1" style="direction: rtl; font-family: Vazir,Tahoma; text-align: justify; line-height: 1.85;"></div>### خروجی (Response)

#### موفقیت (Success):

ساختار خروجی استاندارد شامل `payload` (داده اصلی) و `meta` (اطلاعات متا) است.

```
{
    "payload": {
        "credit": 15000000,       // مجموع ورودی‌ها
        "debit": 5000000,         // مجموع خروجی‌ها
        "balance": 10000000,      // مانده (credit - debit)
        "diagnosis": "creditor"   // وضعیت: creditor | debtor | neutral
    },
    "meta": {
        "timestamp": 1715780000
    }
}
```

#### خطا (Error):

```
{
    "status": false,
    "time": 1715780005,
    "message": "Error message here...",
    "trace": [...]
}
```