Báo cáo danh sách cán bộ

1. Mô tả chung

API này giúp các phòng và trường đối tác thực hiện gửi dữ liệu báo cáo cán bộ khi có yêu cầu thực hiện báo cáo.

2. Phạm vi đối tượng sử dụng

• Các trường học, phòng giáo dục liên kết với GEdu.
• Các hệ thống đối tác tích hợp như phần mềm quản lý học sinh, cổng thông tin giáo dục,...

3. Chuẩn bị cho Api

• Thực hiện lấy danh sách đợt báo cáo hiện có để lấy reportingRoundId
• Xem cách lấy thông tin đợt báo cáo tại : 👉 Xem thêm

4. Tài liệu api

4.1 Gửi dữ liệu báo cáo

Dùng để gửi thông tin cán bộ để thống kê dữ liệu ngành

• 4.1.1 Endpoint:

POST /edu/v1/external/reporting-rounds/employees

• 4.1.2 Request Parameters:

EmployeeModel

Tên	Kiểu dữ liệu	Bắt buộc	Mô tả
reportingRoundId	int	Có	Id đợt báo cáo
schoolCode	string	Có	Mã định danh trường
employeeItems	EmployeeItem[]	Có	Chi tiết cán bộ
timestamp	long	Có	Thời điểm request
signature	string	Có	Chữ ký xác thực. Mã hóa base64

EmployeeItem

Tên	Kiểu dữ liệu	Bắt buộc	Mô tả
FirstName	string	Có	Họ và tên lót
LastName	string	Có	Tên cán buộc
DoB	DateTime	Có	Ngày sinh
IdentityNo	string	Có	Căn cước công dân
StatusName	string	Có	Trạng thái
GenderName	string	Không	Giới tính
IdentityIssuedBy	string	Không	Được cấp bởi
IdentityIssuedDate	DateTime	Không	Ngày cấp
Email	string	Không	Email
Phone	string	Không	Số điện thoại
EthnicName	string	Không	Dân tộc
ReligionName	string	Không	Tôn giáo
ProvinceName	string	Không	Tỉnh / Thành phố
DistrictName	string	Không	Quận
WardName	string	Không	Huyện
Address	string	Không	Địa chỉ
Hometown	string	Không	Quê quán
MajorName	string	Không	Chuyên ngành
UniversityName	string	Không	Tên trường đại học
EducationLevelName	string	Không	Trình độ học vấn
IsUnionMember	bool	Không	Có phải đoàn viên không?
IsPartyMember	bool	Không	Có phải đảng viên không?
InsuranceNo	string	Không	Số bảo hiểm xã hội
EmployeeGroupName	string	Không	Nhóm cán bộ
EmployeeTypeName	string	Không	Loại cán bộ
ContractTypeName	string	Không	Loại hợp đồng
SubjectCode	string	Không	Mã môn giảng dạy. [Xem mô tả]
ExtendInfo	Dictionary<string, string>	Không	Danh sách thông tin mở rộng. Xem mô tả

• 4.1.3 Request body:

Dữ liệu sẽ được gửi hình thức json: application/json

Example request:

Request body

  {
    "reportingRoundId": 8,
    "schoolCode": "TH01",
    "employeeItems": [
      {
        "FirstName": "Nguyen Van",
        "LastName": "A",
        "DoB": "1990-01-01T00:00:00",
        "GenderName": "Nam",
        "IdentityNo": "012345678",
        "IdentityIssuedBy": "Công an TP Hà Nội",
        "IdentityIssuedDate": "2010-05-20T00:00:00",
        "Email": "nguyenvana@example.com",
        "Phone": "0901234567",
        "EthnicName": "Kinh",
        "ReligionName": "Không",
        "ProvinceName": "Hà Nội",
        "DistrictName": "Quận Ba Đình",
        "WardName": "Phường Điện Biên",
        "Address": "123 Đường ABC, Quận Ba Đình",
        "Hometown": "Hà Nội",
        "MajorName": "Sư phạm Toán",
        "UniversityName": "ĐH Sư phạm Hà Nội",
        "EducationLevelName": "Đại học",
        "StatusName": "Đang công tác",
        "IsUnionMember": true,
        "IsPartyMember": false,
        "InsuranceNo": "0123456789",
        "EmployeeGroupName": "Giáo viên",
        "EmployeeTypeName": "Biên chế",
        "ContractTypeName": "Hợp đồng không xác định thời hạn",
        "SubjectName": "Toán",
        "ExtendInfo": {
          "IS_LEVEL_2_VNEID": "true"
        }
      }
    ]
  }

• 4.1.3 Response:

Response

  {
      "success": true,
      "message": "Đã tải lên 1 bản ghi",
      "data": true,
      "showMessage": true,
      "statusCode": 200,
      "errors": null,
      "meta": null
  }