Watch
1
0
Fork
You've already forked Seyyed_arc
0
forked from hesabix/arc
Seyyed_arc/docs/QUICK_SALES_CUSTOMER_BALANCE.md

35 lines
3.5 KiB
Markdown

# اعمال مانده مشتری در فروش سریع
در فروش سریع، پس از انتخاب یک مشتری مشخص، مانده حساب او در ارز فاکتور و تا تاریخ فاکتور زیر فیلد مشتری نمایش داده می‌شود. علامت مانده در API به این صورت است:
- مانده مثبت: مشتری بستانکار است.
- مانده منفی: مشتری بدهکار است.
- مانده صفر: حساب تسویه است.
گزینه «اعمال مانده در مبلغ قابل تسویه» به صورت پیش‌فرض خاموش است. این گزینه برای مشتری ناشناس یا مانده صفر فعال نمی‌شود. مبلغ خود فاکتور با فعال کردن این گزینه تغییر نمی‌کند؛ فقط مبلغی که صندوق‌دار باید تسویه کند تغییر می‌کند.
## محاسبه مبلغ قابل تسویه
اگر مبلغ فاکتور ۵٬۰۰۰٬۰۰۰ ریال باشد:
- مشتری با ۲٬۰۰۰٬۰۰۰ ریال بدهی قبلی باید ۷٬۰۰۰٬۰۰۰ ریال بپردازد.
- مشتری با ۲٬۰۰۰٬۰۰۰ ریال بستانکاری قبلی باید ۳٬۰۰۰٬۰۰۰ ریال بپردازد.
- اگر بستانکاری مشتری ۷٬۰۰۰٬۰۰۰ ریال باشد، مبلغ قابل تسویه صفر است و ۲٬۰۰۰٬۰۰۰ ریال بستانکاری برای او باقی می‌ماند.
در حالت بدهکار، دریافتی ابتدا بدهی قبلی را تسویه می‌کند و سپس به فاکتور جاری تخصیص می‌یابد. در حالت بستانکار، بخشی از اعتبار قبلی تا سقف مبلغ فاکتور به فاکتور جاری تخصیص داده می‌شود.
## کنترل هم‌زمانی و تاریخ
رابط کاربری مانده را از مسیر زیر دریافت می‌کند:
`GET /api/v1/businesses/{business_id}/quick-sales/customer-balance`
پارامترهای درخواست `person_id`، `currency_id` و `as_of_date` هستند. محاسبه فقط اسناد قطعی سال مالی جاری را در همان ارز و تا تاریخ فاکتور در نظر می‌گیرد.
هنگام ثبت فاکتور، بک‌اند مانده را دوباره محاسبه می‌کند. اگر مانده از زمان نمایش تا ثبت تغییر کرده باشد، پاسخ `409` با کد `QUICK_SALE_CUSTOMER_BALANCE_CHANGED` برگردانده می‌شود تا کاربر مانده جدید را ببیند و دوباره تصمیم بگیرد.
## اطلاعات ذخیره‌شده روی فاکتور
نتیجه نهایی در `extra_info.quick_sale_customer_balance` ثبت می‌شود و شامل مانده قبل از فاکتور، بدهی قبلی، اعتبار اعمال‌شده و مبلغ قابل تسویه است. این اطلاعات برای محاسبه مانده همان فاکتور و تشخیص اضافه‌دریافت استفاده می‌شود. سند حسابداری جداگانه‌ای برای «اعمال مانده» ساخته نمی‌شود، چون اثر آن از گردش واقعی حساب شخص به دست می‌آید.
در فروش‌های پارک‌شده فقط انتخاب کاربر برای اعمال مانده نگهداری می‌شود. هنگام بازگشت به فروش، مانده دوباره از سرور خوانده می‌شود و مقدار قدیمی به عنوان مبنای ثبت استفاده نمی‌شود.