Documentation sur Oracle Cloud Infrastructure

Extraction de clé-valeur (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 comprend un nom de fournisseur, un total et un code de facture, Document Understanding peut identifier ces valeurs et les retourner en tant que paire clé-valeur.

Les fonctionnalités prises en charge sont les suivantes :
  • Extraire les valeurs des paires clé-valeur prédéfinies
  • Polygones de liaison
  • Note de fiabilité

Les champs pris en charge sont les suivants :

Champs pris en charge
Champ Description
CustomerName Nom du client facturé.
CustomerId Identificateur de référence de client.
PurchaseOrder Numéro de bon de commande.
InvoiceId Identificateur pour la facture spécifique.
InvoiceDate Date d'émission de la facture.
DueDate Date à laquelle le paiement est dû sur cette facture.
VendorName Nom du fournisseur.
VendorAddress Adresse postale du fournisseur.
VendorAddressRecipient Nom référencé avec VendorAddress.
CustomerAddress Adresse postale du client.
CustomerAddressRecipient Nom référencé avec CustomerAddress.
BillingAddress Adresse de facturation explicite du client.
BillingAddressRecipient Nom référencé avec BillingAddress.
ShippingAddress Adresse d'expédition explicite du client.
ShippingAddressRecipient Nom référencé avec ShippingAddress.
PaymentTerm Conditions de paiement de la facture.
Total partiel Champ de sous-total identifié sur cette facture.
TotalTax Valeur totale des taxes identifiée sur cette facture.
InvoiceTotal Montant total des frais associé à la facture.
AmountDue Montant total dû au fournisseur.
ServiceAddress Adresse de service ou adresse de propriété explicite du client.
ServiceAddressRecipient Nom référencé avec ServiceAddress.
RemittanceAddress Adresse de versement ou de paiement explicite du client.
RemittanceAddressRecipient Nom référencé avec RemittanceAddress.
ShippingCost Frais totaux 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 impayé explicite.

Les lignes d'article prises en charge sont les suivantes :

Lignes d'article prises en charge
Élément de ligne Description
Éléments Concaténation de toutes les autres valeurs d'article de ligne (c'est-à-dire la ligne entière de l'article de ligne).
Nom Nom répertorié pour un produit ou un service, par exemple t-shirt.
Montant Montant de la ligne d'article.
Description Description textuelle de l'article de ligne de facture, par exemple, chemise de rayonne pour hommes, tailles petite, moyenne et grande.
Quantité Quantité pour cet article de ligne de facture.
UnitPrice Prix par article indiqué sur la facture.
ProductCode Code de produit, numéro de produit ou UGS référencé dans la ligne d'article. Par exemple, 123456.
Unité Unité de la ligne, par exemple kg, lb.
Taxe Taxe explicitement référencée sur la ligne d'article.
Date Date correspondant à chaque ligne d'article.

Exemple d'extraction de clé-valeur (facture)

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

Document d'entrée
Demande d'API d'entrée d'extraction de clé-valeur (facture) 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           
       }          
       },        
       ]        
       }       
       }      
       ]     
       }    
       }   
       ]  
       } 
       ],
       }