SUMBER API

Kutipan & Kewangan

Invois, tahsilat idempoten, baki akaun semasa, penyelarasan hujung hari dan e-Fatura. Wang disimpan dengan numeric(14,2); baki akaun semasa diterbitkan, tidak ditulis secara manual.

Akses Awal Semua API

Titik Akhir

12 titik akhir

Titik akhir bagi sumber ini. Setiap titik akhir terhad kepada data klinik yang dikaitkan dengan kunci API; titik akhir penulisan menyokong pengepala Idempotency-Key.

POST /v1/invoices Mencipta invois admin · setiausaha · doktor

GET /v1/invoices Menyenaraikan invois admin

GET /v1/invoices/{id} Mendapatkan butiran invois Semua peranan yang dibenarkan

POST /v1/invoices/{id}/void Membatalkan invois (rekod balikan) admin

POST /v1/invoices/{id}/einvoice Menghantar invois sebagai e-Fatura (GİB) admin

GET /v1/einvoices Menyenaraikan rekod e-Fatura admin

POST /v1/payments Merekod tahsilat (idempoten) admin · setiausaha · doktor

GET /v1/patients/{id}/balance Mendapatkan baki akaun semasa pesakit Semua peranan yang dibenarkan

GET /v1/patients/{id}/ledger Menyenaraikan pergerakan akaun semasa pesakit Semua peranan yang dibenarkan

GET /v1/cash/day Mendapatkan ringkasan kunci wang hujung hari admin · setiausaha

GET /v1/cari Menyenaraikan baki akaun semasa admin · setiausaha

GET /v1/billing/summary Mendapatkan ringkasan kewangan/tahsilat admin · setiausaha

Contoh Penggunaan

Rekod tahsilat (idempoten)

Permintaan

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

Respons

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.

Keselamatan dalam sumber ini

Keselamatan bukanlah satu ciri, tetapi seni bina itu sendiri. Jaminan yang terpakai dalam sumber ini:

Tahsilat idempoten: dengan Idempotency-Key + kunci pelayan, bayaran yang sama tidak direkodkan dua kali walaupun berlaku ulangan rangkaian (tiada tahsilat berganda).

Wang sentiasa numeric(14,2); tiada aritmetik dilakukan dengan amaun yang datang daripada klien, pembundaran dilakukan di satu titik sahaja pada pelayan.

Pembatalan/pemulangan = rekod balikan (void/refund); baris tidak dipadam secara fizikal. Baki akaun semasa diterbitkan sebagai Σinvois − Σbayaran.

Operasi berbilang-entiti (invois + item + bayaran) adalah atomik dalam satu transaction: sama ada semua atau tiada langsung.

Seluruh model keselamatan →

Format Ralat

Ralat dipulangkan dengan sampul yang tekal; kod ditujukan kepada mesin, mesej kepada pengguna. Ralat dalaman/stack tidak sekali-kali dibocorkan.

{
  "error": {
    "code": "validation_failed",
    "message": "Medan tidak sah: e-mel"
  }
}

Sumber Lain

Pesakit Penjadualan & Kalendar Odontogram & Rawatan Stok Pengimejan Makmal Lead & CRM Pelancongan Kesihatan Pelaporan & BI Webhooks Pemindahan Data (Export API)

Mahukan akses awal?

Jadilah orang pertama yang tahu apabila API dibuka.

Hubungi kami