لا تزال XML-RPC تعمل في Odoo 19، لكنها مهجورة، وتقول الوثائق الرسمية إن من المقرر إزالتها في Odoo 22. فأي شيء تعمل عليه الآن انقله إلى واجهة JSON-2 API.

نقل البوابة إلى JSON-2

• أنشئ مستخدمًا مخصصًا للتكامل لا يملك إلا الصلاحيات التي يحتاجها.
• من تفضيلات ذلك المستخدم، ضمن أمان الحساب، أنشئ مفتاح API جديدًا بوصف واضح ومدة قصيرة. ولا يمكن أن تتجاوز مدة المفاتيح ثلاثة أشهر، لذا خطط لتدويرها.
• استدعِ POST /json/2/sale.order/ متبوعًا باسم الدالة، مع إرسال المفتاح كرمز bearer في ترويسة Authorization.
• كل استدعاء معاملة مستقلة، لذا تجنب تقسيم الطلب الواحد على استدعاءات كثيرة.

تحقق أيضًا من خطتك: إذ تنص الوثائق على أن الوصول إلى واجهة API الخارجية متاح فقط في خطط التسعير المخصصة.

تجنب التكرار

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

الدفعات

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