ماذا تفعل
تنقل إضافة ShipStation الطلبات المادية من متجرك إلى حسابك في ShipStation، فتتوقف عن إدخالها يدويًا. وحين يدفع عميل ثمن طلب يحتوي على منتج مادي واحد على الأقل، تنشئ الإضافة طلبًا في ShipStation يحمل معرّف طلب VeloCMS رقمًا للطلب، وتاريخ الطلب، والحالة التي اخترتها («Awaiting Shipment» ما لم تغيّرها)، واسم المشتري وعنوانه وهاتفه، وكل بند باسمه ورمز SKU وكميته وسعر الوحدة. أما الطلبات الرقمية فقط فتُتجاوز. وإعادة إرسال الطلب نفسه تحدّثه ولا تضيف طلبًا ثانيًا. ويمكنك أيضًا شراء بطاقة شحن من صفحة الطلب، باستخدام رموز شركة الشحن والخدمة والطرد التي حفظتها.
لمن يناسب
أصحاب المتاجر الذين يديرون شحنهم أصلًا من ShipStation ويريدون وصول الطلبات المدفوعة إليه دون نسخها. وتناسب المتاجر التي تشحن دائمًا بشركة الشحن والخدمة نفسيهما، لأن زر البطاقة يستخدم مجموعة واحدة من الرموز المحفوظة ولا يقارن الأسعار. وإن كنت تحتاج إلى مقارنة الأسعار أو إلى أحجام طرود خاصة بكل شحنة، فأنجز طباعة البطاقات داخل ShipStation واستخدم هذه الإضافة لإدخال الطلبات فقط.
كيف تعمل
في ShipStation، أنشئ مفتاح API وكلمة سرّ (secret) من Settings ثم Account ثم API Settings. وفي VeloCMS، افتح إضافة ShipStation والصق كليهما، وفعّل مزامنة الطلبات ثم احفظ. يُخزَّن الاثنان مشفّرين.
اضغط «Test Connection». ينشئ هذا طلبًا حقيقيًا في ShipStation رقمه velocms-connection-test ويوضع قيد الانتظار (on hold). وضغطه مرة أخرى يحدّث الطلب نفسه. احذفه من ShipStation بعد ذلك.
حين يدفع عميل ثمن طلب فيه منتج مادي واسم شحن وعنوان، ينشئ VeloCMS الطلب في ShipStation في الخلفية.
لشراء بطاقة، املأ إعدادات البطاقة الافتراضية (Label defaults) وعنوان الشحن، ثم افتح الطلب واضغط زر بطاقة ShipStation. يشتري VeloCMS بطاقة برموزك المحفوظة ويحفظ رقم التتبع وشركة الشحن في الطلب.
الإعدادات التي تضبطها
- مفتاح API (API Key)
- تجده في ShipStation ضمن Settings ثم Account ثم API Settings. يُخزَّن مشفّرًا ولا يُعرض لك مرة أخرى بعد الحفظ.
- كلمة سرّ API (API Secret)
- تجدها بجوار مفتاح API في المكان نفسه. تُخزَّن مشفّرة ولا تُعرض لك مرة أخرى بعد الحفظ.
- حالة الطلب الافتراضية (Default order status)
- حالة ShipStation التي تُعطى لكل طلب يُرسل. وتعود إلى awaiting_shipment إذا تُركت فارغة.
- إرسال الطلبات المادية إلى ShipStation
- يبدأ معطّلًا. وما دام معطّلًا لا يُرسل شيء، حتى لو كان المفتاح وكلمة السرّ محفوظين.
- إعدادات البطاقة الافتراضية (Label defaults)
- رمز شركة الشحن ورمز الخدمة ورمز الطرد، مثل fedex وfedex_ground وpackage. ويتوقف شراء البطاقة بخطأ إذا كان أي من الثلاثة فارغًا.
- عنوان الشحن (Ship-from address)
- الاسم أو النشاط، والشارع، والمدينة، والولاية، والرمز البريدي، والدولة. وهو عنوان المنشأ المطبوع على كل بطاقة تشتريها.
ما تستطيع الوصول إليه
بعد كل طلب مدفوع، تقرأ الإضافة معرّف الطلب وتاريخه واسم الشحن والعنوان والهاتف والمنتجات المشتراة. وترسل هذه البيانات إلى ssapi.shipstation.com وحده، ولا ترسلها إلى أي جهة أخرى. ولا تقرأ تدويناتك ولا أعضاءك. يُخزَّن مفتاح API وكلمة السرّ في ShipStation مشفّرين ولا يُعرضان نصًا صريحًا أبدًا. وشراء البطاقة ينفق مالًا من حسابك في ShipStation.
الأذونات
- قراءة عنوان الشحن وبنود الطلب بعد الشراء
- إجراء اتصالات شبكية بـ ssapi.shipstation.com
- تخزين مفتاح ورمز واجهة برمجة تطبيقات ShipStation الخاصين بك بشكل مشفّر
- تخزين شركة الشحن والخدمة ورموز الطرود الافتراضية الخاصة بك إضافةً إلى عنوان الشحن المصدر
- شراء ملصق شحن (بأرخص سعر متاح) وحفظ رابط الملصق ورقم التتبع في الطلب عند الضغط على شراء الملصق
الوصول إلى الشبكة الخارجية
ترسل هذه الإضافة طلبات إلى النطاقات التالية:
ssapi.shipstation.com
الإمكانات
commerce:readnetwork:fetchui:settingsorder:afterCreate
لقطات الشاشة

حدود نذكرها بصراحة
لا يقارن زر البطاقة الأسعار. فهو يشتري بالضبط شركة الشحن والخدمة والطرد التي حفظتها، لطرد وزنه رطل واحد (1 lb) بتاريخ اليوم. وبطاقة لخدمة لا تناسب الطرد تبقى مع ذلك عملية شراء.
شراء البطاقة عملية شراء حقيقية تُفوتَر عبر ShipStation، ولا تطلب الإضافة أي تأكيد إضافي بعد ضغط الزر.
تُشترى البطاقة بمعزل عن غيرها. ولا يحدّث VeloCMS الطلب المصطف في ShipStation بعد ذلك.
الطلب الذي لا يحمل اسم شحن أو عنوانًا يُتجاوز ويُسجَّل، وكذلك الطلب الرقمي فقط.
إن تعذّر الوصول إلى ShipStation أو رفض الطلب، تتم عملية البيع رغم ذلك. ويُسجَّل الفشل في نشاط الموصّل ولا تُعاد المحاولة تلقائيًا. أنشئ ذلك الطلب في ShipStation يدويًا بعد أن يعمل المفتاح.
الاتجاه واحد فقط. تغييرات الحالة التي تجريها في ShipStation لا تعود إلى VeloCMS.
الأسئلة الشائعة
هل أحتاج إلى حساب في ShipStation؟
نعم. تستخدم الإضافة حسابك الخاص في ShipStation عبر مفتاح API وكلمة سرّ تلصقهما بنفسك. وتسري خطط ShipStation وتكاليف بطاقاتها، وتحاسبك عليها ShipStation.
هل سيُرسل الطلب نفسه مرتين؟
لا. يتذكر VeloCMS الطلب الذي أرسله من قبل، وتحدّث ShipStation الطلب الذي يحمل المعرّف نفسه بدل أن تضيف طلبًا آخر.
لماذا ترك اختبار الاتصال طلبًا في ShipStation؟
لأن ShipStation لا تقدّم أمر فحص بسيطًا، ينشئ الاختبار طلبًا صغيرًا قيد الانتظار. وتكرار الاختبار يحدّث الطلب نفسه. ويمكنك حذفه.
هل تستطيع الإضافة اختيار أرخص شركة شحن؟
لا. تستخدم الإضافة رموز شركة الشحن والخدمة والطرد التي حفظتها ولا تقارن الأسعار. استخدم ShipStation نفسها إن أردت مقارنة الأسعار.
إضافات ذات صلة
المواصفات
- الفئة
- commerce
- السعر
- مضمَّن
- الإصدار
- 1.1.0
- المصدر
- من الطرف الأول
تصفّح المزيد من التكاملات
57 تكامل أصلي مجاني متاح.