Merge pull request #225129 from laujan/BemaBonsu/main

Bema bonsu/main

Author: American-Dipper

articles/applied-ai-services/form-recognizer/concept-id-document.md

@@ -200,7 +200,9 @@ Below are the fields extracted per document type. The Azure Form Recognizer ID m
 |:-----|:----:|:----:|:----:|:----:|:----:|:----:|:----:|:----:|
 |[prebuilt-idDocument](concept-id-document.md#field-extractions) | ✓ |   |   |  | ✓ |   |  | ✓ |
 
-### Document type - `idDocument.driverLicense` fields extracted
+### Document types
+
+#### `idDocument.driverLicense` fields extracted
 
 | Field | Type | Description | Example |
 |:------|:-----|:------------|:--------|
@@ -223,7 +225,7 @@ Below are the fields extracted per document type. The Azure Form Recognizer ID m
 |`Restrictions`|`string`|Restrictions|B|
 |`VehicleClassifications`|`string`|Vehicle classification|D|
 
-### Document type - `idDocument.passport` fields extracted
+#### `idDocument.passport` fields extracted
 
 | Field | Type | Description | Example |
 |:------|:-----|:------------|:--------|
@@ -254,7 +256,7 @@ Below are the fields extracted per document type. The Azure Form Recognizer ID m
 |`MachineReadableZone.DateOfExpiration`|`date`|Date of expiration|2019-05-05|
 |`MachineReadableZone.Sex`|`string`|Sex|F|
 
-### Document type - `idDocument.nationalIdentityCard` fields extracted
+#### `idDocument.nationalIdentityCard` fields extracted
 
 | Field | Type | Description | Example |
 |:------|:-----|:------------|:--------|
@@ -274,7 +276,7 @@ Below are the fields extracted per document type. The Azure Form Recognizer ID m
 |`Weight`|`string`|Weight|185LB|
 |`Sex`|`string`|Sex|M|
 
-### Document type - `idDocument.residencePermit` fields extracted
+#### `idDocument.residencePermit` fields extracted
 
 | Field | Type | Description | Example |
 |:------|:-----|:------------|:--------|
@@ -289,7 +291,7 @@ Below are the fields extracted per document type. The Azure Form Recognizer ID m
 |`PlaceOfBirth`|`string`|Place of birth|Germany|
 |`Category`|`string`|Permit category|DV2|
 
-### Document type - `idDocument.usSocialSecurityCard` fields extracted
+#### `idDocument.usSocialSecurityCard` fields extracted
 
 | Field | Type | Description | Example |
 |:------|:-----|:------------|:--------|
@@ -298,7 +300,7 @@ Below are the fields extracted per document type. The Azure Form Recognizer ID m
 |`LastName`|`string`|Surname|TALBOT|
 |`DateOfIssue`|`date`|Date of issue|08/12/2012|
 
-### Document type - `idDocument` field extracted
+#### `idDocument` field extracted
 
 |Name| Type | Description | Standardized output|
 |:-----|:----|:----|:----|

articles/applied-ai-services/form-recognizer/concept-invoice.md

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: conceptual
-ms.date: 11/14/2022
+ms.date: 01/25/2023
 ms.author: lajanuar
 recommendations: false
 ---
@@ -23,7 +23,14 @@ recommendations: false
 [!INCLUDE [applies to v2.1](includes/applies-to-v2-1.md)]
 ::: moniker-end
 
-The Form Recognizer invoice model combines powerful Optical Character Recognition (OCR) capabilities with invoice understanding models to analyze and extract key fields and line items from sales invoices. Invoices can be of various formats and quality including phone-captured images, scanned documents, and digital PDFs. The API analyzes invoice text; extracts key information such as customer name, billing address, due date, and amount due; and returns a structured JSON data representation. The model currently supports both English and Spanish invoices.
+The Form Recognizer invoice model uses powerful Optical Character Recognition (OCR) capabilities to analyze and extract key fields and line items from sales invoices, utility bills, and purchase orders. Invoices can be of various formats and quality including phone-captured images, scanned documents, and digital PDFs. The API analyzes invoice text; extracts key information such as customer name, billing address, due date, and amount due; and returns a structured JSON data representation. The model currently supports both English and Spanish invoices.
+
+**Supported document types:**
+
+* Invoices
+* Utility bills
+* Sales orders
+* Purchase orders
 
 ## Automated invoice processing
 
@@ -41,7 +48,7 @@ Automated invoice processing is the process of extracting key accounts payable f
 
 **Sample invoice processed with [Form Recognizer Sample Labeling tool](https://fott-2-1.azurewebsites.net)**:
 
-:::image type="content" source="media/invoice-example-new.jpg" alt-text="Screenshot of a sample invoice."::: 
+:::image type="content" source="media/invoice-example-new.jpg" alt-text="Screenshot of a sample invoice.":::
 
 ::: moniker-end
 
@@ -155,17 +162,17 @@ See how data, including customer information, vendor details, and line items, is
 ## Supported languages and locales
 
 >[!NOTE]
- > It's not necessary to specify a locale. This is an optional parameter. The Form Recognizer deep-learning technology will auto-detect the language of the text in your image.
-
-| Model | Language—Locale code | Default |
-|--------|:----------------------|:---------|
-|Invoice| <ul><li>English (United States)—en-US</li></ul>| English (United States)—en-US|
-|Invoice| <ul><li>Spanish—es</li></ul>| Spanish (United States)—es|
-|Invoice | <ul><li>German—de</li></ul>| German (Germany)-de|
-|Invoice | <ul><li>French—fr</li></ul>| French (France)—fr|
-|Invoice | <ul><li>Italian—it</li></ul>| Italian (Italy)—it|
-|Invoice | <ul><li>Portuguese—pt</li></ul>| Portuguese (Portugal)—pt|
-|Invoice | <ul><li>Dutch—nl</li></ul>| Dutch (Netherlands)—nl|
+> Form Recognizer auto-detects language and locale data.
+
+| Supported languages | Details |
+|:----------------------|:---------|
+| &bullet; English | United States (us), Australia (-au), Canada (-ca), Great Britain (-gb), India (-in)|
+| &bullet; Spanish |Spain (es)|
+| &bullet; German | Germany (de)|
+| &bullet; French | France (fr) |
+| &bullet; Italian | Italy (it)|
+| &bullet; Portuguese | Portugal (-pt), Brazil (-br)|
+| &bullet; Dutch | Netherlands (de)|
 
 ## Field extraction
 
@@ -200,10 +207,14 @@ See how data, including customer information, vendor details, and line items, is
 | ServiceStartDate | Date | First date for the service period (for example, a utility bill service period) | yyyy-mm-dd |
 | ServiceEndDate | Date | End date for the service period (for example, a utility bill service period) | yyyy-mm-dd|
 | PreviousUnpaidBalance | Number | Explicit previously unpaid balance | Integer |
+| CurrencyCode | String | The Currency Code associated with an extracted amount |  |
+| PaymentOptions | Array | An array that holds Payment Option details such as `IBAN`and `SWIFT` |  |
+| TotalDiscount | Number | The total discount applied to an invoice | Integer |
+| TaxItems (en-IN only) | Array | AN array that holds added tax information such as `CGST`, `IGST`, and `SGST`. This line item is currently only available for the en-in locale  |  |
 
 ### Line items
 
-Following are the line items extracted from an invoice in the JSON output response (the output below uses this [sample invoice](media/sample-invoice.jpg))
+Following are the line items extracted from an invoice in the JSON output response (the following output uses this [sample invoice](media/sample-invoice.jpg))
 
 |Name| Type | Description | Text (line item #1) | Value (standardized output) |
 |:-----|:----|:----|:----| :----|
@@ -215,7 +226,8 @@ Following are the line items extracted from an invoice in the JSON output respon
 | ProductCode | String| Product code, product number, or SKU associated with the specific line item | A123 | |
 | Unit | String| The unit of the line item, e.g,  kg, lb etc. | Hours | |
 | Date | Date| Date corresponding to each line item. Often it's a date the line item was shipped | 3/4/2021| 2021-03-04 |
-| Tax | Number | Tax associated with each line item. Possible values include tax amount, tax %, and tax Y/N | 10% | |
+| Tax | Number | Tax associated with each line item. Possible values include tax amount and tax Y/N | 10.00 | |
+| TaxRate | Number | Tax Rate associated with each line item. | 10% | |
 
 The invoice key-value pairs and line items extracted are in the `documentResults` section of the JSON output.
 
@@ -235,7 +247,7 @@ Keys can also exist in isolation when the model detects that a key exists, with
 
 ## Fields extracted
 
-The Invoice service will extract the text, tables, and 26 invoice fields. Following are the fields extracted from an invoice in the JSON output response (the output below uses this [sample invoice](media/sample-invoice.jpg)).
+The Invoice service will extract the text, tables, and 26 invoice fields. Following are the fields extracted from an invoice in the JSON output response (the following output uses this [sample invoice](media/sample-invoice.jpg)).
 
 |Name| Type | Description | Text | Value (standardized output) |
 |:-----|:----|:----|:----| :----|
@@ -266,7 +278,7 @@ The Invoice service will extract the text, tables, and 26 invoice fields. Follow
 | ServiceEndDate | date | End date for the service period (for example, a utility bill service period) | 11/14/2019 | 2019-11-14 |
 | PreviousUnpaidBalance | number | Explicit previously unpaid balance | $500.00 | 500 |
 
-Following are the line items extracted from an invoice in the JSON output response (the output below uses this [sample invoice](./media/sample-invoice.jpg))
+Following are the line items extracted from an invoice in the JSON output response (the following output uses this [sample invoice](./media/sample-invoice.jpg))
 
 |Name| Type | Description | Text (line item #1) | Value (standardized output) |
 |:-----|:----|:----|:----| :----|
@@ -310,4 +322,4 @@ The JSON output has three parts:
 
 * Complete a [Form Recognizer quickstart](quickstarts/get-started-sdks-rest-api.md?view=form-recog-2.1.0&preserve-view=true) and get started creating a document processing app in the development language of your choice.
 
-::: moniker-end
+::: moniker-end

articles/applied-ai-services/form-recognizer/concept-receipt.md

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: conceptual
-ms.date: 11/14/2022
+ms.date: 01/25/2023
 ms.author: lajanuar
 recommendations: false
 ---
@@ -157,20 +157,18 @@ See how data, including time and date of transactions, merchant information, and
 ## Supported languages and locales v3.0
 
 >[!NOTE]
-> It's not necessary to specify a locale. This is an optional parameter. The Form Recognizer deep-learning technology will auto-detect the language of the text in your image.
+> Form Recognizer auto-detects language and locale data.
 
 The receipt model supports all English receipts and the following locales:
 
-|Language| Locale code |
+|Supported Languages| Details |
 |:-----|:----:|
-|English (Australia)|`en-au`|
-|English (Canada)|`en-ca`|
-|English (United Kingdom)|`en-gb`|
-|English (India|`en-in`|
-|English (United States)| `en-us`|
-|French | 'fr' |
-|Spanish | `es` |
-
+|• English| United States (-us), Australia (-au), Great Britain (-gb), India (-in), United Arab Emirates (-ae)|
+|• Dutch| Netherlands (nl)|
+|• French | France (fr) |
+|• Japanese | Japan (ja)|
+|• Portuguese| Portugal (-pt), Brazil (-br)|
+|• Spanish | Spain (es) |
 ::: moniker-end
 
 ::: moniker range="form-recog-2.1.0"
@@ -262,4 +260,4 @@ The receipt model supports all English receipts and the following locales:
 
 * Complete a [Form Recognizer quickstart](quickstarts/get-started-sdks-rest-api.md?view=form-recog-2.1.0&preserve-view=true) and get started creating a document processing app in the development language of your choice.
 
-::: moniker-end
+::: moniker-end

articles/applied-ai-services/form-recognizer/language-support.md

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: reference
-ms.date: 01/06/2023
+ms.date: 01/25/2023
 ms.author: lajanuar
 ---
 
@@ -260,7 +260,7 @@ The **2022-06-30** and later releases  include Japanese language support:
 
 Language| Locale code |
 |:-----|:----:|
-|English (United States) |en-US|
+|English |en-US, en-IN, en-GB, en-CA, en-AU|
 |Spanish| es|
 |German (**2022-06-30** and later)| de|
 |French (**2022-06-30** and later)| fr|
@@ -505,23 +505,30 @@ This table lists the written languages supported by each Form Recognizer service
 ## Prebuilt receipt and business card
 
 >[!NOTE]
- > It's not necessary to specify a locale. This is an optional parameter. The Form Recognizer deep-learning technology will auto-detect the language of the text in your image.
+ >The Form Recognizer deep-learning technology will auto-detect the language of the text in your image.
 
 Prebuilt Receipt and Business Cards support all English receipts and business cards with the following locales:
 
-|Language| Locale code |
+|Supported Languages| Details |
 |:-----|:----:|
-|English (Australia)|`en-au`|
-|English (Canada)|`en-ca`|
-|English (United Kingdom)|`en-gb`|
-|English (India|`en-in`|
-|English (United States)| `en-us`|
+|English| United States (-us), Australia (-au), Great Britain (-gb), India (-in|
+|French | France (FR) |
+|Spanish | Spain (ES) |
 
 ## Prebuilt invoice
 
-Language| Locale code |
-|:-----|:----:|
-|English (United States)|en-us|
+>[!NOTE]
+ >The Form Recognizer deep-learning technology will auto-detect the language of the text in your image.
+
+| Supported languages | Details |
+|:----------------------|:---------|
+| <ul><li>English</li></ul>| United States (-us), Australia (-au), Canada (-ca), Great Britain (-gb), India (-in)|
+| <ul><li>Spanish</li></ul>|Spain (ES)|
+| <ul><li>German</li></ul>| Germany (DE)|
+| <ul><li>French</li></ul>| France (FR) |
+| <ul><li>Italian</li></ul>| Italy (IT)|
+| <ul><li>Portuguese</li></ul>| Portugal (-pt), Brazil (-br)|
+| <ul><li>Dutch</li></ul>| Netherlands (DE)|
 
 ## Prebuilt identity documents
 
@@ -540,4 +547,4 @@ This technology is currently available for US driver licenses and the biographic
 ::: moniker range="form-recog-2.1.0"
 > [!div class="nextstepaction"]
 > [Try Form Recognizer Sample Labeling tool](https://aka.ms/fott-2.1-ga)
-::: moniker-end
+::: moniker-end

articles/applied-ai-services/form-recognizer/whats-new.md

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: conceptual
-ms.date: 12/15/2022
+ms.date: 01/30/2023
 ms.author: lajanuar
 monikerRange: '>=form-recog-2.1.0'
 recommendations: false
@@ -27,6 +27,43 @@ Form Recognizer service is updated on an ongoing basis. Bookmark this page to st
 >[!NOTE]
 > With the release of the 2022-08-31 GA API, the associated preview APIs are being deprecated. If you are using the 2021-09-30-preview or the 2022-01-30-preview API versions, please update your applications to target the 2022-08-31 API version. There are a few minor changes involved, for more information, _see_ the [migration guide](v3-migration-guide.md).
 
+## January 2023
+
+* **[Prebuilt receipt model](concept-receipt.md#supported-languages-and-locales-v30) —additional language support**:
+
+   The **prebuilt receipt model** now has added support for the following languages:
+
+  * English - United Arab Emirates (en-ae)
+  * Dutch - Netherlands (nl-nl)
+  * French - Canada (fr-ca)
+  * Japanese - Japan (ja-jp)
+  * Portuguese - Brazil (pt-br)
+
+* **[Prebuilt invoice model](concept-invoice.md)—additional language support and field extractions**
+
+  The **prebuilt invoice model** now has added support for the following languages:
+
+  * English - Australia (en-au), Canada (en-ca), Great Britain (en-gb), India (en-in)
+  * Portuguese - Brazil (pt-br)
+
+  The **prebuilt invoice model** now has added support for the following field extractions:
+
+  * Currency code
+  * Payment options
+  * Total discount
+  * Tax items (en-in only)
+
+* **[Prebuilt ID document model](concept-id-document.md#document-types)—additional document types support**
+
+  The **prebuilt ID document model** now has added support for the following document types:
+
+  * Passport, driver's license, and residence permit ID expansion.
+  * US military ID
+  * India ID
+  * Australia ID
+  * Canada ID
+  * United Kingdom ID
+
 ## December 2022
 
 * [**Form Recognizer Studio updates**](https://formrecognizer.appliedai.azure.com/studio)