Phòng công nghệ thông tin của một bệnh viện tuyến tỉnh nhận yêu cầu triển khai liên thông dữ liệu nhà thuốc quốc gia từ ban giám đốc, nhưng loay hoay không rõ nên làm theo hướng nào: cử một nhân viên ngồi nhập tay dữ liệu bán thuốc mỗi cuối ngày trên cổng web của hệ thống trung tâm, hay yêu cầu nhà cung cấp phần mềm dựng kết nối API để dữ liệu tự chảy lên theo thời gian thực. Hai cách đều đáp ứng yêu cầu liên thông, nhưng khác nhau hoàn toàn về công sức vận hành lâu dài. Bài viết giải thích kết nối API là gì trong bối cảnh liên thông dữ liệu dược, quy trình thực hiện gồm những mốc nào, và cách xử lý khi đường truyền gián đoạn giữa ca bán thuốc.
Nhập Tay Qua Web Và Kết Nối API: Khác Nhau Ở Đâu
Hệ thống cơ sở dữ liệu về dược tại csdlduoc.com.vn cho phép cơ sở kinh doanh dược nhập dữ liệu theo hai hình thức song song. Cách thứ nhất là đăng nhập cổng web, tự gõ hoặc tải lên file Excel theo mẫu cho từng đợt bán ra, nhập vào. Cách thứ hai là để phần mềm quản lý nhà thuốc tự gửi dữ liệu trực tiếp tới hệ thống trung tâm thông qua kết nối API, ngay khi giao dịch được ghi nhận tại quầy.
Khác biệt nằm ở chỗ ai là người thao tác lặp lại. Với nhập tay, mỗi đơn thuốc bán ra đã có trong phần mềm quản lý nội bộ của nhà thuốc, rồi lại phải gõ thêm một lần nữa trên cổng web riêng - hai hệ thống, hai lần nhập, hai cơ hội sai lệch. Với kết nối API, dữ liệu chỉ nhập một lần tại điểm bán, phần còn lại là máy với máy tự trao đổi.
Với một quầy bán lẻ nhỏ, vài chục đơn mỗi ngày, nhập tay cuối ca vẫn xoay xở được. Nhà thuốc bệnh viện thì khác: lượng đơn phát sinh liên tục suốt giờ hành chính, gắn với cả luồng cấp phát nội trú lẫn bán lẻ ngoại trú. Cộng dồn việc nhập tay riêng cho hệ thống dược quốc gia vào cuối ngày là phép tính không kịp về mặt nhân lực, và rủi ro bỏ sót dòng dữ liệu tăng theo số lượng.
So khớp dữ liệu tại quầy trước khi bật kết nối tự động lên hệ thống trung tâm
Kết Nối API Trong Liên Thông Dữ Liệu Dược Hoạt Động Thế Nào
Về bản chất, API (giao diện lập trình ứng dụng) là một kênh trao đổi dữ liệu chuẩn hóa giữa hai phần mềm - ở đây là phần mềm quản lý nhà thuốc và hệ thống trung tâm của Hệ thống cơ sở dữ liệu về dược. Đơn vị vận hành hệ thống trung tâm công bố đặc tả kỹ thuật: dữ liệu cần gửi gồm những trường nào, định dạng ra sao, gửi qua kênh nào. Nhà cung cấp phần mềm nhà thuốc dựa vào đặc tả đó để dựng kết nối.
Khi kết nối đã chạy, mỗi lần quầy thuốc xuất một đơn bán ra hoặc kho ghi nhận một lô nhập vào, phần mềm tự đóng gói dữ liệu giao dịch đó và gửi lên hệ thống trung tâm mà không cần thao tác thủ công thêm. Ngược lại, nếu hệ thống trung tâm từ chối một dòng dữ liệu - ví dụ mã thuốc không khớp danh mục chuẩn - phản hồi lỗi cũng trả về qua API để phần mềm nội bộ ghi nhận và cảnh báo, thay vì để nhân viên phải tự vào cổng web kiểm tra thủ công từng dòng.
Điểm cần lưu ý: nhà thuốc bệnh viện không tự viết kết nối này. Việc phát triển và kiểm thử API là trách nhiệm của nhà cung cấp phần mềm quản lý nhà thuốc, dựa trên đặc tả kỹ thuật do đơn vị vận hành hệ thống công bố. Phía nhà thuốc bệnh viện chỉ cần làm việc với nhà cung cấp phần mềm để xác nhận phiên bản đang dùng đã hỗ trợ kết nối, và chuẩn bị dữ liệu nội bộ cho khớp.
Từ Tài Khoản Đến API Chạy Thật: Các Mốc Cần Đi Qua
Kết nối API không phải bước đầu tiên trong hành trình liên thông, mà là bước sau cùng, sau khi phần thủ tục pháp lý đã xong. Trình tự thường gặp gồm bốn mốc:
- Hoàn tất đăng ký tài khoản csdlduoc.com.vn và bước định danh, xác thực cơ sở kinh doanh dược.
- Xác nhận với nhà cung cấp phần mềm quản lý nhà thuốc rằng phiên bản đang sử dụng đã hỗ trợ kết nối API theo đặc tả kỹ thuật hiện hành của hệ thống trung tâm.
- Rà soát và chuẩn hóa danh mục thuốc nội bộ cho khớp với mã chuẩn của hệ thống trung tâm, trước khi bật kết nối chính thức.
- Chạy thử - lý tưởng là trên môi trường kiểm thử nếu đơn vị vận hành hệ thống có cung cấp, hoặc tối thiểu chạy song song một thời gian ngắn giữa gửi dữ liệu thật và đối chiếu thủ công - rồi mới tắt hẳn quy trình dự phòng.
Bỏ qua mốc thứ ba là lỗi phổ biến nhất trên thực tế. Kết nối API vẫn "chạy" theo nghĩa kỹ thuật - dữ liệu vẫn được gửi đi - nhưng nếu mã thuốc sai, hệ thống trung tâm từ chối hoặc gắn cờ lỗi từng dòng, và người phụ trách lại phải quay về xử lý thủ công đúng thứ mà API vốn được dựng ra để tránh.
Sai lầm thường gặp: Coi kết nối API xong là hết việc. Trên thực tế, API chỉ vận chuyển dữ liệu đúng như những gì phần mềm nội bộ đang có - nếu danh mục thuốc nội bộ còn sai mã, còn thiếu số lô hoặc hạn dùng, kết nối càng nhanh thì lỗi càng nhanh dồn lên hệ thống trung tâm.
Gửi Theo Lô Hay Đồng Bộ Theo Thời Gian Thực
Không phải mọi kết nối API đều đẩy dữ liệu ngay lập tức. Có hai cách vận hành phổ biến. Gửi theo lô (batch) là phần mềm gom dữ liệu giao dịch trong một khoảng thời gian - ví dụ cuối mỗi giờ hoặc cuối ngày - rồi gửi một lần. Đồng bộ theo thời gian thực là mỗi giao dịch được đẩy đi ngay khi phát sinh, gần như tức thời.
Với nhà thuốc bệnh viện có lượng giao dịch lớn và đòi hỏi dữ liệu tồn kho phải đúng ngay trong ngày để phục vụ đối chiếu kho - viện phí, đồng bộ theo thời gian thực phù hợp hơn. Với cơ sở bán lẻ quy mô nhỏ, gửi theo lô cuối ngày vẫn đáp ứng được yêu cầu liên thông kịp thời mà không cần hạ tầng mạng phức tạp. Việc chọn cách nào phụ thuộc vào quy mô giao dịch và khả năng đáp ứng của phần mềm đang dùng, không có một cấu hình chung cho mọi cơ sở.
Ba Nhóm Dữ Liệu Phải Khớp Trước Khi Bật Kết Nối
Trước khi yêu cầu nhà cung cấp phần mềm bật kết nối API, ba nhóm dữ liệu sau cần được rà lại:
- Mã thuốc chuẩn: danh mục thuốc trong phần mềm nội bộ phải khớp với mã trên hệ thống trung tâm, không dùng mã tự đặt riêng của nhà thuốc.
- Số lô và hạn dùng: đây là hai trường bắt buộc trong dữ liệu liên thông, nhưng lại dễ bị bỏ trống hoặc nhập sai định dạng khi thao tác vội ở quầy.
- Đơn vị tính: một hoạt chất có thể bán theo viên, vỉ hoặc hộp; đơn vị tính không thống nhất giữa kho và quầy bán lẻ là nguyên nhân phổ biến khiến số liệu tồn kho lệch khỏi số liệu đã liên thông.
Mất Kết Nối Giữa Ca Bán Thuốc: Quầy Không Được Đứng Hình
Đường truyền internet của cơ sở y tế không phải lúc nào cũng ổn định tuyệt đối. Câu hỏi thực tế mà bất kỳ nhà thuốc bệnh viện nào cũng cần có câu trả lời trước khi bật kết nối API: nếu mạng rớt giữa lúc đang bán thuốc, quầy có phải dừng lại chờ không?
Phần mềm quản lý nhà thuốc thiết kế đúng chuẩn sẽ có cơ chế hàng đợi cục bộ: giao dịch vẫn được ghi nhận bình thường trong hệ thống nội bộ, dược sĩ vẫn cấp phát thuốc cho người bệnh như thường lệ, chỉ riêng phần gửi dữ liệu lên hệ thống trung tâm được xếp vào hàng chờ và tự động gửi lại khi đường truyền khôi phục. Thiếu cơ chế này, một lần mất mạng vài phút có thể khiến hàng chục giao dịch bị bỏ sót khỏi dữ liệu liên thông mà không ai phát hiện kịp thời.
Kiểm tra hạ tầng mạng là việc làm cùng lúc với chuẩn hóa danh mục thuốc, không phải sau khi phát sinh sự cố
Nhập Tay Mất Bao Lâu, Kết Nối API Rút Ngắn Được Gì
Một nhà thuốc bệnh viện quy mô trung bình, khoảng 300 đơn bán ra mỗi ngày, từng phân công một nhân viên ngồi nhập tay dữ liệu lên cổng web hệ thống trung tâm vào cuối mỗi ca. Công việc mất khoảng hai giờ mỗi ngày, chưa tính thời gian dò lại khi phát hiện gõ nhầm mã thuốc hoặc thiếu số lô.
| Tiêu chí | Nhập tay qua web | Kết nối API |
|---|---|---|
| Thời gian xử lý mỗi ngày | Khoảng 2 giờ cho 300 đơn | Gần như không tốn thêm thao tác |
| Độ trễ dữ liệu | Cuối ca hoặc cuối ngày | Theo thời gian thực hoặc theo lô ngắn |
| Rủi ro sai lệch | Cao, do nhập lại thủ công lần hai | Thấp hơn, nhưng phụ thuộc danh mục gốc đã sạch |
| Ai thao tác | Nhân viên nhà thuốc | Phần mềm, có giám sát của bộ phận IT |
Sau khi chuyển sang kết nối API, nhân viên nhà thuốc không còn phải ngồi nhập lại dữ liệu cuối ca, nhưng vai trò của họ không mất đi mà chuyển hướng: từ người nhập liệu sang người kiểm soát chất lượng danh mục thuốc đầu vào, vì API chỉ tự động hóa khâu vận chuyển dữ liệu, không tự sửa dữ liệu sai.
Quầy thuốc vẫn hoạt động bình thường trong lúc dữ liệu tự động chảy lên hệ thống trung tâm phía sau
Ai Trong Nhà Thuốc Bệnh Viện Cần Ngồi Cùng Bàn Kỹ Thuật
Kết nối API không phải việc riêng của phòng công nghệ thông tin. Ba vai trò cần có mặt khi lên kế hoạch: người phụ trách kho dược nắm rõ danh mục thuốc và số lô thực tế, dược sĩ trực quầy hiểu quy trình bán ra hằng ngày để phát hiện điểm bất thường sớm, và cán bộ IT làm việc trực tiếp với nhà cung cấp phần mềm về đặc tả kỹ thuật. Thiếu một trong ba, kết nối vẫn có thể chạy được về mặt kỹ thuật nhưng dễ phát sinh lỗi dữ liệu không ai kịp phát hiện.
Trước khi bước vào giai đoạn kết nối API, nhiều cơ sở còn bỏ sót việc rà soát phần mềm nội bộ - từ danh mục thuốc đến quy trình xử lý khi mất kết nối. Xem thêm những việc cần rà soát trên phần mềm trước khi kết nối và bối cảnh pháp lý đầy đủ tại Quyết định 1867/QĐ-BYT về Hệ thống cơ sở dữ liệu về dược.
