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 ligandoStartExpenseAnalysis, 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 paraStartExpenseAnalysis
. 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 paraGetExpenseAnalysis
e passar o identificador de trabalho (JobId
) da chamada inicial paraStartExpenseAnalysis
.
Use o parâmetro MaxResults para limitar o número de blocos que são retornados. Se houver mais resultados do que o especificado emMaxResults
, o valor deNextToken
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 paraGetExpenseAnalysis
e preencher as UOsNextToken
parâmetro request com o valor do token retornado da chamada anterior paraGetExpenseAnalysis
.
Para obter mais informações, consulteAnalisando faturas e recibos.
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
-
Um identificador exclusivo para o trabalho de detecção de texto. O
JobId
é retornado doStartExpenseAnalysis
. UMAJobId
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
-
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
-
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
-
A versão atual do modelo do AnalyzeExpense.
Type: String
- DocumentMetadata
-
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
- ExpenseDocuments
-
As despesas detectadas pelo Amazon Textract.
Type: Matriz deExpenseDocumentobjetos
- JobStatus
-
O status atual do trabalho de detecção de texto.
Type: String
Valores válidos:
IN_PROGRESS | SUCCEEDED | FAILED | PARTIAL_SUCCESS
- NextToken
-
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
-
Retorna se o trabalho de detecção não puder ser concluído. Contém explicação para qual erro ocorreu.
Type: String
- Warnings
-
Uma lista de avisos ocorridos durante a operação de detecção de texto do documento.
Type: Matriz deWarningobjetos
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 paraGetDocumentAnalysisou paraGetDocumentAnalysis.
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 dosS3Object
ouBytes
valores são fornecidos noDocument
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 S3Para obter informações sobre a solução de problemas, consulteSolução de problemas do Amazon S3
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: