Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Oggetti di risposta alle fatture e alle ricevute
Quando si invia una fattura o una ricevuta all' AnalyzeExpense API, questa restituisce una serie di ExpenseDocuments oggetti. Ciascuno ExpenseDocument è ulteriormente suddiviso in LineItemGroups eSummaryFields. La maggior parte delle fatture e delle ricevute contiene informazioni come il nome del fornitore, il numero di ricevuta, la data di ricezione o l'importo totale. AnalyzeExpense restituisce queste informazioni sotto. SummaryFields Le ricevute e le fatture contengono anche dettagli sugli articoli acquistati. L' AnalyzeExpense API restituisce queste informazioni sotto. LineItemGroups Il ExpenseIndex campo identifica in modo univoco la spesa e associa la spesa appropriata SummaryFields e quella LineItemGroups rilevata in tale spesa. Infine, l'analisi delle spese restituirà un Block oggetto, fornendoti le stesse informazioni che il rilevamento del testo fornirebbe sul tuo documento.
Alcune informazioni, come indirizzi e nomi, possono essere difficili da distinguere sulla base di una singola risposta. Expense Analysis utilizza l'oggetto ExpenseGroupProperties per aiutare a distinguere le risposte nebulose. Questo oggetto contiene un tipo dal seguente elenco:
-
VENDOR_REMIT_TO
-
DESTINATARIO_SPEDIZIONE_A
-
DESTINATARIO_VENDUTO_A
-
FATTURA_DESTINATARIO
-
FORNITORE_FORNITORE
Questi tipi distinguono tra i diversi gruppi di risposte. Più elementi appartenenti allo stesso gruppo sono collegati tramite un numero di identificazione, anch'esso restituitoExpenseGroupProperties.
Il livello di dati più granulare nella AnalyzeExpense risposta è costituito da TypeValueDetection, e LabelDetection (Facoltativo). Le singole entità sono:
-
Tipo: si riferisce al tipo di informazioni rilevate ad alto livello.
-
LabelDetection: si riferisce all'etichetta di un valore associato all'interno del testo del documento.
LabelDetectionè facoltativo e viene restituito solo se l'etichetta è scritta. -
ValueDetection: si riferisce al valore dell'etichetta o del tipo restituito.
L' AnalyzeExpense API rileva inoltre ITEMQUANTITY, e PRICE all'interno degli elementi di riga, come campi normalizzati. Se c'è altro testo in una riga sull'immagine della ricevuta, ad esempio SKU o descrizione dettagliata, verrà incluso nel file JSON come. EXPENSE_ROW Questo viene mostrato nell'esempio seguente:
{ "Type": { "Text": "EXPENSE_ROW", "Confidence": 99.95216369628906 }, "ValueDetection": { "Text": "Banana 5 $2.5", "Geometry": { … }, "Confidence": 98.11214447021484 }
L'esempio precedente mostra come l'operazione AnalyzeExpense API restituisca l'intera riga di una ricevuta contenente informazioni sulla voce relativa a 5 banane vendute per 2,5 USD.
Tipo
Di seguito è riportato un esempio del tipo standard o normalizzato della coppia chiave-valore:
{ "PageNumber": 1, "Type": { "Text": "VENDOR_NAME", "Confidence": 70.0 }, "ValueDetection": { "Geometry": { ... }, "Text": "AMAZON", "Confidence": 87.89806365966797 } }
Nella ricevuta non era indicato esplicitamente il «Nome fornitore». Tuttavia, l'API Analyze Expense ha riconosciuto il valore «AMAZON» come Type. VENDOR_NAME
LabelDetection
Di seguito è riportato un esempio di testo visualizzato nella pagina del documento di un cliente:
{ "PageNumber": 1, "Type": { "Text": "OTHER", "Confidence": 70.0 }, "LabelDetection": { "Geometry": { ... }, "Text": "CASHIER", "Confidence": 88.19171142578125 }, "ValueDetection": { "Geometry": { ... }, "Text": "Mina", "Confidence": 87.89806365966797 } }
Il documento di esempio conteneva «CASHIER Mina». L'API Analyze Expense ha estratto il valore così com'è e lo restituisce sotto. LabelDetection I valori impliciti come «Data della fattura», in cui la «chiave» non è esplicitamente mostrata nella ricevuta, non LabelDetection verranno inclusi nell'elemento. AnalyzeExpense In questi casi, l'operazione AnalyzeExpense API non viene restituita. LabelDetection
ValueDetection
Di seguito è riportato un esempio che mostra il «valore» della coppia chiave-valore.
{ "PageNumber": 1, "Type": { "Text": "OTHER", "Confidence": 70.0 }, "LabelDetection": { "Geometry": { ... }, "Text": "CASHIER", "Confidence": 88.19171142578125 }, "ValueDetection": { "Geometry": { ... }, "Text": "Mina", "Confidence": 87.89806365966797 } }
Nell'esempio, il documento conteneva «CASHIER Mina». L' AnalyzeExpense API ha rilevato il valore Cashier come Mina e lo ha restituito. ValueDetection
