メインコンテンツへスキップ
ABBYY FlexiCapture for Invoices Cloud には、請求書処理向けに特別に設計された、すぐに使用できるアプリケーションが含まれています。このアプリケーションを使用すると、追加の設定を行わなくても、ほとんどのドキュメントから必要なすべてのデータフィールドを認識して抽出できます。デフォルトで請求書から抽出されるフィールドの詳細な一覧については、仕様セクションを参照してください。 請求書を処理するには、以下の手順に従います。
  1. いずれかのアプリケーションの認証情報を使用して、authorization headerを取得します。authorization headerの取得方法の詳細については、認証セクションを参照してください。
  2. 有効な入力形式のファイルを、File.Uploadメソッドを使用してサーバーにアップロードします。レスポンスでは、そのファイルに関する以降のすべてのrequestで使用する、ファイルの識別子とトークンが返されます。
curl -X POST —header “Accept: application/json” —header “Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l” “https://api-eu.flexicapture.com/v2/file” —form “file=@/path/to/file/US_1.png”
{“id”: “5eeb762149c6470fdc65a84c”,“token”: “4B5A1A00E7A82C2AF31E20CADE7284DDA43DED30”,“name”: “US_1.png”,“extension”: “.png”,“hash”: “E75133BA4FC50B7197C2842D7A8A8AE615C37E38714C7773B1F8E2904EC62537A199129CD3B737673FBAB1DE63CBD5D428705443ADD2E1BA6223B7DD60070FDA”,“size”: 369090,“mime”: “image/png”,“is_recognizable”: true,“account”: “5dae591d3c66a51ae8be9896”,“application”: “5dae591e91375010bcd78362”,“email”: “user@abbyy.com”,“created”: “2020-02-02T14:11:45.5338461Z”,“expiring”: “2020-03-03T14:11:45.5338254Z”}
  1. データ抽出を開始するには、Task.Runメソッドを使用して処理タスクを開始します。このrequestでは複数のファイルを指定できます。requestには、次の任意parametersを含めることができます: 請求書の地域、verification type、および結果のエクスポート形式です。
レスポンスにはタスク識別子が含まれており、これは次の手順で必要になります。
curl -X POST —header “Content-Type: application/json” —header “Accept: application/json” —header “Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l” -d ”{“properties”: {“region”: “US”,“export_format”: “Xls”,“verification_type”: “NoVerification”,},“files”: [{“id”: “5eeb762149c6470fdc65a84c”,“token”: “4B5A1A00E7A82C2AF31E20CADE7284DDA43DED30”}]}” “https://api-eu.flexicapture.com/v2/task/capture/invoices”
{“id”: “5eeb7bf728613d1e04a70782”,“number”: “1126563”,“batch_id”: 0,“type”: “ic”,“is_realtime_enabled”: false,“processing_priority”: “Normal”,“is_demo”: false,“properties”: {“region”: “US”,“export_format”: “Xls”,“verification_type”: “NoVerification”},“account”: “5dae591d3c66a51ae8be9896”,“email”: “user@abbyy.com”,“application”: “5dae591e91375010bcd78362”,“created”: “2020-02-02T14:36:39.441Z”,“progress”: 0,“status”: “Submitted”,“is_deleted”: false,“is_billed”: false,“documents”: [{“files”: {“source”: {“id”: “5eeb762149c6470fdc65a84c”,“token”: “4B5A1A00E7A82C2AF31E20CADE7284DDA43DED30”,“name”: “US_1.png”}},“data”: {},“is_moved”: false}],“is_extra_error”: false}
  1. タスクの処理にはしばらく時間がかかるため、抽出データをすぐに利用することはできません。タスクの開始時に受け取った識別子を使用して、タスクのステータスを確認できます。ステータスが Done に変わるまで待機してください。タスクのステータスを確認するには、Task.Get メソッドを使用してください。
curl -X GET —header “Accept: application/json” —header “Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l” “https://api-eu.flexicapture.com/v2/task/5eeb7bf728613d1e04a70782
{“id”: “5eeb7bf728613d1e04a70782”,“number”: “1126563”,“batch_id”: 2640691,“type”: “ic”,“is_realtime_enabled”: false,“processing_priority”: “Normal”,“is_demo”: false,“properties”: {“region”: “US”,“export_format”: “Xls”,“verification_type”: “NoVerification”},“account”: “5dae591d3c66a51ae8be9896”,“email”: “user@abbyy.com”,“application”: “5dae591e91375010bcd78362”,“created”: “2020-02-02T14:36:39.441Z”,“started”: “2020-02-02T14:36:50.308Z”,“billed”: “2020-02-02T14:37:14.35Z”,“delivered”: “2020-02-02T14:37:14.328Z”,“progress”: 100,“status”: “Done”,“is_deleted”: false,“is_billed”: true,“documents_count”: 1,“pages_count”: 1,“documents”: [{“files”: {“source”: {“id”: “5eeb762149c6470fdc65a84c”,“token”: “4B5A1A00E7A82C2AF31E20CADE7284DDA43DED30”,“name”: “US_1.png”},“target”: {“id”: “5eeb7c1963ee5a1268123b96”,“token”: “A01EFC05BBB787DC6825F08E51B56CF3E066210E”,“name”: “Data_00000001.xls”},“verification_layer_page_0”: {“id”: “5eeb7c1a63ee5a1268123b97”,“token”: “18921FFB4C944056CB3ED00768F90724ADF0CB69”,“name”: “verification_layer_page_2.xml”}},“data”: {“region”: “us”,“export_format”: “xls”,“verification_type”: “noverification”,“vendor_id”: “1”,“vendor_name”: “AA APPAREL”,“total”: “20208”,“currency”: “USD”},“is_moved”: false}],“is_extra_error”: false}
  1. ステータスがDoneに変わったら、識別子とトークン (前のステップのレスポンスに含まれるtargetファイル情報) を使用して出力ファイルをダウンロードできます。これには、File.Downloadメソッドを使用します。このrequestは、タスクrequest内の各入力ファイルに対して繰り返し実行できます。
curl -X GET —header “Accept: application/json” —header “Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l=” “https://api-eu.flexicapture.com/v2/file/5eeb7c1963ee5a1268123b96/A01EFC05BBB787DC6825F08E51B56CF3E066210E”
成功すると、サーバーは HTTPステータス200 OK とファイルの内容を返します。
  1. 出力データをダウンロードしたら、すべての入力ファイルと出力ファイルを削除するためにタスクを削除します。これには、Task.Deleteメソッドを使用し、タスク識別子を指定します。
curl -X DELETE —header “Accept: application/json” —header “Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l=” “https://api-eu.flexicapture.com/v2/task/5eeb7bf728613d1e04a70782”
成功すると、サーバーは HTTPステータス204 OK を返します。 requestでエラーが発生した場合、サーバーは失敗の理由を示す HTTPレスポンスコードのいずれかを返します。詳細については、Request errors sectionを参照してください。