Quyết định 1403/QĐ-TCT năm 2018 về Chuẩn trao đổi dữ liệu giữa hệ thống của Tổng cục Thuế và Ngân hàng thương mại, Đơn vị trung gian thanh toán đáp ứng nộp thuế điện tử bằng hình thức nộp qua Internet Banking
| Số hiệu: | 1403/QĐ-TCT | Loại văn bản: | Quyết định |
| Nơi ban hành: | Tổng cục Thuế | Người ký: | Nguyễn Đại Trí |
| Ngày ban hành: | 30/08/2018 | Ngày hiệu lực: | Đang cập nhật |
| Ngày công báo: | Đang cập nhật | Số công báo: | Đang cập nhật |
| Lĩnh vực: | Thuế, phí, lệ phí, Ngân hàng, tiền tệ, Bưu chính, viễn thông, | Tình trạng: | Đang cập nhập |
| Ngày hết hiệu lực: | Đang cập nhật |
| BỘ TÀI CHÍNH |
CỘNG HÒA XÃ HỘI CHỦ NGHĨA VIỆT NAM |
| Số: 1403/QĐ-TCT |
Hà Nội, ngày 30 tháng 8 năm 2018 |
TỔNG CỤC TRƯỞNG TỔNG CỤC THUẾ
Căn cứ Quyết định số 115/2009/QĐ-TTg ngày 28/9/2009 của Thủ tướng Chính phủ quy định chức năng, nhiệm vụ, quyền hạn và cơ cấu tổ chức của Tổng cục Thuế trực thuộc Bộ Tài chính;
Căn cứ Quyết định số 114/QĐ-BTC ngày 15/01/2013 của Bộ trưởng Bộ Tài chính về chức năng, nhiệm vụ, quyền hạn và cơ cấu tổ chức của Cục Công nghệ thông tin trực thuộc Tổng cục Thuế;
Căn cứ Thông tư số 110/2015/TT-BTC ngày 28/7/2015 của Bộ Tài chính về Hướng dẫn giao dịch điện tử trong lĩnh vực thuế;
Xét đề nghị của Cục trưởng Cục Công nghệ thông tin,
QUYẾT ĐỊNH:
|
|
KT. TỔNG CỤC TRƯỞNG |
GIỮA HỆ THỐNG CỦA TỔNG CỤC THUẾ VÀ NGÂN HÀNG THƯƠNG MẠI, ĐƠN VỊ TRUNG GIAN THANH TOÁN ĐÁP ỨNG NỘP THUẾ ĐIỆN TỬ BẰNG HÌNH THỨC NỘP QUA INTERNETBANKING
(Ban hành kèm theo Quyết định số 1403/QĐ-TCT ngày 30/8/2018 của Tổng cục trưởng Tổng cục Thuế)
MỤC LỤC
I. GIỚI THIỆU
1. Tổng quan
2. Phạm vi
3. Thông tin liên hệ và hỗ trợ
4. Danh mục thuật ngữ/từ viết tắt
II. DỮ LIỆU TRAO ĐỔI GIỮA TỔNG CỤC THUẾ VÀ NGÂN HÀNG THƯƠNG MẠI, ĐƠN VỊ TRUNG GIAN THANH TOÁN
1. Phạm vi dữ liệu trao đổi
2. Giải pháp cung cấp
3. Mô hình trao đổi dữ liệu
4. Nội dung dữ liệu trao đổi
4.1. Gửi thông tin chứng từ từ các ĐVTT đến hệ thống của Tổng cục Thuế
4.2. Tra cứu thông tin chứng từ từ các ĐVTT đến hệ thống của Tổng cục Thuế
4.3. Dịch vụ cung cấp tra cứu sổ thuế LPTB
III. ĐỊNH DẠNG DỮ LIỆU
1. Danh sách các ứng dụng tham gia kết nối
2. Danh sách các loại message truyền - nhận
3. Chuẩn kết nối
4. Chuẩn dữ liệu
4.1. Chuẩn liên ngân hàng khi triển khai NTĐT đối với LPTB
4.2. Quy ước về biểu diễn dữ liệu
4.3. Chuẩn ký tự
4.4. Chuẩn khuôn dạng message truyền nhận
4.4.1. Khuôn dạng message chung
4.4.2. Khuôn dạng message chứng từ gửi từ ĐVTT tới GIP/T2B
4.4.3. Khuôn dạng message truy vấn chứng từ trên GIP/T2B
4.4.4. Khuôn dạng message trả lời truy vấn chứng từ từ GIP/T2B tới ĐVTT
4.4.5. Khuôn dạng message phản hồi kết quả nhận chứng từ
4.4.6. Khuôn dạng message truy vấn sổ thuế LPTB
4.4.7. Khuôn dạng message Trả lời Truy vấn sổ thuế LPTB
4.5. Chuẩn bảo mật
IV. CÁC LOẠI DANH MỤC
1. Danh mục trạng thái chứng từ
2. Danh mục thông báo
3. Danh mục loại NNT
4. Danh mục hình thức nộp
5. XSD Schemas tương ứng
1. Tổng quan
Tài liệu này mô tả chuẩn trao đổi dữ liệu giữa Tổng cục Thuế với các Ngân hàng thương mại/Đơn vị trung gian thanh toán trong việc nộp thuế điện tử thông qua hình thức Internet Banking, cụ thể:
- Mô tả chi tiết các thông số kết nối thông qua các API sử dụng WebSevice.
- Mô tả chi tiết khuôn dạng dữ liệu của các message tham gia vào trao đổi thông tin giữa Ngân hàng thương mại, Đơn vị trung gian thanh toán và hệ thống Tổng cục Thuế.
Ngoài ra, tài liệu này là cơ sở để lập trình, kết nối, kiểm thử hệ thống, người dùng trong việc xây dựng ứng dụng trao đổi dữ liệu giữa Tổng cục Thuế và Ngân hàng thương mại/Đơn vị trung gian thanh toán.
2. Phạm vi
Đặc tả chuẩn trao đổi dữ liệu và khuôn dạng message truyền nhận giữa Ngân hàng thương mại, Đơn vị trung gian thanh toán với hệ thống của Tổng cục Thuế thông qua hình thức nộp thuế Internet Banking tại các Ngân hàng thương mại, Đơn vị trung gian thanh toán.
3. Thông tin liên hệ và hỗ trợ
Trong quá trình tổ chức thực hiện, nếu có khó khăn vướng mắc, các đơn vị phản ánh về Tổng cục Thuế (qua Cục CNTT) xem xét, sửa đổi, bổ sung tài liệu cho phù hợp.
4. Danh mục thuật ngữ/từ viết tắt
| Thuật ngữ/ Từ viết tắt |
Định nghĩa |
| API |
Giao diện lập trình ứng dụng |
| CKS |
Chữ ký số |
| CMND |
Chứng minh nhân dân |
| CN BĐS |
Chuyển nhượng bất động sản |
| CP |
Chính phủ |
| CQ |
Cơ quan |
| CQT |
Cơ quan thuế |
| CSDL |
Cơ sở dữ liệu |
| ĐBHC |
Địa bàn hành chính |
| ĐVTT |
Ngân hàng thương mại hoặc Đơn vị trung gian thanh toán |
| ESB |
Trục tích hợp ngành thuế |
| GIP/T2B |
Cổng cung cấp thông tin cho các đơn vị bên ngoài |
| GTGT |
Giá trị gia tăng |
| KBNN |
Kho bạc nhà nước |
| LPTB |
Lệ phí trước bạ |
| MST |
Mã số thuế |
| NH |
Ngân hàng |
| NN |
Nhà nước |
| NNT |
Người nộp thuế |
| NSNN |
Ngân sách nhà nước |
| NTĐT |
Nộp thuế điện tử |
| QĐ |
Quyết định |
| TC |
Tài chính |
| TCT |
Tổng cục thuế |
| TK |
Tài khoản |
II. DỮ LIỆU TRAO ĐỔI GIỮA TỔNG CỤC THUẾ VÀ NGÂN HÀNG THƯƠNG MẠI, ĐƠN VỊ TRUNG GIAN THANH TOÁN.
1. Phạm vi dữ liệu trao đổi
- Thông tin chứng từ từ các ĐVTT.
- Sổ thuế LPTB.
2. Giải pháp cung cấp
- Tổng cục Thuế cung cấp các dịch vụ (Web Service) cho hệ thống của ĐVTT để thực hiện việc trao đổi dữ liệu.
- Các dữ liệu trao đổi phải được thực hiện ký số trước khi truyền nhận.
3. Mô hình trao đổi dữ liệu
- External ESB: Là trục truyền tin bên ngoài ngành Thuế, thực hiện truyền tin giữa cơ quan Thuế và các ứng dụng bên ngoài ngành Thuế. External ESB nhận các thông tin GIP qua Internal ESB rồi truyền cho các đơn vị bên ngoài ngành Thuế.
- Service GipApp: Cung cấp dữ liệu cho các hệ thống khác khai thác thông qua trục tích hợp theo giao thức MQ, và giao thức HTTPS (Web Service).
- NHTM: Hệ thống của các ngân hàng thương mại
4. Nội dung dữ liệu trao đổi
4.1. Gửi thông tin chứng từ từ các ĐVTT đến hệ thống của Tổng cục Thuế
- Hệ thống của ĐVTT thực hiện gọi dịch vụ gửi thông tin chứng từ để gửi chứng từ sang hệ thống của Tổng cục Thuế.
- Thông tin dữ liệu trong chứng từ gửi được mô tả chi tiết như sau:
| STT |
Thông tin |
Mô tả |
Người cung cấp |
| 1 |
MST |
MST của NNT ghi trên giấy nộp tiền |
ĐVTT |
| 2 |
Tên NNT |
Tên NNT tương ứng với MST |
ĐVTT |
| 3 |
Địa chỉ NNT |
Địa chỉ của NNT ghi trên giấy nộp tiền |
ĐVTT |
| 4 |
MST người nộp thay |
MST của người được ủy quyền nộp thay ghi trên giấy nộp tiền |
ĐVTT |
| 5 |
Tên người nộp thay |
Tên người nộp thay tương ứng với MST người nộp thay |
ĐVTT |
| 6 |
Địa chỉ người nộp thay |
Địa chỉ của người nộp thay ghi trên giấy nộp tiền |
ĐVTT |
| 7 |
Số TK tại NH/KBNN |
Số tài khoản của NNT mở tại NH/ KBNN ghi trên giấy nộp tiền |
ĐVTT |
| 8 |
CQ quản lý thu |
Tên của cơ quan thu trực tiếp quản lý khoản nộp NSNN được ghi trên giấy nộp tiền |
ĐVTT |
| 9 |
Số chứng từ |
Thông tin số chứng từ trên giấy nộp tiền của NNT |
ĐVTT |
| 10 |
Ngày chứng từ |
Ngày ĐVTT lập chứng từ |
ĐVTT |
| 11 |
Tính chất khoản nộp |
Giá trị: - TK thu hồi quỹ hoàn thuế GTGT - Nộp vào NSNN |
ĐVTT |
| 12 |
CQ thẩm quyền |
Giá trị: - Kiểm toán NN - Thanh tra TC - Thanh tra CP - CQ có thẩm quyền khác |
ĐVTT |
| 13 |
Mã ĐVTT |
Mã 8 số của ĐVTT nơi gửi chứng từ sang GIP |
ĐVTT |
| 14 |
Tỉnh |
Thông tin mã tỉnh |
ĐVTT |
| 15 |
Huyện |
Thông tin mã huyện |
ĐVTT |
| 16 |
Mã hình thức nộp |
Giá trị: 00, 01, 02, 03, 04, 05, 06, 07 |
ĐVTT |
| 17 |
Diễn giải hình thức nộp |
- 00: Nộp tại cổng NTĐT của TCT - 01: Nộp tại quầy - 02: Nộp qua hình thức EBanking - 03: Nộp qua ATM - 04: Nộp qua Home Banking - 05: Nộp qua Mobile Banking - 06: Nộp qua hình thức điện tử khác - 07: Nộp qua hình thức phi điện tử khác |
ĐVTT |
| 18 |
Loại hình NNT |
Giá trị: - 0: Không xác định - 1: Doanh nghiệp - 2: Cá nhân |
ĐVTT |
| 19 |
Loại tiền |
Giá trị: - VND - USD |
ĐVTT |
| 20 |
Số quyết định |
Số quyết định, số tờ khai, số thông báo |
ĐVTT |
| 21 |
Địa chỉ tài sản |
Với CN BĐS là địa chỉ/số lô/số thửa |
ĐVTT |
| 22 |
Số khung |
Đối với LPTB ô tô xe máy |
ĐVTT |
| 23 |
Số máy |
Đối với LPTB ô tô xe máy |
ĐVTT |
| 24 |
Ngày nộp tiền |
Ngày nộp tiền |
ĐVTT |
| 25 |
Đặc điểm phương tiện |
Đặc điểm phương tiện (Loại TS, Nhãn hiệu, Số loại hoặc Tên thương mại Loại TS: xxx; Nhãn hiệu: xxx; Số Loại/Tên Thương mại: xxxx) |
ĐVTT |
|
|
Chương |
Mã chương ghi trên giấy nộp tiền của NNT |
ĐVTT |
| 27 |
Tiểu mục |
Mã tiểu mục (mã nội dung kinh tế) ghi trên giấy nộp tiền của NNT |
ĐVTT |
| 28 |
Thông tin khoản nộp |
Thông tin chi tiết tên khoản nộp mà NNT ghi trên giấy nộp tiền |
ĐVTT |
| 29 |
Số tiền |
Số tiền NNT nộp ghi trên giấy nộp tiền |
ĐVTT |
| 30 |
Kỳ thuế |
Kỳ thuế |
ĐVTT |
- Hệ thống của Tổng cục Thuế nhận thông tin chứng từ và kiểm tra thông tin CKS của ĐVTT:
+ Trường hợp thông tin CKS của ĐVTT không hợp lệ, hệ thống gửi kết quả phản hồi xác thực CKS không thành công cho ĐVTT.
+ Trường hợp thông tin CKS của ĐVTT hợp lệ, thực hiện:
■ Ký nhân danh TCT lên kết quả xác nhận và lưu trữ.
■ Gửi kết quả xác nhận đã thành công tới ĐVTT.
4.2. Tra cứu thông tin chứng từ từ các ĐVTT đến hệ thống của Tổng cục Thuế
- ĐVTT nhập điều kiện tìm kiếm thông tin chứng từ và thực hiện truy vấn vào hệ thống của Tổng cục Thuế để lấy thông tin.
- Thông tin dữ liệu tra cứu chứng từ được mô tả chi tiết như sau:
| STT |
Thông tin |
Mô tả |
Người cung cấp |
| 1 |
MST |
MST của NNT ghi trên giấy nộp tiền |
ĐVTT |
| 2 |
MST người nộp thay |
MST của người được ủy quyền nộp thay ghi trên giấy nộp tiền |
ĐVTT |
| 3 |
Số chứng từ |
Nhập số chứng từ cần tra cứu |
ĐVTT |
| 4 |
Ngày chứng từ (Từ ngày... đến ngày...) |
Nhập ngày chứng từ tra cứu trong khoảng từ ngày ... đến ngày... |
ĐVTT |
| 5 |
Trạng thái |
Giá trị: 01: Thành công 02: Hủy |
ĐVTT |
- Hệ thống GIP/T2B tiếp nhận yêu cầu tra cứu chứng từ và kiểm tra CKS của ĐVTT.
+ Trường hợp thông tin CKS của ĐVTT không hợp lệ, hệ thống gửi kết quả phản hồi xác thực CKS không thành công cho ĐVTT.
+ Trường hợp thông tin CKS của ĐVTT hợp lệ, thực hiện:
■ Tìm kiếm thông tin chứng từ thu thuế trong CSDL GIP/T2B thỏa mãn điều kiện tìm kiếm.
■ Thực hiện ký nhân danh TCT lên kết quả tìm kiếm.
■ Gửi trả kết quả tra cứu cho ĐVTT, thông tin chứng từ trả ra bao gồm:
| STT |
Thông tin |
Mô tả |
Người cung cấp |
| 1 |
MST |
MST của NNT ghi trên giấy nộp tiền |
TCT |
| 2 |
Tên NNT |
Tên NNT tương ứng với MST |
TCT |
| 3 |
Địa chỉ NNT |
Địa chỉ của NNT ghi trên giấy nộp tiền |
TCT |
| 4 |
MST người nộp thay |
MST của người được ủy quyền nộp thay ghi trên giấy nộp tiền |
TCT |
| 5 |
Tên người nộp thay |
Tên người nộp thay tương ứng với MST người nộp thay |
TCT |
| 6 |
Địa chỉ người nộp thay |
Địa chỉ của người nộp thay ghi trên giấy nộp tiền |
TCT |
| 7 |
Số TK tại NH/KBNN |
Số tài khoản của NNT mở tại NH/ KBNN ghi trên giấy nộp tiền |
TCT |
| 8 |
CQ quản lý thu |
Tên của cơ quan thu trực tiếp quản lý khoản nộp NSNN được ghi trên giấy nộp tiền |
TCT |
| 9 |
Số chứng từ |
Thông tin số chứng từ trên giấy nộp tiền của NNT |
TCT |
| 10 |
Ngày chứng từ |
Ngày ĐVTT lập chứng từ |
TCT |
| 11 |
Tính chất khoản nộp |
Giá trị: - TK thu hồi quỹ hoàn thuế GTGT - Nộp vào NSNN |
TCT |
| 12 |
CQ thẩm quyền |
Giá trị: - Kiểm toán NN - Thanh tra TC - Thanh tra CP - CQ có thẩm quyền khác |
TCT |
| 13 |
Mã ĐVTT |
Mã 8 số của ĐVTT nơi gửi chứng từ sang GIP/T2B |
TCT |
| 14 |
Trạng thái chứng từ |
Giá trị: 01: Thành công 02: Hủy |
|
| 15 |
Tỉnh |
Thông tin mã tỉnh |
TCT |
| 16 |
Huyện |
Thông tin mã huyện |
TCT |
| 17 |
Mã hình thức nộp |
Giá trị: 00, 01, 02, 03, 04, 05, 06, 07 |
TCT |
| 18 |
Diễn giải hình thức nộp |
- 00: Nộp tại cổng NTĐT của TCT - 01: Nộp tại quầy - 02: Nộp qua hình thức EBanking - 03: Nộp qua ATM - 04: Nộp qua Home Banking - 05: Nộp qua Mobile Banking - 06: Nộp qua hình thức điện tử khác - 07: Nộp qua hình thức phi điện tử khác |
TCT |
| 19 |
Loại tiền |
Loại tiền + VND + USD |
|
| 20 |
Loại hình NNT |
Giá trị: - 0: Không xác định - 1: Doanh nghiệp - 2: Cá nhân |
TCT |
| 21 |
Số quyết định |
Số quyết định, số tờ khai, số thông báo |
TCT |
| 22 |
Địa chỉ tài sản |
Với CN BĐS là địa chỉ/số lô/số thửa |
TCT |
| 23 |
Số khung |
Đối với LPTB ô tô xe máy |
TCT |
| 24 |
Số máy |
Đối với LPTB ô tô xe máy |
TCT |
| 25 |
Ngày nộp tiền |
Ngày nộp tiền |
TCT |
| 26 |
Đặc điểm phương tiện |
Đặc điểm phương tiện (Loại TS, Nhãn hiệu, Số loại hoặc Tên thương mại Loại TS: xxx; Nhãn hiệu: xxx; Số Loại/Tên Thương mại: xxxx) |
TCT |
| 27 |
Chương |
Mã chương ghi trên giấy nộp tiền của NNT |
TCT |
| 28 |
Tiểu mục |
Mã tiểu mục (mã nội dung kinh tế) ghi trên giấy nộp tiền của NNT |
TCT |
| 29 |
Thông tin khoản nộp |
Thông tin chi tiết tên khoản nộp mà NNT ghi trên giấy nộp tiền |
TCT |
| 30 |
Số tiền |
Số tiền NNT nộp ghi trên giấy nộp tiền |
TCT |
| 31 |
Kỳ thuế |
Kỳ thuế |
TCT |
4.3. Dịch vụ cung cấp tra cứu sổ thuế LPTB
- ĐVTT thực hiện nhập số quyết định (số tờ khai), mã số thuế, loại thuế gửi thông tin truy vấn tới hệ thống GIP/T2B để tra cứu thông tin sổ thuế LPTB (Loại thuế không bắt buộc nhập).
- Hệ thống GIP/T2B tiếp nhận yêu cầu tra cứu thông tin sổ thuế LPTB và kiểm tra CKS của ĐVTT:
+ Trường hợp thông tin CKS của ĐVTT không hợp lệ, hệ thống gửi kết quả phản hồi xác thực CKS không thành công cho ĐVTT.
+ Trường hợp thông tin CKS của ĐVTT hợp lệ, thực hiện:
■ Tìm kiếm thông tin sổ thuế LPTB trong CSDL GIP/T2B thỏa mãn điều kiện tìm kiếm.
■ Gửi trả lại kết quả tra cứu cho ĐVTT. Thông tin chi tiết như sau:
| STT |
Thông tin |
Mô tả |
Người cung cấp |
| 1 |
MST |
Mã số thuế của NNT (thông tin chung của NNT) |
TCT |
| 2 |
Tên NNT |
Tên người nộp thuế |
TCT |
| 3 |
Loại NNT |
Loại người nộp thuế |
TCT |
| 4 |
Số CMND |
Số chứng minh nhân dân |
TCT |
| 5 |
Mã chương |
Mã chương của NNT (thông tin chung NNT) |
TCT |
| 6 |
Mã CQT quản lý |
Mã cơ quan thuế quản lý NNT |
TCT |
| 7 |
Địa chỉ |
Mô tả địa chỉ |
TCT |
| 8 |
Tỉnh/Thành phố |
Mã tỉnh |
TCT |
| 9 |
Quận/Huyện |
Mã huyện |
TCT |
| 10 |
Phường/xã |
Mã xã |
TCT |
| 11 |
MST |
Mã số thuế của NNT (thông tin sổ thuế) |
TCT |
| 12 |
Mã chương |
Mã chương của khoản phải nộp (thông tin sổ thuế) |
TCT |
| 13 |
Mã CQ thu |
Mã cơ quan thu |
TCT |
| 14 |
Số hiệu kho bạc |
Số hiệu kho bạc |
TCT |
| 15 |
Tiểu mục |
Tiểu mục khoản phải nộp |
TCT |
| 16 |
Nợ cuối kỳ |
Nợ cuối kỳ |
TCT |
| 17 |
Số Tài khoản có |
Tài khoản hạch toán khoản nộp của NNT |
TCT |
| 18 |
Số quyết định |
Số quyết định, số tờ khai, số thông báo |
TCT |
| 19 |
Ngày quyết định |
Ngày QĐ tương ứng với số QĐ |
TCT |
| 20 |
Tỉ giá |
Tỉ giá lần xuất bản |
TCT |
| 21 |
Loại tiền |
Loại tiền + VND + USD |
TCT |
| 22 |
Loại thuế |
Loại thuế |
TCT |
| 23 |
Địa chỉ tài sản |
Với CN BĐS là địa chỉ/số lô/số thửa |
TCT |
| 24 |
Mã ĐBHC |
Mã địa bàn hành chính |
TCT |
| 25 |
Số khung |
Số khung với LPTB ô tô, xe máy |
TCT |
| 26 |
Số máy |
Số máy với LPTB ô tô, xe máy |
TCT |
| 27 |
Kỳ thuế |
Kỳ thuế |
TCT |
| 28 |
Đặc điểm phương tiện |
Đặc điểm phương tiện (Loại TS, Nhãn hiệu, Số loại hoặc Tên thương mại Loại TS: xxx; Nhãn hiệu: xxx; Số Loại/Tên Thương mại: xxxx) |
TCT |
1. Danh sách các ứng dụng tham gia kết nối
| STT |
Sender_code/Receiver_code |
Sender_name/Receiver_name |
| 1 |
GIP/T2B |
Hệ thống GIP/T2B |
| 2 |
XXXXXXXX |
XXXXXXXX là mã 8 ký tự của ngân hàng do ĐVTT quy định |
2. Danh sách các loại message truyền - nhận
| STT |
Type |
Type_name |
Sender |
Receiver |
| 1 |
00021 |
Gửi thông tin chứng từ |
XXXXXXXX |
GIP/T2B |
| 2 |
00026 |
Phản hồi kết quả nhận chứng từ |
G1P/T2B |
XXXXXXXX |
| 3 |
00022 |
Truy vấn thông tin chứng từ |
XXXXXXXX |
GIP/T2B |
| 4 |
00023 |
Trả lời truy vấn thông tin chứng từ |
GIP/T2B |
XXXXXXXX |
| 5 |
00027 |
Kết quả phản hồi trao đổi thông tin khi gặp lỗi |
GIP/T2B |
XXXXXXXX |
| 6 |
00046 |
Yêu cầu tra cứu sổ thuế LPTB |
XXXXXXXX |
GIP/T2B |
| 7 |
00047 |
Trả lời truy vấn yêu cầu tra cứu sổ thuế LPTB |
GIP/T2B |
XXXXXXXX |
3. Chuẩn kết nối
Các ĐVTT xây dựng ứng dụng kết nối đến hệ thống trục ngoài (ESB External) để truyền thông tin chứng từ về Web Services của GIP/T2B.
Chức năng: API để các ĐVTT cấu hình truyền dữ liệu (chứng từ có chữ ký số của ngân hàng/trạng thái chứng từ) đến GIP/T2B.
| API name |
Property |
Value |
| Web Services |
Cung cấp |
ESB |
| Sử dụng |
XXXXXXXX, GIP/T2B (với XXXXXXXX là mã ĐVTT, tham chiếu đến mục 1) |
|
| API type |
Web services |
|
| Connection name |
https://... (Cung cấp khi có yêu cầu kết nối) |
4. Chuẩn dữ liệu
4.1. Chuẩn liên ngân hàng khi triển khai NTĐT đối với LPTB
- Cấu trúc:
+ NTDTCN+KB:ND1+NgayNT:ND2+MST:ND3+DBHC:ND4+TKNS:ND5 +CQT:ND6+Lthue:ND7+STB:ND8+NTB:ND9+SK:ND10-SM:ND11 (C:ND12-TM:ND13-KT:ND14-ST:ND15-GChu:ND16)
- Các thông tin:
+ ND1: Số hiệu KB
+ ND2: Ngày nộp theo định dạng DDMMYYYY
+ ND3: Mã NNT
+ ND4: Mã DBHC
+ ND5: Tài khoản NSNN
+ ND6: Mã CQ thu
+ ND7: Loại thuế
+ ND8: Số thông báo nộp thuế/số tờ khai/số quyết định
+ ND9: Ngày thông báo/ngày quyết định
+ ND10: Số khung
+ ND11: Số máy
+ ND12: Chương
+ ND13: Tiểu mục
+ ND14: Kỳ thuế
+ ND15: Số tiền
+ ND16: Ghi chú
- Chú ý:
+ Đối với các trường hợp không yêu cầu gửi số khung, số máy, số thông báo, ngày thông báo có thể để null, các trường hợp này bỏ cả ký hiệu đầu (bỏ: STB, NTB, SK, SM).
+ Đối với trường hợp nộp thay: Ngân hàng không kiểm tra tên người nộp thuế, phần ghi chú (ND16) để nội dung là ‘NT’.
4.2. Quy ước về biểu diễn dữ liệu
Trong tài liệu chuẩn này, dữ liệu được đặt trong phần nội dung của thẻ và trong một số trường hợp được đưa vào phần thuộc tính (chẳng hạn phần nội dung chứng từ cần có thuộc tính “id” để phục vụ ký số). Một thẻ chứa dữ liệu bên trong nó thì không chứa bất cứ thẻ con nào khác, và được gọi là thẻ đơn. Thẻ phức là thẻ chỉ chứa các thẻ con. Trong một tài liệu, có thể có ba loại gồm thẻ đơn hoặc thẻ phức hoặc thẻ rỗng. Nếu thẻ là thẻ rỗng (không chứa dữ liệu hoặc bất kỳ thẻ con nào) thì 2 bên thống nhất vẫn để thẻ đó tồn tại trong tài liệu mà không bỏ đi.
4.3. Chuẩn ký tự
Chuẩn Code CharSet ID (CCSID) và Encoding: CCSID =1208 và encoding 546 (UTF-8).
Mục 4.4 sẽ mô tả các thẻ đơn có thể có trong message trao đổi giữa 2 bên.
Các kiểu dữ liệu cơ sở (như String, Integer, Date...) được hiểu như khuyến nghị của tổ chức World Wide Web (W3).
Tài liệu tham khảo tại trang http://www.w3.org/TR/2006/REC-xml11-20060816/. Quy luật chuẩn ký tự được sử dụng theo cách sau: Các tên tiếng Việt được viết liền không dấu, viết hoa; Nếu tên quá dài được viết tắt.
4.4. Chuẩn khuôn dạng message truyền nhận
4.4.1. Khuôn dạng message chung
- Thông điệp trao đổi thông tin trên ESB có khuôn dạng XML bao gồm các thành phần:
+ HEADER: Chứa các thông tin định tuyến truyền tin.
+ BODY: Chứa dữ liệu mà các ứng dụng trao đổi với nhau. Phần này sẽ để mở để các ứng dụng chủ động định nghĩa.
+ SECURITY: Chứa các thông tin về bảo mật. Hiện tại là chữ ký điện tử nhân danh TCT khi TCT gửi dữ liệu ra ngoài và chữ ký điện tử của đối tác ngân hàng,... khi TCT nhận được từ đối tác.
- Cấu trúc khuôn dạng chung của 1 message như sau:
- Lưu ý: Tất cả các khuôn dạng message chi tiết được trình bày ở các mục 4.4 (từ 4.4.2 cho đến 4.4.7) dưới đây đều được đóng gói bên trong thẻ <ROW></ROW> của khuôn dạng message chung này. Do đó, trong các phần bên dưới đây (từ 4.4.2 cho đến 4.4.7), tài liệu chỉ đề cập đến việc mô tả cấu trúc khuôn dạng message riêng của từng loại dịch vụ, tất cả các khuôn dạng chi tiết này là một thành phần con và được đưa vào trong thẻ <ROW> của khuôn dạng chung như đã đề cập ở trên.
Chi tiết các thẻ phức <HEADER>, <BODY> và <SECURITY> như sau:
| Tên thẻ XML |
Loại |
Độ dài |
Diễn giải |
Ràng buộc |
Chú thích |
| <HEADER> |
|||||
| <VERSION> |
String |
3 |
Phiên bản message |
Bắt buộc |
1.0 |
| <SENDER_CODE> |
String |
10 |
Mã ứng dụng gửi. |
Bắt buộc |
|
| <SENDER_NAME> |
String |
200 |
Tên ứng dụng gửi |
Tùy chọn |
|
| <RECEIVER_CODE> |
String |
10 |
Mã ứng dụng nhận |
Bắt buộc |
|
| <RECEIVER_NAME> |
String |
200 |
Tên ứng dụng nhận |
Tùy chọn |
|
| <TRAN CODE> |
String |
5 |
Mã loại message |
Bắt buộc |
Mã 05010: Là mã giao dịch của ĐVTT truy vấn tới GIP/T2B Mã 05011: Là mã giao dịch của GIP/T2B gửi tới ĐVTT |
| <MSG_ID> |
String |
20 |
Id của message gửi |
Bắt buộc |
SENDER_CODE + sequence (ứng dụng gửi cung cấp). Trong trường hợp msg là msg phản hồi thì giá trị này là “999” |
| <MSG REFID> |
String |
20 |
Id ref của message gửi |
Bắt buộc |
là MSG_ID của msg mà msg này báo trạng thái, chỉ có giá trị khi msg này là msg phản hồi (msg cập nhật trạng thái truyền tin) |
| <ID_LINK> |
String |
30 |
|
|
Dùng để chứa giá trị của ID chứng từ trong body. Phục vụ việc tra cứu log. Trong trường hợp gửi theo lô, các ID cách nhau bằng 1 ký tự (vd “:”). |
| <SEND_DATE> |
DATE |
|
Ngày gửi message |
Bắt buộc |
Định dạng DD-MMM-YYYY hh24:mi:ss Ví dụ: 01-Jan-2014 16:17:18 |
| <ORIGINAL_CODE> |
String |
10 |
Mã địa chỉ nguồn |
Tùy chọn |
3 trường original là thông tin về nơi xuất phát của chứng từ gốc, dùng trong trường hợp msg đi qua nhiều chặng |
| <ORIGINAL_NAME> |
String |
200 |
Tên địa chỉ nguồn |
Tùy chọn |
|
| <ORIGINAL_DATE> |
String |
|
Ngày export dữ liệu |
Tùy chọn |
Định dạng DD-MMM-YYYY hh24:mi:ss Ví dụ: 01-Jan-2014 16:17:18 |
| <ERROR_CODE> |
Number |
3 |
Mã lỗi truyền tin |
Tùy chọn |
Chỉ có giá trị khi msg là msg phản hồi |
| <ERROR_DESC> |
String |
100 |
Mô tả lỗi truyền tin |
Tùy chọn |
Chỉ có giá trị khi msg là msg phản hồi |
| <SPARE1> |
String |
50 |
Dự phòng |
Tùy chọn |
|
| <SPARE2> |
String |
50 |
Dự phòng |
Tùy chọn |
|
| <SPARE3> |
String |
50 |
Dự phòng |
Tùy chọn |
|
| </HEADER> |
|||||
| <BODY> |
|||||
| <ROW> Dữ liệu XML được định nghĩa bởi các ứng dụng tham gia kết nối (từ 4.4.2 cho đến 4.4.7) </ROW> |
|||||
| </BODY> |
|||||
| <SECURITY> |
|||||
| <SIGNATURE> |
|
|
|
|
Thẻ chứa các giá trị của thẻ ký |
| <SignatureValue> |
String |
|
Chữ kí điện tử nhân danh tổ chức (TCT, Ngân hàng...) |
Tùy chọn |
|
| </SECURITY> |
|||||
4.4.2. Khuôn dạng message chứng từ gửi từ ĐVTT tới GIP/T2B
Khuôn dạng message chứng từ gửi từ ĐVTT tới GIP/T2B gửi có cấu trúc như sau:
Định nghĩa chi tiết message:
| STT |
Thẻ phức |
Thẻ đơn |
Mức |
Bắt buộc |
Kiểu dữ liệu |
Độ dài |
Mô tả |
Ghi chú |
| 1 |
ROW |
|
3 |
|
|
|
|
|
| 2 |
|
TYPE |
4 |
Y |
String |
10 |
Kiểu message |
|
| 3 |
|
NAME |
4 |
Y |
String |
100 |
Tên loại message |
|
| 4 |
CHUNGTU |
|
4 |
|
|
|
|
|
| 5 |
|
MST |
5 |
Y |
String |
14 |
Mã số thuế |
|
| 6 |
|
TEN_NNT |
5 |
Y |
String |
200 |
Tên người nộp thuế |
|
| 7 |
|
DIACHI_NNT |
5 |
Y |
String |
200 |
Địa chỉ người nộp thuế |
|
| 8 |
|
MST_NNTHAY |
5 |
|
String |
14 |
MST người nộp thay |
|
| 9 |
|
TEN_NNTHAY |
5 |
|
String |
200 |
Tên người nộp thay |
|
| 10 |
|
DIACHI_NNTHAY |
5 |
|
String |
200 |
Địa chỉ người nộp thay |
|
| 11 |
|
SO_TK_NHKBNN |
5 |
Y |
String |
100 |
Số tài khoản NH/KBNN |
|
| 12 |
|
CQ_QLY_THU |
5 |
Y |
String |
7 |
Mã cơ quan thu (7 ký tự) |
|
| 13 |
|
SO_CHUNGTU |
5 |
Y |
String |
20 |
Số chứng từ |
|
| 14 |
|
NGAY_CHUNGTU |
5 |
Y |
Date |
10 |
Ngày chứng từ |
Định dạng DD/MM /YYYY |
| 15 |
|
TINHCHAT_ KHOAN_NOP |
5 |
Y |
String |
100 |
Tính chất khoản nộp |
|
| 16 |
|
CQUAN_THAM QUYEN |
5 |
Y |
String |
100 |
Cơ quan thẩm quyền |
|
| 17 |
|
MA_ĐVTT |
5 |
Y |
String |
8 |
Mã 8 số của ngân hàng thương mại |
|
| 18 |
|
TINH |
5 |
Y |
String |
5 |
Mã tỉnh |
|
| 19 |
|
HUYEN |
5 |
Y |
String |
5 |
Mã huyện |
|
| 20 |
|
MA_HTHUC_NOP |
5 |
Y |
String |
2 |
Mã hình thức nộp: 00, 01, 02, 03, 04, 05, 06, 07 |
|
| 21 |
|
DIENGIAI_ HTHUC_NOP |
5 |
Y |
String |
100 |
Diễn giải hình thức nộp: + 00: Nộp tại cổng NTĐT của TCT + 01: Nộp tại quầy + 02: Nộp qua Ebanking + 03: Nộp qua ATM + 04: Nộp qua Home Banking + 05: Nộp qua Mobile Banking + 06: Nộp qua hình thức điện tử khác + 07: Nộp qua hình thức phi điện tử khác |
|
| 22 |
|
LOAI_TIEN |
5 |
|
String |
3 |
Loại tiền + VND + USD |
|
| 23 |
|
LHINH_NNT |
5 |
|
String |
1 |
Loại hình người nộp thuế: + 0: Không xác định + 1: Doanh nghiệp + 2: Cá nhân |
|
| 24 |
|
SO_QUYET_DINH |
5 |
Y |
String |
30 |
Số quyết định, số thông báo, số tờ khai |
|
| 25 |
|
DIA_CHI_TS |
5 |
Y |
String |
250 |
Địa chỉ/số lô/số thửa (với CN BĐS) |
|
| 26 |
|
SO_KHUNG |
5 |
N |
String |
30 |
Đối với LPTB ô tô xe máy |
|
| 27 |
|
SO_MAY |
5 |
N |
String |
30 |
Đối với LPTB ô tô xe máy |
|
| 28 |
|
NGAY_NTIEN |
5 |
|
Date |
10 |
Ngày nộp tiền |
Định dạng DD/MM /YYYY |
| 29 |
|
DAC_DIEM_PTIEN |
5 |
Y |
String |
250 |
Đặc điểm phương tiện (Loại TS, Nhãn hiệu, Số loại hoặc Tên thương mại Loại TS: xxx; Nhãn hiệu: xxx; Số Loại/Tên Thương mại: xxxx) |
|
| 30 |
CHUNGTU_ CHITIET |
|
4 |
|
|
|
Thẻ được lặp nhiều lần |
|
| 31 |
|
CHUONG |
5 |
Y |
String |
3 |
Mã Chương |
|
| 32 |
|
TIEUMUC |
5 |
Y |
String |
4 |
Mã tiểu mục |
|
|
|
|
THONGTIN_ KHOANNOP |
5 |
Y |
String |
100 |
Thông tin khoản nộp |
|
| 33 |
|
SO_TIEN |
5 |
Y |
NUMBER |
17 |
Số tiền |
|
| 34 |
|
KY_THUE |
5 |
|
String |
10 |
Định dạng: MM/YYYY |
|
| 35 |
<Signature Value> |
|
|
Y |
|
|
Chữ ký Ngân hàng |
|
| 36 |
|
SignatureMethod Algorithm |
|
|
|
|
Thuật toán ký theo chuẩn http://www.w 3.org/2000/0 9/xmldsig#rs a-sha1 |
|
| 37 |
|
Transform Algorithm |
|
|
|
|
Ký theo chuẩn http://www.w 3.org/2000/0 9/xmldsig#en veloped-signature |
|
| 38 |
|
Keyinfo/ X509Data |
|
|
|
|
|
|
| 39 |
|
X509SubjectName |
|
|
|
|
Tên chủ thể chứng thư số |
|
| 40 |
|
X509Certificate |
|
|
|
|
Chứng thư số |
|
4.4.3. Khuôn dạng message truy vấn chứng từ trên GIP/T2B
Khuôn dạng message truy vấn chứng từ trên GIP/T2B có cấu trúc như sau:
Định nghĩa chi tiết message:
| STT |
Thẻ phức |
Thẻ đơn |
Mức |
Kiểu dữ liệu |
Độ dài |
Mô tả |
| 1 |
ROW |
|
3 |
|
|
|
| 2 |
|
TYPE |
4 |
String |
10 |
Kiểu message |
| 3 |
|
NAME |
4 |
String |
100 |
Tên loại message |
| 4 |
CHUNGTU |
|
4 |
|
|
|
| 5 |
|
MST |
5 |
String |
14 |
Mã số thuế |
| 6 |
|
MST_NNTHAY |
5 |
String |
14 |
Mã số thuế người nộp thay thuế |
| 7 |
|
SO_CHUNGTU |
5 |
String |
20 |
Số chứng từ |
| 8 |
|
NGAY_CHUNG TU_TUNGAY |
5 |
Date |
10 |
Ngày chứng từ (VD: 20/10/2017) |
| 9 |
|
NGAY_CHUNG TU_DENNGAY |
5 |
Date |
10 |
Đến ngày chứng từ (VD: 20/10/2017) |
| 10 |
|
TRANG_THAI |
5 |
String |
2 |
Trạng thái chứng từ 01: Thành công 02: Hủy |
| 11 |
<SignatureValue> |
|
|
|
|
Chữ ký Ngân hàng |
| 12 |
|
SignatureMethod Algorithm |
|
|
|
Thuật toán ký theo chuẩn http://www.w 3.org/2000/0 9/xmldsig#rs a-sha1 |
| 13 |
|
Transform Algorithm |
|
|
|
Ký theo chuẩn http://www.w 3.org/2000/0 9/xmldsig#en veloped-signature |
| 14 |
|
Keylnfo/ X509Data |
|
|
|
|
| 15 |
|
X509SubjectName |
|
|
|
Tên chủ thể chứng thư số |
| 16 |
|
X509Certificate |
|
|
|
Chứng thư số |
4.4.4. Khuôn dạng message trả lời truy vấn chứng từ từ GIP/T2B tới ĐVTT
Khuôn dạng message trả lời truy vấn chứng từ từ GIP/T2B tới ĐVTT có cấu trúc như sau:
Định nghĩa chi tiết message:
| STT |
Thẻ phức |
Thẻ đơn |
Mức |
Kiểu dữ liệu |
Độ dài |
Mô tả |
Ghi chú |
| 1 |
ROW |
|
3 |
|
|
|
|
| 2 |
|
TYPE |
4 |
String |
10 |
Kiểu message |
|
| 3 |
|
NAME |
4 |
String |
100 |
Tên loại message |
|
| 4 |
CHUNGTU |
|
4 |
|
|
|
|
| 5 |
|
MST |
5 |
String |
14 |
Mã số thuế |
|
| 6 |
|
TEN_NNT |
5 |
String |
200 |
Tên người nộp thuế |
|
| 7 |
|
DIACHI_NNT |
5 |
String |
200 |
Địa chỉ người nộp thuế |
|
| 8 |
|
MST_NNTHAY |
5 |
String |
14 |
MST người nộp thay |
|
| 9 |
|
TEN_NNTHAY |
5 |
String |
200 |
Tên người nộp thay |
|
| 10 |
|
DIACHI_NNTHAY |
5 |
String |
200 |
Địa chỉ người nộp thay |
|
| 11 |
|
SO_TK_NHKB NN |
5 |
String |
100 |
Số tài khoản ngân hàng/KBNN |
|
| 12 |
|
CQ_QLY_THU |
5 |
String |
7 |
Mã cơ quan thu |
|
| 13 |
|
SO_CHUNGTU |
5 |
String |
20 |
Số chứng từ |
|
| 14 |
|
NGAY_CHUNGTU |
5 |
Date |
10 |
Ngày chứng từ |
Định dạng DD/MM/ YYYY |
| 15 |
|
TINHCHAT_KHOAN NOP |
5 |
String |
100 |
Tính chất khoản nộp |
|
| 16 |
|
CQUAN_THAM QUYEN |
5 |
String |
100 |
Cơ quan thẩm quyền |
|
| 17 |
|
MA_ĐVTT |
5 |
String |
8 |
Mã ngân hàng thương mại |
|
| 18 |
|
TRANGTHAI_ CHUNGTU |
5 |
String |
2 |
Trạng thái chứng từ 01: Thành công 02: Hủy |
|
| 19 |
|
TINH |
5 |
String |
5 |
Mã Tỉnh |
|
| 20 |
|
HUYEN |
5 |
String |
5 |
Mã Huyện |
|
| 21 |
|
MA_HTHUC_NOP |
5 |
String |
2 |
Mã hình thức nộp: 00, 01, 02, 03, 04, 05, 06, 07 |
|
| 22 |
|
DIENGIAI_HTHUCNOP |
5 |
String |
100 |
Diễn giải hình thức nộp: + 00: Nộp tại cổng NTĐT của TCT + 01: Nộp tại quầy + 02: Nộp qua Ebanking + 03: Nộp qua ATM + 04: Nộp qua Home Banking + 05: Nộp qua Mobile Banking + 06: Nộp qua hình thức điện tử khác + 07: Nộp qua hình thức phi điện tử khác |
|
| 23 |
|
LOAI_TIEN |
5 |
String |
3 |
Loại tiền + VND + USD |
|
| 24 |
|
LHINH_NNT |
5 |
String |
1 |
Loại hình người nộp thuế: + 0: Không xác định + 1: Doanh nghiệp + 2: Cá nhân |
|
| 25 |
|
SO_QUYET_DINH |
5 |
String |
30 |
Số quyết định |
|
| 26 |
|
DIA_CHI_TS |
5 |
String |
2500 |
Địa chỉ/số lô/số thửa (với CN BĐS) |
|
| 27 |
|
SO_KHUNG |
5 |
String |
30 |
Đối với LPTB ô tô xe máy |
|
| 28 |
|
SO_MAY |
5 |
String |
30 |
Đối với LPTB ô tô xe máy |
|
| 29 |
|
NGAY_NTIEN |
5 |
Date |
10 |
Ngày nộp tiền |
Định dạng DD/MM/ YYYY |
| 30 |
|
DAC_DIEM_PTIEN |
5 |
String |
250 |
Đặc điểm phương tiện (Loại TS, Nhãn hiệu, Số loại hoặc Tên thương mại Loại TS: xxx; Nhãn hiệu: xxx; Số Loại/Tên Thương mại: xxxx) |
|
| 31 |
CHUNGTU_ CHITIET |
|
4 |
|
|
Thẻ được lặp nhiều lần |
|
| 32 |
|
CHUONG |
5 |
String |
3 |
Mã Chương |
|
| 33 |
|
TIEUMUC |
5 |
String |
4 |
Mã tiểu mục |
|
| 34 |
|
THONGTIN_KHOAN NOP |
5 |
String |
100 |
Thông tin khoản nộp |
|
| 35 |
|
SO_TIEN |
5 |
Number |
17 |
Số tiền |
|
| 36 |
|
KY_THUE |
5 |
String |
10 |
Định dạng: MM/YYYY |
|
| 37 |
<SignatureValue> |
|
|
|
|
Chữ ký Ngân hàng |
|
| 38 |
|
SignatureMethod Algorithm |
|
|
|
Thuật toán ký theo chuẩn http://www. w3.org/2000 /09/xmldsig# rsa-sha1 |
|
| 39 |
|
Transform Algorithm |
|
|
|
Ký theo chuẩn http://www. w3.org/2000 /09/xmldsig# enveloped- signature |
|
| 40 |
|
Keylnfo/ X509Data |
|
|
|
|
|
| 41 |
|
X509SubjectName |
|
|
|
Tên chủ thể chứng thư số |
|
| 42 |
|
X509Certificate |
|
|
|
Chứng thư số |
|
4.4.5. Khuôn dạng message phản hồi kết quả nhận chứng từ
Khuôn dạng message phản hồi kết quả nhận chứng từ do GIP/T2B gửi có cấu trúc như sau:
Định nghĩa chi tiết message:
| STT |
Tên thẻ phức |
Thẻ đơn |
Mức |
Kiểu dữ liệu |
Độ dài |
Mô tả |
| 1 |
ROW |
|
2 |
|
|
|
| 2 |
|
TYPE |
4 |
String |
10 |
Loại message |
| 3 |
|
NAME |
4 |
String |
100 |
Tên của loại cần trao đổi |
| 4 |
CHUNGTU |
|
3 |
|
|
|
| 5 |
|
SO_CHUNGTU |
4 |
String |
20 |
Thông báo kết quả nhận cho số chứng từ này |
| 6 |
|
TRANG_THAI |
4 |
String |
2 |
Là mã trạng thái của kết quả nhận chứng từ: + 01: Thành công + 02: Không thành công |
| 7 |
|
MOTA_TRANGTHAI |
4 |
String |
100 |
Miêu tả trạng thái |
4.4.6. Khuôn dạng message truy vấn sổ thuế LPTB
Khuôn dạng message truy vấn sổ thuế LPTB do các ĐVTT gửi có cấu trúc như sau:
Định nghĩa chi tiết message:
| STT |
Tên thẻ phức |
Thẻ đơn |
Mức |
Kiểu dữ liệu |
Độ dài |
Mô tả |
| 1 |
ROW |
|
2 |
|
|
|
| 2 |
|
TYPE |
4 |
String |
10 |
Loại message |
| 3 |
|
NAME |
4 |
String |
100 |
Tên của loại cần trao đổi |
| 4 |
TRUYVAN |
|
4 |
|
|
|
| 5 |
|
SO_TKHAI |
5 |
String |
30 |
Số quyết định (số tờ khai) cần tra cứu |
| 6 |
|
MST |
5 |
String |
14 |
Mã số thuế cần tra cứu |
| 7 |
|
LOAI_THUE |
5 |
String |
3 |
Loại thuế |
4.4.7. Khuôn dạng message Trả lời Truy vấn sổ thuế LPTB
Khuôn dạng message trả lời truy vấn sổ thuế LPTB do GIP/T2B gửi có cấu trúc như sau:
Định nghĩa chi tiết message:
| STT |
Tên thẻ phức |
Thẻ đơn |
Mức |
Kiểu dữ liệu |
Độ dài |
Mô tả |
Ghi chú |
| 1 |
ROW |
|
3 |
|
|
|
|
| 2 |
|
TYPE |
4 |
String |
10 |
Loại message |
|
| 3 |
|
NAME |
4 |
String |
100 |
Tên của loại cần trao đổi |
|
| 4 |
THONGTIN _NNT |
|
4 |
|
|
|
|
| 5 |
THONGTIN CHUNG |
|
5 |
|
|
|
|
| 6 |
ROW_NNT |
|
6 |
|
|
Thẻ được lặp nhiều lần |
|
| 7 |
|
MST |
7 |
String |
14 |
Trường hợp NNT không có MST thì trả ra MST đặc biệt |
|
| 8 |
|
TEN_NNT |
7 |
String |
200 |
Tên người nộp thuế |
|
| 9 |
|
LOAI_NNT |
7 |
String |
4 |
Loại người nộp thuế |
|
| 10 |
|
SO_CMND |
7 |
String |
20 |
Số CMND |
|
| 11 |
|
CHUONG |
7 |
String |
3 |
Mã chương |
|
| 12 |
|
MA_CQT_QL |
7 |
String |
10 |
Mã cơ quan thuế quản lý NNT |
|
| 13 |
DIACHI |
|
5 |
|
|
|
|
| 14 |
ROW_DIAC_HI |
|
6 |
|
|
Thẻ được lặp nhiều lần |
|
| 15 |
|
MOTA_DIACHI |
7 |
String |
100 |
Mô tả địa chỉ |
|
| 16 |
|
MA_TINH |
7 |
String |
5 |
Mã tỉnh |
|
| 17 |
|
MA_HUYEN |
7 |
String |
5 |
Mã huyện |
|
| 18 |
|
MA_XA |
7 |
String |
10 |
Mã xã |
|
| 19 |
SOTHUE |
|
5 |
|
|
|
|
| 20 |
ROW_SOTHUE |
|
6 |
|
|
Thẻ được lặp nhiều lần |
|
| 21 |
|
MST |
7 |
String |
14 |
Mã số thuế |
|
| 22 |
|
MA_CHUONG |
7 |
String |
3 |
Mã chương |
|
| 23 |
|
MA_CQ_THU |
7 |
String |
7 |
Mã CQ thu |
Lấy theo địa bàn Cơ quan thuế trên tờ khai |
| 24 |
|
SHKB |
7 |
String |
4 |
Số hiệu kho bạc |
|
| 25 |
|
MA_TMUC |
7 |
String |
4 |
Mã tiểu mục |
|
| 26 |
|
NO_CUOI_KY |
7 |
Number |
20 |
Nợ cuối kỳ |
|
| 27 |
|
SO_TAI_KHOAN_CO |
7 |
String |
4 |
Tài khoản hạch toán khoản nộp của NNT |
|
| 28 |
|
SO_QDINH |
7 |
String |
30 |
Số quyết định |
|
| 29 |
|
NGAY_QDINH |
7 |
Date |
10 |
Ngày quyết định |
Định dạng DD/MM/ YYYY |
| 30 |
|
TI_GIA |
7 |
String |
5 |
Tỉ giá |
|
| 31 |
|
LOAI_TIEN |
7 |
String |
3 |
Loại tiền + VND + USD |
|
| 32 |
|
LOAI_THUE |
7 |
String |
2 |
Loại thuế |
|
| 33 |
|
DIA_CHI_TS |
7 |
String |
250 |
Địa chỉ/số lô/số thửa (với CN BĐS) |
|
| 34 |
|
SO_KHUNG |
7 |
String |
30 |
Số khung |
|
| 35 |
|
SO_MAY |
7 |
String |
50 |
Số máy |
|
| 36 |
|
MA_DBHC |
7 |
String |
7 |
Mã địa bàn hành chính |
- Đối với CN BDS: mã xã/phường (mã 07 số) - Đối với LPTB Phương tiện: mã quận/huyện + 00 |
| 37 |
|
KY_THUE |
7 |
String |
10 |
Định dạng: MM/YYYY |
|
| 38 |
|
DAC_DIEM_PTIEN |
5 |
String |
250 |
Đặc điểm phương tiện (Loại TS, Nhãn hiệu, Số loại hoặc Tên thương mại Loại TS: xxx; Nhãn hiệu: xxx; Số Loại/Tên Thương mại: xxxx) |
|
4.5. Chuẩn bảo mật
Hệ thống GIP/T2B và ESB đòi hỏi mỗi yêu cầu gửi đến phải được xác thực để có thể sử dụng các API trên đó. Ngoài ra, toàn bộ dữ liệu trao đổi cần phải được ký số.
Vì vậy hai bên cần trao đổi chứng thư số được cấp bởi một cơ quan có thẩm quyền (các cơ quan triển khai CA) hoặc TCT. Chuẩn ký sử dụng trong quá trình trao đổi là chuẩn ký XPath Filter.
Phạm vi ký gồm toàn bộ nội dung trong 2 thẻ <HEADER></HEADER>, và <BODY></BODY> của file XML.
Nội dung ký nằm trong thẻ:
<SECURITY>
</SECURITY>
Thông tin về chữ kí điện tử:
| 1 |
SignatureMethod Algorithm |
Thuật toán ký theo chuẩn http://www.w3.org/2000/09/xmldsig#rsa-sha1 |
| 2 |
Transform Algorithm |
Ký theo chuẩn http://www.w3.org/2000/09/xmldsig#enveloped-signature |
| 4 |
X509SubjectName |
Tên chủ thể chứng thư số |
| 5 |
X509Certificate |
Chứng thư số |
1. Danh mục trạng thái chứng từ
| Mã trạng thái |
Mô tả |
| 01 |
Thêm mới chứng từ |
| 02 |
Hủy chứng từ |
2. Danh mục thông báo
| Mã lỗi |
Msg Type |
Mô tả lỗi |
| 02 |
00002 |
Null Số chứng minh nhân dân |
| 02 |
00004,00006 |
Null MST |
| 02 |
00023 |
Thiếu điều kiện tìm kiếm |
| 02 |
00025 |
Thiếu số chứng từ hoặc mã ngân hàng |
| 02 |
00027 |
Các lỗi khác |
| 02 |
00002,00004,00006 |
Không tìm thấy kết quả tìm kiếm |
| 02 |
00004,00006 |
Mã số thuế không tồn tại trong danh mục |
| 02 |
00031 |
Lỗi null mã tài khoản |
| 02 |
00026 |
Lỗi insert vào bảng chứng từ |
| 02 |
00004 |
Thiếu điều kiện tìm kiếm...MST tìm kiếm null |
3. Danh mục loại NNT
| Mã loại NNT |
Tên Loại NNT |
| 0100 |
01/ĐK-TCT (TChức, DNghiệp, CTy) |
| 0110 |
02/ĐK-TCT (TC, DN, CT TThuộc) |
| 0300 |
03/ĐK-TCT (Cá nhân, nhóm cá nhân KD) |
| 0310 |
03.1/ĐK-TCT (Cá nhân, nhóm CNKD TT) |
| 0400 |
04/ĐK-TCT (Nhà thầu nước ngoài) |
| 0410 |
04.1/ĐK-TCT (ĐV nộp hộ thuế NTNN) |
| 0420 |
04.2/ĐKT-TCT (NT, NTP không nộp TT) |
| 0430 |
04.3/ĐK-TCT (BĐH DA T.hiện HĐNT) |
| 0500 |
06/ĐK-TCT (Tổ chức ngoại giao) |
| 0900 |
05/ĐK-TCT (CN làm công ăn lương) |
| 9100 |
01/ĐKT-DKDN (Tổ chức SX, KDHH, DV) |
| 9110 |
02/ĐK-DKDN (Đơn vị trực thuộc) |
4. Danh mục hình thức nộp
| Mã hình thức nộp |
Tên hình thức nộp |
| 00 |
Nộp tại cổng NTĐT của TCT |
| 01 |
Nộp tại quầy |
| 02 |
Nộp qua Ebanking |
| 03 |
Nộp qua ATM |
| 04 |
Nộp qua Home Banking |
| 05 |
Nộp qua Mobile Banking |
| 06 |
Nộp qua hình thức điện tử khác |
| 07 |
Nộp qua hình thức phi điện tử khác |
5. XSD Schemas tương ứng
5.1. XSD Schemas Nhận chứng từ từ ĐVTT thực hiện triển khai phối hợp thu LPTB:
Thông tư 110/2015/TT-BTC hướng dẫn giao dịch điện tử trong lĩnh vực thuế Ban hành: 28/07/2015 | Cập nhật: 30/07/2015
Quyết định 115/2009/QĐ-TTg quy định chức năng, nhiệm vụ, quyền hạn và cơ cấu tổ chức của Tổng Cục thuế trực thuộc Bộ Tài chính Ban hành: 28/09/2009 | Cập nhật: 02/10/2009