إضافة تابي إلى أودو: دليل الربط خطوة بخطوة

دليل عملي لإضافة تابي إلى متجر أودو: حساب التاجر، المفاتيح، وضع الاختبار، العملات الست المدعومة، نشر المزود في صفحة الدفع، والتحقق بطلب حقيقي.

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

أودو لا يأتي بمزود دفع جاهز لتابي في أي إصدار. يعني التفعيل يمر بثلاث مراحل منفصلة: حساب تاجر لدى تابي، وحدة برمجية تتكلم مع واجهة تابي، ثم ضبط داخل أودو. المرحلة الأخيرة هي التي تضيع فيها ساعات، لأن فيها خطوتين تفشلان بصمت: مزود مفعّل لكنه غير منشور لا يظهر في صفحة الدفع أبدًا، وطلب بعملة غير مدعومة يخفي المزود تمامًا بدون أي رسالة خطأ.

هذا الدليل يمشي معك بالترتيب، ويشير إلى كل فخ في مكانه.

الخطوة الأولى: احصل على حساب تاجر في تابي

لا توجد وحدة برمجية تعطيك هذا الحساب، وأي صفحة توحي بغير ذلك تبيعك شيئًا لا تملكه. التقديم يتم مباشرة عبر merchant.tabby.ai.

ما الذي يطلبه تابي منك

جهّز السجل التجاري أو وثيقة العمل الحر، وحساب بنكي باسم النشاط، ورابط المتجر، ومعلومات عن نوع المنتجات ومتوسط قيمة الطلب. تابي يدرس التاجر قبل الموافقة، فالقرار تجاري من طرفهم ومدة الدراسة تخصهم، لا تخص المبرمج الذي ينفذ الربط.

بعد الموافقة تدخل لوحة التاجر وتجد ما يحتاجه أودو: مفتاح عام ومفتاح سري، بنسختين، واحدة للاختبار وواحدة للتشغيل الحقيقي. كذلك تتفق مع تابي على نسبة الرسوم وعلى خطة التقسيط المعروضة لعميلك. هذه الأرقام يحددها تابي معك في العقد، ولا تحددها أي وحدة في أودو.

وماذا عن تمارا

تمارا شركة مستقلة تمامًا، لها تقديم منفصل ومفاتيح منفصلة. أغلب المتاجر في السعودية تنتهي إلى تفعيل الاثنين معًا، لأن العميل له تفضيل، وصفحة الدفع التي تعرض مزودًا واحدًا تخسر النصف الآخر. الأفضل تقديم الطلبين بالتوازي لا بالتتابع.

الخطوة الثانية: اختر إضافة تناسب إصدارك ونسختك

أودو يبيع ويرخّص لكل إصدار رئيسي على حدة، فالإضافة المشتراة للإصدار 17 ليست نفس المنتج في الإصدار 18. قبل الشراء تأكد من ثلاثة أمور: رقم إصدار قاعدة بياناتك بدقة، هل الإضافة تعمل على النسخة المجتمعية أم على المؤسسية فقط، وهل تغطي الشاشات التي تحصّل منها فعلًا.

النقطة الثالثة تستحق وقفة. كثير من التجار يفكر في المتجر الإلكتروني فقط، ثم يكتشف بعد الإطلاق أن رابط الفاتورة الذي يرسله للعميل في البوابة لا يحتوي زر تابي، وأن الكاشير في الفرع لا يملك الخيار أصلًا. من هنا جاءت فكرة Tabby & Tamara for Odoo: تثبيت واحد يغطي المتجر الإلكتروني وفواتير البوابة وعروض الأسعار ونقاط البيع، للمزودين معًا، على أودو من 14 إلى 19، المجتمعي والمؤسسي.

الخطوة الثالثة: التثبيت وإدخال المفاتيح

ثبّت الإضافة من شاشة التطبيقات، ثم افتح المحاسبة، الإعدادات، مزودو الدفع. في أودو 16 وما قبله تسمى الشاشة نفسها وسطاء الدفع.

افتح سجل تابي وعبّئ:

• المفتاح العام والمفتاح السري من لوحة تابي، ابدأ بمفاتيح الاختبار.
• رمز المتجر إن كان حسابك يستخدم رمزًا لكل دولة أو لكل فرع.
• يومية الدفع في تبويب المحاسبة. أودو يرفض تفعيل مزود بلا يومية، ورسالة الخطأ ليست واضحة دائمًا.

احفظ، ثم اضغط زر اختبار الاتصال قبل أي شيء آخر. الوحدة الجيدة ترسل طلبًا حقيقيًا للبوابة وتخبرك بصراحة هل المفاتيح مقبولة أم لا. إذا فشل الاتصال هنا فالمشكلة في المفاتيح، لا في أودو، ولن يحلها تحديث الأصول ولا إعادة تشغيل الخادم.

الخطوة الرابعة: وضع الاختبار، وما معناه بالضبط

اجعل حالة المزود على وضع الاختبار واستخدم مفاتيح الاختبار. بيئة تابي التجريبية تتيح لك هويات اختبار تنتج موافقة أو رفضًا حسب طلبك، فتجرب الحالتين بدل أن تنتظر الصدفة.

انتبه لأمرين. الأول أن معاملات الاختبار لا تُسوّى ماليًا، فلا تعتمد عليها للتحقق من القيود المحاسبية. الثاني أنك عند التحويل للوضع الحقيقي يجب أن تستبدل المفتاحين معًا، لا المفتاح العام وحده، وأن تعيد اختبار الاتصال. مفتاح سري حقيقي مع مفتاح عام تجريبي ينتج رسالة خطأ تبدو وكأنها مشكلة شبكة.

الخطوة الخامسة: انشر المزود، لا تكتفِ بتفعيله

هذا هو السبب الأول والأكثر تكرارًا وراء شكوى: تابي ما يظهر في صفحة الدفع.

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

اضبط الحالة على مفعّل وتجاهل النشر، وستحصل على المشهد الذي يصفه كثيرون: الإعدادات تبدو سليمة، اختبار الاتصال ناجح، وصفحة الدفع خالية من تابي. لا شيء معطّل، أودو ينفذ ما طلبته منه حرفيًا.

فعّل النشر. وإذا كنت على أودو 15 أو أقدم، المقابل هو زر النشر الذي يظهر عند فتح المزود من واجهة الموقع.

الخطوة السادسة: راجع العملة قبل أن تبحث عن عطل

تابي وتمارا يعملان بعملات خليجية فقط، وهي الريال السعودي والدرهم الإماراتي والدينار الكويتي والدينار البحريني والريال القطري والريال العماني.

إذا كان أمر البيع أو الفاتورة أو جلسة نقاط البيع بعملة أخرى مثل الدولار أو اليورو، فالوحدة المبنية بشكل صحيح تخفي المزود بدل أن ترسل للبوابة طلبًا مصيره الفشل. هذا هو السلوك الصحيح، لكنه من الخارج يشبه تمامًا التثبيت المعطوب.

لذلك عند غياب تابي، افحص بهذا الترتيب:

1. حالة المزود مفعّل وليست معطل.
2. المزود منشور.
3. عملة المستند من العملات الست.
4. إجمالي الطلب داخل الحد الأدنى والأعلى المعتمدين لحسابك لدى تابي.
5. قيود الدولة والعملة على المزود لا تستبعد هذا الزائر.

هذه القائمة تحل الغالبية العظمى من الحالات قبل أن يفتح أحد ملف السجلات.

الخطوة السابعة: تحقق بطلب حقيقي

حوّل إلى المفاتيح الحقيقية، أبقِ الحالة على مفعّل، ونفّذ بنفسك طلبًا صغيرًا حقيقيًا. ثم تحقق من أربعة أمور لا من واحد:

• ظهور شارة التقسيط تحت سعر المنتج، وتحدّثها عند تغيير الكمية أو اختيار متغير آخر. تابي يتوقع رسالة التقسيط ظاهرة في الموقع ضمن مراجعة الإطلاق، وصورة ثابتة للشعار لا تكفي.
• انتقال العميل إلى صفحة تابي بالمبلغ الصحيح وبيانات العميل الصحيحة.
• بعد الموافقة، تتحول المعاملة في أودو إلى منجزة، ويتأكد أمر البيع، ويرتبط الدفع بالفاتورة.
• تطابق المبلغ في لوحة تابي مع المبلغ في أودو حتى الهللة.

ثم نفّذ الاختبار العكسي: اترك صفحة تابي دون إكمال الدفع، وتأكد أن الطلب بقي غير مدفوع في أودو.

لماذا يجب ألا تُصدّق صفحة نجاح مزورة

هذه النقطة أهم مما تبدو. المتصفح يعود إلى موقعك برابط، والرابط يستطيع أي شخص كتابته بيده. فإذا كانت الوحدة تصدّق كلمة نجاح مكتوبة في الرابط، يستطيع العميل أن يعلّم طلبه كمدفوع بنفسه.

الأسلوب الصحيح أن يحمل رابط العودة مرجعًا فقط، ثم يتصل أودو بالمزود ويقرأ الحالة الحقيقية عبر GET /api/v2/payments/{id} قبل أن يلمس الطلب. وأن يُتحقق من الويب هوك بالطريقة نفسها بدل الوثوق به عند وصوله، وألا تُعالج معاملة وصلت لحالة نهائية مرتين. هكذا هي مبنية في Tabby & Tamara for Odoo، وهذا سؤال مشروع تسأله أي مزود قبل الشراء.

الخطوة الثامنة: الاسترداد وتشغيل اليوم التالي

أول سؤال يأتيك من المحاسب هو الاسترداد. يفترض أن يكون الاسترداد الكامل والجزئي ممكنًا من خلفية أودو، ومن الفاتورة نفسها، بحيث يصدر إشعار الدائن ويُنفذ الاسترداد لدى المزود في حركة واحدة، لا في نظامين منفصلين لا يعرف أحدهما الآخر.

راقب أيضًا سجل طلبات الواجهة. تسجيل كل نداء للبوابة مع إخفاء المفاتيح يعني أن أي طلب يتصرف بشكل غريب تستطيع أن ترى طلبه ورده بدل التخمين.

ما لا تفعله هذه الإضافة، بوضوح

لا تجعلك معتمدًا لدى تابي أو تمارا. وليست رسمية ولا معتمدة ولا تابعة لأي منهما. عدد الأقساط ونسبة الرسوم وحدود الشراء يحددها تابي وتمارا في اتفاقية التاجر، لا أي وحدة في أودو. ولا تغني عن اختبارك أنت على قاعدة بياناتك قبل أن تضعها أمام العملاء.

ما عدا ذلك، كل ما سبق تستطيع تنفيذه بنفسك الآن. وإذا كنت تفضّل ألا تكرر العملية مرتين، مرة لتابي ومرة لتمارا، فهذا بالضبط سبب وجود Tabby & Tamara for Odoo.

أسئلة متكررة