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ế

48

DM_NGUONCHI_ID

Mã nguồn NSNN

49

SO_TIEN

Số tiền

50

DV_NOPTHUE

Số tiền nộp thuế

51

DV_NHANTIEN

Số tiền thanh toán

52

MA_HANG

Số thứ tự dòng

Thông tin chi tiết mẫu 16c1, 16c3

1

SO_CHUNG_TU

Ngày chứng từ

2

NGAY_CHUNG_TU

Số chứng từ giấy

3

DM_DV_TRATIEN_ID

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

4

MTK_DV_TRATIEN_ID

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

5

DV_TRATIEN_DIACHI

Địa chỉ đơn vị

6

DV_TRATIEN_KBNN_ID

Mã KBNN mở tài khoản

7

DV_TRATIEN_TKKT_ID

Mã Tài khoản

8

DV_TRATIEN_CTMT_ID

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