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

> Listez les nouveaux fichiers salariaux, téléchargez-les, puis confirmez chaque téléchargement.

Les fichiers CODB sont les fichiers salariaux que les secrétariats sociaux transmettent à Codaclean pour vos clients.

Le processus est le même que pour les fichiers CODA. Les fichiers arrivent le matin : il suffit de l'exécuter deux fois par jour.

<Steps>
  <Step title="Listez les nouveaux fichiers">
    Appelez [`POST /codb-files`](/fr/api/endpoints/list-codb-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 secrétariat social et par année.

    Filtres utiles : `enterpriseNumber`, `payrollProvider`, `accountPeriod`, `statementDate`, `processingDate`, `statementNumber`.

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

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

  <Step title="Téléchargez chaque fichier">
    Chaque fichier comporte un lien `urls.codb` (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 /codb-files/{fileId}`](/fr/api/endpoints/acknowledge-codb-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`.

## Bon à savoir

* Dans les réponses CODB, `statementDate` correspond à la date de génération du fichier, et `statementNumber` à son numéro de séquence.
* `statementNumber` est une chaîne de caractères. Elle est généralement numérique, mais peut combiner plusieurs numéros de séquence (par exemple `"0103-0203"`) : ne la convertissez pas en nombre.
* `accountPeriod` est un entier au format `AAAAMM` (par exemple `202609`).
* 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.