Difference between revisions of "OCR service"

From 1Archive help
Jump to: navigation, search
Line 1: Line 1:
The OCR service is used for recognizing and validating documents coming from BilltoBox.
+
==General==
 
+
The OCR service is used for recognizing and validating documents coming from an external source. Your app can make use of it by sending PDF documents to Onea Transfer (documentation can be found [https://dev.onea.be/api/oneatransfer/index.html here]).<br/>
==BilltoBox - Onea integration==
+
Those documents will automatically be sent through our recognition server, where they will await validation by a manual validator.
 
 
<br/>{{note|This is only applicable for companies for which the Value Added Service OCR & Scanning is set to Onea in BilltoBox.}}<br/>
 
 
 
PDF documents added in BilltoBox wil automatically be sent to Onea. These will pass through our recognition server, where they will await validation by a manual validator.
 
  
 
<br/>{{info|The advantage of using a manual validator is we can increase the recognition percentage to a maximum.}}<br/>
 
<br/>{{info|The advantage of using a manual validator is we can increase the recognition percentage to a maximum.}}<br/>
  
Schematic overview of the flow:<br/>
+
Schematic overview of the flow:
<br/>[[image:billtobox_onea_integration.png|link=|600px]]<br/>
+
<br/>[[image:app_ocr_integration.png|link=|800px]]<br/>
 +
<br/>
 +
# Your app is sending a PDF document to the OCR service
 +
# The OCR service sets the status to ''PENDING'' and sends a uuid back
 +
# The OCR service sets the status to ''PROCESSING'' when the document is successfully received and ready to process
 +
#: The OCR service also pokes the given callback URL saying there was a statusupdate
 +
# Your app gets the ''PROCESSING'' status from the OCR service
 +
# The OCR service sets the status to ''VALIDATION'' when the document is successfully processed and ready for manual validation
 +
#: The OCR service also pokes the given callback URL saying there was a statusupdate
 +
# Your app gets the ''VALIDATION'' status from the OCR service
 +
# Now there are two possible events:
 +
## The OCR service sets the status to ''CANCELLED'' when the document has been cancelled by the manual validator
 +
## The OCR service sets the status to ''DONE'' when the document was successfully validated by the manual validator
 +
#: The OCR service also pokes the given callback URL saying there was a statusupdate
 +
# Your app gets the ''CANCELLED'' or ''DONE'' status from the OCR service
 +
# Your app gets the UBL data of the document from the OCR service
  
# BilltoBox is sending a pdf document to Onea
+
==BilltoBox usecase==
# Onea sets the status to ''PENDING'' and sends a uuid back
+
<br/>{{note|This is only applicable for companies for which the Value Added Service OCR & Scanning is set to Onea in BilltoBox.}}<br/>
# Onea sets the status to ''PROCESSING'' when the document is successfully received and ready to process
 
 
 
==Manual validator manual==
 

Revision as of 13:41, 6 June 2018

1 General

The OCR service is used for recognizing and validating documents coming from an external source. Your app can make use of it by sending PDF documents to Onea Transfer (documentation can be found here).
Those documents will automatically be sent through our recognition server, where they will await validation by a manual validator.


Info.png The advantage of using a manual validator is we can increase the recognition percentage to a maximum.

Schematic overview of the flow:
App ocr integration.png

  1. Your app is sending a PDF document to the OCR service
  2. The OCR service sets the status to PENDING and sends a uuid back
  3. The OCR service sets the status to PROCESSING when the document is successfully received and ready to process
    The OCR service also pokes the given callback URL saying there was a statusupdate
  4. Your app gets the PROCESSING status from the OCR service
  5. The OCR service sets the status to VALIDATION when the document is successfully processed and ready for manual validation
    The OCR service also pokes the given callback URL saying there was a statusupdate
  6. Your app gets the VALIDATION status from the OCR service
  7. Now there are two possible events:
    1. The OCR service sets the status to CANCELLED when the document has been cancelled by the manual validator
    2. The OCR service sets the status to DONE when the document was successfully validated by the manual validator
    The OCR service also pokes the given callback URL saying there was a statusupdate
  8. Your app gets the CANCELLED or DONE status from the OCR service
  9. Your app gets the UBL data of the document from the OCR service

2 BilltoBox usecase


Note.png This is only applicable for companies for which the Value Added Service OCR & Scanning is set to Onea in BilltoBox.