تكامل Oracle NetSuite

الفوترة الإلكترونية في الإمارات لـ Oracle NetSuite

تربط تراست بل حساب NetSuite لديك بشبكة الفوترة الإلكترونية للهيئة الاتحادية للضرائب عبر Microvista Technologies، وهو مزوّد خدمة معتمد من الهيئة. ابدأ بتصدير بسيط، أو أرسل الفواتير تلقائيًا من NetSuite. لا حاجة إلى هجرة النظام.

اقرأ الدليل الفني تواصل معنا

كيف تتصل تراست بل بـ Oracle NetSuite

NetSuite منتج سحابي، لذلك لا يحتاج إلى بوابة أو وكيل على جهاز محلي. تستلم تراست بل فواتير المبيعات وإشعارات الدائنة، وتتحقق منها وفق قواعد الهيئة، وتحوّلها إلى PINT-AE، وترسلها عبر مزوّد خدمة معتمد على شبكة Peppol، ثم تعيد إليك FTA UUID والحالة.

هناك ثلاث طرق لتغذية تراست بل بفواتير NetSuite. التصدير والرفع يعمل اليوم دون تثبيت أي شيء. والإرسال من NetSuite، عبر سكربت في حسابك أو عبر منصة التكامل لديك مثل Celigo أو Boomi أو Workato، يعمل اليوم أيضًا من خلال Partner API في تراست بل. أما الموصّل الأصلي الذي يسحب من NetSuite فيُحدَّد نطاقه لكل عميل عند الطلب. ولا نصفه بأنه متاح عمومًا.

أي طريقة تناسب حساب NetSuite لديك

الخيار A، التصدير والرفع: يصدّر Saved Search الفواتير المرحّلة إلى CSV أو Excel، وترفع الملف إلى تراست بل. يحتاج إلى ساعات للإعداد ويناسب التجارب الأولية والأحجام الصغيرة.

الخيار B، الإرسال من NetSuite: يرسل سكربت أو مسار تكامل كل فاتورة معتمدة إلى تراست بل ويكتب FTA UUID والحالة في الفاتورة. يستغرق عادةً من أسبوع إلى أسبوعين من وقت مطوّر NetSuite أو الشريك ويناسب معظم الحسابات متوسطة الحجم.

الخيار C، الموصّل الأصلي بالسحب: تقرأ تراست بل الفواتير من NetSuite عبر خدمات REST و SuiteQL باستخدام OAuth 2.0 أو المصادقة بالرمز المميّز. يُتفق على النطاق والجدول الزمني والسعر بعد إجابتك عن استبيان NetSuite القصير.

دليل الإعداد

1. اختر الخيار — أجب عن استبيان NetSuite إن لم تكن متأكدًا وسنرد بتوصية. 2. عبّئ الأرقام الضريبية — خزّن الرقم الضريبي من 15 رقمًا لكل عميل ولكل شركة تابعة في الإمارات. 3. عيّن الرموز الضريبية — اربط كل رمز ضريبي تستخدمه في NetSuite بفئة PINT-AE: S أو Z أو E أو O أو RC. 4. أنشئ حقول الحالة — أضف حقول حالة FTA ومعرّف UUID وسبب الرفض إلى الفواتير وإشعارات الدائنة (الخياران B و C). 5. اختبر في البيئة التجريبية — نفّذ حالات اختبار القبول من الدليل الفني بفواتير نموذجية. 6. ابدأ التشغيل — انتقل إلى بيانات الاعتماد الفعلية وارفع الحجم تدريجيًا خلال الأيام الأولى.

يحتوي الدليل الفني على تفاصيل الواجهة كاملة، وهيكل سكربت، وإجراء الإشعار الموقّع، وقائمة اختبار القبول.

امتثال PINT-AE لفواتير NetSuite

يخزّن NetSuite الفواتير في بنية سجلات خاصة به تختلف عن ملف PINT-AE UBL. تحوّل تراست بل كل حقل تطلبه الهيئة: رقم الفاتورة وتاريخها، والرقم الضريبي للبائع والمشتري، وتفاصيل البنود، وفئة ضريبة القيمة المضافة ونسبتها، والمؤشرات الخاصة بالإمارات مثل المنطقة الحرة والاحتساب العكسي.

يجري التحقق من كل فاتورة محوَّلة قبل الإرسال، فتُلتقط مشكلات مثل غياب الرقم الضريبي للمشتري أو رمز ضريبي غير معيَّن أو مجموع بند غير متطابق، وتُبلَّغ بسبب واضح بدلًا من رفضها لاحقًا من الشبكة. وتعود حالات الرفض كحالة يمكنك كتابتها في فاتورة NetSuite.

تعيين حقل NetSuite ← PINT-AE

التعيين الذي تطبّقه تراست بل عند تحويل معاملة NetSuite إلى PINT-AE. تظهر معرّفات حقول NetSuite القياسية؛ أما الحقول المخصصة مثل custentity_trn فهي أمثلة، لأن كل حساب يسمّي حقوله بنفسه.

حقل NetSuite	حقل PINT-AE / UBL 2.1	ملاحظة
transaction.tranid (Document Number)	cbc:ID	يجب أن يكون فريدًا لكل رقم ضريبي.
transaction.trandate	cbc:IssueDate	تاريخ ISO. يجب ألا يكون في المستقبل.
حقل التسجيل الضريبي للعميل أو custentity_trn	cac:AccountingCustomerParty/cac:PartyTaxScheme/cbc:CompanyID	الرقم الضريبي للمشتري، 15 رقمًا. مطلوب لفواتير B2B في الإمارات.
رقم التسجيل الضريبي للشركة التابعة (OneWorld)	cac:AccountingSupplierParty/cac:PartyTaxScheme/cbc:CompanyID	رقمك الضريبي. واحد لكل شركة تابعة تحمل رقمًا ضريبيًا.
وصف البند / اسم الصنف المعروض	cac:Item/cbc:Name أو cbc:Description	UTF-8؛ النص العربي مدعوم.
كمية البند × السعر	cbc:InvoicedQuantity, cac:Price/cbc:PriceAmount, cbc:LineExtensionAmount	السعر غير شامل الضريبة.
رمز ضريبة البند (SuiteTax أو التقليدي)	cac:ClassifiedTaxCategory (S = 5%, Z = 0%, E = معفى, O = خارج النطاق, RC = احتساب عكسي)	يجب أن يقابل كل رمز ضريبي في NetSuite فئة واحدة.
عملة المعاملة، exchangerate	cbc:DocumentCurrencyCode	AED للمحلي. غير AED يحتاج إلى سعر الصرف.
total، taxtotal	cac:LegalMonetaryTotal/cbc:PayableAmount	تُطابَق مع مجاميع البنود مع الضريبة.
حقل مخصص للمنطقة الحرة في العميل	مؤشر ملحق؛ تُشتق فئة الضريبة	يُضبط مرة واحدة في سجل العميل.
credit memo createdfrom	cbc:InvoiceTypeCode="381"; cac:BillingReference/cac:InvoiceDocumentReference	أنشئ إشعارات الدائنة من الفاتورة ليرتبط الأصل بها.

أخطاء التحقق الشائعة من NetSuite إلى PINT-AE

أخطاء التحقق التي تواجهها فواتير NetSuite في الغالب، وما يجب تصحيحه في NetSuite. تعيد تراست بل هذه الرموز في لوحة التحكم وعبر إشعار الحالة.

رمز الخطأ	المعنى	التصحيح في NetSuite
PAE-BR-01	الرقم الضريبي للمشتري مفقود أو غير صحيح.	سجل العميل: أدخل الرقم الضريبي من 15 رقمًا في حقل التسجيل الضريبي أو في الحقل المخصص للرقم الضريبي.
PAE-BR-04	الرقم الضريبي للبائع مفقود.	OneWorld: أدخل رقم التسجيل الضريبي في الشركة التابعة. شركة واحدة: في سجل معلومات الشركة.
PAE-BR-11	مجموع البند لا يساوي الكمية × السعر.	صحّح التقريب في الكمية أو السعر ليتطابق البند. افحص إعدادات التقريب في الصنف إن تكرر.
PAE-BR-12	رمز ضريبي غير معيَّن إلى فئة PINT-AE.	عيّن كل رمز ضريبي في NetSuite إلى S أو Z أو E أو O أو RC في إعدادات تراست بل ثم تعيين الضرائب.
PAE-BR-14	العملة ليست AED ولم يُزوَّد سعر الصرف.	تأكد من وجود العملة وسعر الصرف في الفاتورة. افحص أسعار العملات لتاريخ الفاتورة.
PAE-BR-21	إشعار الدائنة بلا فاتورة أصلية صالحة.	أنشئ إشعار الدائنة من الفاتورة (Actions ثم Credit) بدلًا من إنشائه كسجل مستقل.
PAE-BR-31	مؤشر المنطقة الحرة مفعّل دون عنوان توريد داخل المنطقة.	اضبط حقل المنطقة الحرة في العميل وتأكد أن عنوان الشحن داخل المنطقة الحرة.

OneWorld والشركات التابعة وتعدد الأرقام الضريبية

تصبح كل شركة تابعة في NetSuite تحمل رقمًا ضريبيًا إماراتيًا كيانًا قانونيًا مستقلًا في تراست بل ببيانات اعتماد خاصة بها، ويختار مسارك الكيان الصحيح بحسب الشركة التابعة. أما المجموعة الضريبية في الإمارات فتستخدم رقم المجموعة الضريبي كرقم للبائع في فواتير الأعضاء؛ أكّد المعالجة مع مستشارك الضريبي. الشركات التابعة خارج الإمارات لا تُربط.

الأسعار والجدول الزمني

يمكن بدء التصدير والرفع في اليوم نفسه. يستغرق الإرسال من NetSuite عادةً من أسبوع إلى أسبوعين من وقت مطوّر NetSuite. ويُحدَّد نطاق الموصّل الأصلي بعد الاستبيان، مع تأكيد الجدول الزمني والسعر بالبريد الإلكتروني.

الأسعار المنشورة لتكاملات الأنظمة موجودة في صفحة أسعار تكامل الأنظمة، وخطط رصيد الفواتير في صفحة الأسعار.

الأسئلة الشائعة

هل Oracle NetSuite سحابي أم محلي؟

NetSuite سحابي فقط. المنتجات المحلية من Oracle هي E-Business Suite وJD Edwards. أما Oracle Fusion Cloud ERP فمنتج سحابي مستقل وله دليله الخاص.

هل لدى تراست بل موصّل أصلي لـ NetSuite؟

ليس كمنتج متاح عمومًا اليوم. يمكنك الربط الآن بالتصدير والرفع، أو بإرسال الفواتير من NetSuite عبر سكربت أو منصة تكامل. أما الموصّل الأصلي فيُحدَّد نطاقه لكل عميل عند الطلب.

هل أحتاج إلى تثبيت أي شيء في NetSuite؟

لا حاجة إلى SuiteApp. التصدير والرفع لا يتطلب تثبيت شيء. والإرسال من NetSuite يستخدم سكربتات أو مسارات تعمل في حسابك أنت.

أين أحتفظ بالرقم الضريبي للعميل في NetSuite؟

في حقل التسجيل الضريبي في سجل العميل أو في حقل مخصص. يجب أن يكون 15 رقمًا. يسأل الاستبيان عن مكان حفظه لنتمكن من تعيينه.

هل تتعاملون مع عدة شركات تابعة بأرقام ضريبية مختلفة؟

نعم. كل شركة تابعة تحمل رقمًا ضريبيًا إماراتيًا هي كيان قانوني مستقل في تراست بل ببيانات اعتماد خاصة بها.

ماذا يحدث إذا رُفضت فاتورة؟

تعيد تراست بل حالة رفض مع السبب. يمكنك كتابتها في فاتورة NetSuite، ثم تصحيح السبب وإعادة الإرسال، أو إصدار إشعار دائنة حيث تتطلب القواعد ذلك.

هل هو آمن؟

تستخدم الطلبات HTTPS مع زوج مفاتيح وسرّ خاص بكل كيان، والإشعارات موقّعة. نطلب فقط دور تكامل بأقل الصلاحيات في NetSuite، ولا نطلب كلمات المرور عبر نموذج الطلب أبدًا.