Quyết định 1259/QĐ-BNV 2026 hướng dẫn kỹ thuật kết nối, chia sẻ và khai thác dữ liệu hội, quỹ, tổ chức phi chính phủ

BỘ NỘI VỤ
^__________

Số: 1259/QĐ-BNV

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

Hà Nội, ngày 16 tháng 10 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;

- Các bộ, cơ quan ngang bộ (để p/hợp);

- UBND các tỉnh, thành phố (để p/hợp);

- Cổng Thông tin điện tử Bộ Nội vụ (để đăng tải);

- Lưu: VT, TCPCP, TTCNTT.

KT. BỘ TRƯỞNG

THỨ TRƯỞNG

Trương Hải Long

STT

Tên dịch vụ

Mã dịch vụ

Mô tả

1

Dịch vụ lấy Token

hq_token

Khởi tạo token cho phép thực hiện phiên làm việc với các dịch vụ dữ liệu hội, quỹ. Token được sử dụng cho tất cả các dịch vụ còn lại.

2

Khai thác dữ liệu thông tin hội

hq_hoi_01

Cung cấp dữ liệu thông tin hội trong Cơ sở dữ liệu về hội, quỹ, tổ chức phi chính phủ: thông tin tổ chức, số lượng hội viên, người làm việc, tổ chức pháp nhân thuộc hội, quy chế; lãnh đạo hội; quá trình hoạt động; tài chính, tài sản; khen thưởng, xử lý vi phạm. Mỗi bản tin là thông tin của 01 hội.

3

Khai thác dữ liệu thông tin quỹ

hq_quy_01

Cung cấp dữ liệu thông tin quỹ trong Cơ sở dữ liệu về hội, quỹ, tổ chức phi chính phủ: thông tin tổ chức, quyết định thành lập, công nhận; lãnh đạo, Hội đồng quản lý, Ban Kiểm soát; quá trình hoạt động; tài chính; khen thưởng, xử lý vi phạm. Mỗi bản tin là thông tin của 01 quỹ.

4

Khai thác dữ liệu danh mục

hq_dm_01

Cung cấp giá trị các danh mục dùng chung sử dụng trong Cơ sở dữ liệu về hội, quỹ, tổ chức phi chính phủ. Mỗi bản tin là 01 bản ghi giá trị danh mục.

TT

Tên trường

Kiểu dữ liệu

Bắt buộc

Mô tả

1

grant_type

String

x

Nhận giá trị cố định: client_credentials

TT

Tên trường

Định dạng

Mô tả

1

access_token

String

Chuỗi token được cấp tương ứng với một phiên làm việc

2

scope

String

Phạm vi sử dụng của token

3

token_type

String

Kiểu token

4

expires_in

Number

Thời gian token có hiệu lực (giây)

Địa chỉ kết nối

URL

{{base_url}}/token

Request header

Method

POST

Content-Type

application/x-www-form-urlencoded

Authorization

Basic Base64(consumer-key:consumer-secret) (cặp khóa consumer-key và consumer-secret do đơn vị quản lý trục cung cấp cho mỗi hệ thống thông tin)

Request Body

Body

grant_type=client_credentials

Response Body

200 OK

{"access_token": "d32ed548-e44c-350c-b047-c10f829064fb", "scope": "am_application_scope default", "token_type": "Bearer", "expires_in": 3600}

TT

Tên tham số

Kiểu dữ liệu

Bắt buộc

Mô tả

1

maHoi

String

Mã đơn vị hội (khóa nghiệp vụ). Khi truyền tham số này, dịch vụ trả về dữ liệu của 01 hội

2

tuThoiDiem

String

Lấy các bản ghi có ThoiGianCapNhat lớn hơn hoặc bằng giá trị này; dùng cho đồng bộ gia tăng. Định dạng YYYY-MM-DDTHH:mm:ss

3

denThoiDiem

String

Lấy các bản ghi có ThoiGianCapNhat nhỏ hơn hoặc bằng giá trị này. Định dạng YYYY-MM-DDTHH:mm:ss

4

pageNumber

Number

Số thứ tự trang cần lấy, tính từ 0. Mặc định: 0

5

pageSize

Number

Số bản ghi trên một trang. Mặc định: 20; tối đa: 100

STT

Tên

Kiểu

Bắt buộc

Lặp

Ghi chú

1

code

Number

x

Mã trạng thái:

200: Khai thác thành công Khác 200: Không thành công (chi tiết lỗi mô tả trong trường message)

2

message

String

x

Mô tả trạng thái hoặc lỗi

3

response_time

String

x

Thời gian phản hồi kết quả

4

data

Object

Dữ liệu trả về, chỉ có khi code = 200

4.1

content

Array

x

x

Danh sách bản ghi dữ liệu, sắp xếp theo thoiGianCapNhat tăng dần

4.1.1

idBanGhi

String

x

ID bản ghi, trùng với thẻ DuLieuChiaSe/IdBanGhi của bản tin

4.1.2

maHoi

String

x

Mã đơn vị hội (khóa nghiệp vụ)

4.1.3

maLoaiDuLieu

String

x

Mã loại dữ liệu của bản tin: thongtinhoi

4.1.4

suKien

String

x

Trạng thái thay đổi của bản ghi tại Cơ sở dữ liệu nguồn: NEW (bản ghi mới phát sinh), UPDATE (bản ghi đã được cơ quan có thẩm quyền sửa đổi), CANCEL (bản ghi đã bị hủy)

4.1.5

phienBan

Number

x

Phiên bản dữ liệu của bản ghi

4.1.6

thoiGianCapNhat

String

x

Thời gian bản ghi được cập nhật. Định dạng YYYY-MM-DDTHH:mm:ss

4.1.7

duLieu

String

x

Bản tin XML mã hóa base64. Cấu trúc bản tin theo bảng Cấu trúc bản tin dữ liệu dưới đây

4.2

pageNumber

Number

x

Số thứ tự trang hiện tại, tính từ 0

4.3

pageSize

Number

x

Số bản ghi trên một trang

4.4

totalElements

Number

x

Tổng số bản ghi thỏa điều kiện khai thác

4.5

totalPages

Number

x

Tổng số trang

STT

Tên

Kiểu

Kích thước tối đa

Bắt buộc

Lặp

Ghi chú

I

Root

x

Phần mô tả

1.

NguonDuLieu

Object

x

Chứa thông tin xác định nguồn dữ liệu

1.1

IdNguonDuLieu

String

10

x

Mã nguồn dữ liệu, tham chiếu theo bảng mã kèm Quyết định số 20/2020/QĐ-TTg ngày 22/7/2020 của Thủ tướng Chính phủ và quy định liên quan. Đối với Bộ Nội vụ: G09

1.2

MaLoaiDuLieu

String

100

x

Mã loại dữ liệu, là duy nhất. Mã quy ước: thongtinhoi

2.

TrangThaiDuLieu

Object

x

Chứa thông tin trạng thái dữ liệu

2.1

SuKien

String

10

x

Trạng thái thay đổi của bản ghi tại Cơ sở dữ liệu nguồn, dùng để hệ thống khai thác xử lý bản sao dữ liệu của mình:

- NEW: Bản ghi mới phát sinh

- UPDATE: Bản ghi đã được cơ quan có thẩm quyền sửa đổi

- CANCEL: Bản ghi đã bị hủy (hủy mềm)

2.2

LoaiSuKien

String

2

x

Mức độ thay đổi của bản ghi, giúp hệ thống khai thác quyết định có cần thông báo cho người dùng của mình hay không:

- 1: Thay đổi thông thường, hệ thống khai thác chỉ cần đồng bộ dữ liệu

- 2: Thay đổi quan trọng (ví dụ: thành lập, giải thể, đổi tên hội, quỹ; thay đổi lãnh đạo), hệ thống khai thác đồng bộ dữ liệu và nên thông báo cho người dùng của mình

2.3

MoTa

Object

Mô tả cập nhật. Chỉ sử dụng với trường hợp cập nhật hoặc hủy

2.3.1

LyDoCapNhat

String

2000

Lý do cập nhật

2.3.2

ChiTietLyDoCapNhat

String

2000

Mô tả chi tiết thông tin cập nhật

2.4

PhienBan

Number

10

x

Là số nguyên khác 0. Bộ Nội vụ tăng số PhienBan mỗi khi bản ghi thay đổi. Hệ thống khai thác dựa trên thông tin SuKien và PhienBan để đồng bộ dữ liệu có phiên bản lớn nhất vào hệ thống khai thác và không xử lý trường hợp PhienBan nhỏ hơn hoặc bằng PhienBan lớn nhất đã có tại hệ thống khai thác.

Giá trị nhỏ nhất: 1

Giá trị lớn nhất: (2^31)-1

2.5

NgayHieuLuc

String

20

Ngày dữ liệu có giá trị pháp lý. Trường hợp dữ liệu không xác định Ngày hiệu lực thì được gán là ngày dữ liệu được cập nhật vào Cơ sở dữ liệu về hội, quỹ, tổ chức phi chính phủ. Định dạng YYYY-MM-DDTHH:mm:ss. Giờ áp dụng theo giờ Hà Nội GMT+7. Giờ (HH) là số tự nhiên 0-23.

2.6

ThoiGianCapNhat

String

20

x

Thời gian dữ liệu được cập nhật vào Cơ sở dữ liệu về hội, quỹ, tổ chức phi chính phủ:

- Trường hợp SuKien là NEW: là thời gian thêm mới dữ liệu.

- Trường hợp SuKien là UPDATE hoặc CANCEL: là thời gian gần nhất bản ghi được chỉnh sửa, thay đổi thông tin. Định dạng YYYY-MM-DDTHH:mm:ss. Giờ áp dụng theo giờ Hà Nội GMT+7. Giờ (HH) là số tự nhiên 0-23.

3.

DuLieuChiaSe

Object

x

Dữ liệu chia sẻ là thông tin của 01 hội. Khi có thay đổi thông tin, toàn bộ thông tin của hội được cung cấp lại với PhienBan mới.

3.1

IdBanGhi

String

150

x

ID bản ghi là duy nhất; hệ thống khai thác sử dụng IdBanGhi là khóa chính để đối soát, đồng bộ dữ liệu tại hệ thống khai thác

3.2

MaHoi

String

15

x

Mã đơn vị hội

* Khóa nghiệp vụ

3.3

TTToChucHoi

Object

x

Thông tin tổ chức hội

3.3.1

TTCapToChuc

Object

x

Biểu tượng, cấp tổ chức của Hội

3.3.1.1

CapToChuc

String

1

x

Mã cấp tổ chức, theo danh mục Cấp tổ chức

0 - Trung ương

1 - Liên tỉnh

2 - Tỉnh, thành phố

3 - Xã, phường, đặc khu

4 - Khác

3.3.1.2

PhamViHoatDong

String

1

x

Mã phạm vi hoạt động của hội theo danh mục Phạm vi hoạt động của hội

0 - Toàn quốc

1 - Liên tỉnh

2 - Tỉnh/Thành phố trực thuộc Trung ương

3 - Xã/Phường/Đặc khu

3.3.1.3

LaHoiDangNhaNuocGiaoNhiemVu

Boolean

x

Là Hội Đảng nhà nước giao nhiệm vụ

- 1 - Đúng

- 0 - Sai

3.3.2

TTTenGoiHoi

Object

x

Thông tin tên gọi của Hội

3.3.2.1

TenTiengViet

String

255

x

Tên gọi của Hội bằng tiếng Việt.

3.3.2.2

TenTiengAnh

String

255

Tên gọi của Hội bằng tiếng Anh, nếu có.

3.3.2.3

TenVietTat

String

255

Tên viết tắt của Hội, nếu có.

3.3.3

QDThanhLap

Object

x

Thông tin quyết định thành lập

3.3.3.1

ThoiGianBanHanhQD

String

10

x

Ngày ban hành quyết định thành lập. Định dạng YYYY-MM-DD.

3.3.3.2

SoKyHieuQDThanhLap

String

50

x

Số, ký hiệu quyết định thành lập.

3.3.3.3

NguoiKyQuyetDinh

String

255

Họ và tên người ký quyết định thành lập.

3.3.3.4

CoQuanBanHanhQD

String

255

Cơ quan ban hành quyết định thành lập.

3.3.4

TTQDPheDuyetDieuLe

Object

Quyết định phê duyệt Điều lệ nhiệm kỳ hiện tại

3.3.4.1

ThoiGianQDPheDuyet

String

10

Ngày ban hành quyết định phê duyệt Điều lệ. Định dạng YYYY-MM-DD.

3.3.4.2

SoKyHieuQDPheDuyet

String

50

Số, ký hiệu quyết định phê duyệt Điều lệ.

3.3.4.3

NguoiKyQuyetDinh

String

255

Họ và tên người ký quyết định thành lập.

3.3.4.4

CoQuanBanHanhQD

String

255

Cơ quan ban hành quyết định phê duyệt Điều lệ.

3.3.4.5

ThoiGianToChucDaiHoiKeTiep

String

4

Năm dự kiến tổ chức đại hội nhiệm kỳ kế tiếp. Định dạng YYYY

3.3.5

TonChiMucDichCuaHoi

String

5000

Nội dung tôn chỉ, mục đích hoạt động của Hội.

3.3.6

CoQuanQuanLyLVHD

String

2

Mã cơ quan quản lý lĩnh vực hoạt động chính của Hội Danh mục Cơ quan quản lý theo lĩnh vực hoạt động chính của Hội

3.3.7

LinhVucHoatDongChinh

String

2

Mã lĩnh vực hoạt động chính, theo danh mục lĩnh vực hoạt động

0 - Thanh tra

1 - Xây dựng

2 - Công an

3 - Công Thương

4 - Dân tộc và Tôn giáo

5 - Giáo dục và Đào tạo

6 - Khoa học, Công nghệ

7 - Nông nghiệp và Môi trường

8 - Ngoại giao

9 - Nội vụ

10 - Quốc phòng

11 - Tài chính

12 - Tư pháp

13 - Văn hóa, thể thao và du lịch

14 - Ngân hàng

15 - Y tế

16 - Những lĩnh vực khác

3.3.8

TinhChatHoi

String

1

Mã tính chất hội, theo danh mục Tính chất hội:

0 - Chính trị - xã hội - nghề nghiệp

1 - Chính trị - Xã hội

2 - Xã hội

3 - Xã hội - nghề nghiệp

4 - Hội đảng nhà nước giao nhiệm vụ

5 - Chưa xác định

3.3.9

LoaiHinhHoi

String

1

Mã loại hình hội theo danh mục Loại hình hội:

0 - Liên minh

1 - Liên đoàn

2 - Hiệp hội

3 - Liên hiệp hội

4 - Hội

5 - Tổng hội

6 - Câu lạc bộ

7 - Ủy ban

8 - Loại hình khác

3.3.10

TTTruSo

Object

Trụ sở chính

3.3.10.1

DiaChi

Object

Thông tin địa chỉ của trụ sở

3.3.10.1.1

DiaChiChiTiet

String

500

x

Địa chỉ chi tiết

3.3.10.1.2

MaXa

String

5

x

Mã xã, phường, thị trấn. Mã xã, phường, thị trấn theo danh mục quy định tại Quyết định 19/2025/QĐ-TTg

3.3.10.1.3

MaTinh

String

2

x

Mã tỉnh, thành phố trực thuộc trung ương. Mã tỉnh, thành phố trực thuộc trung ương theo danh mục quy định tại Quyết định 19/2025/QĐ-TTg

3.3.10.1.4

QuocGia

String

2

Mã quốc gia của địa chỉ trong trường hợp địa chỉ xác định ở nước ngoài. Mã quốc gia của địa chỉ theo danh mục quy định tại QCVN 109:2017/BTTTT

3.3.10.2

SoDienThoai

String

11

Số điện thoại của Hội.

3.3.10.3

Website

String

255

Địa chỉ website của Hội.

3.3.10.4

Email

String

255

Địa chỉ thư điện tử của Hội.

3.3.10.5

MaSoThue

String

14

Mã số thuế của Hội.

3.3.11

DSSoLuongHoiVien

Object

Danh sách thông tin số lượng hội viên

3.3.11.1

SoLuongHoiVien

Array<Object>

x

x

Thông tin số lượng hội viên từng năm

3.3.11.1.1

Nam

String

4

x

Năm thống kê số lượng hội viên. Định dạng YYYY

3.3.11.1.2

HoiVienChinhThuc

Object

Hội viên chính thức

3.3.11.1.2.1

HoiVienChinhThucCaNhanMoiKetNap

Number

8

Số hội viên mới kết nạp thuộc nhóm hội viên cá nhân, hội viên chính thức trong năm.

Giá trị nhỏ nhất: 0

Giá trị lớn nhất: (10^8)-1

3.3.11.1.2.2

HoiVienChinhThucCaNhanKhaiTru

Number

8

Số hội viên khai trừ thuộc nhóm hội viên cá nhân, hội viên chính thức trong năm.

Giá trị nhỏ nhất: 0

Giá trị lớn nhất: (10^8)-1

3.3.11.1.2.3

HoiVienChinhThucToChucMoiKetNap

Number

8

Số hội viên mới kết nạp thuộc nhóm hội viên tổ chức, hội viên chính thức trong năm.

Giá trị nhỏ nhất: 0

Giá trị lớn nhất: (10^8)-1

3.3.11.1.2.4

HoiVienChinhThucToChucKhaiTru

Number

8

Số hội viên khai trừ thuộc nhóm hội viên tổ chức, hội viên chính thức trong năm.

Giá trị nhỏ nhất: 0

Giá trị lớn nhất: (10^8)-1

3.3.11.1.3

HoiVienDanhDu

Object

Hội viên danh dự

3.3.11.1.3.1

HoiVienDanhDuCaNhanMoiKetNap

Number

8

Số hội viên mới kết nạp thuộc nhóm hội viên cá nhân, hội viên danh dự trong năm.

Giá trị nhỏ nhất: 0

Giá trị lớn nhất: (10^8)-1

3.3.11.1.3.2

HoiVienDanhDuCaNhanKhaiTru

Number

8

Số hội viên khai trừ thuộc nhóm hội viên cá nhân, hội viên danh dự trong năm.

Giá trị nhỏ nhất: 0

Giá trị lớn nhất: (10^8)-1

3.3.11.1.3.3

HoiVienDanhDuToChucMoiKetNap

Number

8

Số hội viên mới kết nạp thuộc nhóm hội viên tổ chức, hội viên danh dự trong năm.

Giá trị nhỏ nhất: 0

Giá trị lớn nhất: (10^8)-1

3.3.11.1.3.4

HoiVienDanhDuToChucKhaiTru

Number

8

Số hội viên khai trừ thuộc nhóm hội viên tổ chức, hội viên danh dự trong năm.

Giá trị nhỏ nhất: 0

Giá trị lớn nhất: (10^8)-1

3.3.11.1.4

HoiVienLienKet

Object

Hội viên liên kết

3.3.11.1.4.1

HoiVienLienKetCaNhanMoiKetNap

Number

8

Số hội viên mới kết nạp thuộc nhóm hội viên cá nhân, hội viên liên kết trong năm.

Giá trị nhỏ nhất: 0

Giá trị lớn nhất: (10^8)-1

3.3.11.1.4.2

HoiVienLienKetCaNhanKhaiTru

Number

8

Số hội viên khai trừ thuộc nhóm hội viên cá nhân, hội viên liên kết trong năm.

Giá trị nhỏ nhất: 0

Giá trị lớn nhất: (10^8)-1

3.3.11.1.4.3

HoiVienLienKetToChucMoiKetNap

Number

8

Số hội viên mới kết nạp thuộc nhóm hội viên tổ chức, hội viên liên kết trong năm.

Giá trị nhỏ nhất: 0

Giá trị lớn nhất: (10^8)-1

3.3.11.1.4.4

HoiVienLienKetToChucKhaiTru

Number

8

Số hội viên khai trừ thuộc nhóm hội viên tổ chức, hội viên liên kết trong năm.

Giá trị nhỏ nhất: 0

Giá trị lớn nhất: (10^8)-1

3.3.12

DSNguoiLamViecTaiHoi

Object

Danh sách thông tin số người làm việc tại Hội

3.3.12.1

NguoiLamViecTaiHoi

Array<Object>

x

x

Thông tin số người làm việc tại Hội

3.3.12.1.1

Nam

String

4

x

Năm thống kê người làm việc tại Hội. Định dạng YYYY

3.3.12.1.2

TongSoNguoiLamViecChuyenTrachTaiHoi

Number

8

x

Tổng số người làm việc chuyên trách tại Hội trong năm.

Giá trị nhỏ nhất: 0

Giá trị lớn nhất: (10^8)-1

3.3.12.1.3

TongSoBienCheDuocCoQuanNhaNuocCoThamQuyenGiao

Number

8

x

Tổng số biên chế được cơ quan nhà nước có thẩm quyền giao.

Giá trị nhỏ nhất: 0

Giá trị lớn nhất: (10^8)-1

3.3.12.1.4

SoNguoiLamViecTaiHoiDoHoiTuHopDong

Number

8

x

Số người làm việc tại Hội theo hợp đồng do Hội tự thỏa thuận.

Giá trị nhỏ nhất: 0

Giá trị lớn nhất: (10^8)-1

3.3.13

DSTTToChucPhapNhan

Object

Danh sách các tổ chức có tư cách pháp nhân thuộc Hội

3.3.13.1

TTToChucPhapNhan

Array<Object>

x

x

Thông tin tổ chức có tư cách pháp nhân thuộc Hội

3.3.13.1.1

TenDonVi

String

255

x

Tên tổ chức có tư cách pháp nhân thuộc Hội.

3.3.13.1.2

LoaiToChuc

String

2

x

Loại tổ chức, theo danh mục Loại tổ chức Danh mục Loại tổ chức thuộc Hội

3.3.13.1.3

ToChucPhapNhan

Boolean

x

Thông tin tổ chức pháp nhân.

0 – Không

1 - Có

3.3.13.1.4

DiaChi

Object

Địa chỉ của tổ chức.

3.3.13.1.4.1

DiaChiChiTiet

String

500

Địa chỉ chi tiết

3.3.13.1.4.2

MaXa

String

5

x

Mã xã, phường, thị trấn. Mã xã, phường, thị trấn theo danh mục quy định tại Quyết định 19/2025/QĐ-TTg

3.3.13.1.4.3

MaTinh

String

2

x

Mã tỉnh, thành phố trực thuộc trung ương. Mã tỉnh, thành phố trực thuộc trung ương theo danh mục quy định tại Quyết định 19/2025/QĐ-TTg

3.3.13.1.4.4

QuocGia

String

2

Mã quốc gia của địa chỉ trong trường hợp địa chỉ xác định ở nước ngoài. Mã quốc gia của địa chỉ theo danh mục quy định tại QCVN 109:2017/BTTTT

3.3.13.1.5

MaSoThue

String

14

Mã số thuế của tổ chức.

3.3.13.1.6

DienThoai

String

11

Số điện thoại của tổ chức.

3.3.13.1.7

SoQuyetDinhThanhLap

String

255

Số quyết định thành lập tổ chức.

3.3.13.1.8

NgayQuyetDinh

String

10

Ngày ban hành quyết định thành lập tổ chức. Định dạng YYYY-MM-DD.

3.3.13.1.9

CoQuanBanHanhQuyetDinh

String

255

Cơ quan ban hành quyết định thành lập tổ chức

3.3.14

DSQuyCheQuyDinh

Object

Danh sách quy chế, quy định nội bộ của Hội

3.3.14.1

QuyCheQuyDinh

Array<Object>

x

x

Quy chế, quy định nội bộ của Hội

3.3.14.1.1

TenQuyCheQuyDinhNoiBoCuaHoi

String

2025

x

Tên quy chế hoặc quy định nội bộ của Hội.

3.3.14.1.2

CoQuanDonViBanHanh

String

255

x

Tên cơ quan, đơn vị ban hành quy chế, quy định.

3.3.14.1.3

GhiChu

String

2025

Thông tin ghi chú.

3.4

DSLanhDao

Object

Danh sách các Lãnh đạo hội của Hội

3.4.1

LanhDao

Array<Object>

x

x

Thông tin Lãnh đạo hội của Hội

3.4.1.1

DSCapLanhDaoHoi

Object

x

Danh sách cấp lãnh đạo Hội

3.4.1.1.1

CapLanhDao

Array<String>

1

x

x

Thông tin cấp lãnh đạo Hội Danh mục cấp lãnh đạo Hội

1- Lãnh đạo hội

2 - Ban chấp hành

3 - Ban thường vụ

4 - Ban kiểm tra

5 - Lãnh đạo văn phòng

6 - Lãnh đạo phòng ban

7 - Lãnh đạo tổ chức

8 - Lãnh đạo chi hội

3.4.1.2

SoDinhDanh

String

12

x

Số định danh cá nhân

3.4.1.3

HoVaTen

String

150

x

Họ, chữ đệm và tên khai sinh

3.4.1.4

GioiTinh

String

2

Giới tính theo danh mục tại QCVN 109:2017/BTTTT:

0 - Chưa có thông tin

1 - Giới tính nam

2 - Giới tính nữ

3.4.1.5

NgayThangNamSinh

Object

Ngày tháng năm sinh

3.4.1.5.1

NgayThangNam

String

10

x

Ngày tháng năm sinh. Định dạng YYYY-MM-DD (Chỉ lựa chọn 1 trong các định dạng ngày)

3.4.1.5.2

ThangNam

String

7

Tháng năm sinh. Định dạng YYYY-MM

3.4.1.5.3

Nam

String

4

Năm sinh. Định dạng YYYY

3.4.1.6

DSGiayToDinhDanhCN

Object

Danh sách giấy tờ định danh cá nhân

3.4.1.6.1

GiayToDinhDanhCN

Array<Object>

x

x

Giấy tờ định danh cá nhân

3.4.1.6.1.1

LoaiGiayTo

String

2

x

Loại giấy tờ cá nhân theo danh mục

- 1: Giấy khai sinh

- 2: Chứng minh nhân dân

- 3: Giấy chứng minh sỹ quan quân đội nhân dân Việt Nam

- 4: Giấy chứng minh công an nhân dân

- 5: Căn cước công dân

- 6: Hộ chiếu

- 7: Sổ hộ khẩu

- 8: Các loại giấy tờ tùy thân khác

3.4.1.6.1.2

SoGiayTo

String

30

x

Số giấy tờ.

3.4.1.6.2

NgayCap

Object

Ngày cấp giấy tờ

3.4.1.6.2.1

NgayThangNam

String

10

x

Ngày tháng năm cấp giấy tờ. Định dạng YYYY-MM-DD (Chỉ lựa chọn 1 trong các định dạng ngày)

3.4.1.6.2.2

ThangNam

String

7

Tháng năm cấp giấy tờ. Định dạng YYYY-MM

3.4.1.6.2.3

Nam

String

4

Năm cấp giấy tờ. Định dạng YYYY

3.4.1.6.3

NoiCap

String

200

Nơi cấp

3.4.1.6.4

NgayHetHan

Object

Ngày hết hạn

3.4.1.6.4.1

NgayThangNam

String

10

x

Ngày tháng năm hết hạn. Định dạng YYYY-MM-DD (Chỉ lựa chọn 1 trong các định dạng ngày)

3.4.1.6.4.2

ThangNam

String

7

Tháng năm hết hạn. Định dạng YYYY-MM

3.4.1.6.4.3

Nam

String

4

Năm hết hạn. Định dạng YYYY

3.4.1.7

ChucDanh

String

2

x

Mã chức danh, theo danh mục Chức danh Hội

0 - Chánh Văn phòng

1 - Phó Chánh Văn phòng

2 - Viện trưởng

3 - Tổng biên tập

4 - Chi hội trưởng

5 - Chi hội phó

6 - Trưởng ban

7 - Phó Trưởng ban

8 - Trưởng phòng

9 - Phó Trưởng phòng

10 - Trưởng ban kiểm tra

11 - Ủy viên Ban Thường vụ

12 - Chủ tịch

13 - Phó Chủ tịch - Tổng Thư ký Hội

14 - Ủy viên Ban Chấp hành

15 - Giám đốc

16 - Phó giám đốc

17 - Khác

3.4.1.8

CoQuanDangCongTac

String

255

Cơ quan nơi cá nhân đang công tác

3.4.1.9

ChucDanhChucVuCaoNhat

String

3

Chức danh, chức vụ cao nhất đã từng đảm nhiệm trong cơ quan nhà nước Danh mục Chức danh, chức vụ trong cơ quan nhà nước

3.5

QuaTrinhHoatDong

Object

Quá trình hoạt động

3.5.1

QDThanhLapBVD

Object

Quyết định thành lập Ban vận động của Hội

3.5.1.1

ThoiGianBanHanh

String

10

x

Ngày ban hành quyết định thành lập Ban vận động. Định dạng YYYY-MM-DD.

3.5.1.2

SoKyHieuQD

String

50

x

Số, ký hiệu quyết định thành lập Ban vận động.

3.5.1.3

NguoiKyQD

String

255

Họ và tên người ký quyết định.

3.5.1.4

CoQuanBanHanh

String

255

Cơ quan ban hành quyết định

3.5.2

DSNguoiBanVanDong

Object

Danh sách người trong Ban vận động

3.5.2.1

NguoiBanVanDong

Array<Object>

x

x

Thông tin người trong Ban vận động

3.5.2.1.1

SoDinhDanh

String

12

x

Số định danh cá nhân

3.5.2.1.2

HoVaTen

String

150

x

Họ, chữ đệm và tên khai sinh

3.5.2.1.3

GioiTinh

String

2

Giới tính theo danh mục tại QCVN 109:2017/BTTTT:

0 - Chưa có thông tin

1 - Giới tính nam

2 - Giới tính nữ

3.5.2.1.4

NgayThangNamSinh

Object

x

Ngày tháng năm sinh

3.5.2.1.4.1

NgayThangNam

String

10

x

Ngày tháng năm sinh. Định dạng YYYY-MM-DD (Chỉ lựa chọn 1 trong các định dạng ngày)

3.5.2.1.4.2

ThangNam

String

7

Tháng năm sinh. Định dạng YYYY-MM

3.5.2.1.4.3

Nam

String

4

Năm sinh. Định dạng YYYY

3.5.2.1.5

DSGiayToDinhDanhCN

Object

Danh sách giấy tờ định danh cá nhân

3.5.2.1.5.1

GiayToDinhDanhCN

Array<Object>

x

x

Giấy tờ định danh cá nhân

3.5.2.1.5.1.1

LoaiGiayTo

String

2

x

Loại giấy tờ cá nhân theo danh mục

- 1: Giấy khai sinh

- 2: Chứng minh nhân dân

- 3: Giấy chứng minh sỹ quan quân đội nhân dân Việt Nam

- 4: Giấy chứng minh công an nhân dân

- 5: Căn cước công dân

- 6: Hộ chiếu

- 7: Sổ hộ khẩu

- 8: Các loại giấy tờ tùy thân khác

3.5.2.1.5.1.2

SoGiayTo

String

30

x

Số giấy tờ.

3.5.2.1.5.2

NgayCap

Object

Ngày cấp giấy tờ

3.5.2.1.5.2.1

NgayThangNam

String

10

x

Ngày tháng năm cấp giấy tờ. Định dạng YYYY-MM-DD (Chỉ lựa chọn 1 trong các định dạng ngày)

3.5.2.1.5.2.2

ThangNam

String

7

Tháng năm cấp giấy tờ. Định dạng YYYY-MM

3.5.2.1.5.2.3

Nam

String

4

Năm cấp giấy tờ. Định dạng YYYY

3.5.2.1.5.3

NoiCap

String

200

Nơi cấp

3.5.2.1.5.4

NgayHetHan

Object

Ngày hết hạn

3.5.2.1.5.4.1

NgayThangNam

String

10

x

Ngày tháng năm hết hạn. Định dạng YYYY-MM-DD (Chỉ lựa chọn 1 trong các định dạng ngày)

3.5.2.1.5.4.2

ThangNam

String

7

Tháng năm hết hạn. Định dạng YYYY-MM

3.5.2.1.5.4.3

Nam

String

4

Năm hết hạn. Định dạng YYYY

3.5.2.1.6

QueQuan

Object

Quê quán

3.5.2.1.6.1

DiaChiChiTiet

String

500

x

Địa chỉ chi tiết.

3.5.2.1.6.2

MaXa

String

5

x

Mã xã, phường, thị trấn. Mã xã, phường, thị trấn theo danh mục quy định tại Quyết định 19/2025/QĐ-TTg.

3.5.2.1.6.3

MaTinh

String

2

x

Mã tỉnh, thành phố trực thuộc trung ương. Mã tỉnh, thành phố trực thuộc trung ương theo danh mục quy định tại Quyết định 19/2025/QĐ-TTg.

3.5.2.1.6.4

QuocGia

String

3

Mã quốc gia của địa chỉ trong trường hợp địa chỉ xác định ở nước ngoài. Mã quốc gia của địa chỉ theo danh mục quy định tại QCVN 109:2017/BTTTT

3.5.2.1.7

TrinhDoChuyenMon

String

30

Mã trình độ chuyên môn, theo danh mục Trình độ chuyên môn

3.5.2.1.8

ChucDanhTrongBanVanDong

String

1

Mã chức danh trong Ban vận động, theo danh mục Chức danh trong Ban vận động:

0 – Trưởng ban

1 – Phó Trưởng ban

2 – Thành viên

3.5.2.1.9

DSQuaTrinhToChucDaiHoi

Object

Danh sách Quá trình tổ chức đại hội

3.5.2.1.9.1

QuaTrinhToChucDaiHoi

Array<Object>

x

x

Thông tin tổ chức đại hội

3.5.2.1.9.1.1

NhiemKy

String

255

x

Nhiệm kỳ đại hội chọn từ danh mục, theo danh mục Nhiệm kỳ

3.5.2.1.9.1.2

ThoiGianBatDau

String

10

x

Thời gian bắt đầu nhiệm kỳ. Định dạng YYYY-MM-DD.

3.5.2.1.9.1.3

ThoiGianKetThuc

String

10

x

Thời gian kết thúc nhiệm kỳ. Định dạng YYYY-MM-DD.

3.5.2.1.9.1.4

ChuTich

String

255

x

Họ tên chủ tịch của nhiệm kỳ.

3.5.2.1.9.1.5

TongThuKy

String

255

Họ tên tổng thư ký của nhiệm kỳ.

3.5.2.1.9.1.6

NgayToChuc

String

10

Ngày tổ chức đại hội. Định dạng YYYY-MM-DD.

3.5.2.1.10

DSBaoCaoHoatDongNam

Object

Danh sách Báo cáo hoạt động năm

3.5.2.1.10.1

Nam

Array<String>

4

x

x

Năm báo cáo hoạt động. Định dạng YYYY

3.5.2.1.11

DSTiepNhanVienTro

Object

Danh sách Tiếp nhận viện trợ không hoàn lại của nước ngoài

3.5.2.1.11.1

TiepNhanVienTro

Array<Object>

x

x

Tiếp nhận viện trợ không hoàn lại của nước ngoài

3.5.2.1.11.1.1

TenDuAnPhiDuAn

String

255

x

Tên dự án hoặc phi dự án.

3.5.2.1.11.1.2

DonViThucHien

String

255

Đơn vị thực hiện dự án/phi dự án.

3.5.2.1.11.1.3

TenToChucVienTro

String

255

Tên tổ chức viện trợ.

3.5.2.1.11.1.4

TongVonDuAn

Number

15

Tổng vốn của dự án/phi dự án (VNĐ)

Giá trị nhỏ nhất: 0

Giá trị lớn nhất (10^8)-1

3.5.2.1.11.1.5

VonVienTro

Number

15

Giá trị vốn viện trợ.

Giá trị nhỏ nhất: 0

Giá trị lớn nhất (10^8)-1

3.5.2.1.11.1.6

VonDoiUng

Number

15

Giá trị vốn đối ứng.

Giá trị nhỏ nhất: 0

Giá trị lớn nhất (10^8)-1

3.5.2.1.11.1.7

ThoiGianThucHien

String

10

x

Thời gian bắt đầu thực hiện. Định dạng YYYY-MM-DD.

3.5.2.1.11.1.8

ThoiGianKetThuc

String

10

x

Thời gian kết thúc. Định dạng YYYY-MM-DD.

3.5.2.1.11.1.9

TongThoiGianThucHien

String

255

x

Tổng thời gian thực hiện dự án/phi dự án.

3.5.2.1.11.1.10

DiaDiemTrienKhai

String

255

Địa điểm triển khai.

3.5.2.1.11.1.11

HienTrangTrienKhai

String

500

Hiện trạng triển khai

3.6

TaiChinhTaiSan

Object

Tài chính, tài sản

3.6.1

DSTaiChinh

Object

Danh sách Tài chính của Hội

3.6.1.1

TaiChinh

Array<Object>

x

x

Thông tin Tài chính của Hội

3.6.1.1.1

Nam

String

4

x

Năm tài chính. Định dạng YYYY

3.6.1.1.2

NganSachNhaNuocHoTro

Number

15

Giá trị ngân sách nhà nước hỗ trợ trong năm (VNĐ)

Giá trị nhỏ nhất: 0

Giá trị lớn nhất (10^15)-1

3.6.1.1.3

NguonKinhPhiTuNuocNgoai

Number

15

Giá trị nguồn kinh phí từ nước ngoài trong năm (VNĐ)

Giá trị nhỏ nhất: 0

Giá trị lớn nhất (10^15)-1

3.6.1.1.4

NguonKhac

Number

15

Giá trị nguồn kinh phí khác trong năm (VNĐ)

Giá trị nhỏ nhất: 0

Giá trị lớn nhất (10^15)-1

3.6.1.1.5

TongThu

Number

15

Tổng thu trong năm (VNĐ)

Giá trị nhỏ nhất: 0

Giá trị lớn nhất (10^15)-1

3.6.1.1.6

TongChi

Number

15

Tổng chi trong năm (VNĐ)

Giá trị nhỏ nhất: 0

Giá trị lớn nhất (10^15)-1

3.6.1.1.7

DienGiai

String

1025

Nội dung diễn giải tài chính.

3.6.2

DSTaiSan

Object

Danh sách Tài sản của Hội

3.6.2.1

TaiSan

Array<Object>

x

x

Thông tin Tài sản của Hội

3.6.2.1.1

Nam

String

4

x

Năm thống kê tài sản. Định dạng YYYY

3.6.2.1.2

TaiSanHinhThanhTuNganSachNhaNuoc

String

15

Giá trị tài sản hình thành từ ngân sách nhà nước (VNĐ)

Giá trị nhỏ nhất: 0

Giá trị lớn nhất (10^15)-1

3.6.2.1.3

TaiSanTuNguonVienTroVaNguonHopPhap

String

15

Giá trị tài sản từ nguồn viện trợ và nguồn hợp pháp (VNĐ)

Giá trị nhỏ nhất: 0

Giá trị lớn nhất (10^15)-1

3.6.2.1.4

TongTaiSan

String

15

Tổng giá trị tài sản (VNĐ)

Giá trị nhỏ nhất: 0

Giá trị lớn nhất (10^15)-1

3.6.2.1.5

DienGiai

String

1025

Nội dung diễn giải tài sản.

3.7

KhenThuongXuLyViPham

Object

Khen thưởng xử lý, vi phạm

3.7.1

DSKhenThuong

Object

Danh sách Khen thưởng

3.7.1.1

KhenThuong

Array<Object>

x

x

Thông tin Khen thưởng

3.7.1.1.1

Nam

String

4

x

Năm khen thưởng. Định dạng YYYY

3.7.1.1.2

QuyetDinhKhenThuong

String

255

Thông tin quyết định khen thưởng.

3.7.1.1.3

HinhThucKhenThuong

String

1

x

Mã hình thức khen thưởng, theo danh mục hình thức khen thưởng:

0 - Bằng khen của Thủ tướng Chính phủ

1 - Huân chương Lao động Hạng Ba

2 - Huân chương Lao động Hạng Hai

3 - Huân chương Lao động Hạng Nhất

4 - Quà tặng

5 - Giải thưởng chuyên đề

6 - Kỷ niệm chương, huy hiệu

7 - Danh hiệu, chứng nhận

8 - Bằng khen, giấy khen

9 - Khác

3.7.1.1.4

CapCoThamQuyenKhenThuong

String

255

Cấp có thẩm quyền khen thưởng cho hội.

3.7.2

DSXuLyViPham

Object

Danh sách Xử lý vi phạm

3.7.2.1

XuLyViPham

Array<Object>

x

x

Thông tin Xử lý vi phạm

3.7.2.1.1

Nam

String

4

x

Năm xử lý vi phạm. Định dạng YYYY

3.7.2.1.2

QuyetDinhKyLuat

String

255

Thông tin quyết định kỷ luật.

3.7.2.1.3

HinhThucKyLuat

String

1

x

Mã hình thức kỷ luật, theo danh mục hình thức kỷ luật:

0 - Bãi nhiệm, cách chức

1 - Tạm đình chỉ hoạt động

2 - Cảnh cáo bằng văn bản

3 - Khiển trách

4 - Nhắc nhở, cảnh cáo nội bộ

5 - Hình thức khác

3.7.2.1.4

HanhViKyLuat

String

255

Hành vi kỷ luật.

3.7.2.1.5

SoTruongHopKyLuat

Number

4

Số trường hợp bị kỷ luật.

Giá trị nhỏ nhất: 0

Giá trị lớn nhất: 9999

3.7.2.1.6

SoTruongHopGiaiQuyet

Number

4

Số trường hợp đã giải quyết.

Giá trị nhỏ nhất: 0

Giá trị lớn nhất: 9999

3.7.2.1.7

CoQuanQuyetDinh

String

255

Cơ quan ban hành quyết định kỷ luật, theo danh mục Cơ quan

3.7.3

DSKhenThuongNoiBo

Object

Danh sách Khen thưởng nội bộ

3.7.3.1

KhenThuongNoiBo

Array<Object>

x

x

Thông tin Khen thưởng nội bộ

3.7.3.1.1

Nam

Number

4

x

Năm khen thưởng nội bộ. Định dạng YYYY

3.7.3.1.2

QuyetDinhKhenThuong

String

255

Thông tin quyết định khen thưởng.

3.7.3.1.3

HinhThucKhenThuong

String

1

x

Hình thức khen thưởng Hình thức khen thưởng chọn từ danh mục:

0 - Bằng khen của Thủ tướng Chính phủ

1 - Huân chương Lao động Hạng Ba

2 - Huân chương Lao động Hạng Hai

3 - Huân chương Lao động Hạng Nhất

4 - Quà tặng

5 - Giải thưởng chuyên đề

6 - Kỷ niệm chương, huy hiệu

7 - Danh hiệu, chứng nhận

8 - Bằng khen, giấy khen

9 - Khác

3.7.3.1.4

CapCoThamQuyenKhenThuong

String

30

Cấp có thẩm quyền khen thưởng, theo danh mục Phân cấp

3.7.4

DSXuLyViPhamNoiBo

Object

Danh sách Xử lý vi phạm nội bộ

3.7.4.1

XuLyViPhamNoiBo

Array<Object>

x

x

Thông tin Xử lý vi phạm nội bộ

3.7.4.1.1

Nam

String

4

x

Năm xử lý vi phạm. Định dạng YYYY

3.7.4.1.2

QuyetDinhKyLuat

String

255

Thông tin quyết định kỷ luật.

3.7.4.1.3

HinhThucKyLuat

String

1

x

Mã hình thức kỷ luật, theo danh mục hình thức kỷ luật:

0 - Bãi nhiệm, cách chức

1 - Tạm đình chỉ hoạt động

2 - Cảnh cáo bằng văn bản

3 - Khiển trách

4 - Nhắc nhở, cảnh cáo nội bộ

5 - Hình thức khác

3.7.4.1.4

HanhViKyLuat

String

255

Hành vi kỷ luật.

3.7.4.1.5

SoTruongHopKyLuat

Number

4

Số trường hợp bị kỷ luật.

Giá trị nhỏ nhất: 0

Giá trị lớn nhất: 9999

3.7.4.1.6

SoTruongHopGiaiQuyet

Number

4

Số trường hợp đã giải quyết.

Giá trị nhỏ nhất: 0

Giá trị lớn nhất: 9999

3.7.4.1.7

CoQuanQuyetDinh

String

255

Cơ quan ban hành quyết định kỷ luật, theo danh mục Cơ quan

Địa chỉ kết nối

URL

{{base_url}}/apiHoiQuy/1.0/api/v1/thongtinhoi

Request header

Method

GET

Content-Type

application/json

Authorization

Bearer {token} (token sinh ra từ dịch vụ hq_token)

Request

Tham số

?tuThoiDiem=2026-10-01T00:00:00&denThoiDiem=2026-10-15T23:59:59&pageNumber=0&pageSize=20

Body

Không sử dụng

Response Body

Thành công

{

"code": 200,

"message": "Thành công!",

"response_time": "2026-10-15T10:20:00+07:00",

"data": {

"content": [

{

"idBanGhi": "G09-thongtinhoi-000123",

"maHoi": "HOI000000000123",

"maLoaiDuLieu": "thongtinhoi",

"suKien": "UPDATE",

"phienBan": 2,

"thoiGianCapNhat": "2026-10-10T14:05:00",

"duLieu":

"PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVR

GLTgiPz4..."

}

],

"pageNumber": 0,

"pageSize": 20,

"totalElements": 1,

"totalPages": 1

}

}

Không thành công

{

"code": 400,

"message": "Mô tả lỗi tham số khai thác",

"response_time": "2026-10-15T10:20:00+07:00"

}

Ví dụ bản tin

duLieu (sau giải mã)

<?xml version="1.0" encoding="UTF-8"?>

<Root>

<NguonDuLieu>

<IdNguonDuLieu>G09</IdNguonDuLieu>

<MaLoaiDuLieu>thongtinhoi</MaLoaiDuLieu>

</NguonDuLieu>

<TrangThaiDuLieu>

<SuKien>UPDATE</SuKien>

<LoaiSuKien>1</LoaiSuKien>

<PhienBan>2</PhienBan>

<NgayHieuLuc>2026-10-10T00:00:00</NgayHieuLuc>

<ThoiGianCapNhat>2026-10-

10T14:05:00</ThoiGianCapNhat>

</TrangThaiDuLieu>

<DuLieuChiaSe>

<IdBanGhi>G09-thongtinhoi-000123</IdBanGhi>

<MaHoi>HOI000000000123</MaHoi>

<TTToChucHoi>

<TTCapToChuc>

<CapToChuc>0</CapToChuc>

<PhamViHoatDong>0</PhamViHoatDong>

<LaHoiDangNhaNuocGiaoNhiemVu>0</LaHoiDangNhaN

uocGiaoNhiemVu>

</TTCapToChuc>

<TTTenGoiHoi>

<TenTiengViet>Hội A</TenTiengViet>

</TTTenGoiHoi>

<QDThanhLap>

<ThoiGianBanHanhQD>2010-05-

20</ThoiGianBanHanhQD>

<SoKyHieuQDThanhLap>123/QĐ-

BNV</SoKyHieuQDThanhLap>

</QDThanhLap>

...

</TTToChucHoi>

...

</DuLieuChiaSe>

</Root>

TT

Tên tham số

Kiểu dữ liệu

Bắt buộc

Mô tả

1

maQuy

String

Mã đơn vị quỹ (khóa nghiệp vụ). Khi truyền tham số này, dịch vụ trả về dữ liệu của 01 quỹ

2

tuThoiDiem

String

Lấy các bản ghi có ThoiGianCapNhat lớn hơn hoặc bằng giá trị này; dùng cho đồng bộ gia tăng. Định dạng YYYY-MM-DDTHH:mm:ss

3

denThoiDiem

String

Lấy các bản ghi có ThoiGianCapNhat nhỏ hơn hoặc bằng giá trị này. Định dạng YYYY-MM-DDTHH:mm:ss

4

pageNumber

Number

Số thứ tự trang cần lấy, tính từ 0. Mặc định: 0

5

pageSize

Number

Số bản ghi trên một trang. Mặc định: 20; tối đa: 100

STT

Tên

Kiểu

Bắt buộc

Lặp

Ghi chú

1

code

Number

x

Mã trạng thái:

200: Khai thác thành công Khác 200: Không thành công (chi tiết lỗi mô tả trong trường message)

2

message

String

x

Mô tả trạng thái hoặc lỗi

3

response_time

String

x

Thời gian phản hồi kết quả

4

data

Object

Dữ liệu trả về, chỉ có khi code = 200

4.1

content

Array

x

x

Danh sách bản ghi dữ liệu, sắp xếp theo thoiGianCapNhat tăng dần

4.1.1

idBanGhi

String

x

ID bản ghi, trùng với thẻ DuLieuChiaSe/IdBanGhi của bản tin

4.1.2

maQuy

String

x

Mã đơn vị quỹ (khóa nghiệp vụ)

4.1.3

maLoaiDuLieu

String

x

Mã loại dữ liệu của bản tin: thongtinquy

4.1.4

suKien

String

x

Trạng thái thay đổi của bản ghi tại Cơ sở dữ liệu nguồn: NEW (bản ghi mới phát sinh), UPDATE (bản ghi đã được cơ quan có thẩm quyền sửa đổi), CANCEL (bản ghi đã bị hủy)

4.1.5

phienBan

Number

x

Phiên bản dữ liệu của bản ghi

4.1.6

thoiGianCapNhat

String

x

Thời gian bản ghi được cập nhật. Định dạng YYYY-MM-DDTHH:mm:ss

4.1.7

duLieu

String

x

Bản tin XML mã hóa base64. Cấu trúc bản tin theo bảng Cấu trúc bản tin dữ liệu dưới đây

4.2

pageNumber

Number

x

Số thứ tự trang hiện tại, tính từ 0

4.3

pageSize

Number

x

Số bản ghi trên một trang

4.4

totalElements

Number

x

Tổng số bản ghi thỏa điều kiện khai thác

4.5

totalPages

Number

x

Tổng số trang

STT

Tên

Kiểu

Kích thước tối đa

Bắt buộc

Lặp

Ghi chú

I

Root

x

Phần mô tả

1.

NguonDuLieu

Object

x

Chứa thông tin xác định nguồn dữ liệu

1.1

IdNguonDuLieu

String

10

x

Mã nguồn dữ liệu, tham chiếu theo bảng mã kèm Quyết định số 20/2020/QĐ-TTg ngày 22/7/2020 của Thủ tướng Chính phủ và quy định liên quan. Đối với Bộ Nội vụ: G09

1.2

MaLoaiDuLieu

String

100

x

Mã loại dữ liệu, là duy nhất. Mã quy ước: thongtinquy

2.

TrangThaiDuLieu

Object

x

Chứa thông tin trạng thái dữ liệu

2.1

SuKien

String

10

x

Trạng thái thay đổi của bản ghi tại Cơ sở dữ liệu nguồn, dùng để hệ thống khai thác xử lý bản sao dữ liệu của mình:

- NEW: Bản ghi mới phát sinh

- UPDATE: Bản ghi đã được cơ quan có thẩm quyền sửa đổi

- CANCEL: Bản ghi đã bị hủy (hủy mềm)

2.2

LoaiSuKien

String

2

x

Mức độ thay đổi của bản ghi, giúp hệ thống khai thác quyết định có cần thông báo cho người dùng của mình hay không:

- 1: Thay đổi thông thường, hệ thống khai thác chỉ cần đồng bộ dữ liệu

- 2: Thay đổi quan trọng (ví dụ: thành lập, giải thể, đổi tên hội, quỹ; thay đổi lãnh đạo), hệ thống khai thác đồng bộ dữ liệu và nên thông báo cho người dùng của mình

2.3

MoTa

Object

Mô tả cập nhật. Chỉ sử dụng với trường hợp cập nhật hoặc hủy

2.3.1

LyDoCapNhat

String

2000

Lý do cập nhật

2.3.2

ChiTietLyDoCapNhat

String

2000

Mô tả chi tiết thông tin cập nhật

2.4

PhienBan

Number

10

x

Là số nguyên khác 0. Bộ Nội vụ tăng số PhienBan mỗi khi bản ghi thay đổi. Hệ thống khai thác dựa trên thông tin SuKien và PhienBan để đồng bộ dữ liệu có phiên bản lớn nhất vào hệ thống khai thác và không xử lý trường hợp PhienBan nhỏ hơn hoặc bằng PhienBan lớn nhất đã có tại hệ thống khai thác.

Giá trị nhỏ nhất: 1

Giá trị lớn nhất: (2^31)-1

2.5

NgayHieuLuc

String

20

Ngày dữ liệu có giá trị pháp lý. Trường hợp dữ liệu không xác định Ngày hiệu lực thì được gán là ngày dữ liệu được cập nhật vào Cơ sở dữ liệu về hội, quỹ, tổ chức phi chính phủ. Định dạng YYYY-MM-DDTHH:mm:ss. Giờ áp dụng theo giờ Hà Nội GMT+7. Giờ (HH) là số tự nhiên 0-23.

2.6

ThoiGianCapNhat

String

20

x

Thời gian dữ liệu được cập nhật vào Cơ sở dữ liệu về hội, quỹ, tổ chức phi chính phủ:

- Trường hợp SuKien là NEW: là thời gian thêm mới dữ liệu.

- Trường hợp SuKien là UPDATE hoặc CANCEL: là thời gian gần nhất bản ghi được chỉnh sửa, thay đổi thông tin. Định dạng YYYY-MM-DDTHH:mm:ss. Giờ áp dụng theo giờ Hà Nội GMT+7. Giờ (HH) là số tự nhiên 0-23.

3.

DuLieuChiaSe

Object

x

Dữ liệu chia sẻ là thông tin của 01 quỹ. Khi có thay đổi thông tin, toàn bộ thông tin của quỹ được cung cấp lại với PhienBan mới.

3.1

IdBanGhi

String

150

x

ID bản ghi là duy nhất; hệ thống khai thác sử dụng IdBanGhi là khóa chính để đối soát, đồng bộ dữ liệu tại hệ thống khai thác

3.2

MaQuy

String

15

x

Mã đơn vị quỹ

* Khóa nghiệp vụ

3.3

TTToChucQuy

Object

x

Thông tin tổ chức Quỹ

3.3.1

TTCapToChuc

Object

x

Mã số, biểu tượng, cấp tổ chức của Quỹ

3.3.1.1

MaSoQuy

String

50

x

Mã số của Quỹ.

3.3.1.2

CapToChuc

String

1

x

Mã cấp tổ chức, theo danh mục Cấp tổ chức

0 - Trung ương

1 - Liên tỉnh

2 - Tỉnh, thành phố

3 - Xã, phường, đặc khu

4 - Khác

3.3.1.3

PhamViHoatDong

String

1

x

Mã phạm vi hoạt động của quỹ theo danh mục Phạm vi hoạt động của quỹ

0 - Toàn quốc

1 - Liên tỉnh

2 - Tỉnh/Thành phố trực thuộc Trung ương

3 - Xã/Phường/Đặc khu

3.3.2

TTTenGoiQuy

Object

x

Thông tin tên gọi của Quỹ

3.3.2.1

TenTiengViet

String

255

x

Tên gọi của Quỹ bằng tiếng Việt.

3.3.2.2

TenTiengAnh

String

255

Tên gọi của Quỹ bằng tiếng Anh, nếu có.

3.3.2.3

TenVietTat

String

255

Tên viết tắt của Quỹ, nếu có.

3.3.3

QDThanhLap

Object

x

Thông tin quyết định cấp giấy phép thành lập và công nhận Điều lệ

3.3.3.1

ThoiGianBanHanhQD

String

10

x

Ngày ban hành quyết định cấp giấy phép thành lập và công nhận Điều lệ. Định dạng YYYY-MM-DD.

3.3.3.2

SoKyHieuQDThanhLap

String

50

x

Số, ký hiệu quyết định cấp giấy phép thành lập và công nhận Điều lệ.

3.3.3.3

NguoiKyQuyetDinh

String

255

Họ và tên người ký quyết định.

3.3.3.4

CoQuanBanHanhQD

String

255

Cơ quan ban hành quyết định.

3.3.4

QDCongNhanQuyDuDieuKien

Object

Quyết định công nhận Quỹ đủ điều kiện hoạt động

3.3.4.1

ThoiGianQDCongNhan

String

10

Ngày ban hành quyết định công nhận Quỹ đủ điều kiện hoạt động. Định dạng YYYY-MM-DD.

3.3.4.2

SoKyHieuQDCongNhan

String

50

Số, ký hiệu quyết định công nhận Quỹ đủ điều kiện hoạt động.

3.3.4.3

NguoiKyQuyetDinh

String

255

Họ và tên người ký quyết định công nhận.

3.3.4.4

CoQuanBanHanhQD

String

255

Cơ quan ban hành quyết định công nhận.

3.3.4.5

Nam

String

4

Năm của quyết định công nhận. Định dạng YYYY

3.3.5

QDCongNhanHDQL

Object