Skip to main content
The Analytics Reporting Warehouse stores data that can be used to analyze the efficiency of document processing within the system. With this data, you can identify which documents require more time for manual verification and why. Statistics are collected for Process skills that have at least one Manual Review step and include at least one Document skill. The system compares the document’s initial pre-manual review state with its state after processing. The Analytics Reporting Warehouse stores the following data:
  • Information about changes in documents
  • Information about document fields:
    • The number of extracted field values
    • The number of changed field values
    • The status of each field (indicating whether it is correct, has recognition issues, has been located incorrectly, or has not been detected)

​
Migrating from v1 to v2

Only the path has changed from “/v1/” to “/v2/.” There are no request/response field or behavioral changes.

​
Downloading a data report

Note: Only users with Tenant Administrator or Processing Supervisor roles can download data reports. For more information, see Role-Based Access Control.
To obtain data from the Analytics Reporting Warehouse, send a GET request to one of the following resources, depending on the kind of report you need to obtain:

​
Obtaining data about documents processed by a Process skill

GET {base_url}/api/reporting/v2/qa/process-skills/documents

​
Obtaining data about fields processed by Process and Document skills

GET {base_url}/api/reporting/v2/qa/process-skills/fields
A request body contains the following parameters:
  • startDate. The first day of the period for which data should be downloaded (sample formatting: 2022-01-07T13:03:38, time should be in UTC). This is a required parameter.
  • endDate. The last day of the period for which data should be downloaded (sample formatting: 2022-09-07T13:03:38, time should be in UTC).
  • processSkillId. The ID of the Process skill the data for which should be downloaded. This is a required parameter.
  • documentSkillId. The ID of the Document skill for which the data should be downloaded.
Note: You can include this parameter only in the /api/reporting/v1/qa/process-skills/fields request.
  • imageType. The type of document image. Possible values: Unknown, Receipt, A4, BusinessCard, Book, Id, PassportRus, DiscountCard, BankCard, NotDocument, PassportPage.
  • imageColority. Indicates whether the document’s first page is color, black, or black and white. Possible values: BlackWhite, Gray, Color.
  • imageSource. The source of the document image. Possible values: Unknown, Photo, Scan, Synthetic, Screenshot, Pdf.
  • wasCorrectedInManualReview. Indicates whether the document fields were corrected during manual review.
  • wasDocumentTypeChangedInManualReview. Indicates whether the document type was changed during manual review.
The resulting CSV file will contain the following information sorted into columns.

​
Report about changes in documents

ColumnDescription
ProcessSkillIdThe ID of the Process skill.
ProcessSkillVersionThe version of the Process skill.
ProcessSkillNameThe name of the Process skill.
DocumentSkillIdThe ID of the Document skill.
DocumentSkillVersionThe version of the Document skill.
DocumentSkillNameThe name of the Document skill.
TransactionIdThe ID of the transaction.
HasManualReviewIndicates whether the document was manually reviewed. Possible values: 1 or 0.
DocumentIdThe ID of the document passed for processing.
DocumentNameThe name of the document passed for processing.
PageSizeThe size of the document’s first page in pixels (width and height).
ImageColorityIndicates whether the document’s first page is color, gray, or black and white.
ImageSourceThe image source of the document’s first page. For example: scan, photo, PDF file, screenshot, etc.
ImageTypeThe image type of the document’s first page. For example: A4, receipt, bank card, etc.
DPIThe number of dots (or pixels) in the document’s first page.
TransactionParameter1..NTransaction parameters passed for processing. If the document does not contain any transaction parameters, the value in the report will be null.
DimensionField1..MValueDimension fields passed for processing. If the document does not contain any dimension fields, the value in the report will be null.
DocumentSkillChangedIndicates whether the document type was changed during manual review. Possible values: true, false.
DocumentSkillIdUsedBeforeManualReviewThe Document skill applied to the document before the Manual Review stage.
NumberOfExportedFieldsThe number of exported fields in the document.
NumberOfChangedFieldsThe number of manually changed fields in the document.
Data for this report will be stored for 12 months.

​
Report about changes in fields

ColumnDescription
ProcessSkillIdThe ID of the Process skill.
ProcessSkillVersionThe version of the Process skill.
ProcessSkillNameThe name of the Process skill.
DocumentSkillIdThe ID of the Document skill.
DocumentSkillVersionThe version of the Document skill.
DocumentSkillNameThe name of the Document skill.
TransactionIdThe ID of the transaction.
HasManualReviewIndicates whether the document was manually reviewed. Possible values: 1 or 0.
DocumentIdThe ID of the document passed for processing.
DocumentNameThe name of the document passed for processing.
PageSizeThe size of the document’s first page in pixels (width and height).
ImageColorityIndicates whether the document’s first page is color, gray, or black and white.
ImageSourceThe image source of the document’s first page. For example: scan, photo, PDF file, screenshot, etc.
ImageTypeThe image type of the document’s first page. For example: A4, receipt, bank card, etc.
DPIThe number of dots (or pixels) in the document’s first page.
TransactionParameter1..NTransaction parameters passed for processing. If the document does not contain any transaction parameters, the value in the report will be null.
DimensionField1..MValueDimension fields passed for processing. If the document does not contain any dimension fields, the value in the report will be null.
DocumentSkillChangedIndicates whether the document type was changed during manual review. Possible values: true, false.
DocumentSkillIdUsedBeforeManualReviewThe Document skill applied to the document before the Manual Review stage.
NumberOfExportedFieldsThe number of exported fields in the document.
NumberOfChangedFieldsThe number of manually changed fields in the document.
FieldIDThe ID of the document field.
FieldNameThe name of the document field.
CorrectInformation about the correction status of non-repeating fields and the number of instances of repeating fields that weren’t corrected. Possible values:
- 1, if the non-repeating field wasn’t corrected during manual review.
- The number of instances of a repeating field that weren’t corrected during manual review.
RecognitionIssueInformation about recognition issues during the processing of document fields. Possible values:
- 1, if the non-repeating field’s value was corrected, but the region was not.
- The number of instances where the values of a repeating field were corrected during manual review.
DetectedIncorrectlyInformation about corrections that were made during the manual review. Possible values:
- 1, if the region and value of a non-repeating field were corrected.
- The number of instances where regions and values of a repeating field were corrected during manual review.
NotDetectedInformation about field values that were not extracted before manual review. Possible values:
- 1, if the value of a non-repeating field wasn’t extracted before manual review and was created by a verifier.
- The number of instances of a repeating field’s values that were created during manual review.
IsInDocumentIndicates if the field has at least one instance in the document. Possible values: true, false.
Data for this report will be stored for 14 days. Data obtained in CSV format may be further analyzed in any BI tool.