تكامل Xero
فوترة إلكترونية Xero في الإمارات: تكامل PINT-AE للهيئة 2026
Xero مبني للبنوك الإلكترونية والعملات المتعددة والشركات الصغيرة والمتوسطة المدارة من المحاسبين — لكنه لا ينشئ PINT-AE XML أصليًا ولا يرسل إلى الهيئة الاتحادية للضرائب. تغلق تراست بل هذه الفجوة بموصل OAuth معتمد يحول فواتير Xero المعتمدة ويرسلها عبر شبكة Peppol.
كيف تتكامل تراست بل مع Xero
تتصل تراست بل بـ Xero عبر واجهة REST API المفتوحة ومصادقة OAuth 2.0. بمجرد الترخيص، نقرأ بيانات الفواتير وجهات الاتصال المعتمدة من Xero، ونطبق تعيين حقول PINT-AE للإمارات، ونتحقق من المخرجات وفقًا لقواعد وزارة المالية. بعد ذلك يتم توقيع الفواتير الصالحة إلكترونيًا وإرسالها عبر مزود خدمة معتمد من الهيئة الاتحادية للضرائب على شبكة Peppol من 5 أطراف. يستلم مزود خدمة المشتري الفاتورة وتستلم الهيئة الاتحادية للضرائب وثيقة بيانات الضريبة المطلوبة (TDD).
دليل الإعداد لمرة واحدة
البدء بفوترة Xero الإلكترونية يستغرق بضع دقائق ولا يتطلب كتابة أكواد:
1. **أنشئ حساب تراست بل** — سجل مجانًا وأدخل الرقم الضريبي وبيانات العمل. 2. **اربط Xero** — صرح لـ تراست بل عبر تسجيل دخول OAuth من Xero. نطلب فقط وصول القراءة للفواتير وجهات الاتصال ومعدلات الضريبة والحسابات. 3. **عيّن معدلات الضريبة** — اجعل معدلات ضريبة القيمة المضافة في Xero (5% القياسية، 0%, معفاة) تتوافق مع فئات ضريبة PINT-AE. 4. **راجع البيانات الأساسية** — تأكد من صحة أرقام TRN للعملاء/الموردين والإمارات وبيانات المنطقة الحرة في Xero. 5. **اختبر وانطلق** — أرسل فاتورة اختبار، تحقق من التحقق من PINT-AE، ثم انتقل إلى الإرسال المباشر.
معظم الشركات تصدر فواتير إلكترونية متوافقة في نفس اليوم.
امتثال PINT-AE لفواتير Xero
لا ينتج Xero حاليًا ملفات PINT-AE XML ولا يرسل الفواتير إلى الهيئة الاتحادية للضرائب مباشرة. بموجب تفويض الفوترة الإلكترونية في الإمارات، لن تكون فواتير PDF والبريد الإلكتروني صالحة للمعاملات B2B و B2G بمجرد سريان المواعيد النهائية. فقط الفواتير منظمة XML/JSON المتبادلة عبر مزود خدمة معتمد على شبكة Peppol تلبي المتطلبات القانونية. تراست بل تعمل كموصل ASP: تعيّن بيانات فاتورة Xero إلى قاموس بيانات PINT-AE، وتنشئ XML، وتطبق التوقيع الرقمي المطلوب، وتبلغ TDD إلى الهيئة الاتحادية للضرائب.
تعيين حقل Xero ← PINT-AE
التعيين الدقيق الذي يطبّقه تراست بل عند تحويل فاتورة Xero (عبر حمولة Accounting API v2) إلى PINT-AE XML. احتفظ بهذا الجدول قبل تكوين معدلات ضرائب Xero وسجلات جهات الاتصال — التفصيل على مستوى الحقل هو ما يصنع أو يكسر مطابقة الهيئة اللاحقة.
| حقل Xero API | حقل PINT-AE / UBL 2.1 | ملاحظة |
|---|---|---|
| Invoice.InvoiceNumber | cbc:ID | رقم فاتورتك. يجب أن يكون فريدًا عبر جميع الإرساليات. |
| Invoice.Date | cbc:IssueDate | تاريخ ISO. لا يجب أن يكون في المستقبل. |
| Invoice.Contact.TaxNumber | cac:AccountingCustomerParty/cac:PartyTaxScheme/cbc:CompanyID | TRN المشتري — 15 رقمًا. اضبطه على سجل جهة الاتصال، وليس على الفاتورة. |
| Organisation.TaxNumber | cac:AccountingSupplierParty/cac:PartyTaxScheme/cbc:CompanyID | TRN الخاص بك. اضبطه مرة في Xero ← Settings ← Organisation details. |
| LineItems[].Description | cac:InvoiceLine/cbc:Description أو cac:Item/cbc:Name | نص بند السطر. UTF-8، الأحرف العربية مدعومة. |
| LineItems[].Quantity × UnitAmount | cbc:LineExtensionAmount, cbc:BaseQuantity, cac:Price/cbc:PriceAmount | PINT-AE يُعيد بناء إجمالي البند من الكمية × السعر. |
| LineItems[].TaxType (INPUT/OUTPUT/NONE) | cac:ClassifiedTaxCategory (S=5%, Z=0%, E=معفى, O=خارج النطاق) | TaxType الإماراتي في Xero يجب أن يُطابق فئة PINT-AE قبل الإرسال. |
| Invoice.CurrencyCode | cbc:DocumentCurrencyCode | AED للمحلي؛ غير AED يحتاج إضافة Xero متعددة العملات وسعر قاعدة. |
| Invoice.Total | cac:LegalMonetaryTotal/cbc:PayableAmount | مُطابق مع إجماليات البنود + الضرائب؛ عدم تطابق = فشل تحقق. |
| Contact.TrackingCategories → "FreeZone" | علم namespace امتداد؛ فئة الضريبة مُشتقة | اضبط فئة التتبع على جهة الاتصال ليتدفق إلى كل فاتورة. |
| Invoice.Reference / TrackingCategories → "AdvanceUUID" | cac:DocumentReference لربط الدفعة المقدمة (النوع 386) | عبّئ على أي فاتورة تسترد دفعة مقدمة سابقة. |
| CreditNote.Allocations[].InvoiceID | cbc:InvoiceTypeCode="381"؛ cac:BillingReference/cac:InvoiceDocumentReference | إشعار Xero الدائن يجب أن يكون مُخصّصًا للفاتورة المصدر. |
أخطاء التحقق الشائعة Xero ← PINT-AE
أكثر ثمانية أخطاء تحقق تُصادَف عندما تفشل فاتورة Xero في فحوصات PINT-AE، وما يجب إصلاحه بالضبط في Xero لتصفيتها. لوحة تحكم تراست بل تُظهر هذه الرموز بتفسيرات واضحة؛ الجدول أدناه هو النسخة المرجعية.
| رمز الخطأ | المعنى | الإصلاح في Xero |
|---|---|---|
| PAE-BR-01 | TRN المشتري مفقود أو غير صحيح. | Xero ← Contacts ← حرّر العميل ← اضبط Tax Number إلى TRN من 15 رقمًا. |
| PAE-BR-04 | TRN البائع مفقود. | Xero ← Settings ← Organisation details ← اضبط Tax Number. |
| PAE-BR-11 | عدم تطابق إجمالي البند (كمية × سعر ≠ إجمالي البند). | في فاتورة Xero، حرّر البند وصحّح التقريب على Quantity أو Unit Price بحيث يتوافق الإجمالي. |
| PAE-BR-12 | معدل ضريبة Xero غير مطابق لفئة PINT-AE. | تراست بل ← Settings ← Tax Mapping. اربط كل معدل ضريبة Xero (5% VAT on Income، 0% Zero Rated، No VAT، إلخ) بفئة PINT-AE (S / Z / E / O). |
| PAE-BR-14 | العملة ليست AED ولا يوجد مرجع سعر FX مُقدّم. | في Xero، تأكد من ضبط Currency و Exchange Rate للفاتورة قبل المزامنة إلى تراست بل. |
| PAE-BR-21 | الإشعار الدائن يفتقر إلى مرجع فاتورة أم صالح. | في Xero، أنشئ الإشعار الدائن عبر الفاتورة المصدر ← Invoice Options ← Add Credit Note بحيث يتم ضبط التخصيص. لا تُنشئه مستقلاً. |
| PAE-BR-22 | فاتورة الدفعة المقدمة غير مرتبطة باستردادها. | اضبط حقل Reference لفاتورة الاسترداد إلى UUID فاتورة الدفعة المقدمة (أو استخدم فئة تتبع باسم AdvanceUUID). |
| PAE-BR-31 | علم المنطقة الحرة مُعلّم لكن رمز مكان التوريد غير موجود. | في Xero، اضبط عنوان جهة الاتصال إلى عنوان المنطقة الحرة ومكّن فئة التتبع FreeZone. |
ميزات رئيسية لمستخدمي Xero
تكامل Xero في تراست بل مصمم لطريقة عمل مستخدمي Xero بالفعل:
- **التوافق مع التغذية البنكية** — تبقى الفواتير في Xero؛ نقرأ نفس السجلات التي يراجعها محاسبك. - **جاهز للشركات الصغيرة والمتوسطة** — مبني للشركات الصغيرة والمتوسطة المدارة من المحاسبين أو المؤسسين التي تحتاج مسارًا بسيطًا لامتثال الهيئة. - **دعم العملات المتعددة** — فواتير Xero متعددة العملات تُحوّل إلى قيم معادلة بالدرهم الإماراتي مع الحفاظ على العملة الأصلية في حمولة PINT-AE. - **ضريبة القيمة المضافة 5%** — تعيين مباشر للإمدادات الخاضعة للنسبة القياسية 5%، والمعفاة، والصفرية. - **تكامل VAT 201** — تملأ الفواتير المرسلة مسودة VAT 201 في تراست بل للتقديم عبر EmaraTax. - **تتبع الحالة** — راقب كل فاتورة من معلقة إلى مقبولة أو مرفوضة أو مسلّمة على شبكة Peppol. - **معالجة الأخطاء** — تُعاد مشاكل التحقق مع توضيحات على مستوى الحقل وإصلاحات مقترحة. - **إقامة البيانات** — تُشفّر بيانات الفاتورة وتُستضيف في الإمارات (AWS me-central-1).
الأمان ووصول OAuth
تستخدم تراست بل تدفق OAuth 2.0 الرسمي من Xero. نطلب أذونات قراءة فقط لتسحب بيانات الفواتير وجهات الاتصال والضرائب والحسابات. لا نطلب أذونات لإنشاء أو تعديل أو حذف أو معالجة المدفوعات في Xero. جميع الاتصالات بين Xero وتراست بل تستخدم TLS 1.3، وتُشفّر البيانات في حالة التخزين، ولا تُخزّن بيانات اعتماد Xero. تُعالج وتُخزّن بيانات الفواتير في الإمارات.
الأسئلة الشائعة
هل يدعم Xero الفوترة الإلكترونية في الإمارات أصليًا؟
لا. حتى عام 2026، لا يحتوي Xero على وحدة PINT-AE أصلية للإمارات أو إرسال مباشر إلى الهيئة الاتحادية للضرائب. تحتاج الشركات التي تستخدم Xero إلى موصل ASP معتمد من الهيئة مثل تراست بل لتحويل الفواتير والإبلاغ عنها.
كم يستغرق إعداد فوترة Xero الإلكترونية؟
يستغرق معظم الإعدادات من 15 إلى 30 دقيقة. إذا كانت بيانات الرقم الضريبي ومعدلات الضريبة والبيانات الأساسية للعملاء صحيحة في Xero، يمكنك البدء بإرسال فواتير PINT-AE في نفس اليوم.
هل تساعد تراست بل في الإبلاغ عن VAT 201؟
نعم. تُجمّع بيانات الفواتير الإلكترونية المرسلة في مسودة VAT 201 في تراست بل، مرتبة حسب الإمارة ومعدل ضريبة القيمة المضافة ونوع الإمداد. ما زلت تقدم الإقرار النهائي عبر EmaraTax، لكن الأرقام مملوءة مسبقًا من تدفق الفواتير المباشر.
كيف تُحفظ بيانات Xero الخاصة بي آمنة؟
تتصل تراست بل بـ Xero عبر تكامل OAuth 2.0 للقراءة فقط، وتستخدم TLS 1.3 أثناء النقل، وتشفر البيانات في حالة التخزين. لا نخزّن كلمات مرور Xero أو بيانات الدفع، وتبقى بيانات الفواتير في الإمارات.
هل يعمل هذا مع فواتير Xero متعددة العملات؟
نعم. تقرأ تراست بل المبلغ الأصلي بالعملة الأجنبية والقيمة بالدرهم الإماراتي من Xero، ثم تستخدم كليهما في حمولة PINT-AE للحفاظ على توافق سجلاتك مع إرسال الهيئة.