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à.
# AnalyzeExpense
`AnalyzeExpense`analizza in modo sincrono un documento di input per le relazioni finanziarie tra testo.
Le informazioni vengono restituite come`ExpenseDocuments`e separato come segue.
+ `LineItemGroups`- Un set di dati contenente`LineItems`che memorizzano informazioni sulle righe di testo, come un articolo acquistato e il suo prezzo su una ricevuta.
+ `SummaryFields`- Contiene tutte le altre informazioni di una ricevuta, come le informazioni sull'intestazione o il nome del fornitore.
## Sintassi della richiesta
```
{
"Document": {
"Bytes": blob,
"S3Object": {
"Bucket": "string",
"Name": "string",
"Version": "string"
}
}
}
```
## Parametri della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [Document](#API_AnalyzeExpense_RequestSyntax) **
Il documento di input, sia come byte che come oggetto S3.
È possibile trasmettere i byte di immagine a un'operazione API di Amazon Textract utilizzando la`Bytes`proprietà. Ad esempio, è possibile utilizzare la`Bytes`proprietà per passare un documento caricato da un file system locale. Byte immagine passati usando il`Bytes`la proprietà deve essere codificata in base64. Il codice potrebbe non aver bisogno di codificare i byte dei file dei documenti se utilizzi un SDK AWS per chiamare le operazioni dell'API Amazon Textract.
È possibile trasmettere le immagini archiviate in un bucket S3 a un'operazione API Amazon Textract di utilizzando la`S3Object`proprietà. I documenti archiviati in un bucket S3 non devono essere codificati con Base64.
La regione AWS per il bucket S3 contenente l'oggetto S3 deve corrispondere alla regione AWS utilizzata per le operazioni Amazon Textract.
Se si utilizza AWS CLI per richiamare le operazioni Amazon Textract, la trasmissione dei byte di immagine utilizzando la proprietà Bytes non è supportata. È necessario prima caricare il documento in un bucket Amazon S3, quindi richiamare l'operazione utilizzando la proprietà S3Object.
Per consentire ad Amazon Textract di elaborare un oggetto S3, l'utente deve disporre dell'autorizzazione per accedere all'oggetto S3.
Tipo: [Document](API_Document.md) oggetto
Campo obbligatorio: Sì
## Sintassi della risposta
```
{
"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"
}
}
]
}
]
}
```
## 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.
** [DocumentMetadata](#API_AnalyzeExpense_ResponseSyntax) **
Informazioni sul documento di input.
Tipo: [DocumentMetadata](API_DocumentMetadata.md) oggetto
** [ExpenseDocuments](#API_AnalyzeExpense_ResponseSyntax) **
Le spese rilevate da Amazon Textract.
Type: Matrice di[ExpenseDocument](API_ExpenseDocument.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
** BadDocumentException **
Amazon Textract non è in grado di leggere il documento. Per ulteriori informazioni sui limiti dei documenti in Amazon Textract, consulta[Limiti rigidi per Amazon Textract](limits.md).
Codice di stato HTTP: 400
** DocumentTooLargeException **
Il documento non può essere elaborato perché è troppo grande. La dimensione massima dei documenti per le operazioni sincrone 10 MB. La dimensione massima del documento per le operazioni asincrone è di 500 MB per i file PDF.
Codice di stato HTTP: 400
** InternalServerError **
Amazon Textract ha riscontrato un problema del servizio. Riprova la chiamata.
Codice di stato HTTP: 500
** 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 di richiesta. Convalida il parametro prima di richiamare 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
** UnsupportedDocumentException **
Il formato del documento di input non è supportata. I documenti per le operazioni possono essere in formato PNG, JPEG, PDF o TIFF.
Codice di stato HTTP: 400
## 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/AnalyzeExpense)
+ [SDK AWS per .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/AnalyzeExpense)
+ [SDK AWS per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/AnalyzeExpense)
+ [SDK AWS per Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/AnalyzeExpense)
+ [AWSSDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/AnalyzeExpense)
+ [SDK AWS per JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/AnalyzeExpense)
+ [SDK AWS per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/AnalyzeExpense)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/AnalyzeExpense)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/AnalyzeExpense)