Cấu hình liên thông DQG
Cấu hình liên thông DQG là nơi khai tài khoản cơ sở của phòng khám trên cổng Đơn thuốc Quốc gia (donthuocquocgia.vn). Khai xong, phần mềm mới đăng nhập được vào cổng để gửi đơn thuốc điện tử và để thêm bác sĩ vào cơ sở trên cổng.
Mỗi bộ thông tin như vậy gọi là một giấy phép. Một khách có thể có nhiều giấy phép (ví dụ nhiều phòng khám riêng), còn mỗi chi nhánh chỉ thuộc đúng một giấy phép.
Bạn cần quyền quản lý cấu hình mới mở được trang này.
| Cấp | Khai ở đâu | Dùng để |
|---|---|---|
| Tài khoản cơ sở (phòng khám) | Trang này | Đăng nhập cổng, thêm/gỡ bác sĩ khỏi cơ sở |
| Tài khoản bác sĩ | Tài khoản liên thông bác sĩ | Gửi từng đơn thuốc |
Nhập nhầm mật khẩu của cấp này vào ô của cấp kia là lý do bị cổng từ chối nhiều nhất.
Đường đi từ lúc chưa có gì đến lúc gửi được đơn
| Bước | Làm ở đâu | Nội dung |
|---|---|---|
| 1 | Cổng DQG | Cơ sở đăng ký, Sở Y tế duyệt → có mã liên thông cơ sở. |
| 2 | Trang này | Tạo giấy phép bằng mã và mật khẩu cơ sở. |
| 3 | Trang này | Bấm Chi nhánh & bác sĩ, gán chi nhánh vào giấy phép. |
| 4 | Cổng DQG | Từng bác sĩ khai hồ sơ → phòng khám duyệt → Sở Y tế duyệt → bác sĩ có mã liên thông bác sĩ. |
| 5 | Cấu hình hệ thống | Khai mã của từng bác sĩ ở Tài khoản liên thông bác sĩ. |
| 6 | Trang này | Bấm Chi nhánh & bác sĩ → Thêm lên cổng cho từng bác sĩ. |
Thiếu bất kỳ bước nào ở trên thì đơn thuốc sẽ không gửi được, và phần mềm báo đúng bước còn thiếu — xem Lỗi thường gặp.
Chuẩn bị trước trên donthuocquocgia.vn
Đăng nhập cổng bằng tài khoản cơ sở. Trang tổng quan phải ghi hồ sơ đã được phê duyệt và hiện mã liên thông. Chưa được duyệt thì chưa khai vào phần mềm được.
Mã liên thông cơ sở = 01 + mã cơ sở. Mã cơ sở gồm 5 ký tự theo QĐ 384; tỉnh nào cấp
hết số thì phần đuôi có chữ. Ví dụ mã cơ sở 79abc thì mã liên thông là 0179abc.
Mã cơ sở nằm ở mục Thông tin thành viên trên cổng:

Hình minh họa trang Thông tin thành viên trên cổng Đơn thuốc Quốc gia
Ô số 1 là Mã cơ sở — lấy đúng chuỗi này rồi thêm 01 phía trước. Các thông tin
khác trên ảnh đã được làm mờ.
0179abc và 0179ABC là hai mã khác nhau. Chép đúng như cổng hiển thị, đừng tự viết hoa
cho đẹp.
Trang web của cổng cho đăng nhập bằng tên đăng nhập, email hoặc mã liên thông. Phần mềm chỉ dùng được mã liên thông. Nhiều phòng khám quen gõ tên đăng nhập nên đưa nhầm chuỗi đó vào phần mềm.
Danh sách giấy phép

Hình minh họa màn hình Cấu hình liên thông DQG
| # | Là gì |
|---|---|
| 1. Nút Tạo mới | Khai thêm một giấy phép. |
| 2. Cột Mã liên thông cơ sở | Mã dùng để đăng nhập cổng. |
| 3. Cột Mã bảo hiểm cơ sở | 5 ký tự đầu của mọi mã đơn thuốc gửi lên cổng. |
| 4. Cụm nút cuối mỗi dòng | Biểu tượng sơ đồ mở Chi nhánh & bác sĩ, bút chì để sửa, thùng rác để xoá. |
Các cột còn lại: Tên cơ sở khám chữa bệnh, Địa chỉ cổng và Trạng thái (Đang bật liên thông / Đang tắt). Trong hình, mã và tên cơ sở đã được làm mờ.
Thêm hoặc sửa giấy phép
Bấm Tạo mới để mở hộp thoại Thêm giấy phép liên thông.

Hình minh họa hộp thoại Thêm giấy phép liên thông
| # | Ô | Nhập gì |
|---|---|---|
| 1. | Tên cơ sở khám chữa bệnh (bắt buộc) | Tên đúng như trên giấy phép hoạt động. |
| 2. | Mã liên thông cơ sở (bắt buộc) | 01 + mã cơ sở, đúng như cổng hiển thị. Không dùng lại mã đã khai ở giấy phép khác. |
| 3. | Mã bảo hiểm cơ sở | Đúng 5 ký tự — chính là mã cơ sở, tức mã liên thông bỏ 01 ở đầu. Giữ nguyên hoa thường. |
| 4. | Địa chỉ cổng | Điền sẵn https://api.donthuocquocgia.vn theo QĐ 808/QĐ-BYT. Chỉ sửa khi cổng thông báo địa chỉ khác. |
| 5. | Mật khẩu cơ sở (bắt buộc khi tạo) | Mật khẩu tài khoản cơ sở trên donthuocquocgia.vn. |
| 6. | Đang bật liên thông | Tắt thì mọi chi nhánh thuộc giấy phép này ngừng gửi đơn. |
| 7. | Lưu | Ghi giấy phép vào phần mềm. |
Ô Ghi chú để ghi nhớ nội bộ, không gửi lên cổng.
Mã bảo hiểm là 5 ký tự đầu của mã đơn thuốc, nên chưa khai thì phần mềm chưa dựng được mã đơn. Bạn vẫn lưu giấy phép được để làm tiếp phần khác, rồi bổ sung sau.
Nhập mật khẩu cho chắc
- Bấm biểu tượng con mắt để nhìn ký tự đang gõ — tránh trình duyệt tự điền một mật khẩu khác mà bạn không biết.
- Gõ tay, tắt bộ gõ tiếng Việt. Dán từ chỗ khác dễ dính dấu cách thừa.
- Phần mềm không hiện lại mật khẩu đã lưu (lưu dưới dạng mã hoá). Khi sửa, để trống ô mật khẩu nghĩa là giữ nguyên mật khẩu cũ.
- Đổi mật khẩu trên cổng thì phải vào đây cập nhật lại, nếu không các đơn sau đó không gửi được.
Đừng gửi mật khẩu tài khoản cơ sở qua chat, email hay tin nhắn. Lỡ để lộ thì đổi mật khẩu trên donthuocquocgia.vn trước, rồi vào sửa lại giấy phép ở đây.
Chi nhánh & bác sĩ
Trên dòng giấy phép, bấm biểu tượng sơ đồ để mở hộp thoại Giấy phép: <tên cơ sở>.

Hình minh họa hộp thoại Giấy phép
Chi nhánh thuộc giấy phép này
Đơn thuốc được gửi bằng giấy phép của chi nhánh nơi lập đơn. Chi nhánh chưa gán vào giấy phép nào thì đơn ở chi nhánh đó không gửi được.
Chọn chi nhánh trong ô rồi bấm Gán chi nhánh (số 1). Chi nhánh đã gán hiện thành một thẻ nhỏ bên dưới, bấm dấu ✕ để gỡ.
Một chi nhánh chỉ thuộc đúng một giấy phép — chọn chi nhánh đang thuộc giấy phép khác sẽ bị từ chối. Và không xoá được giấy phép còn chi nhánh: gỡ hết chi nhánh trước đã.
Bác sĩ trên cổng quốc gia
Chọn bác sĩ trong ô Chọn bác sĩ... rồi bấm Thêm lên cổng (số 2). Mỗi bác sĩ chỉ cần làm một lần cho mỗi giấy phép.
Ô chọn chỉ liệt kê bác sĩ đã khai mã ở trang Tài khoản liên thông bác sĩ. Chưa khai ai thì hộp thoại báo "Chưa có bác sĩ nào khai báo mã liên thông…".
Gỡ khỏi cổng cắt liên thông của bác sĩ trên hệ thống của Bộ Y tế, không phải chỉ xoá trong phần mềm. Bác sĩ sẽ không gửi được đơn nào cho tới khi được thêm lại. Phần mềm hỏi xác nhận hai lần — đọc kỹ cả hai.
Cũng vì vậy, muốn xoá tài khoản liên thông của một bác sĩ thì gỡ họ khỏi cổng trước; còn đang đăng ký trên cổng thì phần mềm không cho xoá.
Cấu hình này dùng vào đâu
- Đơn thuốc được gửi bằng tài khoản của bác sĩ kê đơn, không phải người bấm nút (người bấm thường là dược sĩ). Đơn bán lẻ không có bác sĩ kê không thuộc diện liên thông.
- Nơi theo dõi và gửi: Dược › Đơn thuốc, cột Trạng thái DQG. Trạng thái gồm Chưa gửi, Đang gửi, Đã gửi và Lỗi. Đơn Đã gửi thì không gửi lại được; đơn Lỗi thì sửa nguyên nhân rồi gửi lại.
- Trước lần gửi đầu tiên, mở Tình trạng liên thông DQG — màn này liệt kê đúng những gì còn thiếu, theo nhóm: Chi nhánh chưa gán giấy phép, Bác sĩ chưa khai credential, Bác sĩ chưa thêm vào cơ sở. Hết vướng mắc thì màn báo "Không còn vướng mắc nào đang chặn gửi đơn."
Cổng nhận đơn ngay khi gửi, và đơn đã lên cổng không sửa, không xoá lại được. Vì vậy đừng gửi một đơn "cho thử": hãy dùng Tình trạng liên thông DQG để kiểm cấu hình, rồi chọn một đơn thật đơn giản (một đến hai loại thuốc thường, hồ sơ người bệnh đầy đủ) làm đơn gửi đầu tiên.
Trước khi gửi, đơn cần có đủ
Phần mềm kiểm trước và chặn lại nếu thiếu, kèm câu báo đúng chỗ thiếu:
- Chẩn đoán của đơn (mã ICD-10 hoặc tên bệnh).
- Họ tên, ngày sinh và địa chỉ của người bệnh trong hồ sơ.
- Người giám hộ, nếu người bệnh dưới 72 tháng tuổi.
- Mã thuốc cho mọi thuốc trong đơn — không để trống và không dài quá 20 ký tự.
- Đơn phải có ít nhất một thuốc.
Lỗi thường gặp
| Thông báo | Vì sao | Làm gì |
|---|---|---|
| Cổng Đơn thuốc Quốc gia từ chối đăng nhập cơ sở — vui lòng kiểm tra mã liên thông cơ sở và mật khẩu cơ sở… | Mã liên thông sai (nhập mã cơ sở 5 ký tự, nhập tên đăng nhập, hoặc sai hoa thường), hoặc mật khẩu sai / bị trình duyệt tự điền | Sửa giấy phép: nhập mã đúng như cổng hiển thị, gõ lại mật khẩu và bấm con mắt kiểm tra |
| Bác sĩ không tồn tại trong hệ thống hoặc chưa được duyệt mã định danh | Mã liên thông bác sĩ sai, hoặc hồ sơ bác sĩ chưa được phòng khám và Sở Y tế duyệt | Làm đủ các bước duyệt trên cổng, lấy mã ở trang tổng quan tài khoản bác sĩ |
| Mã bảo hiểm của cơ sở khám chữa bệnh phải đúng 5 ký tự | Thường là dán nhầm cả mã liên thông vào ô này | Nhập mã cơ sở 5 ký tự, tức mã liên thông bỏ 01 ở đầu |
| Mã liên thông cơ sở này đã được dùng cho một giấy phép khác | Hai giấy phép cùng một mã | Kiểm lại danh sách giấy phép, mỗi cơ sở chỉ khai một lần |
| Chi nhánh của đơn chưa được gán vào giấy phép liên thông nào | Thiếu bước gán chi nhánh | Mở Chi nhánh & bác sĩ rồi gán chi nhánh |
| Giấy phép liên thông của chi nhánh đang tắt | Giấy phép đang ở trạng thái tắt | Sửa giấy phép, bật lại Đang bật liên thông |
| Bác sĩ kê đơn chưa khai mã liên thông, hoặc mã đang tắt | Bác sĩ chưa được khai, hoặc đã khai nhưng đang tắt | Khai hoặc bật lại ở Tài khoản liên thông bác sĩ |
| Thuốc "…" chưa có mã thuốc / Mã thuốc của "…" dài quá 20 ký tự | Danh mục thuốc thiếu mã hoặc mã quá dài | Sửa mã trong Danh sách thuốc |
| Đơn chưa có chẩn đoán… và các câu báo thiếu ngày sinh, địa chỉ, người giám hộ | Hồ sơ người bệnh hoặc đơn thiếu dữ liệu bắt buộc | Bổ sung rồi gửi lại |
| Giấy phép này còn chi nhánh đang gán | Đang xoá giấy phép khi chưa gỡ chi nhánh | Gỡ hết chi nhánh trong Chi nhánh & bác sĩ rồi xoá |
Câu hỏi thường gặp
Phòng khám có 3 chi nhánh thì khai mấy giấy phép? Theo số cơ sở được cấp mã trên cổng. Ba chi nhánh cùng một pháp nhân, dùng chung một mã cơ sở thì một giấy phép, gán cả ba chi nhánh vào đó. Mỗi chi nhánh có mã riêng thì khai từng giấy phép.
Có cần khai lại mỗi khi thêm bác sĩ mới? Không. Giấy phép khai một lần. Bác sĩ mới chỉ cần làm bước 4, 5 và 6 trong bảng ở đầu bài.
Tắt Đang bật liên thông thì đơn cũ có mất không? Không. Đơn đã gửi vẫn nằm trên cổng; tắt chỉ khiến các chi nhánh thuộc giấy phép này ngừng gửi đơn mới.
Đổi mật khẩu cổng có ảnh hưởng đơn đã gửi không? Không. Nhưng phải vào sửa giấy phép cập nhật mật khẩu mới, nếu không các đơn sau đó sẽ báo lỗi đăng nhập.
Liên quan
- Tài khoản liên thông bác sĩ — khai mã cổng cho từng bác sĩ, bước 5 trong bảng trên.
- Danh sách thuốc — nơi khai mã thuốc mà cổng yêu cầu.