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

> كل تغيير في Kosoor Merchant API، الأحدث أولاً.

كل تغيير في الـ API يُذكر هنا، الأحدث أولاً. وما يمكن أن يتغير داخل v1 موضح في [سياسة الإصدارات](https://docs.kosoor.com.sa/ar/versioning.md).

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

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

- **العملاء**: إنشاء الأفراد والشركات وقراءتهم وعرض قوائمهم وتعديلهم، والبحث عنهم برقم الجوال أو الرقم الضريبي أو رقم الهوية أو `referenceId` الخاص بك. الصلاحيتان `customers:read` و `customers:write`. التفاصيل في [العملاء](https://docs.kosoor.com.sa/ar/customers.md).
- **فواتير المبيعات**: إصدار الفاتورة في طلب واحد، مع الدفع عند الإصدار أو بالآجل، والفواتير الضريبية تعتمدها هيئة الزكاة والضريبة والجمارك قبل الرد. وقراءة الفواتير من كل القنوات وعرض قوائمها، وتحميل ملفي PDF و XML الخاصين بالهيئة. الصلاحيتان `sales_invoices:read` و `sales_invoices:write`. التفاصيل في [فواتير المبيعات](https://docs.kosoor.com.sa/ar/sales-invoices.md).
- **المدفوعات**: تسجيل الدفعة وتخصيصها على الفواتير، وقراءة المدفوعات من كل القنوات وعرض قوائمها. الصلاحيتان `payments:read` و `payments:write`. التفاصيل في [المدفوعات](https://docs.kosoor.com.sa/ar/payments.md).
- **الإشعارات الدائنة**: إصدار إشعار على فاتورة صادرة مع إرجاع المبلغ أو خصمه من المستحق على العميل، وقراءة الإشعارات وعرض قوائمها بما فيها الاسترجاع من نقطة البيع ومن لوحة التحكم، وتحميل ملفي PDF و XML. الصلاحيتان `credit_notes:read` و `credit_notes:write`. التفاصيل في [الإشعارات الدائنة](https://docs.kosoor.com.sa/ar/credit-notes.md).
- **الكتالوج**: قراءة الفروع والأصناف وطرق الدفع وعرض قوائمها، لتعرف المعرّفات التي تحتاجها الفاتورة. الصلاحيات `branches:read` و `items:read` و `payment_methods:read`.
- **الـ Webhooks**: نتائج الهيئة التي تصل بعد الرد تُرسل إلى HTTPS Endpoint يسجّله المفتاح، موقّعة بطريقة Standard Webhooks، وتُعاد محاولة إرسالها لمدة 3 أيام تقريباً. الصلاحيتان `webhooks:read` و `webhooks:write`. التفاصيل في [Webhooks](https://docs.kosoor.com.sa/ar/webhooks.md).
- **وضع الاختبار**: بيئة اختبار لكل تاجر، ومفاتيح اختبار تبدأ بـ `ksr_test_`، والـ Header `Kosoor-Mode: test`، وعملاء جاهزون بنتائج معروفة. التفاصيل في [وضع الاختبار](https://docs.kosoor.com.sa/ar/test-mode.md).

المصدر: https://docs.kosoor.com.sa/ar/changelog