NetSuite

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

قبل البدء

تحتاج إلى مسؤول NetSuite لتنفيذ هذه الخطوات.

1. فعّل الميزات. افتح Setup > Company > Enable Features، وفي تبويب SuiteCloud فعّل REST Web Services، ثم فعّل OAuth 2.0 ضمن Manage Authentication، واحفظ.
2. أنشئ دورًا للقراءة فقط. افتح Setup > Users/Roles > Manage Roles > New وأضف الصلاحيات التالية:
   • Setup: صلاحيتا REST Web Services وLog in using OAuth 2.0 Access Tokens.
   • Reports: صلاحية SuiteAnalytics Workbook.
   • Transactions وLists: صلاحية العرض (View) على السجلات التي تريدها في كيوبت، مثل Find Transaction وSales Order وInvoice وBills وJournal Entry وCustomers وVendors وItems وAccounts وSubsidiaries وDepartments وClasses وLocations وCurrency.
3. امنح الدور لموظف. يعمل كيوبت باسم هذا الموظف وبهذا الدور وحده.
4. أنشئ سجل التكامل. افتح Setup > Integration > Manage Integrations > New، وسمّه Qubit، وفعّل ضمن OAuth 2.0 خيار Client Credentials (Machine to Machine) Grant مع نطاق REST Web Services. احفظ السجل، ثم انسخ معرّف العميل (Client ID)، إذ لا يعرضه NetSuite إلا مرة واحدة. لا يحتاج كيوبت إلى السر (Client Secret).

ربط NetSuite

1. افتح البيانات من الشريط الجانبي، وانقر على إضافة بيانات، ثم اختر ربط قاعدة بيانات.
2. في صفحة مصدر بيانات جديد، انقر على NetSuite ضمن فئة المحاسبة.
3. أدخل اسم الاتصال.
4. في قسم الشهادة، انقر على إنشاء شهادة، فيُنزّل المتصفح الملف qubit-netsuite-certificate.pem. ويحتفظ كيوبت بالمفتاح الخاص المقابل مشفّرًا مع هذا الاتصال.
5. في NetSuite، افتح Setup > Integration > Manage Authentication > OAuth 2.0 Client Credentials (M2M) Setup وانقر على Create New. اختر الموظف في حقل Entity، والدور الذي أنشأته في حقل Role، وتكامل Qubit في حقل Application، ثم ارفع ملف الشهادة. احفظ، ثم انسخ معرّف الشهادة (Certificate ID).
6. عُد إلى كيوبت واملأ الحقول:
   • معرّف الحساب (Account ID): من Setup > Company > Company Information، مثل 1234567. وينتهي معرّف حساب الاختبار (Sandbox) بـ _SB1 أو ما يشبهه.
   • معرّف العميل (Client ID): من سجل التكامل.
   • معرّف الشهادة (Certificate ID): من إعداد M2M.
   • قراءة المعاملات ابتداءً من: اختياري. يقرأ كيوبت المعاملات وبنودها وأثرها في دفتر الأستاذ ابتداءً من هذا التاريخ. اتركه فارغًا لقراءة السجل كاملًا.
7. اختر جدول المزامنة. الخيار الافتراضي يوميًا.
8. انقر على إنشاء.

إذا كانت لديك شهادة خاصة بك، فاختر استخدام شهادتي الخاصة بدلًا من ذلك والصق مفتاحها الخاص بصيغة PEM دون عبارة مرور. يقبل NetSuite مفاتيح RSA بطول 3072 أو 4096 بت، ومفاتيح EC.

ما يقرؤه كيوبت

ويقرأ كيوبت الحقول المخصصة أيضًا (custbody_ وcustcol_ وcustentity_ وcustitem_) متى وُجدت لها قيمة في سجل حديث.

• تصل المبالغ كما يرسلها NetSuite، نصًا عشريًا دقيقًا.
• تُقرأ التواريخ والأوقات بالصيغة YYYY-MM-DD HH:MM:SS وفق المنطقة الزمنية لموظف التكامل.
• تُقرأ مربعات الاختيار بالقيمة T أو F كما في NetSuite.

بعد الربط

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

استبدال الشهادة

تبقى الشهادة صالحة لمدة سنتين، فاستبدلها قبل انتهاء صلاحيتها: افتح قائمة الاتصال في كتالوج البيانات واختر تعديل، وانقر على إنشاء شهادة جديدة، وأضف الملف الجديد في OAuth 2.0 Client Credentials (M2M) Setup للتكامل والموظف والدور أنفسهم، ثم الصق معرّف الشهادة الجديد واحفظ. واحذف الشهادة القديمة من NetSuite بعد نجاح اختبار الاتصال.

حل المشكلات

• رفض NetSuite تسجيل الدخول: تحقّق من أن معرّف العميل يخص التكامل، وأن الشهادة مضافة إلى إعداد M2M الخاص به، وأن معرّف الشهادة مطابق. ويعرض سجل تدقيق الدخول في NetSuite، من Setup > Users/Roles > View Login Audit Trail، السبب الدقيق.
• تعذّر الوصول إلى NetSuite: تحقّق من معرّف الحساب. وينتهي معرّف حساب الاختبار بـ _SB1 أو ما يشبهه.
• جدول غير قابل للقراءة: امنح الدور صلاحية العرض على نوع السجل ذاك، ثم شغّل اختبار الاتصال مجددًا.