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 | Unieke ID van de toewijzing. Wordt automatisch toegekend | 4567 |
| status | text | Status van de toewijzing. Mogelijke waarden: allocated (toegewezen), assigned (toegewezen aan klant/leverancier), external (toegewezen aan extern document) | allocated |
| amount | float | Bedrag van de toewijzing. Positief bedrag bij inkomende betalingen en negatief bedrag bij uitgaande betalingen. | 780 |
| invoice_id | int | ID van de factuur van de toewijzing. | 123456 |
| invoice_number | text | Nummer van de toegewezen factuur. Wordt automatisch weergegeven indien ID van de factuur beschikbaar | 2025-0001 |
| receipt_id | int | ID van het kasticket van de toewijzing. | 123456 |
| receipt_number | text | Nummer van het toegewezen kasticket. Wordt automatisch weergegeven indien ID van het kasticket beschikbaar. | #000001 |
| paymentrequest_id | int | ID van het betaalverzoek van de toewijzing | 123456 |
| paymentrequest_number | text | Nummer van het toegewezen betaalverzoek. Wordt automatisch weergegeven indien ID van het betaalverzoek beschikbaar. | 2025-0001 |
| purchase_id | int | ID van de aankoopfactuur van de toewijzing | 123456 |
| purchase_number | text | Nummer van de toegewezen aankoopfactuur. Wordt automatisch weergegeven indien ID van de aankoopfactuur beschikbaar. | 202500123 |
| client_id | int | ID van de klant van de toewijzing | 123456 |
| client_name | text | Naam van de toegewezen klant | Jan Desmet |
| supplier_id | int | ID van de leverancier van de toewijzing | 123456 |
| supplier_name | text | Naam van de toegewezen leverancier. Wordt automatisch weergegeven indien ID van de leverancier beschikbaar | Telenet |
| reference | text | Eigen referentie van de toewijzing. Kan enkel worden gebruik indien geen andere toewijzing opgegeven. Status komt in external | Loon mei |
| created | datetime | Datum van toewijzing | 2025-05-15 13:57:18 |
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"
}
]
}