MINISTRY OF HEALTH OF VIETNAM | SOCIALIST REPUBLIC OF VIETNAM |
No. 808/QD-BYT | Hanoi, April 01, 2022 |
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”
}