|
MINISTRY OF
HEALTH OF VIETNAM
-------
|
SOCIALIST
REPUBLIC OF VIETNAM
Independence – Freedom – Happiness
----------------
|
|
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.
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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)
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
- 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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
Method
POST
Request Header
Content-Type: application/json
FormData
{
"ma_lien_thong_co_so_kham_chua_benh" :
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
}
3. Input data
Input data
Field name
Types of data
Mandatory
Note
Clearance code of medical establishment
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
Value
Note
Header Status
422
Incorrect clearance code of medical establishment
or password
5. Returned data in case of
success
Field
Value
Note
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
200
Header Content-Type
application/json;charset=UTF-8
JsonData
{
token: { token }
token_type: “bearer”
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
- 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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
Note
Link API
/api/v1/them-bac-si
Method
POST
Request Header
Content Type: application/json
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
Type of data
Size
Mandatory
Note
Physician clearance code
ma_lien_thong_bac_si
String
x
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
4. Data returned in case of
error
Field
Value
Note
Header Status
422
JsonData
{danh_sach_cac_loi}
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
5. Data returned in case of
success
Field
Value
Note
Header Status
200
Header Content-Type
application/json;charset=UTF-8
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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.
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
URL:
https://api.donthuocquocgia.vn
Field
Value
Description
Link API
/api/v1/ xoa-bac-si
Method
POST
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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 }
}
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
3. Input data
Input data
Field name
Type of data
Size
Mandatory
Note
Physician clearance code
ma_lien_thong_bac_si
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
x
Clearance code of prescribing physician -
provided by national prescription system
4. Data returned in case of
error
Field
Value
Note
Header Status
422
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
JsonData
{
danh_sach_cac_loi
}
List of errors
5. Data returned in case of
success
Field
Value
Note
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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'
}
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
Link API
/api/auth/dang-nhap-bac-si
Method
POST
Request Header
Content-Type: application/json
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
{
"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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
Field
Value
Note
Header Status
200
Header Content-Type
application/json;charset=UTF-8
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
{
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)
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
/api/v1/gui-don-thuoc
Method
POST
Request Header
Content Type: application/json
Authorization: bearer { token }
token is gathered from login API of physicians
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
{
“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 },
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
“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 },
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
}],
“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 },
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
“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}
}
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
3. Input data
TT
Input data
Field name
Type of data
Size
Mandatory
Note
1
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
Citizen ID
ma_dinh_danh_cong_dan
Number string
12 number
Citizen ID issued by Ministry of Public Security
7
Weight
can_nang
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
Weight of patient.
8
Gender
gioi_tinh
Number
x
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
1: No information given
2: Male
3: Female
9
Health insurance code
ma_so_bao_hiem_y_te
String
10 characters
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
String
500 characters
x
Temporary and permanent residence address(es) of
patient
12
Diagnosis
chan_doan
List of medical diagnosis.
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
For traditional medicine prescription: Name of
traditional medicine
19
Name of medicine
ten_thuoc
String
500 characters
x
Trade name of medicine
20
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
don_vi_tinh
String
500 characters
x
Unit of measurement of medicine
21
Quantity
so_luong
Number
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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,…
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
Number string
12 number
Phone number of patient receiving medical
examination
25
Date of re-examination
ngay_tai_kham
Number of day
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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ãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
H:m:s
27
Digital signature
signature
signature
Digital signature of prescribing physician
4. Data returned in case of
failure
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
Value
Note
Header Status
422
JsonData
{
danh_sach_cac_loi
}
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
5. Data returned in case of
success
Field
Value
Note
Header Status
200
Header Content-Type
application/json;charset=UTF-8
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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.
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
URL: www.donthuocquocgia.vn
Field
Value
Note
Link API
/api/v1/thong-tin-don-thuoc/{ma_don_thuoc}
Request Header
Content Type: application/json
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
app-key: {app-key}
Method
GET
Parameter
ma_don_thuoc
3. Data returned in case of
failure
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
Result
Note
Header Status
404
JsonData
{
“danh_sach_cac_loi
}
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
Prescription not found
4. Data returned in case of
success
Field
Value
Note
Header Status
200
Header Content-
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
Type
JsonData
{
ma_don_thuoc: { ma_don_thuoc},
ho_ten_benh_nhan: {ho_ten_benh_nhan},
ngay_sinh_benh_nhan:{ ngay_sinh_benh_nhan },
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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 },
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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 }
}
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
/api/v1/cap-nhat-don-thuoc
Request Header
Content Type: application/json app-name:
{app-name}
app-key: {app-key}
Method
POST
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
{
“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 },
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
“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":
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
“ma_hoa_don”: “ma_hoa_don”
}
3. Input data description
TT
Input data
Field name
Type of data
Size
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
Note
1
Prescription code
ma_don_thuoc
String
14 characters
x
Prescription code
2
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
20 characters
x
Code of prescribed medicine
4
Code of medicine
ma_thuoc
String
20 characters
x
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
Unit of measurement of drugs
8
Quantity
so_luong
Number
x
Quantity of prescribed medicine
9
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
so_luong_ban
Number
x
Number of medicine sold.
10
Administration
cach_dung
String
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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.
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
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
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
12 number
x
Phone number of pharmacy Pos
14
Address of pharmacy Pos
dia_chi_co_so_cung_ung_thuoc
String
2000 characters
x
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
15
Invoice code
ma_hoa_don
String
20 characters
x
Code of medicine retail invoice
4. Data returned in case of
failure
Field
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
Note
Header Status:
404
Header Status:
422
JsonData
{
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
}
List of errors
5. Data returned in case of
success
Field
Value
Note
Header Status
200
...
...
...
Hãy đăng nhập hoặc đăng ký Thành viên
Pro tại đây để xem toàn bộ văn bản tiếng Anh.
application/json;charset=UTF-8
JsonData
{
“Cập nhật đơn thuốc đã bán thành công”
}