ParsePilot

Secțiune: CRM
URL: /admin/parsepilot
Titlu pagină: ParsePilot

Prezentare generală

ParsePilot este un modul de parsare a documentelor bazat pe AI care utilizează API-ul OpenAI pentru a extrage date structurate din fișiere încărcate — PDF-uri și imagini — și a mapa automat valorile extrase în înregistrările CRMConnect. Personalul încarcă o factură scanată, un bon sau un document similar printr-o interfață modală; ParsePilot trimite fișierul la OpenAI, primește câmpurile parsate și pre-completează formularul relevant pentru ca înregistrarea să poată fi revizuită și salvată fără introducere manuală de date.

Modulul acceptă fișiere de până la 500 MB, acceptă PDF și formate comune de imagine (PNG, JPG, JPEG, WebP, TIFF) și poate fi restricționat la pagini sau tipuri de documente specifice prin panoul de setări. Un prag de confidență opțional filtrează extragerile de câmpuri cu confidență scăzută înainte ca acestea să ajungă la utilizator.

Valoare pentru business

Introducerea manuală a datelor din facturile furnizorilor, bonuri sau alte documente primite în CRM este lentă și predispusă la erori. ParsePilot elimină cea mai mare parte a acestei munci convertind o scanare încărcată într-un formular pre-completat în câteva secunde, permițând personalului să se concentreze pe revizuire și aprobare în loc să tasteze.

Cine îl utilizează: Personalul de finanțe și back-office care procesează documente primite (facturi, comenzi de achiziție, bonuri); administratorii care configurează conexiunea OpenAI și permisiunile de pagină.
Beneficiu principal: Extragere de date bazată pe AI din documente scanate sau digitale direct în formularele CRMConnect, reducând timpul de introducere manuală și erorile de introducere.

Cazuri de utilizare tipice:

Încărcați un PDF cu factura unui furnizor; ParsePilot extrage denumirea furnizorului, data, elementele din linie și totalurile, apoi pre-completează formularul de cheltuieli sau achiziție.
Încărcați o fotografie a unui bon și extrageți automat suma și data.
Restricționați parsarea documentelor la pagini specifice CRMConnect (ex: doar pe ecranele de facturi sau cheltuieli) prin panoul de setări.
Setați un prag de confidență astfel încât să fie acceptate doar extragerile de câmpuri cu confidență ridicată — valorile incerte sunt lăsate necompletate pentru revizuire manuală.
Potriviți o cotă TVA/fiscală parsată cu o înregistrare fiscală existentă în CRMConnect folosind endpoint-ul de căutare fiscală integrat.

Accesarea modulului

/admin/parsepilot/settings — pagina de setări este punctul principal de intrare (ruta de index returnează 404). Interfața modală este încorporată pe paginile unde parsarea este activată și nu este accesată direct prin URL.

Doar administratorii pot accesa pagina de setări și pot salva configurația. Personalul cu permisiunea de creare parsepilot poate declanșa parsarea documentelor din modal.

Concepte cheie

Concept	Descriere
Cheie API OpenAI	Cheia secretă utilizată pentru autentificarea apelurilor către serviciul OpenAI pentru parsarea documentelor.
Tip document	Categoria documentului care se parsează (ex: `invoice`). Determină ce câmpuri încearcă AI-ul să extragă.
Prag de confidență	O valoare între 0.0 și 1.0. Câmpurile extrase sub acest scor sunt eliminate înainte de prezentarea către utilizator.
Pagini activate	O listă separată prin virgulă de identificatori de pagini CRMConnect unde modalul ParsePilot este disponibil.
Limbi	Indicii transmise AI-ului privind limbile așteptate ale documentelor încărcate, îmbunătățind acuratețea extragerii.
Modal de parsare	Suprapunerea în pagină declanșată pe paginile activate care permite personalului să încarce un fișier și să revizuiască câmpurile extrase.
Căutare fiscală	Un apel API intern (`/admin/parsepilot/find_tax_by_rate`) care potrivește o cotă fiscală parsată cu o înregistrare fiscală existentă în baza de date.
Formate acceptate	PDF și fișiere imagine (PNG, JPG, JPEG, WebP, TIFF și alte tipuri MIME corespunzătoare `image/*`).
Dimensiune maximă încărcare	500 MB per fișier.

Acțiuni frecvente

Configurați cheia OpenAI — Mergeți la /admin/parsepilot/settings, introduceți cheia API OpenAI, setați limba(ile) așteptată(e) a documentului și salvați.
Setați un prag de confidență — În setări, introduceți o valoare zecimală între 0 (acceptă toate) și 1 (doar extragerile cu confidență perfectă). Valorile în afara acestui interval sunt ajustate automat.
Activați parsarea pe pagini specifice — În setări, selectați sau introduceți identificatorii de pagini CRMConnect unde modalul ParsePilot ar trebui să apară, apoi salvați.
Parsați un document — Pe o pagină activată (ex: factură nouă), faceți clic pe iconița sau butonul ParsePilot pentru a deschide modalul, încărcați un PDF sau imagine și așteptați ca AI-ul să returneze câmpurile extrase. Revizuiți valorile pre-completate, efectuați corecțiile necesare, apoi salvați înregistrarea normal.
Revizuiți câmpurile cu confidență scăzută — Câmpurile care se situează sub pragul de confidență configurat nu sunt pre-completate; personalul trebuie să le introducă manual, ceea ce reprezintă un pas deliberat de control al calității.
Potriviți o cotă fiscală parsată — ParsePilot apelează automat endpoint-ul de căutare fiscală pentru a găsi o cotă TVA corespunzătoare în CRMConnect și a o lega de elementele din linie parsate; dacă nu se găsește nicio potrivire, este afișată o eroare de negăsire și câmpul fiscal trebuie selectat manual.

Tip

Setați pragul de confidență la 0.7 sau mai mare înainte de lansare — câmpurile extrase sub acel scor rămân necompletate pentru revizuire manuală, acționând ca o poartă de calitate care împiedică valorile cu confidență scăzută să intre în înregistrări în tăcere.

Warning

ParsePilot necesită propria cheie API OpenAI — fiecare document parsat implică un cost în contul dvs. OpenAI. Monitorizați utilizarea API în dashboard-ul OpenAI după activarea integrării pentru a evita costuri neașteptate pe fluxuri de documente cu volum mare.

Sursă: crm-connect-main/app/modules/parsepilot