Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
GetExpenseAnalysis
Ottiene i risultati di un'operazione asincrona Amazon Textract che analizza fatture e ricevute. Amazon Textract trova le informazioni di contatto, gli articoli acquistati e il nome del fornitore, dalle fatture di input e dalle ricevute.
Si avvia l'analisi asincrona di fattura/ricevuta chiamandoStartExpenseAnalysis, che restituisce un identificatore di lavoro (JobId
). Al termine dell'analisi di fattura/ricevuta, Amazon Textract pubblica lo stato di completamento nell'argomento Amazon Simple Notification Service (Amazon SNS). Questo argomento deve essere registrato nella chiamata iniziale aStartExpenseAnalysis
. Per ottenere i risultati dell'operazione di analisi fattura/ricevuta, accertati prima che il valore di stato pubblicato nell'argomento Amazon SNS sia.SUCCEEDED
. Se è così, chiamaGetExpenseAnalysis
e passa l'identificativo del processo (JobId
) dalla chiamata iniziale aStartExpenseAnalysis
.
Utilizza il parametro MaxResults per limitare il numero di blocchi restituiti. Se ci sono più risultati di quelli specificati inMaxResults
, il valore diNextToken
nella risposta operativa contiene un token di impaginazione per ottenere il successivo set di risultati. Per visualizzare la pagina di risultati successiva, chiamaGetExpenseAnalysis
e popolare ilNextToken
parametro request con il valore del token restituito dalla chiamata precedente aGetExpenseAnalysis
.
Per ulteriori informazioni, consultaAnalisi di fatture e ricevute.
Sintassi della richiesta
{
"JobId": "string
",
"MaxResults": number
,
"NextToken": "string
"
}
Parametri della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- JobId
-
L'identificatore univoco per il processo di rilevamento del testo. La
JobId
viene restituito daStartExpenseAnalysis
. UNJobId
il valore è valido solo per 7 giorni.Type: Stringa
Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Modello:
^[a-zA-Z0-9-_]+$
Campo obbligatorio: Sì
- MaxResults
-
Numero massimo di risultati da restituire per ogni chiamata impaginata. Il valore maggiore che puoi specificare è 20. Se si specifica un valore maggiore di 20, vengono restituiti al massimo 20 risultati. Il valore predefinito è 20.
Type: Numero intero
Intervallo valido: Valore minimo di 1.
Campo obbligatorio: No
- NextToken
-
Se la risposta precedente era incompleta (perché ci sono più blocchi da recuperare), Amazon Textract restituisce un token di impaginazione nella risposta. È possibile utilizzare questo token per recuperare il successivo set di blocchi.
Type: Stringa
Vincoli di lunghezza: Lunghezza minima pari a 1. Lunghezza massima di 255.
Modello:
.*\S.*
Campo obbligatorio: No
Sintassi della risposta
{
"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 ]
}
]
}
Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- AnalyzeExpenseModelVersion
-
La versione attuale del modello di AnalyzeExpense.
Type: Stringa
- DocumentMetadata
-
Informazioni su un documento elaborato da Amazon Textract.
DocumentMetadata
viene restituito in ogni pagina delle risposte impaginate da un'operazione Amazon Textract.Tipo: DocumentMetadata oggetto
- ExpenseDocuments
-
Le spese rilevate da Amazon Textract.
Type: Matrice diExpenseDocumentoggetti
- JobStatus
-
Lo stato corrente del processo di rilevamento del testo.
Type: Stringa
Valori validi:
IN_PROGRESS | SUCCEEDED | FAILED | PARTIAL_SUCCESS
- NextToken
-
Se la risposta viene troncata, Amazon Textract restituisce questo token. È possibile utilizzare questo token nella richiesta seguente per recuperare il successivo set di risultati di rilevamento del testo.
Type: Stringa
Vincoli di lunghezza: Lunghezza minima pari a 1. Lunghezza massima di 255.
Modello:
.*\S.*
- StatusMessage
-
Restituisce se non è stato possibile completare il processo di rilevamento. Contiene una spiegazione per quale errore si è verificato.
Type: Stringa
- Warnings
-
Un elenco di avvisi verificati durante l'operazione di rilevamento del testo per il documento.
Type: Matrice diWarningoggetti
Errori
- AccessDeniedException
-
Non sei autorizzato a eseguire l'operazione. Utilizzare l'ARN (Amazon Resource Name) di un utente autorizzato o un ruolo IAM per eseguire l'operazione.
Codice di stato HTTP: 400
- InternalServerError
-
Amazon Textract ha riscontrato un problema del servizio. Riprova la chiamata.
Codice di stato HTTP: 500
- InvalidJobIdException
-
È stato passato un identificatore di lavoro non validoGetDocumentAnalysiso aGetDocumentAnalysis.
Codice di stato HTTP: 400
- InvalidKMSKeyException
-
Indica che non si dispone delle autorizzazioni di decrittografia con la chiave KMS immessa o che la chiave KMS è stata immessa in modo errato.
Codice di stato HTTP: 400
- InvalidParameterException
-
Un parametro di input ha violato un vincolo. Ad esempio, nelle operazioni sincrone, un
InvalidParameterException
eccezione si verifica quando nessuno dei dueS3Object
oBytes
i valori sono forniti nelDocument
parametro della richiesta. Convalida il parametro prima di chiamare nuovamente l'operazione API.Codice di stato HTTP: 400
- InvalidS3ObjectException
-
Amazon Textract non è in grado di accedere all'oggetto S3 specificato nella richiesta. Per ulteriori informazioni,Configura l'accesso ad Amazon S3Per informazioni sulla risoluzione dei problemi, consultaRisoluzione dei problemi Amazon S3
Codice di stato HTTP: 400
- ProvisionedThroughputExceededException
-
Il numero di richieste ha superato il limite di throughput. Per aumentare questo limite, contatta Amazon Textract.
Codice di stato HTTP: 400
- ThrottlingException
-
Amazon Textract non è temporaneamente in grado di elaborare la richiesta. Riprova la chiamata.
Codice di stato HTTP: 500
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: