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