Data Alchemy — Software IDP con AI
Funzionalità · licenze Business ed Enterprise

External fields: i dati letti dall'AI verificati sui tuoi sistemi

Leggere bene un documento non basta: il dato deve essere coerente con quello che hai già nel gestionale. Con gli external fields, durante la scansione Data Alchemy interroga servizi esterni — per esempio il tuo ERP tramite l'Agente AI o via API — recupera i dati a cui il documento rimanda e li confronta con quelli letti dall'AI, prima che il documento prosegua.

Disponibilità: inclusi nelle licenze Business ed Enterprise. Non disponibili nella licenza Basic, e quindi nemmeno nella Demo, che ne è la prova gratuita.

Che cosa sono

Cosa sono gli external fields

Gli external fields sono campi di un modello documentale il cui valore non si ferma a quanto scritto sul documento: Data Alchemy li usa per interrogare un servizio esterno del cliente e confrontare il documento con i dati collegati. L'esempio tipico è il DDT che riporta il riferimento all'ordine d'acquisto: Data Alchemy consulta l'ERP, tramite l'Agente AI o via API, recupera l'ordine e verifica riga per riga codice articolo, quantità e gli altri campi.

La differenza con la remote validation è nello scopo. Gli external fields arricchiscono e confrontano il documento con i dati esterni a cui il documento stesso rimanda (l'ordine richiamato sul DDT). La remote validation verifica o risolve singoli valori contro un'anagrafica: un codice articolo che deve esistere, un codice cliente da ricavare dalla ragione sociale. Le due funzionalità si usano spesso insieme e sono incluse nelle stesse licenze.

Come funziona

Come funzionano gli external fields durante la lettura

Gli external fields si configurano nel modello documentale: per i campi indicati, a ogni documento letto Data Alchemy interroga la fonte collegata e usa o segnala il risultato del confronto.

  1. 01Lettura AIIl motore AI del modello legge il documento, per esempio un DDT, ed estrae testata e righe, compreso il riferimento all'ordine d'acquisto.
  2. 02Richiesta al tuo sistemaPer i campi configurati come external fields Data Alchemy interroga il servizio esterno, per esempio l'ERP tramite l'Agente AI o via API, e recupera l'ordine richiamato.
  3. 03Confronto riga per rigaCodice articolo, quantità e gli altri campi letti dall'AI vengono confrontati con quelli dell'ordine recuperato.
  4. 04Dato coerente o segnalatoSe i dati coincidono il documento prosegue; se non coincidono la differenza viene segnalata per la verifica.
Schema semplificato: il documento letto dall'AI viene confrontato con i dati esterni a cui rimanda, prima di proseguire nel flusso.

1. Configuri i campi nel modello

Nel modello documentale si indica quali campi sono external fields e quale servizio esterno interrogare: per un DDT, il riferimento all'ordine d'acquisto da cercare nell'ERP.

2. L'AI legge il documento

Il motore AI abbinato al modello estrae i dati dal documento, come per ogni altro campo: numero, data, riferimenti, righe con codici e quantità.

3. Data Alchemy interroga il servizio esterno

Durante la scansione Data Alchemy contatta il sistema del cliente — tipicamente l'ERP, tramite l'Agente AI o via API — e recupera i dati collegati al documento, per esempio il contenuto dell'ordine d'acquisto.

4. Confronto e segnalazione

Il dato letto dall'AI viene verificato su quello del gestionale, riga per riga: ciò che è coerente prosegue, le differenze vengono segnalate invece di finire nel gestionale.

Quando la fonte è il tuo gestionale, la consultazione passa dall'Agente AI — installato presso di te, con le credenziali del gestionale nel tuo perimetro — oppure dalle API del tuo sistema. Vedi anche l'integrazione con l'ERP.

Nella piattaforma

Com'è fatto nella piattaforma

Un external field configurato su un modello per i DDT: la ricerca dell'ordine d'acquisto richiamato dal documento.

Configurazione JSON di un external field in Data Alchemy: chiave API oscurata, indirizzo di ricerca degli ordini d'acquisto e parametri numeroOrdine, da DA-RifOrdine, e codiceArticolo o codiceArticoloFornitore, dai codici articolo letti
La configurazione collega il riferimento ordine e i codici articolo letti dal documento all'API degli ordini d'acquisto: i dati dell'ordine restituiti, come quantità ordinate e prezzi, vengono poi confrontati con quelli letti. La chiave API è oscurata.
Casi d'uso

Dove servono gli external fields

Ogni volta che un documento richiama un altro documento già presente nei tuoi sistemi, gli external fields permettono di verificarlo prima di registrarlo.

DDT confrontato con l'ordine d'acquisto

Leggendo un DDT che riporta il riferimento all'ordine d'acquisto, Data Alchemy recupera l'ordine dall'ERP e verifica riga per riga codice articolo, quantità e gli altri campi: la merce ricevuta è confrontata con quella ordinata.

Fattura fornitore e documenti collegati

Quando la fattura richiama un ordine o un DDT, il confronto con i dati del gestionale supporta la riconciliazione a tre vie fattura-ordine-DDT, con le differenze segnalate prima della registrazione.

Coerenza del dato prima del gestionale

Il dato letto dall'AI e quello già presente nell'ERP vengono allineati durante la scansione: nel gestionale non entrano quantità o codici che contraddicono il documento di riferimento.

Eccezioni al posto dei controlli a campione

Invece di ricontrollare a mano ogni riga, l'operatore guarda solo i documenti in cui il confronto con i dati esterni ha trovato una differenza.

Caso cliente

Caso Agribologna: codici articolo delle righe verificati sull'AS400

Presso Agribologna gli external fields sono collegati al gestionale AS400 e lavorano sulle righe dei documenti, principalmente sui codici articolo. I codici cliente, invece, sono verificati dalla remote validation partendo dalla ragione sociale. Leggi il caso Agribologna.

Licenze

In quali licenze sono disponibili gli external fields

Gli external fields sono inclusi a partire dalla licenza Business, insieme alla remote validation e al Servizio mail.

Licenza Enterprise

Inclusi

Inclusi, con tutto ciò che offre la licenza Business, l'integrazione nativa con Salesforce, l'Order Dispatcher e l'Agente AI.

Licenza Business

Inclusi

Inclusi insieme alla remote validation e al Servizio mail; l'Agente AI è disponibile come opzione quotata a parte.

Licenza Basic

Non disponibili

La licenza Basic copre la lettura dei documenti con 1 modello e crediti a consumo, senza verifica sui sistemi esterni.

Demo (prova della Basic)

Non inclusi

La Demo è la licenza Basic di prova: 10 giorni, 10 documenti, 1 modello tra i predefiniti. Per vedere gli external fields sui tuoi flussi pianifica una call.

Confronta le licenze nella pagina prezzi e licenze oppure richiedi un preventivo.

Approfondimenti

Funzionalità e pagine collegate

  • Remote validationVerifica dei codici articolo e recupero del codice cliente o fornitore dall'anagrafica.
  • Agente AIIl componente installato presso di te che rende consultabili i dati del gestionale e registra i dati estratti nell'ERP o nel CRM.
  • Riconciliazione a tre vieFattura, ordine e DDT confrontati in automatico, con le anomalie segnalate.
  • Modelli documentaliDove si configurano i campi da leggere, compresi gli external fields.
Domande frequenti

External fields: domande frequenti

Cosa sono gli external fields di Data Alchemy?

Sono campi del modello documentale per cui Data Alchemy, durante la scansione, interroga un servizio esterno del cliente — per esempio l'ERP, tramite l'Agente AI o via API — per verificare i dati letti dall'AI. Leggendo un DDT con il riferimento all'ordine d'acquisto, la piattaforma recupera l'ordine e verifica riga per riga codice articolo, quantità e gli altri campi.

Che differenza c'è tra external fields e remote validation?

Gli external fields confrontano il documento con i dati esterni a cui il documento rimanda, come l'ordine d'acquisto richiamato su un DDT. La remote validation verifica o risolve singoli valori contro un'anagrafica: controlla che un codice articolo esista o recupera il codice cliente o fornitore a partire da ragione sociale o partita IVA. Sono incluse nelle stesse licenze, Business ed Enterprise.

Come si collega Data Alchemy al mio ERP per gli external fields?

Quando la fonte è il tuo gestionale, la consultazione passa dall'Agente AI oppure via API. L'Agente AI è installato presso di te, si collega a Data Alchemy via websocket e API e legge i dati dell'ERP o del CRM da database, file CSV, JSON o TXT oppure API, con le credenziali del gestionale che restano nel tuo perimetro. In alternativa Data Alchemy interroga direttamente le API che il tuo sistema espone. L'Agente AI è incluso in Enterprise e disponibile come opzione quotata a parte in Business.

Cosa succede se i dati non coincidono?

Se quanto letto dall'AI non coincide con i dati recuperati dal sistema esterno, la differenza viene segnalata invece di proseguire come dato valido: l'operatore verifica solo quei documenti, non tutti.

In quali licenze sono inclusi gli external fields?

Sono inclusi nelle licenze Business ed Enterprise. Non sono disponibili nella licenza Basic né nella Demo, che è la licenza Basic di prova gratuita.

Verifica i tuoi documenti sui dati che hai già

Attiva la Demo gratuita per provare la lettura AI dei tuoi documenti, oppure pianifica una call per vedere gli external fields collegati al tuo gestionale.