تكامل QuickBooks Online
الفوترة الإلكترونية في الإمارات لـ QuickBooks Online — لا حاجة للهجرة
تربط تراست بل QuickBooks Online بشبكة الفوترة الإلكترونية للهيئة الاتحادية للضرائب عبر Microvista Technologies. استمر في استخدام QuickBooks كما تفعل اليوم — نحن نتعامل مع تحويل PINT-AE والتوقيع والإرسال تلقائيًا. مباشر في 5 دقائق.
كيف تتكامل تراست بل مع QuickBooks Online
ترتبط تراست بل بـ QuickBooks Online عبر OAuth API، وتسحب بيانات الفاتورة تلقائيًا بدون تصدير يدوي. التكامل يدعم جميع أنواع فواتير QuickBooks Online: فواتير المبيعات، وإشعارات الدائنة، والتقديرات المحولة إلى فواتير. بمجرد الاتصال، كل فاتورة تنشئها في QuickBooks Online تتم مزامنتها مع تراست بل في الوقت الفعلي، وتحويلها إلى تنسيق PINT-AE XML، والتحقق من صحتها ضد متطلبات الهيئة، وإرسالها إلى شبكة مزود الخدمة المعتمد. العملية بالكامل آلية — لا حاجة لتدخل يدوي. يمكنك الاستمرار في استخدام QuickBooks Online لجميع عمليات المحاسبة: الفوترة، وتتبع الدفع، والمصالحة، والتقارير. تعمل تراست بل كطبقة امتثال فوق ذلك، تضمن كل فاتورة صادرة تلبي متطلبات تفويض 2026-2027.
دليل الإعداد في 5 دقائق
إعداد تكامل QuickBooks Online يستغرق أقل من 5 دقائق:
1. **أنشئ حساب تراست بل** — سجل مجانًا (لا حاجة لبطاقة ائتمان). 2. **انتقل إلى المصادر** — اذهب إلى صفحة المصادر في لوحة تحكم تراست بل. 3. **اختر QuickBooks Online** — اختر QuickBooks Online من قائمة تكامل ERP. 4. **أذن الاتصال** — انقر Connect للسماح لتراست بل بالوصول إلى حساب QuickBooks Online عبر OAuth. 5. **قم بتكوين إعدادات المزامنة** — اختر أنواع الفواتير للمزامنة (مبيعات، إشعارات دائنة) واضبط تردد المزامنة (الوقت الفعلي أو كل ساعة). 6. **اختبر الإرسال** — أنشئ فاتورة اختبار في QuickBooks Online وتحقق من ظهورها في تراست بل مع التحقق من PINT-AE.
التكامل يستخدم OAuth 2.0 للمصادقة الآمنة — تراست بل لا تخزن بيانات اعتماد QuickBooks الخاصة بك أبدًا. يمكنك إلغاء الوصول في أي وقت من إعدادات QuickBooks Online.
امتثال PINT-AE لفواتير QuickBooks
تحول تراست بل تلقائيًا فواتير QuickBooks Online إلى تنسيق PINT-AE XML، معيار الفوترة الإلكترونية الوطني في الإمارات. التحويل يتعامل مع جميع عناصر البيانات المطلوبة: UUID للفاتورة، تاريخ الإصدار، TRN البائع/المشتري، تفاصيل بنود السطر، معدلات ضريبة القيمة المضافة، والحقول المحددة للإمارات مثل أعلام المنطقة الحرة ومؤشرات نظام الهامش.
يخزن QuickBooks Online بيانات الفاتورة بتنسيقه الأصلي، الذي يختلف عن متطلبات PINT-AE. محرك التحويل في تراست بل يحول هياكل بيانات QuickBooks إلى مواصفات PINT-AE، يضمن ملء كل حقل بشكل صحيح. يتحقق النظام من كل فاتورة محولة ضد 51 عنصر بيانات إلزامي للهيئة قبل الإرسال، يلتقط أخطاء مثل TRNs المفقودة، معدلات ضريبة القيمة المضافة غير الصالحة، أو تفاصيل بنود السطر غير المكتملة. يتم الإبلاغ عن أخطاء التحقق في لوحة تحكم تراست بل مع تفسيرات واضحة، مما يسمح لك بإصلاح المشكلات في QuickBooks Online وإعادة الإرسال.
تعيين حقل QuickBooks ← PINT-AE
أدناه التعيين الدقيق الذي يطبّقه محرك تراست بل عند تحويل فاتورة QuickBooks Online إلى PINT-AE XML. فرق مالية المؤسسات تُشير إلى هذا الجدول عند مطابقة إعداد QuickBooks مقابل التفويض؛ احتفظ به قبل تكوين رموز الضرائب في QBO والبيانات الرئيسية للعملاء.
| حقل QuickBooks Online | حقل PINT-AE / UBL 2.1 | ملاحظة |
|---|---|---|
| Invoice.DocNumber | cbc:ID | رقم فاتورتك. يجب أن يكون فريدًا عبر جميع الإرساليات. |
| Invoice.TxnDate | cbc:IssueDate | تاريخ ISO. لا يجب أن يكون في المستقبل. |
| Invoice.CustomerRef → Customer.TaxIdentifier | cac:AccountingCustomerParty/cac:PartyTaxScheme/cbc:CompanyID | TRN المشتري — 15 رقمًا. غياب TRN = سبب الرفض رقم 1. |
| CompanyInfo.CompanyName + حقل TRN مخصص | cac:AccountingSupplierParty/cac:PartyTaxScheme/cbc:CompanyID | TRN الخاص بك. اضبطه مرة في تراست بل؛ QBO لا يُخزنه أصليًا. |
| Line.Description | cac:InvoiceLine/cbc:Description أو cac:Item/cbc:Name | نص بند السطر. UTF-8، الأحرف العربية مدعومة. |
| Line.Amount / Line.SalesItemLineDetail.Qty × UnitPrice | cbc:LineExtensionAmount, cbc:BaseQuantity, cac:Price/cbc:PriceAmount | PINT-AE يُعيد بناء إجمالي البند من الكمية × السعر. |
| Line.TaxLineDetail.TaxRateRef | cac:ClassifiedTaxCategory (S=5%, Z=0%, E=معفى, O=خارج النطاق) | رمز ضريبة QBO يجب أن يُطابق فئة PINT-AE قبل الإرسال. |
| Invoice.CurrencyRef | cbc:DocumentCurrencyCode | يجب أن يكون AED إلا لفاتورة FX صالحة — غير AED يُشغّل حقولاً إضافية. |
| Invoice.TotalAmt | cac:LegalMonetaryTotal/cbc:PayableAmount | مُطابق مع إجماليات البنود + الضرائب؛ عدم تطابق = فشل تحقق. |
| Invoice.CustomField "FreeZone" | علم namespace امتداد؛ فئة الضريبة مُشتقة | كوّن الحقل المخصص مرة؛ تراست بل يقرأ عند كل إرسال. |
| Invoice.PrivateNote / CustomField "AdvanceUUID" | cac:DocumentReference لربط الدفعة المقدمة (النوع 386) | إذا كنت تُفوتر مقابل دفعة مقدمة سابقة، عبّئ هذا الحقل. |
| Refund/CreditMemo.LinkedTxn | cbc:InvoiceTypeCode="381"؛ cac:BillingReference/cac:InvoiceDocumentReference | الإشعار الدائن يجب أن يُشير إلى UUID الفاتورة الأصلية، وليس رقمها فقط. |
أخطاء التحقق الشائعة QuickBooks ← PINT-AE
أكثر ثمانية أخطاء تحقق تُصادَف عندما تفشل فاتورة QuickBooks Online في فحوصات PINT-AE، وما يجب إصلاحه بالضبط في QuickBooks Online لتصفيتها. لوحة تحكم تراست بل تُظهر هذه الرموز بتفسيرات واضحة؛ الجدول أدناه هو النسخة المرجعية.
| رمز الخطأ | المعنى | الإصلاح في QuickBooks Online |
|---|---|---|
| PAE-BR-01 | TRN المشتري مفقود أو غير صحيح. | افتح العميل في QBO ← Sales ← Customers ← تحرير ← اضبط حقل Tax Identifier إلى TRN من 15 رقمًا. |
| PAE-BR-04 | TRN البائع مفقود. | اضبط TRN شركتك مرة في تراست بل (Settings ← Company). QBO لا يخزّنه أصليًا. |
| PAE-BR-11 | عدم تطابق إجمالي البند (كمية × سعر ≠ إجمالي البند). | في QBO، حرّر البند: صحّح التقريب على Unit Price أو Qty بحيث يتوافق المبلغ مع بنود الضرائب. |
| PAE-BR-12 | فئة الضريبة غير قابلة للحل — رمز ضريبة QBO غير مُطابق. | تراست بل ← Settings ← Tax Mapping. اربط كل رمز ضريبة QBO بفئة PINT-AE (S / Z / E / O). |
| PAE-BR-14 | العملة ليست AED ولا يوجد مرجع سعر FX مُقدّم. | للفواتير بغير AED، تأكد من ضبط سعر الصرف في رأس فاتورة QBO قبل المزامنة. |
| PAE-BR-21 | الإشعار الدائن يفتقر إلى مرجع فاتورة أم صالح. | في QBO، أنشئ المذكرة الائتمانية عبر Apply Credit ← اربط بالفاتورة الأصلية. لا تُنشئ كوحدة قائمة بذاتها. |
| PAE-BR-22 | فاتورة الدفعة المقدمة غير مرتبطة باستردادها. | أضف UUID فاتورة الدفعة المقدمة إلى الحقل المخصص "AdvanceUUID" لفاتورة الاسترداد قبل إعادة المزامنة. |
| PAE-BR-31 | علم المنطقة الحرة مُعلّم لكن رمز مكان التوريد غير موجود. | اضبط عنوان العميل في QBO إلى عنوان المنطقة الحرة، ومكّن الحقل المخصص FreeZone على الفاتورة. |
ميزات رئيسية لمستخدمي QuickBooks Online
يتضمن تكامل QuickBooks Online في تراست بل:
- **مزامنة في الوقت الفعلي** — تظهر الفواتير في تراست بل في ثوانٍ بعد الإنشاء في QuickBooks Online. - **المعالجة بالجملة** — تعامل مع فوترة عالية الحجم بدون تدخل يدوي. - **معالجة الأخطاء** — يتم تمييز أخطاء التحقق مع تفسيرات واضحة وإصلاحات مقترحة. - **تتبع الحالة** — راقب حالة الإرسال (معلق، مرسل، مقبول، مرفوض) لكل فاتورة. - **إدارة الرفض** — يمكن إصلاح الفواتير المرفوضة في QuickBooks Online وإعادة إرسالها تلقائيًا. - **تكامل VAT 201** — تملأ الفواتير المرسلة مسودة إقرار ضريبة القيمة المضافة 201 تلقائيًا. - **دعم الكيانات المتعددة** — اربط شركات QuickBooks Online متعددة بحساب تراست بل واحد. - **إقامة البيانات** — جميع بيانات الفاتورة تبقى في الإمارات (AWS me-central-1).
التكامل يعمل مع جميع إصدارات QuickBooks Online: Simple Start، Essentials، Plus، و Advanced.
التسعير لتكامل QuickBooks Online
تقدم تراست بل باقة مجانية لمستخدمي QuickBooks Online: 50 فاتورة شهريًا بدون تكلفة، لا حاجة لبطاقة ائتمان. هذا يغطي معظم الشركات الصغيرة التي تختبر الفوترة الإلكترونية قبل موعدها النهائي الإلزامي.
تبدأ الخطط المدفوعة من 200 درهم شهريًا لـ 500 فاتورة، مع تسعير متدرج لأحجام أعلى. الخطط للمؤسسات مع SLA مخصص ودعم مخصص متاحة لشركات المحاسبة التي تدير عملاء QuickBooks Online متعددين.
لا توجد رسوم إعداد أو عقود طويلة الأجل. يمكنك الترقية أو التخفيض في أي وقت. تكامل QuickBooks Online مشمول في جميع الخطط — لا رسوم إضافية.
الأسئلة الشائعة
هل أحتاج إلى تغيير إعداد QuickBooks Online؟
لا. ترتبط تراست بل بحساب QuickBooks Online الحالي الخاص بك بدون الحاجة إلى أي تغييرات في الإعداد الحالي أو سير العمل أو القوالب. تستمر في استخدام QuickBooks Online تمامًا كما تفعل اليوم.
هل بيانات QuickBooks Online آمنة؟
نعم. تستخدم تراست بل OAuth 2.0 للمصادقة الآمنة ولا تخزن بيانات اعتماد QuickBooks الخاصة بك أبدًا. جميع البيانات مشفرة أثناء النقل (TLS 1.3) وفي حالة التخزين (AES-256-GCM). بيانات الفاتورة تبقى في الإمارات (AWS me-central-1).
ماذا يحدث إذا تم رفض فاتورة؟
يتم تمييز الفواتير المرفوضة في لوحة تحكم تراست بل مع تفسيرات أخطاء واضحة. تقوم بإصلاح المشكلة في QuickBooks Online (مثلًا، تصحيح TRN، تعديل معدل ضريبة القيمة المضافة)، وتقوم تراست بل بإعادة إرسال الفاتورة المصححة تلقائيًا.
هل يمكنني ربط شركات QuickBooks Online متعددة؟
نعم. يمكنك ربط شركات QuickBooks Online متعددة بحساب تراست بل واحد، مما يجعله مثاليًا لشركات المحاسبة أو الشركات ذات الكيانات المتعددة.
هل يعمل هذا مع QuickBooks Desktop؟
تكامل QuickBooks في تراست بل مخصص لـ QuickBooks Online. لمستخدمي QuickBooks Desktop، نوصي باستخدام ميزة تصدير Excel/CSV أو تكامل الوكيل المكتبي.