Extraktion der wichtigsten Rechnungsfelder

ABBYY FlexiCapture for Invoices Cloud enthält eine sofort einsatzbereite Anwendung, die speziell für die Rechnungsverarbeitung entwickelt wurde. Diese Anwendung erkennt und extrahiert alle erforderlichen Datenfelder aus den meisten Dokumenten ohne zusätzliche Anpassungen. Eine detaillierte Liste der Felder, die standardmäßig aus Rechnungen extrahiert werden, finden Sie im Abschnitt Erfasste Felder. Führen Sie die folgenden Schritte aus, um Rechnungen zu verarbeiten.

Authorization-Header abrufen

Rufen Sie den Authorization-Header mit den Zugangsdaten einer Ihrer Anwendungen ab. Weitere Informationen finden Sie im Abschnitt Authentifizierung. In den folgenden Beispielen wird der Header Basic QWxhZGRpbjpPcGVuU2VzYW1l verwendet.

Datei hochladen

Laden Sie mithilfe der File.Upload-Methode eine Datei in einem gültigen Eingabeformat auf den Server hoch. In der Antwort erhalten Sie den Bezeichner und das Token der Datei; diese werden in allen nachfolgenden Anfragen verwendet, die sich auf die Datei beziehen.

curl -X POST \
  --header "Accept: application/json" \
  --header "Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l" \
  --form "file=@/path/to/file/US_1.png" \
  "https://api-eu.flexicapture.com/v2/file"

Die Antwort enthält die Metadaten der hochgeladenen Datei:

{
  "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"
}

Verarbeitungsaufgabe starten

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: Rechnungs-Region, Verifizierungstyp und das Exportformat für die Ergebnisse. Die Antwort enthält eine Task-ID, die 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"

Die Antwort beschreibt den neu erstellten Task:

{
  "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
}

Prüfen Sie den Status des Tasks

Die Verarbeitung der Aufgabe dauert einige Zeit, daher sind die extrahierten Daten nicht sofort verfügbar. Prüfen Sie den Aufgabenstatus mit dem Bezeichner, den Sie beim Starten der Aufgabe erhalten haben, mithilfe der Methode Task.Get. Warten Sie, bis sich der Status in Done ändert.

curl -X GET \
  --header "Accept: application/json" \
  --header "Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l" \
  "https://api-eu.flexicapture.com/v2/task/5eeb7bf728613d1e04a70782"

Wenn der Task abgeschlossen ist, enthält die Antwort die target-Dateien zum Herunterladen:

{
  "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
}

Laden Sie die Ausgabedateien herunter

Nachdem der Status zu Done gewechselt hat, laden Sie die Ausgabedateien mithilfe ihrer Bezeichner und Tokens (den target-Dateiinformationen in der Antwort aus dem vorherigen Schritt) mit der Methode File.Download herunter. Wiederholen Sie diese Anfrage für jede Eingabedatei in der Task-Anfrage.

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.

Task löschen

Nachdem Sie die Ausgabedaten heruntergeladen haben, löschen Sie den Task, um alle Eingabe- und Ausgabedateien zu entfernen. Verwenden Sie dazu die Methode Task.Delete mit dem Task-Bezeichner.

curl -X DELETE \
  --header "Accept: application/json" \
  --header "Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l" \
  "https://api-eu.flexicapture.com/v2/task/5eeb7bf728613d1e04a70782"

Im Erfolgsfall gibt der Server den HTTP-Status 204 No Content zurück.

Wenn die Anfrage Fehler enthält, 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.

Administrator's Guide

Administration Guide

Performance Guide

Troubleshooting

Cloud

Extraktion der wichtigsten Rechnungsfelder