تكامل Zoho Books
الفوترة الإلكترونية في الإمارات لـ Zoho Books — لا حاجة للهجرة
تربط تراست بل Zoho Books بشبكة الفوترة الإلكترونية للهيئة الاتحادية للضرائب عبر Microvista Technologies. استمر في استخدام Zoho كما تفعل اليوم — نحن نتعامل مع تحويل PINT-AE والتوقيع والإرسال تلقائيًا. مباشر في 5 دقائق.
كيف تتكامل تراست بل مع Zoho Books
ترتبط تراست بل بـ Zoho Books عبر OAuth API، وتسحب بيانات الفاتورة تلقائيًا بدون تصدير يدوي. التكامل يدعم جميع أنواع فواتير Zoho Books: فواتير المبيعات، وإشعارات الدائنة، وإشعارات المدين. بمجرد الاتصال، كل فاتورة تنشئها في Zoho Books تتم مزامنتها مع تراست بل في الوقت الفعلي، وتحويلها إلى تنسيق PINT-AE XML، والتحقق من صحتها ضد متطلبات الهيئة، وإرسالها إلى شبكة مزود الخدمة المعتمد. العملية بالكامل آلية — لا حاجة لتدخل يدوي. يمكنك الاستمرار في استخدام Zoho Books لجميع عمليات المحاسبة: الفوترة، وتتبع الدفع، والمصالحة، والتقارير. تعمل تراست بل كطبقة امتثال فوق ذلك، تضمن كل فاتورة صادرة تلبي متطلبات تفويض 2026-2027.
دليل الإعداد في 5 دقائق
إعداد تكامل Zoho Books يستغرق أقل من 5 دقائق:
1. **أنشئ حساب تراست بل** — سجل مجانًا (لا حاجة لبطاقة ائتمان). 2. **انتقل إلى المصادر** — اذهب إلى صفحة المصادر في لوحة تحكم تراست بل. 3. **اختر Zoho Books** — اختر Zoho Books من قائمة تكامل ERP. 4. **أذن الاتصال** — انقر Connect للسماح لتراست بل بالوصول إلى حساب Zoho Books عبر OAuth. 5. **قم بتكوين إعدادات المزامنة** — اختر أنواع الفواتير للمزامنة (مبيعات، إشعارات دائنة، إشعارات مدين) واضبط تردد المزامنة (الوقت الفعلي أو كل ساعة). 6. **اختبر الإرسال** — أنشئ فاتورة اختبار في Zoho Books وتحقق من ظهورها في تراست بل مع التحقق من PINT-AE.
التكامل يستخدم OAuth 2.0 للمصادقة الآمنة — تراست بل لا تخزن بيانات اعتماد Zoho الخاصة بك أبدًا. يمكنك إلغاء الوصول في أي وقت من إعدادات Zoho Books.
امتثال PINT-AE لفواتير Zoho
تحول تراست بل تلقائيًا فواتير Zoho Books إلى تنسيق PINT-AE XML، معيار الفوترة الإلكترونية الوطني في الإمارات. التحويل يتعامل مع جميع عناصر البيانات المطلوبة: UUID للفاتورة، تاريخ الإصدار، TRN البائع/المشتري، تفاصيل بنود السطر، معدلات ضريبة القيمة المضافة، والحقول المحددة للإمارات مثل أعلام المنطقة الحرة ومؤشرات نظام الهامش.
يخزن Zoho Books بيانات الفاتورة بتنسيقه الأصلي، الذي يختلف عن متطلبات PINT-AE. محرك التحويل في تراست بل يحول هياكل بيانات Zoho إلى مواصفات PINT-AE، يضمن ملء كل حقل بشكل صحيح. يتحقق النظام من كل فاتورة محولة ضد 51 عنصر بيانات إلزامي للهيئة قبل الإرسال، يلتقط أخطاء مثل TRNs المفقودة، معدلات ضريبة القيمة المضافة غير الصالحة، أو تفاصيل بنود السطر غير المكتملة. يتم الإبلاغ عن أخطاء التحقق في لوحة تحكم تراست بل مع تفسيرات واضحة، مما يسمح لك بإصلاح المشكلات في Zoho Books وإعادة الإرسال.
تعيين حقل Zoho Books ← PINT-AE
التعيين الدقيق الذي يطبّقه تراست بل عند تحويل فاتورة Zoho Books إلى PINT-AE XML. احتفظ بهذا الجدول قبل تكوين قوالب ضرائب Zoho والبيانات الرئيسية للعملاء — التفصيل على مستوى الحقل هو ما يصنع أو يكسر مطابقة الهيئة اللاحقة.
| حقل Zoho Books | حقل PINT-AE / UBL 2.1 | ملاحظة |
|---|---|---|
| invoice.invoice_number | cbc:ID | رقم فاتورتك. يجب أن يكون فريدًا عبر جميع الإرساليات. |
| invoice.date | cbc:IssueDate | تاريخ ISO. لا يجب أن يكون في المستقبل. |
| invoice.customer.gst_no / customer.custom_fields[trn] | cac:AccountingCustomerParty/cac:PartyTaxScheme/cbc:CompanyID | TRN المشتري — 15 رقمًا. اضبطه على سجل العميل، وليس على الفاتورة. |
| organization.tax_id (UAE) | cac:AccountingSupplierParty/cac:PartyTaxScheme/cbc:CompanyID | TRN الخاص بك، مضبوط مرة في إعدادات مؤسسة Zoho Books. |
| line_items[].description | cac:InvoiceLine/cbc:Description | نص بند السطر. UTF-8، الأحرف العربية مدعومة. |
| line_items[].quantity × rate | cbc:LineExtensionAmount, cbc:BaseQuantity, cac:Price/cbc:PriceAmount | PINT-AE يُعيد بناء إجمالي البند من الكمية × المعدل. |
| line_items[].tax_id → tax_name | cac:ClassifiedTaxCategory (S=5%, Z=0%, E=معفى, O=خارج النطاق) | اسم ضريبة Zoho يجب أن يُطابق فئة PINT-AE عبر Tax Mapping في تراست بل. |
| invoice.currency_code | cbc:DocumentCurrencyCode | AED للمحلي؛ الرموز الأخرى تحتاج ملف تعريف فاتورة FX. |
| invoice.total | cac:LegalMonetaryTotal/cbc:PayableAmount | مُطابق مع إجماليات البنود + الضرائب؛ عدم تطابق = فشل تحقق. |
| customer.custom_fields[free_zone_id] | علم namespace امتداد؛ فئة الضريبة مُشتقة | مكّن الحقل المخصص على العميل ليتدفق إلى كل فاتورة. |
| invoice.notes / custom_fields[advance_uuid] | cac:DocumentReference لربط الدفعة المقدمة (النوع 386) | عبّئ على أي فاتورة تسترد دفعة مقدمة سابقة. |
| creditnote.invoice_id | cbc:InvoiceTypeCode="381"؛ cac:BillingReference/cac:InvoiceDocumentReference | إشعار Zoho الدائن يجب أن يكون مرتبطًا بالفاتورة المصدر. |
أخطاء التحقق الشائعة Zoho Books ← PINT-AE
أكثر ثمانية أخطاء تحقق تُصادَف لفواتير Zoho Books، مع الإصلاح الدقيق على جانب Zoho. لوحة تحكم تراست بل تُظهر كلاً منها بتفسير واضح؛ الجدول أدناه هو النسخة المرجعية.
| رمز الخطأ | المعنى | الإصلاح في Zoho Books |
|---|---|---|
| PAE-BR-01 | TRN المشتري مفقود أو غير صحيح. | افتح العميل في Zoho Books ← Contacts ← تحرير ← اضبط GST Treatment على UAE مع TRN من 15 رقمًا، أو استخدم الحقل المخصص trn. |
| PAE-BR-04 | TRN البائع مفقود. | Zoho Books ← Settings ← Organization Profile ← اضبط Tax Registration Number. |
| PAE-BR-11 | عدم تطابق إجمالي البند (كمية × معدل ≠ إجمالي البند). | في فاتورة Zoho، حرّر البند وصحّح التقريب على Rate أو Qty بحيث يتوافق المبلغ. |
| PAE-BR-12 | اسم ضريبة Zoho غير مطابق لفئة PINT-AE. | تراست بل ← Settings ← Tax Mapping. اربط كل ضريبة Zoho بفئة PINT-AE (S / Z / E / O). |
| PAE-BR-14 | العملة ليست AED ولا يوجد مرجع سعر FX مُقدّم. | في فاتورة Zoho، تأكد من ضبط Exchange Rate وتكوين Base Currency للمؤسسة. |
| PAE-BR-21 | الإشعار الدائن يفتقر إلى مرجع فاتورة أم صالح. | في Zoho Books، أنشئ الإشعار الدائن من الفاتورة المصدر عبر More ← Create Credit Note. لا تُنشئه مستقلاً. |
| PAE-BR-22 | فاتورة الدفعة المقدمة غير مرتبطة باستردادها. | أضف UUID فاتورة الدفعة المقدمة إلى الحقل المخصص advance_uuid لفاتورة الاسترداد قبل إعادة المزامنة. |
| PAE-BR-31 | علم المنطقة الحرة مُعلّم لكن رمز مكان التوريد غير موجود. | اضبط عنوان العميل في Zoho إلى عنوان المنطقة الحرة، ومكّن الحقل المخصص free_zone_id. |
ميزات رئيسية لمستخدمي Zoho Books
يتضمن تكامل Zoho Books في تراست بل:
- **مزامنة في الوقت الفعلي** — تظهر الفواتير في تراست بل في ثوانٍ بعد الإنشاء في Zoho Books. - **المعالجة بالجملة** — تعامل مع فوترة عالية الحجم بدون تدخل يدوي. - **معالجة الأخطاء** — يتم تمييز أخطاء التحقق مع تفسيرات واضحة وإصلاحات مقترحة. - **تتبع الحالة** — راقب حالة الإرسال (معلق، مرسل، مقبول، مرفوض) لكل فاتورة. - **إدارة الرفض** — يمكن إصلاح الفواتير المرفوضة في Zoho Books وإعادة إرسالها تلقائيًا. - **تكامل VAT 201** — تملأ الفواتير المرسلة مسودة إقرار ضريبة القيمة المضافة 201 تلقائيًا. - **دعم الكيانات المتعددة** — اربط منظمات Zoho Books متعددة بحساب تراست بل واحد. - **إقامة البيانات** — جميع بيانات الفاتورة تبقى في الإمارات (AWS me-central-1).
التكامل يعمل مع جميع إصدارات Zoho Books: Standard، Professional، Premium، و Enterprise.
التسعير لتكامل Zoho Books
تقدم تراست بل باقة مجانية لمستخدمي Zoho Books: 50 فاتورة شهريًا بدون تكلفة، لا حاجة لبطاقة ائتمان. هذا يغطي معظم الشركات الصغيرة التي تختبر الفوترة الإلكترونية قبل موعدها النهائي الإلزامي.
تبدأ الخطط المدفوعة من 200 درهم شهريًا لـ 500 فاتورة، مع تسعير متدرج لأحجام أعلى. الخطط للمؤسسات مع SLA مخصص ودعم مخصص متاحة لشركات المحاسبة التي تدير عملاء Zoho Books متعددين.
لا توجد رسوم إعداد أو عقود طويلة الأجل. يمكنك الترقية أو التخفيض في أي وقت. تكامل Zoho Books مشمول في جميع الخطط — لا رسوم إضافية.
الأسئلة الشائعة
هل أحتاج إلى تغيير إعداد Zoho Books؟
لا. ترتبط تراست بل بحساب Zoho Books الحالي الخاص بك بدون الحاجة إلى أي تغييرات في الإعداد الحالي أو سير العمل أو القوالب. تستمر في استخدام Zoho Books تمامًا كما تفعل اليوم.
هل بيانات Zoho Books آمنة؟
نعم. تستخدم تراست بل OAuth 2.0 للمصادقة الآمنة ولا تخزن بيانات اعتماد Zoho الخاصة بك أبدًا. جميع البيانات مشفرة أثناء النقل (TLS 1.3) وفي حالة التخزين (AES-256-GCM). بيانات الفاتورة تبقى في الإمارات (AWS me-central-1).
ماذا يحدث إذا تم رفض فاتورة؟
يتم تمييز الفواتير المرفوضة في لوحة تحكم تراست بل مع تفسيرات أخطاء واضحة. تقوم بإصلاح المشكلة في Zoho Books (مثلًا، تصحيح TRN، تعديل معدل ضريبة القيمة المضافة)، وتقوم تراست بل بإعادة إرسال الفاتورة المصححة تلقائيًا.
هل يمكنني ربط منظمات Zoho Books متعددة؟
نعم. يمكنك ربط منظمات Zoho Books متعددة بحساب تراست بل واحد، مما يجعله مثاليًا لشركات المحاسبة أو الشركات ذات الكيانات المتعددة.
هل يعمل هذا مع Zoho Books الهند أو مناطق أخرى؟
تكامل Zoho Books في تراست بل مكون خصيصًا لامتثال الفوترة الإلكترونية في الإمارات (تنسيق PINT-AE، التحقق من TRN الإمارات، إرسال الهيئة). يعمل مع حسابات Zoho Books الإمارات والحسابات العالمية المستخدمة للأعمال في الإمارات.