ماذا تفعل
تسلّم هذه الإضافة طلبات الطباعة عند الطلب إلى Printful حتى لا تضطر إلى إعادة كتابتها بنفسك. فحين يدفع عميل ثمن طلب فيه عنصر مادي، تنشئ الإضافة طلبًا مطابقًا في متجرك على Printful، مستخدمةً اسم الشحن وعنوانه كما جاءا من صفحة الدفع. ويُرسل الطلب إلى الإنتاج فورًا، فيخصم Printful المبلغ من وسيلة الدفع المسجّلة في حسابك لديه. ويذهب معرّف طلبك في VeloCMS إلى Printful بصفته معرّفًا خارجيًا، فلا يُنشئ إشعار مكرر طلبًا ثانيًا. وتخبرها بربط صغير أي منتج في VeloCMS يطابق أي متغير في Printful، ولا يُرسل إلا العناصر المربوطة. وبعد ذلك تُظهر صفحة الطلب أنه أُرسل، مع معرّفه لدى Printful ووقت الإرسال.
لمن يناسب
لأصحاب المتاجر الذين يبيعون منتجات مخصصة مثل القمصان والأكواب والملصقات ولديهم منتجات جاهزة في Printful. ينبغي أن تكون مرتاحًا للبحث عن معرّف المتغير المتزامن (sync variant) في لوحة تحكم Printful ولصقه في ربط JSON قصير. وإن كنت تريد جلب المنتجات من Printful تلقائيًا، فاعلم أن هذه الإضافة لا تفعل ذلك بعد.
كيف تعمل
تلصق رمز API الخاص بك في Printful ورقم المتجر في إعدادات الإضافة، ثم تضغط «اختبار الاتصال». ويُخزَّن الرمز مشفّرًا.
في «ربط المتغيرات» تسرد معرّف كل منتج في VeloCMS (أو معرّف المتغير) بجانب معرّف المتغير المتزامن في Printful. والعناصر التي تتركها تُتجاوز ولا يُخمَّن لها ربط.
يدفع عميل طلبًا يحتوي على عنصر مادي واحد على الأقل. أما الطلبات الرقمية فقط فتُتجاوز، لأنه لا يوجد فيها شيء يُطبع.
ترسل الإضافة العناصر المربوطة وعنوان الشحن إلى Printful كطلب جديد وتؤكده للإنتاج فورًا، وهو ما يحمّل حسابك في Printful رسوم الطلب. وتعرض صفحة الطلب Printful مع معرّف الطلب لديه.
الإعدادات التي تضبطها
- تنفيذ الطلبات تلقائياً عبر Printful
- مفعّل افتراضيًا. وعند تفعيله يُرسل كل طلب مدفوع فيه عنصر مادي مربوط واحد على الأقل إلى Printful ويُؤكَّد للإنتاج، ويخصم Printful من حسابك.
- رمز API
- من لوحة Printful تحت الإعدادات ثم API ثم الوصول إلى API. يُخزَّن مشفّرًا ولا يُعرض ثانية بعد الحفظ.
- رقم المتجر
- الرقم التعريفي لمتجرك في Printful (أرقام فقط). وهو لازم لحصر استدعاءات المنتجات والطلبات في نطاق متجرك.
- ربط المتغيرات
- كائن JSON اختياري يربط معرّف منتج أو متغير في VeloCMS بمعرّف المتغير المتزامن في Printful. والعناصر غير المدرجة تُتجاوز.
- اختبار الاتصال
- يتأكد من أن Printful يقبل الرمز المحفوظ.
ما تستطيع الوصول إليه
بعد كل طلب مدفوع تقرأ الإضافة معرّف الطلب، واسم الشحن والعنوان ورقم الهاتف، وبريد العميل الإلكتروني، والعناصر التي طلبتها. ولا تقرأ تدويناتك ولا أعضاءك. وترسل هذه التفاصيل إلى api.printful.com وحده ولا تُرسلها إلى أي جهة أخرى. ويُخزَّن رمز API الخاص بك في Printful مشفّرًا، ولا يُعرض عليك مرة أخرى نصًّا صريحًا بأي حال.
الأذونات
- تسجيل حالة تنفيذ Printful على طلباتك
- قراءة بيانات الطلب بعد إتمام الشراء المدفوع
- إجراء اتصالات شبكية بـ api.printful.com
- تخزين رمز واجهة برمجة تطبيقات Printful الخاص بك بشكل مشفّر
- قراءة معرّف متجر Printful الذي اخترته
الوصول إلى الشبكة الخارجية
ترسل هذه الإضافة طلبات إلى النطاقات التالية:
api.printful.com
الإمكانات
commerce:readcommerce:writenetwork:fetchui:settingsafterOrderCreate
لقطات الشاشة

حدود نذكرها بصراحة
تُؤكَّد الطلبات عند وصولها ولا تُترك مسودّات، فلا خطوة مراجعة قبل أن يخصم Printful من حسابك. أوقف الإعداد لتتوقف عن الإرسال.
لا يوجد استيراد للمنتجات. فالإضافة لا تسحب كتالوج Printful إلى VeloCMS. تنشئ المنتجات في متجرك بنفسك ثم تربطها عبر «ربط المتغيرات».
ربط المتغيرات ملف JSON تكتبه بنفسك يدويًا بمعرّفات المتغيرات المتزامنة في Printful. والعناصر الغائبة عنه تُتجاوز. وإذا لم يُربط أي عنصر من عناصر الطلب فلا يُرسل أي شيء.
الطلب الذي عنوان الشحن فيه ناقص يُتجاوز ويُسجَّل، ولا يُرسل.
لا تُجلب أسعار الشحن ولا تتبع الشحنات من Printful. وتغييرات الحالة التي تجريها في Printful لا تُسحب إلى VeloCMS.
إذا رفض Printful الطلب أو تعذّر الوصول إليه، تتم عملية البيع رغم ذلك. ويُسجَّل الفشل ويُدوَّن في نشاط الموصّل، ولا تُعاد المحاولة تلقائيًا.
لا تُرسل إلا الطلبات التي تُقدَّم بعد الربط. أما الطلبات السابقة فلا تُرسل بأثر رجعي.
الأسئلة الشائعة
هل تستورد منتجاتي من Printful؟
لا. تنشئ المنتجات في VeloCMS وتربط كلًّا منها بمعرّف متغير متزامن في Printful. والإضافة لا ترسل إلا الطلبات إلى Printful.
ماذا يحدث للمنتجات الرقمية في السلة نفسها؟
لا يذهب إلى Printful إلا العناصر المادية المربوطة. وتُتجاهل العناصر الرقمية، ويُتجاوز كليًا أي طلب ليس فيه سوى عناصر رقمية.
هل يُنشئ الإشعار المكرر طلبًا مكررًا؟
لا. تسجّل الإضافة طلب Printful مقابل طلبك، وترسل أيضًا معرّف طلبك في VeloCMS بوصفه المعرّف الخارجي لدى Printful، وهو معرّف يعدّه Printful فريدًا.
أين أرى أن الطلب قد أُرسل؟
في صفحة تفاصيل الطلب، تحت «مزوّدو التنفيذ». تعرض الصفحة هناك Printful، ومعرّف الطلب لديه، ووقت إرساله.
إضافات ذات صلة
المواصفات
- الفئة
- commerce
- السعر
- مضمَّن
- الإصدار
- 1.0.0
- المصدر
- من الطرف الأول
تصفّح المزيد من التكاملات
57 تكامل أصلي مجاني متاح.