Om het inlezen van bankbestanden (zoals CODA of CSV) te automatiseren, kan je deze via de API uploaden. De bankverrichtingen worden daarbij automatisch gekoppeld aan openstaande facturen, zodat betalingen automatisch geregistreerd worden.
Voorwaarde: activeer eerst de Bank-module om gebruik te maken van deze functionaliteit.
Stuur de inhoud van het bankbestand naar: POST /api/v1/banktransactions/import/{bestandstype}
Vervang {bestandstype} door het juiste type bestand dat je wilt importeren.
Ondersteunde bestandstypes
Bestandstype | Beschrijving |
---|---|
coda | CODA-bestand (standaard in België) |
mt940 | MT940-formaat |
csv_bnpparisbas | CSV van BNP Paribas Fortis |
csv_belfius | CSV van Belfius |
csv_kbc | CSV van KBC |
csv_ing | CSV van ING |
Voorbeelden
Importeer CODA-bestand in curl:
curl -X POST "https://eenvoudigfactureren.be/api/v1/banktransactions/import/coda" \ -H "X-API-Key: your_api_key_here" \ -H "Accept: application/json" \ --data-binary @bestand.coda
Importeer CODA-bestand in PHP:
$p = curl_init('https://eenvoudigfactureren.be/api/v1/banktransactions/import/coda'); curl_setopt($p, CURLOPT_HTTPHEADER, [ 'Accept: application/json', 'X-API-Key: your_api_key_here', ]); curl_setopt($p, CURLOPT_POST, 1); curl_setopt($p, CURLOPT_POSTFIELDS, $codaContent); curl_setopt($p, CURLOPT_RETURNTRANSFER, TRUE); $result = json_decode(curl_exec($p)); curl_close($p);
Voorbeeld bij fout:
{ "error": "invalid content" }
Voorbeeld bij succes:
{ "success": "bank transactions imported", "banktransaction_count": 20 }
Meer info? Lees onderstaande nuttige artikels