CRMconnect Azuvio · Docs

ParsePilot

Sezione: CRM URL: /admin/parsepilot Titolo pagina: ParsePilot

Panoramica

ParsePilot è un modulo di analisi documenti basato su intelligenza artificiale che utilizza l'API OpenAI per estrarre dati strutturati da file caricati — PDF e immagini — e mappare automaticamente i valori estratti nei record CRMconnect. Il personale carica una fattura scansionata, una ricevuta o un documento simile tramite un'interfaccia modale; ParsePilot invia il file a OpenAI, riceve i campi analizzati e precompila il modulo pertinente in modo che il record possa essere rivisto e salvato senza inserimento manuale dei dati.

Il modulo supporta file fino a 500 MB, accetta PDF e formati immagine comuni (PNG, JPG, JPEG, WebP, TIFF), e può essere limitato a pagine o tipi di documento specifici tramite il pannello impostazioni. Una soglia di confidenza opzionale filtra le estrazioni di campi a bassa confidenza prima che raggiungano l'utente.

Valore aziendale

Inserire manualmente i dati da fatture fornitori, ricevute o altri documenti in entrata nel CRM è lento e soggetto a errori. ParsePilot elimina la maggior parte di questo lavoro convertendo una scansione caricata in un modulo precompilato in pochi secondi, consentendo al personale di concentrarsi sulla revisione e approvazione piuttosto che sulla digitazione.

  • Chi lo utilizza: Personale finanziario e di back-office che elabora documenti in entrata (fatture, ordini di acquisto, ricevute); amministratori che configurano la connessione OpenAI e le autorizzazioni di pagina.
  • Vantaggio chiave: Estrazione dati basata su IA da documenti scansionati o digitali direttamente nei moduli CRMconnect, riducendo i tempi di inserimento manuale e gli errori di input.

Casi d'uso tipici:

  • Caricare un PDF di fattura fornitore; ParsePilot estrae nome fornitore, data, voci e totali, quindi precompila il modulo spese o acquisto.
  • Caricare una foto di una ricevuta e fare estrarre automaticamente l'importo e la data.
  • Limitare l'analisi documenti a pagine CRMconnect specifiche (es. solo sulle schermate fatture o spese) tramite il pannello impostazioni.
  • Impostare una soglia di confidenza in modo che vengano accettate solo le estrazioni di campi ad alta confidenza — i valori incerti vengono lasciati vuoti per la revisione manuale.
  • Abbinare un'aliquota IVA/fiscale analizzata a un record fiscale esistente in CRMconnect usando l'endpoint di ricerca fiscale integrato.

Accesso al modulo

/admin/parsepilot/settings — la pagina impostazioni è il punto di accesso principale (il percorso indice restituisce 404). L'interfaccia modale è incorporata nelle pagine dove l'analisi è abilitata e non è accessibile direttamente tramite URL.

Solo gli amministratori possono accedere alla pagina impostazioni e salvare la configurazione. Il personale con il permesso di creazione parsepilot può avviare l'analisi documenti dal modale.

Concetti chiave

Concetto Descrizione
Chiave API OpenAI La chiave segreta utilizzata per autenticare le chiamate al servizio OpenAI per l'analisi documenti.
Tipo di documento La categoria del documento da analizzare (es. invoice). Determina quali campi l'IA tenta di estrarre.
Soglia di confidenza Un valore tra 0,0 e 1,0. I campi estratti al di sotto di questo punteggio vengono eliminati prima della presentazione all'utente.
Pagine abilitate Un elenco separato da virgole di identificatori di pagina CRMconnect dove il modale ParsePilot è disponibile.
Lingue Suggerimento/i passato/i all'IA indicante/i la/e lingua/e prevista/e dei documenti caricati, migliorando la precisione dell'estrazione.
Modale di analisi L'overlay nella pagina attivato nelle pagine abilitate che consente al personale di caricare un file e rivedere i campi estratti.
Ricerca fiscale Una chiamata API interna (/admin/parsepilot/find_tax_by_rate) che abbina un'aliquota fiscale analizzata a un record fiscale esistente nel database.
Formati supportati PDF e file immagine (PNG, JPG, JPEG, WebP, TIFF e altri tipi MIME corrispondenti a image/*).
Dimensione massima upload 500 MB per file.

Azioni comuni

  1. Configurare la chiave OpenAI — Andare su /admin/parsepilot/settings, inserire la chiave API OpenAI, impostare la/e lingua/e prevista/e del documento e salvare.
  2. Impostare una soglia di confidenza — Nelle impostazioni, inserire un valore decimale tra 0 (accetta tutto) e 1 (solo estrazioni perfettamente certe). I valori al di fuori di questo intervallo vengono limitati automaticamente.
  3. Abilitare l'analisi su pagine specifiche — Nelle impostazioni, selezionare o inserire gli identificatori di pagina CRMconnect dove il modale ParsePilot deve apparire, quindi salvare.
  4. Analizzare un documento — Su una pagina abilitata (es. nuova fattura), fare clic sull'icona o sul pulsante ParsePilot per aprire il modale, caricare un PDF o un'immagine e attendere che l'IA restituisca i campi estratti. Rivedere i valori precompilati, apportare correzioni se necessario, quindi salvare il record normalmente.
  5. Rivedere i campi a bassa confidenza — I campi che scendono al di sotto della soglia di confidenza configurata non vengono precompilati; il personale deve inserirli manualmente, il che è un passaggio deliberato di controllo della qualità.
  6. Abbinare un'aliquota fiscale analizzata — ParsePilot chiama automaticamente l'endpoint di ricerca fiscale per trovare un'aliquota IVA corrispondente in CRMconnect e collegarla alle voci analizzate; se non viene trovata alcuna corrispondenza, viene mostrato un errore di mancata corrispondenza e il campo fiscale deve essere selezionato manualmente.

Fonte: crm-connect-main/app/modules/parsepilot