Nội dung toàn văn Quyết định 228/QĐ-QLD 2023 Chuẩn kết nối giữa Hệ thống cơ sở dữ liệu quản lý kê đơn thuốc
BỘ Y TẾ | CỘNG HÒA XÃ HỘI CHỦ NGHĨA VIỆT NAM |
Số: 228/QĐ-QLD | Hà Nội, ngày 03 tháng 04 năm 2023 |
QUYẾT ĐỊNH
VỀ VIỆC BAN HÀNH “CHUẨN KẾT NỐI GIỮA HỆ THỐNG CƠ SỞ DỮ LIỆU DƯỢC QUỐC GIA VÀ HỆ THỐNG THÔNG TIN QUỐC GIA VỀ QUẢN LÝ KÊ ĐƠN THUỐC VÀ BÁN THUỐC THEO ĐƠN”
CỤC TRƯỞNG CỤC QUẢN LÝ DƯỢC
Căn cứ Nghị định số 95/2022/NĐ-CP ngày 15/11/2022 của Chính phủ quy định chức năng, nhiệm vụ, quyền hạn và cơ cấu tổ chức của Bộ Y tế;
Căn cứ Quyết định 7868/2018/QĐ-BYT ngày 28/12/2018 của Bộ trưởng Bộ Y tế quy định chức năng, nhiệm vụ, quyền hạn và cơ cấu tổ chức của Cục Quản lý Dược thuộc Bộ Y tế;
Căn cứ Quyết định số 4041/QĐ/BYT ngày 07/9/2017 của Bộ trưởng Bộ Y tế phê duyệt Đề án tăng cường kiểm soát kê đơn thuốc và bán thuốc kê đơn giai đoạn 2017-2020;
Căn cứ Thông tư 27/2021/TT-BYT ngày 20/12/2021 của Bộ trưởng Bộ Y tế quy định kê đơn thuốc bằng hình thức điện tử;
Căn cứ Thông tư 04/2022/TT-BYT ngày 12/07/2022 của Bộ trưởng Bộ Y tế ban hành Thông tư số 04/2022/TT-BYT sửa đổi, bổ sung một số điều của Thông tư số 52/2017/TT-BYT ngày 29 tháng 12 năm 2017, Thông tư số 18/2018/TT-BYT ngày 22 tháng 8 năm 2018 của Bộ trưởng Bộ Y tế sửa đổi, bổ sung một số điều của Thông tư số 52/2017/TT-BYT quy định về đơn thuốc và kê đơn thuốc hóa dược, sinh phẩm trong điều trị ngoại trú và Thông tư số 27/2021/TT-BYT ngày 20 tháng 12 năm 2021 của Bộ trưởng Bộ Y tế về việc quy định kê đơn thuốc bằng hình thức điện tử;
Căn cứ Quyết định số 808/QĐ-BYT ngày 01/04/2022 của Bộ trưởng Bộ Y tế ban hành tài liệu hướng dẫn kết nối với hệ thống thông tin quốc gia về quản lý kê đơn thuốc và bán thuốc theo đơn;
Căn cứ Quyết định số 540/QĐ-QLD ngày 20 tháng 8 năm 2018 của Cục trưởng Cục Quản lý Dược về việc ban hành “chuẩn yêu cầu dữ liệu đầu ra phần mềm ứng dụng công nghệ thông tin kết nối liên thông cơ sở bán lẻ thuốc” phiên bản 1.0;
Căn cứ Quyết định 777/QĐ-QLD ngày 27 tháng 11 năm 2018 của Cục trưởng Cục Quản lý Dược về việc ban hành “Chuẩn kết nối dữ liệu phần mềm ứng dụng công nghệ thông tin kết nối liên thông cơ sở bán lẻ thuốc” phiên bản 1.0;
Theo đề nghị của Trưởng phòng Pháp chế Thanh tra.
QUYẾT ĐỊNH:
Điều 1. Ban hành kèm theo Quyết định này Chuẩn kết nối giữa Hệ thống cơ sở dữ liệu Dược Quốc gia và Hệ thống thông tin Quốc gia về quản lý kê đơn thuốc và bán thuốc theo đơn (Phụ lục kèm theo Quyết định này).
Điều 2. Các đơn vị cung cấp phần mềm phải cập nhập, nâng cấp phần mềm quản lý cơ sở bán lẻ thuốc đối với Chuẩn kết nối giữa Hệ thống cơ sở dữ liệu Dược Quốc gia và Hệ thống thông tin Quốc gia về quản lý kê đơn thuốc và bán thuốc theo đơn ban hành kèm theo Quyết định này nhằm đón đơn thuốc điện tử để bảo đảm thực hiện đúng Quyết định số 808/QĐ-BYT ngày 01/04/2022 của Bộ trưởng Bộ Y tế ban hành tài liệu hướng dẫn kết nối với hệ thống thông tin quốc gia về quản lý kê đơn thuốc và bán thuốc theo đơn;
Điều 3. Quyết định này thay thế Bảng 3 tại Phụ lục ban hành kèm theo Quyết định 540/QĐ-QLD ngày 20 tháng 8 năm 2018 của Cục Quản lý Dược về việc ban hành “chuẩn yêu cầu dữ liệu đầu ra phần mềm ứng dụng công nghệ thông tin kết nối liên thông cơ sở bán lẻ thuốc” phiên bản 1.0, Mục 2, 3, 4 và phần mã đơn thuốc quốc gia mục 5.2 tại Phụ lục kèm theo Quyết định 777/QĐ-QLD ngày 27 tháng 11 năm 2018 của Cục Quản lý Dược về việc ban hành “Chuẩn kết nối dữ liệu phần mềm ứng dụng công nghệ thông tin kết nối liên thông cơ sở bán lẻ thuốc” phiên bản 1.0.
Điều 4. Quyết định này có hiệu lực từ ngày ký ban hành.
Điều 5. Các Ông/Bà Chánh văn phòng, Trưởng phòng Pháp chế Thanh tra, Lãnh đạo các phòng, đơn vị thuộc Cục Quản lý Dược và Thủ trưởng các đơn vị có liên quan chịu trách nhiệm thi hành Quyết định này./.
| CỤC TRƯỞNG |
PHỤ LỤC
CHUẨN KẾT NỐI GIỮA HỆ THỐNG CƠ SỞ DỮ LIỆU DƯỢC QUỐC GIA VÀ HỆ THỐNG THÔNG TIN QUỐC GIA VỀ QUẢN LÝ KÊ ĐƠN THUỐC VÀ BÁN THUỐC THEO ĐƠN
(Ban hành kèm theo Quyết định số 228/QĐ-QLD ngày 03 tháng 04 năm 2023 của Cục Quản lý Dược)
I. API LẤY ĐƠN THUỐC
1. Điều kiện và mục đích sử dụng
- Api sử dụng cho cơ sở bán lẻ thuốc lấy thông tin đơn thuốc trên đơn thuốc quốc gia về phần mềm bán thuốc để bán.
- Yêu cầu: các đơn vị cung cấp phần mềm liên hệ với đơn vị hỗ trợ vận hành để lấy app-name và app-key sử dụng cho API. App-name và app-key là những thông tin bảo mật tương ứng với từng đơn vị phần mềm. Khi lấy thông tin đơn thuốc phải gửi kèm app-name và app-key.
2. Mô tả
URL: www.donthuocquocgia.vn
Trường thông tin | Giá trị | Ghi chú |
Link API | /api/v1/thong-tin-donthuoc/ {ma_don_thuoc} | |
Request Header | Content Type: application/json app-name: {app-name} app-key: {app-key} | |
Method | GET | |
Tham số | ma_don_thuoc |
3. Dữ liệu trả về khi lỗi
Trường thông tin | Kết quả | Ghi chú |
Header Status | 404 | |
JsonData | { “danh_sach_cac_loi } | Danh sách các lỗi: đơn Không tìm thấy thuốc |
4. Dữ liệu trả về trường hợp thành công
Trường thông tin | Giá trị | Ghi chú |
Header Status | 200 | |
Header Content- | application/json;charset=UTF-8 | |
Type | ||
JsonData | { |
II. API CẬP NHẬT SỐ LƯỢNG BÁN
1. Điều kiện và mục đích sử dụng
- Api sử dụng cho cơ sở bán lẻ thuốc cập nhật số lượng bán đã bán một đơn thuốc lên hệ thống đơn thuốc trên đơn thuốc quốc gia.
- Yêu cầu: các đơn vị cung cấp phần mềm liên hệ với đơn vị hỗ trợ vận hành để lấy app-name và app-key sử dụng cho API. App-name và app-key là những thông tin bảo mật tương ứng với từng đơn vị phần mềm. Khi cập nhật số lượng bán thuốc phải gửi kèm app-name và app-key.
2. Mô tả
URL: www.donthuocquocgia.vn
Trường thông tin | Giá trị | Ghi chú |
Link API | /api/v1/cap-nhat-don-thuoc | |
Request Header | Content Type: application/json app-name: {app-name} app-key: {app-key} | |
Method | POST | |
Tham số | { |
3. Mô tả dữ liệu đầu vào
TT | Dữ liệu đầu vào | Tên trường dữ liệu | Kiểu dữ liệu | Kích thước | Bắt buộc | Ghi chú |
1 | Mã đơn thuốc | ma_don_thuoc | Chuỗi kỹ tự | 14 ký tự | x | Mã đơn thuốc |
2 | Thông tin thuốc | thong_tin_thuoc | Thông tin thuốc là một danh sách gồm một hoặc nhiều thuốc. | x | Mỗi thuốc gồm có các thông tin: Mã thuốc được kê, Mã thuốc, Biệt dược Tên thuốc, Đơn vị tính, Số lượng, Số lượng bán), Cách dùng được mô tả ở các hàng bến dưới tại bảng này. | |
3 | Mã thuốc đã kê đơn | ma_thuoc_da_ke_don | Chuỗi kỹ tự | 20 ký tự | x | Mã thuốc đã kê theo đơn thuốc kéo về |
4 | Mã thuốc | ma_thuoc | Chuỗi kỹ tự | 20 ký tự | x | Mã của thuốc được bán. Trường hợp bán thuốc thay thế có công dụng tương tự thì gửi lên mã thuốc thay thế. |
5 | biet_duoc | Chuỗi ký tự | 200 ký tự | x | Biệt dược (hoạt chất) chính của thuốc được bán. Đối với đơn thuốc y học cổ truyền là tên dược liệu, vị thuốc dược liệu, thuốc cổ truyền) | |
6 | Tên thuốc | ten_thuoc | Chuỗi ký tự | 200 ký tự | x | Tên của thuốc được bán. Trường hợp bán thuốc thay thế có công dụng tương tự thì gửi lên tên thuốc thay thế. |
7 | Đơn vị tính | don_vi_tinh | Chuỗi ký tự | 200 ký tự | x | Đơn vị tính của thuốc |
8 | Số lượng | so_luong | Số | x | Số lượng thuốc được kê | |
9 | Số lượng bán | so_luong_ban | Số | x | Số lượng bán của thuốc. | |
10 | Cách dùng | cach_dung | Chuỗi ký tự | 200 ký tự | x | Cách dùng thuốc. Trường hợp bán thuốc thay thế có công dụng tương tự thì gửi lên cách dùng thuốc thay thế. |
11 | Mã định danh cơ sở cung ứng thuốc | ma_dinh_danh_co_so_cung_ung_thuoc | Chuỗi ký tự | 200 ký tự | x | Mã định danh cơ sở cung ứng thuốc. |
12 | Tên cơ sở cung ứng thuốc | ten_co_so_cung_ung_thuoc | Chuỗi ký tự | 2000 ký tự | x | Tên cơ sở cung ứng thuốc |
13 | Số điện thoại cơ sở cung ứng thuốc | so_dien_thoai_co_so_cung_ung_thuoc | Chuỗi số | 12 số | x | Số điện thoại cơ sở cung ứng thuốc |
14 | Địa chỉ cơ sở cung ứng thuốc | dia_chi_co_so_cung_ung_thuoc | Chuỗi ký tự | 2000 ký tự | x | Địa chỉ cơ sở cung ứng thuốc |
15 | Mã hóa đơn | ma_hoa_don | Chuỗi ký tự | 20 ký tự | x | Mã hóa đơn bán lẻ thuốc |
4. Dữ liệu trả về khi lỗi
Trường thông tin | Giá trị | Ghi chú |
Header Status: | 404 | |
Header Status: | 422 | |
JsonData | { danh sach cac loi } | Danh sách các lỗi |
5. Dữ liệu trả về trường hợp thành công
Trường thông tin | Giá trị | Ghi chú |
Header Status | 200 | |
Header Content-Type | application/json;charset=UTF-8 | |
JsonData | { “Cập nhật đơn thuốc đã bán thành công” } |