Quyết định 1405/QĐ-BTTTT 2021 hướng dẫn mã QR cá nhân của ứng dụng phòng, chống dịch Covid-19

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ế

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 “<”

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.

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.

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;

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

Mã lỗi

Mô tả

Thành công

Access token không hợp lệ

IP không hợp lệ

Số giấy tờ không hợp lệ

Loại giấy tờ không hợp lệ

Ngày sinh không hợp lệ

Họ tên không hợp lệ

Lỗi không xác định