Skip to main content
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.
1

Listez les nouveaux fichiers

Appelez POST /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
2

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

Confirmez chaque téléchargement

Une fois le fichier enregistré de votre côté, appelez DELETE /coda-files/{fileId} 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.

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