Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Objets de réponse aux factures et aux reçus
Lorsque vous soumettez une facture ou un reçu à l' AnalyzeExpense API, celle-ci renvoie une série d' ExpenseDocuments objets. Chacun ExpenseDocument est ensuite séparé en `LineItemGroups` et`SummaryFields`. La plupart des factures et reçus contiennent des informations telles que le nom du fournisseur, le numéro du reçu, la date de réception ou le montant total. AnalyzeExpense renvoie ces informations sous`SummaryFields`. Les reçus et les factures contiennent également des détails sur les articles achetés. L' AnalyzeExpense API renvoie ces informations sous`LineItemGroups`. Le `ExpenseIndex` champ identifie de manière unique la dépense et associe les dépenses appropriées `SummaryFields` et `LineItemGroups` détectées dans cette dépense. Enfin, l'analyse des dépenses renverra un `Block` objet, vous donnant les mêmes informations que la détection de texte sur votre document.
Certaines informations, telles que les adresses et les noms, peuvent être difficiles à distinguer sur la base d'une seule réponse. L'analyse des dépenses utilise l'objet `ExpenseGroupProperties` pour aider à distinguer les réponses nébuleuses. Cet objet contient un type de la liste suivante :
+ VENDOR\_REMIT\_TO
+ RECEIVER\_SHIP\_TO
+ RÉCEPTEUR\_VENDU À
+ RECEVEUR\_BILL\_TO
+ FOURNISSEUR\_FOURNISSEUR
Ces types font la distinction entre les différents groupes de réponses. Plusieurs éléments appartenant au même groupe sont connectés via un numéro d'identification, également renvoyé`ExpenseGroupProperties`.
Le niveau de données le plus détaillé de la AnalyzeExpense réponse est le suivant : `Type``ValueDetection`, et `LabelDetection` (Facultatif). Les entités individuelles sont les suivantes :
+ [Type](#how-it-works-type): fait référence au type d'information détecté à un niveau élevé.
+ [LabelDetection](#how-it-works-labeldetection): fait référence à l'étiquette d'une valeur associée dans le texte du document. `LabelDetection`est facultatif et renvoyé uniquement si l'étiquette est écrite.
+ [ValueDetection](#how-it-works-valuedetection): fait référence à la valeur de l'étiquette ou du type renvoyé.
L' AnalyzeExpense API détecte également `ITEM``QUANTITY`, et `PRICE` dans les éléments de ligne sous forme de champs normalisés. S'il existe un autre texte dans une ligne figurant sur l'image du reçu, tel qu'un SKU ou une description détaillée, il sera inclus dans le JSON sous la forme`EXPENSE_ROW`. comme illustré dans l’exemple suivant :
```
{
"Type": {
"Text": "EXPENSE_ROW",
"Confidence": 99.95216369628906
},
"ValueDetection": {
"Text": "Banana 5 $2.5",
"Geometry": {
…
},
"Confidence": 98.11214447021484
}
```
L'exemple précédent montre comment l'opération AnalyzeExpense API renvoie la ligne entière d'un reçu contenant les informations relatives à 5 bananes vendues pour 2,5$.
## Type
Voici un exemple du type standard ou normalisé de la paire clé-valeur :
```
{
"PageNumber": 1,
"Type": {
"Text": "VENDOR_NAME",
"Confidence": 70.0
},
"ValueDetection": {
"Geometry": { ... },
"Text": "AMAZON",
"Confidence": 87.89806365966797
}
}
```
Le « nom du fournisseur » ne figurait pas explicitement sur le reçu. Cependant, l'API Analyze Expense a reconnu la valeur « AMAZON » comme type`VENDOR_NAME`.
## LabelDetection
Voici un exemple de texte tel qu'il apparaît sur la page d'un document client :
```
{
"PageNumber": 1,
"Type": {
"Text": "OTHER",
"Confidence": 70.0
},
"LabelDetection": {
"Geometry": { ... },
"Text": "CASHIER",
"Confidence": 88.19171142578125
},
"ValueDetection": {
"Geometry": { ... },
"Text": "Mina",
"Confidence": 87.89806365966797
}
}
```
Le document d'exemple contenait « CASHIER Mina ». L'API Analyze Expense a extrait la valeur telle quelle et la renvoie sous`LabelDetection`. Les valeurs implicites telles que la « date de facture », pour lesquelles la « clé » n'est pas explicitement indiquée sur le reçu, ne `LabelDetection` seront pas incluses dans l' AnalyzeExpense élément. Dans de tels cas, l'opération AnalyzeExpense d'API n'est pas renvoyée`LabelDetection`.
## ValueDetection
L'exemple suivant montre la « valeur » de la paire clé-valeur.
```
{
"PageNumber": 1,
"Type": {
"Text": "OTHER",
"Confidence": 70.0
},
"LabelDetection": {
"Geometry": { ... },
"Text": "CASHIER",
"Confidence": 88.19171142578125
},
"ValueDetection": {
"Geometry": { ... },
"Text": "Mina",
"Confidence": 87.89806365966797
}
}
```
Dans l'exemple, le document contenait « CASHIER Mina ». L' AnalyzeExpense API a détecté la valeur du caissier comme étant Mina et l'a renvoyée sous`ValueDetection`.