Release 2027 · Schemaversie 001.05 · Actief
SIVI-bericht 14 (00556): Betaalinformatie (VB-PUO)
Bericht 14 bevat de betaalinstructies voor onttrekkingen: welk bedrag, in welke valuta, naar welke rekening (IBAN en BIC van de crediteur) en met welke valutadatum. De fiduciair laat de betaling uitvoeren en de kasafwikkeling verloopt via SWIFT buiten de standaard. Sinds de definitieve Release 2027 draagt één bericht per regeling 1 tot 999 betalingen.
Berichtstructuur
Entiteiten met cardinaliteit [min..max] en aantal attributen; klik voor de entiteitpagina.
- chunking.default[0..1] · 4 attr.
- commonFunctional.default[1..1] · 4 attr.
- commonTechnical.default[1..1] · 3 attr.
- party.receiver[1..1] · 3 attr.
- party.sender[1..1] · 4 attr.
- party.contact[0..9] · 2 attr.
- document.default[0..99] · 3 attr.
- party.pensionProvider[1..1] · 3 attr.
- pension.scheme[1..999] · 2 attr.
- financialInformation.reportingPeriod[1..1] · 1 attr.
- financialTransaction.payment[1..999] · 4 attr.
- party.creditor[1..1] · 5 attr.
- pension.scheme[1..999] · 2 attr.
Attributen (38)
| Entiteit | Attribuut | Type | V/O | Codelijst | Omschrijving |
|---|---|---|---|---|---|
| chunking.default | currentChunkId | string · max 70 | V | Unieke referentie van de huidige chunk. | |
| chunking.default | chunkSequenceNumber | integer | V | Volgnummer van de huidige chunk. | |
| chunking.default | totalNumberOfChunks | integer | V | Totale aantal chunks waarin het bericht is opgesplitst. | |
| chunking.default | chunkFragmentPaths | array[string] | V | Array van JMESPath-verwijzingen naar de berichtdelen die gebruikt zijn binnen deze chunk. | |
| commonFunctional.default | afdDefinitionVersion | string · max 80 | V | 001.05 | Met AFD definitieversienummer wordt aangegeven over welke versie van de (product)definitie wordt gecommuniceerd. |
| commonFunctional.default | afdDefinitionName | string · max 80 | V | VBPUO-001.00-Bericht_14._Betaalinformatie_(00556) | De AFD definitienaam van o.a. webservices en verzekeringsproducten. |
| commonFunctional.default | originalMessageId | string · max 70 | O | MessageId van het oorspronkelijke bericht, dat wordt vervangen door dit bericht. | |
| commonFunctional.default | function | string | V | ADNFUN | Berichtfunctie |
| commonTechnical.default | creationDateTime | string · format date-time | V | Datum en tijd van het aanmaken van het bericht. | |
| commonTechnical.default | testMessage | boolean | O | Indicatie of sprake is van een testbericht. | |
| commonTechnical.default | messageId | string · max 70 | V | Unique identification of the message. (AFD 2.0 only) | |
| party.receiver | refKey | string · max 70 | V | Entiteitsreferentie is een unieke referentie sleutel die aan een entiteit wordt toegekend. | |
| party.receiver | organizationName | string · max 60 | V | Naam beroeps of branche organisatie. | |
| party.receiver | rsinNumber | string · max 9 | O | Governmental identification number for legal entities and associations. (AFD 2.0 only) | |
| party.sender | refKey | string · max 70 | V | Entiteitsreferentie is een unieke referentie sleutel die aan een entiteit wordt toegekend. | |
| party.sender | applicationSenderName | string · max 60 | O | Naam van de applicatie die de gegevens verzendt. | |
| party.sender | organizationName | string · max 60 | V | Naam beroeps of branche organisatie. | |
| party.sender | rsinNumber | string · max 9 | O | Governmental identification number for legal entities and associations. (AFD 2.0 only) | |
| party.contact | emailWork | string · max 60 | V | E-mail adres werk | |
| party.contact | workPhoneNumber | string · max 60 | V | Telefoonnummer werk | |
| document.default | refKey | string · max 70 | V | Entiteitsreferentie is een unieke referentie sleutel die aan een entiteit wordt toegekend. | |
| document.default | fileName | string · max 60 | V | Naam van het bestand waaronder de bijlage kan worden opgeslagen. | |
| document.default | fileExtension | string | V | pdf | csv | txt | Extensienaam van het bestand waaronder de bijlage kan worden opgeslagen. Bijvoorbeeld "PDF", "DOC", etc. |
| party.pensionProvider | organizationName | string · max 60 | V | Naam beroeps of branche organisatie. | |
| party.pensionProvider | rsinNumber | string · max 9 | O | Governmental identification number for legal entities and associations. (AFD 2.0 only) | |
| party.pensionProvider | puvCode | string | V | AFDIDP | Pensioenuitvoerder |
| pension.scheme | refKey | string · max 70 | V | Entiteitsreferentie is een unieke referentie sleutel die aan een entiteit wordt toegekend. | |
| pension.scheme | pensionSchemeName | string · max 60 | V | Naam van de pensioenregeling. | |
| financialInformation.reportingPeriod | valueDate | string · format date | V | Valutadatum | |
| financialTransaction.payment | amount | number · multipleOf 0.01 | V | Bedrag | |
| financialTransaction.payment | description | string · max 60 | V | Omschrijving | |
| financialTransaction.payment | currencyType | string | V | ISOVAL | ISO valutacodetabel (ISO 4217) |
| financialTransaction.payment | collectionAccountIban | string · max 34 | V | Bank Account Nummer (IBAN) van de incassorekening. Zie SEPA. | |
| party.creditor | refKey | string · max 70 | V | Entiteitsreferentie is een unieke referentie sleutel die aan een entiteit wordt toegekend. | |
| party.creditor | collectionAccountIban | string · max 34 | V | Bank Account Nummer (IBAN) van de incassorekening. Zie SEPA. | |
| party.creditor | collectionAccountBic | string · max 10 | V | Bank Identificatie Code (BIC) van de incassorekening. Zie SEPA. | |
| party.creditor | collectionAccountInNameOf | string · max 60 | V | Girorek. incasso, ten name van | |
| party.creditor | collectionAccountBicCorrespondent | string · max 10 | O | BIC-correspondent. |
Voorbeeldbericht
Bron voorbeeld: SIVI voorbeeldbericht (Voorbeeldbericht_14). Waarden zijn fictief.
{
"commonTechnical": [
{
"entityType": "default",
"creationDateTime": "2027-03-01T09:00:00+01:00",
"messageId": "VB-00556-0001",
"testMessage": true,
"party": [
{
"entityType": "sender",
"refKey": "BA01",
"organizationName": "Beleggingsadministrateur Voorbeeld",
"applicationSenderName": "VoorbeeldApplicatie"
},
{
"entityType": "receiver",
"refKey": "PUO01",
"organizationName": "Pensioenuitvoerder Voorbeeld"
}
]
}
],
"commonFunctional": [
{
"entityType": "default",
"afdDefinitionName": "VBPUO-001.00-Bericht_14._Betaalinformatie_(00556)",
"afdDefinitionVersion": "001.05",
"function": "01"
}
],
"party": [
{
"entityType": "pensionProvider",
"puvCode": "U0202",
"organizationName": "Stichting Pensioenfonds ABP",
"pension": [
{
"entityType": "scheme",
"refKey": "REG-01",
"pensionSchemeName": "Basisregeling Voorbeeld",
"financialInformation": [
{
"entityType": "reportingPeriod",
"valueDate": "2027-03-25"
}
],
"financialTransaction": [
{
"entityType": "payment",
"amount": 334684.54,
"description": "Uitkeringen ouderdomspensioen maart 2027",
"currencyType": "EUR",
"collectionAccountIban": "NL86ABNA9711164294",
"party": [
{
"entityType": "creditor",
"refKey": "CRED-01",
"collectionAccountIban": "NL94INGB3692677651",
"collectionAccountBic": "INGBNL2A",
"collectionAccountInNameOf": "Stichting Uitkeringen Voorbeeld"
}
]
},
{
"entityType": "payment",
"amount": 1400556.36,
"description": "Uitkeringen partnerpensioen maart 2027",
"currencyType": "EUR",
"collectionAccountIban": "NL70ABNA6742218167",
"party": [
{
"entityType": "creditor",
"refKey": "CRED-02",
"collectionAccountIban": "NL07INGB1059682214",
"collectionAccountBic": "INGBNL2A",
"collectionAccountInNameOf": "Stichting Uitkeringen Voorbeeld"
}
]
},
{
"entityType": "payment",
"amount": 208144.59,
"description": "Afdracht loonheffing februari 2027",
"currencyType": "EUR",
"collectionAccountIban": "NL61ABNA7993076009",
"party": [
{
"entityType": "creditor",
"refKey": "CRED-03",
"collectionAccountIban": "NL18RABO8020886857",
"collectionAccountBic": "RABONL2U",
"collectionAccountInNameOf": "Ontvanger Loonheffing Voorbeeld"
}
]
}
]
}
]
}
]
}Regels en verbandscontroles
- party.creditor bevat collectionAccountIban, collectionAccountBic en collectionAccountInNameOf; collectionAccountBicCorrespondent is optioneel voor betalingen via een correspondentbank.
- financialTransaction.payment bevat amount, currencyType, description en collectionAccountIban (de debetrekening); per regeling 1 tot 999 betalingen in één bericht, waar Release 2026 en de pre-release er precies één toelieten (issue #149). De valutadatum staat in financialInformation.reportingPeriod.valueDate.
- collectionAccountIban is in de definitieve Release 2027 maximaal 34 tekens lang, de internationale IBAN-lengte, bij de betaling en bij de crediteur (issue #135); een Nederlands IBAN telt 18 tekens. Release 2026 (001.04, ook in v1.3.2) en de pre-release stonden maar 10 tekens toe: daar is een volledig IBAN een schemafout.
Valkuilen
- Een IBAN met spaties of in kleine letters valt buiten de lengte- en formaatverwachting van de ontvanger; lever het IBAN aaneengesloten in hoofdletters.
- Een bericht met volledige IBAN's of meerdere betalingen per regeling is alleen onder Release 2027 geldig; stuur het niet met afdDefinitionVersion 001.04.
- collectionAccountBic is in beide releases maximaal 10 tekens, terwijl een BIC 8 of 11 tekens telt: een BIC van 11 tekens geeft een schemafout. Gebruik de achtletterige vorm waar dat kan.
Fouten en oplossingen
- messageId ontbreekt, is leeg of langer dan 70 tekensSchemafout op commonTechnical/0/messageId: 'must have required property' of 'must NOT have more than 70 characters'.
- Dubbele messageId na acceptatie (HTTP 400 met feedback)De ontvanger antwoordt HTTP 400 met een feedbackbericht (statusType 0) op een bericht dat inhoudelijk correct lijkt.
- afdDefinitionName onjuist (vaste waarde sinds de definitieve Release 2027)Schemafout 'must be equal to constant' op afdDefinitionName; de validator van WTP Data Lab noemt de verwachte waarde. Typisch voor een bericht dat op de pre-release van juli 2026 is gebouwd: het vermeldt de juiste versie 001.05 en valt toch af.
- afdDefinitionVersion onjuist (001.04 versus 001.05)Schemafout 'must be equal to one of the allowed values' op afdDefinitionVersion, of de ontvanger valideert tegen het verkeerde schema en meldt onbekende velden.
- collectionAccountIban ongeldig of te langSchemafout op de maximale lengte van het IBAN, of een functionele afwijzing door de fiduciair.
- Meerdere betalingen per regeling of een volledig IBAN onder Release 2026 (bericht 14)Schemafout op het aantal betalingen (hoogstens één item met entityType payment) of op de lengte van collectionAccountIban, bij afdDefinitionVersion 001.04.
- collectionAccountBic ongeldigFunctionele afwijzing van de betaalinstructie.
- currencyType geen ISO 4217-codeSchemafout op currencyType (codelijst ISOVAL).
Veelgestelde vragen
Is bericht 14 een SEPA-betaalopdracht?
Nee. Het is de functionele instructie aan de fiduciair; de daadwerkelijke betaling loopt via het betaalkanaal van de custodian (SWIFT), buiten de standaard.
Wijzigingsgeschiedenis
- v1.3.0 (Release 2026): chunking.
- v1.4.0 (Release 2027): JSON Schema 2020-12.
- Definitieve Release 2027 (12 oktober 2026): 1 tot 999 betalingen per regeling (issue #149); collectionAccountIban maximaal 34 tekens (issue #135); afzender de beleggingsadministrateur (issue #142).
Schema-bestand: VBPUO-001.00-Bericht_14._Betaalinformatie_(00556).json · JSON-schema (001.05) · GitHub
