Zum Hauptinhalt springen
ABBYY FlexiCapture for Invoices Cloud enthält eine sofort einsatzbereite Anwendung, die speziell für die Rechnungsverarbeitung entwickelt wurde. Mit dieser Anwendung können Sie alle erforderlichen Datenfelder aus den meisten Dokumenten ohne zusätzliche Anpassungen erkennen und extrahieren. Eine detaillierte Liste der Felder, die standardmäßig aus Rechnungen extrahiert werden, finden Sie im Abschnitt Spezifikation. Führen Sie die folgenden Schritte aus, um Rechnungen zu verarbeiten:
  1. Rufen Sie den Authorization-Header mithilfe der Anmeldeinformationen einer Ihrer Anwendungen ab. Ausführliche Informationen zum Abrufen des Authorization-Headers finden Sie im Abschnitt Authentifizierung.
  2. Laden Sie mit der Methode File.Upload eine Datei in einem gültigen Eingabeformat auf den Server hoch. In der Antwort erhalten Sie den Bezeichner und das Token der Datei, die in allen nachfolgenden Anfragen verwendet werden, die sich auf die Datei beziehen.
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. Starten Sie mit der Methode Task.Run eine Verarbeitungsaufgabe, um die Datenextraktion zu beginnen. Sie können in dieser Anfrage mehrere Dateien angeben. Die Anfrage kann die folgenden optionalen Parameter enthalten: Region der Rechnungen, Verifizierungstyp und das Exportformat für die Ergebnisse.
Die Antwort enthält einen Aufgabenbezeichner, den Sie in den nächsten Schritten benötigen.
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. Die Verarbeitung der Aufgabe dauert некоторое Zeit, daher sind die extrahierten Daten nicht sofort verfügbar. Sie können den Status der Aufgabe anhand des Bezeichners prüfen, den Sie beim Starten der Aufgabe erhalten haben. Warten Sie, bis der Status zu Done wechselt. Um den Status der Aufgabe zu prüfen, verwenden Sie die Methode 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. Nachdem der Status auf Done gewechselt ist, können Sie die Ausgabedateien anhand ihrer Bezeichner und Token herunterladen (Informationen zu den target-Dateien in der Antwort aus dem vorherigen Schritt). Verwenden Sie dazu die Methode File.Download. Diese Anfrage kann für jede Eingabedatei in der Aufgabenanfrage wiederholt werden.
curl -X GET —header “Accept: application/json” —header “Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l=” “https://api-eu.flexicapture.com/v2/file/5eeb7c1963ee5a1268123b96/A01EFC05BBB787DC6825F08E51B56CF3E066210E”
Bei Erfolg gibt der Server den HTTP-Status 200 OK und den Dateiinhalt zurück.
  1. Nachdem Sie die Ausgabedaten heruntergeladen haben, löschen Sie die Aufgabe, um alle Eingabe- und Ausgabedateien zu entfernen. Verwenden Sie dazu die Methode Task.Delete und geben Sie den Aufgabenbezeichner an.
curl -X DELETE —header “Accept: application/json” —header “Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l=” “https://api-eu.flexicapture.com/v2/task/5eeb7bf728613d1e04a70782”
Bei Erfolg gibt der Server den HTTP-Status 204 OK zurück. Wenn die Anfrage Fehler enthielt, gibt der Server einen der HTTP-Antwortcodes zurück, um den Grund für das Fehlschlagen anzugeben. Weitere Informationen finden Sie im Abschnitt Request-Fehler.