Documentación de Oracle Cloud Infrastructure

Extracción de valor clave (facturas de venta)

La extracción de valores clave se puede utilizar para identificar valores para claves predefinidas en una factura. Por ejemplo, si una factura incluye un nombre de proveedor, un total y un ID de factura, Document Understanding puede identificar estos valores y devolverlos como un par clave-valor.

Las funciones soportadas son:
  • Extraer valores para pares de valores de clave predefinidos
  • Polígonos encuadernados
  • Puntuación de confianza

Los campos soportados son:

Campos soportados
Campo Descripción
CustomerName Nombre del cliente facturado.
CustomerId Identificador de referencia de cliente.
PurchaseOrder Número de orden de compra.
InvoiceId Identificador para la factura específica.
InvoiceDate Fecha de emisión de la factura.
DueDate Fecha de vencimiento de pago en esta factura.
VendorName Nombre del proveedor.
VendorAddress Dirección postal del proveedor.
VendorAddressRecipient Nombre al que se hace referencia con VendorAddress.
CustomerAddress Dirección postal del cliente.
CustomerAddressRecipient Nombre al que se hace referencia con CustomerAddress.
BillingAddress Dirección de facturación explícita para el cliente.
BillingAddressRecipient Nombre al que se hace referencia con BillingAddress.
ShippingAddress Dirección de envío explícita para el cliente.
ShippingAddressRecipient Nombre al que se hace referencia con ShippingAddress.
PaymentTerm Las condiciones de pago de la factura.
Subtotal Campo de subtotal identificado en esta factura de venta.
TotalTax Valor fiscal total identificado en esta factura.
InvoiceTotal Importe total de cargo asociado con la factura.
AmountDue Importe total debido al proveedor.
ServiceAddress Dirección de servicio explícita o dirección de propiedad para el cliente.
ServiceAddressRecipient Nombre al que se hace referencia con ServiceAddress.
RemittanceAddress Dirección de pago o remesa explícita del cliente.
RemittanceAddressRecipient Nombre al que se hace referencia con RemittanceAddress.
ShippingCost Total de gastos de envío o envío y manipulación asociados a una factura.
ServiceStartDate Primera fecha para el período de servicio.
ServiceEndDate Fecha de finalización del período de servicio.
PreviousUnpaidBalance Saldo explícito no pagado anteriormente.

Las líneas de ítem soportadas son:

Líneas de ítem soportadas
Línea de ítem Descripción
Elementos Concatenación de todos los demás valores de línea de ítem (es decir, toda la línea de ítem).
Nombre Nombre que se muestra para un producto o servicio, por ejemplo, camiseta.
Importe El importe del ítem de línea.
Descripción Descripción de texto del artículo de línea de factura, por ejemplo, camisa de rayón para hombres, tamaños pequeños, medianos y grandes.
Cantidad La cantidad de esta línea de ítem de factura.
UnitPrice Precio por artículo identificado en la factura.
ProductCode Código de producto, número de producto o SKU a los que se hace referencia en la línea de ítem. Por ejemplo, 12456.
Unidad La unidad de la línea de ítem, por ejemplo, kg, lb.
Impuesto Impuesto al que se hace referencia explícitamente en la línea de ítem.
Fecha Fecha correspondiente a cada línea de ítem.

Ejemplo de extracción de valor clave (factura)

Ejemplo del uso de la extracción de valores clave de una factura en Document Understanding.

Documento de Entrada
Solicitud de API de entrada de extracción de valor clave (factura de venta) Factura ficticia para cable y alambre.:
{ 
       "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": "" 
       }
       }
Salida:
Respuesta de 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           
       }          
       },        
       ]        
       }       
       }      
       ]     
       }    
       }   
       ]  
       } 
       ],
       }