You can now request CODA files for the period prior to the activation of the mandate. This can be useful when transferring a company from another office or when adding an IBAN (for an existing company) that has already been in use for some time.


Historical CODA is available for current accounts with active CODA via Argenta, Bank van Breda, Banque CPH, Belfius, Beobank, BNP Paribas Fortis, CBC, Crelan, ING, KBC, and Triodos.

The files are generated based on an open banking connection and are numbered with '000'. Check with your software to see if processing is possible and, if necessary, whether certain settings need to be adjusted.


This functionality is brand new and is currently still being developed further. Would you like to give it a try?

We would love to receive any feedback you have via helpdesk@codabox.com.


Enable historical CODA for your organization


  1. In the blue menu bar at the top, click Administration. Go to Settings and choose CODA.
  2. Turn the toggle switch on to activate Historical CODA.
    Historical CODA: switch on the toggle
  3. In the next screen, you'll see more info about the possibilities. Click Confirm.


Then you can request historical CODA per company. This is done in 3 steps:

  1. Request: open the company's CODA tab > Request historical CODA.
  2. Consent: the account holder receives an email to give one-time consent via the banking application.
  3. Delivery: following the consent, the files will be available via Mandates & Services > CODA > Delivery on demand.


More info below.


Request, consent and delivery of historical CODA


Request historical CODA
  1. Find the company and open the CODA tab.
  2. At the top right, click the button Request historical CODA.
    Request Historical CODA in MyCodabox
  3. On the next screen, select the current account(s) for which you want to retrieve CODA.
    The screen indicates which accounts are eligible (more info about the conditions and status). The available period depends on the bank and varies from 6 months to 2 years.
  4. Click Submit request.
    The account holder will receive a request to provide one-time authorization via the banking app (in addition to the mandate previously signed).

We recommend that you inform the account holder about this personally. Use our handy template (NL / FR).


Consent by the account holder
The account holder immediately receives an email from Codabox. 
The account holder clicks the button Approve request and then follows a few short steps to give consent via our trusted external provider Spendee/Salt Edge and the familiar banking portal. No fees are charged.


Delivery of the files
The files are NOT automatically delivered. Once the account holder has given consent, the available files are prepared in MyCodabox. Follow these steps to have them delivered:
  1. Go to Mandates & Services > CODA.
  2. Find the company in the list.
  3. Click the button Delivery on demand.Historical CODA: delivery on demand
  4. Select the period for which you wish to receive the files.
    The screen indicates the availability. Select the entire period or another date range within this period. Via the button Advanced you can also select a separate period per bank account or select ‘CODA number’ 000 to 000 (this numbering is specific to historical CODA).
    Tip: The files that were not previously delivered, are indicated in the calendar with a colored dot.
  5. Click Download CODA or Deliver CODA:
    • Download CODA: You will immediately find the files on the download location that is configured via your browser. 
    • Deliver CODA: You will receive the files within 24 hours via your daily delivery method. You will immediately see how many files you will receive (per bank account).


More info about the files


We generate these files using an open banking connection. You may notice a difference compared to the CODA statements you receive daily.


We ensure that balances match and prefix all historical CODA statements with '000'.
Since banks use different numbering systems, and counting backward from the files already available is often not possible, we use this standard numbering to facilitate better integration with most softwares.

Check with your software provider to see if processing is possible and whether certain settings need to be adjusted.


Conditions and status


Requesting historical CODA is possible if the following conditions are met:

  • The IBAN is a current account (not possible for savings accounts)
  • CODA is active for the IBAN
  • The bank supports historical CODA. Currently: Argenta, Bank van Breda, Banque CPH, Belfius, Beobank, BNP Paribas Fortis, CBC, Crelan, ING, KBC, and Triodos. 

The available period depends on the bank and varies from 6 months to 2 years (counting backward from the date the account holder gives consent).


In MyCodabox you'll see the status in the request screen and in the IBAN overview on the CODA tab.
Historical CODA: check the status


What does the status mean?

StatusMeaning
PossibleYou can request historical CODA statements.

The available period depends on the bank (it is calculated retroactively from the date the account holder gives consent).

Waiting for consentThe account holder received an email asking them to give one-time consent via the banking app.
CODA being createdThe account holder has given consent. The files will soon be available for delivery.
Ready for delivery

There are historical CODA files ready for delivery.

➜ Use the button Delivery on demand to get the desired files.

History deliveredThe historical CODAs have been delivered or will soon be retrieved by your software.
Request expired

The request is no longer valid.

➜ Retry the request via MyCodabox and contact the account holder to give consent.

Request failed

The request did no go through. 

➜ Check the account number and the email address and try again.

Not possible

Not possible for this bank

or

It is a savings account

or 

CODA is not active for this account and/or there are no regular CODA files yet, which means there cannot be historical CODA
or
Codabox has been delivering CODA for this account for so long that historical CODA does not apply.