View a markdown version of this page

Objetos de resposta de faturas e recibos - Amazon Textract
TipoLabelDetectionValueDetection

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Objetos de resposta de faturas e recibos

Quando você envia uma fatura ou um recibo para a AnalyzeExpense API, ela retorna uma série de ExpenseDocuments objetos. Cada um ExpenseDocument é ainda mais separado em LineItemGroups SummaryFields e. A maioria das faturas e recibos contém informações como nome do fornecedor, número do recibo, data do recebimento ou valor total. AnalyzeExpense retorna essas informações emSummaryFields. Recibos e faturas também contêm detalhes sobre os itens comprados. A AnalyzeExpense API retorna essas informações emLineItemGroups. O ExpenseIndex campo identifica de forma exclusiva a despesa e associa a apropriada SummaryFields e a LineItemGroups detectada nessa despesa. Por fim, a análise de despesas retornará um Block objeto, fornecendo as mesmas informações que a detecção de texto forneceria em seu documento.

Certas informações, como endereços e nomes, podem ser difíceis de discernir com base em uma única resposta. A Análise de Despesas usa o objeto ExpenseGroupProperties para ajudar a distinguir respostas nebulosas. Esse objeto contém um tipo da lista a seguir:

  • REMETER_PARA O FORNECEDOR

  • DESTINATÁRIO_DE_ENVIO_PARA

  • DESTINATÁRIO_VENDIDO_PARA

  • DESTINATÁRIO_BILL_TO

  • FORNECEDOR_FORNECEDOR

Esses tipos distinguem os diferentes grupos de respostas. Vários elementos pertencentes ao mesmo grupo são conectados via número de identificação, também retornadoExpenseGroupProperties.

O nível mais granular de dados na AnalyzeExpense resposta consiste em TypeValueDetection, e LabelDetection (opcional). As entidades individuais são:

  • Tipo: refere-se ao tipo de informação detectada em alto nível.

  • LabelDetection: refere-se ao rótulo de um valor associado no texto do documento. LabelDetectioné opcional e só é retornado se a etiqueta estiver escrita.

  • ValueDetection: refere-se ao valor da etiqueta ou do tipo retornado.

A AnalyzeExpense API também detecta ITEMQUANTITY, e PRICE dentro de itens de linha como campos normalizados. Se houver outro texto em um item de linha na imagem do recibo, como SKU ou descrição detalhada, ele será incluído no JSON como. EXPENSE_ROW Isso é mostrado no exemplo a seguir:


               {
                                    "Type": {
                                        "Text": "EXPENSE_ROW",
                                        "Confidence": 99.95216369628906
                                    },
                                    "ValueDetection": {
                                        "Text": "Banana 5 $2.5",
                                        "Geometry": {
                                          …
                                        },
                                        "Confidence": 98.11214447021484
                                    }

O exemplo anterior mostra como a operação da AnalyzeExpense API retorna a linha inteira em um recibo que contém informações sobre o item de linha sobre 5 bananas vendidas por $2,5.

Tipo

A seguir está um exemplo do tipo padrão ou normalizado do par de valores-chave:


               {
                    "PageNumber": 1, 
                    "Type": {
                        "Text": "VENDOR_NAME", 
                        "Confidence": 70.0
                    }, 
                    "ValueDetection": {
                        "Geometry": { ... }, 
                        "Text": "AMAZON", 
                        "Confidence": 87.89806365966797
                    }
                }

O recibo não tinha “Nome do fornecedor” listado explicitamente. No entanto, a API Analyze Expense reconheceu o valor “AMAZON” como TipoVENDOR_NAME.

LabelDetection

Veja a seguir um exemplo de texto conforme mostrado na página de um documento do cliente:


               {
                    "PageNumber": 1, 
                    "Type": {
                        "Text": "OTHER", 
                        "Confidence": 70.0
                    }, 
                    "LabelDetection": {
                        "Geometry": { ... }, 
                        "Text": "CASHIER", 
                        "Confidence": 88.19171142578125
                    }, 
                    "ValueDetection": {
                        "Geometry": { ... }, 
                        "Text": "Mina", 
                        "Confidence": 87.89806365966797
                    }
                }

O documento de exemplo continha “CASHIER Mina”. A API Analyze Expense extraiu o valor no estado em que se encontra e o retorna em. LabelDetection Valores implícitos, como “Data da fatura”, em que a “chave” não é mostrada explicitamente no recibo, não LabelDetection serão incluídos no elemento. AnalyzeExpense Nesses casos, a operação AnalyzeExpense da API não retornaLabelDetection.

ValueDetection

Veja a seguir um exemplo que mostra o “valor” do par de valores-chave.


               {
                    "PageNumber": 1, 
                    "Type": {
                        "Text": "OTHER", 
                        "Confidence": 70.0
                    }, 
                    "LabelDetection": {
                        "Geometry": { ... }, 
                        "Text": "CASHIER", 
                        "Confidence": 88.19171142578125
                    }, 
                    "ValueDetection": {
                        "Geometry": { ... }, 
                        "Text": "Mina", 
                        "Confidence": 87.89806365966797
                    }
                }

No exemplo, o documento continha “CASHIER Mina”. A AnalyzeExpense API detectou o valor do caixa como Mina e o retornou abaixoValueDetection.