ملی ای‌پی‌آی

قبض آب بدون شناسه قبض: چه راه‌هایی هست و چه راهی نیست

استعلام قبض آب در این سرویس فقط با شناسه قبض انجام می‌شود، نه کد ملی یا نشانی؛ اگر شناسه را ندارید باید از قبض قبلی، سامانهٔ استان یا مالک بگیرید.

با کد ملی یا نشانی نمی‌شود قبض آب را از این سرویس گرفت: ورودی فقط شناسه قبض است. اگر آن را ندارید، اول باید شناسه را پیدا کنید و بعد استعلام بزنید، نه برعکس.

این پرسش در جست‌وجو زیاد تکرار می‌شود، چون بسیاری از مردم قبض آب را فقط وقتی لازم دارند که قبض کاغذی دم‌دستشان نیست: تازه اسباب‌کشی کرده‌اند، مستأجرند، یا از طرف مالک پیگیری می‌کنند. این راهنما می‌گوید در آن لحظه چه راه‌هایی واقعاً هست، و اگر محصولی می‌سازید که این سرویس را صدا می‌زند، فرمش را چطور طراحی کنید که کاربر بی‌شناسه رها نشود.

چه ورودی‌ای پذیرفته نمی‌شود

سرویس استعلام قبض آب یک فیلد ورودی دارد: billId، شش تا سیزده رقم. این‌ها را نمی‌پذیرد:

  • کد ملی مالک یا مشترک
  • نشانی ملک یا کد پستی
  • نام مشترک
  • شماره اشتراک به‌جای شناسه قبض

دلیل فنی‌اش ساده است: فرم و قرارداد ورودی این سرویس همین یک فیلد را دارد. اگر چیز دیگری بفرستید، نتیجه نمی‌گیرید. و دلیل منطقی‌اش این است که شناسه قبض مشترک را مشخص می‌کند، در حالی که کد ملی یک نفر می‌تواند چند انشعاب داشته باشد و یک نشانی ممکن است چند قبض.

درباره تفاوت شناسه قبض و شناسه پرداخت و اینکه کدام را وارد کنید، شناسه قبض و شناسه پرداخت چیست؟ را بخوانید. اینجا فرض بر این است که مشکل شما «عدد را ندارم» است، نه «عدد را اشتباه برداشتم».

شناسه را از کجا بیاوریم

منبع‌هایی که مردم عملاً استفاده می‌کنند، به ترتیب از ساده به سخت:

۱. قبض کاغذی قبلی. شناسه روی قبض چاپ شده است، پس پوشهٔ قبوض قدیمی یا عکس قبضی که قبلاً گرفته‌اید هم کفایت می‌کند. گزارش‌های فارسی دربارهٔ شناسه قبض می‌گویند شناسه به مصرف بستگی ندارد و با تغییر مصرف عوض نمی‌شود، پس قبض چند دورهٔ قبل هم کار می‌کند؛ این را یک منبع می‌گوید و من آن را قطعی نمی‌دانم، پس یک بار با استعلام امتحانش کنید و به نشانی و نام مالک در نتیجه نگاه کنید.

۲. سامانهٔ شرکت آب و فاضلاب استان. هر استان سامانهٔ خودش را دارد. بعضی از آن‌ها علاوه بر شناسه قبض، شماره مشترک را هم می‌پذیرند. این رفتار از استانی به استان دیگر فرق می‌کند و چیزی نیست که ما کنترلش کنیم؛ سرویس ما شماره مشترک را نمی‌پذیرد.

۳. اپلیکیشن‌های اسکن بارکد. بعضی اپ‌ها بارکد قبض کاغذی را می‌خوانند. اگر قبض کاغذی دارید ولی عدد خوانا نیست، این راه کمک می‌کند. سرویس ما بارکد نمی‌خواند و تصویر نمی‌گیرد.

۴. مالک یا مدیر ساختمان. در مستأجری ساده‌ترین راه همین است. شناسه ملک است، نه شخص، پس مالک بی‌دردسر می‌تواند عکس قبض را بفرستد.

چطور بفهمم شناسهٔ پیداشده درست است

نتیجهٔ استعلام نشانی واحد و نام مالک را هم برمی‌گرداند. بعد از اولین استعلام، این دو را با ملکی که می‌دانید مقایسه کنید. اگر نشانی مال جای دیگری بود، یا شناسه اشتباه برداشته شده یا قبض مال ملک دیگری است.

نشانی را رشته‌به‌رشته با نشانی خودتان تطبیق ندهید. املای نشانی هیچ‌وقت یکسان نیست («خیابان» و «خ»، ارقام فارسی و لاتین). یک بررسی چشمی کافی است: نام محله و خیابان درست‌اند یا نه.

فرم خودتان را چطور بسازید

اگر محصولی دارید که شناسه قبض آب از کاربر می‌گیرد، چهار کار کمک می‌کند:

  1. زیر کادر بنویسید «عدد زیر برچسب شناسه قبض، شش تا سیزده رقم». برچسب را بنویسید، نه فقط «شناسه».
  2. خط تیره، فاصله و ارقام فارسی را خودتان پیش از ارسال پاک و یکدست کنید. API این‌ها را هم می‌پذیرد، ولی اعتبارسنجی سمت خودتان خطای زودتر و روشن‌تری می‌دهد.
  3. پیوندی به «شناسه را کجا پیدا کنم» بگذارید که همین چهار راه را بگوید.
  4. اگر کاربر نمی‌تواند شناسه را بدهد، مسیر دیگری پیشنهاد کنید، نه خطا. مثلاً «از مالک بخواهید» یا «بعداً ادامه دهید و ذخیره می‌کنیم».

ورودی نامعتبر خطای invalid_input با HTTP ۴۰۰ می‌گیرد و هزینه ندارد، پس اعتبارسنجی پیش از ارسال برای صرفه‌جویی لازم نیست، ولی برای تجربهٔ کاربر خوب است.

چه کسی می‌تواند ببیند

این بخش را نادیده نگیرید. نتیجهٔ استعلام نام مالک و نشانی کامل را می‌دهد، و کسی که شناسه را داشته باشد می‌تواند آن را بپرسد. لازم نیست مالک باشد. این خودش اشکالی نیست، ولی در محصول شما معنا دارد.

اگر فرم عمومی بسازید که هر غریبه‌ای شناسه بزند و نشانی و نام مالک را ببیند، شما یک ابزار جست‌وجوی اطلاعات شخصی ساخته‌اید. پیشنهاد من: نتیجهٔ کامل را فقط پشت ورود کاربر و برای ملکی نشان دهید که کاربر با آن ارتباط دارد، یا نام را پوشیده کنید («ع. ر***») و فقط نشانی ناقص را بدهید تا کاربر خودش بتواند صحت را بسنجد.

آنچه این سرویس نمی‌کند

  • با کد ملی، نشانی، نام یا شماره اشتراک جست‌وجو نمی‌کند.
  • شناسه قبض گمشده را بازیابی نمی‌کند.
  • انشعاب‌های یک فرد را فهرست نمی‌کند.
  • پرداخت انجام نمی‌دهد؛ شناسهٔ پرداخت را برمی‌گرداند و پرداخت از درگاه شماست.

وقتی کاربر فقط قبض عکس‌گرفته‌شده دارد

یک حالت واقعی: کاربر عکس قبض را در گالری دارد ولی عدد را از روی صفحهٔ گوشی درست نمی‌خواند. فرم شما می‌تواند دو کمک بدهد. اول، کادر ورودی را بزرگ و با فونت خوانا بسازید و ارقام را گروه‌بندی نکنید که با خط تیره قاطی نشود. دوم، پس از استعلام نشانی و نام را نشان دهید و بپرسید «این ملک شماست؟». اگر کاربر «نه» زد، یعنی عدد را اشتباه خوانده است و شما یک تلاش اضافه را پیش از اینکه تکرار شود متوقف کرده‌اید.

هر تلاش هزینه دارد، پس فرمی که اشتباه ورودی را زود نشان می‌دهد برای شما هم ارزان‌تر است. فقط ورودی نامعتبر رایگان است؛ شناسهٔ درستی که به ملک دیگری تعلق دارد، یک استعلام معتبر است و هزینه می‌گیرد. برای همین پیش از ارسال حتماً طول و ارقام را بسنجید. صفحهٔ سرویس ورودی دقیق را نشان می‌دهد.

چند پرسش که پیش می‌آید

شناسهٔ قبض آب با شناسهٔ قبض برق فرق دارد؟ هر قبض شناسهٔ خودش را دارد، پس شناسهٔ یک قبض را به سرویس قبض دیگر نفرستید. هر سه قبض آب، برق و گاز سرویس جدا و استعلام جدا هستند.

مستأجر می‌تواند استعلام بگیرد؟ سرویس بررسی مالکیت نمی‌کند و هر کس شناسه را داشته باشد می‌تواند بپرسد. این یعنی مستأجر بدون مالک هم می‌تواند ببیند، ولی همین باعث می‌شود حواستان به حریم خصوصی باشد.

اگر شناسه درست است ولی نتیجه‌ای نیامد چه؟ پاسخ «رکوردی نیست» یک پاسخ معتبر است و هزینه دارد. یک بار شناسه را با قبض چک کنید و اگر همان بود، از شرکت آب و فاضلاب بپرسید.

خلاصه برای مرور بعدی

ورودی شناسه است و بس. اگر ندارید، قبض قبلی، سامانهٔ استان یا مالک ملک سه راه عملی‌اند. اگر محصول می‌سازید، فرم را با برچسب روشن و راه جایگزین بسازید و نتیجه را، چون نام و نشانی دارد، بی‌حساب جلوی همه نگذارید. شکل پاسخ و خطاها در راهنمای فنی API آمده است.

آخرین بازبینی: تیم تحریریه ملی ای‌پی‌آی

وب‌سرویس مرتبط با این راهنما

API استعلام قبض آب

مبلغ و مهلت پرداخت قبض آب.

مشاهده مشخصات فنی و تعرفه

راهنماهای مرتبط

پرسش و تجربه کاربران

اگر این راهنما جوابتان را نداد، همین‌جا بپرسید. پرسش‌ها را تیمملی ای‌پی‌آی پاسخ می‌دهد و هر نظر پیش از انتشار بررسی می‌شود.

هنوز پرسشی ثبت نشده، اولین نفر باشید.