Come Importare Documenti nel CRM Automaticamente con l'AI

Il problema: il CRM è sempre incompleto

Il CRM dovrebbe essere la fonte di verità sui clienti e sui fornitori. Ma nella realtà, è sempre incompleto perché aggiornarlo manualmente è lento e noioso:

Il commerciale chiude un contratto → lo scansiona → lo manda in email → nessuno lo carica nel CRM
Arriva una fattura da un nuovo fornitore → viene pagata → il record fornitori nel CRM non viene aggiornato
Un cliente invia un ordine di acquisto → viene evaso → i dati dell'ordine non entrano nel CRM

Il risultato: il CRM contiene informazioni di settimane o mesi fa, e le decisioni commerciali si basano su dati obsoleti.

Cosa si può estrarre da un documento e caricare nel CRM

Tipo documento	Campi estraibili	Dove nel CRM
Contratto	Parti, valore, durata, rinnovo, clausole chiave	Account + Deal/Opportunity
Ordine acquisto	Cliente, prodotti, quantità, prezzi, data consegna	Deal + Line Items
Fattura emessa	Cliente, importo, data, scadenza, stato pagamento	Account + Activity
Preventivo ricevuto	Fornitore, prodotti, prezzi, validità	Company + Deal
DDT in entrata	Fornitore, articoli, quantità, data consegna	Company + Activity

Integrazione con Salesforce

Salesforce è il CRM enterprise più diffuso. L'integrazione con DataUnchain usa le REST API standard con autenticazione OAuth2.

Il flusso di integrazione per una fattura cliente:

AI estrae: ragione sociale cliente, P.IVA, importo, data, numero fattura
Sistema cerca Account in Salesforce per P.IVA (campo TaxId__c)
Se trovato: crea un record Activity collegato all'Account
Se non trovato: crea nuovo Account con i dati estratti e poi l'Activity
Aggiorna campo custom LastInvoiceDate__c sull'Account

Payload esempio inviato a Salesforce:

{
  "object": "Account",
  "upsert_by": "TaxId__c",
  "fields": {
    "Name": "Rossi Forniture S.r.l.",
    "TaxId__c": "IT01234567890",
    "BillingCity": "Milano",
    "LastInvoiceDate__c": "2026-03-15",
    "LastInvoiceAmount__c": 1500.00
  }
}

Integrazione con HubSpot

HubSpot usa le Private App API con token header. Il flusso per un contratto:

Estrazione: parti contraenti, valore annuo, data inizio, data scadenza, tipo servizio
Ricerca Company in HubSpot per P.IVA (proprietà custom)
Creazione o aggiornamento Company con i dati anagrafici
Creazione Deal collegato alla Company con: valore contratto, data chiusura prevista, pipeline stage
Upload del PDF originale come attachment al Deal

🔄 Deduplicazione automatica

Il sistema usa la P.IVA come chiave univoca per la deduplicazione. Se arriva una seconda fattura dello stesso fornitore, non viene creato un duplicato nel CRM — viene aggiornato il record esistente. Per fornitori senza P.IVA (es. persone fisiche), viene usata la combinazione nome+indirizzo con fuzzy matching (Levenshtein distance < 3).

Integrazione con Odoo

Odoo (CRM/ERP open source molto usato in Italia) usa XML-RPC per le integrazioni. L'integrazione è più ricca perché Odoo gestisce sia CRM che contabilità:

Fatture passive → direttamente in account.move (contabilità) con tutte le righe
Contatti/fornitori → res.partner con anagrafica completa
Ordini di acquisto → purchase.order con righe prodotto
DDT → stock.picking per la gestione magazzino

Gestione della qualità dei dati

L'integrazione AI-CRM non è solo "copia e incolla". La qualità del dato è fondamentale:

Validazione pre-import: Prima di scrivere nel CRM, il sistema valida tutti i campi. Una P.IVA con checksum errata non viene mai inserita — meglio un campo vuoto che un dato sbagliato.
Confidence threshold: Solo i documenti con confidence ≥ 85 vengono importati automaticamente. Quelli con confidence 60-84 vanno in revisione umana. Quelli sotto 60 vengono rifiutati con notifica.
Conflict resolution: Se il documento contiene dati che contraddicono quelli già nel CRM (es. indirizzo diverso per la stessa P.IVA), il sistema non sovrascrive automaticamente ma mette il record in revisione manuale con evidenza del conflitto.
Audit trail: Ogni modifica al CRM viene registrata nel log di DataUnchain con: timestamp, documento sorgente, campi modificati, valori precedenti. Tracciabilità completa.

ROI reale: calcolo per una PMI italiana

📊 Scenario: azienda commerciale, 30 dipendenti

Volume mensile: 200 fatture passive, 150 ordini clienti, 50 contratti

Tempo attuale inserimento manuale CRM: 5 min/documento (dati base)

Costo orario operatore: €22/h

Costo manuale mensile: 400 doc × 5 min × €22/60 = €733/mese

Con AI (10% revisione manuale): 40 × 5 min × €22/60 = €73/mese

Risparmio netto: €660/mese = €7.920/anno

+ Miglioramento qualità dati CRM (zero errori di digitazione)

+ CRM aggiornato in tempo reale (non con settimane di ritardo)

+ Recupero crediti più rapido (scadenze sempre aggiornate)

Guida all'implementazione in 5 step

Step 1 — Mappa i documenti

Identifica i 3 tipi di documento che entrano più frequentemente e che contengono dati rilevanti per il CRM. Inizia con il volume più alto.

Step 2 — Configura i campi custom nel CRM

Crea i campi custom necessari (es. P.IVA, codice destinatario SDI su Account in Salesforce). Documenta il mapping: campo estratto → campo CRM.

Step 3 — Test con dati reali

Elabora 50 documenti reali in ambiente di staging. Verifica che i dati arrivino nei campi giusti e che la deduplicazione funzioni correttamente.

Step 4 — Configura soglie e notifiche

Imposta il confidence threshold per l'import automatico (85% consigliato). Configura le notifiche email per i documenti in revisione manuale.

Step 5 — Go-live graduale

Inizia con un tipo documento. Monitora per 2 settimane. Poi aggiungi gli altri tipi. Obiettivo: 90%+ import automatico, <10% revisione manuale.