DECISION

MANUAL FOR CONNECTING WITH NATIONAL INFORMATION SYSTEM ON PRESCRIPTION MANAGEMENT AND SALE OF PRESCRIPTION DRUGS

MINISTER OF HEALTH

Pursuant to Decree No. 75/2017/ND-CP dated June 20, 2017 of Government on functions, tasks, powers, and organizational structure of Ministry of Health;

Pursuant to Circular No. 27/2021/TT-BYT dated December 20, 2021 of Minister of Health on electronic drug prescription;

At request of Director of Electronic Health Administration, Ministry of Health.

HEREBY DECIDES:

Article 1. The Manual for connecting with the national information system on prescription management and sale of prescription drugs is attached hereto.

...

...

...

Article 3. Department of Medical Service Administration is responsible for managing, operating the national information system on prescription management and sale of prescription drugs in an efficient and secured manner as per the law.

Article 4. Chief of the Ministry Office, Director of Electronic Health Administration, Directors, Chief Ministry Inspectorate, Director General affiliated to Ministry of Health, Directors of entities affiliated to Ministry of Health, Director of Health Departments of provinces and central-affiliated cities, heads of health sector and heads of relevant entities shall implement this Decision./.

PP. MINISTER
DEPUTY MINISTER




Tran Van Thuan

MANUAL

FOR CONNECTING WITH NATIONAL INFORMATION SYSTEM ON PRESCRIPTION MANAGEMENT AND SALE OF PRESCRIPTION DRUGS
(Attached to Decision No. 808/QD-BYT dated April 1, 2022)

I. PROCEDURES FOR CONNECTING WITH NATIONAL INFORMATION SYSTEM ON PRESCRIPTION MANAGEMENT AND SALE OF PRESCRIPTION DRUGS

...

...

...

Department of Medical Service Administration is responsible for managing, operating the national information system on prescription management and sale of prescription drugs in an efficient and secured manner as per the law.

Departments of Health of provinces and cities and health sector shall contact Department of Medical Service Administration in order to receive administrator accounts. Upon logging in to their accounts on www.donthuocquocgia.vn, a detail instruction will be available.

Departments of Health, health sectors shall request medical facilities and medicine practitioners (within their management) to register identifier on www.donthuocquocgia.vn (Folder: Physician registration - Facility registration) or compile list and submit to Department of Medical Service Administration in case of great quantity of applicants. Professional officials of Departments, health sector shall inspect, approve registration of facilities and practitioners. Once approved, a single identifier shall be automatically issued for each registration. Officials of Departments of Health and health sector shall transfer identifier of practitioners and facilities to intended destinations.

The same procedures shall apply to Department of Professional Management of Department of Medical Service Administration and medicine practice authorities in facilities affiliated to Ministry of Health.

2. For medical examination and treatment establishments

Send officials to register information of the facility and prescription maker on www.donthuocquocgia.vn or compile list and send to Departments of Health, Ministry of Health.

Receive identifier of facilities and practitioners from superior agencies.

Cooperate with providers of hospital information system (HIS) in introducing identifiers of practitioners and facilities in login session in the HIS. (specific instructions are under Part III, Part IV, and Part V)

Direct providers of HIS to connect drug prescription with national information system for prescription management and sale of prescription drugs of Minister of Health (specific instructions are under Part II and Part VI)

...

...

...

Drug Administration of Vietnam shall request providers of point-of-sale management software to adjust the software in order to receive prescription from the national information system on prescription management and sale of prescription drugs (instructions are under Part VII and Part VIII).

Drug Administration of Vietnam shall cooperate with Department of Medical Service Administration in creating clearance accounts for providers of point-of-sale management software. Uploaded reports on sold prescription will include the account name in order to verify from which Pos software and by which supplier the prescription is sold.

The Pos management software must also submit reports on sold prescriptions to the System (specific instructions are under part VII and part VIII)

4. For prescribing physicians:

Register in order to receive identifiers on www.donthuocquocgia.vn or submit information to their facilities for collective registration. Receive and store: Personal identifier (including account and password)

Once HIS has been revised, make prescription as usual while information technology system will automatically send prescription reports.

5. For the general public

The general public can look up their prescription using prescription code on www.donthuocquocgia.vn

II. GUIDING UPLOAD OF PRESCRIPTION ON DONTHUOCQUOCGIA.VN

...

...

...

Medical examination and treatment establishments that utilize HIS or other management software of service providers.

Pharmacy point-of-sale that are using software of service providers.

2. Requirements for sending prescription

- Have Internet connection.

- Have qualified software according to this document.

- Medical examination and treatment establishments have clearance code granted by donthuocquocgia.vn.

- Prescribing physicians must have clearance code granted by donthuocquocgia.vn.

- Medical examinations and treatment must add physicians to prescribing software (By using Add physician API).

3. Adding and removing physicians in HIS

...

...

...

4. Uploading prescription on donthuocquocgia.vn

- In order to upload prescriptions, login sessions of physicians must be retrieved. A login session remains valid for 7 days. Retrieval of the login session is instructed in Sending prescription API.

- In order to upload prescriptions, information management system (HIS, etc.) must meet API standards stated hereunder.

5. Retrieving prescriptions and updating prescriptions

- Pos management system qualifying for clearance on the “Dược Quốc gia” (National Pharmacy) website must use prescription code to retrieve prescription information to software.

- Adjust the software to receive electronic prescriptions as invoices.

- Adjust the software in order to produce reports on sold drugs as instructed hereunder.

III. API USED BY MEDICAL ESTABLISHMENTS FOR LOGIN

1. Requirements and purpose of use

...

...

...

- Login API is used by prescription software to gather session token. This token is used in API for adding physicians in medical establishments and API for removing physicians from medical establishments.

- A login token remains valid for 7 days.

2. Description

URL: https://api.donthuocquocgia.vn

Field

Value

Note

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

...

...

...

}

3. Input data

Input data

Field name

Types of data

Mandatory

Note

Clearance code of medical establishment

...

...

...

String

x

Clearance code of medical establishment where the physician is added.

Password

password

String

x

Password of medical establishment account

4. Returned data in case of error

...

...

...

Value

Note

Header Status

422

Incorrect clearance code of medical establishment or password

5. Returned data in case of success

Field

Value

Note

...

...

...

200

Header Content-Type

application/json;charset=UTF-8

JsonData

{

token: { token }

token_type: “bearer”

...

...

...

- token is used for the session

- token type: token type is bearer for upload with a token.

IV. API FOR ADDING PHYSICIANS TO MEDICAL ESTABLISHMENTS

1. Requirements and purpose of use

- Requirements: the physicians are granted clearance code on the national prescription system

- The establishments shall use login API of medical establishment to gather session token.

2. Description

URL: https://api.donthuocquocgia.vn

Field

...

...

...

Note

Link API

/api/v1/them-bac-si

Method

POST

Request Header

Content Type: application/json

...

...

...

token is gathered from login API of medical establishment.

FormData

{

“ma_lien_thong_bac_si”:

{ ma_lien_thong_bac_si }

}

3. Input data

Input data

...

...

...

Type of data

Size

Mandatory

Note

Physician clearance code

ma_lien_thong_bac_si

String

x

...

...

...

4. Data returned in case of error

Field

Value

Note

Header Status

422

JsonData

{danh_sach_cac_loi}

...

...

...

5. Data returned in case of success

Field

Value

Note

Header Status

200

Header Content-Type

application/json;charset=UTF-8

...

...

...

JsonData

{

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

}

V. API FOR REMOVING PHYSICIANS FROM MEDICAL ESTABLISHMENTS

1. Objectives

- Requirements: the physicians have been granted clearance code on the national prescription system and added to medical establishments as stated in Section I.

- The establishments shall use login API of medical establishment to gather session token.

...

...

...

URL: https://api.donthuocquocgia.vn

Field

Value

Description

Link API

/api/v1/ xoa-bac-si

Method

POST

...

...

...

Request Header

Content Type: application/json

Authorization: bearer { token }

token is gathered from login API of medical establishments.

FormData

{

“ma_lien_thong_bac_si” :

{ ma_lien_thong_bac_si }

}

...

...

...

3. Input data

Input data

Field name

Type of data

Size

Mandatory

Note

Physician clearance code

ma_lien_thong_bac_si

...

...

...

x

Clearance code of prescribing physician - provided by national prescription system

4. Data returned in case of error

Field

Value

Note

Header Status

422

...

...

...

JsonData

{

danh_sach_cac_loi

}

List of errors

5. Data returned in case of success

Field

Value

Note

...

...

...

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'

}

...

...

...

VI. API FOR PHYSICIAN LOGIN

1. Requirements and purpose of use

- Requirements: the physicians are granted clearance code and password on the national prescription system.

- Purpose: Login API of physicians is to gather session token of uploading prescriptions onto the national prescription system. Login requires physician clearance code and clearance code of medical establishments to which physicians are added according to Part IV.

- A login token remains valid for 7 days.

2. Description

URL: https://api.donthuocquocgia.vn

Field

Value

...

...

...

Link API

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

Method

POST

Request Header

Content-Type: application/json

...

...

...

{

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

}

3. Input data

Input data

Name of field

...

...

...

Mandatory

Note

Physician clearance code

ma_lien_thong_bac_si

String

x

Physician clearance code

Medical establishment clearance code

ma_lien_thong_co_so_kham_chua_benh

...

...

...

x

Medical establishment clearance code to which physicians are added.

Password

password

String

x

Password of physician account

4. Data returned in case of failure

Field

...

...

...

Note

Header Status

422

JsonData

{ danh_sach_cac_loi}

List of errors:

- The physician has not been added to the medical establishment.

- Incorrect clearance code or password

...

...

...

Field

Value

Note

Header Status

200

Header Content-Type

application/json;charset=UTF-8

...

...

...

{

token: { token },

tocken_type: “bearer”

}

token is used for working sessions of physicians

VII. API FOR SENDING PRESCRIPTIONS

1. Prescription code norms

Prescription codes must follow the below structure upon automatic generation

Prescription code, the information system shall create code automatically (format: xxxxxyyyyyyy-z; the first 5 x characters are medical establishment code; the next 7 y characters include 0-9 or a-z; the final z character can be either C, N, H, or Y which specifies type of prescription: C for regular prescription, N for addictive prescription, H for psychotropic prescription, Y for traditional medicine prescription)

...

...

...

Structure:

- The first 5 characters are insurance code of medical establishments (register at donthuocquocgia.vn medical establishments do not have insurance code)

- The next 7 characters are automatically generated prescription code and may contain number from 0-9 or letters from a-z.

- The last 2 letters are ‘-c’ - standard prescription, ‘-n’ - addictive prescription, ‘-h’ - psychotropic prescription, ‘-y’ - traditional medicine prescription

2. Description

URL: https://api.donthuocquocgia.vn

Field

Value

Note

...

...

...

/api/v1/gui-don-thuoc

Method

POST

Request Header

Content Type: application/json

Authorization: bearer { token }

token is gathered from login API of physicians

...

...

...

{

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

...

...

...

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

...

...

...

}],

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

...

...

...

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

}

...

...

...

3. Input data

TT

Input data

Field name

Type of data

Size

Mandatory

Note

1

...

...

...

loai_don_thuoc

[ c, h, n, y]

1 character

x

Type of prescription will match with one of the following 4 characters:

- c: regular prescription

- h: psychotropic and precursor prescription

- n: addictive prescription

-y: traditional medicine prescription

...

...

...

Prescription code

ma_don_thuoc

String

14 characters

x

Prescription code is the keyword for looking up prescription information on the electronic prescription system. Prescription code must be unique

Prescription code consists of insurance code of medical establishments (5 characters) + 7 random characters including letters and number + 2 final characters of ‘-c’ -regular prescription, ‘-n’ - addictive prescription, ‘-h’ - psychotropic prescription, ‘-y’ - traditional medicine prescription

3

Full name of patient

...

...

...

String

500 characters

x

Full name of the patient receiving medical examination and treatment

4

Date of birth of patient

ngay_sinh_benh_nhan

Date: d/m/Y

...

...

...

Date of birth of patient

Date format: Day/Month/Year

5

Health identification

ma_dinh_danh_y_te

String

10 characters

Health identification of patient

...

...

...

Citizen ID

ma_dinh_danh_cong_dan

Number string

12 number

Citizen ID issued by Ministry of Public Security

7

Weight

can_nang

...

...

...

Weight of patient.

8

Gender

gioi_tinh

Number

x

...

...

...

1: No information given

2: Male

3: Female

9

Health insurance code

ma_so_bao_hiem_y_te

String

10 characters

...

...

...

10

Guardian information

thong_tin_nguoi_giam_ho

String

500 characters

Mandatory if patient is a child older than 72 months of age

Information on guardian: Full name, Phone number, address of guardian.

11

Address of patient

...

...

...

String

500 characters

x

Temporary and permanent residence address(es) of patient

12

Diagnosis

chan_doan

List of medical diagnosis.

...

...

...

Information on diagnosis components:

ma_benh: Code of condition as per ICD10

ten_benh: Name of condition as per ICD10

ket_luan: Conclusion of physician.

13

Note

luu_y

String

2000 characters

...

...

...

Note of physician

14

Form of treatment

hinh_thuc_dieu_tri

Number

Mandatory in case of regular prescription

List of forms of treatment issued by Ministry of Health

15

...

...

...

dot_dung_thuoc

List

Mandatory in case of h, n, or y prescription

List of drug regimes:

- Regime No.

- from: Date format d/m/Y

- to: Date format d/m/Y

- Number of doses: mandatory for traditional medicine prescription

...

...

...

Prescription information

thong_tin_don_thuoc

Prescription information consists of list of prescribed medicine

x

Prescription information consists of code of medicine, brand-name medicine, name of medicine, unit of measurement, quantity, and route of administration listed below.

17

Code of medicine

ma_thuoc

...

...

...

20 characters

x

List of medicine code issued by Drug Administration of Vietnam - Ministry of Health

18

Brand-name medicine

biet_duoc

String

500 characters

x

...

...

...

For traditional medicine prescription: Name of traditional medicine

19

Name of medicine

ten_thuoc

String

500 characters

x

Trade name of medicine

20

...

...

...

don_vi_tinh

String

500 characters

x

Unit of measurement of medicine

21

Quantity

so_luong

Number

...

...

...

x

Medicine quantity is listed according to unit of measurement

22

Administration

cach_dung

String

500 characters

x

Administration includes: route of administration, dose, frequency,…

...

...

...

Physician’s instructions

loi_dan

String

2000 characters

Physician’s instructions

Regarding traditional medicine prescription, add description of: How to brew, how to administer.

24

Phone number of patient receiving medical examination

...

...

...

Number string

12 number

Phone number of patient receiving medical examination

25

Date of re-examination

ngay_tai_kham

Number of day

...

...

...

Interval between prescription date and re-examination date.

26

Date and time of prescription

ngay_gio_ke_don

Date and time:

Y-m-d

H:m:s

...

...

...

H:m:s

27

Digital signature

signature

signature

Digital signature of prescribing physician

4. Data returned in case of failure

...

...

...

Value

Note

Header Status

422

JsonData

{

danh_sach_cac_loi

}

...

...

...

5. Data returned in case of success

Field

Value

Note

Header Status

200

Header Content-Type

application/json;charset=UTF-8

...

...

...

JsonData

{

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

}

VIII. API FOR RETRIEVING PRESCRIPTIONS

1. Requirements and purpose of use

- API is for use by pharmacies to retrieve prescription from the national prescription system.

- Requirements: software providers contact support in order to receive app-name and app-key for use by API. App-name and app-key are confidential information corresponding to each software unit. Once prescription information has been retrieved, attach app-name and app-key.

...

...

...

URL: www.donthuocquocgia.vn

Field

Value

Note

Link API

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

Request Header

Content Type: application/json

...

...

...

app-key: {app-key}

Method

GET

Parameter

ma_don_thuoc

3. Data returned in case of failure

...

...

...

Result

Note

Header Status

404

JsonData

{

“danh_sach_cac_loi

}

...

...

...

Prescription not found

4. Data returned in case of success

Field

Value

Note

Header Status

200

Header Content-

...

...

...

Type

JsonData

{

ma_don_thuoc: { ma_don_thuoc},

ho_ten_benh_nhan: {ho_ten_benh_nhan},

ngay_sinh_benh_nhan:{ ngay_sinh_benh_nhan },

...

...

...

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

...

...

...

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 }

}

...

...

...

IX. API FOR UPDATING SALES

1. Requirements and purpose of use

- API used by pharmacies to upload sales of prescription onto the national prescription system.

- Requirements: software providers contact support in order to receive app-name and app-key for use by API. App-name and app-key are confidential information corresponding to each software unit. When updating drug sales, attach app-name and app-key.

2. Description

URL: www.donthuocquocgia.vn

Field

Value

Note

...

...

...

/api/v1/cap-nhat-don-thuoc

Request Header

Content Type: application/json app-name: {app-name}

app-key: {app-key}

Method

POST

...

...

...

{

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

...

...

...

“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":

...

...

...

“ma_hoa_don”: “ma_hoa_don”

}

3. Input data description

TT

Input data

Field name

Type of data

Size

...

...

...

Note

1

Prescription code

ma_don_thuoc

String

14 characters

x

Prescription code

2

...

...

...

thong_tin_thuoc

Drug information is a list of one or many drugs.

x

Each drug must include the following information:

Code of prescribed drugs, Code of drugs, Brand-name medicine, unit of measurement, quantity, Sales, Administration is described in detail under this schedule.

3

Code of prescribed medicine

ma_thuoc_da_ke_don

...

...

...

20 characters

x

Code of prescribed medicine

4

Code of medicine

ma_thuoc

String

20 characters

x

...

...

...

5

Brand-name medicine

biet_duoc

String

200 characters

x

Primary brand-name medicine (active ingredients) of sold drugs. For traditional medicine prescription: Name of traditional medicine

6

Name of drugs

...

...

...

String

200 characters

x

Name of sold drugs. If drugs with equivalent use are sold, upload name of those drugs instead.

7

Unit of measurement

don_vi_tinh

String

200 characters

...

...

...

Unit of measurement of drugs

8

Quantity

so_luong

Number

x

Quantity of prescribed medicine

9

...

...

...

so_luong_ban

Number

x

Number of medicine sold.

10

Administration

cach_dung

String

...

...

...

x

Administration. If drugs with equivalent use are sold, upload administration of those drugs instead.

11

Identifier of pharmacy Pos

ma_dinh_danh_co_so_cung_ung_thuoc

String

200 characters

x

Identifier of pharmacy Pos.

...

...

...

Name of pharmacy Pos

ten_co_so_cung_ung_thuoc

String

2000 characters

x

Name of pharmacy Pos

13

Phone number of pharmacy Pos

so_dien_thoai_co_so_cung_ung_thuoc

...

...

...

12 number

x

Phone number of pharmacy Pos

14

Address of pharmacy Pos

dia_chi_co_so_cung_ung_thuoc

String

2000 characters

x

...

...

...

15

Invoice code

ma_hoa_don

String

20 characters

x

Code of medicine retail invoice

4. Data returned in case of failure

Field

...

...

...

Note

Header Status:

404

Header Status:

422

JsonData

{

...

...

...

}

List of errors

5. Data returned in case of success

Field

Value

Note

Header Status

200

...

...

...

application/json;charset=UTF-8

JsonData

{

“Cập nhật đơn thuốc đã bán thành công”

}

Quyết định 808/QĐ-BYT năm 2022 về 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 do Bộ trưởng Bộ Y tế ban hành