سرویس «دریافت گردش حساب» در دسته سرویسهای بر پایه حساب فینوتک با گرفتن شماره حساب و بازه تاریخ، فهرست تراکنشهای همان حساب را بههمراه مانده و جزئیات واریز و برداشت برمیگرداند. با این خروجی میتوانید صورتحساب، مغایرتگیری و نمایش حرکت حساب را بدون مراجعه به اینترنتبانک در سامانه خود بسازید.
دریافت گردش حساب چه مشکلی را حل میکند؟
وقتی تسویه، پشتیبانی مالی یا نمایش موجودی به دانستن «چه پولی وارد و خارج شده» وابسته است، گرفتن صورتحساب دستی از شعبه یا فایل اکسل بانک هم کند است و هم با دفاتر داخلی شما همزمان نمیشود. اختلاف یک تراکنش پایا یا یک واریز داخلی، بدون فهرست ساختیافته تراکنشها، به پیگیری تلفنی و چندروزه تبدیل میشود.
این سرویس همان بازه را به یک فراخوانی API تبدیل میکند: حساب تأییدشده و تاریخ شروع و پایان را میفرستید و آرایه تراکنشها، مانده جاری و قابل برداشت، و نشانهای برای وجود صفحه بعدی را میگیرید. نتیجه را میتوانید همان لحظه در پنل نشان دهید یا برای تطبیق با سند داخلی ذخیره کنید.
کاربردهای دریافت گردش حساب
- مغایرتگیری خزانهداری — واحد مالی تراکنشهای بازه را با اسناد داخلی و دستورهای پرداخت مقایسه میکند.
- نمایش صورتحساب در پنل مشتری — کاربر حرکت حساب متصل را در همان محصول شما میبیند.
- تصمیم پس از انتقال نامشخص — وقتی واریز با وضعیت نامعلوم یا کد ۴۰۸ تمام شده، قبل از تکرار، همین گردش حساب بررسی میشود.
- گزارش روزانه صندوق و فروشگاه — واریز و برداشت یک روز کاری در گزارش داخلی جمع میشود.
- حسابرسی دورهای حسابهای عملیاتی — حسابهایی که اپلیکیشن به آنها دسترسی دارد در بازههای کوتاه بازبینی میشوند.
مزایای دریافت گردش حساب
- پاسخ ساختیافته بهجای فایل بانک — هر تراکنش فیلد مانده، مبلغ بدهکار/بستانکار و شرح دارد و به قاعده تصمیم وصل میشود.
- صفحهبندی برای بازههای شلوغ — اگر بیش از ۱۰۰ تراکنش باشد، با
lastRecordNumberصفحه بعد خوانده میشود (بانک آینده). - بدون رضایت پیامکی برای این نسخه — فراخوانی با توکن Client Credential است.
- جزئیات کانال تراکنش — برای تراکنش شبا، کارت یا دفترکل، نقشه اطلاعاتی جدا در پاسخ میآید.
- قابلیت پیگیری هر فراخوانی — با
trackIdیکتا، هر استعلام صورتحساب در گزارش شما پیدا میشود.
چه چیزی از دریافت گردش حساب دریافت میکنید؟
جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.
جریان کار دریافت گردش حساب
- ۱. ساخت کلاینت و گرفتن توکن — با اسکوپ
oak:cc-statement:getتوکن Client Credential بگیرید. - ۲. ارسال حساب و بازه — شماره حساب مسیر و در صورت نیاز
fromDateوtoDateرا بفرستید. بازه بیشتر از ۳۱ روز مجاز نیست. - ۳. خواندن تراکنشها و مانده — آرایه
transactionsو ماندههای حساب را از پاسخ بردارید. - ۴. صفحه بعد در صورت نیاز — اگر
transactionChainبرابرMبود،lastRecordNumberرا در فراخوانی بعدی بفرستید. - ۵. نگهداری نتیجه —
trackIdو فهرست تراکنشها را برای مغایرتگیری ذخیره کنید.
نحوه شروع دریافت گردش حساب
این سرویس با رویکرد Client Credential (بدون رضایت پیامکی) فراخوانی میشود. اسکوپ مورد نیاز: oak:cc-statement:get. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیادهسازی استفاده کنید.
محدودیتها و نکات دریافت گردش حساب
- بازه تاریخ بیشتر از ۳۱ روز پذیرفته نمیشود؛ اگر
fromDateبفرستید،toDateهم لازم است. - قالب تاریخ
YYMMDDو قالب زمانHHMMSSاست. fromTimeوtoTimeبرای بانک کشاورزی، کارآفرین و ملت قابل استفاده نیستند.- صفحهبندی با
lastRecordNumberمخصوص بانک آینده است. - برای بانک صادرات هدر
X-API-KEYاجباری است و مقدار آن را فینوتک میدهد. - حساب باید همان حسابی باشد که برای کلاینت فعال شده است.
سوالات متداول دریافت گردش حساب
دریافت گردش حساب چیست؟
سرویسی است که با شماره حساب و بازه تاریخ، فهرست تراکنشها و مانده حساب را بهصورت داده ساختیافته برمیگرداند.
اگر بیشتر از ۱۰۰ تراکنش در بازه باشد چه میشود؟
مقدار transactionChain برابر M میشود و باید lastRecordNumber خروجی را در فراخوانی بعدی بفرستید تا ۱۰۰ تراکنش بعدی را بگیرید.
آیا رضایت پیامکی کاربر لازم است؟
خیر. این نسخه با Client Credential فراخوانی میشود.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
Grant type: client_credentials. جزئیات در راهنمای توکن.
بازه تاریخ را چطور باید بفرستم؟
قالب YYMMDD است و طول بازه حداکثر ۳۱ روز. اگر تاریخ شروع را بفرستید، تاریخ پایان را هم بفرستید.
مستندات فنی دریافت گردش حساب
مشاهده مستندات فنی «دریافت گردش حساب» — endpoint، پارامترها، نمونه درخواست و پاسخ.