Cổng Tuân Thủ Nhà Cung Cấp
Nhà cung cấp tải lên các chứng từ. Loại tài liệu, tính hợp lệ và hồ sơ thiếu được nhận diện và hiển thị trên cổng.
- 01 Tiếp nhận
Chứng từ PDF trên cổng
- 02 Nhận diện
OCR và Bố cục
- 03 Phân loại
Loại tài liệu và Tính hợp lệ
- 04 Kiểm tra
Chứng từ thiếu
- 05 Trạng thái
Cổng hiển thị kết quả
- Tình huống ban đầu
- Mua hàng và Chất lượng cần trạng thái theo từng nhà cung cấp, mà không để chứng từ nằm trong hộp thư.
- Kết quả tự động hóa
- Mỗi lần tải lên cung cấp loại tài liệu, ngày hết hạn và trạng thái cổng rõ ràng.
- Đầu vào
-
- Chứng chỉ PDF
- Phiếu giao hàng
- Chứng nhận ISO
- Đầu ra
-
- Loại tài liệu
- Tính hợp lệ
- Chứng từ thiếu
- Trạng thái cổng
Quy trình
- 01Tải lên trình duyệt gửi đến PaperOffice
- 02Khởi động OCR với processing_lane=instant
- 03Hoàn tất công việc qua GET /job/get/{job_id}
- 04Áp dụng IDP-Agent cho cùng chứng từ
- 05Kết xuất trạng thái và trường thiếu trên cổng
- Xác thực
- Khóa công khai (po_pk_)
Chỉ Publishable Key po_pk_ trong trình duyệt. Giới hạn scope vào các công việc OCR và IDP. Đặt danh sách gốc được phép, ngân sách và giới hạn tốc độ. Lên kế hoạch hết hạn và xoay vòng. Không bao giờ đưa po_sk_ ra frontend.
- Hồ sơ MCP
- Điểm cuối
-
POST /job/add/paperoffice_aiocr___generatePOST /documents/idp-agent-runGET /job/get/{job_id}
- Mô-đun
-
- Capture
- OCR
- Classify
- Export
- Quyền hạn
- Scope cho POST /job/add/paperoffice_aiocr___generate và POST /documents/idp-agent-run. Không có quyền XÓA, Quản trị, Hóa đơn hoặc Webhook trên po_pk_.
- Lỗi và phê duyệt
- 401/403: Kiểm tra Key, Scope hoặc Origin. 402: Ngân sách. 429: chờ đợi, không lặp vô hạn. 202: poll cho đến khi completed. Timeout: thử lại một lần, sau đó hủy. Lỗi từng phần: đánh dấu chứng từ là chưa kiểm tra.
- Bảo mật
-
- po_pk_ chỉ với scope OCR/IDP
- Giữ danh sách gốc thật chặt chẽ
- Đặt ngân sách và giới hạn tốc độ
- Xoay Key, không bao giờ xuất po_sk_
Prompt cho Ứng dụng riêng
Trước tiên, hãy đọc đầy đủ:
https://api.paperoffice.ai/latest/docs/llms-full.txt
Nhiệm vụ:
Xây dựng ứng dụng trình duyệt "Cổng tuân thủ nhà cung cấp". Nhà cung cấp tải lên các chứng từ. Ứng dụng nhận dạng loại tài liệu và tính hợp lệ, đồng thời hiển thị trạng thái.
Khung kỹ thuật:
- Base URL: https://api.paperoffice.ai/latest
- Authorization: Bearer po_pk_PUBLISHABLE_KEY
- Origin do trình duyệt đặt. Khóa có giới hạn scope, danh sách cho phép Origin, ngân sách (HTTP 402), giới hạn tốc độ (HTTP 429), TTL tối đa 365 ngày.
- Không sử dụng khóa bí mật (po_sk_) trong trình duyệt. po_pk_ không được thực hiện các hành động DELETE, Admin, Billing hoặc Webhook.
Chỉ sử dụng các điểm cuối sau:
- POST /job/add/paperoffice_aiocr___generate (file multipart, processing_lane=instant, client_wait)
- GET /job/get/{job_id} khi HTTP 202 hoặc hết thời gian chờ client_wait
- POST /documents/idp-agent-run (tải lên hoặc pofid)
Quy trình:
1. Nhận tệp.
2. Khởi tạo công việc OCR.
3. Polling khi nhận 202, không poll vô hạn.
4. Áp dụng IDP cho cùng tài liệu đó.
5. Hiển thị loại tài liệu, tính hợp lệ và các chứng từ còn thiếu trên giao diện người dùng.
Xử lý lỗi: Dừng lại và kiểm tra khóa với 401/403. Hiển thị ngân sách với 402. Backoff với 429. Lặp lại lỗi mạng một lần. Đánh dấu rõ ràng các lỗi từng phần. Không tạo ra các điểm cuối giả, không sử dụng token thật. - iso-9001-acme-2026.pdf
- nhà cung cấp: ACME Components GmbH
- cấp ngày: 2025-03-12, hết hạn: 2026-03-11
Kết quả mong đợi
typ=iso_certificate, supplier=ACME Components GmbH, valid_until=2026-03-11, missing=[], portal_status=complete
Xây dựng hoặc bán giải pháp này với PaperOffice?
Nhà tích hợp và nhà phân phối lại có thể được kết hợp. Bước tiếp theo là hợp tác đối tác — đơn đăng ký và quyết định tức thì sẽ được cung cấp trong ứng dụng PaperOffice.
Bắt đầu hợp tác đối tác