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 etSummaryFields. 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 sousSummaryFields. Les reçus et les factures contiennent également des détails sur les articles achetés. L' AnalyzeExpense API renvoie ces informations sousLineItemGroups. 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 :

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 : TypeValueDetection, et LabelDetection (Facultatif). Les entités individuelles sont les suivantes :

L' AnalyzeExpense API détecte également ITEMQUANTITY, 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 formeEXPENSE_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 typeVENDOR_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 sousLabelDetection. 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éeLabelDetection.

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 sousValueDetection.