آموزش ارسال بسته با InPost Paczkomaty لهستان در وبیتو

راهنمای جامع اتصال به سیستم ارسال لاکر پستی و پیک این‌پست (InPost Paczkomaty) در وبیتو

شرکت این‌پست (InPost) غول بی‌رقیب لجستیک و ارسال مرسولات در لهستان و پیشگام جهانی در توسعه دستگاه‌های خودکار تحویل بسته (Paczkomaty) است. با داشتن بیش از ۲۲,۰۰۰ لاکر هوشمند ۲۴ ساعته در سرتاسر لهستان، بیش از ۸۵ درصد مردم لهستان ترجیح می‌دهند سفارش‌های اینترنتی خود را از نزدیک‌ترین لاکر پستی سر کوچه یا خیابان خود دریافت کنند تا اینکه منتظر رسیدن مامور پست در منزل بمانند.

پلاگین رسمی InPost Paczkomaty & Kurier در وبیتو، با اتصال مستقیم به ShipX API v1 شرکت این‌پست، امکاناتی شامل:

انتخاب لاکر مقصد از روی نقشه هوشمند Geowidget یا وارد کردن کد لاکر (مانند WAW01A)
محاسبه‌گر خودکار سایز بسته بر اساس دسته‌بندی سه‌گانه ابعاد (Gabaryt A, B, C)
صدور بارنامه خودکار به صورت فایل PDF معمولی یا کد ZPL برای پرینترهای حرارتی رول
و سامانه رهگیری زنده بسته‌ها را فراهم می‌آورد.

۱. دسته‌بندی سه‌گانه ابعاد مرسولات این‌پست (سیستم Gabaryt)

یکی از قوانین سخت‌گیرانه در ارسال به لاکرهای Paczkomaty، محدودیت ابعاد و حجم هر کمد است. این‌پست مرسولات را در سه سایز استاندارد طبقه‌بندی می‌کند که توسط پلاگین وبیتو به صورت خودکار از روی ابعاد محصول محاسبه می‌گردد:

سایز استاندارد (Gabaryt)	حداکثر ابعاد (ارتفاع × عرض × طول)	حداکثر وزن مجاز	مناسب برای چه کالاهایی؟	تعرفه پایه
Gabaryt A (Small)	۸ × ۳۸ × ۶۴ سانتی‌متر	۲۵ کیلوگرم	کتاب، لوازم آرایشی، زیورآلات، قاب گوشی، تیشرت و البسه نازک	۱۳.۹۹ PLN
Gabaryt B (Medium)	۱۹ × ۳۸ × ۶۴ سانتی‌متر	۲۵ کیلوگرم	کفش، لوازم الکترونیکی، البسه ضخیم، کیف‌های کوچک، لوازم خانگی کوچک	۱۶.۹۹ PLN
Gabaryt C (Large)	۴۱ × ۳۸ × ۶۴ سانتی‌متر	۲۵ کیلوگرم	کاپشن، پتو، جاروبرقی، لوازم بزرگ، بسته‌های چند محصولی حجیم	۱۹.۹۹ PLN

مورد مهم

قانون محدودیت وزن: حداکثر وزن فیزیکی مجاز برای هر بسته تحویلی به لاکرهای Paczkomaty دقیقاً ۲۵ کیلوگرم است. مرسولات با وزن بالاتر از ۲۵ کیلوگرم باید توسط سرویس پیک مستقیم (InPost Kurier Standard) ارسال شوند.

۲. مدارک و تنظیمات اتصال به InPost ShipX API

برای فعال‌سازی پلاگین در فروشگاه وبیتو:

در پرتال پذیرندگان این‌پست بخش مدیر بسته (InPost Parcel Manager به آدرس manager.paczkomaty.pl) ثبت نام کرده و قرارداد تجاری منعقد کنید.
از تب API، شناسه سازمان (organization_id) و توکن احراز هویت اختصاصی (API Token) را استخراج کنید.

تنظیمات پلاگین در وبیتو:

عنوان فیلد	کلید فنی	الزامی؟	توضیحات	نمونه مقدار
شناسه سازمان (Organization ID)	`organizationId`	بله	کد کاربری سازمان در سامانه ShipX	`778899`
توکن دسترسی (API Token)	`apiToken`	بله	توکن اعتبارسنجی Bearer جهت امضای درخواست‌ها	`shipx_token_live_abc123`
لاکر مبدا پیش‌فرض	`defaultDispatchPoint`	خیر	کد لاکری که بسته‌ها توسط فروشگاه در آن قرار می‌گیرد	`KRA010`
سایز پیش‌فرض گاباریت	`defaultTemplate`	خیر	سایز پیش‌فرض برای کالاهایی که ابعاد ثبت نشده دارند	`small / medium / large`
فرمت لیبل بارنامه	`labelFormat`	خیر	فرمت خروجی بارنامه: `pdf` (کاغذ معمولی) یا `zpl` (پرینتر حرارتی رول)	`pdf`
حالت سندباکس	`sandbox`	خیر	هدایت درخواست‌ها به `sandbox-api-shipx-pl.easypack24.net`	`true / false`

۳. دیاگرام چرخه حیات ارسال مرسوله با InPost

mermaid
sequenceDiagram
    autonumber
    actor Customer as خریدار
    participant Webito as فروشگاه وبیتو
    participant Plugin as پلاگین InPost
    participant ShipX as سرور InPost ShipX
    participant Locker as لاکر Paczkomat

    Customer->>Webito: انتخاب لاکر مقصد (مثال: WAW01A) و تکمیل خرید
    Webito->>Plugin: فراخوانی dispatch با ابعاد و مشخصات
    Plugin->>ShipX: POST /v1/organizations/{org_id}/shipments
    ShipX-->>Plugin: صدور شناسه مرسوله و بارنامه (AWB)
    Webito->>Webito: پرینت لیبل بارنامه و الصاق روی کارتن بسته
    Webito->>Locker: قرار دادن بسته در لاکر مبدا (Drop-off)
    ShipX->>Plugin: آپدیت وضعیت: dispatched_by_sender
    Locker->>Customer: پیامک و پوش‌نوتیفیکیشن: «بسته در لاکر WAW01A آماده تحویل است با کد بازگشایی»
    Customer->>Locker: اسکن QR Code و دریافت بسته از درب لاکر
    ShipX->>Plugin: آپدیت نهایی: delivered

۴. جدول کدهای وضعیت رهگیری و رفع خطاها

وضعیت رهگیری (ShipX Status)	وضعیت در وبیتو	معنی و اقدام
`created`	`pending`	محموله ثبت شد؛ منتظر تحویل به مامور یا لاکر مبدا.
`dispatched_by_sender`	`pending`	بسته توسط فروشنده در لاکر مبدا گذاشته شد.
`taken_by_courier`	`in_transit`	مامور این‌پست بسته را برای انتقال به هاب جمع‌آوری کرد.
`ready_for_pickup`	`in_transit`	بسته در لاکر مقصد قرار گرفت و منتظر تحویل به خریدار است.
`delivered`	`delivered`	خریدار بسته را دریافت و درب لاکر بسته شد. سفارش تکمیل است.
`returned_to_sender`	`returned`	خریدار ظرف ۴۸ ساعت بسته را تحویل نگرفت و مرجوع شد.

مقالات مرتبط

دسته‌بندی‌های راهنما

راهنمای جامع اتصال به سیستم ارسال لاکر پستی و پیک این‌پست (InPost Paczkomaty) در وبیتو

راهنمای جامع اتصال به سیستم ارسال لاکر پستی و پیک این‌پست (InPost Paczkomaty) در وبیتو

۱. دسته‌بندی سه‌گانه ابعاد مرسولات این‌پست (سیستم Gabaryt)

مورد مهم

۲. مدارک و تنظیمات اتصال به InPost ShipX API

تنظیمات پلاگین در وبیتو:

۳. دیاگرام چرخه حیات ارسال مرسوله با InPost

۴. جدول کدهای وضعیت رهگیری و رفع خطاها