Error Reporting#
We recommend using the feedback-api for error reporting.
Feedback-API#
Caution
This currently only works for FTEE-projects. TYOE and TYOC will follow soon.
The POST /processing/feedback/{processing_id} endpoint is available to allow the reporting of erroneous extractions or classifications.
The processed document will be added as training data to the corresponding workflow for annotation.
Parameters#
| Field | Type | Description |
|---|---|---|
{processing_id} |
UUID | The UUID of the processing you want to report an error for. |
Request body#
| Field | Type | Description |
|---|---|---|
description |
string | Permits describing the error in a plain and explicit manner. This information will be shown during annotation, so that you can easily fix the error. |
tag |
string | You can specify the 'tag' of the training data. The tag refers to the name of the issuer/template you created when adding data to our interfaces. The erroneous document will then be placed in this bucket so that you can keep your data sorted and categorised. If you do not use the 'tag' parameter, the erroneous document will be placed in the unknown bucket. |
Error-Reports API (old)#
Caution
Please note, that this API Endpoint needs some additional configuration. For that get in contact with us. We always recommend using the newer feedback API route instead.
The endpoint POST /processing/error-reports/{processing_result} is available to allow the reporting
of errors related to document processing and classifications. This endpoint provides not only the ability
to simply state an error but also provide any specific fields that may be incorrect as well as the correct
value of that field. This information can then be used to help improve our system.
Parameters#
| Field | Type | Description |
|---|---|---|
{processing_result} |
string |
Passed as part of the query path, defining the aspect of the document processing that contains errors.
Currently, only extractions is supported.
|
Request body#
The request body can define the description of the error, but also the specific fields that contain an error and what the correct value should be.
| Field | Type | Description |
|---|---|---|
processing_id |
UUID | Defines the process instance that needs correction. |
description(optional) |
string | Permits describing the error in a plain and explicit manner. |
incorrect_fields(optional) |
array |
Used to indicate the specific fields that are incorrect. Allows providing both the field, as well as the correct value, as a part of each entry.
Each entry follows the general form of:
{
"field": "customer.name",
"correct_value": "Customer's Name"
}
The dot notation, used for the field, defines the specific attribute of the entity.
|