BỘ TƯ PHÁP
-------

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

Số: 900/QĐ-BTP

Hà Nội, ngày 31 tháng 3 năm 2026

Nơi nhận:
- Như Điều 3;
- Bộ trưởng (để báo cáo);
- Các đồng chí Thứ trưởng (để biết);
- Các bộ, cơ quan ngang bộ;
- UBND các tỉnh, thành phố;
- Lưu: VT, CNTT.

KT. BỘ TRƯỞNG
THỨ TRƯỞNG




Nguyễn Thanh Tịnh

BỘ TƯ PHÁP
-------

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

Số: 900/QĐ-BTP

Hà Nội, ngày 31 tháng 3 năm 2026

Nơi nhận:
- Như Điều 3;
- Bộ trưởng (để báo cáo);
- Các đồng chí Thứ trưởng (để biết);
- Các bộ, cơ quan ngang bộ;
- UBND các tỉnh, thành phố;
- Lưu: VT, CNTT.

KT. BỘ TRƯỞNG
THỨ TRƯỞNG




Nguyễn Thanh Tịnh

STT

Thuật ngữ

Ý nghĩa

1

GQTTHC BTP

Giải quyết thủ tục hành chính Bộ Tư pháp

2

TTHC

Thủ tục hành chính

STT

Tên trường

Kiểu dữ liệu

Độ dài tối đa

Mô tả

Yêu cầu

1

MaHoSo

String

50 ký tự

Mã hồ sơ thủ tục hành chính quy định tại Điều 26 Nghị định 61/2018 của Chính phủ.

Bắt buộc

2

MaTTHC

String

50 ký tự

Mã thủ tục hành chính theo CSDL TTHC Quốc gia

Bắt buộc

3

TenTTHC

String

3000 ký tự

Tên loại thủ tục theo CSDL TTHC Quốc gia

Bắt buộc

4

MaLinhVuc

String

50 ký tự

Mã lĩnh vực theo CSDL TTHC Quốc gia

Bắt buộc

5

TenLinhVuc

String

500 ký tự

Tên lĩnh vực theo CSDL TTHC Quốc gia

Bắt buộc

6

NguoiNopHoSo

String

500 ký tự

Tên người đăng ký thực hiện thủ tục hành chính

Bắt buộc

7

SoDinhDanhNguoiNop

String

20 ký tự

Số căn cước công dân người nộp

Bắt buộc

8

SoDienThoaiNguoiNop

String

20 Ký tự

Không bắt buộc

9

EmailNguoiNop

String

20 Ký tự

Không bắt buộc

10

LoaiDoiTuong

Code

Kiểu đối tượng chủ hồ sơ

- 1: Người dân;

- 2: Doanh Nghiệp;

- 3: Cơ quan nhà nước;

- 4: Tổ chức khác.

Bắt buộc

11

ChuHoSo

Array

Danh sách chủ sở hữu hồ sơ

Bắt buộc

11.1

SoDinhDanh

String

20 ký tự

Số định danh tương ứng với LoaiDoiTuong

Bắt buộc

11.2

TenChuSoHuu

String

500 Ký tự

Tên chủ sở hữu hồ sơ

Bắt buộc

11.3

Email

String

50 ký tự

Địa chỉ thư điện tử của công dân tổ chức

Không bắt buộc

11.4

SoDienThoai

String

13 ký tự

Số điện thoại liên hệ của cá nhân, tổ chức theo định dạng: 0123456789

Không bắt buộc

12

NgayTiepNhan

Date

Ngày tiếp nhận hồ sơ định dạng: yyyyMMddHHmmss

Bắt buộc

13

NgayHenTra

Date

Ngày hẹn trả hồ sơ định dạng: yyyyMMddHHmmss

Không Bắt buộc

14

DonViXuLy

String

500 ký tự

Tên đơn vị thụ lý hồ sơ

Bắt buộc

15

MaDonViXuLy

String

50 ký tự

Mã đơn vị xử lý theo CSDL TTHC Quốc gia. Ví dụ: H37.224.3.5

Mã định danh theo QĐ 20/2020 QĐ-TTg

Bắt buộc

16

TaiLieuKemTheo

Array

Danh sách đính kèm của hồ sơ.

Không bắt buộc

16.1

TepDinhKemId

String

50 ký tự

Id của tệp đính kèm

Không bắt buộc

16.2

TenTepDinhKem

String

200 ký tự

Tên file đính kèm

Bắt buộc

16.3

TenThanhPhanHoSo

String

500 ký tự

Tên thành phần hồ sơ

Bắt buộc

16.4

MaThanhPhanHoSo

String

50 ký tự

Mã thành phần hồ sơ nếu file đính kèm là một thành phần hồ sơ của thủ tục

Không bắt buộc

16.5

DuongDanFile

String

500 ký tự

Đường dẫn tải file

Bắt buộc

17

DataChuyenNganh

Text

Dữ liệu json chứa thông tin chuyên ngành

{“hotencha”: “Nguyễn Văn A”}

Không bắt buộc

18

TrangThaiHoSo

Code

KHOITAOHOSO

BOSUNGHOSO

HUYHOSO

Bắt buộc

STT

Tên trường

Kiểu dữ liệu

Mô tả

1

Success

Boolean

true | false

2

ErrorCode

String

Mã lỗi trong trường hợp success = false

3

ErrorMessage

String

Nội dung lỗi

4

RequestID

string, GUID

Mã request dùng để trace log giữa 2 bên

ST T

Tên trường

Kiểu dữ liệu

Độ dài tối đa

Mô tả

Bắt buộc

1

MaHoSo

String

50 ký tự

Mã hồ sơ

X

2

NguoiXuLy

String

50 ký tự

Tên người xử lý

X

3

ChucDanh

String

100 ký tự

Chức vụ của người xử lý

4

ThoiDiemXuLy

Date

Thời điểm xử lý hồ sơ định dang:

yyyyMMddHHmmss

X

5

DonViXuLy

String

500 ký tự

Tên đơn vị xử lý hồ sơ

X

6

MaDonViXuLy

String

50 ký tự

Mã đơn vị xử lý theo CSDL TTHC Quốc Gia. Ví dụ: H37.244.3.5

7

NoiDungXuLy

String

1000 ký tự

Nội dung xử lý

8

MaTrangThai

Int

Theo phụ lục trạng thái đính kèm

Ví dụ: 1

X

9

TenTrangThai

String

100

Trạng thái xử lý hồ sơ

X

10

TraKetQua

Boolean

Đánh dấu trạng thái kết thúc xử lý

11

TaiLieuXuLy

Array

Danh sách tài liệu xử lý

Bắt buộc trong trường hợp TraKetQua= True

11.1

TenTepDinhKem

String

200 ký tự

Tên file đính kèm

X

11.2

DuongDanFile

String

500 ký tự

Đường dẫn tải file

X

STT

Tên trường

Kiểu dữ liệu

Mô tả

1

Success

Boolean

true | false

2

ErrorCode

String

Mã lỗi trong trường hợp success = false

Tham khảo phụ lục danh sách mã lỗi

3

ErrorMessage

String

Nội dung lỗi

4

RequestID

string, GUID

Mã request dùng để trace log giữa 2 bên

STT

Tên trường

Kiểu dữ liệu

Độ dài tối đa

Mô tả

Bắt buộc

12

MaHoSo

String

50 ký tự

Mã hồ sơ

X

13

NguoiXuLy

String

50 ký tự

Tên người xử lý

X

14

ChucDanh

String

100 ký tự

Chức vụ của người xử lý

15

ThoiDiemXuLy

Date

Thời điểm xử lý hồ sơ định dạng: yyyyMMddHHmmss

X

16

DonViXuLy

String

500 ký tự

Tên đơn vị xử lý hồ sơ

X

17

MaDonViXuLy

String

50 ký tự

Mã đơn vị xử lý theo CSDL TTHC Quốc Gia. Ví dụ: H37.244.3.5

18

NoiDungXuLy

String

1000 ký tự

Nội dung xử lý

19

MaTrangThai

Int

Theo phụ lục trạng thái đính kèm

Ví dụ: 1

X

20

TenTrangThai

String

100

Trạng thái xử lý hồ sơ

X

21

TraKetQua

Boolean

Đánh dấu trạng thái kết thúc xử lý

22

TaiLieuXuLy

Array

Danh sách tài liệu xử lý

Bắt buộc trong trường hợp TraKet Qua=True

11.1

TenTepDinhKem

String

200 ký tự

Tên file đính kèm

X

11.2

PhuongThucTaiFile

String

50 ký tự

Phương thức tải file, chỉ cho phép BASE64 hoặc URL. Nếu không truyền thì mặc định là URL

11.3

NoiDungFile

String

Nội dung file dưới dạng base64.

11.4

DuongDanFile

String

500 ký tự

Đường dẫn tải file

11.5

LoaiDuLieu

String

10 ký tự

Chỉ cho phép: "doc", "docx", "pdf", "xls", "xlsx", "png", "jpg", "jpeg"

X

STT

Tên trường

Kiểu dữ liệu

Mô tả

1

Success

Boolean

true | false

2

ErrorCode

String

Mã lỗi trong trường hợp success = false

Tham khảo phụ lục danh sách mã lỗi

3

ErrorMessage

String

Nội dung lỗi

4

RequestID

string, GUID

Mã request dùng để trace log giữa 2 bên

STT

Tên thuộc tính

Kiểu dữ liệu

Độ dài tối đa

Bắt buộc

Ghi chú

1

userId

String

12 ký tự

x

CCCD của cán bộ thực hiện gửi liên thông Quản lý văn bản

2

documentCode

String

x

Mã của hồ sơ bên hệ thống GQ TTHC

3

maHoSo

Int

x

Id của hồ sơ bên hệ thống GQ TTHC

4

tenHoSo

String

256 ký tự

x

Tên của hồ sơ bên hệ thống GQ TTHC

5

soKyHieu

String

Số ký hiệu của văn bản (Bắt buộc nếu đơn vị muốn tạo văn bản đến trên hệ thống Quản lý văn bản)

6

coQuanBanHanh

String

Đơn vị ban hành văn bản (Bắt buộc nếu đơn vị muốn tạo văn bản đến trên hệ thống Quản lý văn bản)

7

loaiVanBan

Number

x

1: Tạo văn bản đến

2: Tạo văn bản đi (*)

8

files

Arrays

Ds các tệp đính kèm muốn đẩy sang hệ thống ioffice để đính kèm vào mục File đính kèm trên ioffice

8.1

filename

String

Tên của tệp đính kèm

8.2

bytefile

String

Nọi dung của tệp đính kèm dạng base64

8.3

extension

String

Định dạng tệp tin (doc, pdf, …)

8.4

size

Number

Dung lượng của file (byte)

8.5

Urlfile

String

Đường dẫn tệp đính kèm có thể tài được

9

MaLienThong

String

Mã hệ thống gửi liên thông Quản lý văn bản

10

maCoQuanBanHanh

String

Mã định danh Đơn khởi tạo văn bản

STT

Trường

Ý nghĩa

Ghi chú

1

status

Trạng thái (code = 1 là request thành công)

1.1

code

Trạng thái (code = 1 là request thành công, code = 0 là request thất bại)

1.2

message

Trả về theo từng trường hợp nếu có lỗi xảy ra

2

data

Thông tin hồ sơ trả ra

2.1

id

ID văn bản được tạo

2.2

code

Số ký hiệu văn bản được tạo

STT

Tên thuộc tính

Kiểu dữ liệu

Độ dài tối đa

Bắt buộc

Ghi chú

1

MaHoSo

String

50 ký tự

x

Số hồ sơ trên hệ thống GQ TTHC.

2

content

Object

50 ký tự

x

Thông tin trạng thái hồ sơ.

2.1

maTrangThai

String

x

Mã trạng thái hồ sơ (xem danh mục trạng thái bên dưới)

Khi trả kết quả văn bản gửi giá trị = 9.

2.2

ngayXuLy

String

x

Ngày xử lý/cập nhật trạng thái hồ sơ (định dạng dd/MM/yyyy HH:mm:ss).

2.3

noiDungXuLy

String

x

Nội dung xử lý của bước (nếu không có thông tin thì truyền theo tên trạng thái xem danh mục trạng thái bên dưới).

3

TaiLieuXuLy

Array

Danh sách file kết quả đính kèm.

3.1

DuongDanFile

String

Đường dẫn tải file đính kèm (Khuyến nghị sử dụng).

3.2

TenTepDinhKem

String

Tên tệp tin đính kèm.

STT

Trường

Ý nghĩa

Ghi chú

1

affectedRows

Trạng thái thành công hay thất bại

Giá trị = 0: thất bại

Giá trị = 1: thành công

2

message

Thông tin mô tả trạng thái

3

errBody

Nội dung lỗi trả ra

Mã trạng thái

Tên trạng thái

1

Mới đăng ký

2

Được tiếp nhận

3

Không được tiếp nhận

4

Đang xử lý

5

Yêu cầu bổ sung

6

Yêu cầu thực hiện nghĩa vụ tài chính

7

Công dân yêu cầu rút hồ sơ

8

Dừng xử lý

9

Đã xử lý xong

10

Đã trả kết quả

StatusCode

Error Code

ErrorMessage

404

HOSO_NOT_FOUND

MaHoSo H49.122-251025-0001 không tồn tại trong hệ thống

400

BAD_REQUEST

" MaHoSo là bắt buộc

400

BAD_REQUEST

DonViXuLy la bat buoc, NguoiXuLy la bat buoc, MaTrangThai phai tu 1 den 10, ThoiDiemXuLy la bat buoc

401

Unauthorized

404

Not Found

409

EXISTED

Hồ sơ H49.122-251025-000 đã đồng bộ với trạng thái 1: abcxyz

500

INTERNAL_SEVER_ERROR

Lỗi hệ thống