Documentação do Oracle Cloud Infrastructure

Extração de Chave-Valor (Recebimentos)

A extração de valor de chave pode ser usada para identificar valores para chaves predefinidas em um recebimento. Por exemplo, se um recibo incluir um nome de comerciante, endereço do comerciante ou número de telefone do comerciante, o Document Understanding poderá identificar esses valores e retorná-los como um par de chave/valor.

Os recursos suportados são:
  • Extrair valores para pares de chave/valor predefinidos
  • Polígonos de contorno
  • Solicitação única
  • Solicitação em lote
Limitações:
  • Suporta recibos apenas em inglês.

Os campos suportados são:

Campos Suportados
Campo Descrição
MerchantName O nome do comerciante que emite o recebimento.
MerchantPhoneNumber O número de telefone do comerciante.
MerchantAddress O endereço do comerciante.
TransactionDate A data em que o recebimento foi emitido.
TransactionTime A hora em que o recibo foi emitido.
Total O valor total do recebimento, após a aplicação de todos os encargos e impostos.
Subtotal O subtotal antes dos impostos.
Imposto Quaisquer impostos sobre vendas.
Dica O valor da gorjeta dada pelo comprador.

As informações de item de linha suportadas são:
Itens de Linha Suportados
Item de Linha Descrição
ItemName Nome do item.
ItemPrice Preço unitário do item.
ItemQuantity O número de cada item comprado.
ItemTotalPrice O preço total do item de linha.

Exemplo de Extração de Valor-Chave (Recebimentos)

Um exemplo de uso de extração de valor-chave no Document Understanding.

Documento de entrada
Solicitação de API Recibo de um café fictício, incluindo dois itens de linha, imposto, subtotal e valores totais. de Entrada de Extração de Valor Chave (Recebimentos):
{ 
            "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": "" 
            }
            }
Saída:
Resposta da API O recibo fictício com apenas linhas e campos específicos destacados de Saída de Extração de Valor-Chave (Recebimentos):
{ "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" } },
            ...