Oracle Cloud Infrastructure-Dokumentation

Schlüsselwertextraktion (Ausgangsrechnungen)

Mit der Schlüsselwertextraktion können Sie Werte für vordefinierte Schlüssel in einer Rechnung identifizieren. Beispiel: Wenn eine Rechnung einen Lieferantennamen, eine Summe und eine Rechnungs-ID enthält, kann Document Understanding diese Werte identifizieren und als Schlüssel/Wert-Paar zurückgeben.

Die unterstützten Features sind:
  • Extrahieren Sie Werte für vordefinierte Schlüsselwertpaare
  • Grenzpolygone
  • Sicherheitsscore

Folgende Felder werden unterstützt:

Unterstützte Felder
Field Beschreibung
CustomerName Name des fakturierten Kunden.
CustomerId Kundenreferenz-ID.
PurchaseOrder Bestellnummer.
InvoiceId ID der spezifischen Rechnung.
InvoiceDate Ausstellungsdatum der Rechnung.
DueDate Datum an dem die Zahlung auf dieser Rechnung fällig ist.
VendorName Name des Lieferanten.
VendorAddress Lieferanschrift.
VendorAddressRecipient Name, der mit VendorAddress referenziert wird.
CustomerAddress Postanschrift für den Kunden.
CustomerAddressRecipient Name, der mit CustomerAddress referenziert wird.
BillingAddress Explizite Rechnungsadresse für den Kunden.
BillingAddressRecipient Name, der mit BillingAddress referenziert wird.
ShippingAddress Explizite Versandadresse für den Kunden.
ShippingAddressRecipient Name, der mit ShippingAddress referenziert wird.
PaymentTerm Die Zahlungsbedingungen für die Rechnung.
Summe Zwischensummenfeld, das auf dieser Ausgangsrechnung ermittelt wurde.
TotalTax Gesamtsteuerwert, der auf dieser Rechnung angegeben ist.
InvoiceTotal Der Rechnung zugeordneter Gebührengesamtbetrag.
AmountDue Gesamtbetrag, der an den Anbieter fällig ist.
ServiceAddress Explizite Service- oder Immobilienadresse für den Kunden.
ServiceAddressRecipient Name, der mit ServiceAddress referenziert wird.
RemittanceAddress Explizite Zahlungsanweisungs- oder Zahlungsadresse für den Kunden.
RemittanceAddressRecipient Name, der mit RemittanceAddress referenziert wird.
ShippingCost Gesamtkosten für Versand oder Versand und Bearbeitung, die einer Rechnung zugeordnet sind.
ServiceStartDate Erstes Datum für die Serviceperiode.
ServiceEndDate Enddatum der Serviceperiode.
PreviousUnpaidBalance Expliziter vorher nicht bezahlter Saldo.

Folgende Positionen werden unterstützt:

Unterstützte Positionen
Position Beschreibung
Elemente Verkettung aller anderen Positionswerte (d.h. der gesamten Position).
Name Der für ein Produkt oder eine Dienstleistung aufgeführte Name, z.B. T-Shirt.
Betrag Der Betrag der Position.
Beschreibung Die Textbeschreibung für die Rechnungsposition, z.B. Rayon-Hemd für Männer, Größen klein, mittel und groß.
Menge Die Menge für diese Rechnungsposition.
UnitPrice Der Preis pro Artikel, der auf der Rechnung angegeben ist.
ProductCode Produktcode, Produktnummer oder SKU, die in der Position referenziert wird. Zum Beispiel, 123456.
Einheit Die Einheit der Position, z.B. kg, lb.
Tax Steuer, die in der Position explizit referenziert wird.
Datum Datum, das jeder Position entspricht.

Schlüsselwertextraktion (Rechnung) - Beispiel

Ein Beispiel für die Verwendung der Schlüsselwertextraktion aus einer Rechnung in Document Understanding.

Eingabedokument
API-Anforderung für Schlüsselwertextraktion (Rechnung) - Eingabe Fiktive Rechnung für Kabel und Draht.:
{ 
       "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": "" 
       }
       }
Ausgabe:
API-Antwort:
{ 
       "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           
       }          
       },        
       ]        
       }       
       }      
       ]     
       }    
       }   
       ]  
       } 
       ],
       }