الواجهة البرمجية ومفاتيح API

تسمح واجهة Softic.Invoice لنظام ERP أو برنامج فوترة بدفع فواتيره بنفسه وطلب معالجتها وقراءة حالتها القانونية واسترجاع الوثائق. وهي موصوفة بـ OpenAPI على /services/swagger وفي دليل الإدماج.

مفاتيح API

الفوترة > مفاتيح API (للمسؤولين): مفتاح لكل نظام مستدعٍ. عند الإنشاء يُعرض المفتاح الكامل مرة واحدة فقط: انسخه، فلا تُحفظ إلا بصمته. يمكن حصر المفتاح في إنشاء المسودات والقراءة، أو السماح له بـالمعالجة (الإصدار، التوقيع، الإيداع، الإلغاء). يمكن أن ينتهي أو يُعطّل أو يُحذف؛ ويُعرض آخر استخدام له.

ما تفعله الواجهة

• POST /api/v1/invoices: إنشاء أو تحديث مسودات بصيغة JSON (نفس صيغة الاستيراد)، بلا تكرار بفضل المرجع الخارجي، مع معالجة فورية اختيارية.
• القراءة بالمعرّف أو بالمرجع الخارجي أو التغييرات منذ تاريخ (استطلاع دوري من ERP).
• الإجراءات: الإصدار، التوقيع، الإيداع، المعالجة في استدعاء واحد، استعلام المنصة، الإلغاء.
• الوثائق القانونية (XML موقّع، رد المنصة، عنصر SAF-T) والفاتورة القابلة للطباعة باللغة المطلوبة.
• مرجع الشركة: النظام، رموز الأداءات، الحرفاء، المواد.

تظهر الفواتير المنشأة عبر الواجهة في شاشة الفواتير مع اسم المفتاح الذي قام بالإجراء في سجلها.