TÀI LIỆU HƯỚNG DẪN KẾT NỐI VỚI HỆ THỐNG THÔNG TIN QUỐC GIA VỀ QUẢN LÝ KÊ ĐƠN THUỐC VÀ BÁN THUỐC THEO ĐƠN

CỘNG HOÀ XÃ HỘI CHỦ NGHĨA VIỆT NAM Độc lập - Tự - Hạnh phúc 1/0 /20 22 09 :20 :49 BỘ Y TẾ _v t_S oY te K on Tu m _0 TÀI LIỆU HƯỚNG DẪN KẾT NỐI VỚI HỆ THỐNG THÔNG TIN QUỐC GIA VỀ QUẢN LÝ KÊ ĐƠN THUỐC VÀ BÁN THUỐC THEO ĐƠN (Ban hành kèm theo Quyết định số 808 /QĐ-BYT ngày 01 tháng 04 năm 2022) t_k on tum I QUY TRÌNH THỰC HIỆN KẾT NỐI VỚI HỆ THỐNG THÔNG TIN QUỐC GIA QUẢN LÝ KÊ ĐƠN THUỐC VÀ BÁN THUỐC THEO ĐƠN sy Đối với Cơ quan quản lý ( Sở y tế Tỉnh, Thành phố trực thuộc trung ương, y tế ngành Phòng quản lý hành nghề - Cục quản lý khám chữa bệnh): Cục Quản lý Khám, chữa bệnh có trách nhiệm quản lý, vận hành hệ thống thông tin quốc gia quản lý kê đơn thuốc bán thuốc theo đơn bảo đảm hiệu năng, an tồn thơng tin theo quy định pháp luật Sở y tế tỉnh thành phố trực thuộc trung ương, y tế ngành liên hệ với Cục Quản lý Khám chữa bệnh - Bộ Y tế để cấp tài khoản quản trị Khi đăng nhập vào tài khoản trang thơng tin điện tử: www.donthuocquocgia.vn có tài liệu hướng dẫn chi tiết trực tuyến Sở y tế, y tế ngành để nghị sở hành nghề y người hành nghề (trong phạm vi quản lý mình) thực đăng ký thơng tin cấp mã định danh lên hệ thống tự động trang thông tin điện tử: www.donthuocquocgia.vn (Thư mục: Đăng ký bác sỹ - Đăng ký sở) tập hợp danh sách gửi lên Cục quản lý khám chữa bệnh để đăng ký với số lượng lớn Cán chuyên môn Sở, y tế ngành phụ trách đọc kiểm tra tài liệu sở người hành nghề đăng ký phê duyệt thông tin Sau phê duyệt, mã định danh hệ thống tự động cấp cho hồ sơ Cán sở, y tế ngành có trách nhiệm bàn giao mã định danh người hành nghề sở hành nghề tới đơn vị Quy trình thực tương tự với phịng quản lý hành nghề Cục quản lý khám chữa bệnh, đơn vị quản lý hành nghề sở trực thuộc Bộ y tế Đối với sở khám bệnh, chữa bệnh Cử cán thực việc đăng ký thông tin sở người kê đơn thuốc sở lên trang thông tin điện tử: www.donthuocquocgia.vn tập hợp danh sách gửi cho Sở y tế, Bộ y tế 09 :20 :49 Tiếp nhận thông tin mã định danh sở người hành nghề từ quản chủ quản Tu m _0 1/0 /20 22 Thực phối hợp với đơn vị cung cấp phần mềm quản lý sở khám chữa bệnh để triển khai đưa mã định danh người hành nghề sở hành nghề vào phiên đăng nhập hệ thống phần mềm quản lý sở khám chữa bệnh HIS (tài liệu hướng dẫn cụ thể phần III, phần IV phần V) tum _v t_S oY te K on Chỉ đạo đơn vị cung cấp phần mềm quản lý sở khám chữa bệnh thực kết nối liên thông đơn thuốc kê tới hệ thống thông tin quốc gia quản lý kê đơn thuốc bán thuốc theo đơn Bộ y tế (tài liệu hướng dẫn cụ thể phần II phần VI) sy t_k on Đối với Các sở cung ứng thuốc Cục quản lý dược yêu cầu đơn vị cung cấp phần mềm quản lý sở cung ứng thuốc chỉnh sửa phần mềm đáp ứng yêu cầu đón đơn thuốc từ hệ thống thông tin quốc gia quản lý kê đơn thuốc bán thuốc theo đơn (tài liệu hướng dẫn số phần VII phần VIII) Cục quản lý dược phối hợp với cục quản lý khám chữa bệnh khởi tạo cho nhà cung cấp phần mềm quản trị sở cung ứng thuốc (Pos) tài khoản liên thông theo nhà cung cấp Báo cáo đơn thuốc bán gửi lên kèm theo tài khoản để xác minh đơn thuốc bán theo phần mềm nhà cung cấp nào, sở bán sở Đồng thời phần mềm quản lý sở cung thuốc gửi báo cáo đơn thuốc bán Hệ thống (tài liệu hướng dẫn cụ thể phần VII phần VIII) Đối với bác sỹ kê đơn thuốc: Đăng ký thông tin để cấp mã đinh danh hệ thống trang thông tin điện tử: www.donthuocquocgia.vn gửi thơng tin cho sở đơn vị làm việc để đăng ký tập thể Tiếp nhận lưu giữ: Mã định danh cá nhân (bao gồm tài khoản mật khẩu) Sau phần mềm quản lý sở khám chữa bệnh hoàn thiện chỉnh sửa, thực việc kê đơn thuốc thao tác làm trước hệ thống CNTT tự động thực việc gửi báo cáo đơn thuốc Đối với người dân Người dân tự tra cứu tìm kiếm đơn thuốc thơng qua mã đơn thuốc hệ thống trang thông tin điện tử: www.donthuocquocgia.vn 09 :20 :49 II HƯỚNG DẪN GỬI ĐƠN THUỐC LÊN DONTHUOCQUOCGIA.VN Tu m _0 1/0 /20 22 Đối tượng thực Các sở hành nghề khám, chữa bệnh có sử dụng hệ thống phần mềm quản lý HIS phần mềm quản lý sở khác nhiều đơn vị cung cấp dịch vụ te K on Các sở cung ứng thuốc sử dụng phần mềm nhà cung cấp dịch vụ sy t_k on tum _v t_S oY Các điều kiện để gửi đơn thuốc - Có đường truyền Internet - Các đơn vị có phần mềm đạt tiêu chuẩn theo tài liệu - Cơ sở khám chữa bệnh cần phải có mã liên thơng donthuocquocgia.vn cấp - Bác sĩ kê đơn phải có mã liên thông donthuocquocgia.vn cấp - Cơ sở khám chữa bệnh cần phải thêm bác sĩ vào phần mềm kê đơn (Sử dụng API thêm bác sĩ) Thêm xóa bác sĩ cho phần mềm sở khám chữa bệnh Để thêm hay xóa bác sĩ cho phần mềm sở khám chữa bệnh cần phải lấy phiên làm việc hướng dẫn tài liệu Gửi đơn thuốc lên donthuocquocgia.vn - Để gửi đơn thuốc lên cần lấy phiên đăng nhập bác sĩ, phiên đăng nhập cho thời gian hiệu lực ngày Phần lấy phiên đăng nhập hướng dẫn tài liệu phần API gửi đơn thuốc - Để gửi đơn thuốc lên cần thực hoàn thiện phần mềm quản lý thông tin (HIS,…) cho đáp ứng tiêu chuẩn API quy định tài liệu Lấy đơn thuốc cập nhật đơn thuốc bán - Phần mềm quản lý sở cung ứng thuốc đáp ứng liên thông Dược Quốc gia cần sử dụng mã đơn thuốc để gọi thông tin đơn thuốc phần mềm - Chỉnh sửa phần mềm để tiếp nhận đơn thuốc điện tử thành hóa đơn bán hàng theo tài liệu - Chỉnh sửa phần mềm để báo cáo liên thống số lượng thuốc bán theo tài liệu phần cập nhật đơn thuốc 09 :20 :49 III API CƠ SỞ KHÁM CHỮA BỆNH DÙNG ĐỂ ĐĂNG NHẬP 1/0 /20 22 Điều kiện mục đích sử dụng - Điều kiện: Cơ sở khám chữa bệnh phải cấp mã liên thông mật hệ thống đơn thuốc quốc gia te K on Tu m _0 - API sử dụng cho phần mềm kê đơn đăng nhập token cho phiên làm việc Token sử dụng API thêm bác sĩ vào sở khám chữa bệnh API xóa bác sĩ khỏi sở khám chữa bệnh t_S oY - Token đăng nhập có hiệu lực ngày sy t_k on tum _v Mô tả URL: https://api.donthuocquocgia.vn Trường thông tin Giá trị Ghi 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" : { ma_lien_thong_co_so_kham_chua_benh }, "password" : { password } } Dữ liệu đầu vào Dữ liệu Tên trường liệu đầu vào Mã liên ma_lien_thong_co_so_ thông kham_chua_benh sở khám Kiểu liệu Chuỗi ký tự Bắt buộc Ghi x Mã liên thông sở khám chữa bệnh mà bác sĩ thêm vào password Chuỗi ký tự x Mật tài khoản sở khám chữa bệnh te K on Tu m _0 1/0 /20 Mật 22 09 :20 :49 chữa bệnh Giá trị Ghi on tum _v t_S oY Dữ liệu trả lỗi Trường thông tin Mã liên thông sở khám chữa bệnh mật không 422 sy t_k Header Status Dữ liệu trả trường hợp thành công Trường thông Giá trị tin Header Status Ghi 200 Header Content- application/json;charset=UTF-8 Type JsonData - token sử dụng cho phiên làm việc { token: { token } token_type: “bearer” } - token type: loại token bearer để truyền lên kèm theo token 09 :20 :49 IV API THÊM BÁC SĨ VÀO CƠ SỞ KHÁM CHỮA BỆNH 1/0 /20 22 Điều kiện mục đích sử dụng - Điều kiện: bác sĩ cấp mã liên thông hệ thống đơn thuốc quốc gia te K on Tu m _0 - Cơ sở dùng API đăng nhập sở khám chữa bệnh để lấy token cho phiên làm việc _v t_S oY Mô tả URL: https://api.donthuocquocgia.vn Trường thông tin Ghi sy t_k on tum Giá trị Link API /api/v1/them-bac-si Method POST Request Header Content Type: application/json FormData { Authorization: bearer { token } “ma_lien_thong_bac_si”: { ma_lien_thong_bac_si } } token lấy API đăng nhập sở khám chữa bệnh :49 09 :20 Dữ liệu đầu vào 22 Tên trường liệu Kiểu liệu Kích Bắt thước buộc Ghi ma_lien_thong_bac_si Chuỗi ký tự x sy t_k on tum _v t_S oY Mã liên thông bác sĩ te K on Tu m _0 1/0 /20 Dữ liệu đầu vào Dữ liệu trả lỗi Trường thông tin Giá trị Mã liên thông bác sĩ kê đơn cung cấp hệ thống đơn thuốc điện tử Ghi Header Status 422 JsonData {danh_sach_cac_loi} Danh sách lỗi Dữ liệu trả trường hợp thành công Trường thông tin Giá trị Ghi Header Status 200 Header Content-Type application/json;charset=UTF-8 JsonData { 'success' => 'Bạn thêm bác sĩ thành công' } 09 :20 :49 V API XÓA BÁC SĨ KHỎI CƠ SỞ KHÁM CHỮA BỆNH t_S oY te K on Tu m _0 1/0 /20 22 Mục tiêu - Điều kiện: bác sĩ cấp mã liên thông hệ thống đơn thuốc quốc gia thêm vào sở khám chữa bệnh dựa API mục I - Cơ sở dùng API đăng nhập sở khám chữa bệnh để lấy token cho phiên làm việc Mô tả tum _v URL: https://api.donthuocquocgia.vn Giá trị Mô tả sy t_k on Trường thông tin Link API /api/v1/ xoa-bac-si Method POST Request Header Content Type: application/json FormData { Authorization: bearer { token } token lấy API đăng nhập sở khám chữa bệnh “ma_lien_thong_bac_si” : { ma_lien_thong_bac_si } } Dữ liệu đầu vào Dữ liệu Tên trường liệu Kiểu Kích Bắt Ghi đầu vào liệu thước buộc Mã liên ma_lien_thong_bac_si Chuỗi ký x Mã liên thông thông tự bác sĩ kê đơn bác sĩ cung cấp hệ thống đơn thuốc quốc gia 09 :20 :49 Dữ liệu trả lỗi Giá trị Ghi /20 22 Trường thông tin 422 { Danh sách lỗi danh_sach_cac_loi } t_S oY te K on Tu m _0 JsonData 1/0 Header Status Trường thông tin Giá trị t_k on tum _v Dữ liệu trả trường hợp thành công 200 Header Content-Type application/json;charset=UTF-8 JsonData { 'success' => 'Bạn xóa bác sĩ khỏi sở khám chữa bệnh thành công' } sy Header Status Ghi 09 :20 :49 VI API ĐĂNG NHẬP BÁC SĨ 1/0 /20 22 Điều kiện mục đích sử dụng - Điều kiện: bác sĩ cấp mã liên thông mật hệ thống đơn thuốc quốc gia t_S oY te K on Tu m _0 - Mục đích API sử dụng đăng nhập bác sĩ lấy token cho phiên làm việc gửi đơn thuốc lên hệ thống đơn thuốc quốc gia Khi đăng nhập cần tài khoản liên thông bác sĩ mã liên thông sở khám chữa bệnh mà bác sĩ thêm vào phần IV tum _v - Token đăng nhập có hiệu lực ngày sy t_k on Mô tả URL: https://api.donthuocquocgia.vn Trường thông tin Giá trị Link API /api/auth/dang-nhap-bac-si Method POST Request Header Content-Type: application/json FormData { Ghi "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 } } Dữ liệu đầu vào Dữ liệu đầu Tên trường liệu vào Kiểu Bắt Ghi liệu buộc Mã liên thông ma_lien_thong_bac_si bác sĩ Chuỗi ký tự 10 x Mã liên thông bác sĩ 09 :20 :49 “ho_ten_benh_nhan”:{ho_ten_benh_nhan}, 22 “ma_dinh_danh_y_te”: {ma_dinh_danh_y_te}, Tu m _0 1/0 /20 “ma_dinh_danh_cong_dan”: {ma_dinh_danh_cong_dan}, sy t_k on tum _v t_S oY te K on “ngay_sinh_benh_nhan”: { ngay_sinh_benh_nhan }, “can_nang” : { can_nang }, “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 }, “ket_luan” : { ket_luan }, }], “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 }, 13 09 :20 :49 “don_vi_tinh” : { don_vi_tinh }, 22 “so_luong” : { so_luong }, _0 Tu m }], 1/0 /20 “cach_dung” : { cach_dung }, “so_dien_thoai_nguoi_kham_benh”: {so_dien_thoai_nguoi_kham_benh}, t_k on tum _v t_S oY te K on “loi_dan” : { loi_dan }, “ngay_tai_kham” : {ngay_tai_kham}, sy “ngay_gio_ke_don” : { ngay_gio_ke_don}, “signature”: { chu_ky_so} } Dữ liệu đầu vào Dữ T liệu TT đầu vào Loại đơn thuốc Tên trường liệu loai_don_thuoc Kiểu liệu Kích Bắt thước buộc [ c, h, n, y] ký tự x Ghi Loại đơn thuốc ứng với ký tự: - c: loại đơn thuốc - h: loại đơn thuốc hướng tâm thần thuốc tiền chất - n: loại đơn thuốc gây nghiện -y: 14 loại đơn 09 :20 :49 thuốc cổ truyền Chuỗi kỹ 14 ký tự tự x t_S oY te K on Tu m _0 1/0 /20 22 Mã đơn ma_don_thuoc thuốc Mã đơn thuốc từ khóa để tìm kiếm đơn thuốc hệ thống đơn thuốc điện tử Mã đơn thuốc phải sy t_k on tum _v Mã đơn thuốc cấu trúc gồm mã bảo hiểm sở khám chữa bệnh(5 ký tự) + ký tự bao gồm chữ số + ký tự cuối ‘c’ – đơn thuốc chuẩn, ‘-n’ – đơn thuốc gây nghiện, ‘-h’ – đơn thuốc hướng thần, ‘-y’ – đơn thuốc y học cổ truyền Họ tên ho_ten_benh_ bệnh nhan nhân Chuỗi kỹ 500 ký tự tự x Họ tên bệnh nhân đến khám chữa bệnh Ngày sinh bệnh nhân Date: d/m/Y x Ngày sinh bệnh nhân ngay_sinh_benh _nhan Date format: Ngày/Tháng/Nă m 15 Mã định danh y tế bệnh nhân Chuỗi số Cân nặng can_nang Số Giới tính gioi_tinh Số Mã định danh công dân cấp bới công an 12 số sy t_k tum _v t_S oY te K on Tu m ma_dinh_danh _cong_dan on Mã định danh công dân _0 1/0 /20 22 09 :20 :49 Mã ma_dinh_danh_y Chuỗi ký 10 ký định _te tự tự danh y tế x Cân nặng bệnh nhân Giới tính bệnh nhân 1: Chưa có thơng tin 2: Giới tính Nam 3: Giới tính nữ Mã số ma_so_bao_ bảo hiem_y_te hiểm y tế Chuỗi ký 10 ký tự tự Mã số bảo hiểm y tế bệnh nhân có Thơng tin 10 người giám hộ Chuỗi ký 500 ký Bắt tự tự buộc trườn g hợp người khám bệnh trẻ em 72 Thông tin người giám hộ: Họ tên, Số điện thoại, địa người giám hộ thong_tin_nguoi _giam_ho 16 /20 22 09 :20 :49 tháng tuổi Chuỗi ký 500 ký tự tự x Địa thường trú, tạm trú bệnh nhân Danh sách chẩn đốn bệnh x Thơng tin phần tử chẩn đoán: te K on Tu m _0 1/0 11 Địa dia_chi bệnh nhân t_S oY chan_doan ma_benh: Mã bệnh theo ICD10 t_k on tum _v 12 Chẩn đoán sy ten_benh: Tên bệnh theo ICD10 ket_luan: Kết luận bác sĩ 13 Lưu ý luu_y Chuỗi ký 2000 tự ký tự 14 Hình thức điều trị hinh_thuc_dieu _tri Số Bắt Danh mục hình buộc thức điều trị ban hành Bộ Y tế loại đơn thuốc đơn thuốc 15 Đợt dùng thuốc dot_dung_thuoc Danh sách Bắt buộc loại đơn thuốc h, 17 Lưu ý bác sĩ Danh sách đợt dùng thuốc gồm: - Đợt: số - từ ngày: Date format d/m/Y - đến ngày: Date format d/m/Y Thông tin đơn thuốc bao gồm danh sách thuốc kê đơn x Các phần tử thông tin thuốc gồm mã thuốc, biệt dược, tên thuốc, đơn vị tính, số lượng cách dùng mô tả hàng bên - Số thang thuốc: yêu cầu thuốc y học cổ truyền te K on Tu m _0 1/0 /20 22 09 :20 :49 n y sy t_k on tum _v t_S oY 16 Thông thong_tin_don tin đơn _thuoc thuốc 17 Mã thuốc ma_thuoc Chuỗi ký 20 ký tự tự x Danh mục mã thuốc cấp cục quản lý dược Bộ Y tế 18 Biệt dược biet_duoc Chuỗi ký 500 ký tự tự x Biệt dược ( hoạt chất ) thuốc Đối với đơn thuốc y học cổ truyền: Tên dược liệu, vị thuốc cổ truyền 19 Tên thuốc ten_thuoc 20 Đơn vị don_vi_tinh tính Chuỗi ký 500 ký tự tự x Tên thương mại thuốc Chuỗi ký 500 ký tự tự x Đơn vị tính thuốc 18 :49 so_luong Số x Số lượng thuốc kê theo đơn vị tính Chuỗi ký 500 ký tự tự x Cách dùng thuốc bao gồm: đường dùng, liều dùng, thời gian dùng,… on cach_dung on tum _v t_S oY te K 22 Cách dùng Tu m _0 1/0 /20 22 09 :20 21 Số lượng sy t_k 23 Lời dặn loi_dan Chuỗi ký 2000 tự ký tự Lời dặn bác sĩ Đối với đơn thuốc y học cổ truyền cần mô tả thêm: Cách sắc thuốc, cách uống thuốc 24 Số điện so_dien_thoai thoại _nguoi_kham người _benh khám bệnh Chuỗi số 25 Ngày tái khám Số ngày Số ngày bệnh nhân đến khám lại kể từ ngày kê đơn Datetime: Y-m-d H:m:s Ngày bác sĩ kê đơn phần mềm gửi lên Ngày kê đơn bao gồm ngày có cấu trúc:Y-m-d ngay_tai_kham 26 Ngày ngay_gio_ke_ kê don đơn 19 12 số Số điện thoại liên lạc người đến khám bệnh 09 :20 :49 H:m:s signature Chữ ký số người kê đơn on Tu m _0 1/0 /20 22 27 Chữ ký signature số t_S oY te K Dữ liệu trả lỗi Trường thông tin Ghi 422 on tum _v Header Status Giá trị { sy t_k JsonData Danh sách lỗi danh_sach_cac_loi } Dữ liệu trả trường hợp thành công Trường thông tin Giá trị Header Status Ghi 200 Header Content-Type application/json;charset=UTF-8 JsonData { 'success' => 'Gửi đơn thuốc thành công' } VIII API LẤY ĐƠN THUỐC Điều kiện mục đích sử dụng - Api sử dụng cho nhà thuốc lấy thông tin đơn thuốc đơn thuốc quốc gia phần mềm bán thuốc để bán - Yêu cầu: đơn vị cung cấp phần mềm liên hệ với đơn vị hỗ trợ vận hành để lấy app-name app-key sử dụng cho API App-name app-key thông tin bảo mật tương ứng với đơn vị phần mềm Khi lấy thông tin đơn thuốc phải gửi kèm app-name app-key 20 Giá trị 1/0 /20 Trường thông tin 22 09 :20 :49 Mô tả URL: www.donthuocquocgia.vn /api/v1/thong-tin-donthuoc/{ma_don_thuoc} te K on Tu m _0 Link API Ghi t_S oY Request Header Content Type: application/json tum _v app-name: {app-name} sy t_k on app-key: {app-key} Method GET Tham số ma_don_thuoc Dữ liệu trả lỗi Trường thông tin Header Status 404 JsonData { Kết Ghi Danh sách lỗi: “danh_sach_cac_loi } Dữ liệu trả trường hợp thành công Trường Giá trị thông tin Header Status 200 Header Content- application/json;charset=UTF-8 21 Không thuốc tìm thấy đơn Ghi 22 { /20 JsonData 09 :20 :49 Type _0 1/0 ma_don_thuoc: { ma_don_thuoc}, Tu m ho_ten_benh_nhan: {ho_ten_benh_nhan}, sy t_k on tum _v t_S oY te K on ngay_sinh_benh_nhan:{ ngay_sinh_benh_nhan }, ma_dinh_danh_y_te: { ma_dinh_danh_y_te }, 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 }, chan_doan: { chan_doan }, 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 } } 22 09 :20 :49 IX API CẬP NHẬT SỐ LƯỢNG BÁN 1/0 /20 22 Điều kiện mục đích sử dụng - Api sử dụng cho nhà thuốc cập nhật số lượng bán bán đơn thuốc lên hệ thông đơn thuốc đơn thuốc quốc gia t_S oY te K on Tu m _0 - Yêu cầu: đơn vị cung cấp phần mềm liên hệ với đơn vị hỗ trợ vận hành để lấy app-name app-key sử dụng cho API App-name app-key thông tin bảo mật tương ứng với đơn vị phần mềm Khi cập nhật số lượng bán thuốc phải gửi kèm app-name app-key t_k on tum _v Mô tả URL: www.donthuocquocgia.vn Trường thông tin sy Giá trị Ghi Link API /api/v1/cap-nhat-don-thuoc Request Header Content Type: application/json app-name: {app-name} app-key: {app-key} Method POST Tham số { “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 }, 23 09 :20 :49 “so_luong” : { so_luong }, /20 22 “cach_dung” : { cach_dung } 1/0 }], { 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": t_k on tum _v t_S oY te K on Tu m _0 "ma_dinh_danh_co_so_cung_ung_thuoc": sy { so_dien_thoai_co_so_cung_ung_thuoc}, "dia_chi_co_so_cung_ung_thuoc": { dia_chi _co_so_cung_ung_thuoc }, “ma_hoa_don”: “ma_hoa_don” } Mô tả liệu đầu vào Dữ liệu Tên trường liệu đầu vào Kiểu Kích Bắt thước buộc liệu Mã đơn ma_don_thuoc thuốc Chuỗi 14 ký kỹ tự tự x Mã đơn thuốc Thông tin thuốc Thôn g tin thuốc danh sách gồm nhiều x Mỗi thuốc gồm có thơng tin: TT thong_tin_thuoc 24 Ghi Mã thuốc kê, Mã thuốc, Biệt dược Tên thuốc, Đơn vị tính, Số lượng, Số lượng bán), :49 Cách dùng mô tả hàng bến bảng Tu m _0 1/0 /20 22 09 :20 thuốc Mã ma_thuoc_da_ke_ thuốc don kê đơn Chuỗi 20 ký kỹ tự tự x Mã thuốc kê theo đơn thuốc kéo Mã thuốc ma_thuoc Chuỗi 20 ký kỹ tự tự x Mã thuốc bán Trường hợp bán thuốc thay có cơng dụng tương tự gửi lên mã thuốc thay Biệt dược biet_duoc Chuỗi 200 ký tự ký tự x Biệt dược( hoạt chất) thuốc bán Đối với đơn thuốc y học cổ truyền tên dược liệu, vị thuốc cổ truyền Tên thuốc ten_thuoc Chuỗi 200 kỹ tự ký tự x Tên thuốc bán Trường hợp bán thuốc thay có cơng dụng tương tự gửi lên tên thuốc thay tum _v t_S oY te K on sy t_k on 25 Đơn vị don_vi_tinh tính x Đơn vị tính thuốc Số lượng Số x Số lượng thuốc kê Số lượng bán so_luong_ban Số x Số lượng bán thuốc Cách dùng cach_dung Chuỗi 200 ký tự ký tự x Cách dùng thuốc Trường hợp bán thuốc thay có cơng dụng tượng tự gửi lên cách dùng thuốc thay 11 Mã ma_dinh_danh_co_ định so_cung_ung_thuoc danh sở cung ứng thuốc Chuỗi 200 ký tự ký tự x Mã định danh sở cung ứng thuốc 12 Tên ten_co_so_cung_ung Chuỗi 2000 sở cung _thuoc ký tự ký tự ứng thuốc x Tên sở cung ứng thuốc 13 Số điện so_dien_thoai_co_so Chuỗi 12 số thoại _cung_ung_thuoc số sở cung ứng thuốc x Số điện thoại sở cung ứng thuốc 14 Địa dia_chi_co_so_cung_ Chuỗi 2000 sở ung_thuoc ký tự ký tự cung x Địa sở cung ứng 22 09 :20 :49 Chuỗi 200 ký tự ký tự /20 sy t_k on tum _v 10 t_S oY te K on Tu m _0 1/0 so_luong 26 thuốc 22 09 :20 :49 ứng thuốc Mã hóa ma_hoa_don đơn Chuỗi 20 ký ký tự tự x Mã hóa đơn bán lẻ thuốc te K on Tu m _0 1/0 /20 15 _v t_S oY Dữ liệu trả lỗi Trường thông tin Ghi 404 t_k on tum Header Status: Giá trị 422 JsonData { sy Header Status: Danh sách lỗi danh_sach_cac_loi } Dữ liệu trả trường hợp thành công Trường thông tin Giá trị Header Status 200 Header Content-Type application/json;charset=UTF-8 JsonData { “Cập nhật đơn thuốc bán thành công” } 27 Ghi