Documentation Oracle Cloud Infrastructure

Extraction valeur clé (factures)

L'extraction des valeurs de clé peut être utilisée pour identifier les valeurs des clés prédéfinies dans une facture. Par exemple, si une facture inclut un nom de fournisseur, un total et un code facture, Document Understanding peut identifier ces valeurs et les renvoyer sous forme de paire de valeurs de clé.

Les fonctionnalités prises en charge sont les suivantes :
  • Extraire les valeurs pour les paires clé-valeur prédéfinies
  • Polygone limitant
  • Score de confiance

Les champs pris en charge sont les suivants :

Champs pris en charge
Champ Description :
CustomerName Nom du client facturé.
CustomerId Identifiant de la référence client.
PurchaseOrder Numéro de commande d'achat.
InvoiceId Identifiant pour la facture spécifique.
InvoiceDate Date d'émission sur la facture.
DueDate Date d'échéance du paiement sur cette facture.
VendorName Nom du fournisseur.
VendorAddress Adresse postale du fournisseur.
VendorAddressRecipient Nom référencé par VendorAddress.
CustomerAddress Adresse postale du Client.
CustomerAddressRecipient Nom référencé par CustomerAddress.
BillingAddress Adresse de facturation explicite pour le client.
BillingAddressRecipient Nom référencé par BillingAddress.
ShippingAddress Adresse d'expédition explicite pour le client.
ShippingAddressRecipient Nom référencé par ShippingAddress.
PaymentTerm Conditions de paiement de la facture.
Sous-total Champ de sous-total identifié sur cette facture.
TotalTax Valeur totale de la taxe identifiée sur cette facture.
InvoiceTotal Montant total des frais associés à la facture.
AmountDue Montant total dû au fournisseur.
ServiceAddress Adresse de service ou adresse de propriété explicite pour le client.
ServiceAddressRecipient Nom référencé par ServiceAddress.
RemittanceAddress Adresse de remise ou de paiement explicite pour le client.
RemittanceAddressRecipient Nom référencé par RemittanceAddress.
ShippingCost Total des frais d'expédition ou d'expédition et de manutention associés à une facture.
ServiceStartDate Première date de la période de service.
ServiceEndDate Date de fin de la période de service.
PreviousUnpaidBalance Solde précédemment impayé explicite.

Les lignes prises en charge sont les suivantes :

Eléments libres pris en charge
Ligne Description :
Eléments Concaténation de toutes les autres valeurs de ligne (c'est-à-dire la totalité de la ligne).
Nom Nom répertorié pour un produit ou un service, par exemple, t-shirt.
Montant Montant de la ligne.
Description : Description du texte de la ligne de facture, par exemple, chemise rayonne pour homme, tailles petite, moyenne et grande.
Quantité Quantité pour cette ligne de facture.
UnitPrice Prix par article identifié sur la facture.
ProductCode Code produit, numéro de produit ou SKU référencé dans la ligne. Par exemple, 123456.
Unité Unité de la ligne, par exemple, kg, livre.
Taxe Taxe explicitement référencée sur la ligne.
Date Date correspondant à chaque ligne.

Exemple d'extraction de valeur clé (facture)

Exemple d'utilisation de l'extraction de valeur de clé à partir d'une facture dans Document Understanding.

Document d'entrée
Extraction de valeur de clé (facture) - Demande d'API d'entrée Facture fictive pour câble et fil. :
{ 
       "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": "" 
       }
       }
Sortie :
Réponse d'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           
       }          
       },        
       ]        
       }       
       }      
       ]     
       }    
       }   
       ]  
       } 
       ],
       }