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