Estrazione valore chiave (fatture)
L'estrazione dei valori chiave può essere utilizzata per identificare i valori delle chiavi predefinite in una fattura. Ad esempio, se una fattura include un nome fornitore, un totale e un ID fattura, Document Understanding è in grado di identificare questi valori e restituirli come coppia di valori chiave.
Le funzioni supportate sono:
- Estrai valori per coppie di valori chiave predefinite
- Polighi di delimitazione
- Punteggio affidabilità
Di seguito sono riportati i campi supportati.
| Campo | descrizione; |
|---|---|
| CustomerName | Nome del cliente fatturato. |
| CustomerId | Identificativo di riferimento cliente. |
| PurchaseOrder | Numero ordine di acquisto. |
| InvoiceId | Identificativo della fattura specifica. |
| InvoiceDate | Data di emissione sulla fattura. |
| DueDate | Data di scadenza del pagamento su questa fattura. |
| VendorName | Nome del fornitore. |
| VendorAddress | Indirizzo postale fornitore. |
| VendorAddressRecipient | Nome a cui viene fatto riferimento con VendorAddress. |
| CustomerAddress | Indirizzo e-mail del cliente. |
| CustomerAddressRecipient | Nome a cui viene fatto riferimento con CustomerAddress. |
| BillingAddress | Indirizzo di fatturazione esplicito per il cliente. |
| BillingAddressRecipient | Nome a cui viene fatto riferimento con BillingAddress. |
| ShippingAddress | Indirizzo di spedizione esplicito per il cliente. |
| ShippingAddressRecipient | Nome a cui viene fatto riferimento con ShippingAddress. |
| PaymentTerm | Condizioni di pagamento per la fattura. |
| Totale parziale | Campo Totale parziale identificato in questa fattura. |
| TotalTax | Valore imposta totale identificato in questa fattura. |
| InvoiceTotal | Importo di addebito totale associato alla fattura. |
| AmountDue | Importo totale dovuto al fornitore. |
| ServiceAddress | Indirizzo di servizio o indirizzo di proprietà esplicito per il cliente. |
| ServiceAddressRecipient | Nome a cui viene fatto riferimento con ServiceAddress. |
| RemittanceAddress | Indirizzo di rimessa o pagamento esplicito per il cliente. |
| RemittanceAddressRecipient | Nome a cui viene fatto riferimento con RemittanceAddress. |
| ShippingCost | Costi totali di spedizione o spedizione e gestione associati a una fattura. |
| ServiceStartDate | Prima data per il periodo di servizio. |
| ServiceEndDate | Data di fine per il periodo di servizio. |
| PreviousUnpaidBalance | Saldo esplicito precedentemente non pagato. |
Di seguito sono riportati gli elementi riga supportati.
| Elemento riga | descrizione; |
|---|---|
| Elemento | Concatenazione di tutti gli altri valori di elemento riga, ovvero l'intera riga dell'elemento riga. |
| Nome | Nome elencato per un prodotto o servizio, ad esempio t-shirt. |
| Numero | Importo dell'elemento. |
| descrizione; | Descrizione del testo per l'elemento della fattura, ad esempio camicia rayon da uomo, dimensioni piccole, medie e grandi. |
| Quantità | Quantità per questa voce riga fattura. |
| UnitPrice | Prezzo per articolo identificato nella fattura. |
| ProductCode | Codice prodotto, numero prodotto o SKU a cui si fa riferimento nell'elemento riga. ad esempio 123456. |
| Unità | L'unità dell'elemento riga, ad esempio kg, lb. |
| Tax | Imposta a cui viene fatto riferimento in modo esplicito nella voce riga. |
| Date | Data corrispondente a ogni voce riga. |
Esempio di estrazione valore chiave (fattura)
Esempio di utilizzo dell'estrazione del valore chiave da una fattura in Document Understanding.
- Documento di input
-
Richiesta API input estrazione valore chiave (fattura)
:{ "processorConfig": { "processorType": "GENERAL", "features": [ { "featureType": "KEY_VALUE_EXTRACTION" }, "documentType": "INVOICE" }, "inputLocation": { "sourceType": "OBJECT_STORAGE_LOCATIONS", "objectLocations": [ { "source": "OBJECT_STORAGE", "namespaceName": "", "bucketName": "", "objectName": "" } ] }, "compartmentId": "", "outputLocation": { "namespaceName": "", "bucketName": "", "prefix": "" } } - output:
- Risposta API:
{ "documentMetadata": { "pageCount": 1, "mimeType": "image/png" }, "pages": [ { "pageNumber": 1, "dimensions": { "width": 1372, "height": 1732, "unit": "PIXEL" }, "documentFields": [ { "fieldType": "KEY_VALUE", "fieldLabel": { "name": "VendorAddress", "confidence": 0.99862003 }, "fieldValue": { "valueType": "STRING", "text": "657 Clifford Street Allentown, PA", "boundingPolygon": { "normalizedVertices": [ { "x": 0.08454810495626822, "y": 0.10219399538106236 }, { "x": 0.21793002915451895, "y": 0.10219399538106236 }, { "x": 0.21793002915451895, "y": 0.13048498845265588 }, { "x": 0.08454810495626822, "y": 0.13048498845265588 } ] }, "wordIndexes": [ 3, 4, 5, 9, 10 ], "value": "657 Clifford Street Allentown, PA" } }, { "fieldType": "LINE_ITEM_GROUP", "fieldLabel": { "name": "Items" }, "fieldValue": { "valueType": "ARRAY", "items": [ { "fieldType": "LINE_ITEM", "fieldValue": { "valueType": "ARRAY", "text": "1 Cable165XZ3654681 12.75 $12.75", "items": [ { "fieldType": "LINE_ITEM_FIELD", "fieldLabel": { "name": "Quantity", "confidence": 0.9989789 }, "fieldValue": { "valueType": "NUMBER", "text": "1", "boundingPolygon": { "normalizedVertices": [ { "x": 0.39941690962099125, "y": 0.5075057736720554 }, { "x": 0.39941690962099125, "y": 0.5184757505773672 }, { "x": 0.24927113702623907, "y": 0.5184757505773672 } ] }, "wordIndexes": [ 68 ], "value": "Cable165XZ3654681" } }, { "fieldType": "LINE_ITEM_FIELD", "fieldLabel": { "name": "UnitPrice", "confidence": 0.9375645 }, "fieldValue": { "valueType": "NUMBER", "text": "12.75", "boundingPolygon": { "normalizedVertices": [ { "x": 0.7594752186588921, "y": 0.50635103926097 }, { "x": 0.8024781341107872, "y": 0.50635103926097 }, { "x": 0.8024781341107872, "y": 0.5196304849884527 }, { "x": 0.7594752186588921, "y": 0.5196304849884527 } ] }, "wordIndexes": [ 69 ], "value": 12.75 } }, ] } } ] } } ] } ], }