> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Extraktion der wichtigsten Rechnungsfelder

> Extrahieren Sie die wichtigsten Rechnungsfelder mit FlexiCapture for Invoices Cloud, indem Sie eine Datei hochladen, eine Erfassungsaufgabe ausführen, den Status abfragen und die Ergebnisse herunterladen.

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](/de/flexi-capture/cloud/cloud-f-cfor-invoices-fields).

Führen Sie die folgenden Schritte aus, um Rechnungen zu verarbeiten.

<Steps>
  <Step title="Authorization-Header abrufen">
    Rufen Sie den Authorization-Header mit den Zugangsdaten einer Ihrer Anwendungen ab. Weitere Informationen finden Sie im Abschnitt [Authentifizierung](/de/flexi-capture/cloud/cloud-f-cfor-invoices-api-auth). In den folgenden Beispielen wird der Header `Basic QWxhZGRpbjpPcGVuU2VzYW1l` verwendet.
  </Step>

  <Step title="Datei hochladen">
    Laden Sie mithilfe der [File.Upload](/de/flexi-capture/cloud/cloud-f-cfor-invoices-api-upload-file)-Methode eine Datei in einem gültigen [Eingabeformat](/de/flexi-capture/cloud/cloud-f-cfor-invoices-formats) 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.

    ```bash theme={null}
    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:

    ```json theme={null}
    {
      "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"
    }
    ```
  </Step>

  <Step title="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](/de/flexi-capture/cloud/cloud-f-cfor-invoices-languages), Verifizierungstyp und das [Exportformat](/de/flexi-capture/cloud/cloud-f-cfor-invoices-formats) für die Ergebnisse. Die Antwort enthält eine Task-ID, die Sie in den nächsten Schritten benötigen.

    ```bash theme={null}
    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:

    ```json theme={null}
    {
      "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
    }
    ```
  </Step>

  <Step title="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](/de/flexi-capture/cloud/cloud-f-cfor-invoices-api-get-task). Warten Sie, bis sich der Status in `Done` ändert.

    ```bash theme={null}
    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:

    ```json theme={null}
    {
      "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
    }
    ```
  </Step>

  <Step title="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](/de/flexi-capture/cloud/cloud-f-cfor-invoices-api-download-file) herunter. Wiederholen Sie diese Anfrage für jede Eingabedatei in der Task-Anfrage.

    ```bash theme={null}
    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.
  </Step>

  <Step title="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.

    ```bash theme={null}
    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.
  </Step>
</Steps>

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](/de/flexi-capture/cloud/cloud-f-cfor-invoices-api-errors).
