Extracción de valor clave (recibos)

La extracción de valores clave se puede utilizar para identificar valores para claves predefinidas en un cobro. Por ejemplo, si un recibo incluye un nombre de comerciante, una dirección de comerciante o un número de teléfono de comerciante, 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
  • Solicitud única
  • Solicitud de lote
Limitaciones:
  • Solo soporta recibos en inglés.

Los campos soportados son:

Campos soportados
Campo Descripción
MerchantName Nombre del comerciante que emite el recibo.
MerchantPhoneNumber Número de teléfono del comerciante.
MerchantAddress La dirección del comerciante.
TransactionDate Fecha en que se emitió el cobro.
TransactionTime Hora a la que se emitió el recibo.
Total Importe total del recibo, una vez aplicados todos los cargos e impuestos.
Subtotal Subtotal antes de impuestos.
Impuesto Cualquier impuesto sobre las ventas.
Consejo La cantidad de propina dada por el comprador.

La información de línea de ítem soportada es:
Líneas de ítem soportadas
Línea de ítem Descripción
ItemName Nombre del elemento.
ItemPrice Precio unitario del artículo.
ItemQuantity Número de cada artículo comprado.
ItemTotalPrice Precio total de la línea de ítem.

Ejemplo de extracción de valores clave (recepciones)

Ejemplo de uso de extracción de valores clave en Document Understanding.

Documento de Entrada
Solicitud de API de entrada de extracción de valor clave (recibos) Recibo de una cafetería ficticia, que incluye dos artículos de línea, impuestos, importes totales y subtotales.:
{ 
            "processorConfig": {  
            "processorType": "GENERAL",  
            "features": [   
            {    
            "featureType": "KEY_VALUE_EXTRACTION"   
            },  
            "documentType": "RECEIPT" 
            }, 
            "inputLocation": {  
            "sourceType": "OBJECT_STORAGE_LOCATIONS",  
            "objectLocations": [   
            {    
            "source": "OBJECT_STORAGE",    
            "namespaceName": "",   
            "bucketName": "",    
            "objectName": ""   
            }  
            ] 
            }, 
            "compartmentId": "", 
            "outputLocation": {  
            "namespaceName": "",  
            "bucketName": "",  
            "prefix": "" 
            }
            }
Salida:
Salida de extracción de valor clave (recibos) Recibo ficticio con solo líneas y campos específicos resaltados Respuesta de API:
{ "documentMetadata":
            { "pageCount": 1,
            "mimeType": "image/jpeg" },
            "pages":
            [ { "pageNumber": 1, 
            "dimensions":
            { "width": 361,
            "height": 600,
            "unit": "PIXEL" },
            ...
            "documentFields":
            [ { "fieldType": "KEY_VALUE",
            "fieldLabel":
            { "name": "MerchantName" },
            "fieldValue":
            { "valueType": "STRING",
            "boundingPolygon":
            { "normalizedVertices":
            [ { "x": 0.0664819944598338,
            "y": 0.011666666666666667 },
            { "x": 0.3157894736842105,
            "y": 0.011666666666666667 },
            { "x": 0.3157894736842105,
            "y": 0.035 },
            { "x": 0.0664819944598338,
            "y": 0.035 } ]
            },
            "wordIndexes":
            [ 0, 1 ],
            "value": "Example cafe" } },
            ...