- Cloud OCR SDK Documentation
Quick Start GuidesThese guides will help you to start development with ABBYY Cloud OCR SDK.
API ReferenceThe description of API methods.
Code SamplesDemo samples show how to create a simple application with Cloud OCR SDK.
Sample ImagesHere you can download sample images in different languages.
Technical SpecificationsThe list of supported image formats, recognition languages, text types, etc.
FAQAnswers to commonly-asked questions about ABBYY Cloud OCR SDK.
Best PracticesGeneral recommendations on settings needed for the best recognition results.
Cloud OCR SDK Documentation
Important: the technology fully supports US receipts, other countries are currently supported in beta mode.
The method allows you to recognize the image of a receipt. The method loads the image, creates a processing task for the image with the specified parameters, and passes the task for processing.
The image file is transmitted in the request body. See the list of supported input formats.
The result is returned in XML format. The elements and attributes of the resulting file are described in Output XML with Receipt Data.
For details on task cost please see billing terms.
|Parameter||Is required||Default value||Description|
Specifies the country where the receipt was printed. This parameter can contain several names of countries separated with commas, for example "taiwan,china". The following values are supported:
Important! The technology fully supports US receipts, other countries are currently supported in beta mode.
Specifies the source of the image. It can be either a scanned image, or a photograph created with a digital camera. Special preprocessing operations can be performed with the image depending on the selected source. For example, the system can automatically correct distorted text lines, poor focus and lighting on photos.
The value of this parameter can be one of the following:
|correctOrientation||No||"true"||Specifies whether the orientation of the image should be automatically detected and corrected. It can have one of the following values:
|correctSkew||No||"true"||Specifies whether the skew of the image should be automatically detected and corrected. It can have either true or false value.|
|xml:writeExtendedCharacterInfo||No||"false"||Specifies whether the additional information on the recognized characters (e.g. whether the character is recognized uncertainly) should be written to an output file in XML format. The parameter can have one of the following values:
|description||No||""||Contains the description of the processing task. Must contain no more than 255 characters.|
|pdfPassword||No||""||Contains a password for accessing password-protected images in PDF format.|
Status codes and response format
General status codes and response format of the method are described in HTTP Status Codes and Response Formats.
The following status codes can be returned when this method is called:
|200||Successful method call.|
|450||Incorrect parameters have been passed. One of the following errors occurred:
|550||An internal program error occurred while processing the image.|
|551||An error occurred on the server side:
Output file format
The result of processing is returned in an XML file of the following format:
<?xml version="1.0" encoding="UTF-8"?>
<receipts count="1" xmlns="http://www.abbyy.com/ReceiptCaptureSDK_xml/ReceiptCapture-1.0.xsd">
See the XSD schema of an XML file.
You do not need to set the recognition languages for receipt recognition; they will be selected automatically on the basis of the countries you specify. See below the list of languages corresponding to countries.
|Brazil||Portuguese (Brazil); English|
Note that the receipt in one of these languages, but printed in some other country, is not guaranteed to be recognized correctly.