Document Understanding release notes

Introducing Field Groups and Monetary Quantity​

Document Understanding API v2​

What’s new​

• Discovery returns the associated taxonomy in the response so you can use it to guide extraction and validation.
• Extraction and Validation accept taxonomy as an input parameter. This enables partial extraction, data type overrides, and additional validation customization. For details, see Use the Validation Service.
• The API evaluates business rules defined in the taxonomy during extraction and validation to ensure that extracted data complies with configured requirements, such as mandatory fields and allowed values.
• Predefined projects now support tag-based extraction using a single tag named Production.
• IXP extraction result is now returned as FieldGroups instead of Tables. With FieldGroups, each field preserves its actual data type. For details, see Taxonomy Manager.
• A new predefined project offers enhanced support for non-Latin character sets.

Document Understanding API v2 breaking changes​

• Response bodies on all routes now use PascalCase property names instead of camelCase. Any case-sensitive integrations, such as those written in Python, JavaScript, or others, require updating to match the new casing.
• Tag-based routes now use /projects/{projectId}/tags/{tag}/.... Requests using the previous route structure return a 400 bad request error in v2.
• The fields property has been removed from Discovery responses; integrations must use taxonomy instead.
• The Discovery routes now return tags instead of tag.
• IXP extraction results are now returned as FieldGroups instead of Tables, which requires updates if your automation treats extraction results as tables to handle the new FieldGroup structure and data types.
• Entries that previously returned FieldType == Table now return FieldType == FieldGroup. Parsers that handle only Table results will not process this data. For detailed migration steps and examples, check Migrating integrations from Document Understanding API v1 to v2.

Bug fixes​