|
BỘ Y TẾ
CỤC QUẢN LÝ DƯỢC
-------
|
CỘNG HÒA XÃ HỘI
CHỦ NGHĨA VIỆT NAM
Độc lập - Tự do - Hạnh phúc
---------------
|
|
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./.
|
Nơi nhận:
- Như Điều 5;
- Văn phòng Chính phủ (để b/c);
- Bộ trưởng (để b/c);
- Các Thứ trưởng Bộ Y tế (để b/c);
- Các Vụ, Cục, Tổng Cục, Thanh tra Bộ Y tế;
- Sở Y tế các tỉnh, TP trực thuộc TW (để t/h);
- Các cơ sở cung cấp phần mềm (để t/h);
- Cơ sở bán lẻ thuốc (để t/h);
- Cổng thông tin điện tử Cục QLD;
- Lưu: VT. PCTTra (Đ).
|
CỤC TRƯỞNG
Vũ Tuấn Cườ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
|
{
ma_don_thuoc: {ma_don_thuoc},
ho ten_benh_nhan: {ho_ten_benh_nhan},
ngay_sinh_benh_nhan: { ngay_sinh_benh_nhan },
ma_dinh_danh_y_te: { ma_dinh_danh_y_te },
loai_don_thuoc: { loai_don_thuoc },
hinh_thuc_dieu_tri: { hinh_thuc_dieu_tri }, dia_chi: { dia_chi }, gioi_tinh:
{ gioi_tinh }, can_nang: { can_nang }, ma_so_the_bao_hiem_y_te: {
ma_so_the_bao_hiem_y_te },
thong_tin_don_thuoc: { thong_tin_don_thuoc },
dot_dung_thuoc: { dot_dung_thuoc }, chan_doan: { chan_doan }, luu_y: { luu_y
}, loi_dan:{ loi_dan }, ten_bac_si:{ ten_bac_si },
ten_co_so_kham_chua_benh:
{ ten_co_so_kham_chua_benh }
so_dien_ thoai _co_so_kham_chua_benh:
{ so_dien_thoai_co_so_kham_chua_benh }
ngay_gio_ke_don: { ngay_gio_ke_don }
}
|
|
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ố
|
{
“ma_don_thuoc” : “ma don thuoc”,
“thong_tin_thuoc” : [{
“ma_thuoc_da_ke_don”,
{ ma_thuoc_da_ke_don },
“ma_thuoc” : { ma_thuoc },
“biet_duoc” : { biet_duoc },
“ten_thuoc” : { ten_thuoc },
“don_vi_tinh” : { don_vi_tinh },
“so_luong” : { so_luong },
“cach_dung”: { cach_dung }
}],
“ma_dinh_danh_co_so_cung_ung_thuoc”:
{ ma_dinh_danh_co_so_cung_ung_thuoc},
“ten_co_so_cung_ung_thuoc”:
{ ten_co_so_cung_ung_thuoc },
“so_dien_thoai_co_so_cung_ung_thuoc”:
{ so_dien_thoai_co_so_cung_ung_thuoc },
“dia_chi_co_so_cung_ung_thuoc”:
{ dia_chi_co_so_cung_ung_thuoc },
“ma_hoa_don”: “ma_hoa_don”
}
|
|
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”
}
|
|