Thu viện phí tự động
cho phòng khám & bệnh viện

Quầy thu ngân đông, đối soát tay dễ nhầm hồ sơ

Giờ cao điểm bệnh nhân dồn về quầy thu ngân; nhân viên vừa thu tiền vừa nhập tay, vừa đối chiếu sao kê để biết ai đã trả cho lượt khám nào.

• 1Hàng đợi giờ cao điểm — bệnh nhân xếp hàng ở quầy thu ngân để chờ nộp và lấy biên nhận.
• 2Chuyển khoản kèm nội dung — thu ngân dò sao kê thủ công, dễ sót và chậm.
• 3Hai bệnh nhân trùng số tiền — khớp tay dễ nhầm hồ sơ, nhầm lượt khám.
• 4Nhiều khoản trong ngày — khám, CLS, thuốc, tạm ứng… cuối ngày cộng sổ vất vả.

Gốc rễ là khâu thu và ghi nhận vẫn làm tay. Một giải pháp API thanh toán gắn mỗi khoản với mã bệnh nhân + lượt khám, để tiền về là tự khớp đúng hồ sơ.

Từ lúc bệnh nhân quét tới lúc ghi nhận

// order_id định danh cho khoản thu này (tối đa 36 ký tự)
const payload = {
  req_id: "req-BN048213-KHAM-20260816", order_id: "BN048213-KHAM-20260816",
  va: "VA100023312", bincode: "970454", amount: 350000,
}; // amount 0/bỏ trống = QR tĩnh; > 0 = QR động

// Mã hoá AES-256-CBC (hex) rồi gọi API tạo QR
const res = await fetch("https://sme-open-api-sandbox.tconnect.vn/openapi/v1/transaction/qr/generate", {
  method: "POST",
  headers: {
    "partner-code": partnerCode,
    "x-service-code": serviceCode, // lấy từ API Get Services
    Authorization: `Bearer ${accessToken}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ data: encryptAES256(payload) }),
});

Mỗi khoản một mã định danh — khớp không nhầm hồ sơ

Khi bệnh nhân trả tiền, TCONNECT báo có tự động về HIS (cơ chế IPN). Nhờ order_id, hệ thống biết ngay là khoản gì, khớp đúng bệnh nhân + lượt khám và cập nhật đã thanh toán — quầy thu ngân không phải nhập tay hay dò sao kê. Phần báo có chỉ cần đúng ba nguyên tắc: xác thực nguồn gọi, không ghi nhận trùng, phản hồi nhanh (dưới vài giây).

Nhiều quầy, nhiều chi nhánh — gộp về một dashboard

Vì mỗi khoản có VA/order_id định danh, doanh thu tự gộp về đúng quầy — đúng chi nhánh. Quản lý xem ngay khoản nào đã thu, còn treo, và đối soát cuối ngày trong vài phút thay vì cộng sổ tay.

Xuất hóa đơn điện tử (tùy chọn)

Sau khi ghi nhận thanh toán, có thể gọi tiếp API hóa đơn điện tử của TCONNECT để tự phát hành hóa đơn/biên nhận cho khách — đúng Nghị định 123/2020 & 70/2025. Đây là bước bổ sung; nghiệp vụ thu tiền tự động ở trên đã chạy độc lập.