Gelato

ماذا تفعل

تعمل إضافة Gelato انطلاقًا من جدول مطابقة تكتبه أنت بنفسك. يربط كل سطر فيه معرّف منتج من VeloCMS بمعرّف متغيّر منتج في Gelato. وبعد أن يُكمل المشتري الدفع، تفحص الإضافة كل عنصر في الطلب، وتستبعد أي عنصر رقمي أو ترخيص، وتُبقي العناصر التي تجدها في ذلك الجدول. وتُرسَل هذه العناصر بكمياتها، مع اسم المشتري وعنوان الشحن والبريد الإلكتروني والهاتف، إلى واجهة طلبات Gelato الخاصة بمعرّف المتجر الذي أدخلته. ويُرفق معرّف طلبك في VeloCMS بالطلب بوصفه مرجع الطلب في Gelato، ويُحفَظ معرّف طلب Gelato الذي يعود في الرد مع طلبك. ويخرج الطلب كطلب عادي في اللحظة التي يتأكد فيها الدفع. وليس لدى VeloCMS خطوة تعليق أو موافقة خاصة بها.

لمن يناسب

للمتاجر التي تصمّم منتجاتها داخل Gelato أصلًا، مثل الملصقات والأكواب والملابس والفن الجداري، وتريد أن تصل الطلبات المدفوعة إلى Gelato دون أن تنسخها بيدها. ستحتاج إلى الوصول إلى لوحة Gelato كي تجلب مفتاح API ومعرّف متجرك من نوع UUID ومعرّفات متغيّرات المنتجات. وتوقّع إعدادًا لمرة واحدة بصيغة JSON. أما من يأمل تصفح منتجات Gelato واستيرادها من داخل VeloCMS فلن يجد ذلك هنا.

كيف تعمل

1. 01

   أنشئ مفتاح API في لوحة Gelato، ثم انسخ UUID الخاص بمتجر Gelato الذي تعيش فيه منتجاتك.

2. 02

   أدخل القيمتين في الإضافة، وفعّل «تنفيذ الطلبات تلقائيًا عبر جيلاتو»، واملأ «تخطيط المتغيرات» بأزواج، مثل معرّف منتجك ومعرّف متغيّر منتج Gelato المقابل له. احفظ مرة واحدة؛ فليس هناك اختبار اتصال منفصل.

3. 03

   يدفع مشترٍ ثمن طلب. تشغّل VeloCMS الإضافة، فتتوقف مبكرًا إن لم يحتوِ الطلب على شيء مادي، أو كان المفتاح أو معرّف المتجر ناقصًا، أو كان الطلب مُعلَّمًا أصلًا بأنه أُرسل إلى Gelato، أو كان عنوان الشحن ناقصًا، أو لم يوجد أي عنصر في جدولك.

4. 04

   وفيما عدا ذلك، ترسل الإضافة بنود الطلب المطابقة مع تفاصيل التسليم إلى Gelato، ومعرّف طلبك في VeloCMS هو مرجع الطلب.

5. 05

   عند النجاح يُخزَّن معرّف طلب Gelato والوقت في طلبك، ويظهران تحت «مزوّدو التنفيذ» في صفحة الطلب. وكل طلب يُرسَل إلى Gelato، مقبولًا كان أو مرفوضًا، يُسجَّل أيضًا في صفحة «نشاط المزامنة».

الإعدادات التي تضبطها

تنفيذ الطلبات تلقائيًا عبر جيلاتو

هو مفتاح التبديل الرئيسي. إيقافه مع الحفظ يعطّل الإضافة أيضًا، فتتوقف الطلبات المدفوعة عن الذهاب إلى Gelato.

مفتاح API

يُنشأ في Gelato ضمن Settings ثم API ثم API Keys. ويُرسَل إلى Gelato في الترويسة X-API-KEY. وبعد الحفظ يعرض الحقل نصًا نائبًا بدلًا من المفتاح.

معرّف المتجر

هو UUID الخاص بمتجرك على Gelato، ويُكتب يدويًا. وبدونه لا يُرسَل شيء، لأن كل طلب يسمّي هذا المتجر.

تخطيط المتغيرات

كائن JSON مفاتيحه معرّفات منتجات VeloCMS وقيمه معرّفات متغيّرات منتجات Gelato، وكلاهما نص. يفشل الحفظ إذا كان JSON معطوبًا أو لم يكن كائنًا.

ما تستطيع الوصول إليه

لا تنظر الإضافة في الطلب إلا عند دفعه: معرّف الطلب، والعناصر والكميات، وأنواع المنتجات، وبريد المشتري، واسم المستلم وعنوان شارعه ورقم هاتفه. ولا تمس المقالات ولا الصفحات ولا قائمة أعضائك أبدًا. والمضيف الخارجي الوحيد الذي تتصل به هو api.gelato.com. ويُحفظ مفتاح API مشفّرًا في إعدادات الإضافة، بينما يبقى معرّف المتجر وجدول المتغيّرات نصًّا عاديًا لأن أيًّا منهما ليس سرًّا.

حدود نذكرها بصراحة

• اربط بمعرّف المنتج. يقبل الجدول مفاتيح من نوع معرّف المتغيّر، لكن بيانات الطلب المسلَّمة إلى الإضافة اليوم تحمل معرّفات المنتجات فقط، ولذلك لا يُطابَق مفتاح كُتب على أنه معرّف متغيّر في VeloCMS.

• لا يوجد في الإعدادات استيراد للكتالوج ولا منتقٍ للمتاجر ولا اختبار اتصال. فأنت تنسخ UUID المتجر وكل معرّف متغيّر منتج من Gelato بنفسك.

• العناصر الغائبة عن الجدول تُترك خارج طلب Gelato دون أي تحذير للمشتري، والطلب الذي لا عناصر مطابقة فيه لا يُرسَل إطلاقًا.

• نقص الاسم أو سطر الشارع أو المدينة أو الرمز البريدي أو البلد يوقف إرسال الطلب. ويُسجَّل التخطي، ولا يُخمَّن شيء ولا يُملأ بدلًا من الناقص.

• لا يؤثر الاستدعاء الفاشل إلى Gelato في عملية البيع، سواء كان ردًّا بخطأ أو انتهاء مهلة. يُسجَّل الخطأ وتعرض صفحة «نشاط المزامنة» إدخالًا فاشلًا، لكن لا شيء يعيد إرساله نيابةً عنك.

• تسري المعلومات في اتجاه واحد. فلا تُقرأ حالة طلب Gelato ولا تكاليف الشحن ولا أرقام التتبع مرة أخرى إلى VeloCMS.

• الطلبات التي دُفعت قبل أن تُعدّ الإضافة لا تُرسَل أبدًا إلى Gelato.

الأسئلة الشائعة

إضافات ذات صلة

• Printful
• Printify
• ShipStation

المواصفات

الفئة

commerce

السعر

مضمَّن

الإصدار

1.0.0

المصدر

من الطرف الأول