مورد API

التحصيل والمالية

الفاتورة، التحصيل الـ idempotent، الرصيد الجاري، مطابقة نهاية اليوم وe-Fatura. تُحفظ المبالغ بنوع numeric(14,2)؛ ويُشتَق الرصيد الجاري ولا يُكتب يدويًا.

وصول مبكر كل الـ API

النقاط الطرفية

12 نقطة طرفية

النقاط الطرفية العائدة لهذا المورد. تقتصر كل نقطة على بيانات العيادة المرتبطة بمفتاح API؛ وتدعم نقاط الكتابة ترويسة Idempotency-Key.

POST /v1/invoices ينشئ فاتورة admin · السكرتير · الطبيب

GET /v1/invoices يعرض قائمة الفواتير admin

GET /v1/invoices/{id} يجلب تفاصيل الفاتورة جميع الأدوار المصرّح لها

POST /v1/invoices/{id}/void يلغي الفاتورة (قيد عكسي) admin

POST /v1/invoices/{id}/einvoice يرسل الفاتورة كـ e-Fatura (GİB) admin

GET /v1/einvoices يعرض قائمة سجلات e-Fatura admin

POST /v1/payments يسجّل تحصيلًا (idempotent) admin · السكرتير · الطبيب

GET /v1/patients/{id}/balance يجلب الرصيد الجاري للمريض جميع الأدوار المصرّح لها

GET /v1/patients/{id}/ledger يعرض قائمة الحركات الجارية للمريض جميع الأدوار المصرّح لها

GET /v1/cash/day يجلب ملخص صندوق نهاية اليوم admin · السكرتير

GET /v1/cari يعرض قائمة الأرصدة الجارية admin · السكرتير

GET /v1/billing/summary يجلب ملخص المالية/التحصيل admin · السكرتير

مثال استخدام

سجّل تحصيلًا (idempotent)

الطلب

curl -X POST https://api.udentiva.com/v1/payments \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Idempotency-Key: pay-7c3f..." \
  -H "Content-Type: application/json" \
  -d '{"patient_id":"c0ffee00-...","amount":"1500.00","method":"card"}'

الاستجابة

HTTP/1.1 201 Created
{
  "id": "pmt-9001",
  "amount": "1500.00",
  "method": "card",
  "created_at": "2026-06-24T09:15:00Z"
}

# Aynı Idempotency-Key ile tekrar → aynı kayıt döner, ikinci tahsilat OLUŞMAZ.

الأمان في هذا المورد

الأمان ليس ميزة، بل المعمارية نفسها. الضمانات السارية في هذا المورد:

تحصيل idempotent: بفضل Idempotency-Key + قفل الخادم لا تُسجَّل الدفعة ذاتها مرتين حتى مع تكرار الشبكة (لا تحصيل مزدوج).

المبالغ دائمًا numeric(14,2)؛ لا تُجرى عمليات حسابية على المبلغ الوارد من العميل، ويتم التقريب في نقطة واحدة على الخادم.

الإلغاء/الاسترجاع = قيد عكسي (void/refund)؛ ولا يُحذف الصف فعليًا. ويُشتَق الرصيد الجاري بصيغة Σالفاتورة − Σالدفعة.

العملية متعددة الكيانات (الفاتورة + البند + الدفعة) ذرّية في transaction واحد: إما الكل أو لا شيء.

نموذج الأمان الكامل →

صيغة الأخطاء

تُعاد الأخطاء بغلاف متسق؛ الرمز موجَّه للآلة والرسالة للمستخدم. لا يُسرَّب الخطأ الداخلي/التتبّع (stack) أبدًا.

{
  "error": {
    "code": "validation_failed",
    "message": "حقل غير صالح: البريد الإلكتروني"
  }
}

موارد أخرى

المرضى المواعيد والتقويم المخطط السنّي (Odontogram) والعلاج المخزون التصوير المختبر Lead وCRM السياحة الصحية التقارير وذكاء الأعمال (BI) Webhooks نقل البيانات (Export API)

هل ترغب في الوصول المبكر؟

كن أول من يعلم عند إتاحة API.

تواصل معنا