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 chiamando[StartExpenseAnalysis](API_StartExpenseAnalysis.md), 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 a`StartExpenseAnalysis`. 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ì, chiama`GetExpenseAnalysis`e passa l'identificativo del processo (`JobId`) dalla chiamata iniziale a`StartExpenseAnalysis`. Utilizza il parametro MaxResults per limitare il numero di blocchi restituiti. Se ci sono più risultati di quelli specificati in`MaxResults`, il valore di`NextToken`nella risposta operativa contiene un token di impaginazione per ottenere il successivo set di risultati. Per visualizzare la pagina di risultati successiva, chiama`GetExpenseAnalysis`e popolare il`NextToken`parametro request con il valore del token restituito dalla chiamata precedente a`GetExpenseAnalysis`. Per ulteriori informazioni, consulta[Analisi di fatture e ricevute](https://docs.aws.amazon.com/textract/latest/dg/invoices-receipts.html). ## Sintassi della richiesta ``` { "JobId": "string", "MaxResults": number, "NextToken": "string" } ``` ## Parametri della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [JobId](#API_GetExpenseAnalysis_RequestSyntax) ** L'identificatore univoco per il processo di rilevamento del testo. La`JobId`viene restituito da`StartExpenseAnalysis`. UN`JobId`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](#API_GetExpenseAnalysis_RequestSyntax) ** 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](#API_GetExpenseAnalysis_RequestSyntax) ** 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](#API_GetExpenseAnalysis_ResponseSyntax) ** La versione attuale del modello di AnalyzeExpense. Type: Stringa ** [DocumentMetadata](#API_GetExpenseAnalysis_ResponseSyntax) ** Informazioni su un documento elaborato da Amazon Textract.`DocumentMetadata`viene restituito in ogni pagina delle risposte impaginate da un'operazione Amazon Textract. Tipo: [DocumentMetadata](API_DocumentMetadata.md) oggetto ** [ExpenseDocuments](#API_GetExpenseAnalysis_ResponseSyntax) ** Le spese rilevate da Amazon Textract. Type: Matrice di[ExpenseDocument](API_ExpenseDocument.md)oggetti ** [JobStatus](#API_GetExpenseAnalysis_ResponseSyntax) ** Lo stato corrente del processo di rilevamento del testo. Type: Stringa Valori validi: ` IN_PROGRESS | SUCCEEDED | FAILED | PARTIAL_SUCCESS` ** [NextToken](#API_GetExpenseAnalysis_ResponseSyntax) ** 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](#API_GetExpenseAnalysis_ResponseSyntax) ** Restituisce se non è stato possibile completare il processo di rilevamento. Contiene una spiegazione per quale errore si è verificato. Type: Stringa ** [Warnings](#API_GetExpenseAnalysis_ResponseSyntax) ** Un elenco di avvisi verificati durante l'operazione di rilevamento del testo per il documento. Type: Matrice di[Warning](API_Warning.md)oggetti ## 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 valido[GetDocumentAnalysis](API_GetDocumentAnalysis.md)o a[GetDocumentAnalysis](API_GetDocumentAnalysis.md). 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 due`S3Object`o`Bytes`i valori sono forniti nel`Document`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 S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Per informazioni sulla risoluzione dei problemi, consulta[Risoluzione dei problemi Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html) 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: + [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/GetExpenseAnalysis) + [SDK AWS per .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/GetExpenseAnalysis) + [SDK AWS per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/GetExpenseAnalysis) + [SDK AWS per Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/GetExpenseAnalysis) + [AWSSDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/GetExpenseAnalysis) + [SDK AWS per JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/GetExpenseAnalysis) + [SDK AWS per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/GetExpenseAnalysis) + [AWS SDK for 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)