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