English

دليل المستخدم

التكامل

مرجع فني لمن يربط نظامًا خارجيًا ببرنامج الشيكات: مفاتيح API وحدودها، نقاط النهاية بحقولها وأمثلتها وأخطائها، تدفّق Microsoft Dynamics خطوة بخطوة بخريطة الحقول، البثّ اللحظي عبر Pusher، سجل التدقيق والأمان، ومجموعة Postman جاهزة.

14 صفحة

صفحات القسم

  1. سطح التكامل — نظرة عامة للمكامِل

    ثلاثة أشكال للربط: نقاط REST بمفتاح API لإنشاء الشيكات والاستعلام عن البنوك والنماذج، تكامل Microsoft Dynamics الذي يحضّر الشيك ويسلّم الطباعة لموظف، وبثّ لحظي عبر Pusher للإشعارات. كلها من شاشة «التكامل» ومفتاح تفعيل واحد.

  2. مفاتيح API — الإنشاء والإرسال والحدود

    المفتاح هو الاعتماد الوحيد لطرف خارجي: 40 خانة تظهر مرة واحدة وتُخزَّن هاشًا. له اسم وتاريخ انتهاء اختياري وحدّ طلبات في الدقيقة. يُرسل في الترويسة، ويُدوَّر بإنشاء جديد وحذف القديم.

  3. نقاط البنوك والنماذج — GET /api/banks و/api/bank-templates

    قبل إنشاء أي شيك تحتاج معرّف البنك والنموذج كما يعرفهما البرنامج. ثلاث نقاط قراءة: البنوك التي لها نماذج، كل النماذج، ونماذج بنك بعينه — بمفاتيح الردّ الحرفية وقيودها.

  4. إنشاء شيك مباشرة — POST /api/cheque-log/external

    نقطة واحدة تُنشئ صف شيك مطبوع من نظامك بلا شاشة ولا معاينة — للأنظمة التي تطبع بنفسها وتريد السجل في برنامج الشيكات. حقولها وقواعدها الحرفية، الحرّاس التي ترمي 422، شكل الردّ 201، وما يجب أن تعرفه عن التكرار والصورة.

  5. تكامل Microsoft Dynamics — التدفّق من التحضير إلى الـcallback

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

  6. Dynamics — خريطة الحقول واختيار النموذج

    التحضير يقبل أسماء Dynamics المعتادة (payee_name · net_amount · issue_date · document_no · memo) بسلاسل بديلة مرتّبة، ويختار النموذج بشجرة قرار من template_id أو bank_id أو الأسماء. هنا الخريطة كاملة وما يختمه السيرفر وما يُقبل ولا يُقرأ.

  7. استقبال الإحصاءات — POST /api/receive-stats

    نقطة تستقبل أرقامًا تشغيلية من تطبيق خارجي وتسجّل النداء. في الإصدار الحالي تُسجَّل الحمولة في سجل التدقيق ولا تُحفظ الأرقام في جدول — فلا تبنِ عليها تقارير حتى يُعلَن حفظها.

  8. Pusher — البثّ اللحظي للإشعارات

    مع Pusher تزيد شارة الجرس في تبويب مفتوح لحظة وصول تذكير أو إشعار إجراء — بلا تحديث. بدونه لا يتعطّل شيء: الجرس والبريد يعملان، والشارة تتحدّث عند تحميل الصفحة. الإعداد من تبويب Pusher، والمتصفح يشترك في قناة خاصة لكل مستخدم.

  9. سجل التدقيق والأمان

    كل نداء ناجح لنقاط الكتابة يُسجَّل بحمولته بعد تجريد الأسرار والصور، ويُقرأ من تبويب «سجل API» في التحليلات. وهنا صراحةً ما يجب أن يعرفه مسؤول الأمن: نطاق المفتاح، ما لا يُسجَّل، وما يُنصح به.

  10. مرجع الأخطاء

    كل كود يمكن أن تراه من أي نقطة، وجسمه الحرفي، وما تفعله عنده. 503 قبل كل شيء، ثم سلّم المفتاح، ثم 422 بصيغة Laravel ورسائل عربية، و500 بنصّ الاستثناء.

  11. البداية السريعة ومجموعة Postman

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

  12. الربط مع SAP

    SAP لا يحتاج تكاملًا خاصًا — نداء HTTP صادر من برنامج الدفع إلى نقطة الإنشاء المباشر بمفتاح API. عبر Integration Suite بـiFlow، أو من ABAP بوجهة RFC، مع خريطة حقول F110 وتحويل التاريخ.

  13. الربط مع Oracle

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

  14. الربط مع Odoo

    من خادم Odoo عند تأكيد الدفع — إجراء مؤتمت بكود بايثون قصير، أو وحدة مخصّصة تعيد تعريف action_post. المفتاح في ir.config_parameter لا في الكود، وbank_name من دفتر يومية البنك.

اطلب نسختك التجريبية مجانًا