Gegevens uit het domein "banktransactions" stellen een bankverrichting voor. Bankverrichtingen kunnen worden toegevoegd zodat een manuele of automatische toewijzing aan facturen of andere documenten kan worden uitgevoerd. Zo wordt de betaalstatus van de factuur automatisch bijgewerkt.
Opbouw URL's:
/api/v1/banktransactions: Alle bankverrichtingen
/api/v1/banktransactions/1234: Bankverrichting met ID 1234
/api/v1/banktransactions/1234/allocations: Alle toewijzingen van bankverrichting met ID 1234
/api/v1/banktransactions/1234/allocations/5678: Toewijzing met ID 5678 van bankverrichting met ID 1234
Domein: banktransactions
| Veldnaam | Type | Omschrijving | Voorbeeld |
| banktransaction_id | int | Unieke ID van de bankverrichting. Wordt automatisch toegekend. | 1234 |
| bankaccount_id | int | ID van de bankrekening. Niet verplicht. Indien niet opgegeven bij aanmaak van wordt de standaard bankrekening ingesteld of blijft deze leeg (null). | 111 |
| bankaccount | Bankaccount | Informatie van bankrekening. Wordt teruggegeven indien bankaccount_id beschikbaar. | |
| number | text | Nummer van de bankverrichting. Wordt automatisch bepaald. | 2025/00001 |
| date | date | Datum waarop de bankverrichting werd uitgevoerd. | 2025-04-01 |
| amount | float | Totaalbedrag van de bankverrichting. Positief bedrag bij inkomende betalingen en negatief bedrag bij uitgaande betalingen. | 895 |
| amount_to_allocate | float | Nog toe te wijzen bedrag van bankverrichting. | 115 |
| currency | text | Munteenheid van de bankverrichting | EUR |
| counterpart_account_number | text | IBAN van de tegenpartij | BE81123456789012 |
| counterpart_account_name | text | Naam van de tegenpartij | Mudari |
| message | text | Mededeling (vrij of gestructureerd) van de bankverrichting. | +++000/1234/45678+++ |
| status | text | Status van de bankverrichting. Mogelijke waarden: pending (initiële status), allocated (toegewezen), assigned (toegewezen aan klant/leverancier), external (toegewezen aan extern document), unmatched (nog niet volledig toegewezen), dismissed (negeren), mixed (gemengd). | allocated |
| source | text | Bron van de bankverrichting. Mogelijke waarden: unknown (niet gekend), manual (handmatig toegevoegd), file (inlezen bankbestand), codabox (Codabox koppeling), ponto (Ponto koppeling), enablebanking (Bank koppeling) | enablebanking |
| source_reference | text | Technische referentie afhankelijk van de bron (veld source). Bij bron "file" kan de bestandsnaam worden ingevuld. | abb9l9dsc-33cb-47db |
| created | datetime | Datum van aanmaak van de bankverrichting. | 2025-04-03 17:03:13 |
| updated | datetime | Datum van laatste wijziging van de bankverrichting. | 2025-05-15 13:57:18 |
| allocations | list | Lijst met toewijzingen van de bankverrichting. | - |
Subdomein: allocations (< banktransactions)
| Veldnaam | Type | Omschrijving | Voorbeeld |
| allocation_id | int | ||
| status | text | ||
| amount | float | ||
| invoice_id | int | ||
| invoice_number | text | ||
| receipt_id | int | ||
| receipt_number | text | ||
| paymentrequest_id | int | ||
| paymentrequest_number | text | ||
| purchase_id | int | ||
| purchase_number | text | ||
| client_id | int | ||
| client_name | text | ||
| supplier_id | int | ||
| supplier_name | text | ||
| reference | text | ||
| created | datetime |
Voorbeeld van een bankverrichting in JSON:
{
"banktransaction_id": 1234,
"bankaccount_id": 111,
"bankaccount": {
"bankaccount_id": 111,
"number": "BE27123456789012",
"name": "KBC",
"active": "yes",
"default": "yes"
},
"number": "2025/00001",
"date": "2025-04-01",
"amount": 895,
"amount_to_allocate": 115,
"currency": "EUR",
"counterpart_account_number": "BE81123456789012",
"counterpart_account_name": "Mudari",
"message": "+++000/1234/45678+++",
"status": "unmatched",
"source": "enablebanking",
"source_reference": "abb9l9dsc-33cb-47db-9002-2cfal992ceza",
"created": "2025-04-03 17:03:13",
"updated": "2025-05-15 13:57:18",
"allocations": [
{
"allocation_id": 4567,
"status": "allocated",
"amount": 780,
"invoice_id": 123456,
"invoice_number": "2025-00001",
"receipt_id": null,
"paymentrequest_id": null,
"purchase_id": null,
"client_id": null,
"supplier_id": null,
"reference": "",
"created": "2025-05-15 13:57:18"
}
]
}