แหล่งข้อมูล API

การเก็บเงินและการเงิน

ใบแจ้งหนี้, การรับชำระแบบ idempotent, ยอดคงเหลือบัญชีลูกหนี้, การกระทบยอดสิ้นวัน และ e-Fatura เงินถูกเก็บด้วย numeric(14,2) ยอดคงเหลือบัญชีลูกหนี้ถูกคำนวณโดยการอนุมาน ไม่ได้บันทึกด้วยมือ

สิทธิ์เข้าถึงก่อนใคร (Early Access) 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) แถวจะไม่ถูกลบจริง ยอดคงเหลือบัญชีลูกหนี้ถูกคำนวณเป็น Σใบแจ้งหนี้ − Σการชำระเงิน

ธุรกรรมที่มีหลายเอนทิตี (ใบแจ้งหนี้ + รายการ + การชำระเงิน) เป็น atomic ในทรานแซกชันเดียว: ทั้งหมดหรือไม่มีเลย

โมเดลความปลอดภัยทั้งหมด →

รูปแบบข้อผิดพลาด

ข้อผิดพลาดจะส่งคืนในรูปแบบซองที่สอดคล้องกัน โค้ดสำหรับเครื่อง ข้อความสำหรับผู้ใช้ ข้อผิดพลาดภายใน/stack จะไม่มีวันรั่วไหลออกไป

{
  "error": {
    "code": "validation_failed",
    "message": "ฟิลด์ไม่ถูกต้อง: อีเมล"
  }
}

แหล่งข้อมูลอื่น ๆ

ผู้ป่วย การนัดหมาย & ปฏิทิน Odontogram & การรักษา สต็อก การถ่ายภาพ ห้องปฏิบัติการ Lead & CRM การท่องเที่ยวเชิงสุขภาพ การรายงาน & BI Webhooks การถ่ายโอนข้อมูล (Export API)

ต้องการสิทธิ์เข้าถึงก่อนใครหรือไม่

เป็นคนแรกที่รู้เมื่อ API เปิดให้ใช้งาน

ติดต่อเรา