Quickstart theo tuyến tích hợp

Tích hợp GoPaperless Gateway

Đây là hướng dẫn đọc contract, chưa phải chương trình gọi API thật. Khi mất phản hồi, giữ yêu cầu và mã liên kết rồi đối soát trước khi tạo lại.

Tích hợp RSS / RS-HUB

Đây là hướng dẫn đọc contract, chưa phải chương trình gọi API thật. Khi mất phản hồi, giữ yêu cầu và mã liên kết rồi đối soát trước khi tạo lại.

Tích hợp Trusted SIC

Đây là hướng dẫn đọc contract, chưa phải chương trình gọi API thật. Khi mất phản hồi, giữ yêu cầu và mã liên kết rồi đối soát trước khi tạo lại.

Mô hình tham chiếu; chưa phải hợp đồng API vận hành thực tế. Ví dụ chỉ dùng dữ liệu giả lập.

1. 1. Chuẩn bị hồ sơ

   Chốt phiên bản tài liệu và người có quyền ký tại hệ thống nguồn.

2. 2. Tạo giao dịch

   Dùng document_ref, signer_ref, purpose và route của ví dụ tham chiếu.

3. 3. Lưu và theo dõi

   Lưu transaction_id khi nhận 202; chưa đánh dấu hoàn tất.

4. 4. Cấp quyền người dùng

   Người dùng xem tài liệu và quyết định theo tuyến triển khai được duyệt.

5. 5. Nhận kết quả

   Theo dõi trạng thái hoặc sự kiện đã xác thực; chống xử lý trùng.

6. 6. Kiểm chứng và bàn giao

   Kiểm chứng trong hệ thống thật; lưu kết quả và bằng chứng tại hệ thống nguồn.

POST /v1/signing-transactions
{
  "document_ref": "doc_demo_001",
  "signer_ref": "subject_demo_001",
  "purpose": "contract-approval",
  "route": "AUTO"
}

202 Accepted
{
  "transaction_id": "sig_txn_demo_001",
  "state": "WAITING_USER_ACTION",
  "model_status": "SIMULATED_ONLY"
}

Nếu mất phản hồi sau khi tạo, giữ hồ sơ nguồn và chuyển sang đối soát. Không tự tạo lại ý định ký.

Thực hành đối soát an toàn tại máy

Ví dụ Python dưới đây chạy bằng thư viện chuẩn, dùng mô hình sổ theo dõi tổng hợp. Không gửi request mạng, không ký mật mã và không mô phỏng response của một API dịch vụ.

python3 reconciliation_demo.py