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

كل تغيير في الـ API يُذكر هنا، الأحدث أولاً. وما يمكن أن يتغير داخل v1 موضح في سياسة الإصدارات.

7 نوفمبر 2026: الإصدار v1

أول إصدار من Merchant API.

• العملاء: إنشاء الأفراد والشركات وقراءتهم وعرض قوائمهم وتعديلهم، والبحث عنهم برقم الجوال أو الرقم الضريبي أو رقم الهوية أو referenceId الخاص بك. الصلاحيتان customers:read و customers:write. التفاصيل في العملاء.
• فواتير المبيعات: إصدار الفاتورة في طلب واحد، مع الدفع عند الإصدار أو بالآجل، والفواتير الضريبية تعتمدها هيئة الزكاة والضريبة والجمارك قبل الرد. وقراءة الفواتير من كل القنوات وعرض قوائمها، وتحميل ملفي PDF و XML الخاصين بالهيئة. الصلاحيتان sales_invoices:read و sales_invoices:write. التفاصيل في فواتير المبيعات.
• المدفوعات: تسجيل الدفعة وتخصيصها على الفواتير، وقراءة المدفوعات من كل القنوات وعرض قوائمها. الصلاحيتان payments:read و payments:write. التفاصيل في المدفوعات.
• الإشعارات الدائنة: إصدار إشعار على فاتورة صادرة مع إرجاع المبلغ أو خصمه من المستحق على العميل، وقراءة الإشعارات وعرض قوائمها بما فيها الاسترجاع من نقطة البيع ومن لوحة التحكم، وتحميل ملفي PDF و XML. الصلاحيتان credit_notes:read و credit_notes:write. التفاصيل في الإشعارات الدائنة.
• الكتالوج: قراءة الفروع والأصناف وطرق الدفع وعرض قوائمها، لتعرف المعرّفات التي تحتاجها الفاتورة. الصلاحيات branches:read و items:read و payment_methods:read.
• الـ Webhooks: نتائج الهيئة التي تصل بعد الرد تُرسل إلى HTTPS Endpoint يسجّله المفتاح، موقّعة بطريقة Standard Webhooks، وتُعاد محاولة إرسالها لمدة 3 أيام تقريباً. الصلاحيتان webhooks:read و webhooks:write. التفاصيل في Webhooks.
• وضع الاختبار: بيئة اختبار لكل تاجر، ومفاتيح اختبار تبدأ بـ ksr_test_، والـ Header Kosoor-Mode: test، وعملاء جاهزون بنتائج معروفة. التفاصيل في وضع الاختبار.