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. # GetExpenseAnalysis Obtiene los resultados de una operación asíncrona de Amazon Textract que analiza facturas y recibos. Amazon Textract encuentra la información de contacto, los artículos comprados y el nombre del proveedor, a partir de facturas y recibos de entrada. Para iniciar un análisis asíncrono de factura/recibo llamando[StartExpenseAnalysis](API_StartExpenseAnalysis.md), que devuelve un identificador de trabajo (`JobId`). Una vez completado el análisis de factura/recepción, Amazon Textract publica el estado de realización en el tema de Amazon Simple Notification Service (Amazon SNS). Este tema debe registrarse en la llamada inicial a`StartExpenseAnalysis`. Para obtener los resultados de la operación de análisis de factura/recepción, en primer lugar, asegúrese de que el valor de estado publicado en el tema de Amazon SNS es`SUCCEEDED`. Si es así, llame`GetExpenseAnalysis`y pasa el identificador de trabajo (`JobId`) desde la llamada inicial hasta`StartExpenseAnalysis`. Utilice el parámetro MaxResults para limitar el número de bloques devueltos. Si hay más resultados de los especificados en`MaxResults`, el valor de`NextToken`en la respuesta de operación contiene un token de paginación para obtener el siguiente conjunto de resultados. Para obtener la siguiente página de resultados, llame`GetExpenseAnalysis`, y rellénela`NextToken`parámetro request con el valor de token que se devuelve de la llamada anterior a`GetExpenseAnalysis`. Para obtener más información, consulte[Análisis de facturas y recibos](https://docs.aws.amazon.com/textract/latest/dg/invoices-receipts.html). ## Sintaxis de la solicitud ``` { "JobId": "string", "MaxResults": number, "NextToken": "string" } ``` ## Parámetros de solicitud La solicitud acepta los siguientes datos en formato JSON. ** [JobId](#API_GetExpenseAnalysis_RequestSyntax) ** Un identificador único para el trabajo de detección de texto. La`JobId`se devuelve desde`StartExpenseAnalysis`. UNA`JobId`El valor solo es válido durante 7 días. Type: Cadena Restricciones de longitud: Longitud mínima de 1. La longitud máxima es 64. Patrón: `^[a-zA-Z0-9-_]+$` Obligatorio: Sí ** [MaxResults](#API_GetExpenseAnalysis_RequestSyntax) ** El número máximo de resultados que devolver por llamada paginada. El valor más grande que puede especificar es 20. Si especifica un valor superior a 20, se devolverá un máximo de 20 resultados. El valor predeterminado es 20. Type: Entero Rango válido: Valor mínimo de 1. Obligatorio: No ** [NextToken](#API_GetExpenseAnalysis_RequestSyntax) ** Si la respuesta anterior estaba incompleta (porque hay más bloques que recuperar), Amazon Texact devuelve un token de paginación en la respuesta. Puede utilizar este token de paginación para recuperar el siguiente conjunto de bloques. Type: Cadena Restricciones de longitud: Longitud mínima de 1. La longitud máxima es de 255 caracteres. Patrón: `.*\S.*` Obligatorio: No ## Sintaxis de la respuesta ``` { "AnalyzeExpenseModelVersion": "string", "DocumentMetadata": { "Pages": number }, "ExpenseDocuments": [ { "ExpenseIndex": number, "LineItemGroups": [ { "LineItemGroupIndex": number, "LineItems": [ { "LineItemExpenseFields": [ { "LabelDetection": { "Confidence": number, "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Text": "string" }, "PageNumber": number, "Type": { "Confidence": number, "Text": "string" }, "ValueDetection": { "Confidence": number, "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Text": "string" } } ] } ] } ], "SummaryFields": [ { "LabelDetection": { "Confidence": number, "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Text": "string" }, "PageNumber": number, "Type": { "Confidence": number, "Text": "string" }, "ValueDetection": { "Confidence": number, "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Text": "string" } } ] } ], "JobStatus": "string", "NextToken": "string", "StatusMessage": "string", "Warnings": [ { "ErrorCode": "string", "Pages": [ number ] } ] } ``` ## Elementos de respuesta Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200. El servicio devuelve los datos siguientes en formato JSON. ** [AnalyzeExpenseModelVersion](#API_GetExpenseAnalysis_ResponseSyntax) ** La versión del modelo actual de AnalyzeExpense. Type: Cadena ** [DocumentMetadata](#API_GetExpenseAnalysis_ResponseSyntax) ** Información sobre un documento que Amazon Textract procesó.`DocumentMetadata`se devuelve en cada página de respuestas paginadas de una operación de Amazon Textract Texact. Tipo: objeto [DocumentMetadata](API_DocumentMetadata.md) ** [ExpenseDocuments](#API_GetExpenseAnalysis_ResponseSyntax) ** Los gastos detectados por Amazon Textract. Type: Matriz de[ExpenseDocument](API_ExpenseDocument.md)objects ** [JobStatus](#API_GetExpenseAnalysis_ResponseSyntax) ** El estado actual del trabajo de detección de texto. Type: Cadena Valores válidos:` IN_PROGRESS | SUCCEEDED | FAILED | PARTIAL_SUCCESS` ** [NextToken](#API_GetExpenseAnalysis_ResponseSyntax) ** Si la respuesta se trunca, Amazon Textract devuelve este token. Puede utilizar este token en la solicitud subsiguiente para recuperar el siguiente conjunto de resultados de detección de texto. Type: Cadena Restricciones de longitud: Longitud mínima de 1. La longitud máxima es de 255 caracteres. Patrón: `.*\S.*` ** [StatusMessage](#API_GetExpenseAnalysis_ResponseSyntax) ** Devuelve si el trabajo de detección no se ha podido completar. Contiene explicación de qué error se ha producido. Type: Cadena ** [Warnings](#API_GetExpenseAnalysis_ResponseSyntax) ** Lista de advertencias que se produjeron durante la operación de detección de texto del documento. Type: Matriz de[Warning](API_Warning.md)objects ## Errores ** AccessDeniedException ** No tiene autorización para realizar la acción. Utilice el nombre de recurso de Amazon (ARN) de un usuario autorizado o un rol de IAM para realizar la operación. Código de estado HTTP: 400 ** InternalServerError ** Amazon Textract ha tenido un problema de servicio. Pruebe la llamada de nuevo. Código de estado HTTP: 500 ** InvalidJobIdException ** Se ha pasado un identificador de trabajo no válido a[GetDocumentAnalysis](API_GetDocumentAnalysis.md)o para[GetDocumentAnalysis](API_GetDocumentAnalysis.md). Código de estado HTTP: 400 ** InvalidKMSKeyException ** Indica que no tiene permisos de descifrado con la clave KMS introducida o que la clave KMS se ha introducido de forma incorrecta. Código de estado HTTP: 400 ** InvalidParameterException ** Un parámetro de entrada infringió una restricción. Por ejemplo, en operaciones sincrónicas, un`InvalidParameterException`se produce cuando ninguno de los`S3Object`o`Bytes`los valores se proporcionan en el`Document`parámetro de solicitud. Valide el parámetro antes de llamar a la operación de la API de nuevo. Código de estado HTTP: 400 ** InvalidS3ObjectException ** Amazon Textract Texact no puede obtener acceso al objeto de S3 especificado en la solicitud. Para obtener más información,[Configuración del acceso a Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Para obtener información sobre la resolución de problemas, consulte[Solución de problemas de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html) Código de estado HTTP: 400 ** ProvisionedThroughputExceededException ** El número de solicitudes ha superado su límite de rendimiento. Si quieres aumentar este límite, ponte en contacto con Amazon Textract. Código de estado HTTP: 400 ** ThrottlingException ** Amazon Textract Texact no puede procesar temporalmente la solicitud. Pruebe la llamada de nuevo. Código de estado HTTP: 500 ## Véase también Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte: + [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/GetExpenseAnalysis) + [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/GetExpenseAnalysis) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/GetExpenseAnalysis) + [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/GetExpenseAnalysis) + [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/GetExpenseAnalysis) + [AWS SDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/GetExpenseAnalysis) + [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/GetExpenseAnalysis) + [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/GetExpenseAnalysis) + [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/GetExpenseAnalysis)