سجل التغييرات

نتبع مبدأ التوافق الخلفي داخل الإصدار الواحد: قد نضيف حقولًا جديدة إلى الردود أو أنواع أخطاء جديدة، لكننا لا نحذف حقلًا ولا نغيّر معنى قيمة قائمة دون إصدار v2. اكتب عميلك ليتجاهل الحقول غير المعروفة.

v1.0.0 — 2026-10-23

الإصدار الأول العام.

• POST /v1/invoices — إنشاء فاتورة وإرسالها، مع دعم Idempotency-Key.
• POST /v1/invoices/preview — بناء ومعاينة UBL دون إرسال أو استهلاك حصة.
• POST /v1/credit-notes — إشعارات دائنة (نوع 381) مرتبطة بالفاتورة الأصلية.
• GET /v1/invoices و GET /v1/invoices/{id} — سرد واسترجاع مع ترشيح وتصفيح.
• POST /v1/invoices/{id}/retry — إعادة إرسال نفس المستند دون استهلاك حصة.
• GET /v1/invoices/{id}/ubl و /qr.png — المستند والرمز.
• GET /v1/account و /v1/usage و /v1/plans.
• إدارة الـ Webhooks مع توقيع HMAC-SHA256 وإعادة محاولة متدرّجة بستّ مراحل.
• بيئة اختبار كاملة مع محاكاة الرفض عبر البادئة TEST-REJECT.
• دعم مكلّفي الدخل والمبيعات والمبيعات الخاصة، ونقدي/ذمم.
• إدارة تلقائية لعدّاد ICV و UUID لكل منشأة.
• تشفير بيانات اعتماد البوابة بـ AES-256-GCM في قاعدة البيانات.
• ثلاث باقات: البداية (مجانية)، النمو (5 د.أ)، الاحتراف (15 د.أ).

قيد التطوير

• الإرسال بالدفعات — POST /v1/invoices/batch حتى 100 فاتورة في طلب واحد (خطة الاحتراف).
• قوالب طباعة — توليد PDF للفاتورة مع رمز QR وهوية المنشأة.
• دفع إلكتروني مباشر — ربط بوابة دفع لتفعيل الاشتراك تلقائيًا بدل التأكيد اليدوي.
• مكتبات رسمية — حِزم Composer و npm و PyPI.
• تقارير ضريبية — ملخّص شهري قابل للتصدير يطابق متطلّبات الإقرار.

سياسة الإصدارات والإيقاف