بخش ایجنت ام سی پی به استور فرانت اضافه شداطلاعات بیشتر ←

راهنمای جامع اتصال و ارسال مرسولات با شرکت تیپاکس در وبیتو

۲۹ شهریور ۱۴۰۵


راهنمای جامع اتصال و ارسال مرسولات با شرکت تیپاکس (Tipax) در وبیتو

شرکت تیپاکس (Tipax) به عنوان نخستین و بزرگ‌ترین شرکت پست خصوصی در ایران با بیش از ۶۰ سال تجربه، شبکه گسترده‌ای با بیش از ۱۰۰۰ نمایندگی اختصاصی در سرتاسر کشور دارد. برای فروشگاه‌های اینترنتی که کالاهای فیزیکی (پوشاک، قطعات الکترونیکی، لوازم آرایشی، کتاب، اکسسوری و لوازم خانگی) را به مقاصد بین‌شهری ارسال می‌کنند، تیپاکس انتخاب اول است.

پلاگین رسمی تیپاکس در وبیتو، فرآیند اتصال به وب‌سرویس ای‌تیپاکس (e-Tipax V3/V4) را به‌صورت بی‌درنگ برقرار ساخته و تمام مراحل محاسبه هزینه بر اساس وزن و بیمه، صدور بارنامه حرارتی و دریافت بارکد پیگیری مرسوله را خودکار می‌نماید.


۱. مزایای رقابتی تیپاکس برای فروشگاه‌های وبیتو

  • ارسال سریع ۲۴ تا ۴۸ ساعته: انتقال هوایی و زمینی به تمام استان‌ها و شهرهای ایران.
  • تولید خودکار لیبل و بارنامه چاپی: بدون نیاز به پر کردن دستی فرم‌های بارنامه، بارنامه رسمی با کد بارکد استاندارد از پنل وبیتو صادر و چاپ می‌شود.
  • محاسبه هوشمند حق بیمه بر اساس ارزش کالا: جبران خسارت قطعی کالا تا سقف ارزش اظهارشده در صورت بروز حادثه در حین حمل.
  • جمع‌آوری بسته از محل فروشگاه (Pick-up): تحویل بسته‌ها از درب انبار یا فروشگاه شما توسط تیپاکس‌یار بدون نیاز به مراجعه حضوری به نمایندگی.
  • رهگیری خودکار چندمرحله‌ای: مطلع‌سازی مشتری از وضعیت سیر بسته (تحویل به نمایندگی مبدا، هاب مرکزی، نمایندگی مقصد، تحویل به توزیع‌کننده و تحویل به مشتری).

۲. فرمول رسمی محاسبه تعرفه کرایه و بیمه در تیپاکس

تعرفه حمل تیپاکس از یک فرمول استاندارد چندمتغیره پیروی می‌کند که پلاگین وبیتو آن را در متد calculateTariffTomans بدون خطا پیاده‌سازی کرده است:

$$\text{کرایه کل} = \left( \text{نرخ پایه پلکان وزنی} + \text{کرایه کیلوگرم مازاد} + \text{حق بیمه کالا} \right) \times 1.10\ (\text{۱۰٪ مالیات بر ارزش افزوده})$$

پلکان وزنی کالانرخ پایه پیش‌فرض (تومان)حق بیمه کالا (ارزش اظهارشده)مالیات بر ارزش افزوده
تا ۱ کیلوگرم۵۸,۰۰۰ تومان۲ در هزار (۰.۲٪ ارزش فاکتور)۱۰٪ مجموع کرایه و بیمه
۱ تا ۳ کیلوگرم۷۸,۰۰۰ تومان۲ در هزار (۰.۲٪ ارزش فاکتور)۱۰٪ مجموع کرایه و بیمه
۳ تا ۵ کیلوگرم۹۸,۰۰۰ تومان۲ در هزار (۰.۲٪ ارزش فاکتور)۱۰٪ مجموع کرایه و بیمه
بیش از ۵ کیلوگرم۹۸,۰۰۰ + ۱۸,۰۰۰ به ازای هر کیلو اضافه۲ در هزار (۰.۲٪ ارزش فاکتور)۱۰٪ مجموع کرایه و بیمه
مثال محاسبه واقعی:

برای بسته‌ای به وزن ۲ کیلوگرم و ارزش کالای ۱,۰۰۰,۰۰۰ تومان:

  • کرایه پایه (۱ تا ۳ کیلو): ۷۸,۰۰۰ تومان
  • حق بیمه ($1,000,000 \times 0.002$): ۲,۰۰۰ تومان
  • جمع قبل از مالیات: ۸۰,۰۰۰ تومان
  • ۱۰٪ ارزش افزوده: ۸,۰۰۰ تومان
  • مبلغ نهایی پرداختنی توسط مشتری: ۸۸,۰۰۰ تومان

۳. مدارک و تنظیمات وب‌سرویس ای‌تیپاکس

برای دریافت وب‌سرویس، وارد پرتال ای‌تیپاکس شوید یا در سامانه تست omtest.tipax.ir ثبت‌نام کنید:

نام پارامترعنوان در ای‌تیپاکستوضیحاتنمونه مقدار
API Keyکلید دسترسی وب‌سرویسکلید اختصاصی مندرج در پروفایل ای‌تیپاکس بخش تنظیمات APItpx_live_apikey_998811
Contract Codeکد قراردادشماره قرارداد سازمانی فروشگاه با تیپاکسTPX_CTR_44321
Origin Cityشهر مبدانام انگلیسی یا فارسی شهر انبار اصلی فروشگاهTehran / تهران
Fallback Base Feeکرایه پایه جایگزینکرایه پیش‌فرض در شرایط قطعی وب‌سرویس تیپاکس (تومان)65000
Service Typeنوع خدمتسرویس زمینی معمولی یا هوایی سریعGROUND یا EXPRESS
Sandbox Modeمحیط تستیاتصال به سرور شبیه‌ساز تست تیپاکسtrue / false

۴. مراحل گام‌به‌گام صدور بارنامه و ارسال در وبیتو

  1. پس از تکمیل و ثبت سفارش توسط مشتری در فروشگاه وبیتو، سفارش در وضعیت «در حال آماده‌سازی» قرار می‌گیرد.
  2. با کلیک بر روی گزینه ایجاد مرسوله با تیپاکس، وبیتو متد dispatch را فراخوانی می‌کند.
  3. مشخصات گیرنده، کدپستی ۱۰ رقمی، شماره تماس و وزن اقلام به ای‌تیپاکس ارسال شده و کد بارنامه رسمی (Consignment Number) به همراه بارکد ۱۲ رقمی صادر می‌شود.
  4. فایل PDF بارنامه را پرینت گرفته و روی کارتن مرسوله الصاق کنید.
  5. تیپاکس‌یار بسته را تحویل گرفته و کد رهگیری به‌صورت خودکار از طریق پیامک برای مشتری ارسال می‌گردد.

۵. جدول عیب‌یابی و کدهای خطای وب‌سرویس تیپاکس

کد خطامتن پیام خطادلیل بروزراهکار رفع مشکل
401Invalid API Key / Unauthorizedکلید دسترسی اشتباه است یا منقضی شدهکلید را در پنل ای‌تیپاکس مجدداً Generate کرده و در وبیتو ذخیره کنید.
400Invalid Postal Codeکدپستی خریدار نامعتبر یا کمتر از ۱۰ رقم استآدرس مشتری را اصلاح کرده و کدپستی ۱۰ رقمی معتبر ثبت نمایید.
422Destination City Not Coveredشهر یا روستای مقصد تحت پوشش تیپاکس نیستبسته باید از طریق پست پیشتاز یا نزدیک‌ترین نمایندگی شهری تیپاکس ارسال شود.
500Service Temporarily Unavailableقطعی موقت سرور مرکزی تیپاکسوبیتو به صورت خودکار از نرخ پایه جایگزین استفاده کرده و سفارش معلق نمی‌ماند.

۶. پرسش‌های متداول (FAQ)

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

س: بسته‌ها پس از چند ساعت توسط تیپاکس تحویل مشتری می‌شوند؟
ج: برای شهرهای همجوار و استان‌های نزدیک ظرف ۲۴ ساعت و برای مسافت‌های دورتر بین ۴۸ تا حداکثر ۷۲ ساعت کاری تحویل داده می‌شوند.