سرویس‌های کد پستی

دسته «کد پستی» فینوتک سه API دارد: دو سرویس که کد پستی ده‌رقمی را به آدرس رسمی تبدیل می‌کنند و یک سرویس که مرسوله پستی را با کد رهگیری دنبال می‌کند. تفاوت این دو خانواده در ورودی و در کاری است که با پاسخ می‌کنید. هر سه با توکن Client Credential فراخوانی می‌شوند.

درباره دسته کد پستی

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

خانواده دوم یک سرویس است و کار متفاوتی می‌کند: استعلام مرسولات پستی با کد رهگیری، اطلاعات ارسال یک بسته را برمی‌گرداند — نوع ارسال، مبدأ و مقصد، نام فرستنده و گیرنده، کد پستی دو طرف، وزن و جزئیات مسیر. مرز این دسته را در دو جمله می‌توان گفت: جهت حرکت همیشه از شناسه به داده است و برعکس آن وجود ندارد، یعنی از روی متن آدرس به کد پستی نمی‌رسید. همچنین این APIها آدرس را ثبت یا اصلاح نمی‌کنند، مرسوله‌ای ایجاد یا لغو نمی‌کنند و برچسب پستی صادر نمی‌کنند.

کاربردهای کسب‌وکاری کد پستی

• فروشگاه اینترنتی و مارکت‌پلیس — خریدار کد پستی را وارد می‌کند و فرم آدرس با استعلام کد پستی پر می‌شود؛ خطای تایپی و سفارش مرجوعی کمتر می‌شود.
• لجستیک و تحویل آخرین مایل — با استعلام کد پستی همراه با مختصات جغرافیایی نقطه تحویل روی نقشه می‌نشیند و خوشه‌بندی مسیر پیک ممکن می‌شود.
• پرونده مشتری در سرویس‌های مالی — آدرس اعلام‌شده در ثبت‌نام با آدرس متناظر کد پستی مقایسه و ناسازگاری‌ها پیش از تأیید پرونده دیده می‌شود.
• بیمه و خدمات در محل — تعیین اینکه نشانی مشتری داخل محدوده سرویس‌دهی هست یا نه، با مختصات دقیق انجام می‌شود.
• پشتیبانی مشتری و پیگیری سفارش — کارشناس با استعلام مرسولات پستی وضعیت بسته را می‌بیند و پاسخ مشتری را بدون ارجاع به جای دیگر می‌دهد.
• صدور اسناد و فاکتور رسمی — نشانی استانداردشده به‌جای متن آزاد در سند درج می‌شود و شکل یکسانی در همه اسناد پیدا می‌کند.

انتخاب سرویس مناسب در کد پستی

• «کد پستی را دارم و آدرس می‌خواهم» — استعلام کد پستی سبک‌ترین انتخاب است و اجزای آدرس را جدا جدا برمی‌گرداند.
• «باید نقطه را روی نقشه نشان دهم یا فاصله را حساب کنم» — استعلام کد پستی همراه با مختصات جغرافیایی را بگیرید؛ همان آدرس را با طول و عرض جغرافیایی می‌دهد.
• «کدام‌یک را پیش‌فرض محصول کنم؟» — اگر نقشه‌ای در محصول ندارید، سرویس بدون مختصات کافی است و لازم نیست داده‌ای بگیرید که استفاده نمی‌کنید.
• «کد رهگیری دارم و می‌خواهم بدانم بسته کجاست» — این پرسش به خانواده آدرس ربطی ندارد؛ پاسخش در استعلام مرسولات پستی است.
• «می‌خواهم بدانم مرسوله برای چه کسی و با چه وزنی فرستاده شده» — همین سرویس رهگیری، مشخصات فرستنده و گیرنده و وزن و جزئیات ارسال را برمی‌گرداند.

شروع کار با کد پستی

برای هر سه سرویس ابتدا کلاینت بسازید، اسکوپ سرویس موردنظر را روی آن فعال کنید و توکن بگیرید؛ مراحل در راهنمای شروع آمده است. رویکرد توکن در این دسته Client Credential است، بنابراین برای استعلام یک کد پستی یا یک کد رهگیری لازم نیست از کاربر اجازه پیامکی بگیرید.

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

سوالات متداول کد پستی

فهرست سرویس‌های کد پستی

• استعلام کد پستی — با دریافت کد پستی ۱۰ رقمی، اطلاعات مربوط به آدرس پستی برگردانده می‌شود. (مستندات فنی)
• استعلام کد پستی همراه با مختصات جغرافیایی — با وارد کردن کد پستی، استعلام آدرس و مختصات جغرافیایی (عرض و طول) برگردانده می‌شود. (مستندات فنی)
• استعلام مرسولات پستی — با وارد کردن کد رهگیری (trackingCode)، اطلاعات رهگیری بسته پستی برگردانده می‌شود. (مستندات فنی)