Hệ thống pháp luật

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




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”

}

 

 

HIỆU LỰC VĂN BẢN

Quyết định 228/QĐ-QLD năm 2023 "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" do Bộ trưởng Bộ Y tế ban hành

  • Số hiệu: 228/QĐ-QLD
  • Loại văn bản: Quyết định
  • Ngày ban hành: 03/04/2023
  • Nơi ban hành: Bộ Y tế
  • Người ký: Vũ Tuấn Cường
  • Ngày công báo: Đang cập nhật
  • Số công báo: Đang cập nhật
  • Ngày hiệu lực: 03/04/2023
  • Tình trạng hiệu lực: Còn hiệu lực
Tải văn bản