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 ySummaryFields. 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 enSummaryFields. Los recibos y las facturas también contienen detalles sobre los artículos comprados. La AnalyzeExpense API devuelve esta información aLineItemGroups. 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 devuelveExpenseGroupProperties.
El nivel de datos más detallado de la AnalyzeExpense respuesta consiste en TypeValueDetection, y LabelDetection (opcional). Las entidades individuales son:
-
Tipo: Hace referencia al tipo de información que se detecta a un nivel alto.
-
LabelDetection: Hace referencia a la etiqueta de un valor asociado en el texto del documento.
LabelDetectiones opcional y solo se devuelve si la etiqueta está escrita. -
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 comoEXPENSE_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 tipoVENDOR_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 devuelveLabelDetection.
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
