TÀI NGUYÊN API

Thu tiền & Tài chính

Hóa đơn, thu tiền idempotent, số dư công nợ, đối soát cuối ngày và e-Fatura. Tiền được lưu bằng numeric(14,2); số dư công nợ được suy ra, không nhập thủ công.

Truy cập sớm Toàn bộ API

Endpoint

12 endpoint

Các endpoint thuộc tài nguyên này. Mỗi endpoint bị giới hạn trong dữ liệu phòng khám mà khóa API gắn với; các endpoint ghi hỗ trợ tiêu đề Idempotency-Key.

POST /v1/invoices Tạo hóa đơn admin · thư ký · bác sĩ

GET /v1/invoices Liệt kê các hóa đơn admin

GET /v1/invoices/{id} Lấy chi tiết hóa đơn Tất cả các vai trò được ủy quyền

POST /v1/invoices/{id}/void Hủy hóa đơn (bút toán đảo) admin

POST /v1/invoices/{id}/einvoice Gửi hóa đơn dưới dạng e-Fatura (GİB) admin

GET /v1/einvoices Liệt kê các bản ghi e-Fatura admin

POST /v1/payments Ghi nhận thu tiền (idempotent) admin · thư ký · bác sĩ

GET /v1/patients/{id}/balance Lấy số dư công nợ của bệnh nhân Tất cả các vai trò được ủy quyền

GET /v1/patients/{id}/ledger Liệt kê các giao dịch công nợ của bệnh nhân Tất cả các vai trò được ủy quyền

GET /v1/cash/day Lấy tóm tắt quỹ cuối ngày admin · thư ký

GET /v1/cari Liệt kê số dư công nợ admin · thư ký

GET /v1/billing/summary Lấy tóm tắt tài chính/thu tiền admin · thư ký

Ví dụ Sử dụng

Ghi nhận thu tiền (idempotent)

Yêu cầ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"}'

Phản hồi

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.

Bảo mật ở tài nguyên này

Bảo mật không phải là một tính năng, mà là chính kiến trúc. Những đảm bảo có hiệu lực tại tài nguyên này:

Thu tiền idempotent: nhờ Idempotency-Key + khóa máy chủ, ngay cả khi lặp lại trên mạng, cùng một khoản thanh toán không được ghi hai lần (không thu tiền trùng).

Tiền luôn là numeric(14,2); không thực hiện phép tính với số tiền đến từ client, làm tròn tại một điểm duy nhất trên máy chủ.

Hủy/hoàn = bút toán đảo (void/refund); dòng không bị xóa vật lý. Số dư công nợ được suy ra là Σhóa đơn − Σthanh toán.

Giao dịch nhiều thực thể (hóa đơn + hạng mục + thanh toán) mang tính nguyên tử trong một transaction: hoặc tất cả hoặc không có gì.

Toàn bộ mô hình bảo mật →

Định dạng Lỗi

Lỗi trả về trong một phong bì nhất quán; mã hướng đến máy, thông điệp hướng đến người dùng. Lỗi nội bộ/stack không bao giờ bị rò rỉ.

{
  "error": {
    "code": "validation_failed",
    "message": "Trường không hợp lệ: email"
  }
}

Tài nguyên khác

Bệnh nhân Lịch hẹn & Lịch Odontogram & Điều trị Kho Hình ảnh Labo Lead & CRM Du lịch Y tế Báo cáo & BI Webhooks Chuyển Dữ liệu (Export API)

Bạn muốn có quyền truy cập sớm?

Là người đầu tiên biết khi API mở.

Liên hệ