

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 인보이스 및 수신 응답 객체
<a name="expensedocuments"></a>

AnalyzeExpense API에 인보이스 또는 영수증을 제출하면 일련의 ExpenseDocuments 객체가 반환됩니다. 각 ExpenseDocument는 `LineItemGroups` 및 로 추가로 구분됩니다`SummaryFields`. 대부분의 인보이스 및 영수증에는 공급업체 이름, 영수증 번호, 영수증 날짜 또는 총 금액과 같은 정보가 포함됩니다. AnalyzeExpense는에서이 정보를 반환합니다`SummaryFields`. 영수증과 인보이스에는 구매한 항목에 대한 세부 정보도 포함됩니다. AnalyzeExpense API는에서이 정보를 반환합니다`LineItemGroups`. `ExpenseIndex` 필드는 비용을 고유하게 식별하고 해당 비용에서 감지`SummaryFields``LineItemGroups`된 적절한를 연결합니다. 마지막으로 비용 분석은 `Block` 객체를 반환하여 문서의 텍스트 감지와 동일한 정보를 제공합니다.

주소 및 이름과 같은 특정 정보는 단일 응답을 기반으로 구분하기 어려울 수 있습니다. 비용 분석은 객체를 사용하여 모호한 응답을 구분`ExpenseGroupProperties`하는 데 도움이 됩니다. 이 객체에는 다음 목록의 유형이 포함됩니다.
+ 공급업체\_REMIT\_TO
+ RECEIVER\_SHIP\_TO
+ RECEIVER\_SOLD\_TO
+ 수신자\_빌\_TO
+ 공급업체

이러한 유형은 서로 다른 응답 그룹을 구분합니다. 동일한 그룹에 속하는 여러 요소는 식별 번호를 통해 연결되며 에도 반환됩니다`ExpenseGroupProperties`.

AnalyzeExpense 응답에서 가장 세분화된 수준의 데이터는 `Type`, `ValueDetection`및 `LabelDetection` (선택 사항)로 구성됩니다. 개별 개체는 다음과 같습니다.
+ [유형](#how-it-works-type): 어떤 종류의 정보가 높은 수준에서 탐지되는지를 나타냅니다.
+ [LabelDetection](#how-it-works-labeldetection): 문서 텍스트 내에서 연결된 값의 레이블을 나타냅니다. `LabelDetection`는 선택 사항이며 레이블이 작성된 경우에만 반환됩니다.
+ [ValueDetection](#how-it-works-valuedetection): 반환된 레이블 또는 유형의 값을 나타냅니다.

AnalyzeExpense API는 행 항목 `PRICE` 내의 `ITEM``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에 판매된 5개의 바나나에 대한 품목 정보가 포함된 영수증의 전체 행을 반환하는 방법을 보여줍니다.

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

다음은 키-값 페어의 표준 또는 정규화된 유형의 예입니다.

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

영수증에 “벤더 이름”이 명시적으로 나열되지 않았습니다. 그러나 비용 분석 API는 "AMAZON" 값을 유형 으로 인식했습니다`VENDOR_NAME`.

## LabelDetection
<a name="how-it-works-labeldetection"></a>

다음은 고객 문서 페이지에 표시된 텍스트의 예입니다.

```
               {
                    "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`. “키”가 수신에 명시적으로 표시되지 않는 “인보이스 날짜”와 같은 암시적 값의 경우 AnalyzeExpense 요소에 포함되지 `LabelDetection` 않습니다. 이러한 경우 AnalyzeExpense API 작업은를 반환하지 않습니다`LabelDetection`.

## ValueDetection
<a name="how-it-works-valuedetection"></a>

다음은 키-값 페어의 “값”을 보여주는 예제입니다.

```
               {
                    "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가 미나로 데시어 값을 감지하고 아래에 반환했습니다`ValueDetection`.