Quyết định 777/QĐ-QLD 2018 ban hành Chuẩn kết nối dữ liệu phần mềm kết nối liên thông cơ sở bán lẻ thuốc phiên bản 1.0

BỘ Y TẾ
CỤC QUẢN LÝ DƯỢC
-------

Số: 777/QĐ-QLD

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

Hà Nội, ngày 27 tháng 11 năm 2018

Nơi nhận:
- Như Điều 3,
- Văn phòng Chính phủ (để b/c PTT Vũ Đức Đam);
- Bộ trưởng Nguyễn Thị Kim Tiến (để b/c);
- Các Thứ trưởng Bộ Y tế (để b/c);
- Các Vụ, Cục, Tổng Cục, Thanh tra Bộ Y tế;
- Sở Y tế các tỉnh, TP trực thuộc TW (để p/h thực hiện và b/c UBND tỉnh, thành phố);
- Trung tâm TT - Giáo dục sức khỏe TW;
- Tập đoàn công nghiệp - viễn thông quân đội;
- Các cơ sở cung cấp phần mềm;
- Cơ sở bán lẻ thuốc;
- Cổng thông tin điện tử Cục QLD;
- Lưu: VT, TTra (02).

CỤC TRƯỞNG




Vũ Tuấn Cường

Request URL

api/tai_khoan/dang_nhap

Request Method

POST

Request Header

Content Type: application/json

Form data

{

“usr”: { username },

“pwd”: {password}

}

Dữ liệu dầu vào

Tên Field

Kiểu dữ liệu

Kích thước tối đa

Bắt buộc

Ghi chú

Tên đăng nhập

usr

Chuỗi ký tự (bắt buộc)

50

x

Tên đăng nhập vào hệ thống, do hệ thống dược quốc gia cung cấp khi cơ sở đăng ký

Mật khẩu

pwd

Chuỗi ký tự (bắt buộc)

30

x

Mật khẩu tài khoản.

Trường

Kết quả

Header status:400

Tên đăng nhập hoặc mật khẩu không đúng

Trường

Kết quả

Header status

200

Header Content-Type

application/json;charset=UTF-8

Json data

Trả về là một object bao gồm các thuộc tính sau:

{

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

token type: “bearer”,

}

Request URL

/api/lien_thong/don_thuoc

Request Method

POST

Request Header

Content-Type: application/json

Authorization: bearer {token}

Ghi chú: token lấy được ở trên hàm đăng nhập

Body data

Tên trường

Kiểu dữ liệu

Kích thước tối đa

Bắt buộc

Ghi chú

ma_don_thuoc_co_so_kcb

Chuỗi ký tự

50

Mã đơn thuốc của cơ sở khám chữa bệnh kê đơn

ma_co_so_kcb

Chuỗi ký tự

20

x

Mã cơ sở khám chữa bệnh theo BHXH

ten_co_so_kcb

Chuỗi ký tự

100

x

Tên cơ sở khám chữa bệnh

ma_khoa

Chuỗi ký tự

20

Mã khoa khám bệnh do cơ sở cấp

ten_khoa

Chuỗi ký tự

100

Tên khoa khám bệnh

ma_benh_nhan

Chuỗi ký tự

50

Mã bệnh nhân do cơ sở kcb cấp

ho_ten

Chuỗi ký tự

50

x

Họ tên bệnh nhân

tuoi_benh_nhan

Số

3

x

gioi_tinh

Số

1

Giới tính. Nam - 1, Nữ - 2, Khác - 3

can_nang

Số thập phân

Cân nặng đơn vị Kg. Nếu cân có phần lề thì dùng chấm “.” để phân tách phần thập phân và phần nghìn

chieu_cao

Số

Chiều cao đơn vị là cm.

dia_chi

Chuỗi ký tự

255

x

Địa chỉ nơi ở của bệnh nhân

ma_benh

Chuỗi ký tự

15

x

Mã bệnh lCD10

ten_benh

Chuỗi ký tự

n

x

Tên bệnh, Ghi đầy đủ chẩn đoán theo hồ sơ bệnh án

ma_thuoc

Chuỗi ký tự

50

x

Mã thuốc do hệ thống Dược quốc gia cung cấp

ten_thuoc

Chuỗi ký tự

200

x

Tên thuốc

don_vi_tinh

Chuỗi ký tự

50

x

Tên đơn vị tính của thuốc

ham_luong

Chuỗi ký tự

500

x

Hàm lượng hoạt chất chính

lieu_dung

Chuỗi ký tự

200

x

Liều dùng

so_dang_ky

Chuỗi ký tự

50

x

Số đăng ký của thuốc

so_luong

Số

x

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

ngay_ke_don

Chuỗi ký tự

12

x

Ngày kê đơn. Đinh dạng yyyyMMddHHmm

Trường

Kết quả

Header status:401

Tài khoản chưa xác thực

{

code :401,

mess : "Chưa xác thực tài khoản"

}

Header status:400

Đầu vào chưa hợp lệ:

+ Mã cơ sở khám chữa bệnh không để trống

+ Tài khoản không có quyền truy cập

+ Mã cơ sở khám chữa bệnh sai

+ Đã tồn tại đơn thuốc

Trường

Kết quả

Header status

200

Header Content-Type

application/json;charset=UTF-8

Json data

Trả về là một object bao gồm các thuộc tính sau:

{

Code: 200,

mess : "Tạo đơn thuốc thành công",

ma_don_thuoc_quoc_gia : mã đơn thuốc trên hệ thống Dược quốc gia

}

Request URL

/api/lien_thong/don_thuoc

Request Method

PUT

Request Header

Content-Type: application/json

Authorization: bearer {token}

Ghi chú: token lấy được ở trên hàm đăng nhập

Body data

Trường

Kết quả

Header status:401

Tài khoản chưa xác thực

{

code:401,

mess : "Chưa xác thực tài khoản"

}

Header status:404

Không tồn tại đơn thuốc trên hệ thống

Trường

Kết quả

Header status

200

Header Content-Type

application/json;charset=UTF-8

Json data

Trả về là một object bao gồm các thuộc tính sau:

{

Code: 200,

mess : "Cập nhật đơn thuốc thành công",

ma_don_thuoc_quoc_gia : mã đơn thuốc trên hệ thống Dược quốc gia

}

Request URI,

/api/lien_thong/đon_thuoc/ {ma_co_so} / {ma_don_thuoc }

Request Method

DELETE

Request Header

Content-Type: application/json

Authorization: bearer {token}

Ghi chú: token lấy được ở trên hàm đăng nhập

Request data

ma_co_so: Mã cơ sở khám chữa bệnh theo Bảo hiểm y tế

ma_don_thuoc: Mã đơn thuốc do cơ sở khám chữa bệnh cấp

Trường

Kết quả

Header status:401

Tài khoản chưa xác thực

{

code: 401,

mess : "Chưa xác thực tài khoản"

}

Header status:404

Không tồn tại đơn thuốc

Trường

Kết quả

Header status

200

Header Content-Type

application/json;charset=UTF-8

Json data

Trả về là một object bao gồm các thuộc tính sau:

{

code: 200,

mess : "Xóa thành công"

}

Request URL

/api/lien_thong/hoa_don

Request Method

POST

Request Header

Content-Type: application/json

Authorization: bearer {token}

Ghi chú: token lấy được ở trên hàm đăng nhập

Body data

Tên Field

Kiểu dữ liệu

Kích thước tối đa

Bắt buộc

Ghi chú

ma_hoa_don

Chuỗi ký tự

50

x

Mã hóa đơn của cơ sở

ma_co_so

Chuỗi ký tự

50

x

Mã cơ sở GPP do hệ thống Dược quốc gia cấp

ma_don_thuoc_quoc_gia

Chuỗi ký tự

50

Mã đơn thuốc bán theo hóa đơn mua thuốc

ngay_ban

Chuỗi ký tự

12

x

Ngày bán. Định dạng: yyyyMMdd

ho_ten_nguoi_ban

Chuỗi ký tự

50

Họ tên người bán

ho_ten_khach_hang

Chuỗi ký tự

50

Họ tên khách mua thuốc

ma_thuoc

Chuỗi ký tự

50

x

Mã thuốc do hệ thống Dược quốc gia cung cấp

ten_thuoc

Chuỗi ký tự

500

x

Tên thuốc

so_lo

Chuỗi ký tự

50

x

Số lô của thuốc

ngay_san_xuat

Chuỗi ký tự

12

Ngày sản xuất thuốc. Định dạng: yyyyMMdd

han_dung

Chuỗi ký tự

12

x

Hạn dùng thuốc. Định dạng: yyyyMMdd

don_vi_tinh

Chuỗi ký tự

50

x

Tên đơn vị tính của thuốc

ham_luong

Chuỗi ký tự

500

x

Hàm lượng hoạt chất chính

so_luong

Số

x

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

don_gia

Số

x

Đơn giá thuốc

thanh_tien

Số

x

Thành tiền

ty_le_quy_doi

Số

x

Tỷ lệ quy đổi từ đơn vị tính nhập ở trên so với đơn vị cơ bản

lieu_dung

Chuỗi ký tự

n

x

Liều dùng

duong_dung

Chuỗi ký tự

200

Đường dùng

Trường

Kết quả

Header status:401

Tài khoản chưa xác thực

Header status:400

Đầu vào chưa hợp lệ:

+ Mã cơ sở không chính xác

+ Ngày bán không đúng đinh dạng yyyyMMdd hoặc yyyyMMddHHmm

Trường

Kết quả

Header status

200

Header Content-Type

application/json;charset=UTF-8

Json data

Trả về là một object bao gồm các thuộc tính sau:

{

ma_hoa_don : Mã hóa đơn trên hệ thống Dược quốc gia,

code: 200,

mess : "Thành công",

}

Request URL

/api/lien_thong/hoa_don

Request Method

PUT

Request Header

Content-Type: application/json

Authorization: bearer {token}

Ghi chú: token lấy được ở trên hàm đăng nhập

Body data

Trường

Kết quả

Header status:401

Tài khoản chưa xác thực

Header status:400

Đầu vào chưa hợp lệ.

| Mã cơ sở không chính xác

| Ngày bán không đúng định dạng yyyyMMdd hoặc yyyyMMddHHmm

Header status:404

Không tồn tại hóa đơn

Trường

Kết quả

Header status

200

Header Content-Type

application/json;charset=UTF-8

Json data

Trả về là một object bao gồm các thuộc tính sau:

{

ma_hoa_don : Mã hóa đơn trên hệ thống Dược quốc gia,

code : 200, mess : "Thành công",

}

Request URL

/api/lien_thong/hoa_don/ {ma_co_so} / {ma_hoa_don_co_so}

Request Method

DELETE

Request Header

Content-Type: application/json

Authorization: bearer {token}

Ghi chú: token lấy được ở trên hàm đăng nhập

Request data

ma_co_so: Mã cơ sở Gpp trên hệ thống Dược quốc gia

ma_hoa_don_co_so: Mã đơn thuốc trên hệ thống quốc gia

Trường

Kết quả

Header status:401

Tài khoản chưa xác thực

{

code :401,

mess : "Chưa xác thực tài khoản"

}

Header status:404

Không tồn tại đơn thuốc

Trường

Kết quả

Header status

200

Header Content-Type

application/json;charset=UTF-8

Json data

Trả về là một object bao gồm các thuộc tính sau:

{

code: 200,

mess : "Xóa thông tin thành công"

}

Request URL

/api/lien_thong /phieu_nhap

Request Method

POST

Request Header

Content-Type: application/json

Authorization: bearer {token}

Ghi chú: token lấy được ở trên hàm đăng nhập

Body data

Tên Field

Kiểu dữ liệu

Kích thước tối đa

Bắt buộc

Ghi chú

ma_phieu

Chuỗi ký tự

50

x

Mã phiếu nhập cơ sở GPP

ma_co_so

Chuỗi ký tự

50

x

Mã cơ sở GPP do hệ thống Dược quốc gia cấp

ngay_nhap

Chuỗi ký tự

12

x

Ngày nhập. Định dạng: yyyyMMdd

loai_phieu_nhap

Số

x

1: Nhập từ nhà cung cấp

2: Khách trả

3: Nhập tồn

ghi_chu

Chuỗi ký tự

500

Ghi chú

ten_co_so_cung_cap

Chuỗi ký tự

500

Tên cơ sở cung cấp thuốc (Nếu là phiếu nhập từ nhà cung cấp).

ma_thuoc

Chuỗi ký tự

50

x

Mã thuốc do hệ thống Dược quốc gia cung cấp

ten_thuoc

Chuỗi ký tự

500

x

Tên thuốc

so_lo

Chuỗi ký tự

50

x

Số lô thuốc

ngay_san_xuat

Chuỗi ký tự

12

Ngày sản xuất thuốc. Định dạng: yyyyMMdd

han_dung

Chuỗi ký tự

12

x

Hạn dùng thuốc. Định dạng: yyyyMMdd

so_dklh

Chuỗi ký tự

50

x

Số đăng ký lưu hành của thuốc

so_luong

Số

x

Số lượng thuốc quy ra đơn vị tính nhỏ nhất

don_gia

Số

Đơn giá thuốc

don_vi_tinh

Chuỗi ký tự

200

x

Tên đơn vị tính nhỏ nhất của thuốc

Trường

Kết quả

Header status:401

Tài khoản chưa xác thực

{

code :401,

mess : "Chưa xác thực tài khoản"

}

Header status:400

Đầu vào chưa hợp lệ:

+ Ngày nhập không đúng định dạng yyyyMMdd

+ Mã cơ sở không chính xác

+ Mã phiếu để trống

+ Hạn dùng không đúng định dạng yyyyMMdd

Trường

Kết quả

Header status

200

Header Content-Type

application/json;Charset-UTF-8

Json data

Trả về là một string là mã phiếu nhập trên hệ thống quốc gia

Request URL

/api/lien_thong/phieu_nhap

Request Method

PUT

Request Header

Content-Type: application/json

Authorization: bearer {token}

Ghi chú: token lấy được ở trên hàm đăng nhập

Body data

Trường

Kết quả

Header status:401

Tài khoản chưa xác thực

{

code : 401,

mess : "Chưa xác thực tài khoản"

}

Header status:400

Đầu vào chưa hợp lệ:

+ Ngày nhập không đúng định dạng yyyyMMdd

+ Mã cơ sở không chính xác

+ Mã phiếu để trống

+ Hạn dùng không đúng định dạng yyyyMMdd

Trường

Kết quả

Header status

200

Header Content-Type

application/json;charset=UTF-8

Json data

Trả về là một string là mã phiếu nhập trên hệ thống quốc gia

Request URL

/api/lien_thong/phieu_nhap/ {ma_co_so }/ {ma_phieu}

Request Method

DELETE

Request Header

Content-Type: application/json

Authorization: bearer (token)

Ghi chú: token lấy được ở trên hàm đăng nhập

Request data

ma_co_so: Mã cơ sở Gpp trên hệ thống Dược quốc gia

ma_phieu: Mã phiếu nhập cơ sở

Trường

Kết quả

Header status:401

Tài khoản chưa xác thực

{

code: 401,

mess : "Chưa xác thực tài khoản"

}

Header status:404

Không tồn tại phiếu nhập

Trường

Kết quả

Header status

200

Header Content-Type

application/json;charset=UTF-8

Json data

Trả về là một object bao gồm các thuộc tính sau:

{

code: 200,

mess : " Xóa thông tin thành công"

}

Request URL

/api/lien_thong/phieu_xuat

Request Method

POST

Request Header

Content-Type: application/json

Authorization: bearer {token}

Ghi chú: token lấy được ở trên hàm đăng nhập

Body data

Tên Field

Kiểu dữ liệu

Kích thước tối đa

Bắt buộc

Ghi chú

ma_phieu

Chuỗi ký tự

50

x

Mã phiếu nhập cơ sở GPP

ma_co_50

Chuỗi ký tự

50

x

Mã cơ sở GPP do hệ thống Dược quốc gia cấp

ngay_xuat

Chuỗi ký tự

12

x

Ngày xuất. Định dạng: yyyyMMdd

loai_phieu_xuat

Số

x

2: Xuất trả nhà cung cấp

3: Xuất hủy

ghi_chu

Chuỗi ký tự

500

x

Ghi chú

ten_co_so_nhan

Chuỗi ký tự

500

Tên cơ sở nhận,

ma_thuoc

Chuỗi ký tự

50

x

Mã thuốc do hệ thống Dược quốc gia cung cấp

ten_thuoc

Chuỗi ký tự

500

x

Tên thuốc

so_lo

Chuỗi ký tự

50

x

Số lô thuốc

ngay_san_xuat

Chuỗi ký tự

12

Ngày sản xuất thuốc. Định dạng: yyyyMMdd

han_dung

Chuỗi ký tự

12

x

Hạn dung thuốc. Định dạng: yyyyMMdd

so_dklh

Chuỗi ký tự

50

x

Số đăng ký lưu hành của thuốc

so_luong

Số

x

Số lượng thuốc quy ra đơn vị tính nhỏ nhất

don_gia

Số

x

Đơn giá thuốc

don_vi_tinh

Chuỗi ký tự

200

x

Tên đơn vị tính nhỏ nhất của thuốc

Trường

Kết quả

Header status:401

Tài khoản chưa xác thực

{

code :401,

mess : “Chưa xác thực tài khoản”

}

Header status:400

Đầu vào chưa hợp lệ:

+ Ngày xuất không đúng định dạng yyyyMMdd

+ Mã cơ sở không chính xác

+ Mã phiếu để trống

+ Hạn dùng không đúng định dạng yyyyMMdd

Trường

Kết quả

Header status

200

Header Content-Type

application/json;charset=UTF-8

Json data

Trả về là một string là mã phiếu xuất trên hệ thống quốc gia

Request URL

/api/lien_thong/phieu_xuat

Request Method

PUT

Request Header

Content-Type: application/json

Authorization: bearer {token}

Ghi chú: token lấy được ở trên hàm đăng nhập

Body data

Trường

Kết quả

Header status:401

Tài khoản chưa xác thực

{

code :401,

mess : "Chưa xác thực tài khoản"

}

Header status:400

Đầu vào chưa hợp lệ:

+ Ngày xuất không đúng định dạng yyyyMMdd

+ Mã cơ sở không chính xác

+ Mã phiếu để trống

+ Hạn dùng không đúng định dạng yyyyMMdd

Trường

Kết quả

Header status

200

Header Content-Type

application/json;charset=UTF-8

Json data

Trả về là một string là mã phiếu nhập trên hệ thống quốc gia

Request URL

/api/lien_thong/phieu_xuat/ {ma_co_so}/ {ma_phieu}

Request Method

DELETE

Request Header

Content-Type: application/json

Authorization: bearer {token}

Ghi chú: token lấy được ở trên hàm đăng nhập

Request data

ma_co_so: Mã cơ sở Gpp trên hệ thống Dược quốc gia

ma_phieu: Mã phiếu xuất cơ sở

Trường

Kết quả

Header status: 401

Tài khoản chưa, xác thực

{

code :401,

mess : "Chưa xác thực tài khoản"

}

Header status: 404

Không tồn tại phiếu xuất

Trường

Kết quả

Header status

200

Header Content-Type

application/json;charset=UTF-8

Json data

Trả về là một object bao gồm các thuộc tính sau:

{

code: 200,

mess : " Xóa thông tin thành công"

}