# SnelStart API - POST /v2/bankboekingen
Maakt een nieuwe Bankboeking aan.
**Scopes:** `bankieren:write`, `bankboekingen`
## Request
```
POST https://b2bapi.snelstart.nl/v2/bankboekingen
```
## Request Body - BankboekingModel
| Name | Required | Read-only | Type | Description |
|------|----------|-----------|------|-------------|
| modifiedOn | false | false | string (date-time) | Het tijdstip waarop de bankboeking is aangemaakt of voor het laatst is gewijzigd |
| datum | **true** | false | string (date-time) | Boekingsdatum |
| markering | false | false | boolean | **Deze bankboeking verdient speciale aandacht, in SnelStart wordt dit visueel benadrukt** |
| boekstuk | false | false | string | Het boekstuknummer van de bankboeking |
| gewijzigdDoorAccountant | false | false | boolean | Geeft aan of deze bankboeking is aangepast door de accountant |
| omschrijving | false | false | string | Omschrijving |
| grootboekBoekingsRegels | false | false | GrootboekBoekingsRegelModel[] | Grootboek boekingsregels |
| inkoopboekingBoekingsRegels | false | false | InkoopBoekingVerantwoordingsRegelModel[] | Inkoopboeking boekingsregels |
| verkoopboekingBoekingsRegels | false | false | VerkoopBoekingVerantwoordingsRegelModel[] | Verkoopboeking boekingsregels |
| btwBoekingsregels | false | false | BtwBoekingregelModel[] | BTW boekingsregels |
| bedragUitgegeven | **true** | false | number (decimal) | Bedrag uitgegeven |
| bedragOntvangen | **true** | false | number (decimal) | Bedrag ontvangen |
| dagboek | **true** | false | DagboekIdentifierModel | Dagboek referentie |
| id | false | false | string (uuid) | De publieke sleutel |
| uri | false | true | string | Relatieve Uri van het object |
### Example Request
```json
{
"modifiedOn": "string",
"datum": "string",
"markering": true,
"boekstuk": "string",
"gewijzigdDoorAccountant": true,
"omschrijving": "string",
"grootboekBoekingsRegels": [{
"omschrijving": "string",
"grootboek": {
"id": "00000000-0000-0000-0000-000000000000",
"uri": "string"
},
"kostenplaats": {
"id": "00000000-0000-0000-0000-000000000000",
"uri": "string"
},
"debet": 0,
"credit": 0,
"btwSoort": "Geen"
}],
"inkoopboekingBoekingsRegels": [{
"boekingId": {
"id": "00000000-0000-0000-0000-000000000000",
"uri": "string"
},
"omschrijving": "string",
"debet": 0,
"credit": 0
}],
"verkoopboekingBoekingsRegels": [{
"boekingId": {
"id": "00000000-0000-0000-0000-000000000000",
"uri": "string"
},
"omschrijving": "string",
"debet": 0,
"credit": 0
}],
"btwBoekingsregels": [{
"debet": 0,
"credit": 0,
"type": "TeVorderenBtwType",
"tarief": "Hoog"
}],
"bedragUitgegeven": 0,
"bedragOntvangen": 0,
"dagboek": {
"id": "00000000-0000-0000-0000-000000000000",
"uri": "string"
},
"id": "00000000-0000-0000-0000-000000000000",
"uri": "string"
}
```
## Response 201 Created
Returns the created BankboekingModel (same structure as request).
## Response 400 Bad Request
Wanneer een of meer validatie regels worden geschonden.
## Response 403 Forbidden
Indien niet de juiste scopes in het token aanwezig zijn.
## Sub-Models
### GrootboekBoekingsRegelModel
| Name | Required | Type | Description |
|------|----------|------|-------------|
| omschrijving | **true** | string | Omschrijving |
| grootboek | **true** | GrootboekIdentifierModel | Grootboek referentie |
| kostenplaats | false | KostenplaatsIdentifierModel | Kostenplaats referentie |
| debet | false | number (decimal) | Debet bedrag |
| credit | false | number (decimal) | Credit bedrag |
| btwSoort | false | string | BTW soort |
### InkoopBoekingVerantwoordingsRegelModel
| Name | Required | Type | Description |
|------|----------|------|-------------|
| boekingId | **true** | InkoopboekingIdentifierModel | Inkoopboeking referentie |
| omschrijving | false | string | Omschrijving |
| debet | false | number (decimal) | Debet bedrag |
| credit | false | number (decimal) | Credit bedrag |
### VerkoopBoekingVerantwoordingsRegelModel
| Name | Required | Type | Description |
|------|----------|------|-------------|
| boekingId | false | VerkoopboekingIdentifierModel | Verkoopboeking referentie |
| omschrijving | false | string | Omschrijving |
| debet | false | number (decimal) | Debet bedrag |
| credit | false | number (decimal) | Credit bedrag |
### BtwBoekingregelModel
| Name | Required | Type | Description |
|------|----------|------|-------------|
| debet | false | number (decimal) | Debet bedrag |
| credit | false | number (decimal) | Credit bedrag |
| type | **true** | string | BTW type |
| tarief | **true** | string | BTW tarief |
### Identifier Models
| Name | Required | Read-only | Type | Description |
|------|----------|-----------|------|-------------|
| id | false | false | string (uuid) | De publieke sleutel |
| uri | false | true | string | Relatieve Uri van het object |
## Notes
- `datum` moet in ISO 8601 datetime formaat (bijv. `2026-01-23T00:00:00`)
- Bij creditcard uitgave: `bedragUitgegeven` = bedrag, `debet` op grootboekregel
- Bij creditcard ontvangst: `bedragOntvangen` = bedrag, `credit` op grootboekregel
- **`markering: true`** zorgt ervoor dat de boeking visueel benadrukt wordt in SnelStart (handig voor imports)
