Quyết định 935/QĐ-KBNN năm 2022 quy định về chuẩn kết nối và tích hợp phần mềm ứng dụng của các cơ quan, tổ chức vào hệ thống Dịch vụ công trực tuyến Kho bạc Nhà nước

BỘ TÀI CHÍNH
KHO BẠC NHÀ NƯỚC
-------

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

Số: 935/QĐ-KBNN

Hà Nội, ngày 04 tháng 03 năm 2022

Nơi nhận:
- Như Điều 4;
- Cục TH&TK Tài chính - BTC;
- Cổng thông tin điện tử BTC;
- Cổng thông tin điện tử KBNN;
- Lưu: VT, CNTT (80 bản).

KT. TỔNG GIÁM ĐỐC
PHÓ TỔNG GIÁM ĐỐC




Nguyễn Mạnh Cường

STT

Tên dịch vụ

Mô tả

URL

Method

1

Login

Đăng nhập vào hệ thống DVCTT

/Login

POST

2

Logout

Đăng xuất khỏi hệ thống DVCTT

/Logout

POST

3

CheckDocumentStatus

Kiểm tra trạng thái hồ sơ

/CheckDocumentStatus

POST

4

SendDocument

Giao nhận hồ sơ

/SendDocument

POST

5

Download

Tải xuống giấy báo nợ

/Download

GET

6

Upload

Tải lên tệp đính kèm

/Upload

POST

STT

Tên biến

Kiểu

Bắt buộc

Mặc định

Mô tả

1

UserName

String

Có

Tên đăng nhập

2

Password

String

Có

Mật khẩu

3

BudgetCode

String

Có

Mã quan hệ ngân sách

4

ComputerIP

String

Có

EP Public máy tính khách hàng

5

ComputerName

String

Có

Tên máy tính của khách hàng

6

Description

String

Có

Mô tả

STT

Key

Value

Mô Tả

1

Authorization

Bearer Token trả về khi login

STT

Key

Value

Mô tả

1

Authorization

Bearer Token trả về khi login

2

Salt-Token

Private Token trả về khi login

3

Hashed-Data

Body hash SHA256 với salt được trả về khi login

STT

Kiểu

Bắt buộc

Mặc định

Mô tả

1

Mảng obj

DocumentStatusParam

Có

NONE

Danh sách các Document

STT

Key

Value

Mô tả

1

Authorization

Bearer Token trả về khi login

2

Salt-Token

Private Token trả về khi login

3

Hashed-Data

Body hash SHA256 với salt được trả về khi login

STT

Tên biến

Kiểu

Bắt buộc

Mô tả

Mặc định

1

UserName

String

Có

Tên đăng nhập

2

Password

String

Có

Mật khẩu

3

BudgetCode

String

Có

Mã quan hệ ngân sách

4

HeadOfDepart mentUserName

String

Có

Tên đăng nhập chủ tài khoản

5

ChiefAccounta ntUserName

String

Có

Ten đăng nhập kế toán trưởng

6

HeadOfDepart mentCertlnfor

String

Có

Chữ ký số trên dữ liệu xác thực của chủ tài khoản, chương trình của đơn vị kết nối bóc tách ra từ v_chu_ky_so_ctk chữ ký số trong đối tượng Document

7

ChiefAccounta ntCertlnfo

String

Có

Chữ ký số trên dữ liệu xác thực của kế toán trưởng, chương trình của đơn vị kết nối bóc tách ra từ v_chu_ky_so_ktt chữ ký số trong đối tượng Document

STT

Thông tin

Kiểu dữ liệu

Độ dài tối đa

Bắt buộc

Ghi chú

1

v_ma_ho_so

String

100

Có

Mã hồ sơ gửi lên hệ thống DVC:

XYY_ZZZZZZZ_KBNN99999: Trong đó:

- X là mã định danh loại hồ sơ do KBNN cung cấp theo từng nguồn dữ liệu

- YY là 2 ký tự cuối của năm ngân sách

- ZZZZZZZ là mã đơn vị, dự án

- KBNN là số hiệu kho bạc

- 99999: 5 ký tự cuối là số tăng dần.

2

v_dm_hs_ksc_id

Number

Có

Thông tin ID hồ sơ kiểm soát chi

3

v_ma_dvgd

String

50

Có

Mã đơn vị giao dịch

4

v_ma_dvgd_dvqhns

String

50

Có

Mã ĐVQHNS đơn vị giao dịch

5

v_du_lieu_toan_van

String

100

Có

Dữ liệu xác thực đã chuyển sang chuỗi băm sau khi mã hóa chuẩn MD5 theo quy định của hệ thống DVC

6

v_du_lieu_xac_thuc

String

32000

Có

Dữ liệu hồ sơ theo định dạng XML (Theo cấu trúc được nêu tại mục VIII.1 của quy định này)

7

v_chu_ky_so_ktt

String

32000

Có

Thông tin chữ ký số của Kế toán trưởng có cấu trúc xml theo quy định của hệ thống KBNN-Gateway (Theo cấu trúc được nêu tại mục VIII.2 của quy định này)

8

v_chu_ky_so_ctk

String

32000

Có

Thông tin chữ ký số của Kế toán trưởng có cấu trúc xml theo quy định của hệ thống KBNN- Gateway (Theo cấu trúc được nêu tại mục VIII.2 của quy định này)

9

v_tieu_de

String

150

Có

Thông tin tiêu đề hồ sơ gửi lên DVC

STT

Thông tin

Kiểu dữ liệu

Độ dài tối đa

Ghi chú

1

v_ma_ho_so

String

100

Mã hồ sơ gửi lên hệ thống DVC

2

v_gn_tailieu_id

Number

ID của 16a1: 423

ID của 16a2: 500

3

v_so_chung_tu

String

25

Số chứng từ sinh theo quy định DVC:

XYYMMDD_ZZZZZZZ_KBNN999: Trong đó:

- X là mã định danh chứng từ do KBNN cung cấp cho từng nguồn dữ liệu;

- YYMMDD là định dang ngày của chứng từ;

- ZZZZZZZ là mã đơn vị, dự án;

- KBNN là số hiệu kho bạc;

- 999: 3 ký tự cuối là số tăng dần theo ngày, đảm bảo số chứng từ là duy nhất.

4

v_la_tienmat

Number

5

v_so_thu_tu

Number

6

v_chungtu_tong_so_tien

Number

Tổng số tiền của chứng từ

7

v_chungtu_so_ct_giay

String

50

Số chứng từ giấy trên phần mềm ứng dụng

8

v_chungtu_sotk_so

String

50

Số tài khoản thực hiện giao dịch với KBNN

9

v_chungtu_dm_tiente

String

3

Mã đơn vị tiền tệ chứng từ sử dụng

10

v_ngay_chung_tu

String

10

Ngày chứng từ trên phần mềm ứng dụng (dd/MM/yyyy)

11

v_thucchi_tamung

Number

Là thực chi hay tạm ứng (0 hoặc 1)

12

v_chuyenkhoan_tienmat

Number

Là chuyển khoản hay tiền mặt (0 hoặc 1)

13

v_ut_dktt

Number

Ứng trước điều kiện thanh toán

14

v_hdk

String

50

Hợp đồng khung

15

v_hdth

String

50

Hợp đồng thực hiện

16

v_dvqhns_ma

String

20

Mã đơn vị quan hệ ngân sách

17

v_dvqhns_vt

String

70

Tên viết tắt đơn vị quan hệ ngân sách (<70 ký tự) để đi ngân hàng

18

v_dvqhns_sotk_so

String

50

Số tài khoản đơn vị thực hiện giao dịch

19

v_dvqhns_kbnn_ma

String

20

Mã KBNN thực hiện giao dịch

20

v_dvqhns_capns_ma

String

1

Mã cấp ngân sách của đơn vị

21

V_dvqhns_namns

String

4

Năm ngân sách

22

v_dvqhns_ctmt_ma

String

20

Mã chương trình mục tiêu

23

v_dv_nopthue_ten

String

500

Tên đơn vị nộp thuế

24

v_dv_nopthue_masothue

String

100

Mã số thuế đơn vị nộp thuế

25

v_dv_nopthue_ndkt_ma

String

4

Mã nội dung kinh tế đơn vị nộp thuế

26

v_dv_nopthue_chuong_ma

String

1

Mã chương đơn vị nộp thuế

27

v_dv_nopthue_cqthu_ma

String

7

Mã cơ quan thu đơn vị nộp thuế

28

v_dv_nopthue_kb_hachtoan

String

150

29

v_dv_nopthue_sotiennop

Number

Số tiền nộp thuế

30

v_dv_nhantien_ma

String

20

Mã đơn vị nhận tiền

31

v_dv_nhantien_ten

String

240

Tên đơn vị nhận tiền

32

v_dv_nhantien_diachi

String

240

Địa chỉ đơn vị nhận tiền

33

v_dv_nhantien_sotk_so

String

255

Số tài khoản đơn vị nhận tiền

34

v_dv_nhantien_nganhang_ma

String

8

Mã ngân hàng đơn vị nhận tiền

35

v_dv_nhantien_kbnn_ten

String

255

Tên KBNN đơn vị nhận tiền

36

v_dv_nhantien_ctmt_id

String

5

Mã chương trình mục tiêu của đơn vị nhận tiền

37

v_dv_nhantien_sotiennhan

String

50

Số tiền của đơn vị nhận tiền

38

v_nguoinhan_hoten

String

150

Họ tên người nhận tiền

39

v_nguoinhan_so_cmnd

String

20

Số chứng minh thư nhân dân người nhận

40

v_nguoinhan_ngaycapcmnd

String

10

Ngày cấp chứng minh thư người nhận

41

v_nguoinhan_noicapcmnd

String

150

Nơi cấp chứng minh thư người nhận

42

v_tong_so_tien

Number

Tổng số tiền của chứng từ

43

v_par1

String

240

44

v_par2

String

240

45

v_par3

String

240

46

v_dv_nopthue_kythue

String

200

Thông tin kỳ thuế

47

v_ma_dvgd_dvqhns

String

20

Mã quan hệ ngân sách đơn vị giao dịch

48

v_ma_dvgd

String

7

Mã đơn vị giao dịch

49

v_chu_ky_so_ctk

String

32000

Dữ liệu ký số của chủ tài khoản theo cấu trúc DVC

50

v_chu_ky_so_ktt

String

32000

Dữ liệu ký số của kế toán trưởng theo cấu trúc DVC

51

v_dv_nhantien_loai

Number

Loại cơ quan thanh toán (0: Kho bạc; 1: Ngân hàng)

52

v_tg_ky_so_ktt

date

Thời gian kế toán trưởng ký

53

v_tg_ky_so_ctk

date

Thời gian chủ tài khoản ký

54

v_username_ktt

String

100

Kế toán trưởng

55

v_username_ctk

String

100

Chủ tài khoản

STT

Thông tin

Kiểu dữ liệu

Độ dài tối đa

Ghi chú

1

v_so_chung_tu

String

25

Số chứng từ trên hệ thống DVC

2

v_noi_dung

String

500

Nội dung chi tiết

3

v_dm_ndkt_ma

String

4

Mã nội dung kinh tế

4

v_dm_chuong_ma

String

3

Mã chương

5

v_dm_nganh_kt_ma

String

3

Mã ngành

6

v_so_tien

Number

Số tiền

7

v_dm_nguonchi_ma

String

2

Mã nguồn chi

8

v_dv_nopthue

String

50

Số tiền nộp thuế

9

v_dv_nhantien

String

50

Số tiền nhận

10

v_ma_hang

Number

Số thứ tự dòng chi tiết

STT

Thông tin

Kiểu dữ liệu

Độ dài tối đa

Ghi chú

1

v_ma_ho_so

String

100

Mã Hồ sơ gửi DVC

2

v_gn_tailieu_id

Number

ED tài liệu 16c1 (425), 16c3 (421)

3

v_so_chung_tu

String

25

Số chứng từ sinh theo quy định DVC:

XYYMMDD_ZZZZZZZ_ KBNN999: Trong đó:

- X là mã định danh chứng từ do KBNN cung cấp cho từng nguồn dữ liệu;

- YYMMDD là định dạng ngày của chứng từ;

- ZZZZZZZ là mã đơn vị, dự án;

- KBNN là số hiệu kho bạc;

- 999:3 ký tự cuối là số tăng dần theo ngày, đảm bảo số chứng từ là duy nhất.

4

v_la_tienmat

Number

Có sử dụng tiền mặt hay không

5

v_so_thu_tu

Number

Số thứ tự của các chứng từ

6

v_chungtu_tong_so_tien

Number

Tổng số tiền của chứng từ

7

v_chungtu_so_ct_giay

String

50

Số chứng từ lấy trên phần mềm ứng dụng

8

v_chungtu_sotk_so

String

50

Số tài khoản giao dịch với kho bạc

9

v_chungtu_dm_tiente

String

Đơn vị tiền tệ sử dụng

10

v_ngay_chung_tu

Number

Ngày lập chứng từ

11

v_dvqhns_ma

String

20

Mã đơn vị quan hệ ngân sách giao dịch

12

v_dvqhns_vt

String

70

Tên viết tắt của đơn vị < 70 ký tự để đi ngân hàng

13

v_dvqhns_diachi

String

240

Địa chỉ đơn vị

14

v_dv_nopthue_ma

String

50

Mã đơn vị nộp thuế

15

y_dv_nopthue_ten

String

500

Tên đơn vị nộp thuế

16

v_dv_nopthue_ndkt_ma

String

4

Mã nội dung kinh tế đơn vị , nộp thuế

17

v_dv_nopthue_chuong_ma

String

3

Mã chương đơn vị nộp thuế

18

v_dv_nopthue_cqthu_ma

String

50

Mã cơ quan thu đơn vị nộp thuế

19

v_kbnn_hach_toan

String

4

Thông tin kho bạc hạch toán

20

v_dv_nhantien_ten

String

70

Tên đơn vị nhận tiền

21

v_dv_nhantien_diachi

String

240

Địa chỉ đơn vị nhận tiền

22

v_dv_nhantien_sotk_so

String

50

Số tài khoản đơn vị nhận tiền

23

v_par1

String

240

24

v_par2

String

240

25

v_par3

String

240

26

v_par6

String

240

27

v_dvqhns_namns

String

4

Năm ngân sách

28

v_dv_nopthue_kythue

String

200

Thông tin kỳ thuế

29

v_dv_nopthue_stk

String

200

Thông tin số tờ khai nộp thuế

30

v_dv_tratien_kbnn_nh_ten

String

1024

Tên kho bạc đơn vị trả tiền

31

v_dv_nhantien_kbnn_nh_ten

String

1024

Tên kho bạc đơn vị nhận tiền

32

v_dv_tratien_loai

Number

Loại cơ quan thanh toán đơn vị trả tiền

33

v_dv_nhantien_loai

Number

Loại cơ quan thanh toán đơn vị nhận tiền

34

v_dv_tratien_sotk_so

String

50

Số tài khoản đơn vị trả tiền

35

v_dv_tratien_capns_ma

String

50

Mã cấp ngân sách đơn vị trả tiền

36

v_dv_tratien_nganhang_ma

String

50

Mã ngân hàng đơn vị trả tiền

37

v_dv_nhantien_nganhang_ma

String

50

Mã ngân hàng đơn vị nhận tiền

38

v_dv_nhantien_sotien

Number

Số tiền nhận

39

v_tong_so_tien

Number

Tổng số tiền của chứng từ

40

v_thucchi_tamung

Number

Thực chi hay là tạm ứng

41

v_chuyenkhoan_tienmat

Number

Chuyển khoản hay là tiền mặt

42

v_nguoinhan_hoten

String

70

Họ và tên người nhận

43

v_nguoinhan_so_cmnd

String

50

Số CMND người nhận

44

v_nguoinhan_noi_cap_cmnd

String

240

Nơi cấp CMND người nhận

45

v_nguoinhan_ngay_cap_cmnd

date

Ngày cấp CMND người nhận

46

v_ma_nha_tai_tro

String

7

Mã nhà tài trợ

47

v_ma_dvgd_dvqhns

String

20

Mã đơn vị QHNS của đơn vị giao dịch

48

v_ma_dvgd

String

20

Mã đơn vị giao dịch

4.9

v_chu_ky_so_ctk

String

32000

Dữ liệu ký số của chủ tài khoản theo cấu trúc DVC

50

v_chu_ky_so_ktt

String

32000

Dữ liệu ký số của kế toán trưởng theo cấu trúc DVC

51

v_tg_ky_so_ktt

date

Thời gian kế toán trưởng ký

52

v_tg_ky_so_ctk

date

Thời gian chủ tài khoản ký

53

v_username_ktt

String

100

Kế toán trưởng

54

v_username_ctk

String

100

Chủ tài khoản

STT

Thông tin

Kiểu dữ liệu

Độ dài tối đa

Ghi chú

1

v_so_chung_tu

String

25

Số chứng từ trên hệ thống DVC

2

v_noi_dung

String

2048

Nội dung chi tiết

3

v_ngay_chung_tu

String

10

Ngày lập chứng từ

4

v_so_tien

Number

Số tiền hạch toán

5

v_nop_thue

Number

Số tiền nộp thuế

6

v_thanh_toan

Number

Số tiền thanh toán

7

v_so_tien_nguyen_te

Number

Số tiền nguyên tệ

8

v_ma_hang

Number

Số thứ tự dòng chi tiết

STT

Thông tin

Kiểu dữ liệu

Độ dài tối đa

Ghi chú

1

v_ma_ho_so

String

100

Mã hồ sơ gửi DVC

2

v_gn_tailieu_id

Number

ID tài liệu bảng kê 07(99)

3

v_so _chung_tu

String

25

Số chứng từ sinh theo quy định DVC:

XYYMMDD_ZZZZZZZ_KBNN999: Trong đó:

- X là mã định danh chứng từ do KBNN cung cấp cho từng nguồn dữ liệu;

- YYMMDD là định dạng ngày của chứng từ;

- ZZZZZZZ là mã đơn vị, dự án;

- KBNN là số hiệu kho bạc;

- 999: 3 ký tự cuối là số tăng dần theo ngày, đảm bảo số chứng từ là duy nhất.

4

v_so_thu_tu

Number

Số thứ tự của các chứng từ

5

v_chungtu_tong_so_tien

Number

Tổng số tiền của chứng từ

6

v_chungtu_so_ct_giay

String

20

Số chứng từ lấy trên phần mềm ứng dụng

7

v_ngay_chung_tu

String

10

Ngày lập chứng từ

8

v_dvqhns_ma

String

20

Mã đơn vị quan hệ ngân sách giao dịch

9

v_par1

String

240

10

v_dvqhns_ctmt_ma

String

5

Mã chương trình mục tiêu

11

v_dvqhns_nguon_ma

String

2

Mã nguồn

12

v_dvqhns_capns_ma

String

1

Mã cấp ngân sách

13

v_ma_dvgd_dvqhns

String

20

Mã QHNS của đơn vị giao dịch

14

v_ma_dvgd

String

20

Mã đơn vị giao dịch

15

v_chu_ky_so_ctk

String

32000

Dữ liệu ký số của chủ tài khoản theo cấu trúc DVC

16

v_chu_ky_so_ktt

String

32000

Dữ liệu ký số của kế toán trưởng theo cấu trúc DVC

17

v_tg_ky_so_ktt

date

Thời gian kế toán trưởng ký

18

v_tg_ky_so_ctk

date

Thời gian chủ tài khoản ký

19

v_username_ktt

String

100

Kế toán trưởng

20

v_username_ctk

String

100

Chủ tài khoản

STT

Thông tin

Kiểu dữ liệu

Độ dài tối đa

Ghi chú

1

v_so_hoa_don

String

30

Số hóa đơn

2

v_chung_tu_so

String

30

Số chứng từ

3

v_chung_tu_ngay

String

10

Ngày lập chứng từ

4

v_dm_ndkt_ma

String

4

Mã nội dung kinh tế

5

v_noi_dung

String

1024

Nội dung chi tiết

6

v_so_tien

Number

Số tiền hạch toán

7

v_ma_hang

String

50

Số thứ tự dòng chi tiết

8

v_ngay_hoa_don

String

10

Ngày hóa đơn

9

v_so_tien_sl

Number

Số tiền

10

v_so_tien_dm

Number

Số tiền

STT

Thông tin

Kiểu dữ liệu

Độ dài tối đa

Ghi chú

1

v_ma_ho_so

String

100

Mã hồ sơ gửi lên hệ thống DVC

2

v_gn_tailieu_id

Number

Thông tin tài liệu ID theo DVC (88)

3

v_so_chung_tu

String

25

Số chứng từ sinh theo quy định DVC:

XYYMMDD_ZZZZZZZ_KCBNN999: Trong đó:

- X là mã định danh chứng từ do KBNN cung cấp cho từng nguồn dữ liệu;

- YYMMDD là định dang ngày của chứng từ;

- ZZZZZZZ là mã đơn vị, dự án;

- KBNN là số hiệu kho bạc;

- 999: 3 ký tự cuối là số tăng dần theo ngày, đảm bảo số chứng từ là duy nhất.

4

v_la_tienmat

String

1

5

v_so_thu_tu

String

3

6

v_chungtu_tong_so_tien

String

50

Tổng số tiền của chứng từ

7

v_chungtu_so_ct_giay

String

20

Số chứng từ giấy trên phần mềm ứng dụng

8

v_chungtu_sotk_so

String

20

Số tài khoản thực hiện giao dịch với KBNN

9

v_chungtu_dm_tiente

String

3

Mã đơn vị tiền tệ chứng từ sử dụng

10

v_ngay_chung_tu

String

10

Ngày chứng từ trên phần mềm ứng dụng (dd/MM/yyyy)

11

v_tamung_ungtruoc

String

1

Là thực chi hay tạm ứng (0 hoặc 1)

12

v_dvqhns_ma

String

20

Mã quan hệ ngân sách

13

v_dvqhns_sotk_so

String

20

Số tờ khai

14

v_dvqhns_kbnn_ma

String

4

Mã KBNN

15

v_dvqhns_capns_ma

String

1

Mã cấp ngân sách

16

v_dvqhns_namns

String

4

Năm ngân sách

17

v_dvqhns_ctmt_ma

String

5

Mã chương trình mục tiêu

18

v_dvqhns_cancu_tu_ut

Number

Căn cứ số dư: là tạm ứng hay ứng trước

19

v_dvqhns_cancu_tu_ut _ngay

String

10

Ngày căn cứ số dư tạm ứng/ứng trước

20

v_dvqhns_cancu_tu_ut_kbnn_ma

String

4

Mã KBNN đề nghị thanh toán căn cứ Tạm ứng/ứng trước

21

v_dvqhns_cancu_tu_ut_kbnn_ten

String

100

Tên KBNN đề nghị thanh toán căn cứ Tạm ứng/ứng trước

22

v_dvqhns_thanhtoan _tu_ut

String

1

Thanh toán số tiền đã Tạm ứng hay ứng trước

23

v_dvqhns_thanhtoan _tc_ut

String

1

Thanh toán số tiền đã Tạm ứng hay ứng trước thành Thực chi hay ứng trước đủ điều kiện thanh toán

24

v_tong_so_tien

Number

Tổng số tiền trên chứng từ

25

v_par1

String

240

26

v_par2

String

240

27

v_par3

String

240

28

v_ma_dvgd_dvqhns

String

7

Mã QHNS của đơn vị giao dịch

29

v_ma_dvgd

String

7

Mã đơn vị giao dịch.

30

v_chu_ky_so_ctk

String

32000

Dữ liệu ký số của chủ tài khoản theo cấu trúc DVC

31

v_chu_ky_so_ktt

String

32000

Dữ liệu ký số của kế toán trưởng theo cấu trúc DVC

32

v_username_ktt

String

100

Kế toán trưởng

33

v_username_ctk

String

100

Chủ tài khoản

34

v_tg_ky_so_ktt

date

Thời gian kế toán trưởng ký

35

v_tg_ky_so_ctk

date

Thời gian chủ tài khoản ký

STT

Thông tin

Kiểu dữ liệu

Độ dài

Ghi chú

1

v_so_chung_tu

String

25

Số chứng từ trên hệ thống DVC

2

v_noi_dung

String

2048

Nội dung chi tiết

3

v_dm_ndkt_ma

String

4

Mã nội dung kinh tế

4

v_dm_chuong_ma

String

3

Mã chương

5

v_dm_nganh_kt_ma

String

3

Mã ngành kinh tế

6

v_dm_nguonchi_ma

String

2

Mã nguồn chi

7

v_so _ung_truoc

Number

Số ứng trước

8

v_so_de_nghi

Number

Số đề nghị

9

v_so_phe_duyet

Number

Số phê duyệt

10

v_ma_hang

Number

Số thứ tự

STT

Thông tin

Kiểu dữ liệu

Độ dài

Ghi chú

1

v_ma_ho_so

String

100

Mã hồ sơ gửi lên hệ thống DVC

2

v_gn_tailieu_id

Number

Thông tin tài liệu ID theo DVC (424)

3

v_so_chung_tu

String

25

Số chứng từ sinh theo quy định DVC:

XYYMMDD_ZZZZZZZ_KBNN999: Trong đó:

- X là mã định danh chứng từ do KBNN cung cấp cho từng nguồn dữ liệu;

- YYMMDD là định dang ngày của chứng từ;

- ZZZZZZZ là mã đơn vị, dự án;

- KBNN là số hiệu kho bạc;

- 999: 3 ký tự cuối là số tăng dần theo ngày, đảm bảo số chứng từ là duy nhất.

4

v_la_tienmat

String

1

5

v_so_thu_tu

String

3

6

v_chungtu_tong_so_tien

String

50

Tổng số tiền của chứng từ

7

v_chungtu_so_ct_giay

String

50

Số chứng từ giấy trên phần mềm ứng dụng

8

v_chungtu_sotk_so

String

50

Số tài khoản thực hiện giao dịch với KBNN

9

v_chungtu_dm_tiente

String

3

Mã đơn vị tiền tệ chứng từ sử dụng

10

v_ngay_chung_tu

String

10

Ngày chứng từ trên phần mềm ứng dụng (dd/MM/yyyy)

11

v_chuyenkhoan_tienmat

String

1

Là chuyển khoản hay tiền mặt

12

v_dv_nop_ma

String

7

13

v_dv_ma

String

50

14

v_dv_ten

String

500

Tên đơn vị

15

v_dvnop_sotk_so

String

50

Số tờ khai

16

v_dvnop_nguoinop

String

500

Người nộp

17

v_dvnop_kbnn_ma

String

4

Mã KBNN đơn vị nộp

18

v_dvnop_tk

String

50

Tài khoản đơn vị nộp

19

v_dvnop_qd_so

String

50

Quyết định số

20

v_dvnop_nh_ma

String

8

Mã ngân hàng đơn vị nộp

21

p_dvnop_kbnn_nh_ten

String

100

Tên KBNN đơn vị nộp

22

v_dvnop_loai

String

1

Loại đơn vị nộp

23

v_dvnop_sotk_loai

String

1

Loại tờ khai

24

v_dvnop_qd_ngay

String

10

Quyết định ngày

25

v_dvdutoan_ma

String

50

Mã đơn vị dự toán

26

v_dvdutoan_sotk_so

String

50

Số tờ khai đơn vị dự toán

27

v_dvdutoan_kbnn_ma

String

4

Mã KBNN đơn vị dự toán

28

v_dvdutoan_capns

String

1

Cấp ngân sách đơn vị dự toán

29

v_dvdutoan_namns

String

4

Năm ngân sách

30

v_dvdutoan_ckc_hdk

String

50

Cam kết chi hợp đồng khung

31

v_dvdutoan_ckc_hdth

String

50

Cam kết chi hợp đồng thực hiện

32

v_dvdutoan_ctmt_ma

String

5

Mã chương trình mục tiêu

33

v_tong_so_tien

String

100

Tổng số tiền trên chứng từ

34

v_par1

String

500

35

v_par2

String

500

36

v_par3

String

500

37

v_par4

String

500

38

v_par5

String

500

39

v_ma_dvgd_dvqhns

String

7

Mã QHNS đơn vị giao dịch

40

v_ma_dvgd

String

7

Mã đơn vị giao dịch

41

v_chu_ky_so_ctk

String

32000

Chữ ký số chủ tài khoản

42

v_chu_ky_so_ktt

String

32000

Chữ ký số kế toán trưởng

43

v_username_ktt

String

100

44

v_username_ctk

String

100

45

v_tg_ky_so_ktt

Date

Ngày KTT ký số

46

v_tg_ky_so_ctk

Date

Ngày CTK ký số

STT

Thông tin

Kiểu dữ liệu

Độ dài

Ghi chú

1

v_so_chung_tu

String

25

Số chứng từ

2

v_noi_dung

String

2048

Nội dung chi tiết

3

v_dm_ndkt_ma

String

4

Mã nội dung kinh tế

4

v_dm_chuong_ma

String

3

Mã chương

5

v_dm_nganh_kt_ma

String

3

Mã ngành kinh tế

6

v_dm_nguonchi_ma

String

2

Mã nguồn chi

7

v_so_tien

Number

Số tiền

8

v_nam_kh

Number

Năm kế hoạch

9

v_ma_hang

Number

STT

Thông tin

Kiểu dữ liệu

Độ dài

Ghi chú

1

v_ma_ho_so

String

100

Mã hồ sơ

2

v_ngay_ho_so

String

10

Ngày hồ sơ

3

v_ma_kbnn

String

4

Mã KBNN

4

v_ten_file

String

255

Tên file

5

v_ten_tai_lieu

String

500

Tên tài liệu

6

v_so_thu_tu

Number

Số thứ tự tệp trong danh sách

7

fileld

String

Tên file trên thư mục tạm (trả về sau khi upload thành công)

8

v_error_code

String

STT

Key

Value

Mô tả

1

Authorization

Bearer Token trả về khi login

STT

Key

Type

Value

1

file

File

File

STT

Tên thẻ

Ý nghĩa

Ghi chú

Thông tin chung của hồ sơ

1

MA_HO_SO

Mã hồ sơ

Mã hồ sơ gửi lên hệ thống DVC:

XYY_ZZZZZZZ_KBNN99999: Trong đó:

- X là mã định danh loại hồ sơ do KBNN cung cấp theo từng nguồn dữ liệu

- YY là 2 ký tự cuối của năm ngân sách

- ZZZZZZZ là mã đơn vị, dự án

- KBNN là số hiệu kho bạc

- 99999: 5 ký tự cuối là số tăng dần theo năm.

2

DM_KBNN_ID

Mã KBNN thực hiệu giao dịch

3

DM_HS_KSC_ID

Mã loại hồ sơ

1: Chi đầu tư

2: Chi thường xuyên

4

DM_LOAIDOITUONG_ID

Mã loại đối tượng

Giá trị là trống

5

GN_LOAIHS_ID

Mã loại hồ sơ

283: Hồ sơ chi

6

MTK_DVGD_ID

Mã đơn vị giao dịch

Truyền vào mã đơn vị giao dịch

7

HINH_THUC_GIAO_NHAN

Hình thức giao nhận

0: Trực tuyến

8

LOAI

Loại chứng từ

1: Có chứng từ thanh toán

9

MTK_DVGD_DVQHNS_ID

Mã quan hệ ngân sách

Truyền vào mã quan hệ ngân sách

10

DVGD_MA

Mã đơn vị giao dịch

11

DVGD_SOTHANHLAP

Số quyết định thành lập

Theo hồ sơ đơn vị giao dịch đăng ký với KBNN

12

DVGD_NGAYTHANHLAP

Ngày quyết định thành lập

Theo hồ sơ đơn vị giao dịch đăng ký với KBNN

13

SU_DUNG_CKS

Sử dụng CKS

1: Có sử dụng

14

GN_HOSO_TAILIEU

Thẻ đánh dấu bắt đầu tài liệu trong hồ sơ

15

GN_TAILIEU_ID

Mã của loại tài liệu

88: Mẫu 05a

99: Mẫu 07

421: Mẫu 16c3

423: Mẫu 16a1

424: Mẫu 06

425: Mẫu 16c1

500: Mẫu 16a2

Thông tin chi tiết mẫu 16a1, 16a2

1

NGAY_CHUNG_TU

Ngày chứng từ

2

SO_CHUNG_TU

Số chứng từ giấy

3

THUCCHI_TAMUNG

Thực chi/Tạm ứng

0: Thực chi

1: Tạm ứng

2: Ứng trước chưa đủ điều kiện thanh toán

3: Ứng trước đủ điều kiện thanh toán

4

CHUYENKHOAN_TIENMAT

Chuyển khoản/ Tiền mặt

0: Chuyển khoản

1: Tiền mặt

5

UT_DKTT

Ứng trước đủ điều kiện thanh toán

0: ứng trước chưa đủ điều kiện thanh toán

1: Ứng trước đủ điều kiện thanh toán

6

DM_DVQHNS_ID

Mã đơn vị quan hệ ngân sách

7

MTK_DVGD_DVQHNS_ID

Mã đơn vị quan hệ ngân sách

8

DVQHNS_MA

Mã đơn vị quan hệ ngân sách

9

DVQHNS_TEN

Tên đơn vị quan hệ ngân sách

10

DVQHNS_SOTK_ID

Mã tài khoản mở tại KBNN

11

DVQHNS_SOTK_SO

Mã tài khoản mở tại KBNN

12

DVQHNS_KBNN_ID

Mã KBNN mở tài khoản

13

DVQHND_CAPNS_ID

Mã cấp ngân sách

14

DVQHNS_NAMNS

Năm ngân sách

15

DVQHNS_CTMT_ID

Mã chương trình mục tiêu

16

DVQHNS_CKC_HDK

Số hợp đồng khung

17

DVQHNS_CKC_HDTH

Số hợp đồng thực hiện

18

DM_DV_NOPTHUE_ID

Mã đơn vị nộp thuế

19

DV_NOPTHUE_TEN

Tên đơn vị nộp thuế

20

DV_NOPTHUE_MASOTHUE

Mã số thuế

21

DV_NOPTHUE_NDKT_ID

Mã nội dung kinh tế phần thuế

22

DV_NOPTHUE_CHUONG_ ID

Mã chương nộp thuế

23

DV_NOPTHUE_CQTHU_ID

Mã cơ quan thu

24

DV_NOPTHUE_CQTHU_MA

Mã cơ quan thu

25

DV_NOPTHUE_KB_HACHTOAN _ID

Mã KBNN hạch toán thu

26

DV_NOPTHUE_SOTIENNOP

Số tiền nộp thuế

27

DM_DV_NHANTIEN_ID

Mã đơn vị nhận tiền

28

MTK_DV_NHANTIEN_ID

Để trống

29

DV_NHANTIEN_MA

Mã đơn vị nhận tiền

30

DV_NHANTIEN_DIACHI

Địa chỉ đơn vị

31

DV_NHANTIEN_SOTK_SO

Tài khoản đơn vị nhận tiền

32

DV_NHANTIEN_KBNN_ID

Mã KBNN nhận tiền

33

DV_NHANTIEN_NGANHANG_ID

Mã ngân hàng nhận tiền

34

DV_NHANTIEN_CTMT_ID

Để trống

35

DV_NHANTIEN_SOTIENNHAN

Số tiền thanh toán

36

MTK_NGUOINHAN_ID

Để trống

37

NGUOINHAN_SO_CMND

Số CMND người nhận

38

NGUOINHAN_HOTEN

Họ tên người nhận

39

NGUOINHAN_NGAYCAP_CMND

Ngày cấp CMND người nhận

40

NGUOINHAN_NOICAP_CMND

Nơi cấp CMND người nhận

41

TONG_SO_TIEN

Tổng số tiền

42

NGAY_TAO

Ngày tạo chứng từ

43

GN_HOSO_C202_GT

Thẻ chi tiết chứng từ C202

44

NOI_DUNG

Nội dung

45

DM_NDKT_ID

Mã nội dung kinh tế

46

DM_CHUONG_ID

Mã chương

47

DM_NGANH_KT_ID

Mã ngành kinh tế