تكامل SAP
الفوترة الإلكترونية في الإمارات لـ SAP — تكامل API للمؤسسات
تربط تراست بل نظام SAP بشبكة الفوترة الإلكترونية للهيئة الاتحادية للضرائب عبر Microvista Technologies. تكامل API أولاً لـ SAP Business One، S/4HANA، وحلول SAP الأخرى. لا حاجة لهجرة ERP.
كيف تتكامل تراست بل مع SAP
ترتبط تراست بل بـ SAP عبر تكامل REST API، وتسحب بيانات الفاتورة تلقائيًا من نظام SAP الخاص بك. التكامل يدعم جميع أنواع فواتير SAP: فواتير المبيعات، وإشعارات الدائنة، وإشعارات المدين، والفواتير الأولية. بمجرد الاتصال، كل فاتورة تنشئها في SAP تتم مزامنتها مع تراست بل في الوقت الفعلي، وتحويلها إلى تنسيق PINT-AE XML، والتحقق من صحتها ضد متطلبات الهيئة، وإرسالها إلى شبكة مزود الخدمة المعتمد.
تكامل API مصمم لبيئات المؤسسات مع أمان قوي، ومعالجة الأخطاء، والمراقبة. توفر تراست بل وثائق API شاملة، SDKs، ودعم تقني مخصص لتنفيذات SAP. يعمل التكامل مع SAP Business One، SAP S/4HANA، SAP ERP/ECC، وحلول SAP الأخرى المنشورة محليًا أو في السحابة.
دليل الإعداد للمؤسسات
إعداد تكامل SAP API يستغرق عادة 2-4 أسابيع حسب تكوين SAP الخاص بك:
1. **أنشئ حساب تراست بل** — سجل واحصل على بيانات اعتماد API. 2. **مراجعة وثائق API** — راجع وثائق REST API ودليل تكامل SAP من تراست بل. 3. **تكوين برمجيات SAP الوسيطة** — ضبط برمجيات SAP الوسيطة (PI/PO، CPI، أو ABAP مخصص) لاستدعاء APIs تراست بل. 4. **تعيين البيانات** — اربط حقول فواتير SAP بمخطط PINT-AE من تراست بل. 5. **الاختبار في sandbox** — اختبر التكامل في بيئة sandbox من تراست بل مع فواتير نموذجية. 6. **البدء في الإنتاج** — قم بالتبديل إلى بيانات اعتماد الإنتاج وتمكين الإرسال في الوقت الفعلي.
توفر تراست بل دعمًا تقنيًا مخصصًا طوال عملية التنفيذ، بما في ذلك اختبار API، مساعدة تعيين البيانات، ودعم البدء.
امتثال PINT-AE لفواتير SAP
تحول تراست بل تلقائيًا بيانات فواتير SAP إلى تنسيق PINT-AE XML، معيار الفوترة الإلكترونية الوطني في الإمارات. التحويل يتعامل مع جميع عناصر البيانات المطلوبة: UUID للفاتورة، تاريخ الإصدار، TRN البائع/المشتري، تفاصيل بنود السطر، معدلات ضريبة القيمة المضافة، والحقول المحددة للإمارات مثل أعلام المنطقة الحرة ومؤشرات نظام الهامش.
يخزن SAP بيانات الفاتورة بتنسيقه الخاص، الذي يختلف عن متطلبات PINT-AE. محرك التحويل في تراست بل يحول هياكل بيانات SAP إلى مواصفات PINT-AE، يضمن ملء كل حقل بشكل صحيح. يتحقق النظام من كل فاتورة محولة ضد 51 عنصر بيانات إلزامي للهيئة قبل الإرسال، يلتقط أخطاء مثل TRNs المفقودة، معدلات ضريبة القيمة المضافة غير الصالحة، أو تفاصيل بنود السطر غير المكتملة. يتم الإبلاغ عن أخطاء التحقق عبر استدعاءات API وفي لوحة تحكم تراست بل، مما يسمح لنظام SAP بالتعامل مع التصحيحات برمجيًا.
تعيين حقل SAP ← PINT-AE
التعيين الدقيق الذي يطبّقه تراست بل عند تحويل مستند فوترة SAP إلى PINT-AE XML. أسماء الحقول أدناه تستخدم اصطلاحات جداول SAP القياسية (VBRK/VBRP لـ S/4HANA و ECC؛ OINV/INV1 لـ Business One). نفس التعيين يعمل سواء كان المصدر استدعاء BAPI، أو iDoc، أو واجهة OData للفوترة في S/4HANA. احتفظ بهذا الجدول قبل توصيل iFlow في CPI أو قناة PI/PO.
| حقل SAP | حقل PINT-AE / UBL 2.1 | ملاحظة |
|---|---|---|
| VBRK-VBELN (S/4HANA / ECC) / OINV.DocNum (B1) | cbc:ID | رقم مستند الفوترة. يجب أن يكون فريدًا عبر جميع الإرساليات. |
| VBRK-FKDAT / OINV.DocDate | cbc:IssueDate | تاريخ ISO. لا يجب أن يكون في المستقبل. |
| KNA1-STCEG (رقم تسجيل VAT للعميل) | cac:AccountingCustomerParty/cac:PartyTaxScheme/cbc:CompanyID | TRN المشتري — 15 رقمًا. عبّئ STCEG على سجل KNA1 مع الدولة AE. |
| T001-STCEG (تسجيل VAT لكود الشركة) | cac:AccountingSupplierParty/cac:PartyTaxScheme/cbc:CompanyID | TRN الخاص بك. اضبطه مرة لكل كود شركة عبر SPRO. |
| VBRP-ARKTX / INV1.Dscription | cac:InvoiceLine/cbc:Description أو cac:Item/cbc:Name | نص بند السطر. UTF-8؛ الأحرف العربية مدعومة بعد تثبيت خطوط Unicode. |
| VBRP-FKIMG × KOMV-KBETR / INV1.Quantity × Price | cbc:LineExtensionAmount, cbc:BaseQuantity, cac:Price/cbc:PriceAmount | PINT-AE يُعيد بناء إجمالي البند من الكمية × السعر. |
| KOMV / T007A كود الضريبة ← معدل الضريبة | cac:ClassifiedTaxCategory (S=5%, Z=0%, E=معفى, O=خارج النطاق) | شرط MWST وكود الضريبة في SAP يجب أن يُطابق فئة PINT-AE عبر Tax Mapping في تراست بل. |
| VBRK-WAERK / OINV.DocCurrency | cbc:DocumentCurrencyCode | AED للمحلي؛ غير AED يحتاج تعبئة معدل تحويل الرأس (VBRK-KURRF). |
| VBRK-NETWR + KWSTE (الإجمالي) | cac:LegalMonetaryTotal/cbc:PayableAmount | مُطابق مع إجماليات البنود + الضرائب؛ عدم تطابق = فشل تحقق. |
| بيانات العميل الرئيسية ZZFREEZONE (حقل Z أو تصنيف) | علم namespace امتداد؛ فئة الضريبة مُشتقة | وحّد على قيمة حقل Z أو تصنيف KLAH؛ تراست بل يقرأ أيًا منهما. |
| VBRK-XBLNR / OINV.U_AdvanceUUID (مخصص) | cac:DocumentReference لربط الدفعة المقدمة (النوع 386) | عبّئ على أي فاتورة تسترد دفعة مقدمة سابقة. |
| VBRK-FKART="S1" (إلغاء) / ORIN.BaseEntry (ائتمان B1) | cbc:InvoiceTypeCode="381"؛ cac:BillingReference/cac:InvoiceDocumentReference | الإلغاء / المذكرة الائتمانية يجب أن تشير إلى مستند الفوترة الأم عبر VBFA (S/4) أو BaseEntry (B1). |
أخطاء التحقق الشائعة SAP ← PINT-AE
أكثر ثمانية أخطاء تحقق تُصادَف عندما تفشل فاتورة مصدرها SAP في فحوصات PINT-AE، وما يجب إصلاحه بالضبط على جانب SAP لتصفيتها. تُرجع تراست بل هذه الرموز عبر استدعاء API وتُظهرها في لوحة التحكم بتفسيرات واضحة؛ الجدول أدناه هو النسخة المرجعية لفرق ABAP / CPI.
| رمز الخطأ | المعنى | الإصلاح في SAP (S/4HANA / ECC / Business One) |
|---|---|---|
| PAE-BR-01 | TRN المشتري مفقود أو غير صحيح. | SAP ← XD02 (Change Customer) ← اضبط STCEG (رقم تسجيل VAT) إلى TRN من 15 رقمًا. B1 ← Business Partner Master Data ← Federal Tax ID. |
| PAE-BR-04 | TRN البائع مفقود. | SPRO ← General Settings ← Set Up Countries ← عيّن STCEG على كود الشركة T001. B1 ← Company Details ← Federal Tax ID. |
| PAE-BR-11 | عدم تطابق إجمالي البند (كمية × سعر ≠ إجمالي البند). | في VF02 (S/4/ECC)، حرّر إجراء التسعير أو أصلح التقريب على KBETR. B1 ← حقول السعر/الكمية لبند مستند التسويق. |
| PAE-BR-12 | كود ضريبة SAP غير مطابق لفئة PINT-AE. | تراست بل ← Settings ← Tax Mapping. اربط كل كود ضريبة MWST في SAP (V5, VZ, VE، إلخ) بفئة PINT-AE (S / Z / E / O). |
| PAE-BR-14 | العملة ليست AED ولا يوجد مرجع سعر FX مُقدّم. | في VBRK، عبّئ KURRF (سعر الصرف إلى العملة المحلية) قبل الإصدار. B1 ← اضبط Rate على رأس المستند. |
| PAE-BR-21 | الإشعار الدائن يفتقر إلى مرجع فاتورة أم صالح. | في S/4، أنشئ الإلغاءات عبر VF11 أو تصحيحات الفواتير بالإشارة إلى مستند الفوترة الأصلي (VBFA). في B1، استخدم Copy To ← Credit Memo من الفاتورة المصدر. |
| PAE-BR-22 | فاتورة الدفعة المقدمة غير مرتبطة باستردادها. | عبّئ VBRK-XBLNR (المستند المرجعي) أو حقل Z بـ UUID فاتورة الدفعة المقدمة قبل الإصدار. في B1، استخدم UDF U_AdvanceUUID. |
| PAE-BR-31 | علم المنطقة الحرة مُعلّم لكن رمز مكان التوريد غير موجود. | في بيانات العميل الرئيسية، اضبط حقل Z الخاص بـ ZZFREEZONE (أو قيمة تصنيف KLAH) وتأكد من أن عنوان الشحن في المنطقة الحرة. |
ميزات رئيسية لمستخدمي SAP
يتضمن تكامل SAP في تراست بل:
- **REST API** — API شامل لإرسال الفواتير، تتبع الحالة، ومعالجة الأخطاء. - **مزامنة في الوقت الفعلي** — يتم إرسال الفواتير في ثوانٍ بعد الإنشاء في SAP. - **استدعاءات webhook** — استقبل تحديثات الحالة في الوقت الفعلي (مرسل، مقبول، مرفوض) عبر webhooks. - **معالجة الأخطاء** — يتم إرجاع أخطاء التحقق مع أكواد أخطاء واضحة وتفسيرات. - **المعالجة بالجملة** — تعامل مع فوترة عالية الحجم مع دعم API المجموعة. - **إدارة الرفض** — يمكن إصلاح الفواتير المرفوضة في SAP وإعادة إرسالها برمجيًا. - **تكامل VAT 201** — تملأ الفواتير المرسلة مسودة إقرار ضريبة القيمة المضافة 201 تلقائيًا. - **دعم الكيانات المتعددة** — ضبط أكواد شركات SAP متعددة لكيانات مختلفة. - **إقامة البيانات** — جميع بيانات الفاتورة تبقى في الإمارات (AWS me-central-1). - **SLA للمؤسسات** — ضمان وقت تشغيل 99.9% مع دعم مخصص.
التكامل متوافق مع SOC 2 Type II ويدعم SSO للمؤسسات.
تسعير المؤسسات لتكامل SAP
تقدم تراست بل تسعير المؤسسات لعملاء SAP بناءً على حجم الفاتورة ومتطلبات الدعم. تبدأ الخطط من 1,000 درهم شهريًا لـ 5,000 فاتورة، مع تسعير مخصص لأحجام أعلى.
تشمل خطط المؤسسات: - دعم تقني مخصص - وثائق API و SDKs - بيئة اختبار sandbox - SLA وقت تشغيل 99.9% - مساعدة التنفيذ - دعم تعيين البيانات المخصص
اتصل بفريق المبيعات لدينا للحصول على عرض سعر مخصص بناءً على تكوين SAP وحجم الفاتورة الخاص بك.
الأسئلة الشائعة
ما إصدارات SAP المدعومة؟
تدعم تراست بل SAP Business One، SAP S/4HANA، SAP ERP/ECC، وحلول SAP الأخرى. كل من عمليات النشر المحلية والسحابية مدعومة.
هل أحتاج إلى تعديل نظام SAP؟
التغييرات المطلوبة ضئيلة. ستحتاج إلى ضبط برمجيات SAP الوسيطة لاستدعاء APIs تراست بل، لكن لا توجد تغييرات في تكوين SAP الأساسي أو سير العمل ضرورية.
هل التكامل آمن؟
نعم. تستخدم تراست بل OAuth 2.0 لمصادقة API، TLS 1.3 للاتصال المشفر، ومتوافقة مع SOC 2 Type II. جميع البيانات مشفرة أثناء النقل وفي حالة التخزين. بيانات الفاتورة تبقى في الإمارات (AWS me-central-1).
ماذا يحدث إذا تم رفض فاتورة؟
تطلق الفواتير المرفوضة استدعاءات webhook مع تفاصيل الأخطاء. يمكن لنظام SAP التعامل مع التصحيحات وإعادة الإرسال برمجيًا بناءً على هذه الاستدعاءات.
كم يستغرق التنفيذ؟
تنفيذات SAP النموذجية تستغرق 2-4 أسابيع حسب تكوين SAP وتعقيد تعيين البيانات. توفر تراست بل دعمًا تقنيًا مخصصًا طوال العملية.