ربط فاتورة مع ERP ونقاط البيع والأنظمة الأخرى

ما يمكن ربطه اليوم: واجهة التوقيع المحلي بمفتاح Bearer، واجهات الجلسة تحت /api/t/{slug}، ومسار التخصيص لروابط ERP — مع نقاط النهاية الفعلية.

ربط ERP فاتورة إلكترونيةAPI فاتورةsigner pending signedتكامل نقاط البيعفاتورة integration

يوجد اليوم سطحان للربط في الكود: واجهة جهاز التوقيع (مفتاح Bearer) وواجهات جلسة المتصفح تحت `/api/t/{slug}/…`. مفتاح API عام لخوادم ERP غير مطروح كميزة عامة بعد — للربط العميق استخدم التخصيص.

أ. تكامل التوقيع المحلي (مدعوم الآن)

• `GET {origin}/api/e-invoicing/signer/pending`
• `POST {origin}/api/e-invoicing/signer/signed`
• الترويسة: `Authorization: Bearer {signerApiKey}`

هذا ما يستخدمه تطبيق سطح المكتب. لا تعرض مفتاح التوقيع في JavaScript للواجهة.

ب. واجهات المؤسسة (جلسة)

تعتمد على ملف تعريف الارتباط `eta_saas_session`: الإعدادات، المستندات، العملاء، المنتجات، المستخدمون، الوارد، الاستيراد. الكتابة للمالك/المسؤول/المحاسب؛ الإعدادات للمالك/المسؤول.

ليست مصممة كـ API غير مراقب لـ ERP دون جلسة. للمزامنة من خادم إلى خادم اطلب موصّلاً مخصصاً.

ج. نمط ERP شائع

• ERP يحتفظ بالفواتير التجارية
• وسيط/تخصيص ينشئ مستندات فاتورة
• فاتورة يعلّم جاهز للتوقيع
• التوقيع المحلي يوقّع بالتوكن
• فاتورة يرسل للمصلحة ويحفظ الحالة وPDF
• ERP يخزّن uuid/الحالة عبر الموصل

د. قبل الربط

• نجاح اختبار دخول المصلحة
• سياسة ترقيم مستقرة
• توزيع مفتاح التوقيع على أجهزة التوقيع فقط
• استيراد البيانات الأساسية
• إثبات Preprod قبل Prod

الخطوات التالية

• البدء
• تخصيص أو عرض تجريبي