API رهگیری مرسوله پستی
با کد رهگیری مرسوله، نوع ارسال، مبدأ و مقصد، فرستنده و گیرنده، وزن و هزینهٔ ارسال و همهٔ رویدادهای مسیر را برمی‌گرداند.
این سرویس چه میکند
رهگیری مرسوله پستی دو بخش پاسخ دارد: مشخصات مرسوله و رویدادهای مسیر. بخش اول نوع ارسال، مبدأ، دفتر پست مبدأ، مقصد، نام فرستنده و گیرنده، کد پستی مبدأ و مقصد، وزن و هزینهٔ ارسال است؛ بخش دوم tracking_events، که هر ردیفش تاریخ، ساعت، رویداد و محل را دارد. ورودی فقط trackingCode است، همان کدی که روی رسید ادارهٔ پست آمده.
برای فروشگاه اینترنتی، این استعلام جای پیام «بسته‌ام کجاست» را در صندوق پشتیبانی میگیرد. وضعیت را در صفحهٔ سفارش نشان دهید تا مشتری پیش از پرسیدن، جواب را دیده باشد.
آنچه این استعلام نمی‌کند
زمان رسیدن را پیش‌بینی نمی‌کند و تاریخ تحویلی وعده نمی‌دهد؛ فقط آنچه تا این لحظه ثبت شده را نشان میدهد. شکایت، درخواست خسارت یا تغییر نشانی هم از این مسیر ثبت نمیشود. مرسوله‌های شرکتهای پست خصوصی پوشش داده نمی‌شوند و کد رهگیری آن‌ها اینجا نتیجه‌ای نمی‌دهد.
نکته پیاده‌سازی
ترتیب tracking_events را فرض نگیرید. پیش از نمایش، ردیف‌ها را با event_date و event_time مرتب کنید تا آخرین رویداد بالای فهرست باشد؛ همان سطری که مشتری دنبالش است.
weight و postage رشته‌اند و همان‌طور که ثبت شده‌اند می‌آیند. برای نمایش نگهشان دارید و محاسبهٔ هزینه یا وزن در سامانهٔ خودتان را به آن‌ها نسپارید.
هر فراخوان یک استعلام جداست. اگر وضعیت چند سفارش را دورهای پایش می‌کنید، فاصله را با منطق کسب‌وکارتان تنظیم کنید و مرسولهٔ تحویلشده را از فهرست پایش بیرون بگذارید.
کجا به کار می‌آید
- وضعیت ارسال در صفحهٔ سفارشآخرین رویداد مسیر کنار هر سفارش نشان داده میشود و مشتری لازم نیست کد رهگیری را جای دیگری وارد کند.
- پاسخ خودکار در پشتیبانیربات یا کارشناس پشتیبانی با شمارهٔ سفارش، مسیر مرسوله را همان‌جا می‌بیند و بی ارجاع به ادارهٔ پست جواب میدهد.
- تأیید تحویل پیش از تسویه با فروشندهبازارگاهی که پس از تحویل با فروشنده تسویه میکند، رویداد تحویل را از مسیر مرسوله می‌خواند، نه از ادعای فروشنده.
ورودی و خروجی
ورودی
trackingCodestringکد رهگیری مرسولهده تا سی رقم، همان که روی رسید پست آمده.قیمت و شرط پرداخت
هر فراخوان ۲٬۶۰۰ تومان
آخرین تغییر قیمت:
مبلغ پیش از تماس با سرویس مرجع از موجودی پنل قفل میشود و اگر پاسخی نیاید، آزاد میشود. ورودی نامعتبر، در دسترس نبودن سرویس مرجع و عبور از سقف نرخ هزینه‌ای ندارند. «رکوردی یافت نشد» یک پاسخ معتبر است و هزینه دارد.
کمترین مبلغ شارژ پنل: ۱٬۰۰۰٬۰۰۰ تومان
- ثبت‌نام در احرازینو و ساخت حساب کسب‌وکار رایگان است و همهٔ مبلغ شارژ صرف استعلام‌های خودتان میشود.
- استعلام زیادی دارید؟ برای تخفیف و تعرفهٔ اختصاصی با پشتیبانی در تماس باشید.
- می‌خواهید پیش از شارژ آزمایش کنید؟ درخواست شارژ آزمایشی ثبت کنید تا برایتان اضافه کنیم.
پرسش‌های متداول
زمان رسیدن مرسوله را میگوید؟
نه. فقط رویدادهایی را که تا این لحظه ثبت شده نشان میدهد و پیشبینیای از زمان تحویل ندارد.
مرسولهٔ شرکتهای پست خصوصی را هم رهگیری میکند؟
نه. فقط مرسولههایی که کد رهگیریشان را ادارهٔ پست داده است.
هر بار پیگیری یک استعلام جداست؟
بله. هر فراخوان جدا حساب میشود؛ مرسولهٔ تحویلشده را از پایش دورهای کنار بگذارید.
کد رهگیری اشتباه هزینه دارد؟
کدی که اعتبارسنجی را رد کند به سامانهٔ مرجع نمیرسد و مبلغی کسر نمیشود. کدی که شکلش درست است ولی مرسولهای با آن ثبت نیست، پاسخ «یافت نشد» میگیرد که یک نتیجه است و هزینه دارد.