SUMBER API

Penagihan & Keuangan

Faktur, penagihan idempoten, saldo rekening, rekonsiliasi akhir hari, dan e-Fatura. Uang disimpan dengan numeric(14,2); saldo rekening diturunkan, tidak ditulis manual.

Akses Awal Seluruh API

Endpoint

12 endpoint

Endpoint milik sumber ini. Setiap endpoint dibatasi pada data klinik yang terkait dengan kunci API; endpoint penulisan mendukung header Idempotency-Key.

POST /v1/invoices Membuat faktur admin · sekretaris · dokter

GET /v1/invoices Mencantumkan faktur admin

GET /v1/invoices/{id} Mengambil detail faktur Semua peran berwenang

POST /v1/invoices/{id}/void Membatalkan faktur (jurnal balik) admin

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

GET /v1/einvoices Mencantumkan catatan e-Fatura admin

POST /v1/payments Mencatat penagihan (idempoten) admin · sekretaris · dokter

GET /v1/patients/{id}/balance Mengambil saldo rekening pasien Semua peran berwenang

GET /v1/patients/{id}/ledger Mencantumkan mutasi rekening pasien Semua peran berwenang

GET /v1/cash/day Mengambil ringkasan kas akhir hari admin · sekretaris

GET /v1/cari Mencantumkan saldo rekening pasien admin · sekretaris

GET /v1/billing/summary Mengambil ringkasan keuangan/penagihan admin · sekretaris

Contoh Penggunaan

Catat penagihan (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.

Keamanan pada sumber ini

Keamanan bukanlah sebuah fitur, melainkan arsitektur itu sendiri. Jaminan yang berlaku pada sumber ini:

Penagihan idempoten: berkat Idempotency-Key + kunci server, pembayaran yang sama tidak akan tercatat dua kali bahkan saat terjadi pengulangan jaringan (tidak ada penagihan ganda).

Uang selalu numeric(14,2); tidak dilakukan aritmetika dengan nilai yang datang dari klien, pembulatan dilakukan di satu titik di server.

Pembatalan/pengembalian = jurnal balik (void/refund); baris tidak dihapus secara fisik. Saldo rekening diturunkan sebagai Σfaktur − Σpembayaran.

Operasi multi-entitas (faktur + item + pembayaran) bersifat atomik dalam satu transaction: semua atau tidak sama sekali.

Seluruh model keamanan →

Format Kesalahan

Kesalahan dikembalikan dengan amplop yang konsisten; kode ditujukan ke mesin, pesan ke pengguna. Kesalahan/stack internal tidak pernah bocor.

{
  "error": {
    "code": "validation_failed",
    "message": "Bidang tidak valid: e-mail"
  }
}

Sumber Daya Lainnya

Pasien Janji Temu & Kalender Odontogram & Perawatan Inventaris Pencitraan Lab Lead & CRM Wisata Kesehatan Pelaporan & BI Webhooks Transfer Data (Export API)

Ingin akses awal?

Jadilah yang pertama tahu saat API dibuka.

Hubungi