سرویس «استعلام تاریخچه قبض» در دسته استعلام قبض فینوتک با تعیین نوع قبض برق یا گاز و شناسه قبض یا شماره اشتراک، فهرست تاریخچه قبضهای آن اشتراک را برمیگرداند. با این سرویس میتوانید سابقه قبض یک مکان را ببینید، نه فقط بدهی همین دوره.
استعلام تاریخچه قبض چه مشکلی را حل میکند؟
سابقه قبض برق و گاز یک ملک معمولاً جایی بیرون از سامانههای کسبوکار میماند: در رسیدهای کاغذی بایگانیشده، در سامانه جداگانه سازمان خدماتی یا در حافظه مالک قبلی. هر بار که تیمی به این سابقه نیاز پیدا میکند — هنگام تحویل ملک، تسویه با مستاجر، بررسی هزینه یک شعبه یا رسیدگی به اعتراض مشتری — کار به جمعآوری دستی مدارک و مکاتبه میرسد و پرونده روزها باز میماند.
این سرویس همان سابقه را به یک فراخوانی API تبدیل میکند: نوع قبض و شناسه مربوط به آن را میفرستید و فهرست تاریخچه قبض را بهصورت داده ساختیافته میگیرید. خروجی، تصمیمهایی را تغذیه میکند که با بدهی یک دوره قابل گرفتن نیستند؛ مثل تشخیص اینکه قبضهای یک مکان بهطور منظم تسویه شده است یا نه، مستندسازی وضعیت اشتراک در زمان تحویل ملک و ساختن گزارش هزینه چنددورهای. این سرویس تنها استعلام میکند و هیچ قبضی را پرداخت نمیکند.
کاربردهای استعلام تاریخچه قبض
- پلتفرمهای معاملات و اجاره ملک — پیش از تحویل یا تخلیه، سابقه قبض برق و گاز ملک بررسی و در پرونده معامله ثبت میشود.
- مدیریت دارایی و ساختمان — مدیر مجموعه، سابقه قبض هر واحد یا هر انشعاب را برای بستن حساب دورهای در اختیار دارد.
- تیم مالی شرکتهای چندشعبهای — هزینه برق و گاز شعب و انبارها در چند دوره کنار هم دیده میشود و برای بودجهبندی به کار میرود.
- پشتیبانی و رسیدگی به اعتراض مشترکان — کارشناس با دیدن سابقه قبض، به پرسش مشتری درباره دورههای گذشته پاسخ میدهد.
- اپلیکیشنهای مدیریت هزینه خانوار — کاربر سابقه قبض برق و گاز محل سکونت خود را در یک نما دنبال میکند.
مزایای استعلام تاریخچه قبض
- نگاه چنددورهای بهجای یک عدد — برخلاف استعلام بدهی جاری، تصویری از سابقه اشتراک در اختیار شما قرار میگیرد.
- مستندسازی بدون مدرک کاغذی — سابقه بهصورت داده در پرونده معامله، تیکت یا گزارش مالی ذخیره میشود.
- ورودی آشنا برای تیمهای فنی — همان الگوی نوع قبض و شناسه متناظر که در بقیه سرویسهای این دسته به کار میرود.
- مناسب گزارشگیری دورهای — خروجی ساختیافته است و میتوانید آن را در انبار داده و داشبورد خود بنشانید.
- بدون نیاز به تعامل با کاربر — فراخوانی با توکن Client Credential انجام میشود و رضایت پیامکی لازم نیست.
چه چیزی از استعلام تاریخچه قبض دریافت میکنید؟
جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.
جریان کار استعلام تاریخچه قبض
- ۱. گرفتن توکن — با اسکوپ
billing:bill-history-inquiry:getتوکن Client Credential بگیرید. - ۲. تعیین نوع قبض — مشخص کنید تاریخچه قبض برق میخواهید یا گاز.
- ۳. ارسال شناسه — برای برق شناسه قبض و برای گاز شماره اشتراک را همراه یک
trackIdیکتا بفرستید. - ۴. خواندن فهرست تاریخچه — فهرست بازگشتی را به ترتیب دوره در رابط کاربری یا گزارش خود نمایش دهید.
- ۵. نگهداری برای گزارش — فهرست و
trackIdرا در پرونده مکان یا مشترک ذخیره کنید تا در بازبینیهای بعدی قابل استناد باشد.
نحوه شروع استعلام تاریخچه قبض
این سرویس با رویکرد Client Credential (بدون رضایت پیامکی) فراخوانی میشود. اسکوپ مورد نیاز: billing:bill-history-inquiry:get. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیادهسازی استفاده کنید.
محدودیتها و نکات استعلام تاریخچه قبض
- نوع قبض در این سرویس فقط برق یا گاز است؛ برای آب، تلفن ثابت و تلفن همراه از استعلام قبض استفاده کنید.
- مقدار ورودی بسته به نوع قبض تفسیر میشود: برای برق شناسه قبض و برای گاز شماره اشتراک.
- خروجی این سرویس سابقه قبض است، نه دستور پرداخت؛ تسویه در مسیرهای پرداخت خودتان انجام میشود.
- تعداد آیتمهای بازگشتی ثابت نیست؛ رابط کاربری و گزارش خود را برای فهرست خالی یا بلند آماده کنید.
- فهرست بازگشتی وضعیت لحظه استعلام است؛ برای گزارشهای دورهای، زمان استعلام را کنار داده ذخیره کنید.
trackIdیکتا بفرستید و داده اشتراک را فقط برای همان هدف کسبوکاری نگه دارید و دسترسی به آن را محدود کنید.
سوالات متداول استعلام تاریخچه قبض
استعلام تاریخچه قبض چیست؟
سرویسی است که با تعیین نوع قبض (برق یا گاز) و شناسه قبض یا شماره اشتراک، فهرست تاریخچه قبض آن اشتراک را برمیگرداند.
تفاوت این سرویس با استعلام قبض چیست؟
استعلام قبض بدهی جاری یک قبض را برمیگرداند؛ این سرویس سابقه قبض یک اشتراک برق یا گاز را میدهد.
برای گاز چه مقداری باید فرستاده شود؟
شماره اشتراک گاز؛ برای برق شناسه قبض ارسال میشود. شرح ورودیها در مستندات فنی آمده است.
آیا این سرویس امکان پرداخت قبضهای گذشته را میدهد؟
خیر. این سرویس فقط سابقه قبض را استعلام میکند و هیچ عمل پرداختی در آن انجام نمیشود.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
Grant type: client_credentials. جزئیات در راهنمای توکن.
آیا رضایت پیامکی کاربر لازم است؟
خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.
مستندات فنی استعلام تاریخچه قبض
مشاهده مستندات فنی «استعلام تاریخچه قبض» — endpoint، پارامترها، نمونه درخواست و پاسخ.