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