Skip to main content
CODA-bestanden zijn rekeninguittreksels die Codaclean van de banken van uw klanten ontvangt. De bestanden komen ‘s ochtends binnen: het volstaat om deze cyclus twee keer per dag te doorlopen.
1

Nieuwe bestanden opvragen

Roep POST /coda-files aan met een JSON-body, minstens {}.Standaard bevat het antwoord alleen bestanden die u nog niet hebt bevestigd.De bestanden zijn gegroepeerd per klant en vervolgens per IBAN, munt en jaar van het uittreksel.Nuttige filters: enterpriseNumber, iban, statementDate, processingDate, statementNumber.Zet includePdf op true om ook de pdf-versie van elk uittreksel te ontvangen.Vereiste scope: files:read
2

Elk bestand downloaden

Elk bestand bevat een link urls.coda (en urls.pdf als u daarom hebt gevraagd).Het gaat om vooraf ondertekende URL’s: u downloadt ze met een gewone GET, zonder de API-headers.
Download-URL’s verlopen 30 minuten na de aanroep van de lijst. Is een URL verlopen, vraag de lijst dan opnieuw op om een nieuwe URL te krijgen.
3

Elke download bevestigen

Zodra u een bestand aan uw kant hebt opgeslagen, roept u DELETE /coda-files/{fileId} aan met de id van het bestand.Het bestand wordt niet verwijderd. Het wordt voor uw API-sleutel en de huidige gebruiker als gedownload gemarkeerd, en verschijnt niet meer in de volgende lijst.Bevestigt u hetzelfde bestand twee keer, dan krijgt u 409.

​
Een bestand opnieuw downloaden

Wilt u bestanden opvragen die al bevestigd zijn, stuur dan "redownload": true mee. Combineer dit met filters zoals statementDate om een bepaalde periode op te halen.

​
Goed om te weten

  • De lijst is niet gepagineerd. Bevestig de bestanden gaandeweg, zodat de antwoorden klein blijven.
  • Bevestigingen gelden per API-sleutel en per gebruiker. Voor een andere gebruiker van uw software blijft het bestand nieuw.
  • De lijst bevat alleen bestanden die Codaclean volledig heeft verwerkt.