BỘ Y TẾ
-------

CỘNG HÒA XÃ HỘI CHỦ NGHĨA VIỆT NAM
Độc lập - Tự do - Hạnh phúc
---------------

Hà Nội, ngày 01 tháng 04 năm 2022

Nơi nhận:
- Như Điều 4;
- Bộ trưởng (để báo cáo);
- Các Thứ trưởng BYT;
- Bảo hiểm xã hội Việt Nam(để p/h);
- Các cơ sở KCB trực thuộc Bộ Y tế;
- Các cơ sở KCB trực thuộc các Bộ, ngành;
- Các cơ sở KCB trực thuộc các Trường đại học;
- Hiệp hội Bệnh viện tư nhân;
- Các cơ sở KCB tư nhân (nhận trên Cổng Thông tin điện tử Bộ Y tế);
- Cổng Thông tin điện tử Bộ;
- Lưu: VT, CNTT.

KT. BỘ TRƯỞNG
THỨ TRƯỞNG




Trần Văn Thuấn

Trường thông tin

Giá trị

Ghi chú

Link API

/api/auth/dang-nhap-co-so-kham-chua-benh

Method

POST

Request Header

Content-Type: application/json

FormData

{

"ma_lien_thong_co_so_kham_chua_benh" :

{ ma_lien_thong_co_so_kham_chua_benh }, "password" : { password }

}

Dữ liệu đầu vào

Tên trường dữ liệu

Kiểu dữ liệu

Bắt buộc

Ghi chú

Mã liên thông cơ sở khám chữa bệnh

ma_lien_thong_co_so_kham_chua_benh

Chuỗi ký tự

x

Mã liên thông cơ sở khám chữa bệnh mà bác sĩ đã được thêm vào.

Mật khẩu

password

Chuỗi ký tự

x

Mật khẩu tài khoản cơ sở khám chữa bệnh

Trường thông tin

Giá trị

Ghi chú

Header Status

422

Mã liên thông cơ sở khám chữa bệnh hoặc mật khẩu không đúng

Trường thông tin

Giá trị

Ghi chú

Header Status

200

Header Content-Type

application/json;charset=UTF-8

JsonData

{

token: { token }

token_type: “bearer”

}

- token được sử dụng cho phiên làm việc

- token type: loại token là bearer để truyền lên kèm theo token.

Trường thông tin

Giá trị

Ghi chú

Link API

/api/v1/them-bac-si

Method

POST

Request Header

Content Type: application/json

Authorization: bearer { token }

token lấy được trên API đăng nhập cơ sở khám chữa bệnh.

FormData

{

“ma_lien_thong_bac_si”:

{ ma_lien_thong_bac_si }

}

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ú

Mã liên thông bác sĩ

ma_lien_thong_bac_si

Chuỗi ký tự

x

Mã liên thông bác sĩ kê đơn - được cung cấp bởi hệ thống đơn thuốc điện tử

Trường thông tin

Giá trị

Ghi chú

Header Status

422

JsonData

{danh_sach_cac_loi}

Danh sách các lỗi

Trường thông tin

Giá trị

Ghi chú

Header Status

200

Header Content-Type

application/json;charset=UTF-8

JsonData

{

'success' => 'Bạn đã thêm bác sĩ thành công'

}

Trường thông tin

Giá trị

Mô tả

Link API

/api/v1/ xoa-bac-si

Method

POST

Request Header

Content Type: application/json

Authorization: bearer { token }

token lấy được trên API đăng nhập cơ sở khám chữa bệnh.

FormData

{

“ma_lien_thong_bac_si” :

{ ma_lien_thong_bac_si }

}

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ú

Mã liên thông bác sĩ

ma_lien_thong_bac_si

Chuỗi ký tự

x

Mã liên thông bác sĩ kê đơn - được cung cấp bởi hệ thống đơn thuốc quốc gia

Trường thông tin

Giá trị

Ghi chú

Header Status

422

JsonData

{

danh_sach_cac_loi

}

Danh sách các lỗi

Trường thông tin

Giá trị

Ghi chú

Header Status

200

Header Content-Type

application/json;charset=UTF-8

JsonData

{

'success' => 'Bạn đã xóa bác sĩ khỏi cơ sở khám chữa bệnh thành công'

}

Trường thông tin

Giá trị

Ghi chú

Link API

/api/auth/dang-nhap-bac-si

Method

POST

Request Header

Content-Type: application/json

FormData

{

"ma_lien_thong_bac_si":

{ ma_lien_thong_bac_si }, "ma_lien_thong_co_so_kham_chua_benh":

{ma_lien_thong_co_so_kham_chua_benh }, "password" : { password }

}

Dữ liệu đầu vào

Tên trường dữ liệu

Kiểu dữ liệu

Bắt buộc

Ghi chú

Mã liên thông bác sĩ

ma_lien_thong_bac_si

Chuỗi ký tự

x

Mã liên thông bác sĩ

Mã liên thông cơ sở khám chữa bệnh

ma_lien_thong_co_so_kham_chua_benh

Chuỗi ký tự

x

Mã liên thông cơ sở khám chữa bệnh mà bác sĩ đã được thêm vào.

Mật khẩu

password

Chuỗi ký tự

x

Mật khẩu tài khoản bác sĩ

Trường thông tin

Giá trị

Ghi chú

Header Status

422

JsonData

{ danh_sach_cac_loi}

Danh sách các lỗi:

- Bác sĩ chưa được thêm vào cơ sở khám chữa bệnh.

- Mã liên thông hoặc mật khẩu không đúng

Trường thông tin

Giá trị

Ghi chú

Header Status

200

Header Content-Type

application/json;charset=UTF-8

JsonData

{

token: { token },

tocken_type: “bearer”

}

token được sử dụng cho phiên làm việc của bác sĩ

Trường thông tin

Giá trị

Ghi chú

Link API

/api/v1/gui-don-thuoc

Method

POST

Request Header

Content Type: application/json

Authorization: bearer { token }

token lấy được trên API đăng nhập bác sĩ

FormData

{

“loai_don_thuoc”: { loai_don_thuoc },

“ma_don_thuoc”: { ma_don_thuoc },

“ho_ten_benh_nhan”:{ho_ten_benh_nhan},

“ma_dinh_danh_y_te”: {ma_dinh_danh_y_te},

“ma_dinh_danh_cong_dan”:

{ma_dinh_danh_cong_dan},

“ngay_sinh_benh_nhan”:

{ ngay_sinh_benh_nhan },

“can_nang” : { can_nang },

“gioi_tinh” : { gioi_tinh },

“ma_so_the_bao_hiem_y_te”:

{ma_so_the_bao_hiem_y_te},

“thong_tin_nguoi_giam_ho”:

{ thong_tin_nguoi_giam_ho },

“dia_chi” : { dia_chi },

“chan_doan” : [{

“ma_chan_doan” : { ma_chan_doan },

“ten_chan_doan” : { ten_chan_doan },

“ket_luan” : { ket_luan },

}],

“luu_y” : { luu_y },

“hinh_thuc_dieu_tri” : { hinh_thuc_dieu_tri },

“dot_dung_thuoc” : { dot_dung_thuoc },

“thong_tin_don_thuoc” : [{

“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 },

}],

“loi_dan” : { loi_dan },

“so_dien_thoai_nguoi_kham_benh”:

{so_dien_thoai_nguoi_kham_benh},

“ngay_tai_kham” : {ngay_tai_kham},

“ngay_gio_ke_don” : { ngay_gio_ke_don},

“signature”: { chu_ky_so}

}

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

Loại đơn thuốc

loai_don_thuoc

[ c, h, n, y]

1 ký tự

x

Loại đơn thuốc sẽ ứng với 1 trong 4 ký tự:

- c: loại đơn thuốc cơ bản

- h: loại đơn thuốc hướng tâm thần và thuốc tiền chất

- n: loại đơn thuốc gây nghiện

-y: loại đơn thuốc cổ truyền

2

Mã đơn thuốc

ma_don_thuoc

Chuỗi ký tự

14 ký tự

x

Mã đơn thuốc là từ khóa để tìm kiếm đơn thuốc trên hệ thống đơn thuốc điện tử. Mã đơn thuốc phải là duy nhất

Mã đơn thuốc cấu trúc gồm mã bảo hiểm cơ sở khám chữa bệnh (5 ký tự) + 7 ký tự bất kỳ bao gồm chữ và số + 2 ký tự cuối là ‘-c’ - đơn thuốc chuẩn, ‘-n’ - đơn thuốc gây nghiện, ‘-h’ - đơn thuốc hướng thần, ‘-y’ - đơn thuốc y học cổ truyền

3

Họ tên bệnh nhân

ho_ten_benh_nhan

Chuỗi ký tự

500 ký tự

x

Họ tên của bệnh nhân đến khám chữa bệnh

4

Ngày sinh bệnh nhân

ngay_sinh_benh_nhan

Date: d/m/Y

x

Ngày sinh của bệnh nhân

Date format: Ngày/Tháng/Năm

5

Mã định danh y tế

ma_dinh_danh_y_te

Chuỗi ký tự

10 ký tự

Mã định danh y tế của bệnh nhân

6

Mã định danh công dân

ma_dinh_danh_cong_dan

Chuỗi số

12 số

Mã định danh công dân được cấp bới bộ công an

7

Cân nặng

can_nang

Số

Cân nặng của bệnh nhân.

8

Giới tính

gioi_tinh

Số

x

Giới tính của bệnh nhân

1: Chưa có thông tin

2: Giới tính Nam

3: Giới tính nữ

9

Mã số bảo hiểm y tế

ma_so_bao_hiem_y_te

Chuỗi ký tự

10 ký tự

Mã số bảo hiểm y tế của bệnh nhân nếu có.

10

Thông tin người giám hộ

thong_tin_nguoi_giam_ho

Chuỗi ký tự

500 ký tự

Bắt buộc trong trường hợp người khám bệnh là trẻ em hơn 72 tháng tuổi

Thông tin người giám hộ: Họ tên, Số điện thoại, địa chỉ người giám hộ.

11

Địa chỉ bệnh nhân

dia_chi

Chuỗi ký tự

500 ký tự

x

Địa chỉ thường trú, tạm trú của bệnh nhân

12

Chẩn đoán

chan_doan

Danh sách chẩn đoán bệnh.

x

Thông tin phần tử chẩn đoán:

ma_benh: Mã bệnh theo ICD10

ten_benh: Tên bệnh theo ICD10

ket_luan: Kết luận của bác sĩ.

13

Lưu ý

luu_y

Chuỗi ký tự

2000 ký tự

Lưu ý của bác sĩ

14

Hình thức điều trị

hinh_thuc_dieu_tri

Số

Bắt buộc nếu loại đơn thuốc là đơn thuốc cơ bản

Danh mục hình thức điều trị ban hành bởi Bộ Y tế

15

Đợt dùng thuốc

dot_dung_thuoc

Danh sách

Bắt buộc nếu loại đơn thuốc là h, n hoặc y

Danh sách đợt dùng thuốc gồm:

- Đợt: số

- từ ngày: Date format d/m/Y

- đến ngày: Date format d/m/Y

- Số thang thuốc: yêu cầu đối với thuốc y học cổ truyền

16

Thông tin đơn thuốc

thong_tin_don_thuoc

Thông tin đơn thuốc bao gồm danh sách các thuốc được kê đơn

x

Các phần tử của một thông tin thuốc gồm mã thuốc, biệt dược, tên thuốc, đơn vị tính, số lượng và cách dùng được mô tả ở các hàng bên dưới.

17

Mã thuốc

ma_thuoc

Chuỗi ký tự

20 ký tự

x

Danh mục mã thuốc được cấp bởi cục quản lý dược Bộ Y tế

18

Biệt dược

biet_duoc

Chuỗi ký tự

500 ký tự

x

Biệt dược ( hoạt chất ) chính của thuốc

Đối với đơn thuốc y học cổ truyền: Tên dược liệu, vị thuốc cổ truyền

19

Tên thuốc

ten_thuoc

Chuỗi ký tự

500 ký tự

x

Tên thương mại của thuốc

20

Đơn vị tính

don_vi_tinh

Chuỗi ký tự

500 ký tự

x

Đơn vị tính của thuốc

21

Số lượng

so_luong

Số

x

Số lượng thuốc được kê theo đơn vị tính

22

Cách dùng

cach_dung

Chuỗi ký tự

500 ký tự

x

Cách dùng thuốc bao gồm: đường dùng, liều dùng, thời gian dùng,…

23

Lời dặn

loi_dan

Chuỗi ký tự

2000 ký tự

Lời dặn của bác sĩ

Đối với đơn thuốc y học cổ truyền cần mô tả thêm: Cách sắc thuốc, cách uống thuốc.

24

Số điện thoại người khám bệnh

so_dien_thoai_nguoi_kham_benh

Chuỗi số.

12 số

Số điện thoại liên lạc của người đến khám bệnh

25

Ngày tái khám

ngay_tai_kham

Số ngày

Số ngày bệnh nhân đến khám lại kể từ ngày kê đơn.

26

Ngày giờ kê đơn

ngay_gio_ke_don

Datetime:

Y-m-d

H:m:s

Ngày giờ bác sĩ kê đơn trên phần mềm gửi lên. Ngày giờ kê đơn bao gồm cả ngày và giờ có cấu trúc: Y-m-d

H:m:s

27

Chữ ký số

signature

signature

Chữ ký số của người kê đơn

Trường thông tin

Giá trị

Ghi chú

Header Status

422

JsonData

{

danh_sach_cac_loi

}

Danh sách các lỗi

Trường thông tin

Giá trị

Ghi chú

Header Status

200

Header Content-Type

application/json;charset=UTF-8

JsonData

{

'success' => 'Gửi đơn thuốc thành công'

}

Trường thông tin

Giá trị

Ghi chú

Link API

/api/v1/thong-tin-don-thuoc/{ma_don_thuoc}

Request Header

Content Type: application/json

app-name: {app-name}

app-key: {app-key}

Method

GET

Tham số

ma_don_thuoc

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:

Không tìm thấy đơn thuốc

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 }

}

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”

}

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

Biệt dược

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 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

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

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”

}