تكامل Darbpay مع Wafeq يربط إنفاق بطاقاتك مباشرةً بنظام المحاسبة في Wafeq، باستخدام دليل الحسابات وإعدادات الضرائب الخاصة بك.

بعد إكمال الربط، يقوم Darbpay بما يلي:

• استيراد حسابات مصروفات Wafeq وربطها بفئات المصروف في Darbpay

• استيراد رموز الضرائب في Wafeq وإتاحتها للربط مع الفئات

• تصدير مصروفات البطاقات، وكشوف الحساب، وصور الإيصالات إلى حساب بنكي مخصّص في Wafeq لبطاقات Darbpay

يتناول هذا المقال:

• كيف يعمل تكامل Wafeq

• كيفية ربط Wafeq مع Darbpay (تدفق OAuth)

• كيفية استيراد رموز الضرائب والحسابات من Wafeq

• كيفية ربط محافظ Darbpay بحسابات Wafeq البنكية

• كيف تظهر مصروفات Darbpay داخل Wafeq

• الأسئلة الشائعة (FAQs)

كيف يعمل تكامل Wafeq؟

في الخلفية، تم تصميم التكامل حول مسارين رئيسيين:

1. مزامنة بيانات لمرة واحدة (استيراد إلى Darbpay)

• يتم استيراد حسابات مصروفات Wafeq وربطها بفئات المصروف في Darbpay

• يتم استيراد رموز الضرائب في Wafeq وربطها برموز الضرائب في Darbpay

2. تصدير مستمر (من Darbpay إلى Wafeq)

• يقوم Darbpay بتصدير كشوف الحساب، ومصروفات البطاقات، والإيصالات إلى حساب بنكي مخصّص في Wafeq لبطاقات Darbpay

تستخدم عمليات التصدير علاقات الربط المخزَّنة:

• فئة المصروف ↔ حساب الأستاذ العام (GL) ↔ رمز الضريبة

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

الوصول إلى تكامل Wafeq داخل Darbpay

يمكنك العثور على تكامل Wafeq ضمن المسار:

الإعدادات → تكاملات المحاسبة → Wafeq

في هذه الصفحة ستجد:

• حالة التكامل (غير متصل / متصل)

• منظمة Wafeq المرتبطة حاليًا بـ Darbpay

• اختصار للوصول إلى معالج إعداد المحاسبة

• ملخص لعمليات التصدير الأخيرة وأي أخطاء ظهرت

يتبع معالج الإعداد تدفقًا من 5 خطوات:

Connect → Tax Codes → Expense Accounts → Bank Account → Finish
(الاتصال → رموز الضريبة → حسابات المصروف → الحساب البنكي → إنهاء)

الخطوة 1: ربط Darbpay مع Wafeq

اضغط Connect with Wafeq من بطاقة تكامل Wafeq.

سيتم تحويلك إلى صفحة OAuth الآمنة الخاصة بـ Wafeq.

على صفحة Wafeq:

• اختر منظمة Wafeq التي تريد ربطها مع Darbpay (مثال: "Darb").

• راجع الصلاحيات التي سيحصل عليها Darbpay، والتي تشمل عادةً صلاحيات القراءة/الكتابة على:

  • معلومات المنظمة وقائمة المستخدمين

  • دليل الحسابات (Chart of accounts)

  • الحسابات البنكية

  • المصروفات النقدية

  • جهات الاتصال والموظفين

  • معدلات الضرائب

  • قيود اليومية اليدوية (Manual journals)

• اضغط Connect لمنح الوصول (أو Cancel لإلغاء العملية).

بعد التأكيد، يقوم Wafeq بإعادتك إلى Darbpay. في الخلفية يقوم Darbpay بـ:

• استبدال رمز التفويض (Authorization code) برموز الوصول اللازمة

• تخزين مُعرّف (ID) منظمة Wafeq المختارة بشكل آمن ومشفّر

• تحديث حالة التكامل إلى Connected، وينتقل المعالج تلقائيًا إلى خطوة Tax Codes

الخطوة 2: استيراد رموز الضرائب من Wafeq إلى Darbpay

بعد الربط، ستصل إلى خطوة Tax Codes.

في هذه الصفحة سترى جدولاً يعكس إعدادات ضريبة القيمة المضافة/الضرائب في Wafeq، بما في ذلك:

• اسم الضريبة (Tax Name)

• الرمز الداخلي للضريبة (Internal Tax Code)

• نسبة الضريبة % (Tax Rate %)

• الحالة (نشط/Active)

يقوم Darbpay باستدعاء واجهة برمجة التطبيقات الخاصة بمعدلات الضرائب في Wafeq (Tax Rates API) واستيراد القائمة الكاملة لرموز الضرائب الخاصة بالمنظمة المختارة. يتم:

• تخزين هذه الرموز داخل نموذج الضرائب في Darbpay

• وضع علامة عليها بأنها قادمة من Wafeq

• إتاحتها للربط مع فئات المصروف في Darbpay

يمكن استبدال أو دمج إعدادات الضرائب الموجودة مسبقًا في Darbpay لتلك الشركة، حسب إعدادك، لكن يبقى Wafeq هو مرجع الحقيقة الأساسي لمعدلات ضريبة القيمة المضافة.

الخطوة 3: استيراد وربط حسابات مصروفات Wafeq

بعد ذلك تنتقل إلى خطوة Expense Accounts.

اضغط Import Expense Accounts from Wafeq.

• يستدعي Darbpay واجهة برمجة التطبيقات الخاصة بدليل الحسابات في Wafeq (Chart of Accounts API) ويجلب جميع حسابات الأستاذ العام (GL).

• تظهر في واجهة الربط فقط الحسابات ذات نوع "مصروف" (Expense) وفقًا لتصنيف الحساب في Wafeq.

بالنسبة لكل حساب، يخزّن Darbpay:

• مُعرّف حساب Wafeq

• اسم الحساب

بعد ذلك يمكنك ربط:

• كل فئة مصروف في Darbpay بحساب مصروف محدّد في Wafeq

تُستخدم هذه العلاقات في كل مرة ينشئ فيها Darbpay قيودًا محاسبية للتصدير إلى Wafeq.

الخطوة 4: اختيار الحسابات البنكية في Wafeq لتسويات بطاقات Darbpay

تحدد خطوة Bank Account أين ستظهر تسويات بطاقات Darbpay داخل Wafeq.

لديك خياران:

الخيار 1: استخدام حساب بنكي واحد

• اختر حسابًا بنكيًا واحدًا موجودًا في Wafeq من القائمة المنسدلة، مثل:

  • Bank Account

  • Undeposited Funds

  • Petty Cash

• أو أنشئ حسابًا بنكيًا جديدًا في Wafeq مخصّصًا لـ Darbpay إذا لم يكن لديك حساب مناسب.

الخيار 2: ربط المحافظ بعدّة حسابات بنكية

إذا كنت تدير وحدات أعمال أو كيانات مختلفة، يمكنك ربط كل محفظة/محفظة فرعية في Darbpay بحساب بنكي مختلف في Wafeq:

• اضغط Map wallets to Bank Accounts

• لكل محفظة/محفظة فرعية، اختر الحساب البنكي في Wafeq الذي يجب أن تُسجّل عليه

عند الحفظ، يخزّن Darbpay:

• مُعرّف الحساب البنكي الافتراضي لتسويات البطاقات

• (إن تم ضبطه) ربط كل محفظة/محفظة فرعية ↔ مُعرّف حساب بنكي محدد في Wafeq

تُستخدم هذه العلاقات لاحقًا لبناء القيود المحاسبية الصحيحة لكل عملية تصدير.

الخطوة 5: إنهاء الإعداد

في خطوة Finish سترى ملخصًا لتكوينك:

• منظمة Wafeq المتصلة

• رموز الضرائب وحسابات المصروف التي تم استيرادها

• الحساب البنكي الافتراضي وأي ربط خاص بالمحافظ

يمكنك دائمًا العودة إلى صفحة تكامل Wafeq لاحقًا لـ:

• تحديث رموز الضرائب أو الحسابات

• تعديل ربط الفئات أو المحافظ

• فصل وربط Wafeq من جديد عند الحاجة

كيف تظهر عمليات تصدير Darbpay داخل Wafeq؟

بعد إكمال الإعداد، يقوم Darbpay بتصدير حركات البطاقات المعتمدة والجاهزة للتصدير إلى Wafeq، اعتمادًا على العلاقات التي قمت بضبطها.

لكل معاملة:

• يستدعي Darbpay واجهات برمجة تطبيقات Wafeq لإنشاء القيود المحاسبية اللازمة (مصروفات / قيود يومية) مع:

  • حساب المصروف المرتبط (مثال: "530 Darbpay Expenses")

  • الحساب البنكي/حساب التسوية المرتبط

  • رمز الضريبة المرتبط ومبالغ ضريبة القيمة المضافة

بعد أن يؤكد Wafeq إنشاء القيود، يقوم Darbpay بوضع علامة Exported على المعاملة ويخزّن مُعرّف المستند في Wafeq، لاستخدامه في الروابط المباشرة (deep-linking) عند الحاجة.

داخل Wafeq:

• تظهر مصروفات البطاقات في قائمة الأرباح والخسائر (Profit & Loss) تحت حسابات GL التي قمت بربطها (مثل "530 Darbpay Expenses" أو "Fuel" أو "Travel" أو "Office Supplies").

• تعرض التقارير المجاميع الشهرية وتجمعها ضمن بند المصروفات التشغيلية (Operating Expenses) وصافي الربح (Net Profit).

• إذا قمت بربط فئات مختلفة بحسابات GL مختلفة، يظهر كل حساب في سطر منفصل في قائمة الأرباح والخسائر والتقارير ذات الصلة.

هذا يعني أن إنفاق Darbpay يتدفّق مباشرةً إلى لوحات المعلومات والتقارير المالية القياسية في Wafeq، بدون إعادة إدخال يدوية للبيانات.

الأسئلة الشائعة (FAQs)

ما البيانات التي يصل إليها Darbpay داخل Wafeq؟

عند ربط Wafeq، تقوم صراحةً بمنح Darbpay صلاحية الوصول إلى:

• معلومات المنظمة وقائمة المستخدمين

• دليل الحسابات (Chart of accounts)

• الحسابات البنكية

• المصروفات النقدية (Cash expenses)

• جهات الاتصال والموظفين

• معدلات الضرائب (Tax rates)

• قيود اليومية اليدوية (Manual journals)

يستخدم Darbpay هذا الوصول من أجل:

• استيراد رموز الضرائب وحسابات GL لربطها بالفئات والمحافظ

• إنشاء القيود المحاسبية اللازمة لتسجيل مصروفات بطاقات Darbpay

هل يقوم Darbpay بتغيير دليل الحسابات أو معدلات الضرائب في Wafeq؟

لا. يقوم Darbpay بقراءة دليل الحسابات ومعدلات الضرائب لديك في Wafeq واستخدامها كمرجع أساسي.
ولا يقوم بتعديل الحسابات أو قواعد الضرائب الحالية.

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

هل يمكنني ربط محافظ أو أقسام مختلفة بحسابات بنكية مختلفة؟

نعم.

باستخدام خيار Map wallets to Bank Accounts يمكنك:

• ربط كل محفظة/محفظة فرعية في Darbpay بحساب بنكي منفصل في Wafeq

• عكس الكيانات أو الفروع أو مراكز التكلفة مباشرةً من خلال ربطها بالحسابات البنكية المناسبة

ستتبع عمليات التصدير المستقبلية هذه العلاقات تلقائيًا.

ماذا يحدث إذا غيّرت علاقات الربط لاحقًا؟

إذا قمت بتغيير:

• ربط الفئات ↔ الحسابات / رموز الضرائب، أو

• ربط المحافظ ↔ الحسابات البنكية

فإن هذه التغييرات تنطبق على عمليات التصدير المستقبلية فقط.
أما المعاملات التي تم تصديرها بالفعل إلى Wafeq فتظل كما هي؛ وإذا احتجت لتعديلها يجب تعديلها من داخل Wafeq نفسه حسب سياساتك الداخلية.

كيف أفصل Wafeq عن Darbpay؟

من صفحة تكامل Wafeq:

• استخدم خيار Disconnect access لفصل الربط.

يمكنك إعادة الربط في أي وقت عن طريق تكرار خطوة Connect with Wafeq مرة أخرى.