Quyết định 1405/QĐ-BTTTT 2021 hướng dẫn yêu cầu kỹ thuật phân hệ hiển thị mã QR cá nhân

• Số hiệu: 1405/QĐ-BTTTT
• Loại văn bản: Quyết định
• Nơi ban hành: Bộ Thông tin và Truyền thông
• Người ký: Nguyễn Huy Dũng
• Ngày ban hành: 11/09/2021

BỘ THÔNG TIN VÀ TRUYỀN THÔNG -------	CỘNG HÒA XÃ HỘI CHỦ NGHĨA VIỆT NAM Độc lập - Tự do - Hạnh phúc ---------------
Số: 1405/QĐ-BTTTT	Hà Nội, ngày 11 tháng 09 năm 2021

QUYẾT ĐỊNH

BAN HÀNH HƯỚNG DẪN VỀ CÁC YÊU CẦU KỸ THUẬT ĐỐI VỚI PHÂN HỆ HIỂN THỊ MÃ QR CÁ NHÂN THUỘC CÁC NỀN TẢNG, ỨNG DỤNG PHÒNG, CHỐNG DỊCH COVID-19 (PHIÊN BẢN 1.1)

BỘ TRƯỞNG BỘ THÔNG TIN VÀ TRUYỀN THÔNG

Căn cứ Nghị định số 17/2017/NĐ-CP ngày 17/02/2017 của Chính phủ quy định chức năng, nhiệm vụ, quyền hạn và cơ cấu tổ chức của Bộ Thông tin và Truyền thông;

Căn cứ Nghị quyết số 78/NQ-CP ngày 20/7/2021 của phiên họp Chính phủ chuyên đề về phòng, chống dịch Covid-19;

Theo đề nghị của Cục trưng Cục Tin học hóa,

QUYẾT ĐỊNH:

Điều 1. Ban hành kèm theo Quyết định này hướng dẫn về các yêu cầu kỹ thuật đối với phân hệ hiển thị mã QR cá nhân thuộc các nền tảng, ứng dụng phòng, chống dịch Covid-19 (Phiên bản 1.1) để hướng dẫn về việc cấp và sử dụng mã QR cá nhân trong các nền tảng, ứng dụng công nghệ phục vụ phòng, chống dịch Covid-19.

Điều 2. Quyết định này có hiệu lực thi hành kể từ ngày ký.

Điều 3. Chánh Văn phòng, Cục trưởng Cục Tin học hóa, Thủ trưởng các đơn vị có liên quan chịu trách nhiệm thi hành Quyết định này./.

Nơi nhận: - Như Điều 3; - Bộ trưởng (để b/c); - Các Thứ trưởng (để biết); - Các Bộ, cơ quan ngang Bộ, cơ quan thuộc Chính phủ; - UBND các tỉnh, thành phố trực thuộc Trung ương; - Đơn vị chuyên trách về CNTT của các Bộ, cơ quan ngang Bộ, cơ quan thuộc Chính phủ (qua thư điện tử); - Sở TT&TT các tỉnh, thành phố trực thuộc Trung ương (qua thư điện tử); - Cổng thông tin điện tử Bộ TT&TT; - Lưu: VT, Cục THH.

KT. BỘ TRƯỞNG THỨ TRƯỞNG Nguyễn Huy Dũng

YÊU CẦU KỸ THUẬT ĐỐI VỚI PHÂN HỆ HIỂN THỊ MÃ QR CÁ NHÂN THUỘC CÁC NỀN TẢNG, ỨNG DỤNG PHÒNG, CHỐNG DỊCH COVID-19 (Phiên bản 1.1)

(Kèm theo Quyết định số:    /QĐ-BTTTT ngày    /   /2021 của Bộ Thông tin và Truyền thông)

DANH MỤC TỪ NGỮ VIẾT TẮT VÀ GIẢI THÍCH TỪ NGỮ

Mã QR cá nhân	Mã QR (Quick Response) gắn với mỗi cá nhân sử dụng các nền tảng, ứng dụng phục vụ phòng, chống dịch Covid-19
Nền tảng QRQG	Nền tảng quốc gia quản lý người dùng và mã QR cá nhân thống nhất phục vụ phòng, chống dịch Covid-19
QID	Mã người dùng là một thành phần trong Mã QR cá nhân, được nền tảng QRQG sinh ra và cấp phát cho các ứng dụng phòng, chống dịch Covid-19
CCCD	Căn cước công dân
CMND	Chứng minh nhân dân
HTTPS	Hyper Text Transfer Protocol Secure (giao thức truyền tải siêu văn bản bảo mật)
API	Application Programming Interface - là giao diện lập trình ứng dụng, đóng vài trò làm phương thức trung gian kết nối các ứng dụng và thư viện khác nhau
BHYT	Bảo hiểm y tế

I. MỤC ĐÍCH BAN HÀNH

Tài liệu này quy định về các yêu cầu kỹ thuật đối với phân hệ hiển thị mã QR cá nhân, hướng dẫn về việc cấp và sử dụng mã QR cá nhân trong các nền tảng, ứng dụng công nghệ phục vụ phòng, chống dịch Covid-19.

Mỗi cá nhân sử dụng các nền tảng, ứng dụng phòng, chống dịch Covid-19 được cấp một mã QR cá nhân. Mã QR cá nhân có thể được sử dụng để cá nhân, tổ chức có thẩm quyền đọc và truy vấn các dữ liệu liên quan phục vụ công tác phòng, chống dịch, bệnh Covid-19.

Việc hiển thị và sử dụng một mã QR cá nhân thống nhất trong tất cả các nền tảng, ứng dụng nhằm tạo thuận lợi tối đa cho mỗi người dân và các cơ quan, tổ chức khi thực hiện các nghiệp vụ phòng, chống dịch Covid-19. Người dân có thể lựa chọn cài đặt, sử dụng nền tảng, ứng dụng có cung cấp mã QR cá nhân phù hợp với nhu cầu và không cần cài đặt nhiều ứng dụng khác nhau.

Các nền tảng, ứng dụng khi triển khai phục vụ công tác phòng, chống dịch Covid-19 cần đáp ứng các yêu cầu kỹ thuật trong tài liệu này.

Các nền tảng phục vụ việc cung cấp, quản lý mã QR cá nhân cần tuân thủ Quy chế số 733/QC-BCĐ ngày 13/5/2020 của Ban chỉ đạo quốc gia phòng, chống dịch bệnh Covid-19 về quản lý dữ liệu y tế của người khai báo y tế từ các phần mềm phục vụ công tác phòng, chống dịch bệnh Covid-19.

II. HƯỚNG DẪN VỀ VIỆC SỬ DỤNG MÃ QR CÁ NHÂN

1. Cấu trúc mã QR cá nhân

Mỗi mã QR cá nhân có định dạng là một chuỗi các ký tự có cấu trúc. Cụ thể như sau:

- Cấu trúc: SoGiayTo|HoTen|NgaySinh|LoaiDinhDanh|QID|EXT

- Ví dụ: 001093029317|NGUYEN LE KHA HAN|1987-01-18|0|162979388586171100|<1<HS4010120878821<0944713700

Trong đó:

STT	Tên trường	Giải thích	Ghi chú
1	SoGiayTo	Số giấy tờ cá nhân của người dân (số CCCD, CMND, số hộ chiếu). Trên các nền tảng, ứng dụng phòng, chống dịch Covid-19, hỗ trợ hiển thị số giấy tờ cá nhân ở hai chế độ: - Chế độ hiển thị mặc định: Số giấy tờ cá nhân ẩn bớt 6 ký tự đầu tiên bằng cách thay thế bằng ký tự dấu sao (*). - Chế độ hiển thị đầy đủ: hiển thị đầy đủ số giấy tờ cá nhân. Các nền tảng, ứng dụng phòng, chống dịch Covid-19 cần có chức năng để người dùng có thể lựa chọn chuyển đổi nhanh các chế độ hiển thị nói trên.	Bắt buộc hiển thị với QR cá nhân có được bởi người dùng tự khai. Không bắt buộc hiển thị với QR cá nhân có được bởi người dùng được khai hộ.
2	HoTen	Họ và tên người dân, viết hoa, không dấu, mỗi từ cách nhau bởi 01 ký tự khoảng trắng (space).	Bắt buộc
3	NgaySinh	Chuỗi ngày tháng năm sinh theo định dạng: YYYY-MM-DD. Trên các nền tảng, ứng dụng phòng, chống dịch Covid-19, hỗ trợ hiển thị chuỗi ngày tháng năm sinh ở hai chế độ: - Chế độ hiển thị mặc định: chuỗi ngày tháng năm sinh ẩn bớt các ký tự ngày và tháng bằng cách thay thế bằng ký tự dấu sao (*). - Chế độ hiển thị đầy đủ: hiển thị đầy đủ chuỗi ngày tháng năm sinh. Các nền tảng, ứng dụng phòng, chống dịch Covid-19 cần có chức năng để người dùng có thể lựa chọn chuyển đổi nhanh các chế độ hiển thị nói trên.	Bắt buộc
4	LoaiDinhDanh	Loại định danh gồm các giá trị quy ước: - 0: Người dùng tự khai; - 1: Người dùng khai hộ.	Bắt buộc
5	QID	Mã người dùng do nền tảng QRQG cấp, kiểu dữ liệu là chuỗi ký tự	Bắt buộc
6	EXT	Các giá trị mở rộng khác như: 1) QID của người khai hộ (trong trường hợp là mã QR cá nhân có được bởi người dùng khai hộ). 2) Giới tính (theo QCVN 109:2017/BTTTT); 3) Mã số thẻ BHYT; 4) Số điện thoại (gồm 10 ký tự số); 5) Chữ ký điện tử… và các thông tin khác theo nhu cầu thực tiễn.	Tuỳ chọn và các giá trị theo thứ tự được phân định nhau bởi dấu “<”

2. Mô hình cung cấp và quản lý mã QR cá nhân

Hình vẽ sau thể hiện mô hình của việc cung cấp và quản lý mã QR cá nhân trên các nền tảng, ứng dụng phục vụ phòng, chống dịch Covid-19.

Mô hình tổng quan hệ thống

Trong mô hình trên, các thành phần cụ thể gồm có:

- Các ứng dụng phòng, chống dịch Covid-19 là các nền tảng, ứng dụng phục vụ phòng, chống dịch Covid-19 do Ban chỉ đạo quốc gia phòng, chống dịch Covid-19, Bộ Y tế, Bộ Thông tin và Truyền thông triển khai hoặc các ứng dụng do các bộ, ngành, địa phương, doanh nghiệp triển khai;

- Nền tảng QRQG là nền tảng do Bộ Thông tin và Truyền thông xây dựng và quản lý;

- Nguồn thông tin xác thực là hệ thống do một số bộ, ngành, cơ quan trung ương xây dựng và quản lý phục vụ việc xác thực thông tin người dùng thuộc các nền tảng, ứng dụng phòng, chống dịch Covid-19;

- Quy trình trao đổi dữ liệu giữa các thành phần:

(1) Các ứng dụng phòng, chống dịch Covid-19 gửi yêu cầu cấp QID và QR cá nhân đến nền tảng QRQG;

(2) Nền tảng QRQG tiến hành gửi dữ liệu cần xác thực đến Nguồn thông tin xác thực;

(3) Nguồn thông tin xác thực gửi lại kết quả xác thực;

(4) Nền tảng QRQG gửi trả QID và QR cá nhân hoặc thông báo thông tin chưa chính xác đến các ứng dụng phòng, chống dịch Covid-19.

- Việc trao đổi dữ liệu giữa các thành phần trong mô hình được thực hiện thông qua các phương thức đảm bảo an toàn, bảo mật thông tin.

3. Cung cấp QID từ nền tảng QRQG

Mỗi nền tảng, ứng dụng khi triển khai phục vụ công tác phòng, chống dịch Covid-19 cần cung cấp một mã QR cá nhân thống nhất, theo cấu trúc tại mục II.1 và được cấp từ nền tảng QRQG.

Nền tảng QRQG cung cấp cho các ứng dụng phòng, chống dịch Covid-19 dịch vụ đăng nhập và cấp mã QR cá nhân nói trên từ một số tham số đầu vào thông qua API REST service.

- Đặc tả đầu vào API

TT	Tham số	Định dạng	Mô tả
1	HoTen (*)	String	Họ và tên người dân, viết hoa, mỗi từ cách nhau bởi 01 ký tự khoảng trắng (space). Lưu ý: Họ và tên bao gồm cả dấu.
2	NgaySinh (*)	String	Chuỗi ngày tháng năm sinh của người dân tự khai (hoặc người được khai hộ trong trường hợp khai hộ) theo định dạng: YYYY-MM-DD
3	SoGiayTo	String	Trong trường hợp người dân tự khai: Số giấy tờ cá nhân là của người dân tự khai (số CCCD, CMND, số hộ chiếu) và là thông tin bắt buộc. Trong trường hợp khai hộ cho người khác: Số giấy tờ cá nhân là của người được khai hộ và là thông tin không bắt buộc.
4	LoaiDinhDanh (*)	Integer	Loại định danh, kiểu số nguyên, gồm các giá trị quy ước như sau: - 0: Người dân tự khai; - 1: Người dân khai hộ cho người khác.
5	SoDienThoai	String	Trong trường hợp người dân tự khai: Số điện thoại của người dân tự khai (theo định dạng bắt đầu bằng số 0) và là thông tin bắt buộc. Số điện thoại đã được xác thực tại ứng dụng phòng, chống dịch Covid-19. Trong trường hợp khai hộ cho người khác: Số điện thoại của người được khai hộ (theo định dạng bắt đầu bằng số 0) và là thông tin không bắt buộc.
6	GioiTinh (*)	String	Giới tính của người dân tự khai (hoặc người được khai hộ trong trường hợp khai hộ) gồm các giá trị quy ước như sau: 0: Chưa có thông tin; 1: Giới tính nam; 2: Giới tính nữ.
7	QIDKhaiHo	String	Trong trường hợp người dân tự khai: Giá trị rỗng. Trong trường hợp người dân khai hộ cho người khác: Giá trị QID của người khai hộ và là thông tin bắt buộc.

- Đặc tả đầu ra API

TT	Tên trường	Định dạng	Mô tả
1	ResultCode	String	Mã lỗi: xem bảng chi tiết mã lỗi ở mục II.5
2	ResultMessage	String	Mô tả lỗi
3	ResultData	Object JSON	Là một đối tượng gồm các thuộc tính: QID: mã người dùng do nền tảng QRQG cấp. QRCode: mã QR của người dân.

4. Xác thực thông tin khai báo của cá nhân

Mỗi người dân khai báo thông tin trên các nền tảng, ứng dụng phục vụ phòng, chống dịch Covid-19 sẽ được nền tảng QRQG xác thực.

Nếu thông tin người dân khai báo là chính xác, thông tin đó sẽ được cập nhật vào nền tảng. Nếu thông tin không chính xác, ứng dụng phòng, chống dịch Covid-19 thông báo để người dân biết, cập nhật thông tin khai báo.

Nền tảng QRQG cung cấp cho các ứng dụng phòng, chống dịch Covid-19 dịch vụ xác thực thông tin nói trên từ một số tham số đầu vào thông qua API REST service.

Lưu ý: nền tảng QRQG không thực hiện xác thực các trường hợp khai hộ.

- Đặc tả đầu vào API

TT	Tên trường	Định dạng	Mô tả
1	ListXacThuc	Array	Danh sách các đối tượng chứa thông tin người dân cần xác thực, mỗi đối tượng gồm các thuộc tính: - SoGiayTo (*): String - số CCCC/CMND; - HoTen (*): String - Họ và tên người dân, viết hoa, không dấu, mỗi từ cách nhau bởi 01 ký tự khoảng trắng (space); - NgaySinh (*): String - ngày tháng năm sinh theo định dạng: YYYY-MM-DD; - GioiTinh (*): String - Giới tính của người dân gồm các giá trị quy ước như sau: 0: Chưa có thông tin; 1: Giới tính nam; 2: Giới tính nữ. - QuocTich: String - mã quốc gia theo TCVN 7217-1:2007 ;

- Đặc tả đầu ra API

TT	Tên trường	Định dạng	Mô tả
1	ResultCode	String	Mã lỗi: xem bảng chi tiết mã lỗi ở mục II.5
2	ResultMessage	String	Mô tả lỗi
3	ResultData	Array	Danh sách các đối tượng chứa thông tin người dân đã được xác thực, mỗi đối tượng gồm các thuộc tính: - SoGiayTo: String - số CCCC/CMND/Hộ chiếu của người dân được gửi yêu cầu xác thực; - HoTen: String - Họ và tên, viết hoa, không dấu, mỗi từ cách nhau bởi 01 ký tự khoảng trắng (space) của người dân được gửi yêu cầu xác thực; - NgaySinh: String - ngày tháng năm sinh theo định dạng: YYYY-MM-DD của người dân được gửi yêu cầu xác thực; - QuocTich: String - mã quốc gia theo TCVN 7217-1:2007 của người dân được gửi yêu cầu xác thực; - GioiTinh: String - Giới tính của người dân được gửi yêu cầu xác thực; - KetQuaXacThuc: Integer - kết quả xác thực, gồm các giá trị quy ước như sau: 0: Đúng thông tin 1: Sai thông tin 2: Không tồn tại (kiểm tra theo CCCD/CMT/hộ chiếu) 3: Lỗi không xác định 4: Chưa xác thực

5. Bảng mô tả chi tiết mã lỗi

Mã lỗi	Mô tả
0	Thành công
1	Access token không hợp lệ
2	IP không hợp lệ
3	Số giấy tờ không hợp lệ
4	Loại giấy tờ không hợp lệ
5	Ngày sinh không hợp lệ
6	Họ tên không hợp lệ
7	Lỗi không xác định

III. TỔ CHỨC THỰC HIỆN

Các nền tảng, ứng dụng phục vụ phòng, chống dịch Covid-19 trước khi triển khai cần được Bộ Thông tin và Truyền thông và Bộ Y tế đánh giá đáp ứng yêu cầu kỹ thuật tại tài liệu này.

Nền tảng, ứng dụng phục vụ phòng, chống dịch Covid-19 đáp ứng yêu cầu kỹ thuật được công bố tại website: https://covid19.tech.gov.vn.

Đầu mối tổ chức việc tiếp nhận và đánh giá là Trung tâm Công nghệ phòng, chống dịch Covid-19 quốc gia./.