كيف أربط Xero لمزامنة الطلبات وجهات الاتصال مع محاسبتي؟
فوّض Xero مرة واحدة في VeloCMS، فينشئ كل طلب مكتمل فاتورة ACCREC معتمدة للعميل — مجانًا بدل إضافة مزامنة محاسبية مدفوعة.
يُبقي موصل Xero محاسبتك محدّثة دون إدخال يدوي: كل طلب مكتمل ينشئ فاتورة ACCREC (ذمم مدينة) في مؤسستك على Xero، مع جهة اتصال Xero مطابقة للعميل. وهو بديل مجاني عن الإضافة الرسمية للمزامنة المحاسبية التي تكلّف 109 دولارات سنويًا.
تثبيت الإضافة وخطوات استكشاف الأخطاء العامة تنطبق على كل التكاملات ومكتوبة مرة واحدة في الدليل المشترك للتكاملات. وما يلي هو ما يخص Xero وحده.
الخطوة 1 — فوّض مؤسستك على Xero
افتح «لوحة التحكم ← الإضافات ← Xero» واضغط Connect Xero. هذه عملية OAuth: تسجّل الدخول إلى Xero، وتوافق على الوصول إلى مؤسستك، ثم تعود وقد عرضت اللوحة حالة Connected. لا يوجد مفتاح API تنسخه أو تلصقه.
يطلب VeloCMS صلاحيتَي accounting.transactions وaccounting.contacts ليتمكن من إنشاء الفواتير وجهات الاتصال، وoffline_access لتبقى الصلاحية قائمة بعد انتهاء جلسة واحدة. وتُضاف نطاقات تسجيل الدخول المعتادة (openid وprofile وemail). ولا يُطلب شيء يخص الرواتب أو الحسابات المصرفية أو التقارير.
إذا ظهر لك إشعار بأن الموصل غير مهيّأ بدلاً من زر Connect، فهذه خطوة إعداد على مستوى المنصة لم تكتملها نسخة VeloCMS الخاصة بك — وليست شيئًا يمكنك إصلاحه من هذه اللوحة. تواصل مع الدعم إذا احتجت إلى تفعيله.
ماذا يحدث بعد الطلب
- يبحث VeloCMS عن بريد العميل بين جهات اتصال Xero لديك. فإذا وُجدت مطابقة أُعيد استخدامها؛ وإلا أُنشئت جهة اتصال جديدة في Xero باسم بريد العميل الإلكتروني.
- ثم تُنشأ فاتورة ACCREC في Xero للطلب، مرتبطة بجهة الاتصال تلك.
- وإذا فشل البحث عن جهة الاتصال أو إنشاؤها لأي سبب، تُنشأ الفاتورة مع ذلك باستخدام بريد العميل مباشرة — فلا تمنع مشكلة في جهة الاتصال الفاتورة من أن تُزامَن.
كيف تبدو الفاتورة
لكل فاتورة سطر واحد وصفه «Order #» متبوعًا برقم الطلب في VeloCMS، بكمية 1 وإجمالي الطلب سعرًا للوحدة. ويُرمَّز السطر إلى الحساب 200، وهو حساب المبيعات (Sales) في شركة Xero التجريبية الافتراضية، وليس في اللوحة إعداد لاستخدام رمز آخر. فإن كان دليل حساباتك يستخدم رمزًا آخر للمبيعات، فخطّط لإعادة ترميز هذه الأسطر في Xero. وتُنشأ الفاتورة بحالة Authorised، أي معتمدة لا مسودة. ولا يسجّل VeloCMS أي دفعة عليها، فطابِق الدفعة في Xero كما تفعل مع أي فاتورة أخرى.
ويرسل VeloCMS إلى Xero مفتاح تكرار (idempotency key) مبنيًا على الطلب، لجهة الاتصال وللفاتورة معًا. فإذا عولج الطلب نفسه ثانيةً، مثلًا بعد محاولة انقطعت، أعاد Xero الفاتورة الأصلية بدل إنشاء فاتورة ثانية.
إذا تعذّر الوصول إلى Xero مؤقتًا أو انتهت صلاحية تفويضك، تفشل محاولة المزامنة بصمت في الخلفية — ولا تعطّل الطلب نفسه أو تؤخّره أبدًا. ويظهر الطلب عندئذ في «التكاملات ← نشاط المزامنة». وليس لـ Xero زر إعادة المحاولة هناك، فأنشئ تلك الفاتورة في Xero يدويًا بعد إعادة الربط.
قطع الاتصال
اضغط Disconnect في اللوحة لإزالة رموز VeloCMS، وإزالة مؤسستك من اتصالات VeloCMS في Xero، وإلغاء رمز التحديث. تبقى الفواتير وجهات الاتصال التي أُنشئت في Xero فيه؛ ولن تُنشأ أي فواتير جديدة بعد قطع الاتصال.