Ricetta + Prompt
Portale di Conformità dei Fornitori
I fornitori caricano le prove documentali. Il tipo di documento, la validità e i documenti mancanti vengono riconosciuti e resi visibili nel portale.
- 01 Ingresso
Prova PDF nel portale
- 02 Riconoscimento
OCR e layout
- 03 Classificazione
Tipo di documento e validità
- 04 Verifica
Prove mancanti
- 05 Stato
Il portale mostra il risultato
Implementa come
- Contesto iniziale
- Acquisti e qualità necessitano di uno stato per ogni fornitore, senza che le prove finiscano nelle caselle di posta.
- Risultato automatizzato
- Ogni caricamento fornisce il tipo di documento, la data di scadenza e un chiaro stato del portale.
- Input
-
- PDF certificato
- Bolla di consegna
- Prova ISO
- Output
-
- Tipo di documento
- Validità
- Prove mancanti
- Stato del portale
Fasi
- 01Inviare il caricamento al browser a PaperOffice
- 02Avviare OCR con processing_lane=instant
- 03Completare il job tramite GET /job/get/{job_id}
- 04Applicare l'agente IDP alla stessa prova
- 05Renderizzare lo stato e i campi mancanti nel portale
- Autenticazione
- Chiave pubblicabile (po_pk_)
Solo Publishable Key po_pk_ nel browser. Scope limitato ai job OCR e IDP. Impostare whitelist di origine, budget e rate limit. Pianificare scadenza e rotazione. Mai esporre po_sk_ nel frontend.
- Profilo MCP
- Endpoint
-
POST /job/add/paperoffice_aiocr___generatePOST /documents/idp-agent-runGET /job/get/{job_id}
- Moduli
-
- Capture
- OCR
- Classify
- Export
- Permessi
- Scope per POST /job/add/paperoffice_aiocr___generate e POST /documents/idp-agent-run. Nessun diritto di DELETE, Admin, Billing o Webhook su po_pk_.
- Errori e rilascio
- 401/403: verificare chiave, scope o origine. 402: budget. 429: attendere, non ciclare. 202: polling fino a completed. Timeout: retry una volta, poi interrompere. Errori parziali: segnare la prova come non verificata.
- Sicurezza
-
- po_pk_ solo con scope OCR/IDP
- Mantenere stretta la whitelist di origine
- Impostare budget e rate limit
- Ruotare la chiave, non distribuire mai po_sk_
Prompt per App propria
Leggi prima completamente:
https://api.paperoffice.ai/latest/docs/llms-full.txt
Compito:
Sviluppa un'app browser "Portale Conformità Fornitori". I fornitori caricano le prove documentali. L'app riconosce il tipo di documento e la validità e mostra lo stato.
Struttura:
- Base URL: https://api.paperoffice.ai/latest
- Authorization: Bearer po_pk_PUBLISHABLE_KEY
- L'origine è impostata dal browser. La chiave è limitata per ambito, richiede whitelist di origine, budget (HTTP 402), limite di frequenza (HTTP 429), TTL massimo 365 giorni.
- Nessuna chiave segreta (po_sk_) nel browser. po_pk_ non può eseguire azioni DELETE, Admin, Billing o Webhook.
Solo questi endpoint:
- POST /job/add/paperoffice_aiocr___generate (file multipart, processing_lane=instant, client_wait)
- GET /job/get/{job_id} su HTTP 202 o timeout client_wait
- POST /documents/idp-agent-run (upload o pofid)
Flusso:
1. Ricevi il file.
2. Avvia il lavoro OCR.
3. In caso di 202, effettua polling, non all'infinito.
4. Applica IDP allo stesso documento.
5. Mostra nel UI il tipo di documento, la validità e le prove mancanti.
Errori: 401/403 interrompono e verificano la chiave. 402 mostra il budget. 429 backoff. Ripeti una volta gli errori di rete. Segna visibilmente gli errori parziali. Nessun endpoint inventato, nessun token reale.- iso-9001-acme-2026.pdf
- fornitore: ACME Components GmbH
- emesso: 2025-03-12, valido fino a: 2026-03-11
Risultato atteso
typ=iso_certificate, supplier=ACME Components GmbH, valid_until=2026-03-11, missing=[], portal_status=complete
Costruire o vendere questa soluzione con PaperOffice?
Integratori e rivenditori possono essere combinati. Il prossimo passo è la partnership — candidatura e decisione immediata seguiranno nell'app PaperOffice.
Avvia la partnership