> ## 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.

# Traiter les factures via l’API

> Traitez vos premières factures avec l’API FlexiCapture for Invoices Cloud : créez l’en-tête Authorization, téléversez un fichier, lancez une tâche et téléchargez les résultats.

Cette procédure explique comment traiter vos premières factures avec l’API ABBYY FlexiCapture for Invoices Cloud : créez l’en-tête Authorization, téléversez un fichier, lancez une tâche et téléchargez les résultats.

Tous les points de terminaison utilisent l’URL de base `https://api-{location-id}.flexicapture.com`, où `{location-id}` correspond à l’[emplacement pris en charge](/fr/flexi-capture/cloud/cloud-f-cfor-invoices-api#icaas-supported-countries) : `us` (USA et Canada), `au` (Australie) ou `eu` (pays de l’Union européenne).

<Steps>
  <Step title="Créer un compte">
    Pour interagir avec l’API, vous avez besoin d’un compte. Si vous n’en avez pas encore créé, faites-le sur le [portail web ABBYY FlexiCapture Cloud](https://flexicapture.com).
  </Step>

  <Step title="Récupérer l’en-tête Authorization">
    Toutes les requêtes adressées à l’API doivent contenir un en-tête Authorization, construit à partir de votre application ID et de votre token. Pour obtenir des instructions, consultez [Authentification](/fr/flexi-capture/cloud/cloud-f-cfor-invoices-api-auth). Les exemples ci-dessous utilisent l’en-tête d’exemple `Basic QWxhZGRpbjpPcGVuU2VzYW1l`.
  </Step>

  <Step title="Téléverser un fichier">
    [Téléverser un fichier sur le serveur](/fr/flexi-capture/cloud/cloud-f-cfor-invoices-api-upload-file). Vous obtenez l’identifiant et le token du fichier dans la réponse ; ils sont utilisés dans toutes les requêtes suivantes concernant ce fichier.

    ```bash theme={null}
    curl -X POST \
      --header "Accept: application/json" \
      --header "Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l" \
      --form "file=@/path/to/file/Letter.tif" \
      "https://api-{location-id}.flexicapture.com/v2/file"
    ```

    <Warning>
      Les paramètres du projet pour l’assemblage de documents sont ignorés lors du téléversement d’un fichier via l’API REST. Un document distinct est créé pour chaque fichier.
    </Warning>
  </Step>

  <Step title="Démarrer une tâche">
    Une fois votre document téléversé, démarrez une tâche pour lancer l’extraction de données. Vous pouvez spécifier plusieurs fichiers dans cette requête. La requête peut contenir les paramètres facultatifs suivants : [région](/fr/flexi-capture/cloud/cloud-f-cfor-invoices-languages) de facture, type de vérification et [format d’export](/fr/flexi-capture/cloud/cloud-f-cfor-invoices-formats) des résultats. La réponse contient un identifiant de tâche.

    ```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": "5ea16ff21b777315586713bf",
            "token": "34FB84AA68684F0F2BF496045224EB6C436F596B"
          }
        ]
      }' \
      "https://api-{location-id}.flexicapture.com/v2/task/capture/invoices"
    ```
  </Step>

  <Step title="Obtenir le statut d'une tâche">
    Le traitement de la tâche prend un certain temps, les données extraites ne sont donc pas disponibles immédiatement. Vous pouvez [vérifier le statut de la tâche](/fr/flexi-capture/cloud/cloud-f-cfor-invoices-api-get-task) à l’aide de l’identifiant que vous avez reçu lors du démarrage de la tâche. Attendez que le statut passe à `Done`.

    ```bash theme={null}
    curl -X GET \
      --header "Accept: application/json" \
      --header "Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l" \
      "https://api-{location-id}.flexicapture.com/v2/task/5ea18adc220e0d1c58177c59"
    ```
  </Step>

  <Step title="Télécharger le résultat">
    Une fois que le statut de tâche passe à `Done`, vous pouvez [télécharger](/fr/flexi-capture/cloud/cloud-f-cfor-invoices-api-download-file) les fichiers de sortie à l’aide de leurs identifiants et tokens. Répétez cette requête pour chaque fichier d’entrée inclus dans la requête de tâche.

    ```bash theme={null}
    curl -X GET \
      --header "Accept: application/json" \
      --header "Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l" \
      "https://api-{location-id}.flexicapture.com/v2/file/5ea21f6b7a9ae6193831d671/D188E5EFC0042A83529899AC1E1D94400A25DCF6"
    ```
  </Step>

  <Step title="Supprimer la tâche">
    Après avoir téléchargé les données de sortie, [supprimez la tâche](/fr/flexi-capture/cloud/cloud-f-cfor-invoices-api-delete-task) pour effacer tous les fichiers d’entrée et de sortie.

    ```bash theme={null}
    curl -X DELETE \
      --header "Accept: application/json" \
      --header "Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l" \
      "https://api-{location-id}.flexicapture.com/v2/task/5ea18adc220e0d1c58177c59"
    ```
  </Step>
</Steps>