API MƏNBƏSİ

Tahsilat və Maliyyə

Faktura, idempotent tahsilat (ödəniş qəbulu), cari balans, gün sonu üzləşməsi və e-Fatura. Pul numeric(14,2) ilə saxlanılır; cari balans törədilir, əllə yazılmır.

Erkən Giriş Bütün API

Uçlar

12 uc

Bu mənbəyə aid uc nöqtələr. Hər uc, API açarının bağlı olduğu klinika verisi ilə məhduddur; yazma ucları Idempotency-Key başlığını dəstəkləyir.

POST /v1/invoices Faktura yaradır admin · katib · həkim

GET /v1/invoices Fakturaları siyahılayır admin

GET /v1/invoices/{id} Faktura təfərrüatını gətirir Bütün yetkili rollar

POST /v1/invoices/{id}/void Fakturanı ləğv edir (əks qeyd) admin

POST /v1/invoices/{id}/einvoice Fakturanı e-Fatura olaraq göndərir (GİB) admin

GET /v1/einvoices e-Fatura qeydlərini siyahılayır admin

POST /v1/payments Ödəniş qəbulu qeyd edir (idempotent) admin · katib · həkim

GET /v1/patients/{id}/balance Xəstə cari balansını gətirir Bütün yetkili rollar

GET /v1/patients/{id}/ledger Xəstə cari hərəkətlərini siyahılayır Bütün yetkili rollar

GET /v1/cash/day Gün sonu kassa xülasəsini gətirir admin · katib

GET /v1/cari Cari balansları siyahılayır admin · katib

GET /v1/billing/summary Maliyyə/ödəniş qəbulu xülasəsini gətirir admin · katib

Nümunə İstifadə

Ödəniş qəbulu qeyd et (idempotent)

Sorğu

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"}'

Cavab

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.

Bu mənbədə təhlükəsizlik

Təhlükəsizlik bir xüsusiyyət deyil, arxitekturanın özüdür. Bu mənbədə keçərli olan zəmanətlər:

İdempotent ödəniş qəbulu: Idempotency-Key + server kilidi sayəsində şəbəkə təkrarında belə eyni ödəniş iki dəfə qeyd edilmir (ikiqat ödəniş yoxdur).

Pul həmişə numeric(14,2); müştəridən gələn məbləğlə arifmetika edilmir, yuvarlama tək nöqtədə serverdə edilir.

Ləğv/qaytarma = əks qeyd (void/refund); sətir fiziki olaraq silinmir. Cari balans Σfaktura − Σödəniş olaraq törədilir.

Çox-obyektli əməliyyat (faktura + maddə + ödəniş) tək transaction-da atomikdir: ya hamısı, ya heç biri.

Bütün təhlükəsizlik modeli →

Xəta Formatı

Xətalar ardıcıl bir zərf ilə qayıdır; kod maşına, mesaj istifadəçiyə yönəlikdir. Daxili xəta/stack heç vaxt sızdırılmır.

{
  "error": {
    "code": "validation_failed",
    "message": "Yanlış sahə: e-poçt"
  }
}

Digər Mənbələr

Xəstələr Görüş & Təqvim Odontoqram & Müalicə Anbar Görüntüləmə Laboratoriya Lead & CRM Sağlamlıq Turizmi Hesabatlama & BI Webhooks Veri Ötürülməsi (Export API)

Erkən giriş istəyirsiniz?

API açıldıqda ilk siz xəbərdar olun.

Əlaqə Saxla