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á. # GetExpenseAnalysis Obtém os resultados de uma operação assíncrona do Amazon Textract que analisa faturas e recibos. Amazon Textract encontra informações de contato, itens comprados e nome do fornecedor, a partir de faturas e recibos de entrada. Você inicia a análise assíncrona de fatura/recebimento ligando[StartExpenseAnalysis](API_StartExpenseAnalysis.md), que retorna um identificador de trabalho (`JobId`). Após a conclusão da análise de fatura/recebimento, o Amazon Textract publica o status de conclusão no tópico do Amazon Simple Notification Service (Amazon SNS). Este tópico deve ser registrado na chamada inicial para`StartExpenseAnalysis`. Para obter os resultados da operação de análise de fatura/recebimento, primeiro verifique se o valor de status publicado no tópico do Amazon SNS é`SUCCEEDED`. Em caso afirmativo, ligue para`GetExpenseAnalysis`e passar o identificador de trabalho (`JobId`) da chamada inicial para`StartExpenseAnalysis`. Use o parâmetro MaxResults para limitar o número de blocos que são retornados. Se houver mais resultados do que o especificado em`MaxResults`, o valor de`NextToken`Na resposta da operação contém um token de paginação para obter o próximo conjunto de resultados. Para obter a próxima página de resultados, ligue para`GetExpenseAnalysis`e preencher as UOs`NextToken`parâmetro request com o valor do token retornado da chamada anterior para`GetExpenseAnalysis`. Para obter mais informações, consulte[Analisando faturas e recibos](https://docs.aws.amazon.com/textract/latest/dg/invoices-receipts.html). ## Sintaxe da solicitação ``` { "JobId": "string", "MaxResults": number, "NextToken": "string" } ``` ## Parâmetros de solicitação A solicitação aceita os dados a seguir no formato JSON. ** [JobId](#API_GetExpenseAnalysis_RequestSyntax) ** Um identificador exclusivo para o trabalho de detecção de texto. O`JobId`é retornado do`StartExpenseAnalysis`. UMA`JobId`O valor é válido apenas por 7 dias. Type: String Restrições de comprimento: Tamanho mínimo de 1. Tamanho máximo de 64. Padrão: `^[a-zA-Z0-9-_]+$` : obrigatório Sim ** [MaxResults](#API_GetExpenseAnalysis_RequestSyntax) ** O número máximo de resultados a serem retornados por chamada paginada. O maior valor que você pode especificar é 20. Se você especificar um valor maior que 20, um máximo de 20 resultados será retornado. O valor padrão é 20. Type: Inteiro Intervalo válido: Valor mínimo de 1. : obrigatório Não ** [NextToken](#API_GetExpenseAnalysis_RequestSyntax) ** Se a resposta anterior estiver incompleta (porque há mais blocos para recuperar), o Amazon Textract retornará um token de paginação na resposta. Você pode usar esse token de paginação para recuperar o próximo conjunto de blocos. Type: String Restrições de comprimento: Tamanho mínimo de 1. Tamanho máximo de 255. Padrão: `.*\S.*` : obrigatório Não ## Sintaxe da resposta ``` { "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 resposta Se a ação for bem-sucedida, o serviço reenviará uma resposta HTTP 200. Os seguintes dados são retornados no formato JSON pelo serviço. ** [AnalyzeExpenseModelVersion](#API_GetExpenseAnalysis_ResponseSyntax) ** A versão atual do modelo do AnalyzeExpense. Type: String ** [DocumentMetadata](#API_GetExpenseAnalysis_ResponseSyntax) ** Informações sobre um documento que o Amazon Textract processou.`DocumentMetadata`é retornado em todas as páginas de respostas paginadas de uma operação Amazon Textract. Tipo: objeto [DocumentMetadata](API_DocumentMetadata.md) ** [ExpenseDocuments](#API_GetExpenseAnalysis_ResponseSyntax) ** As despesas detectadas pelo Amazon Textract. Type: Matriz de[ExpenseDocument](API_ExpenseDocument.md)objetos ** [JobStatus](#API_GetExpenseAnalysis_ResponseSyntax) ** O status atual do trabalho de detecção de texto. Type: String Valores válidos:` IN_PROGRESS | SUCCEEDED | FAILED | PARTIAL_SUCCESS` ** [NextToken](#API_GetExpenseAnalysis_ResponseSyntax) ** Se a resposta for truncada, o Amazon Textract retornará esse token. Você pode usar esse token na solicitação subsequente para recuperar o próximo conjunto de resultados de detecção de texto. Type: String Restrições de comprimento: Tamanho mínimo de 1. Tamanho máximo de 255. Padrão: `.*\S.*` ** [StatusMessage](#API_GetExpenseAnalysis_ResponseSyntax) ** Retorna se o trabalho de detecção não puder ser concluído. Contém explicação para qual erro ocorreu. Type: String ** [Warnings](#API_GetExpenseAnalysis_ResponseSyntax) ** Uma lista de avisos ocorridos durante a operação de detecção de texto do documento. Type: Matriz de[Warning](API_Warning.md)objetos ## Erros ** AccessDeniedException ** Você não está autorizado a executar a ação. Use o nome de recurso da Amazon (ARN) de um usuário autorizado ou a função do IAM para executar a operação. Código de status HTTP: 400 ** InternalServerError ** O Amazon Textract teve um problema de serviço. Tente fazer a chamada novamente. Código de status HTTP: 500 ** InvalidJobIdException ** Um identificador de trabalho inválido foi passado para[GetDocumentAnalysis](API_GetDocumentAnalysis.md)ou para[GetDocumentAnalysis](API_GetDocumentAnalysis.md). Código de status HTTP: 400 ** InvalidKMSKeyException ** Indica que você não tem permissões de descriptografia com a chave KMS inserida ou a chave KMS foi inserida incorretamente. Código de status HTTP: 400 ** InvalidParameterException ** Um parâmetro de entrada violou uma restrição. Por exemplo, em operações síncronas, um`InvalidParameterException`exceção ocorre quando nenhum dos`S3Object`ou`Bytes`valores são fornecidos no`Document`Parâmetro de solicitação. Valide seu parâmetro antes de chamar a operação de API novamente. Código de status HTTP: 400 ** InvalidS3ObjectException ** O Amazon Textract não pode acessar o objeto do S3 especificado na solicitação. para obter mais informações,[Configuração de acesso ao Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Para obter informações sobre a solução de problemas, consulte[Solução de problemas do Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html) Código de status HTTP: 400 ** ProvisionedThroughputExceededException ** O número de solicitações excedeu o limite da taxa de transferência. Se quiser aumentar esse limite, entre em contato com o Amazon Textract. Código de status HTTP: 400 ** ThrottlingException ** O Amazon Textract está temporariamente indisponível para processar a solicitação. Tente fazer a chamada novamente. Código de status HTTP: 500 ## Consulte também Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte: + [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/GetExpenseAnalysis) + [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/GetExpenseAnalysis) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/GetExpenseAnalysis) + [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/GetExpenseAnalysis) + [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/GetExpenseAnalysis) + [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/GetExpenseAnalysis) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/GetExpenseAnalysis) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/GetExpenseAnalysis) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/GetExpenseAnalysis)