Creare un analizzatore AI personalizzato per il proprio formato di fattura in Power Automate: un flusso di lavoro Dropbox in 3 fasi

UN Modello di analizzatore AI personalizzato Si tratta di uno schema JSON denominato che si definisce nel portale per sviluppatori di PDF4me e che indica all'IA quali campi estrarre da uno specifico tipo di documento. Questa procedura guidata crea un analizzatore per le fatture di abbonamento SaaS di PDF4me (33 campi: blocco indirizzo fornitore, aliquota MWST svizzera, ID abbonamento, voci di riga, dettagli sconto), quindi lo richiama da un flusso Power Automate in 3 fasi che legge un PDF da Dropbox e restituisce un JSON strutturato.

Il incorporato default_invoice_extraction Sebbene lo schema generico copra le fatture generiche, i team di contabilità fornitori reali utilizzano layout specifici per i fornitori, colonne personalizzate per le singole voci, campi fiscali specifici per giurisdizione e metadati di abbonamento che lo schema generico non include. Creando un analizzatore personalizzato una sola volta, si ottiene un'estrazione con corrispondenza esatta per sempre, senza necessità di richiedere l'inserimento di dati per ogni singolo campo o di utilizzare logiche successive per la pulizia della risposta.

Domande e risposte basate sul "perché"​

Cosa riceverai​

Ingresso: Una fattura in formato PDF, nello stesso formato per cui è stato progettato il tuo Analyzer, archiviata su Dropbox. Questa procedura guidata utilizza una fattura di abbonamento SaaS di PDF4me (Ynoox GmbH / Svizzera, IVA 8,1%, metadati di abbonamento, piano Pdf4me Base 1000). Produzione: Una risposta JSON strutturata con tutti i 33 campi dello schema, disponibile come contenuto dinamico di Power Automate per l'azione successiva (scrivere nell'elenco di SharePoint, pubblicare su Slack, aggiungere a Excel Online, inoltrare all'approvazione, ecc.).

Esempio di fattura di input​

Esempio di output JSON (estratto dall'esecuzione reale)​

{
  "documentTitle": "INVOICE",
  "invoiceNumber": "Pdf4me-202601-32324",
  "invoiceDate": "Jan 26, 2026",
  "currency": "USD",
  "paymentStatus": "PAID",
  "vendorName": "Ynoox GmbH",
  "vendorAddress": "Riedstrasse 2B, Hedingen, Zürich 8908, Switzerland",
  "vendorTaxRegNumber": "CHE-360.751.198",
  "billTo": "Chandra Arora",
  "subscriptionId": "2e46662a-32e0-4e79-ba06-b13fe2c113ac",
  "billingPeriodString": "Jan 26 to Feb 26, 2026",
  "nextBillingDate": "Feb 26, 2026",
  "mwstRate": 8.1,
  "discountCode": "F_yn_100!",
  "discountAmount": 35,
  "lineItems": [
    { "description": "Pdf4me Base 1000", "price": 35, "discount": 35, "amount": 0 }
  ]
}

La risposta completa, composta da 33 campi, è scaricabile nella sezione sottostante.

Di cosa hai bisogno​

Lo schema: 33 campi che l'analizzatore estrae​

Lo schema dell'analizzatore è il cuore dell'estrazione personalizzata. Ogni campo dichiara il nome che Power Automate visualizzerà, il tipo che Power Automate riceverà e una descrizione che guida l'IA su dove cercare il valore.

Lo schema JSON completo (con l'esatto fieldDescription le stringhe che l'IA elabora) sono contenute nel file scaricabile qui sopra.

Configurazione A: Come si accede al portale per sviluppatori di PDF4me?​

Dove ti trovi: prima che esista qualsiasi flusso.

1. Aprire dev.pdf4me.com in qualsiasi browser.
2. Inserisci la tua email e la password e fai clic Loginoppure scegli una delle opzioni SSO sulla destra: Continua con Microsoft, Google, Facebook, Mela, GitHub.
3. Sei nuovo qui? Clicca qui Non hai un account? Registrati per crearne uno.

La schermata di accesso​

Configurazione B: Aprire AI Document Parser nella dashboard​

Dove ti trovi: effettuato l'accesso, su dev.pdf4me.com/dashboard.

1. La barra laterale sinistra del pannello di controllo mostra le sezioni del tuo account: Home, Profilo, Abbonamento, Informazioni di pagamento, Chiavi APIRegistri, Fatture, Analizzatore di documenti basato sull'IAI miei documenti, Classifica documento, Analizza documento, Cronologia lavori, Documenti condivisi, Invita un amico, Premi.
2. Fare clic Analizzatore di documenti basato sull'IA.

La barra laterale del cruscotto​

Configurazione C: Come si aggiunge un nuovo modello di analizzatore?​

Dove ti trovi: Pagina del parser di documenti AI.

1. Questa pagina elenca tutti i modelli di analizzatore che hai già creato, con il relativo ID, tipo e azioni di modifica/eliminazione.
2. Fare clic + Aggiungi.
3. Viene visualizzata una riga vuota con due campi:
   • ID analizzatore: digita un nome breve e facile da ricordare (ad esempio Test InvoiceQuesta è la stringa esatta che dovrai inserire come nota di personalizzazione in Power Automate.
   • Tipo di analizzatore: menu a tendina con opzioni Parse E Classify. Scegliere Analizza per l'estrazione strutturata sul campo. Seleziona Classificare quando invece si desidera una decisione di instradamento.
4. Fare clic Salva.

Aggiungi analizzatore​

Configurazione D: Incolla lo schema JSON e salva​

Dove ti trovi: modifica dell'analizzatore appena creato.

1. Fai clic sull'icona di modifica a forma di matita accanto al tuo nuovo Analizzatore (Test Invoice).
2. L'editor Parse Info si apre con l'Analyzer Id in alto e il Schema del documento campo sottostante.
3. Incolla lo schema JSON a 33 campi da analyzer-schema.json nell'area di testo dello schema del documento. Ogni voce è { "fieldName": "...", "fieldType": "...", "fieldDescription": "..." }. IL fieldDescription è il campo più importante, indica all'IA dove guardare e cosa catturare.
4. Scegli un Esempio di tipo di documento preimpostato (Invoice O Purchase Order) se desideri un modello di partenza; altrimenti incolla direttamente il tuo schema.
5. Fare clic Salva le modifiche.

Analizza l'editor dello schema Info​

Flusso 1: Come si collega l'analizzatore a Power Automate?​

Flusso finora: Solo attivazione.

La parte relativa a Power Automate è breve: 3 azioni. Inizia con un trigger manuale per poter iterare; passa a un trigger HTTP/SharePoint/Outlook quando sei pronto per la produzione.

1. In Power Automate clic Creare, scegliere Flusso di nuvole istantaneo.
2. Assegna un nome al flusso (ad esempio Custom Invoice Extraction), scegliere Avviare manualmente un flusso, clicca Creare.

Il flusso completo in 3 fasi​

Tre fasi. L'analisi sintattica dei documenti tramite IA è l'unica fase che richiama PDF4me e occupa la maggior parte del tempo di esecuzione (circa 21 secondi per una fattura di una pagina).

Flusso 2: Scarica il PDF sorgente da Dropbox​

Flusso finora: trigger plus Ottieni il contenuto del file.

1. Fare clic + Nuovo passo, ricerca Dropbox, scegliere Ottieni il contenuto del file utilizzando il percorso.
2. Collegare il tuo account Dropbox, se non l'hai già fatto.
3. Specificare:
   • Percorso del file: /pdf4me.pdf
   • Dedurre il tipo di contenuto: Yes (nelle impostazioni avanzate)

Ottieni la configurazione del contenuto del file​

Flusso 3: Perché il campo Nota di personalizzazione riporta il nome del tuo analizzatore?​

Flusso finora: trigger plus Ottieni contenuto file plus AI - Analizzatore di documenti.

Questa è l'azione che richiama il tuo analizzatore personalizzato. Il trucco è il Nota di personalizzazione campo: incolla il nome ID dell'analizzatore esatto da Setup C (Test Invoice (in questa procedura guidata). Senza di esso, l'azione torna all'estrazione predefinita della fattura.

1. Fare clic + Nuovo passo, ricerca PDF4me, scegliere IA - Analizzatore di documenti.
2. Collegare PDF4me AI con la tua chiave API (solo la prima volta).
3. Specificare:
   • Contenuto del file: scegli il File Content token dal passaggio 2 (Ottieni il contenuto del file)
   • Nome del file: Test.pdf (solo etichetta, non percorso)
   • Nota di personalizzazione (nelle impostazioni avanzate): Test Invoice (l'ID dell'analizzatore esatto che hai impostato nella Configurazione C)
4. Salva e testa.

Azione di analisi del documento tramite IA​

Eseguire il flusso e verificare​

1. Salva il flusso in alto a destra.
2. Fare clic Test, scegliere Manualmente, clicca Test Poi Esecuzione del flusso.
3. Apri i dettagli dell'esecuzione. Tutte e tre le azioni dovrebbero essere verdi. Il passaggio AI - Analizzatore di documenti mostra un corpo JSON nei suoi output.
4. Il corpo della risposta contiene tutti i campi dichiarati dallo schema, popolati a partire dal PDF.

Esempio di risposta da una corsa reale​

Varianti comuni che puoi aggiungere senza dover ricostruire​

Analizzatore personalizzato vs default_invoice_extraction​

Domande frequenti​

Quanto tempo occorre per progettare lo schema?​

Per un formato di fattura familiare (la tua fatturazione SaaS, i tuoi tre fornitori principali), 15-30 minuti per la prima bozza. Leggi una fattura dall'inizio alla fine, elenca ogni campo che il tuo team di contabilità fornitori trascrive manualmente, scrivi una frase fieldDescription per ciascuna etichetta, indica il nome come viene stampata e fornisce un esempio. Quindi, esegui dei test su 3-5 fatture campione e ripeti le modifiche alle descrizioni che risultano errate.

Cosa succede se un campo manca nel documento?​

L'analizzatore restituisce il campo con un valore nullo o vuoto. Non genera errori. La logica di Power Automate a valle dovrebbe gestire i valori mancanti con coalesce() O if(empty(...)) espressioni, soprattutto per i campi obbligatori come invoiceNumber. Questo è lo stesso comportamento di default_invoice_extraction.

Posso gestire le versioni dello schema dell'analizzatore?​

Non ancora nativamente nel portale degli sviluppatori. Il modello consigliato è quello di creare un nuovo ID analista quando si apporta una modifica dello schema incompatibile (Test Invoice v2) e aggiorna la Nota di personalizzazione di Power Automate in modo che punti alla nuova versione. Mantieni attivo il vecchio Analizzatore finché tutti i flussi non saranno stati migrati.

Come fa l'IA a sapere quali campi estrarre per fieldMethod: generate?​

L'IA legge il fieldDescription e i nomi dei campi fratelli allo stesso livello. Per vendorAddress definito come "Complete vendor address (street, city, state, postal code, country). Use comma(,) to separate lines.", l'IA assembla le parti già estratte vendorStreet, vendorCity, vendorState, vendorPostalCode, vendorCountry campi. Nessuna espressione regolare, nessun modello di stringa, nessuna azione successiva richiesta.

L'analizzatore funziona con Power Automate, Make, Zapier e n8n?​

Sì. Una volta pubblicato un ID dell'analizzatore nel portale per sviluppatori, ogni azione di PDF4me AI - Document Parser su qualsiasi piattaforma può farvi riferimento per nome. Crea lo schema una volta, utilizzalo da qualsiasi strumento di automazione e otterrai sempre la stessa struttura di risposta JSON.

Risoluzione dei problemi​

Prossimi passi​

Lo stesso schema "configura una volta, richiama più volte" (definisci Analyzer, incolla lo schema, passa l'ID come nota di personalizzazione) funziona per qualsiasi tipo di documento: ordini di acquisto, contratti, estratti conto bancari, richieste di rimborso medico, dichiarazioni doganali. Definisci un Analyzer per ogni formato, quindi combina e abbina da qualsiasi flusso Power Automate, Make, Zapier o n8n.