English

الربط مع Oracle

E-Business Suite وFusion ERP Cloud وNetSuite تصل كلها إلى نفس النقطة: REST إلى إنشاء الشيك المباشر بمفتاح API. عبر Integration Cloud بمحوّل REST، أو PL/SQL بـAPEX_WEB_SERVICE، أو SuiteScript — والحقل الذي تنساه الأمثلة: bank_name.

آخر تحديث: 2026-09-21

في الصفحة دي

المبدأ

لا كود خاص بـOracle في البرنامج: أي منتج Oracle يرسل REST إلى POST /api/cheque-logs (= الإنشاء المباشر) بترويسة X-API-KEY. الصف يُنشأ مؤكَّدًا، وbank_name إلزامي.

Oracle Integration Cloud (OIC)

REST Adapter Connection إلى APP_URL/api/cheque-logs، الأمان API Key كترويسة X-API-KEY.
اربط الاتصال بحدث تأكيد الدفع في Fusion.
خرّط الحقول كما في الجدول أدناه.

PL/SQL (APEX_WEB_SERVICE) — EBS

sql

DECLARE
  l_resp CLOB;
BEGIN
  apex_web_service.g_request_headers(1).name  := 'X-API-KEY';
  apex_web_service.g_request_headers(1).value := :api_key;
  apex_web_service.g_request_headers(2).name  := 'Content-Type';
  apex_web_service.g_request_headers(2).value := 'application/json';
  l_resp := apex_web_service.make_rest_request(
    p_url         => :base_url || '/api/cheque-logs',
    p_http_method => 'POST',
    p_body        => '{"bank_name":"بنك مصر","cheque_type":"OUT","recipient_name":"شركة النيل للتوريدات",'
                  || '"amount":1250.75,"currency":"EGP","cheque_date":"2026-10-15","cheque_number":"100200",'
                  || '"external_source":"oracle-ebs","external_id":"AP-778812"}');
END;

NetSuite (SuiteScript 2.x — N/https)

javascript

const res = https.post({
  url: baseUrl + '/api/cheque-logs',
  headers: { 'X-API-KEY': apiKey, 'Content-Type': 'application/json', 'Accept': 'application/json' },
  body: JSON.stringify({
    bank_name: 'بنك مصر', cheque_type: 'OUT', recipient_name: payee, amount: amount, currency: 'EGP',
    cheque_date: date, cheque_number: checkNumber, external_source: 'netsuite', external_id: 'VP-' + internalId
  })
});

خريطة الحقول

Oracle	الشيك	ملاحظة
Supplier name	`recipient_name`
Payment amount	`amount`
Currency code	`currency`
Check number / Payment number	`cheque_number`
Payment date	`cheque_date`	`YYYY-MM-DD`
Bank account → bank name	`bank_name`	إلزامي — كما يعيده `/api/banks`
Payment ID	`external_id`	مفتاح التكرار الاختياري

مشاكل شائعة

422 «اسم البنك مطلوب.» — مثال بلا bank_name (الأمثلة المختصرة في الشاشة تُغفله).
رقم مستعمَل — إعادة معالجة دفعة الدفع؛ external_id يجعلها 200 reused.
مهلة من OIC — جدار الخادم لا يقبل عناوين Oracle Cloud الصادرة.