STT

Tham số

Thuộc tính tham số

Mô tả

1

MaThuTuc

String

Mã thủ tục hành chính trong hệ thống Cơ sở dữ liệu về Thủ tục hành chính của thành phố

2

TenThuTuc

String

Tên loại thủ tục.

3

MaLinhVuc

String

Mã lĩnh vực trong hệ thống Cơ sở dữ liệu về Thủ tục hành chính của thành phố

4

TenLinhVuc

String

Tên loại lĩnh vực

5

MaHoSo

String

Lấy hoặc thiết lập Mã hồ sơ đã được đơn vị thụ lý đồng ý tiếp nhận.

6

MaNguoiDaiDien

String

Số định danh của người đại diện

7

TenNguoiDaiDien

String

Tên người đại diện đăng ký hồ sơ một cửa.

8

NgaySinh

String

Ngày sinh người đại diện
Kiểu Date: dd/MM/yyyy
Ví dụ: 22/12/1980

9

GioiTinh

Int

Giới tính người đại diện

10

SoCMND

String

Chứng minh nhân dân hoặc hộ chiếu người đại diện

11

NgayCapCMND

String

Ngày cấp CMND
Kiểu Date: dd/MM/yyyy
Ví dụ: 15/10/2000

12

DiaChiTamTru

String

Địa chỉ tạm trú

13

DiaChiThuongTru

String

Địa chỉ thường trú

14

ChucDanh

String

Chức danh

15

TenCoQuan

String

Tên cơ quan

16

MaSoThue

String

Mã số thuế

17

DienThoai

String

Điện thoại

18

Email

String

Email

19

Website

String

Website

20

Fax

String

Fax

21

ThongTinKhac

String

Thông tin khác.

22

MaDoiTuong

String

Mã đối tượng nộp hồ sơ.

23

LoaiDoiTuong

Int

Kiểu đối tượng nộp hồ sơ:

- 1: Người dân;

- 2: Doanh nghiệp;

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

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

24

DiaChi

JSON Object

JSON địa chỉ tại mục 3.9

25

TrichYeuHoSo

String

Trích yếu hồ sơ một cửa.

26

MaNguoiTiepNhanHoSo

String

Mã người tiếp nhận hồ sơ

27

TenNguoiTiepNhanHoSo

String

Tên người tiếp nhận hồ sơ

28

NgayTiepNhan

String

Ngày tiếp nhận hồ sơ
Kiểu Date: dd/MM/yyyy hh:mm:ss
Ví dụ: 16/09/2016 15:30:16

29

NgayHenTra

String

Ngày hẹn trả hồ sơ
Kiểu Date: dd/MM/yyyy hh:mm:ss
Ví dụ: 16/09/2016 15:30:16

30

HanXuLy

String

Hạn xử lý của trạng thái hiện tại
Kiểu Date: dd/MM/yyyy hh:mm:ss
Ví dụ: 16/09/2016 15:30:16

31

TrangThaiDuyet

Boolean

Trạng thái xử lý cuối cùng của hồ sơ.

- True: Đã duyệt;

- False: Không duyệt;

- Null: Chưa duyệt kết quả.

32

NgayDuyet

Kiểu date

Ngày duyệt hồ sơ
Kiểu Date: dd/MM/yyyy hh:mm:ss
Ví dụ: 16/09/2016 15:30:16

NgayDuyet = NULL khi TrangThaiDuyet = NULL

33

NguoiDuyet

String

Người duyệt hồ sơ.

34

ChucVuDuyet

String

Chức vụ của người duyệt hồ sơ.

35

ThongTinDuyet

String

Thông tin Duyệt hồ sơ

Ví dụ: lý do không duyệt.

36

TrangThaiTra

Boolean

Tập trạng thái đã trả kết quả hồ sơ:

- True: Đã trả kết quả;

- False: Chưa trả kết quả;

- Null: Không trả kết quả.

37

NgayTra

Kiểu date

Ngày trả kết quả hồ sơ cho công dân, tổ chức.
Kiểu Date: dd/MM/yyyy hh:mm:ss
Ví dụ: 16/09/2016 15:30:16

NgayTra = NULL khi TrangThaiTra = NULL

38

ThongTinTra

String

Thông tin trả kết quả

Ví dụ: Ông bà Nguyễn Văn A đã nhận kết quả hồ sơ (0987987894).

39

HinhThucTra

Int

Hình thức trả kết quả:

0 - Trả kết quả tại bộ phận tiếp nhận và trả kết quả;

1 - Trả kết quả qua đường bưu điện.

40

NgayKetThucXuLy

Kiểu date

Ngày kết thúc xử lý hồ sơ.
Kiểu Date: dd/MM/yyyy hh:mm:ss
Ví dụ: 16/09/2016 15:30:16

41

TrangThaiXuLy

Int

Trạng thái xử lý hồ sơ một cửa:

- 0: Hồ sơ đã được tiếp nhận:

- 1: Hồ sơ đang xử lý;

- 2: Hồ sơ đã có kết quả.

42

DonViXuLy

String

Tên đơn vị thụ lý hồ sơ một cửa.

43

BoSung

Boolean

Trạng thái hồ sơ đang có yêu cầu bổ sung hay không:

- True: Có yêu cầu bổ sung;

- False: Không có yêu cầu bổ sung.

44

NgayBoSung

Kiểu date

Lấy hoặc thiết lập ngày yêu cầu bổ sung.

45

GhiChu

String

Ghi chú thông tin khác.

46

SoLuongDinhKem

Int

Số lượng tệp đính kèm

47

TepDinhKems

JSON Array

Json danh sách tệp đính kèm tại mục 3.4

48

LePhis

JSON Array

Json danh sách lệ phí tại mục 3.5

49

GiayToThuKems

JSON Array

Json danh sách giấy tờ thu kèm theo hồ sơ một cửa tại mục 3.6

50

HoSoBoSungs

JSON Array

Danh sách các yêu cầu bổ sung hồ sơ.

51

PhiDichVu

String

Phí dịch vụ công

52

NgayYeuCauThanhToan

String

Ngày thanh toán thành công
Kiểu Date: dd/MM/yyyy hh:mm:ss
Ví dụ: 16/09/2016 15:30:16

53

NgayThanhToan

String

Ngày yêu cầu thanh toán
Kiểu Date: dd/MM/yyyy hh:mm:ss
Ví dụ: 16/09/2016 15:30:16

54

MaGiaoDich

String

Mã giao dịch

55

SoTaiKhoan

String

Số tài khoản

56

ThongTinChuyenPhat

JSON

JSON Thông tin chuyển phát bưu điện tại mục 3.8

57

ThongTinTacNghiep

JSON

JSON chứa dữ liệu tác nghiệp
Cấu trúc và dữ liệu được quy định bởi các đơn vị tham gia trao đổi gói tin với nhau

58

MaTrangThai

String

Mã trạng thái xử lý của hồ sơ
Ví dụ: VERIFIED
Tham khảo Bảng 1

59

Ticket

String

Mã định danh của hồ sơ nộp qua mạng. Dùng để xác định hồ sơ qua mạng khi trao đổi thông tin giữa các phần mềm với nhau.

Hồ sơ phát sinh từ phần mềm nào thì phần mềm đó sinh một mã định danh  duy nhất trong phần mềm đó để trao đổi qua mạng.

Phần mềm nên đặt ticket theo cấu trúc sau:[Mã đơn vị] [Năm nhận hồ sơ][Mã lĩnh vực][Mã thủ tục][Số thứ tự hồ sơ]

60

MaDonViC1

String

- Mã cấp I của cơ quan, tổ chức là đầu mối (Bộ, tỉnh...) kết nối với Cổng DVCQG

- Đối với các Bộ, tỉnh: sử dụng mã cấp 1 theo QCVN 102:2016/BTTTT.

61

TenDonViC1

String

Tên cơ quan, tổ chức là đầu mối kết nối với Cổng DVCQG (Bộ, tỉnh).

62

MaDonViC2

String

- Mã cấp II của cơ quan, tổ chức là các sở, ngành, quận, huyện của TpHCM

63

TenDonViC2

String

Tên cơ quan, tổ chức là các sở, ngành, quận, huyện của TpHCM.

64

MaDonViC3

String

- Mã cấp III của cơ quan, tổ chức là các UBND phường, xã của TpHCM

65

TenDonViC3

String

Tên cơ quan, tổ chức là các UBND phường xã của TpHCM.

66

Version

String

Phiên bản của chuẩn gói tin

{

"BoSung": false,

                       "ChucDanh": "Nhân viên lập trình",

                       "ChucVuDuyet": "",

                       "DiaChi": {…},

            "DiaChiTamTru": "",

                       "DiaChiThuongTru": "47/80/10 Trường Lưu Phường Long Trường Quận 9 TP.HCM",

                       "DienThoai": "0359093780",

                       "DonViXuLy": "38.98.H29",

                       "Email": "",

                       "Fax": "",

                       "GhiChu": "",

                       "GiayToThuKems": [{…}],

                       "GioiTinh": 0,

                       "HanXuLy": "16/09/2016 8:30:15",

                       "HinhThucTra": 0,

                       "HoSoBoSungs": null,

                       "LePhis": [{…}],

                       "LoaiDoiTuong": 1,

                       "MaDoiTuong": "00001",

                       "MaDonViC1": "38.98.H29",

                       "MaDonViC2": "",

                       "MaDonViC3": "",

                       "MaGiaoDich": "",

                       "MaHoSo": "SBN-0010",

                       "MaLinhVuc": "046",

                       "MaNguoiDaiDien": "NĐD-0001",

                       "MaNguoiTiepNhanHoSo": "NTN-0001",

                       "MaSoThue": "000000000",

                       "MaThuTuc": "046002",

                       "MaTrangThai": "SUBMITED",

                       "NgayBoSung": "",

                       "NgayCapCMND": "2009",

                       "NgayDuyet": "",

                       "NgayHenTra": "30/4/2019 22:08:32",

                       "NgayKetThucXuLy": "",

                       "NgaySinh": "1994",

                       "NgayThanhToan": "",

                       "NgayTiepNhan": "16/4/2019 22:08:32",

                       "NgayTra": "",

                       "NgayYeuCauThanhToan": "",

                       "NguoiDuyet": "",

                       "PhiDichVu": "0",

                       "SoCMND": "025127579",

                       "SoLuongDinhKem": 1,

                       "SoTaiKhoan": "",

                       "TenCoQuan": "FPT IS",

                       "TenDonViC1": "Sở Du Lịch",

                       "TenDonViC2": "",

                       "TenDonViC3": "",

                       "TenLinhVuc": "Lữ hành",

                       "TenNguoiDaiDien": "Người đại diện test",

                       "TenNguoiTiepNhanHoSo": "Người tiếp nhận 1",

                       "TenThuTuc": "Thủ tục cấp thẻ hướng dẫn viên du lịch quốc tế",

                       "TepDinhKems": [{…}],

                       "ThongTinChuyenPhat": {…},

                       "ThongTinDuyet": "",

                       "ThongTinKhac": "",

                       "ThongTinTacNghiep": null,

                       "ThongTinTra": "",

                       "Ticket": "38.98.H292019046046002010",

                       "TrangThaiDuyet": false,

                       "TrangThaiTra": false,

                       "TrangThaiXuLy": 1,

                       "TrichYeuHoSo": "",

                       "Version": "v1.0",

                       "Website": ""

 }

STT

Tên trường

Định Dạng

Mô tả

Yêu cầu

1

TenTepDinhKem

String

Tên file đính kèm.

Bắt buộc

2

MaHoSoKemTheo

String

Mã hồ sơ kèm theo

Không bắt buộc

3

MaHoSo

String

Mã hồ sơ

Bắt buộc

4

Base64

String

Lưu giá trị file đính kèm được mã hóa.

Bắt buộc

5

XacThuc

Boolean

Các tệp (thành phần hồ sơ) đính kèm gắn liền với hồ sơ của người sử dụng đã được xác thực.

Bắt buộc

6

MoTa

String

Mô tả tệp đính kèm

Không bắt buộc

{

  "TenTepDinhKem": "DonDangKy.doc",

  "DinhDang": "application/msword",

  "MoTa": "",

  "MaHoSo":"SBN-0010",

  "XacThuc":false,

  "MaHoSoKemTheo":"SBN-0010-hskt001",

  "MoTa":"Hồ sơ đính kèm đơn đăng ký",

  "Base64":"0M8R4KGxGuEAAAAAAAAAAAAAAAAAAAAAPgADAP7…",

}

STT

Tên trường

Định Dạng

Mô tả

Yêu cầu

1

TenLePhi

String

Tên Lệ phí.

Bắt buộc

2

Gia

Decimal

Số tiền thu.

Bắt buộc

3

LoaiLePhi

Int

Loại Lệ phí thu:

- 1: Lệ phí thu khi tiếp nhận hồ sơ;

- 2: Lệ phí thu khi bổ sung hồ sơ;

- 4: Lệ phí thu khi trả kết quả.

Bắt buộc

{

                    "Gia": 1000000,

                    "LoaiLePhi": 1,

                    "TenLePhi": "Lệ phí hồ sơ"

 }

STT

Tên trường

Định Dạng

Mô tả

Yêu cầu

1

TenGiayTo

String

Tên giấy tờ.

Bắt buộc

2

SoLuong

Int

Số lượng.

Bắt buộc

3

LoaiGiayTo

Int

Loại giấy tờ thu:

- 1: Giấy tờ thu khi tiếp nhận hồ sơ;

- 2: Giấy tờ thu khi bổ sung hồ sơ;

- 4: Giấy tờ thu khi trả kết quả.

Bắt buộc

{

                    "SoLuong": 1,

                    "LoaiGiayTo": 1,

                    "TenGiayTo": "Bản sao CMND"

 }

STT

Tên trường

Định Dạng

Mô tả

Yêu cầu

1

HoSoBoSungID

Int

Id của Yêu cầu bổ sung trong hệ thống Cơ quan thụ lý.

Bắt buộc

2

NguoiYeuCauBoSung

String

Người gửi yêu cầu bổ sung.

Bắt buộc

3

NoiDungBoSung

String

Nội dung yêu cầu bổ sung.

Bắt buộc

4

NguoiYeuCauBoSung

String

Ngày gửi yêu cầu bổ sung.
Kiểu Date: dd/MM/yyyy hh:mm:ss
Ví dụ: 16/09/2016 15:30:16

Bắt buộc

5

NgayTiepNhanBoSung

String

Người tiếp nhận Bổ sung hồ sơ từ công dân.

Không bắt buộc

6

ThongTinTiepNhan

String

Thông tin tiếp nhận. Ví dụ: Ông Nguyễn Văn A đã bổ sung đầy đủ ...

Không bắt buộc

7

NguoiTiepNhanBoSung

String

Ngày tiếp nhận bổ sung hồ sơ.
Kiểu Date: dd/MM/yyyy hh:mm:ss
Ví dụ: 16/09/2016 15:30:16

Bắt buộc

8

TrangThaiBoSung

Boolean

Trạng thái bổ sung hồ sơ:

- True: Công dân đã bổ sung đầy đủ thủ tục hồ sơ;

- False: Công dân không bổ sung hồ sơ (quá hạn bổ sung);

- Null: Công dân chưa tới bổ sung hồ sơ (còn hạn).

Bắt buộc

9

LePhiBoSungs

JSON Array

Json danh sách lệ phí tại mục 3.5

Không bắt buộc

10

GiayToBoSungs

JSON Array

Json danh sách giấy tờ thu kèm theo hồ sơ một cửa tại mục 3.6

Không bắt buộc

11

NgayHenTraTruoc

String

Ngày hẹn trả trước khi bổ sung.
Kiểu Date: dd/MM/yyyy hh:mm:ss
Ví dụ: 16/09/2016 15:30:16

Bắt buộc

12

NgayHenTraMoi

String

Ngày hẹn trả mới sau khi bổ sung hồ sơ.
Kiểu Date: dd/MM/yyyy hh:mm:ss
Ví dụ: 16/09/2016 15:30:16

Không bắt buộc

{

                    "HoSoBoSungID ": 100,

                    "NguoiYeuCauBoSung": "Nguyễn Văn A",

                    "NoiDungBoSung": "Bổ sung bản sao CMND",

                    "NgayBoSung": "16/09/2016 15:30:16",

                    "NguoiTiepNhanBoSung": "Nguyễn Văn A",

                    "ThongTinTiepNhan": "Ông Nguyễn Văn A  đã bổ sung hồ sơ đầy đủ",

                    "NgayTiepNhanBoSung": "16/09/2016 15:30:16",

                    "TrangThaiBoSung": true

                    "NgayHenTraTruoc": "16/09/2016 15:30:16",

                    "NgayHenTraMoi": "16/09/2016 15:30:16",

         "LePhiBoSungs": [{…}],     

         "GiayToBoSungs": [{…}],

 }

STT

Tên trường

Định Dạng

Mô tả

Yêu cầu

1

MaDonVi

String

ID của cơ quan, tổ chức

Bắt buộc

2

LoaiDichVu

String

Tên Loại DV: (a) nhận HS tại nhà chuyển cho CQ HCC hay (b) trả KQ của CQ HCC cho người dân. (c) Nhận HS Tại nhà - chuyển trả KQ

Bắt buộc

4

NguoiLH

String

Người liên hệ để nhân viên bưu điện liên hệ nhận hồ sơ đi nộp giúp

Bắt buộc

5

DienThoaiLH

String

Số điện thoại để nhân viên bưu điện liên hệ nhận hồ sơ đi nộp giúp

Bắt buộc

6

DiaChiLH

JSON Object

JSON địa chỉ tại mục 3.9
Địa chỉ để nhân viên bưu điện đến liên hệ nhận hồ sơ đi nộp giúp

Bắt buộc

7

GhiChu

String

Ghi chú, Ghi nội dung hàng cần gửi, mô tả các yêu cầu nhận gửi, nhận

Không bắt buộc

8

NguoiNhans

JSONArray

Json danh sách người nhận tại mục 3.10
Độ ưu tiên theo số được chỉ định ưu tiên từ nhỏ đến lớn (Mặc định là số 1 người nhận chính)

Bắt buộc

{

  "MaDonVi": "ĐVCP0001",

  "LoaiDichVu": "Nhận HS Tại nhà - chuyển trả KQ",

  "NguoiLH": "Nguyễn Nghiêm Thuận",

  "DienThoaiLH": "00000000",

  "DiaChiLH": {..},

  "GhiChu": "",

  "NguoiNhans": [{…}]

}

STT

Tên trường

Định Dạng

Mô tả

Yêu cầu

1

MaThanhPho

String

Mã thành phố

Bắt buộc

2

TenThanhPho

String

Tên thành phố

3

MaQuanHuyen

String

Mã quận huyện

Bắt buộc

4

TenQuanHuyen

String

Tên quận huyện

5

MaPhuongXa

String

Mã phường

Bắt buộc

6

TenPhuongXa

String

Tên phường

7

DiaChi

String

Số nhà và tên đường

Bắt buộc

8

TenDuong

String

Tên đường

Không bắt buộc

9

KhuPho

String

Khu phố

Không bắt buộc

10

SoNha

String

Số nhà

Không bắt buộc

11

Tang

String

Tầng

Không bắt buộc

12

Phong

String

Phòng

Không bắt buộc

{

  "MaThanhPho": "",

  "TenThanhPho": "",

  "MaQuanHuyen": "",

  "TenQuanHuyen": "",

  "MaPhuongXa": "",

  "TenPhuongXa": "",

  "DiaChi": "",

  "TenDuong": "",

  "KhuPho": "",

  "SoNha": "",

  "Tang": "",

  "Phong": ""

}

STT

Tên trường

Định Dạng

Mô tả

Yêu cầu

1

ChiDinh

Int

Độ ưu tiên theo số được chỉ định ưu tiên từ nhỏ đến lớn (Mặc định là số 1 người nhận chính)

Bắt buộc

2

NguoiNhan

String

Họ tên người nhận hồ sơ gửi đến

Bắt buộc

3

DiaChiNhan

JSON Object

JSON địa chỉ tại mục 3.12
Địa chỉ được hồ sơ gửi đến

Bắt buộc

4

DienThoaiNhan

String

Số điện thoại người nhận được hồ sơ gửi đến

Không bắt buộc

5

EmailNhan

String

Email người nhận được hồ sơ gửi đến

Không bắt buộc

{

  "ChiDinh": 0,

  "NguoiNhan": "Nguyễn Văn A",

  "DiaChiNhan": {…}

  "DienThoaiNhan": "0359093780",

  "EmailNhan": ""

}