HIS/LIS/EMR Integration Report

Bệnh viện Đa khoa Thái Bình — Technical Requirements & API Specifications

Comprehensive integration guide for Patient App & Staff App with core hospital systems

HIS Integration

Hospital Information System provides patient data, appointments, and real-time event webhooks.

9 API Endpoints4 Webhooks
LIS & PACS

Laboratory & imaging systems deliver test results and diagnostic images with real-time updates.

3 API Endpoints1 Webhook
EMR & Digital Sign

Electronic Medical Records with digital signature integration via VNeID & RsHub.

4 API Endpoints1 Webhook
HIS API Endpoints (Pull Data)
RESTful APIs for fetching patient data, appointments, and clinical information

Patient Information

GET /his/patients/{patientCode}

Returns: Mã BN, họ tên, ngày sinh, giới tính, số điện thoại, CCCD, địa chỉ, thông tin thẻ BHYT

Visit History

GET /his/visits/{patientCode}

Returns: Mã đợt điều trị, ngày vào/ra, khoa điều trị, chẩn đoán (ICD-10), trạng thái

Visit Details & Services

GET /his/visits/{visitId}/details
GET /his/visits/{visitId}/services

Returns: Bác sĩ điều trị, danh sách dịch vụ, đơn giá, BHYT chi trả, BN chi trả

Prescriptions & Cost

GET /his/visits/{visitId}/prescriptions
GET /his/visits/{visitId}/cost

Returns: Danh sách thuốc (tên, hàm lượng, liều dùng), tổng chi phí, tạm ứng, nợ

Appointment Booking

GET /his/departments
GET /his/slots?dept={code}&date={date}

Returns: Danh sách chuyên khoa, khung giờ trống theo ngày/khoa/bác sĩ

Create/Cancel Appointments

POST /his/appointments
DELETE /his/appointments/{id}

Allows App to push appointment bookings and receive confirmation codes

Staff App: Medical Records

GET /his/patients/{patientCode}/emr

Returns: Bệnh án tóm tắt cho bác sĩ/điều dưỡng xem trên App

Leadership Dashboard

GET /his/reports/dashboard

Returns: Thống kê BN, công suất giường, doanh thu, kê đơn, chỉ định CLS theo khoa

HIS Webhook Events (Push Data)
Real-time event notifications with HMAC-SHA256 signature verification

POST https://api.bvthaibibnh.vn/api/v1/webhooks/his/events

Header: X-HIS-Signature (HMAC-SHA256)

APPOINTMENT_CONFIRMED

Khi HIS xác nhận lịch hẹn

APPOINTMENT_CANCELLED

Khi HIS hủy lịch hẹn

VISIT_STARTED

Khi bệnh nhân bắt đầu khám (tiếp đón)

VISIT_COMPLETED

Khi kết thúc đợt khám (ra viện)

PAYMENT_COMPLETED

Khi bệnh nhân hoàn tất thanh toán

PRESCRIPTION_ISSUED

Khi bác sĩ hoàn tất kê đơn thuốc

Configuration & Credentials Required
Environment variables needed for App Backend to connect with hospital systems
HIS_BASE_URL

Địa chỉ gốc của API HIS (VD: http://his.bvthaibibnh.vn/api)

HIS_API_KEY

Khóa xác thực để App Backend gọi API của HIS

HIS_WEBHOOK_SECRET

Chuỗi bí mật dùng để tạo mã băm HMAC-SHA256 xác thực Webhook

LIS_API_URL / PACS_VIEWER_URL

Địa chỉ kết nối đến hệ thống xét nghiệm và xem ảnh DICOM

EMR_API_URL

Địa chỉ kết nối đến hệ thống Bệnh án điện tử

Summary & Key Points

RESTful API Standard

HIS, LIS, EMR phải cung cấp các API theo chuẩn RESTful (GET, POST, DELETE)

Webhook Real-time Events

Hỗ trợ cơ chế Webhook để đẩy dữ liệu realtime khi có sự kiện quan trọng

Security & Authentication

HMAC-SHA256 signature verification cho Webhook, API Key authentication

Data Completeness

Tập trung vào định danh bệnh nhân, chi tiết đợt khám, dịch vụ, chi phí, cận lâm sàng, ký số

Báo cáo chi tiết này được tạo dựa trên phân tích các tài liệu yêu cầu kỹ thuật của Bệnh viện Đa khoa Thái Bình