GetExpenseAnalysis - Amazon Textract

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ì, chiamaGetExpenseAnalysise 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 diNextTokennella risposta operativa contiene un token di impaginazione per ottenere il successivo set di risultati. Per visualizzare la pagina di risultati successiva, chiamaGetExpenseAnalysise popolare ilNextTokenparametro 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. LaJobIdviene restituito daStartExpenseAnalysis. UNJobIdil 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.DocumentMetadataviene 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, unInvalidParameterExceptioneccezione si verifica quando nessuno dei dueS3ObjectoBytesi valori sono forniti nelDocumentparametro 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: