Giải pháp thực hiện

I. TỔNG QUAN

1.  Mô tả nghiệp vụ

  • CSDL Dùng chung là nơi tập trung toàn bộ kho dữ liệu dùng chung của TPHCM. Cơ quan, tổ chức có thể thực hiện việc khai thác và đồng bộ dữ liệu về CSDL Dùng chung của Thành phố thông qua Nền tảng HCM LGSP.
  • Nền tảng HCM LGSP đảm nhiệm vai trò chính trong việc cung cấp các thông tin kết nối đến các phần mềm tại đơn vị, khai thác và đồng bộ dữ liệu từ CSDL tập trung của thành phố.
  • APIDongBoHoSoDVC hỗ trợ cổng dịch vụ công HCM kết nối vào trục LGSP Đồng bộ dữ liệu hồ sơ tại đơn vị về CSDL dùng chung của Thành phố.

2. Mục đích tài liệu

  • Tài liệu này nhằm hướng dẫn đơn vị đồng bộ dữ liệu hồ sơ về CSDL dùng chung của Thành phố.

3. Phạm vi và đối tượng áp dụng

  • Tài liệu này được sử dụng bởi các kỹ thuật viên của các đơn vị đồng bộ dữ liệu hồ sơ về CSDL dùng chung của Thành phố

II. MÔ HÌNH KẾT NỐI

1. Mô hình kết nối đồng bộ hồ sơ dịch vụ công

 

Hình 1: Mô hình kết nối đồng bộ hồ sơ DVC

  • CSDL Dùng chung là nơi tập trung toàn bộ kho dữ liệu dùng chung của TPHCM. Cơ quan, tổ chức có thể thực hiện việc khai thác và đồng bộ dữ liệu về CSDL Dùng chung của Thành phố thông qua Nền tảng HCM LGSP.
  • Nền tảng HCM LGSP đảm nhiệm vai trò chính trong việc cung cấp các thông tin kết nối đến các phần mềm tại đơn vị, khai thác và đồng bộ dữ liệu từ CSDL tập trung của thành phố.
  • APIDongBoHoSoDVC hỗ trợ cổng dịch vụ công HCM kết nối vào trục LGSP Đồng bộ dữ liệu hồ sơ tại đơn vị về CSDL dùng chung của Thành phố.

2. Quá trình trao đổi gói tin

Hình 2: Quy trình trao đổi gói tin

  • Bước 1: Phần mềm của đơn vị gọi đến Nền tảng HCM LGSP thông qua api kèm theo access token.
  • Bước 2: Nền tảng HCM LGSP kiểm tra access token của đơn vị. Nếu thất bại sẽ trả về gói tin JSON lỗi cho phần mềm của đơn vị.
  • Bước 3: Nền tảng HCM LGSP xử lý dữ liệu và trả về gói tin JSON kết quả cho phần mềm đơn vị.

III. ĐẶC TẢ API ĐỒNG BỘ HỒ SƠ DỊCH VỤ CÔNG

1. Thông tin kết nối

  • Đơn vị đang trong giai đoạn thử nghiệm sẽ dùng hệ thống test theo địa chỉ apdapter Nền tảng HCM thử nghiệm
  • Đơn vị khi có thông báo vận hành chính thức sẽ dùng hệ thống chính theo địa chỉ apdapter Nền tảng HCM chính

Kiểu

Diễn giải

Ví dụ

Địa chỉ adapter Nền tảng HCM chính

Địa chỉ cổng dịch vụ dự kiến chính thức

https://hcmesb.tphcm.gov.vn

Địa chỉ adapter Nền tảng HCM thử nghiệm

Địa chỉ cổng dịch vụ thử nghiệm

https://hcmesb.tphcm.gov.vn/test

AccessKey

Khóa

rTkhYCBwHM

SecretKey

Khóa bí mật

DWkQgY1YSS

AppName

Đơn vị kết nối

QNI

Authorization/Token

Khai báo trong Header, Là chuỗi gồm 3 tham số dạng json được mã hóa thành StringBase64

eyJhcHAiOiJRTkkiLCJzZWNyZXQiOiJEV2tRZ1kxWVNTIiwia2V5IjoiclRraFlDQndITSJ9

được stringbase64 từ:

{

"AccessKey":"rTkhYCBwHM",

"SecretKey":"DWkQgY1YSS",

"AppName": "TPHCM"

}

Bảng 1: bảng thông tin kết nối

  •  

2. API Đồng bộ hồ sơ Dịch vụ công

  • Đường dẫn: /DongBoHoSoDVC
  • Method: POST
  • Đầu vào:
    • Header: Authorization
    • Body: chuỗi json chứa thông tin truyền vào tại mục 3.3
  • Đầu ra:
    • chuỗi json chứa thông tin trả về, resultObject là true hoặc false

STT

Tham số

Thuộc tính tham số

Mô tả

1

StatusCode    

Int

Mã trạng thái gói tin

- 200: Request đã được tiếp nhận và xử lý thành công

- 400: Request bị lỗi hoặc không thể xử lý

- 404: Tài nguyên không tồn tại

- 500: Lỗi trong quá trình xử lý

2

Description

String

Nội dung lỗi trả về

3

ResultObject

JSON

Chuỗi json trả về

4

ResultType

String

Type của gói tin trả về Mặc định là “JSON”

5

Status

String

Trạng thái gói tin“SUCCESS” hoặc “FAIL”

6

ThrowException

bool

 Có lỗi xảy ra hay không

Bảng 2: tham số trả về của chuỗi json

Ví dụ:

 

Thành công

Lỗi

{

    "StatusCode": 200,

    "Description": null,

    "ResultObject": true,

    "ResultType": "JSON",

    "Status": "SUCCESS",

    "ThrowException": false

}

{

    "StatusCode": 500,

    "Description": "Tham số đầu vào không đúng",

    "ResultObject": null,

    "ResultType": null,

    "Status": "FAIL",

    "ThrowException": true

}          

 

  1.  

3. Gói thông tin hồ sơ

STT

Tên trường

Định dạng

Mô tả

Yêu cầu

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ố

Bắt buộc

2

TenThuTuc

String

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

Bắt buộ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ố

Bắt buộc

4

TenLinhVuc

String

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

Bắt buộ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.

Không bắt buộc

6

MaNguoiDaiDien

String

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

Bắt buộc

7

TenNguoiDaiDien

String

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

Bắt buộc

8

NgaySinh

String

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

Không bắt buộc

9

GioiTinh

Int

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

- 0 chưa có thông tin;

- 1 giới tính nam;

- 2 giới tính nữ.

Không bắt buộc

10

SoCMND

String

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

Không bắt buộc

11

NgayCapCMND

String

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

Không bắt buộc

12

DiaChiTamTru

String

Địa chỉ tạm trú

Không bắt buộc

13

DiaChiThuongTru

String

Địa chỉ thường trú

Không bắt buộc

14

ChucDanh

String

Chức danh

Không bắt buộc

15

TenCoQuan

String

Tên cơ quan

Bắt buộc đối với doanh nghiệp

16

MaSoThue

String

Mã số thuế

Không bắt buộc

17

DienThoai

String

Điện thoại

Bắt buộc

18

Email

String

Email

Không bắt buộc

19

Website

String

Website

Không bắt buộc

20

Fax

String

Fax

Không bắt buộc

21

ThongTinKhac

String

Thông tin khác.

Không bắt buộc

22

MaDoiTuong

String

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

Bắt buộc

23

LoaiDoiTuong

Int

Kiu đố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.

Bắt buộc

24

DiaChi

JSON Object

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

Không bắt buộc

25

TrichYeuHoSo

String

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

Không bắt buộc

26

MaNguoiTiepNhanHoSo

String

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

Không bắt buộc

27

TenNguoiTiepNhanHoSo

String

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

Không bắt buộc

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

Bắt buộc

29

NgayHenTra

String

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

Không bắt buộc

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

Không bắt buộc

31

TrangThaiDuyet

Boolean

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

- True: Đã duyệt;

- False: Không duyệt;

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

Không bắt buộc

32

NgayDuyet

Kiu 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

Bắt buộc khi TrangThaiDuyet khác Null

33

NguoiDuyet

String

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

Không bắt buộc

34

ChucVuDuyet

String

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

Không bắt buộc

35

ThongTinDuyet

String

Thông tin Duyệt hồ sơ

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

Không bắt buộc

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ả.

Không bắt buộc

37

NgayTra

Kiu 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

Bắt buộc khi TrangThaiTra khác 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).

Không bắt buộc

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.

Bắt buộc

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

Không bắt buộc

41

TrangThaiXuLy

Int

Trạng thái xlý hồ sơ một ca:

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

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

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

Bắt buộc

42

DonViXuLy

String

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

Bắt buộc

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.

Không bắt buộc

44

NgayBoSung

Kiu date

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

Không bắt buộc

45

GhiChu

String

Ghi chú thông tin khác.

Không bắt buộc

46

SoLuongDinhKem

Int

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

Bt buộc.

47

LePhis

JSON Array

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

Không bắt buộc

48

GiayToThuKems

JSON Array

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

Không bắt buộc

49

HoSoBoSungs

JSON Array

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

Không bắt buộc

50

PhiDichVu

String

Phí dịch vụ công

Bắt buộc khi trạng thái là:

PAYMENT_REQUEST

51

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

Bắt buộc khi trạng thái là: PAYMENT_REQUEST

52

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

Bắt buộc khi trạng thái là: PAID

53

MaGiaoDich

String

Mã giao dịch

Bắt buộc khi trạng thái là: PAID

54

SoTaiKhoan

String

Số tài khoản

Bắt buộc khi trạng thái là: PAID

55

ThongTinChuyenPhat

JSON

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

Không bắt buộc

56

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

Không bắt buộc

57

MaTrangThai

String

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

Bắt buộc

58

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ơ]

Bắt buộc

59

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 Cng DVCQG

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

- Đầu mối hiện tại là trục LGSB do Sở Thông tin và truyền thông HCM quản lý

Bắt buộc

MaDonViC1 = "000.00.15.H29"

60

TenDonViC1

String

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

- Đầu mối hiện tại là trục LGSB do Sở Thông tin và truyền thông HCM quản lý

Bắt buộc

TenDonViC1= "Sở Thông tin và Truyền thông"

61

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

 

Bắt buộc

62

TenDonViC2

String

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

Bắt buộc

63

MaDonViC3

String

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

Bắt buộc

64

TenDonViC3

String

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

Bắt buộc

65

Version

String

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

Bắt buộc

Bảng 4: bảng gói tin hồ sơ

4. Danh sách các bảng mã liên quan tới gói tin hồ sơ

TT

Mã trạng thái

Tên trạng thái

Mô tả

1

CREATED

Vừa tiếp nhận trực tuyến

Vừa tiếp nhận trực tuyến.

2

VERIFIED

Đã tiếp nhận hồ sơ

Vừa tiếp nhận hồ sơ tại đơn vị.

  • Cổng DVC khóa chức năng hiệu chỉnh hồ sơ trên Cổng .

ISO tại đơn vị tiếp nhận hồ sơ nếu cùng “ticket” chỉ tiếp nhận hồ sơ có thời gian gửi lên trục gần nhất.

  • Cổng DVC chuyển gói tin hồ sơ cho Bưu điện nếu người dân có đăng ký dịch vụ: “Nộp hồ sơ tại nhà” hoặc “Nộp và nhận kết quả hồ sơ tại nhà” khi nộp hồ sơ trực tuyến.
  • Bưu điện nhận gói tin hồ sơ, tiến hành thu gom hồ sơ của người dân và chuyển cho đơn vị thụ lý.

3

SUBMITED

Đang xử lý

Đang xử lý, đang chờ duyệt, ... Bao gồm tất cả các trạng thái trong quá trình xử lý trừ: Đã tiếp nhận, chờ bổ sung, hoàn thành, không giải quyết, hủy hồ sơ (xóa, hoặc chủ hồ sơ lên rút lại).

4

REJECTED

Từ chối tiếp nhận hồ sơ

Từ chối tiếp nhận hồ sơ.

  • Cổng DVC mở chức năng hiệu chỉnh hồ sơ trên Cổng DVC để người dân có thể hiệu chỉnh/bổ sung hồ sơ. Sau đó tạo gói tin hồ sơ gửi đến ISO đơn vị (vẫn giữ “ticket” cũ để ISO tại đơn vị cập nhật thông tin hồ sơ).

5

COMPLETED

Hoàn thành hồ sơ

Hoàn thành (cấp phép).

  • Cổng DVC chuyển gói tin trạng thái Hoàn thành cho Bưu điện nếu người dân có đăng ký dịch vụ: “Nhận kết quả hồ sơ tại nhà” hoặc “Nộp và nhận kết quả hồ sơ tại nhà” khi nộp hồ sơ trực tuyến.
  • Bưu điện nhận gói tin trạng thái, tiến hành nhận kết quả hồ sơ tại đơn vị và chuyển cho cho người dân.

7

PUBLISHED

Đã trả kết quả cho công dân

Đã trả hồ sơ cho dân.

8

NEED_INPUT_DATA

Cần bổ sung hồ sơ

Chờ bổ sung hồ sơ.

Cổng DVC mở chức năng hiệu chỉnh hồ sơ trên Cổng DVC để người dân có thể hiệu chỉnh/bổ sung hồ sơ. Sau đó tạo gói tin hồ sơ gửi đến ISO đơn vị (vẫn giữ “ticket” cũ để ISO tại đơn vị cập nhật thông tin hồ sơ).

9

COMPLETED_INPUT_DATA

Đã bổ sung hồ sơ

Hồ sơ đã được nhận bổ sung.

10

ERROR

Lỗi xử lý gói tin

Phần mềm ISO nhận gói tin về bị lỗi do cấu trúc gói tin không đúng thì gửi trạng thái này lại cho DVC để phục vụ hiệu chỉnh phần mềm.

11

CANCEL

Hủy hồ sơ

Sử dụng trong trường hợp xóa, hoặc chủ hồ sơ lên rút lại.

12

PAYMENT_REQUEST

Yêu cầu thanh toán

Phần mềm ISO gửi yêu cầu thanh toán cho DVC

13

PAID

Đã thanh toán

DVC cập nhật trạng thái đã thanh toán cho phần mềm ISO

Bảng 4: bảng mã liên quan tới gói tin

5. Gói tin lệ phí

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

Bảng 5: bảng gói tin lệ phí

6. Gói tin giấy tờ thu kèm

STT

Tên trường

Định dạng

Mô tả

Yêu cầu

1

TenGiayTo

String

Tên giấy tờ.

Bắt buc

2

SoLuong

Int

Slượng.

Bắt buộc

3

LoaiGiayTo

Int

Loại giy 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 trkết qu.

Bắt buộc

Bảng 6: bảng gói tin giấy tờ thu kèm

7. Gói tin hồ sơ bổ sung

STT

Tên trường

Định dạng

Mô tả

Yêu cầu

1

ID

String

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

Bt buc

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

NgayYeuCauBoSung

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

NguoiTiepNhanBoSung

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

NgayTiepNhanBoSung

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 nếu TrangThaiBoSung = true

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 5.4

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 5.5

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

13

SoLuongDinhKem

Int

Số lượng file đính kèm bổ sung

Không bắt buộc

Bảng 7: bảng gói tin bổ sung

8. Gói tin thông tin chuyển phát

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

Loại DV:

"1": Trả kết quả tại nhà

"2": Thu gom hồ sơ tại nhà

"3": Thu gom và trả kết quả tại nhà

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 hoặc trả hồ sơ

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 hoặc trả hồ sơ

Không bắt buộc

6

DiaChiLH

JSON Object

JSON địa chỉ tại mục 5.8
Địa chỉ để nhân viên bưu điện đến liên hệ nhận hoặc trả hồ sơ

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

JSON Array

Json danh sách người nhận tại mục 5.9
Độ ư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

9

MaDonViChuyenPhat

String

Mã đơn vị chuyển phát:
-VNPOST

-VIETTELPOST

Bắt buộc

10

SoHieu

String

Số hiệu bưu điện của hồ sơ

(Trường hợp đơn vị ISO điện tử chưa chưa có số hiệu bưu đơn vị chuyển phát sẽ phát sinh số hiệu này và gửi lại cho trục LGSP. Trục LGSB gửi lại cho đơn vị thông qua gói tin lấy thông tin chuyển phát, trạng thái chuyển phát với mã là POST01)

Không bắt buộc

Bảng 8: bảng gói tin chuyển phát

9. Gói tin địa chỉ

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

Bảng 9: bảng gói tin địa chỉ

10. Gói tin người nhận

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 5.8
Đị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

Bảng 10: bảng gói tin người nhận

Danh sách tệp tin đính kèm

  • DacTaLienThong_APIDongBoHoSoDVC_v1.1.docx