{"id":38450,"date":"2026-04-17T14:33:15","date_gmt":"2026-04-17T12:33:15","guid":{"rendered":"https:\/\/help.qualiware.it\/qw-help\/?p=38450"},"modified":"2026-04-17T15:09:54","modified_gmt":"2026-04-17T13:09:54","slug":"guida-alla-redazione-dei-prompt-per-lestrazione-dei-dati-dai-documenti","status":"publish","type":"post","link":"https:\/\/help.qualiware.it\/qw-help\/guida-alla-redazione-dei-prompt-per-lestrazione-dei-dati-dai-documenti\/","title":{"rendered":"Guida alla redazione dei prompt per l’estrazione dei dati dai documenti"},"content":{"rendered":"

CoDriver consente di estrarre dati strutturati da documenti PDF, attraverso l’applicazione dell’OCR, se necessaria, e dell’AI generativa sul testo contenuto nel documento. Questo rende possibile l’acquisizione di dati come partite IVA, codici articolo, quantit\u00e0, ecc. da documenti come DDT, fatture, ordini, attestati, anche frutto di una scansione. Tale funzione \u00e8 disponibile sia nella Importazione Documenti<\/a> di Qualiware Server Daemon, sia in appositi form creati con lo specifico scopo di importare e archiviare i documenti, estraendo da essi i metadati necessari a successive elaborazioni.<\/p>\n

Le indicazioni su ci\u00f2 che va estratto e su come reperirlo vengono date attraverso un “prompt” che contiene il nome del campo e la relativa descrizione, che comprende anche informazioni che consentono all’AI di capire dove trovare l’informazione.<\/p>\n

Di seguito riportiamo due esempi di prompt, il primo per il recupero dei dati di testata di un DDT, il secondo per il recupero delle righe.<\/p>\n

Ragione Sociale Fornitore: Denominazione dell'Azienda che ha emesso il documento di trasporto. Non \u00e8 il destinatario della merce. Se trovi i nomi i due societ\u00e0, non \u00e8 quella indicata dopo \"Destinatario merce\".\r\nPartita IVA Fornitore: partita iva dell'azienda che ha emesso il documento di trasporto. Non \u00e8 quella del destinatario della merce. Potrebbe essere indicata come P.IVA e C.Fisc., oppure VAT. Se trovi pi\u00f9 valori, non \u00e8 quello indicato dopo il nome del destinatario.\r\nCodice Fiscale Fornitore: codice fiscale dell'azienda che ha emesso il documento di trasporto. Se non lo trovi \u00e8 coincidente con la partita iva fornitore, Non \u00e8 quella del destinatario della merce. Potrebbe essere indicata come P.IVA e C.Fisc., oppure VAT.  Se trovi pi\u00f9 valori, non \u00e8 quello indicato dopo il nome del destinatario.\r\nNumero Documento: numero del documento. Se hai dubbi, non scrivere altri numeri \r\nData Documento: data del documento, in formato dd\/MM\/yyyy . Se hai dubbi, non scrivere altre date\r\nOrdine: numero o riferimento all'ordine\r\nData ordine: data dell'ordine. Se \u00e8 stato riportato solo il numero d'ordine. lascia vuota.\r\nTotale imponibile: totale imponibile o invoice amount del DDT, compreso il separatore decimale\r\nTotale IVA: totale IVA o VAT amount,  compreso il separatore decimale\r\nTotale: totale del DDT o invoice amount, compreso il separatore decimale<\/pre>\n
Estrai le seguenti informazioni delle righe da questo Documento di Trasporto Fornitore (DDT):\r\nCodice, Codice Fornitore, Descrizione Articolo, U.M., Q.t\u00e0, lotto, Note, Prezzo, Ordine\r\nMetti nella colonna \"Codice\" il codice articolo cliente, \r\nNella colonna \"Codice Fornitore\" il codice articolo fornitore,  \r\nNella colonna \"Descrizione\" la descrizione articolo ma prendi l'intero contenuto fino alla colonna successiva\r\nNella colonna \"U.M.\" metti l'unit\u00e0 di misura\r\nNella colonna \"Q.t\u00e0\" metti la quantit\u00e0 articolo, compreso il separatore decimale\r\nSe c'\u00e8 il prezzo mettilo nella colonna \"Prezzo\", compreso il separatore decimale\r\nSe c'\u00e8 il lotto mettilo nella colonna \"Lotto\"\r\nSe ci sono delle note mettile nella colonna \"Note\"\r\nSe c'\u00e8 un riferimento all'ordine sulle righe, prima o dopo la riga, mettilo nella colonna \"Ordine\"\r\nSe c'\u00e8 anche la data dell'ordine sulle righe, prima o dopo la riga, mettila nella colonna \"Data Ordine\"\r\n\r\nAnalogamente, se c'\u00e8 una colonna \"Riferimento\" o \"Ordine\" metti il contenuto nella colonna \"Ordine\".\r\n<\/pre>\n
Non esiste una regola generale per scrivere il prompt, ma esso deve contenere, in modo chiaro, i nomi dei campi, che vanno messi fra doppi apici, come nei due esempi precedenti, oppure possono essere messi all’inizio della riga. Assieme ad essi, va fornita una descrizione di ci\u00f2 che essi devono contenere.<\/p>\n
Di seguito riportiamo alcuni accorgimenti da adottare nella scrittura del prompt:<\/p>\n
    \n
  • Per numeri e date, \u00e8 sempre consigliabile specificare \u201crestituisci come stringa\u201d, per evitare problemi con l’interpretazione dei punti decimali o del formato nel caso delle date.<\/li>\n
  • Se presente una tabella (es. corpo di un DDT) includere nell\u2019elenco dei campi da estrarre anche quelli non interessanti, per consentire all’AI di incasellare correttamente le informazioni.<\/li>\n
  • \u00c8 possibile chiedere di restituire un valore discreto e, in italiano, definire le casistiche (ad esempio “metti ‘Gas’ se \u00e8 un servizio di fornitura gas, ‘Acqua’ se \u00e8 un servizio di fornitura d’acqua, ‘Energia elettrica’ se \u00e8 un servizio di fornitura di energia elettrica<\/em>“; in questo modo, all’interno del campo verranno sempre riportati i 3 valori indicati, qualsiasi sia la descrizione del servizio fatta sulla bolletta stessa).<\/li>\n
  • \u00e8 consigliabile indicare di inserire un valore vuoto in caso il dato sia incerto. Diversamente, l’AI prova comunque a dare una risposta, che potrebbe essere sbagliata.<\/li>\n
  • \u00c8 utile fornire esempi espliciti nel prompt per chiarire cosa si intende estrarre.<\/li>\n
  • E’ necessario tenere presente che all’intelligenza artificiale viene inviato il testo del documento, eventualmente estratto attraverso l’OCR, e non l’immagine, e, di conseguenza, non \u00e8 possibile fare riferimento a specifiche posizioni (es. in basso a destra, sul lato della pagina, ecc.). E’ invece possibile specificare che l’informazione che interessa si trova subito dopo un testo specifico.<\/li>\n<\/ul>\n
    NOTE IMPORTANTI<\/strong><\/p>\n
      \n
    1. L’AI non garantisce risultati corretti al 100%. Ma la qualit\u00e0 aumenta quanto pi\u00f9 \u00e8 dettagliato il prompt. I PDF nativi offrono generalmente un risultato migliore rispetto a quelli scansionati.<\/li>\n
    2. In caso di documenti scansionati, \u00e8 importante la qualit\u00e0 della scansione stessa, che deve essere almeno a 200dpi, e il documento deve essere ben leggibile.<\/li>\n
    3. In caso di estrazione non corretta, \u00e8 consigliabile verificare il testo estraibile dal PDF, selezionandolo dopo avere aperto in anteprima la versione archiviata.<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"
      CoDriver consente di estrarre dati strutturati da documenti PDF, attraverso l’applicazione dell’OCR, se necessaria, e dell’AI generativa sul testo contenuto nel documento. Questo rende possibile l’acquisizione di dati come partite IVA, codici articolo, quantit\u00e0, ecc. da documenti come DDT, fatture, ordini, attestati, anche frutto di una scansione. Tale funzione \u00e8 disponibile sia nella Importazione Documenti…<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"ngg_post_thumbnail":0,"footnotes":""},"categories":[86],"tags":[],"acf":[],"_links":{"self":[{"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/posts\/38450"}],"collection":[{"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/comments?post=38450"}],"version-history":[{"count":6,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/posts\/38450\/revisions"}],"predecessor-version":[{"id":38457,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/posts\/38450\/revisions\/38457"}],"wp:attachment":[{"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/media?parent=38450"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/categories?post=38450"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/tags?post=38450"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}