نظرة عامة على التكاملات

يدعم وقتي التكامل مع أنظمة مؤسسية متعددة لتبسيط عمليات المشتريات لديك.

التكاملات المتاحة

أنظمة المحاسبة وERP

النظام	الحالة	الميزات
Qoyod	✅ متاح	مزامنة الموردين، مزامنة الفواتير، مزامنة المدفوعات (السعودية)
Odoo	✅ متاح	مزامنة أوامر الشراء، مزامنة الموردين، مزامنة الفواتير
QuickBooks Online	✅ متاح	مزامنة الفواتير، مزامنة الموردين، دليل الحسابات

مزودو التوقيع الإلكتروني

المزود	الحالة	الميزات
Signit.sa	✅ متاح	توقيعات رقمية متوافقة مع السعودية، مصادقة Nafath
DocuSign	✅ متاح	توقيع أوامر الشراء والعقود، قوالب
SignNow	✅ متاح	توقيع عبر الجوال، قوالب

الأتمتة

المنصة	الحالة	الميزات
Zapier	✅ متاح	أكثر من 5000 تطبيق متصل، Webhooks، محفزات (triggers)
REST API	✅ متاح	وصول برمجي كامل (خطط Pro وأعلى)

مزودو المصادقة

المزود	الحالة	البروتوكول
Microsoft Entra ID	✅ جاهز	SAML 2.0 / OIDC
Google Workspace	✅ جاهز	OIDC
Okta	✅ جاهز	SAML 2.0
LDAP/Active Directory	✅ متاح	LDAP v3

بوابات الدفع

البوابة	الحالة	المنطقة
Tap Payments	✅ نشط	دول مجلس التعاون والعالم
Moyasar	✅ نشط	المملكة العربية السعودية
Stripe	🔜 قريباً	دولي

إعداد التكاملات

1. الانتقال إلى التكاملات

الإعدادات ← التكاملات ← إضافة جديد

2. اختيار نوع التكامل

اختر من بين:

• ERP/المحاسبة
• المصادقة
• الدفع

3. تكوين بيانات الاعتماد

يتطلب كل تكامل بيانات اعتماد محددة:

الأمان

تُشفَّر بيانات اعتماد التكامل عند التخزين ولا تُعرَض أبداً في السجلات أو التصديرات.

4. اختبار الاتصال

اختبر الاتصال دائماً قبل تفعيل المزامنة:

// Connection test response
{
  "status": "success",
  "message": "Connected to Odoo ERP",
  "version": "16.0",
  "database": "production"
}

5. تكوين إعدادات المزامنة

حدد البيانات التي يجب مزامنتها وتكرار ذلك:

الإعداد	الخيارات	الافتراضي
تكرار المزامنة	فوري، كل ساعة، يومي	كل ساعة
الاتجاه	اتجاه واحد، ثنائي الاتجاه	اتجاه واحد
حل التعارض	يغلب وقتي، يغلب النظام الخارجي	يغلب وقتي

حالة التكامل

راقب تكاملاتك من لوحة التحكم:

┌─────────────────────────────────────────────────────┐
│ حالة التكامل                                        │
├─────────────────────────────────────────────────────┤
│ ✅ Odoo ERP          آخر مزامنة: منذ 5 دقائق        │
│ ✅ QuickBooks        آخر مزامنة: منذ ساعة           │
│ ⚠️ LDAP              انتهت مهلة الاتصال            │
│ ❌ SAP               غير مُكوَّن                    │
└─────────────────────────────────────────────────────┘

التعامل مع الأخطاء

مشكلات شائعة

الخطأ	السبب	الحل
CONNECTION_TIMEOUT	شبكة أو جدار ناري	مراجعة قواعد الجدار الناري
AUTHENTICATION_FAILED	بيانات اعتماد غير صحيحة	إعادة إنشاء مفاتيح API
RATE_LIMITED	طلبات كثيرة جداً	تقليل تكرار المزامنة
DATA_MISMATCH	اختلاف في المخطط	مراجعة تعيينات الحقول

السجلات (Logging)

تتوفر سجلات التكامل عبر:

الإعدادات ← التكاملات ← [التكامل] ← السجلات

تتضمن السجلات:

• بيانات الطلب/الاستجابة (Request/Response)
• الطوابع الزمنية (Timestamps)
• رسائل الخطأ
• إحصاءات المزامنة

تعيين البيانات (Data mapping)

حقول أمر الشراء (Purchase Order)

حقل وقتي	حقل Odoo	حقل QuickBooks
po_number	name	DocNumber
vendor_id	partner_id	VendorRef
total_inc_vat	amount_total	TotalAmt
status	state	TxnStatus

حقول المورد (Vendor)

حقل وقتي	حقل Odoo	حقل QuickBooks
name	name	DisplayName
email	email	PrimaryEmailAddr
vat_number	vat	TaxIdentifier
payment_terms	property_payment_term_id	SalesTermRef

Webhooks

استقبال تحديثات فورية من وقتي:

الأحداث المتاحة (Events)

• po.created
• po.approved
• po.rejected
• invoice.received
• vendor.created

حمولة Webhook (Payload)

{
  "event": "po.approved",
  "timestamp": "2025-01-15T10:30:00Z",
  "data": {
    "po_number": "PO-2025-0042",
    "vendor": "Acme Corp",
    "total": 15000.00,
    "currency": "SAR"
  },
  "signature": "sha256=..."
}

اعتبارات الأمان

1. API Keys — جدِّد المفاتيح كل 90 يوماً تقريباً
2. IP Whitelisting — قيّد الوصول إلى عناوين IP معروفة
3. Audit Trail — تُسجَّل جميع عمليات المزامنة
4. Data Encryption — TLS 1.3 أثناء النقل

الخطوات التالية

• إعداد تكامل Qoyod — محاسبة سعودية
• إعداد تكامل Odoo
• إعداد تكامل QuickBooks
• تكامل Signit.sa — توقيع إلكتروني سعودي
• تكامل DocuSign
• تكامل Zapier — أتمتة
• تكوين LDAP/SSO
• توثيق REST API