翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

請求書と受信レスポンスオブジェクト

請求書または領収書を AnalyzeExpense API に送信すると、一連の ExpenseDocuments オブジェクトが返されます。各ExpenseDocumentはさらに LineItemGroupsと に分割されますSummaryFields。ほとんどの請求書と領収書には、ベンダー名、領収書番号、領収書の日付、合計金額などの情報が含まれています。AnalyzeExpense は、この情報を で返しますSummaryFields。領収書と請求書には、購入したアイテムに関する詳細も含まれています。AnalyzeExpense API は、この情報を で返しますLineItemGroups。ExpenseIndex フィールドは経費を一意に識別し、その経費で適切な SummaryFields とLineItemGroups検出された を関連付けます。最後に、経費分析はBlockオブジェクトを返し、ドキュメントのテキスト検出と同じ情報を提供します。

アドレスや名前などの特定の情報は、単一のレスポンスに基づいて識別するのが難しい場合があります。経費分析では、 オブジェクトExpenseGroupPropertiesを使用して否定的なレスポンスを区別します。このオブジェクトには、次のリストからのタイプが含まれています。

これらのタイプは、レスポンスの異なるグループを区別します。同じグループに属する複数の要素は識別番号を介して接続され、 にも返されますExpenseGroupProperties。

AnalyzeExpense レスポンスの最も詳細なレベルのデータはType、、ValueDetection、および LabelDetection (オプション) で構成されます。個々のエンティティは次のとおりです。

AnalyzeExpense API はITEM、行項目PRICE内の 、QUANTITY、および を正規化されたフィールドとして検出します。SKU や詳細な説明など、受信イメージの明細項目に他のテキストがある場合、JSON には として含まれますEXPENSE_ROW。これを次の例で示します:

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

前の例は、AnalyzeExpense API オペレーションが、2.5 USD で販売された 5 つのバナナに関する明細項目情報を含む受信時に行全体をどのように返すかを示しています。

タイプ

以下は、キーと値のペアの標準型または正規化型の例です。

               {
                    "PageNumber": 1, 
                    "Type": {
                        "Text": "VENDOR_NAME", 
                        "Confidence": 70.0
                    }, 
                    "ValueDetection": {
                        "Geometry": { ... }, 
                        "Text": "AMAZON", 
                        "Confidence": 87.89806365966797
                    }
                }
           

受信に「ベンダー名」が明示的にリストされていません。ただし、経費分析 API は値「AMAZON」をタイプ として認識しましたVENDOR_NAME。

LabelDetection

以下は、顧客ドキュメントページに表示されるテキストの例です。

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

サンプルドキュメントには「CASHIER Mina」が含まれていました。経費分析 API はそのまま値を抽出し、 で返しますLabelDetection。受信に「キー」が明示的に表示されていない「請求日」などの暗黙的な値の場合、 LabelDetection は AnalyzeExpense 要素に含まれません。このような場合、AnalyzeExpense API オペレーションは を返しませんLabelDetection。

ValueDetection

以下は、キーと値のペアの「値」を示す例です。

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

この例では、ドキュメントに「CASHIER Mina」が含まれていました。AnalyzeExpense API は、より詳細な値を Mina として検出し、 で返しましたValueDetection。