Documentation sur Oracle Cloud Infrastructure

Extraction de valeur de clé (factures)

L'extraction des valeurs clés 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, le service de compréhension de documents peut identifier ces valeurs et les retourner en tant que paire de valeurs clés.

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 valeur de clé (facture)

Exemple d'utilisation de l'extraction de valeurs clés à partir d'une facture dans le service de compréhension de documents.

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