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