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

# Télécharger les fichiers CODA

> Listez les nouveaux extraits de compte, téléchargez-les, puis confirmez chaque téléchargement.

Les fichiers CODA sont les extraits de compte que Codaclean reçoit des banques de vos clients.

Les fichiers arrivent le matin : il suffit d'exécuter cette boucle deux fois par jour.

<Steps>
  <Step title="Listez les nouveaux fichiers">
    Appelez [`POST /coda-files`](/fr/api/endpoints/list-coda-files) avec un corps JSON, au minimum `{}`.

    Par défaut, la réponse ne contient que les fichiers dont vous n'avez pas encore confirmé le téléchargement.

    Les fichiers sont regroupés par client, puis par IBAN, devise et année d'extrait.

    Filtres utiles : `enterpriseNumber`, `iban`, `statementDate`, `processingDate`, `statementNumber`.

    Passez `includePdf` à `true` pour recevoir aussi la version PDF de chaque extrait.

    **Scope requis :** `files:read`
  </Step>

  <Step title="Téléchargez chaque fichier">
    Chaque fichier comporte un lien `urls.coda` (ainsi qu'un lien `urls.pdf`, si vous l'avez demandé).

    Il s'agit d'URL présignées : téléchargez-les avec un simple `GET`, sans les en-têtes de l'API.

    <Warning>
      Les URL de téléchargement expirent **30 minutes** après l'appel qui liste les fichiers.

      Si une URL a expiré, listez de nouveau les fichiers pour en obtenir une nouvelle.
    </Warning>
  </Step>

  <Step title="Confirmez chaque téléchargement">
    Une fois le fichier enregistré de votre côté, appelez [`DELETE /coda-files/{fileId}`](/fr/api/endpoints/acknowledge-coda-file) avec l'`id` du fichier.

    Le fichier n'est **pas** supprimé. Il est marqué comme téléchargé pour votre clé API et l'utilisateur courant, et n'apparaît plus dans la liste suivante.

    Une seconde confirmation du même fichier renvoie `409`.
  </Step>
</Steps>

## Télécharger de nouveau un fichier

Pour lister les fichiers déjà confirmés, envoyez `"redownload": true`.

Combinez ce paramètre avec des filtres comme `statementDate` pour récupérer une période précise.

## Bon à savoir

* La liste n'est pas paginée. Confirmez les fichiers au fur et à mesure pour garder des réponses légères.
* Les confirmations sont propres à chaque clé API et à chaque utilisateur. Pour un autre utilisateur de votre logiciel, le fichier apparaît toujours comme nouveau.
* Seuls les fichiers entièrement traités par Codaclean sont listés.