دفترة

اربط حسابك في دفترة بمفتاح API. يستورد كيوبت فواتيرك وعملاءك ومنتجاتك ومورديك بصلاحية القراءة فقط.

قبل البدء

• في دفترة، افتح الإعدادات، ثم API، ثم مفاتيح API، وأنشئ مفتاحًا. امنحه صلاحية القراءة على الموارد الأربعة: الفواتير والعملاء والمنتجات والموردين.
• دوّن النطاق الفرعي لحسابك. فإذا كان عنوان حسابك your-company.daftra.com، فالنطاق الفرعي هو your-company.
• تتطلب المزامنة التزايدية للعملاء أيضًا صلاحية قراءة المسار /v2/api/entity/client/list/-1.

ربط دفترة

1. افتح البيانات من الشريط الجانبي، وانقر على إضافة بيانات، ثم اختر ربط قاعدة بيانات.
2. في صفحة مصدر بيانات جديد، انقر على دفترة ضمن فئة المحاسبة.
3. أدخل اسم الاتصال.
4. املأ الحقول:
   • النطاق الفرعي للحساب: النطاق الفرعي وحده، دون https:// أو اسم النطاق.
   • نطاق الحساب: daftra.com أو daftara.com حسب حسابك، والقيمة الافتراضية daftra.com.
   • مفتاح API: المفتاح الذي أنشأته.
5. اختر جدول المزامنة. الخيار الافتراضي يوميًا.
6. انقر على إنشاء.

بعد الربط

يتحقق كيوبت من صحة صيغة النطاق الفرعي ومفتاح API، ثم يحفظ الاتصال ويبدأ المزامنة الأولى، ويتأكد أثناءها من صلاحية المفتاح.

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

المزامنة التزايدية

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

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