Mobile-ID Sign · TÍCH HỢP VÀ TÀI LIỆU

GoPaperless Gateway — Tài liệu và điều phối ký

Đi từ file, giao dịch và người ký tới prepare/finalize, kết quả và validation; Viewer là lớp giao diện riêng.

Mức bao phủ và điều kiện tích hợp

Tài liệu có dẫn nguồn; mức xác nhận đặc tả, thử nghiệm sandbox và nghiệm thu production là các bước độc lập. Việc đổi phiên bản website không thay thế xác nhận tích hợp.

Xem mức bao phủ của từng operation

Trạng thái theo operation
Operation	Mức tài liệu	Đặc tả	Sandbox
`GET /gateway/view/open/{token}`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`GET /gateway/view/arrangement/{token}`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`GET /gateway/view/signing/{token}`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`GET /gateway/view/signing/batch/{token}`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`GET /gateway/view/signing/sequence/{token}`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`GET /gateway/view/arrangement/sequence/{token}`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`GET /gateway/view/validation/{token}/show`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`GET /gateway/view/configuration/{token}`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`GET /gateway/view/template/{token}`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`POST /gateway/api/signing/users/configure.json`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`GET /gateway/api/signing/users/configure/{token}`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`POST /gateway/api/signing/users/template.json`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`GET /gateway/api/signing/users/template/{token}`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`POST /gateway/api/file/upload`	Trường chọn lọc	Chưa có xác nhận triển khai	Chưa kiểm thử
`GET /gateway/api/file/upload/{token}/status.json`	Trường chọn lọc	Chưa có xác nhận triển khai	Chưa kiểm thử
`POST /gateway/api/file/{token}/delete.json`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`POST /gateway/api/signing/create.json`	Trường chọn lọc	Chưa có xác nhận triển khai	Chưa kiểm thử
`POST /gateway/api/signing/createbatch.json`	Trường chọn lọc	Chưa có xác nhận triển khai	Chưa kiểm thử
`POST /gateway/api/signing/arrangement/createbatch.json`	Trường chọn lọc	Chưa có xác nhận triển khai	Chưa kiểm thử
`POST /gateway/api/signing/{token}/addsigner.json`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`POST /gateway/api/signing/{token}/archive.json`	Trường chọn lọc	Chưa có xác nhận triển khai	Chưa kiểm thử
`POST /gateway/api/signing/{token}/delete.json`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`POST /gateway/api/signing/{token}/removesigner.json`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`GET /gateway/api/signing/{token}/status.json`	Trường chọn lọc	Chưa có xác nhận triển khai	Chưa kiểm thử
`POST /gateway/api/signing/{token}/prepare.json`	Trường chọn lọc	Chưa có xác nhận triển khai	Chưa kiểm thử
`POST /gateway/api/signing/{token}/sign.json`	Trường chọn lọc	Chưa có xác nhận triển khai	Chưa kiểm thử
`POST /gateway/api/signing/{token}/seal.json`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`POST /gateway/api/archive.json`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`POST /gateway/api/file/check.json`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`POST /gateway/api/validation/upload.json`	Trường chọn lọc	Chưa có xác nhận triển khai	Chưa kiểm thử
`GET /gateway/api/validation/{token}/download/detailed-report-pdf`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`GET /gateway/api/validation/{token}/download/diagnostic-data-xml`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`GET /gateway/api/validation/{token}/download/report-pdf`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử
`GET /gateway/api/validation/{token}/download/report-xml`	Danh mục/tham số	Chưa có xác nhận triển khai	Chưa kiểm thử

Tải OpenAPI đúng phạm vi · Tải Postman đọc đặc tả

Gateway và Viewer có vai trò khác nhau

Nguồn: GoPaperless Gateway API Specification v1.261001 và sơ đồ Viewer V.20261008. Danh mục đủ 34 method/path trong Specification; 10 operation có mô hình trường chọn lọc. Vị trí xác thực, request encoding và một số payload chưa đủ rõ để cung cấp tích hợp chạy thật.

OpenAPI JSON OpenAPI YAML Postman Environment

Ranh giới thành phần và trách nhiệm

Trách nhiệm trong hành trình tài liệu
Thành phần	Vai trò	Điều kiện và giới hạn
Ứng dụng nghiệp vụ	Chọn hồ sơ, người ký, thứ tự và quyền đại diện.	Lưu mã tham chiếu và phiên bản tài liệu.
Gateway / Viewer	Gateway điều phối; Viewer hiển thị tài liệu và thao tác người dùng.	Không coi thao tác UI là kết quả backend cuối.
FPS	Chuẩn bị tài liệu và digest; assembling được thể hiện trong luồng SIC.	Bước assembling của luồng VNeID còn cần xác nhận.
RSS / VNeID	Chia sẻ dữ liệu, đăng ký hoặc ký theo từng hành trình.	Kiểm tra citizen ID không phải kiểm chứng chữ ký.
Trusted SIC	Credential, cấp quyền, SAD và chữ ký hash.	Signature data chưa phải tài liệu hoàn chỉnh.

Hành trình tài liệu hoàn chỉnh

1
Tải tài liệu lên
Nhận file token; digest upload là SHA1 trong §4.1.
2
Tạo giao dịch / template
Tạo giao dịch và người ký; phân biệt token file, signing, signer và template.
3
Sắp đặt vị trí / prepare
Xác định vị trí ký và đúng phiên bản tài liệu; prepare trả dtbs/dtbs_hash.
4
Cấp quyền / ký
Dịch vụ ký cấp quyền và tạo signature data theo tuyến riêng.
5
Hoàn tất / đối chiếu
Gateway sign.json hoàn thiện theo contract; đối chiếu trạng thái và file cuối.
6
Kiểm chứng / lưu trữ
Kiểm chứng độc lập, đọc báo cáo; archive/sealing không tự chứng minh bảo quản dài hạn.

Giới hạn 300 MB và danh sách định dạng thuộc phạm vi Specification Gateway. Đây không phải SLA hoặc cam kết tương thích chung cho toàn Mobile-ID Sign. Upload cho validation dùng SHA256 (§9.1), khác upload file để ký.

Đặc tả API có nguồn

POST/gateway/api/file/upload

api/file/upload

Có nguồn · Đặc tả triển khai chưa xác nhận · Chưa kiểm thử sandbox

Nguồn: GoPaperless Gateway API Specification v1.261001 · PDF 18 · Trường logic chọn lọc

Điều kiện: Xác nhận phạm vi triển khai, cách xác thực và quyền sử dụng với Mobile-ID. Giữ token và dữ liệu ký phía máy chủ; không chạy từ trang demo.

Đầu vào — Trường được mô tả

Mô hình tham số logic; encoding của request và vị trí xác thực chưa được xác nhận. Không gửi đối tượng này như payload JSON.

Các trường được biên tập từ nguồn
Trường	Kiểu dữ liệu	Điều kiện	Ý nghĩa và giới hạn
`file[name]`	string	Bắt buộc	Tên file, tối đa 64 ký tự.
`file[digest]`	string	Bắt buộc	SHA1 trong operation upload này; không áp dụng quy tắc SHA256 của validation.
`file[url]`	string	Có điều kiện	Bảng bắt buộc URL nhưng mô tả content Base64 là phương án thay thế; cần xác nhận điều kiện.
`file[content]`	string	Có điều kiện	Nội dung Base64, phương án thay URL.

Kết quả — Trường được mô tả

Các trường được biên tập từ nguồn
Trường	Kiểu dữ liệu	Điều kiện	Ý nghĩa và giới hạn
`status`	string	Tùy chọn	Trạng thái kết quả; ví dụ nguồn ok.
`token`	string	Tùy chọn	Token file đã tải lên; không phải token ký.

Điểm cần xác nhận: GW12-AUTH, GW12-ENCODING, GW12-UPLOAD

GET/gateway/api/file/upload/{token}/status.json

api/file/upload/{token}/status.json

Có nguồn · Đặc tả triển khai chưa xác nhận · Chưa kiểm thử sandbox

Nguồn: GoPaperless Gateway API Specification v1.261001 · PDF 19 · Trường logic chọn lọc

Điều kiện: Xác nhận phạm vi triển khai, cách xác thực và quyền sử dụng với Mobile-ID. Giữ token và dữ liệu ký phía máy chủ; không chạy từ trang demo.

Tham số

Tham số thao tác API
Tên	Vị trí	Bắt buộc	Kiểu dữ liệu
token	path	Có	string

Đầu vào — Trường được mô tả

Mô hình tham số logic; encoding của request và vị trí xác thực chưa được xác nhận. Không gửi đối tượng này như payload JSON.

Phần này mới có danh mục hoặc mô tả kết quả; chưa có cấu trúc dữ liệu đầy đủ để gửi yêu cầu.

Kết quả — Trường được mô tả

Các trường được biên tập từ nguồn
Trường	Kiểu dữ liệu	Điều kiện	Ý nghĩa và giới hạn
`status`	string	Tùy chọn	Trạng thái xử lý file; ví dụ uploaded không phải enum đầy đủ.

Điểm cần xác nhận: GW12-AUTH

POST/gateway/api/signing/create.json

api/signing/create.json

Có nguồn · Đặc tả triển khai chưa xác nhận · Chưa kiểm thử sandbox

Nguồn: GoPaperless Gateway API Specification v1.261001 · PDF 20 · Trường logic chọn lọc

Điều kiện: Xác nhận phạm vi triển khai, cách xác thực và quyền sử dụng với Mobile-ID. Giữ token và dữ liệu ký phía máy chủ; không chạy từ trang demo.

Đầu vào — Trường được mô tả

Mô hình tham số logic; encoding của request và vị trí xác thực chưa được xác nhận. Không gửi đối tượng này như payload JSON.

Các trường được biên tập từ nguồn
Trường	Kiểu dữ liệu	Điều kiện	Ý nghĩa và giới hạn
`type`	string	Bắt buộc	Loại tài liệu được operation hỗ trợ.
`name`	string	Bắt buộc	Tên giao dịch ký.
`signers[0][id]`	string	Bắt buộc	Mã người ký phía gọi.
`signers[0][name]`	string	Bắt buộc	Tên người ký; dùng dữ liệu tổng hợp.
`signers[0][surname]`	string	Bắt buộc	Họ người ký.
`signers[0][email]`	string	Bắt buộc	Email người ký.
`files[0][token]`	string	Bắt buộc	Token file đã tải lên.
`postback_url`	string	Tùy chọn	Điểm nhận postback phía máy chủ.
`process_type`	string · Serial, parallel, individual, custom	Tùy chọn	Loại xử lý trong nguồn; cần xác nhận đơn vị là người ký, tài liệu hay giao dịch.
`template_token`	string	Tùy chọn	Token mẫu, phân biệt với token file và ký.

Kết quả — Trường được mô tả

Phần này mới có danh mục hoặc mô tả kết quả; chưa có cấu trúc dữ liệu đầy đủ để gửi yêu cầu.

Điểm cần xác nhận: GW12-AUTH, GW12-ENCODING, GW12-PROCESS

POST/gateway/api/signing/createbatch.json

api/signing/createbatch.json

Có nguồn · Đặc tả triển khai chưa xác nhận · Chưa kiểm thử sandbox

Nguồn: GoPaperless Gateway API Specification v1.261001 · PDF 26 · Trường logic chọn lọc

Điều kiện: Xác nhận phạm vi triển khai, cách xác thực và quyền sử dụng với Mobile-ID. Giữ token và dữ liệu ký phía máy chủ; không chạy từ trang demo.

Đầu vào — Trường được mô tả

Mô hình tham số logic; encoding của request và vị trí xác thực chưa được xác nhận. Không gửi đối tượng này như payload JSON.

Các trường được biên tập từ nguồn
Trường	Kiểu dữ liệu	Điều kiện	Ý nghĩa và giới hạn
`signings[0][token]`	string	Bắt buộc	Token giao dịch ký đã có.
`signings[0][signer_token]`	string	Bắt buộc	Token theo người ký.

Kết quả — Trường được mô tả

Các trường được biên tập từ nguồn
Trường	Kiểu dữ liệu	Điều kiện	Ý nghĩa và giới hạn
`status`	string	Tùy chọn	Ví dụ nguồn ok.
`token`	string	Tùy chọn	Token nhóm giao dịch.

Điểm cần xác nhận: GW12-AUTH, GW12-ENCODING

POST/gateway/api/signing/arrangement/createbatch.json

api/signing/arrangement/createbatch.json

Có nguồn · Đặc tả triển khai chưa xác nhận · Chưa kiểm thử sandbox

Nguồn: GoPaperless Gateway API Specification v1.261001 · PDF 27 · Trường logic chọn lọc

Điều kiện: Xác nhận phạm vi triển khai, cách xác thực và quyền sử dụng với Mobile-ID. Giữ token và dữ liệu ký phía máy chủ; không chạy từ trang demo.

Đầu vào — Trường được mô tả

Mô hình tham số logic; encoding của request và vị trí xác thực chưa được xác nhận. Không gửi đối tượng này như payload JSON.

Các trường được biên tập từ nguồn
Trường	Kiểu dữ liệu	Điều kiện	Ý nghĩa và giới hạn
`signings[0][token]`	string	Bắt buộc	Token giao dịch ký đã có.

Kết quả — Trường được mô tả

Các trường được biên tập từ nguồn
Trường	Kiểu dữ liệu	Điều kiện	Ý nghĩa và giới hạn
`status`	string	Tùy chọn	Ví dụ nguồn ok.
`token`	string	Tùy chọn	Token nhóm bố trí vị trí.

Điểm cần xác nhận: GW12-AUTH, GW12-ENCODING

POST/gateway/api/signing/{token}/archive.json

api/signing/{token}/archive.json

Có nguồn · Đặc tả triển khai chưa xác nhận · Chưa kiểm thử sandbox

Nguồn: GoPaperless Gateway API Specification v1.261001 · PDF 31 · Trường logic chọn lọc

Điều kiện: Xác nhận phạm vi triển khai, cách xác thực và quyền sử dụng với Mobile-ID. Giữ token và dữ liệu ký phía máy chủ; không chạy từ trang demo.

Tham số

Tham số thao tác API
Tên	Vị trí	Bắt buộc	Kiểu dữ liệu
token	path	Có	string

Đầu vào — Trường được mô tả

Mô hình tham số logic; encoding của request và vị trí xác thực chưa được xác nhận. Không gửi đối tượng này như payload JSON.

Các trường được biên tập từ nguồn
Trường	Kiểu dữ liệu	Điều kiện	Ý nghĩa và giới hạn
`postback_url`	string	Có điều kiện	Bảng bắt buộc trường này nhưng mô tả nhắc URL trước đó; cần xác nhận điều kiện.

Kết quả — Trường được mô tả

Các trường được biên tập từ nguồn
Trường	Kiểu dữ liệu	Điều kiện	Ý nghĩa và giới hạn
`status`	string	Tùy chọn	Ví dụ nguồn ok; không chứng minh bảo quản dài hạn.

Điểm cần xác nhận: GW12-AUTH, GW12-ENCODING, GW12-ARCHIVE

GET/gateway/api/signing/{token}/status.json

api/signing/{token}/status.json

Có nguồn · Đặc tả triển khai chưa xác nhận · Chưa kiểm thử sandbox

Nguồn: GoPaperless Gateway API Specification v1.261001 · PDF 33 · Trường logic chọn lọc

Điều kiện: Xác nhận phạm vi triển khai, cách xác thực và quyền sử dụng với Mobile-ID. Giữ token và dữ liệu ký phía máy chủ; không chạy từ trang demo.

Tham số

Tham số thao tác API
Tên	Vị trí	Bắt buộc	Kiểu dữ liệu
token	path	Có	string

Đầu vào — Trường được mô tả

Mô hình tham số logic; encoding của request và vị trí xác thực chưa được xác nhận. Không gửi đối tượng này như payload JSON.

Phần này mới có danh mục hoặc mô tả kết quả; chưa có cấu trúc dữ liệu đầy đủ để gửi yêu cầu.

Kết quả — Trường được mô tả

Các trường được biên tập từ nguồn
Trường	Kiểu dữ liệu	Điều kiện	Ý nghĩa và giới hạn
`status`	string	Tùy chọn	Các trạng thái nghiệp vụ được mô tả: Pending, completed, archived, failed; JSON nguồn không hợp lệ.
`file`	string	Có điều kiện	URL file cuối khi completed/archived theo nguồn.
`valid_to`	string	Có điều kiện	Giá trị hiệu lực; không suy SLA lưu giữ.

Điểm cần xác nhận: GW12-AUTH, GW12-JSON

POST/gateway/api/signing/{token}/prepare.json

api/signing/{token}/prepare.json

Có nguồn · Đặc tả triển khai chưa xác nhận · Chưa kiểm thử sandbox

Nguồn: GoPaperless Gateway API Specification v1.261001 · PDF 34 · Trường logic chọn lọc

Điều kiện: Xác nhận phạm vi triển khai, cách xác thực và quyền sử dụng với Mobile-ID. Giữ token và dữ liệu ký phía máy chủ; không chạy từ trang demo.

Tham số

Tham số thao tác API
Tên	Vị trí	Bắt buộc	Kiểu dữ liệu
token	path	Có	string

Đầu vào — Trường được mô tả

Mô hình tham số logic; encoding của request và vị trí xác thực chưa được xác nhận. Không gửi đối tượng này như payload JSON.

Các trường được biên tập từ nguồn
Trường	Kiểu dữ liệu	Điều kiện	Ý nghĩa và giới hạn
`signer_id`	string	Bắt buộc	Người ký cần chuẩn bị.
`certificate`	string	Bắt buộc	Chứng thư Base64.

Kết quả — Trường được mô tả

Các trường được biên tập từ nguồn
Trường	Kiểu dữ liệu	Điều kiện	Ý nghĩa và giới hạn
`status`	string	Tùy chọn	Ví dụ nguồn ok.
`dtbs`	string	Tùy chọn	Dữ liệu cần ký.
`dtbs_hash`	string	Tùy chọn	Hash của dữ liệu cần ký.
`algorithm`	string	Tùy chọn	Thuật toán prepare trả về; ví dụ nguồn sha256.

Ví dụ tổng hợp — Không gọi API

{
  "signer_id": "DEMO-SIGNER",
  "certificate": "DEMO-BASE64-CERTIFICATE"
}

Điểm cần xác nhận: GW12-AUTH, GW12-ENCODING

POST/gateway/api/signing/{token}/sign.json

api/signing/{token}/sign.json

Có nguồn · Đặc tả triển khai chưa xác nhận · Chưa kiểm thử sandbox

Nguồn: GoPaperless Gateway API Specification v1.261001 · PDF 34 · Trường logic chọn lọc

Điều kiện: Xác nhận phạm vi triển khai, cách xác thực và quyền sử dụng với Mobile-ID. Giữ token và dữ liệu ký phía máy chủ; không chạy từ trang demo.

Tham số

Tham số thao tác API
Tên	Vị trí	Bắt buộc	Kiểu dữ liệu
token	path	Có	string

Đầu vào — Trường được mô tả

Mô hình tham số logic; encoding của request và vị trí xác thực chưa được xác nhận. Không gửi đối tượng này như payload JSON.

Các trường được biên tập từ nguồn
Trường	Kiểu dữ liệu	Điều kiện	Ý nghĩa và giới hạn
`signer_id`	string	Bắt buộc	Người ký cần hoàn tất.
`signature_value`	string	Bắt buộc	Giá trị chữ ký để hoàn thiện; cần thống nhất cách biểu diễn.

Kết quả — Trường được mô tả

Các trường được biên tập từ nguồn
Trường	Kiểu dữ liệu	Điều kiện	Ý nghĩa và giới hạn
`status`	string	Tùy chọn	Ví dụ nguồn ok; kiểm tra tài liệu cuối riêng.

Điểm cần xác nhận: GW12-AUTH, GW12-ENCODING, GW12-ASSEMBLY

POST/gateway/api/validation/upload.json

api/validation/upload.json

Có nguồn · Đặc tả triển khai chưa xác nhận · Chưa kiểm thử sandbox

Nguồn: GoPaperless Gateway API Specification v1.261001 · PDF 43 · Trường logic chọn lọc

Điều kiện: Xác nhận phạm vi triển khai, cách xác thực và quyền sử dụng với Mobile-ID. Giữ token và dữ liệu ký phía máy chủ; không chạy từ trang demo.

Đầu vào — Trường được mô tả

Mô hình tham số logic; encoding của request và vị trí xác thực chưa được xác nhận. Không gửi đối tượng này như payload JSON.

Các trường được biên tập từ nguồn
Trường	Kiểu dữ liệu	Điều kiện	Ý nghĩa và giới hạn
`file[name]`	string	Bắt buộc	Tên file.
`file[digest]`	string	Bắt buộc	Digest SHA256 của upload để kiểm chứng.
`file[content]`	string	Bắt buộc	Nội dung Base64.
`lang`	string · En, vi	Tùy chọn	Ngôn ngữ báo cáo.
`postback_url`	string	Tùy chọn	Điểm nhận kết quả kiểm chứng phía máy chủ.

Kết quả — Trường được mô tả

Các trường được biên tập từ nguồn
Trường	Kiểu dữ liệu	Điều kiện	Ý nghĩa và giới hạn
`status`	string	Tùy chọn	Ví dụ nguồn ok.
`token`	string	Tùy chọn	Token kiểm chứng.

Ví dụ tổng hợp — Không gọi API

{
  "file[name]": "demo-contract.pdf",
  "file[digest]": "DEMO-SHA256-DIGEST",
  "file[content]": "DEMO-BASE64-DOCUMENT",
  "lang": "en"
}

Điểm cần xác nhận: GW12-AUTH, GW12-ENCODING

Danh mục và mức bao phủ

Danh mục giữ 34 phương thức/đường dẫn từ Gateway Specification v1.261001. Mười operation có mô hình trường logic chọn lọc; encoding và xác thực cần chốt trước khi thực thi.

Operation theo Specification
Phương thức	Đường dẫn	Mức bao phủ	PDF
GET	`/gateway/view/open/{token}`	Danh mục thao tác	8
GET	`/gateway/view/arrangement/{token}`	Danh mục thao tác	8
GET	`/gateway/view/signing/{token}`	Danh mục thao tác	8
GET	`/gateway/view/signing/batch/{token}`	Danh mục thao tác	8
GET	`/gateway/view/signing/sequence/{token}`	Danh mục thao tác	8
GET	`/gateway/view/arrangement/sequence/{token}`	Danh mục thao tác	8
GET	`/gateway/view/validation/{token}/show`	Danh mục thao tác	9
GET	`/gateway/view/configuration/{token}`	Danh mục thao tác	9
GET	`/gateway/view/template/{token}`	Danh mục thao tác	9
POST	`/gateway/api/signing/users/configure.json`	Danh mục thao tác	9
GET	`/gateway/api/signing/users/configure/{token}`	Danh mục thao tác	12
POST	`/gateway/api/signing/users/template.json`	Danh mục thao tác	14
GET	`/gateway/api/signing/users/template/{token}`	Danh mục thao tác	17
POST	`/gateway/api/file/upload`	Trường logic chọn lọc	18
GET	`/gateway/api/file/upload/{token}/status.json`	Trường logic chọn lọc	19
POST	`/gateway/api/file/{token}/delete.json`	Danh mục thao tác	18
POST	`/gateway/api/signing/create.json`	Trường logic chọn lọc	20
POST	`/gateway/api/signing/createbatch.json`	Trường logic chọn lọc	26
POST	`/gateway/api/signing/arrangement/createbatch.json`	Trường logic chọn lọc	27
POST	`/gateway/api/signing/{token}/addsigner.json`	Danh mục thao tác	27
POST	`/gateway/api/signing/{token}/archive.json`	Trường logic chọn lọc	31
POST	`/gateway/api/signing/{token}/delete.json`	Danh mục thao tác	32
POST	`/gateway/api/signing/{token}/removesigner.json`	Danh mục thao tác	32
GET	`/gateway/api/signing/{token}/status.json`	Trường logic chọn lọc	33
POST	`/gateway/api/signing/{token}/prepare.json`	Trường logic chọn lọc	34
POST	`/gateway/api/signing/{token}/sign.json`	Trường logic chọn lọc	34
POST	`/gateway/api/signing/{token}/seal.json`	Danh mục thao tác	37
POST	`/gateway/api/archive.json`	Danh mục thao tác	38
POST	`/gateway/api/file/check.json`	Danh mục thao tác	38
POST	`/gateway/api/validation/upload.json`	Trường logic chọn lọc	43
GET	`/gateway/api/validation/{token}/download/detailed-report-pdf`	Danh mục thao tác	43
GET	`/gateway/api/validation/{token}/download/diagnostic-data-xml`	Danh mục thao tác	44
GET	`/gateway/api/validation/{token}/download/report-pdf`	Danh mục thao tác	44
GET	`/gateway/api/validation/{token}/download/report-xml`	Danh mục thao tác	44

Tách kênh callback, WebSocket và iframe

Kênh và nguồn sự thật
Kênh	Hướng	Cách xử lý
Callback / postback	Service → backend	Lưu kết quả, kiểm tra nguồn gửi theo contract, chống trùng và đối soát.
WebSocket	Backend → frontend	Cập nhật giao diện; mất kết nối phải đọc lại kết quả bền vững. Không đặt event ID chưa có nguồn.
JavaScript iframe	Viewer → host UI	Đối chiếu Paperless/Isign SDK; kiểm tra origin và phiên từ backend, bảo vệ token.
Redirect	UI → browser	Không phải bằng chứng chữ ký hoặc trạng thái cuối.

Điểm cần xác nhận trước tích hợp

GW12-AUTH · Gateway §1–2

Vị trí và loại thông tin xác thực chưa đủ rõ.

Không tạo auth header cho Gateway; thống nhất phía backend.

GW12-ENCODING · Gateway §§4–9

Bảng tham số không xác nhận encoding request.

Mô hình logic nằm trong x-request-model; chưa có requestBody thực thi.

GW12-UPLOAD · Gateway §4.1

File[url] bắt buộc trong bảng nhưng content là phương án thay thế.

Xác nhận điều kiện URL/content và digest SHA1 riêng operation.

GW12-VIEW · Gateway §2.1 và §10.1

View path khác mẫu iframe; signerToken/accessTok khác nhau.

Không xuất URL iframe runnable trước khi xác nhận SDK/path/token.

GW12-JS · Gateway §10.1

Paperless và Isign dùng namespace callback khác nhau.

Không gộp callback thành SDK tự đặt.

GW12-JSON · Gateway §5.8, §10

Một số JSON trạng thái/lỗi không hợp lệ.

Ví dụ biên tập phải ghi rõ; schema signer đầy đủ chưa xác nhận.

GW12-PROCESS · Gateway §5.1 và sơ đồ Viewer

process_type và cách song song/tuần tự trong UI cần đối chiếu đơn vị.

Không đồng nhất WebSocket với chế độ ký song song.

GW12-ARCHIVE · Gateway §5.5

postback_url có điều kiện chưa rõ; archive không chứng minh bảo quản dài hạn.

Xác nhận điều kiện callback và phạm vi lưu trữ.

GW12-ASSEMBLY · Viewer V.20261008, ký VNeID

Sơ đồ VNeID trả signature data rồi tải lại tài liệu, chưa thể hiện assembling.

Đánh dấu bước cần xác nhận; không vẽ mũi tên thực thi tự suy.

FLOW12-TIMEOUT · Viewer, tạo chứng thư SIC, PDF 23

Callback TIMEOUT nhưng WebSocket CANCELED.

Giữ khác biệt, yêu cầu xác nhận mapping.

FLOW12-STATUS · Viewer ký SIC

CANCEL/CANCELED, REJECT/REJECTED thuộc lớp khác nhau.

Không gộp thành enum chung.

Đối chiếu với thao tác trên Viewer

Xem bản ghi đúng tuyến, đọc kết quả và phần lược bỏ, rồi đối chiếu operation. Video không thay contract hoặc báo cáo kiểm chứng.

Xem bảy bản ghi Viewer/VNeID

GoPaperless Gateway — Tài liệu và điều phối ký

Mức bao phủ và điều kiện tích hợp

Gateway và Viewer có vai trò khác nhau

Ranh giới thành phần và trách nhiệm

Hành trình tài liệu hoàn chỉnh

Tải tài liệu lên

Tạo giao dịch / template

Sắp đặt vị trí / prepare

Cấp quyền / ký

Hoàn tất / đối chiếu

Kiểm chứng / lưu trữ

Đặc tả API có nguồn

Đầu vào — Trường được mô tả

Kết quả — Trường được mô tả

Tham số

Đầu vào — Trường được mô tả

Kết quả — Trường được mô tả

Đầu vào — Trường được mô tả

Kết quả — Trường được mô tả

Đầu vào — Trường được mô tả

Kết quả — Trường được mô tả

Đầu vào — Trường được mô tả

Kết quả — Trường được mô tả

Tham số

Đầu vào — Trường được mô tả

Kết quả — Trường được mô tả

Tham số

Đầu vào — Trường được mô tả

Kết quả — Trường được mô tả

Tham số

Đầu vào — Trường được mô tả

Kết quả — Trường được mô tả

Tham số

Đầu vào — Trường được mô tả

Kết quả — Trường được mô tả

Đầu vào — Trường được mô tả

Kết quả — Trường được mô tả

Danh mục và mức bao phủ

Tách kênh callback, WebSocket và iframe

Điểm cần xác nhận trước tích hợp

GW12-AUTH · Gateway §1–2

GW12-ENCODING · Gateway §§4–9

GW12-UPLOAD · Gateway §4.1

GW12-VIEW · Gateway §2.1 và §10.1

GW12-JS · Gateway §10.1

GW12-JSON · Gateway §5.8, §10

GW12-PROCESS · Gateway §5.1 và sơ đồ Viewer

GW12-ARCHIVE · Gateway §5.5

GW12-ASSEMBLY · Viewer V.20261008, ký VNeID

FLOW12-TIMEOUT · Viewer, tạo chứng thư SIC, PDF 23

FLOW12-STATUS · Viewer ký SIC

Đối chiếu với thao tác trên Viewer