Liên thông dữ liệu Văn bản

1. TỔNG QUAN

   1.1. Căn cứ xây dựng tài liệu

• Quyết định số 28/2018/QĐ-TTg về việc gửi nhận văn bản điện tử giữa các cơ quan trong hệ thống hành chính nhà nước.

• QCVN 102:2016/BTTTT: Quy chuẩn kỹ thuật quốc gia về cấu trúc mã định danh và định dạng dữ liệu gói tin phục vụ kết nối các hệ thống quản lý văn bản và điều hành.

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

• Trình bày các yêu cầu nghiệp vụ cơ bản cần đáp ứng của các hệ thống QLVBĐH và Trục liên thông văn bản quốc gia theo quyết định số 28/2018/QĐ-TTg về việc gửi nhận văn bản điện tử giữa các cơ quan trong hệ thống hành chính nhà nước.

• Các Bộ, ngành, địa phương dựa trên tài liệu mô tả này để thực hiện triển khai, nâng cấp, chỉnh sửa hệ thống QLVBĐH đáp ứng yêu cầu của quyết định và kết nối, liên thông với Trục liên thông văn bản quốc gia.

1.3. Phạm vi áp dụng

• Tài liệu này là cơ sở để các hệ thống QLVBĐH của Bộ, ngành, địa phương, Trục liên thông văn bản quốc gia nâng cấp, chỉnh sửa, bổ sung đáp ứng theo quy định tại quyết định 28/2018/QĐ-TTg.

2. CÁC QUY TRÌNH NGHIỆP VỤ

2.1. Nghiệp vụ gửi, nhận văn bản điện tử

• • Cần có theo QĐ 28/2018/QĐ-TTg, ngày 12/7/2018.

Văn bản điện tử sau khi được cấp có thẩm quyền phê duyệt, ký ban hành, ký số theo quy định của pháp luật và gửi đến Bên nhận thông qua các hệ thống QLVBĐH được kết nối, liên thông với nhau qua Trục liên thông văn bản quốc gia.

2.1.1 Yêu cầu chức năng hệ thống QLVBĐH

1. Hệ thống QLVBĐH Bên gửi:

• • Gửi được văn bản điện tử qua Trục liên thông văn bản quốc gia.

• • Có thể kiểm tra, theo dõi để biết văn bản điện tử đã được gửi đến đúng Bên nhận hay chưa trong thời gian cho phép đối với mỗi văn bản.

• • Theo dõi được các trạng thái của văn bản điện tử đã gửi đi: trạng thái gửi, nhận (Đã đến, Đã tiếp nhận), trạng thái xử lý (Đang xử lý, Đã hoàn thành), kèm theo các thông tin về thời gian, tên người, chức danh.

• • Có thể thực hiện tác nghiệp khác khi cần thiết đối với văn bản đã gửi: thu hồi, cập nhật, thay thế, lấy lại văn bản.

• • Nhận được các gói tin thông báo từ Trục: thông báo sự cố, quá hạn tiếp nhận...
• • Quản lý được tình hình gửi, nhận văn bản điện tử qua Trục thông qua hệ thống báo cáo tổng hợp gửi, nhận (đáp ứng các thông tin đã có liên quan văn bản) và các báo cáo chi tiết theo từng văn bản cụ thể.

2. Hệ thống QLVBĐH Bên nhận:

• • Nhận được văn bản điện tử qua Trục liên thông văn bản quốc gia.

• • Sau khi tiếp nhận, xử lý và phản hồi trạng thái xử lý văn bản điện tử (thời gian, vị trí, đơn vị, tên người, chức danh, trạng thái: Đang xử lý, Đã hoàn thành)

trên hệ thống QLVBĐH, chuyển qua Trục liên thông văn bản quốc gia cho Bên gửi.

• Từ chối nhận, trả lại văn bản điện tử, nếu văn bản điện tử đó không bảo đảm các nguyên tắc, yêu cầu về gửi, nhận văn bản điện tử; đánh dấu văn bản trả lại, cập nhật trạng thái và lý do trả lại; phản hồi kịp thời cho Bên gửi;

• Nhận được các gói tin thông báo từ Trục: thông báo sự cố, quá hạn tiếp nhận...

• Quản lý được tình hình gửi, nhận văn bản điện tử qua Trục thông qua hệ thống báo cáo tổng hợp gửi, nhận (đáp ứng các thông tin đã có liên quan văn bản) và các báo cáo chi tiết theo từng văn bản cụ thể.

2.1.2. Yêu cầu đối với trục

• Trục nhận các gói tin liên thông từ Bên gửi và gửi lại các gói tin đó cho Bên nhận, đồng thời lưu vết lại logs gửi nhận văn bản điện tử đi qua trục.
• Trục cần có chức năng thông báo sự cố, quá hạn tiếp nhận văn bản, cụ thể các trường hợp:
• Hệ thống Bên nhận bị lỗi, không thể lấy gói tin liên thông: Trục thông báo sự cố tới Bên gửi qua email, qua chức năng nhận thông báo sự cố. Khi gửi thông báo thành công, Trục đánh dấu để Bên nhận không nhận lại văn bản điện tử. Bên nhận muốn nhận lại văn bản điện tử thì đăng nhập lại vào trang quản trị cập nhật cờ trạng thái cho phép gửi lại văn bản điện tử tới bên nhận.

• Bên nhận tiếp nhận, nhưng quá hạn quy định của gói tin: Trục gửi thông báo tới email, chức năng nhận thông báo cho cả Bên gửi, Bên nhận để biết về việc quá hạn tiếp nhận.

3. Hỗ trợ kỹ thuật, mô tả chi tiết API

3.1 Gửi văn bản

- Đường dẫn: http://lgsp.ungdungtructuyen.vn/RestService/forward/Integration/sendEdoc

- Method: POST

- Pre-request Script: xác thực tài khoản người dùng trước khi thực hiện lấy dữ liệu

o   userName: tài khoản

o   password: mật khẩu

o   secretKey: khóa bí mật

const moment = require('moment');

var Header = require('postman-collection').Header

var userName = 'yourUsername';

var password = 'yourPassword';

var secretKey = 'yourSecretKey';

const user = btoa(`${userName}:${password}`)

var ts = moment().unix()*1000;

pm.request.headers.add(new Header('Timestamp:'+ ts));

pm.request.headers.add(new Header('secretKey:'+ secretKey));

pm.request.headers.add(new Header(`Authorization: Basic ${user}`));

-   Input:

-   Output:

3.2 Nhận văn bản

- Đường dẫn: http://lgsp.ungdungtructuyen.vn//RestService/forward/Integration/getEdoc

- Method: POST

- Pre-request Script: xác thực tài khoản người dùng trước khi thực hiện lấy dữ liệu

o   userName: tài khoản

o   password: mật khẩu

o   secretKey: khóa bí mật

const moment = require('moment');

var Header = require('postman-collection').Header

var userName = 'yourUsername';

var password = 'yourPassword';

var secretKey = 'yourSecretKey';

const user = btoa(`${userName}:${password}`)

var ts = moment().unix()*1000;

pm.request.headers.add(new Header('Timestamp:'+ ts));

pm.request.headers.add(new Header('secretKey:'+ secretKey));

pm.request.headers.add(new Header(`Authorization: Basic ${user}`));

-   Input:

-   Output: