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
<a name="expensedocuments"></a>

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 em`SummaryFields`. Recibos e faturas também contêm detalhes sobre os itens comprados. A AnalyzeExpense API retorna essas informações em`LineItemGroups`. 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 retornado`ExpenseGroupProperties`.

O nível mais granular de dados na AnalyzeExpense resposta consiste em `Type``ValueDetection`, e `LabelDetection` (opcional). As entidades individuais são:
+ [Tipo](#how-it-works-type): refere-se ao tipo de informação detectada em alto nível.
+ [LabelDetection](#how-it-works-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](#how-it-works-valuedetection): refere-se ao valor da etiqueta ou do tipo retornado.

A AnalyzeExpense API também detecta `ITEM``QUANTITY`, 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 name="how-it-works-type"></a>

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 Tipo`VENDOR_NAME`. 

## LabelDetection
<a name="how-it-works-labeldetection"></a>

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 retorna`LabelDetection`. 

## ValueDetection
<a name="how-it-works-valuedetection"></a>

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 abaixo`ValueDetection`.