Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Objetos de respuesta a facturas y recibos
Cuando envías una factura o un recibo a la AnalyzeExpense API, esta devuelve una serie de ExpenseDocuments objetos. Cada uno de ellos ExpenseDocument se divide a su vez en `LineItemGroups` y`SummaryFields`. La mayoría de las facturas y recibos contienen información como el nombre del proveedor, el número de recibo, la fecha del recibo o el importe total. AnalyzeExpense devuelve esta información en`SummaryFields`. Los recibos y las facturas también contienen detalles sobre los artículos comprados. La AnalyzeExpense API devuelve esta información a`LineItemGroups`. El `ExpenseIndex` campo identifica de forma exclusiva el gasto y asocia lo apropiado `SummaryFields` y lo `LineItemGroups` detectado en ese gasto. Por último, el análisis de gastos devolverá un `Block` objeto y le proporcionará la misma información que la que obtendría la detección de texto en su documento.
Cierta información, como direcciones y nombres, puede ser difícil de distinguir a partir de una sola respuesta. El análisis de gastos utiliza el objeto `ExpenseGroupProperties` para ayudar a distinguir las respuestas imprecisas. Este objeto contiene un tipo de la siguiente lista:
+ VENDOR\_REMIT\_TO
+ RECEIVER\_SHIP\_TO
+ RECEPTOR\_VENDIDO\_A
+ RECEIVER\_BILL\_TO
+ VENDEDOR\_PROVEEDOR
Estos tipos distinguen entre los distintos grupos de respuestas. Varios elementos que pertenecen al mismo grupo se conectan mediante un número de identificación, que también se devuelve`ExpenseGroupProperties`.
El nivel de datos más detallado de la AnalyzeExpense respuesta consiste en `Type``ValueDetection`, y `LabelDetection` (opcional). Las entidades individuales son:
+ [Tipo](#how-it-works-type): Hace referencia al tipo de información que se detecta a un nivel alto.
+ [LabelDetection](#how-it-works-labeldetection): Hace referencia a la etiqueta de un valor asociado en el texto del documento. `LabelDetection`es opcional y solo se devuelve si la etiqueta está escrita.
+ [ValueDetection](#how-it-works-valuedetection): Hace referencia al valor de la etiqueta o el tipo devuelto.
La AnalyzeExpense API también detecta `ITEM` los elementos de línea y los `PRICE` encuentra dentro de ellos como campos normalizados. `QUANTITY` Si hay otro texto en una línea de pedido en la imagen del recibo, como el SKU o una descripción detallada, se incluirá en el JSON como`EXPENSE_ROW`. Esto se muestra en el siguiente ejemplo:
```
{
"Type": {
"Text": "EXPENSE_ROW",
"Confidence": 99.95216369628906
},
"ValueDetection": {
"Text": "Banana 5 $2.5",
"Geometry": {
…
},
"Confidence": 98.11214447021484
}
```
En el ejemplo anterior, se muestra cómo la operación de la AnalyzeExpense API devuelve la fila completa de un recibo que contiene información sobre las partidas correspondientes a 5 plátanos vendidos por 2,5$.
## Tipo
A continuación se muestra un ejemplo del tipo estándar o normalizado del par clave-valor:
```
{
"PageNumber": 1,
"Type": {
"Text": "VENDOR_NAME",
"Confidence": 70.0
},
"ValueDetection": {
"Geometry": { ... },
"Text": "AMAZON",
"Confidence": 87.89806365966797
}
}
```
El recibo no incluía explícitamente el «Nombre del proveedor». Sin embargo, la API Analyze Expense reconoció el valor «AMAZON» como tipo`VENDOR_NAME`.
## LabelDetection
A continuación se muestra un ejemplo del texto tal como se muestra en la página de un documento de un cliente:
```
{
"PageNumber": 1,
"Type": {
"Text": "OTHER",
"Confidence": 70.0
},
"LabelDetection": {
"Geometry": { ... },
"Text": "CASHIER",
"Confidence": 88.19171142578125
},
"ValueDetection": {
"Geometry": { ... },
"Text": "Mina",
"Confidence": 87.89806365966797
}
}
```
El documento de ejemplo contenía «CASHIER Mina». La API Analyze Expense extrajo el valor tal cual y lo devolvió por debajo. `LabelDetection` En el caso de valores implícitos, como la «fecha de la factura», en los que la «clave» no aparece de forma explícita en el recibo, `LabelDetection` no se incluirán en el AnalyzeExpense elemento. En esos casos, la operación AnalyzeExpense de la API no se devuelve`LabelDetection`.
## ValueDetection
El siguiente es un ejemplo que muestra el «valor» del par clave-valor.
```
{
"PageNumber": 1,
"Type": {
"Text": "OTHER",
"Confidence": 70.0
},
"LabelDetection": {
"Geometry": { ... },
"Text": "CASHIER",
"Confidence": 88.19171142578125
},
"ValueDetection": {
"Geometry": { ... },
"Text": "Mina",
"Confidence": 87.89806365966797
}
}
```
En el ejemplo, el documento contenía «CASHIER Mina». La AnalyzeExpense API detectó el valor del cajero como Mina y lo devolvió por debajo. `ValueDetection`