هوشمندسازی ارسال کالا با API پست بار

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

مزیت‌های استفاده از متد افزودن بسته پستی API پست بار

اتصال مستقیم به سامانه پست بار از طریق وب‌سرویس، مزایای متعددی برای کسب‌وکارهای آنلاین دارد. این ابزار به شما کمک می‌کند تا روی رشد بیزینس خود تمرکز کنید. 📈

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

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

توسعه‌دهندگان و مدیران فروشگاه‌ها می‌توانند در بخش‌های مختلف از این متد استفاده کنند. این قابلیت‌ها باعث انعطاف‌پذیری سیستم فروش شما می‌شود. ✨

📦 فروشگاه‌های اینترنتی: ثبت خودکار سفارش پس از پرداخت آنلاین مشتری.
📦 سیستم‌های انبارداری: ارسال مستقیم کالاها از مبدأ انبار به مقصد.
📦 اپلیکیشن‌های موبایل: ایجاد امکان ارسال بسته برای کاربران در اپلیکیشن.
📦 پنل‌های مدیریت لجستیک: مدیریت متمرکز بارهای سنگین و نیمه‌سنگین.

راهنمای فنی پیاده‌سازی متد افزودن بسته (AddProductToCartService)

برای استفاده از این متد، باید درخواست خود را به صورت POST به سرور پست بار ارسال کنید. اطلاعات اصلی شامل توکن کاربر و کلید محصول (ID) است. 🛠️

نمونه کد اجرای عملیات با AJAX

در قطعه کد زیر، نحوه فراخوانی متد برای افزودن یک محصول پستی نمایش داده شده است:

javascript

$.ajax({
    type: 'POST',
    url: 'https://postbar.ir/api/AddProductToCartService/ProductKey',
    dataType: 'json',
    contentType: "application/json; charset=utf-8",
    headers: {
        "Token": "توکن_اختصاصی_کاربر"
    },
    success: function(data) {
        console.log(data);
    }
});

نکته مهم: در آدرس URL، به جای عبارت ProductKey باید کد شناسایی محصول مورد نظر را قرار دهید. همچنین توکن دریافتی از مرحله لاگین باید در هدر درخواست جایگذاری شود.

جدول لیست محصولات و کلیدهای ورودی (Product ID)

برای هر نوع بسته پستی با وزن مشخص، یک کد شناسایی منحصر‌به‌فرد وجود دارد. از جدول زیر برای تنظیم ورودی کد خود استفاده کنید:

نام محصول (خدمات درب تا درب)	کلید محصول (Product ID)
حمل بسته ۰ تا ۱ کیلوگرم	۱۰۳۵۱
حمل بسته ۱ تا ۲ کیلوگرم	۱۰۳۵۳
حمل بسته ۲ تا ۳ کیلوگرم	۱۰۳۵۴
حمل بسته ۳ تا ۵ کیلوگرم	۱۰۰۷۸
حمل بسته ۵ تا ۱۰ کیلوگرم	۱۰۳۲۶
حمل بسته ۱۰ تا ۱۵ کیلوگرم	۱۰۳۲۳
حمل بسته ۱۵ تا ۲۰ کیلوگرم	۱۰۰۷۹
حمل بسته ۲۰ تا ۲۵ کیلوگرم	۱۰۰۸۰
حمل بسته ۲۵ تا ۳۰ کیلوگرم	۱۰۰۸۱
حمل بسته ۳۰ تا ۴۰ کیلوگرم	۱۰۳۲۴
حمل بسته ۴۰ تا ۵۰ کیلوگرم	۱۰۳۲۲

آموزش سریع ثبت‌نام در سامانه API پست بار

برای شروع کار و دریافت دسترسی‌های لازم، باید ابتدا در سامانه ثبت‌نام کنید. مراحل زیر را به ترتیب انجام دهید: 📝

✅ ابتدا به وب‌سایت اصلی پنل توسعه‌دهندگان مراجعه کنید.
✅ از طریق لینک p.api.ir وارد بخش ثبت‌نام شوید.
✅ اطلاعات هویتی و شماره تماس خود را به دقت وارد نمایید.
✅ پس از تایید حساب، مستندات فنی و توکن تست را دریافت کنید.
✅ حالا می‌توانید اولین بسته پستی خود را به صورت تستی ثبت کنید.

تحلیل پاسخ‌های سرور (Response Handling)

پس از ارسال درخواست به API، سرور یک پاسخ در قالب JSON برمی‌گرداند. شما باید این پاسخ را در کد خود مدیریت کنید. 🔍

سناریوی اول: ثبت موفق (Success)

اگر اطلاعات درست باشد، فیلد Success برابر با True خواهد بود. در این حالت، لیست خطاها (ErrorList) خالی است. این یعنی محصول با موفقیت به سبد خرید افزوده شده است.

سناریوی دوم: بروز خطا (Error)

اگر توکن منقضی شده باشد یا کد محصول اشتباه باشد، مقدار Success برابر با False می‌شود. در این شرایط، علت دقیق خطا در بخش ErrorList نمایش داده می‌شود. حتماً کدی بنویسید که این خطاها را به کاربر یا مدیر سیستم گزارش دهد.

گام بعدی

متد افزودن بسته پستی، قلب تپنده اتوماسیون لجستیک در API پست بار است. با استفاده از این متد، شما می‌توانید هزینه‌های عملیاتی را به شدت کاهش دهید. 🚀 دقت کنید که انتخاب صحیح Product ID بر اساس وزن، از بروز مغایرت در هزینه‌ها جلوگیری می‌کند.

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

راهنمای جامع متد افزودن بسته پستی API پست بار برای توسعه‌دهندگان