كيف أربط Shippo لإنشاء الشحنات وشراء ملصقات الشحن تلقائيًا؟
ألصق رمز API الخاص بـ Shippo في VeloCMS، فيُنشئ كل طلب لمنتج مادي طلبًا في Shippo — ثم اشترِ أرخص ملصق شحن من شاشة الطلب.
يرسل موصل Shippo كل طلب لمنتج مادي إلى Shippo فور تقديمه، ثم يتيح لك شراء أرخص ملصق شحن متاح مباشرة من شاشة الطلب — ويُحفظ رابط الملصق ورقم التتبع في الطلب نيابةً عنك. وهو بديل مجاني عن إعادة إدخال كل طلب في لوحة تحكم Shippo.
تثبيت الإضافة وقائمة استكشاف الأخطاء العامة واحدة في كل التكاملات ومشروحة مرة واحدة في الدليل المشترك للتكاملات. وبقية هذه الصفحة خاصة بـ Shippo.
الخطوة 1 — احصل على رمز API الخاص بـ Shippo
في Shippo اذهب إلى Settings ← API وانسخ رمز API.
الخطوة 2 — املأ لوحة Shippo
افتح «لوحة التحكم ← الإضافات ← Shippo»، والصق رمز API، وفعّل «تفعيل Shippo». يبدأ المفتاح مُعطَّلًا، فلا يُرسَل شيء حتى تشغّله. ثم املأ «عنوان الشحن مِن»: الاسم أو اسم المتجر، وعنوان الشارع، والمدينة، والولاية أو المنطقة، والرمز البريدي، ورمز الدولة من حرفين. الشارع والمدينة والرمز البريدي والدولة مطلوبة؛ فـ Shippo يحتاج عنوان منشأ في كل طلب. اضغط «حفظ الإعدادات»، ثم «اختبار الاتصال» الذي يقرأ مرة واحدة من طلبات Shippo ولا ينشئ شيئًا.
ماذا يحدث بعد الطلب
- لا تُرسَل إلا الطلبات التي فيها منتج مادي واحد على الأقل. وتُتخطّى الطلبات الرقمية فقط لأنه لا شيء يُشحن.
- ينشئ VeloCMS طلبًا (Order) في Shippo، لا شحنة بعد. يحمل رقم الطلب في VeloCMS رقمًا للطلب، والحالة Paid، ووقت تقديمه، واسم المشتري وعنوانه وهاتفه وبريده، وكل بند بعنوانه ورمز SKU وكميته وسعره الإجمالي بالدولار الأمريكي.
- الطلب الذي لا يحمل عنوان شحن كاملًا، أو لم يُحفظ له عنوان منشأ، يُتخطّى ويُسجَّل في السجلات. ولا يُشترى شيء في هذه المرحلة؛ فـ Shippo يحتفظ بالطلب مسجّلًا فحسب.
- تُتجاهَل إعادات الإرسال، فلا يُنشأ مرتين طلبٌ أُرسل من قبل.
الخطوة 3 — اشترِ ملصقًا من شاشة الطلب
افتح الطلب في «لوحة التحكم ← الطلبات» واستخدم بطاقة «بطاقات الشحن». عندما لا يوجد ملصق بعد يظهر زر «شراء بطاقة شحن Shippo». ينشئ VeloCMS شحنة من عنوان المنشأ المحفوظ إلى عنوان شحن الطلب، ويأخذ أرخص سعر يعيده Shippo، ويشتريه، ثم يحفظ رابط الملصق ورقم التتبع والناقل في الطلب. بعدها تعرض البطاقة رابط «تحميل بطاقة الشحن» مع رقم التتبع والناقل. وإذا لم يكن للطلب رقم تتبع من قبل، يُنسخ الرقم الجديد إليه أيضًا.
يقيّم VeloCMS كل ملصق لطرد افتراضي ثابت مقاسه 10 × 8 × 6 بوصات ووزنه 1 رطل، لا لمحتويات الطلب الفعلية. وللطرود الأثقل أو الأكبر اشترِ الملصق من لوحة تحكم Shippo حيث تدخل الأبعاد الحقيقية.
شراء الملصق ينفق مالًا حقيقيًا، لأن Shippo يحاسبك على الملصق الذي يشتريه. ومن الرسائل الشائعة على البطاقة: أن الطلبات الرقمية فقط لا تحتاج إلى ملصقات شحن، وأنه لا تتوفر أسعار شحن حين لا يعيد Shippo شيئًا لذلك المسار، وتنبيه بأن عنوان شحن الطلب ناقص. استخدم مزوّد ملصقات واحدًا في كل مرة: إذا كان Shippo وShipStation كلاهما مثبّتًا ومفعّلًا فإن شراء الملصق يمرّ عبر Shippo.
عندما يفشل شيء
إذا تعذّر الوصول إلى Shippo مؤقتًا أو كان رمز API خاطئًا، يفشل إرسال الطلب بصمت في الخلفية ولا يعطّل الطلب نفسه أبدًا. ويظهر الفشل مقرونًا بالطلب في «التكاملات ← نشاط المزامنة». ليس لـ Shippo زر إعادة المحاولة هناك؛ ومتى عمل الرمز من جديد يمكنك مع ذلك شراء ملصق يدويًا من الطلب.
قطع الاتصال
أوقف «تفعيل Shippo» أو امسح رمز API في نفس اللوحة لإيقاف إنشاء الطلبات. تبقى الملصقات المُشتراة وأرقام التتبع الخاصة بها على طلباتها؛ ولن تُنشأ أي طلبات جديدة بعد قطع الاتصال.