

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 de facture et de réception
<a name="expensedocuments"></a>

Lorsque vous soumettez une facture ou un reçu à l'API AnalyzeExpense, il renvoie une série d'objets ExpenseDocuments. Chaque document ExpenseDocument est séparé en`LineItemGroups`et`SummaryFields`. La plupart des factures et des reçus contiennent des informations telles que le nom du fournisseur, le numéro de réception, la date de réception ou le montant total. AnalyzeExpense renvoie ces informations sous`SummaryFields`. Les reçus et les factures contiennent également des informations sur les articles achetés. L'API AnalyzeExpense renvoie ces informations sous`LineItemGroups`. Le`ExpenseIndex`identifie de manière unique la dépense et associe le champ approprié`SummaryFields`et`LineItemGroups`détectés dans cette dépense.

Le niveau de données le plus granulaire de la réponse AnalyzeExpense consiste en :`Type`,`ValueDetection`, et`LabelDetection`(Facultatif). Les entités individuelles sont les suivantes :
+ [Type](how-it-works-type.md): désigne le type d'information détecté à un niveau élevé.
+ [Détection d'étiquettes](how-it-works-labeldetection.md): fait référence à l'étiquette d'une valeur associée dans le texte du document.`LabelDetection`est facultatif et n'est renvoyé que si l'étiquette est écrite.
+ [Détection de valeur](how-it-works-valuedetection.md): fait référence à la valeur de l'étiquette ou du type renvoyé.

L'API AnalyzeExpense détecte également`ITEM`,`QUANTITY`, et`PRICE`dans les éléments de ligne sous forme de champs normalisés. S'il y a un autre texte dans une ligne sur l'image de réception, tel que le SKU ou la description détaillée, il sera inclus dans le JSON comme suit :`EXPENSE_ROW`comme illustré dans l'exemple ci-dessous :

```
               {
                                    "Type": {
                                        "Text": "EXPENSE_ROW",
                                        "Confidence": 99.95216369628906
                                    },
                                    "ValueDetection": {
                                        "Text": "Banana 5 $2.5",
                                        "Geometry": {
                                          …
                                        },
                                        "Confidence": 98.11214447021484
                                    }
```

L'exemple ci-dessus montre comment l'API AnalyzeExpense renvoie la ligne entière d'un reçu contenant des informations de ligne sur 5 bananes vendues pour 2,5\$1. 

# Type
<a name="how-it-works-type"></a>

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 vendeur » ne figurait pas explicitement sur le reçu. Toutefois, l'API Analyze Expense a reconnu le document comme un reçu et a classé la valeur « AMAZON » comme Type`VENDOR_NAME`. 

# Détection d'étiquettes
<a name="how-it-works-labeldetection"></a>

Voici un exemple de texte tel qu'il est affiché sur une page de document client :

```
               {
                    "PageNumber": 1, 
                    "Type": {
                        "Text": "OTHER", 
                        "Confidence": 70.0
                    }, 
                    "LabelDetection": {
                        "Geometry": { ... }, 
                        "Text": "CASHIER", 
                        "Confidence": 88.19171142578125
                    }, 
                    "ValueDetection": {
                        "Geometry": { ... }, 
                        "Text": "Mina", 
                        "Confidence": 87.89806365966797
                    }
                }
```

L'exemple de document contenait « CAISSIER Mina ». L'API Analyze Expense a extrait la valeur telle quelle et la renvoie sous`LabelDetection`. Pour les valeurs implicites telles que « Nom du vendeur », où la « clé » n'est pas explicitement affichée dans le reçu,`LabelDetection`ne sera pas inclus dans l'élément AnalyzeExpense. Dans ce cas, l'API AnalyzeExpense ne renvoie pas`LabelDetection`. 

# Détection de valeur
<a name="how-it-works-valuedetection"></a>

L'exemple suivant illustre 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 cet exemple, le document contenait « CAISSIER Mina ». L'API AnalyzeExpense a détecté la valeur Caissier comme Mina et l'a renvoyée sous`ValueDetection`. 