تكامل Sage
فوترة Sage الإلكترونية في الإمارات: تكامل PINT-AE مع الهيئة 2026
تراست بل تربط Sage بشبكة الفوترة الإلكترونية لهيئة الضرائب. لا ترسل Sage فواتير PINT-AE أصليًا، لذا يقوم موصلنا باستخراج بيانات الفاتورة وتحويلها إلى تنسيق PINT-AE المكون من 51 حقلًا، ثم إرسالها عبر مزود خدمة معتمد من الهيئة.
كيف تتكامل تراست بل مع Sage
لا تتضمن إصدارات Sage المحاسبية و ERP إرسالًا أصليًا للهيئة الاتحادية للضرائب. تضيف تراست بل طبقة موصل تقرأ بيانات الفاتورة من Sage 50cloud أو Sage Business One أو Sage X3، وتتحقق منها مقابل قواعد الفوترة الإلكترونية في الإمارات، وتحولها إلى PINT-AE XML. ثم يُرسل الموصل الفاتورة عبر مزود خدمة معتمد على شبكة Peppol ذات النموذج الخماسي: المورد، مزود خدمة المورد، مزود خدمة المشتري، المشتري، والهيئة الاتحادية للضرائب.
إصدارات Sage المدعومة في الإمارات
تدعم تراست بل عائلات منتجات Sage الأكثر استخدامًا في الإمارات:
- **Sage 50cloud** — حزبة محاسبية هجينة لأجهزة سطح المكتب والسحابة للشركات الصغيرة والمتوسطة. تربط تراست بل بيانات Sage وتُرسل فواتير PINT-AE دون استبدال إعداداتك الحالية. - **Sage Business One** — حل موحد لإدارة الأعمال للشركات الصغيرة والمتوسطة النامية. نستخرج فواتير الحسابات المدينة والإشعارات الدائنة ونربطها بالحقول الإلزامية للهيئة. - **Sage X3** — الإصدار المؤسسي للشركات الكبيرة أو متعددة الكيانات. تتعامل تراست بل مع حجم كبير من الفواتير وتسجيلات ضريبة القيمة المضافة متعددة وسيناريوهات أكواد الضرائب المعقدة.
الامتثال لـ PINT-AE لفواتير Sage
يجب إصدار الفواتير الإلكترونية في الإمارات وإرسالها واستلامها بتنسيق XML منظم وفقًا لمواصفات Peppol PINT-AE. يحتوي قاموس بيانات الهيئة على 51 حقلًا إلزاميًا، بما في ذلك UUID الفاتورة، وتاريخ الإصدار، و TRN للبائع والمشتري، وتفاصيل بنود السطر، ومعدلات ضريبة القيمة المضافة، والمؤشرات المحددة للإمارات مثل المنطقة الحرة ومؤشرات نظام الهامش. تحول تراست بل تلقائيًا بيانات فاتورة Sage إلى هذه الحقول وتتحقق من كل مستند قبل الإرسال.
تعيين حقل Sage ← PINT-AE
التعيين الدقيق الذي يطبّقه تراست بل عند تحويل تصدير Sage أو حمولة SData إلى PINT-AE XML. أسماء الحقول أدناه تستخدم اصطلاحات Sage Business One / Sage X3؛ Sage 50cloud يُطابق 1:1 عبر نفس واجهة OData. احتفظ بهذا الجدول قبل تكوين أكواد الضرائب وبيانات الشركاء التجاريين الرئيسية.
| حقل Sage | حقل PINT-AE / UBL 2.1 | ملاحظة |
|---|---|---|
| OINV.DocNum (Business One) / SINVOICE.NUM (X3) | cbc:ID | رقم فاتورتك. يجب أن يكون فريدًا عبر جميع الإرساليات. |
| OINV.DocDate / SINVOICE.INVDAT | cbc:IssueDate | تاريخ ISO. لا يجب أن يكون في المستقبل. |
| OCRD.LicTradNum (TRN المشتري) | cac:AccountingCustomerParty/cac:PartyTaxScheme/cbc:CompanyID | TRN المشتري — 15 رقمًا. اضبطه على البيانات الرئيسية للشريك التجاري. |
| OADM.CompanyGSTRegNo / TRN شركة X3 | cac:AccountingSupplierParty/cac:PartyTaxScheme/cbc:CompanyID | TRN الخاص بك. اضبطه مرة في Company Details. |
| INV1.Dscription | cac:InvoiceLine/cbc:Description أو cac:Item/cbc:Name | نص بند السطر. UTF-8؛ الأحرف العربية مدعومة في Sage X3 v11+. |
| INV1.Quantity × INV1.Price | cbc:LineExtensionAmount, cbc:BaseQuantity, cac:Price/cbc:PriceAmount | PINT-AE يُعيد بناء إجمالي البند من الكمية × السعر. |
| INV1.VatGroup / كود معدل ضريبة X3 | cac:ClassifiedTaxCategory (S=5%, Z=0%, E=معفى, O=خارج النطاق) | مجموعة ضريبة القيمة المضافة في Sage يجب أن تُطابق فئة PINT-AE عبر Tax Mapping في تراست بل. |
| OINV.DocCurrency | cbc:DocumentCurrencyCode | AED للمحلي؛ غير AED يحتاج تعبئة سعر FX على الفاتورة. |
| OINV.DocTotal | cac:LegalMonetaryTotal/cbc:PayableAmount | مُطابق مع إجماليات البنود + الضرائب؛ عدم تطابق = فشل تحقق. |
| OCRD.U_FreeZone (UDF) | علم namespace امتداد؛ فئة الضريبة مُشتقة | أنشئ الحقل المعرّف من المستخدم مرة على البيانات الرئيسية للشريك التجاري. |
| OINV.U_AdvanceUUID (UDF) | cac:DocumentReference لربط الدفعة المقدمة (النوع 386) | عبّئ على أي فاتورة تسترد دفعة مقدمة سابقة. |
| ORIN.BaseEntry (المذكرة الائتمانية ← الفاتورة المصدر) | cbc:InvoiceTypeCode="381"؛ cac:BillingReference/cac:InvoiceDocumentReference | المذكرة الائتمانية في Sage يجب أن ترتبط بـ DocEntry الفاتورة المصدر. |
أخطاء التحقق الشائعة Sage ← PINT-AE
أكثر ثمانية أخطاء تحقق تُصادَف عندما تفشل فاتورة Sage في فحوصات PINT-AE، وما يجب إصلاحه بالضبط في Sage لتصفيتها. لوحة تحكم تراست بل تُظهر هذه الرموز بتفسيرات واضحة؛ الجدول أدناه هو النسخة المرجعية.
| رمز الخطأ | المعنى | الإصلاح في Sage (Business One / X3 / 50cloud) |
|---|---|---|
| PAE-BR-01 | TRN المشتري مفقود أو غير صحيح. | Sage ← Business Partner Master Data ← تحرير ← اضبط Federal Tax ID / LicTradNum إلى TRN من 15 رقمًا. |
| PAE-BR-04 | TRN البائع مفقود. | Sage ← Administration ← System Initialization ← Company Details ← اضبط Federal Tax ID. |
| PAE-BR-11 | عدم تطابق إجمالي البند (كمية × سعر ≠ إجمالي البند). | في مستند التسويق، حرّر الصف وصحّح التقريب على Quantity أو Price بحيث يتوافق الإجمالي. |
| PAE-BR-12 | مجموعة ضريبة Sage غير مطابقة لفئة PINT-AE. | تراست بل ← Settings ← Tax Mapping. اربط كل مجموعة ضريبة Sage بفئة PINT-AE (S / Z / E / O). |
| PAE-BR-14 | العملة ليست AED ولا يوجد مرجع سعر FX مُقدّم. | في فاتورة Sage، تأكد من تعبئة حقل Rate على الرأس لعملة المستند قبل الترحيل. |
| PAE-BR-21 | الإشعار الدائن يفتقر إلى مرجع فاتورة أم صالح. | في Sage، أنشئ المذكرة الائتمانية بالنقر بزر الماوس الأيمن على الفاتورة المصدر ← Copy To ← Credit Memo. لا تُنشئها مستقلة. |
| PAE-BR-22 | فاتورة الدفعة المقدمة غير مرتبطة باستردادها. | عبّئ UDF U_AdvanceUUID لفاتورة الاسترداد بـ UUID فاتورة الدفعة المقدمة قبل الترحيل. |
| PAE-BR-31 | علم المنطقة الحرة مُعلّم لكن رمز مكان التوريد غير موجود. | في بيانات الشريك التجاري الرئيسية، اضبط UDF U_FreeZone وتأكد من أن عنوان الشحن في المنطقة الحرة. |
وقت الإعداد ومسار النشر
عادةً ما يتم تكوين معظم تكاملات Sage خلال يوم عمل واحد. مسار العمل النموذجي هو:
1. **أنشئ حساب تراست بل** — سجل مجانًا وأدخل TRN الخاص بعملك. 2. **اربط Sage** — ثبّت موصل تراست بل لإصدار Sage الخاص بك واسمح بالوصول للقراءة فقط. 3. **اربط أكواد الضرائب** — اربط أكواد ضريبة القيمة المضافة في Sage بتصنيفات PINT-AE (المعدل العادي، الصفر، المعفى، الاحتساب العكسي، نظام الهامش). 4. **اختبر فاتورة نموذجية** — أنشئ فاتورة اختبار في Sage وتأكد من أن تراست بل تحقق منها بنجاح. 5. **انطلق** — تتم مزامنة الفواتير تلقائيًا في الخلفية وإرسالها إلى شبكة الهيئة.
لا حاجة لترقية Sage أو استبدال نظام ERP.
أمان البيانات وربط أكواد الضرائب
تطلب تراست بل الحد الأدنى من وصول القراءة اللازم لاستخراج بيانات الفواتير والإشعارات الدائنة. لا نقوم بإنشاء أو تعديل أو حذف معاملات داخل Sage. يستخدم كل المرور TLS 1.3، وتُشفّر البيانات في حالة التخزين، وتحفظ بيانات الضرائب داخل الإمارات. يتم ربط أكواد الضرائب مرة واحدة أثناء التسجيل، ثم يطبق الموصل هذا الربط باستمرار على كل فاتورة، مما يمنع الرفض الناتج عن معالجة ضريبة القيمة المضافة غير الصحيحة.
الأسئلة الشائعة
ما هي إصدارات Sage المدعومة؟
تدعم تراست بل Sage 50cloud و Sage Business One و Sage X3. يعمل Sage 50cloud عبر موصل هجيب محلي أو سحابي، بينما يتم ربط Business One و X3 عادةً عبر API أو وكيل آمن على الموقع.
هل Sage 50cloud مدعوم؟
نعم. Sage 50cloud منتج هجين ومدعوم بالكامل. تقرأ تراست بل بيانات الفاتورة من ملف شركة Sage 50cloud وتُرسل PINT-AE XML متوافق دون إجبارك على الهجرة الكاملة إلى السحابة.
كم يستغرق الإعداد؟
معظم الشركات تصبح جاهزة خلال يوم عمل واحد. الخطوة الأطيلة عادةً هي ربط أكواد الضرائب، التي تُكتمل باستخدام قائمة المراجعة الخاصة بنا وقوالب Sage إلى PINT-AE المعبأة مسبقًا.
هل بيانات Sage آمنة؟
نعم. تستخدم تراست بل وصولًا للقراءة فقط، و TLS 1.3 أثناء النقل، و AES-256-GCM في حالة التخزين. لا يتم تعديل بيانات شركة Sage أبدًا، وتُخزن بيانات الفواتير في مراكز بيانات الإمارات.
كيف يعمل ربط أكواد الضرائب؟
ترتبط تراست بل كل كود ضريبة في Sage بتصنيف ضريبة PINT-AE المكافئ، مثل المعدل العادي، أو الصفر، أو المعفى، أو الاحتساب العكسي، أو نظام الهامش. يتم التحقق من هذا الربط أثناء التسجيل وتطبيقه تلقائيًا على كل فاتورة.