Release 2027 · Schemaversie 001.05 · Actief
SIVI-bericht 13 (00555b): Waarde-informatie beleggingspool (VB-PUO)
Bericht 13 levert de waarde van elke beleggingspool: de (voorlopige) unitwaarde, het aantal units en de totale waarde, plus de waarde van de gemuteerde units. De PUO gebruikt het om de persoonlijke pensioenvermogens te waarderen en de unit-administratie te sluiten; de fiduciair om de uitvoering te controleren.
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.
- investment.pool[1..99] · 6 attr.
- pension.scheme[1..999] · 2 attr.
Attributen (35)
| 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_13._Waarde-informatie_beleggingspool_(00555b) | 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 | participationValuationDate | string · format date | V | Prijsdatum van de participatiewaarde (cohortpool). | |
| investment.pool | refKey | string · max 70 | V | Entiteitsreferentie is een unieke referentie sleutel die aan een entiteit wordt toegekend. | |
| investment.pool | description | string · max 60 | V | Omschrijving | |
| investment.pool | currencyType | string | V | ISOVAL | ISO valutacodetabel (ISO 4217) |
| investment.pool | numberOfUnits | number · multipleOf 0.000001 | O | Aantal units/eenheden. | |
| investment.pool | preliminaryUnitValueAmount | number · multipleOf 0.000001 | O | Voorlopige unitwaarde. | |
| investment.pool | unitsSummedValueAmount | number · multipleOf 0.01 | V | Som van unitwaarden. |
Voorbeeldbericht
Bron voorbeeld: SIVI voorbeeldbericht (Voorbeeldbericht_13). Waarden zijn fictief.
{
"commonTechnical": [
{
"entityType": "default",
"creationDateTime": "2027-03-01T09:00:00+01:00",
"messageId": "VB-00555B-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_13._Waarde-informatie_beleggingspool_(00555b)",
"afdDefinitionVersion": "001.05",
"function": "01"
}
],
"party": [
{
"entityType": "pensionProvider",
"puvCode": "U0393",
"organizationName": "Pensioenfonds Metaal en Techniek",
"pension": [
{
"entityType": "scheme",
"refKey": "REG-01",
"pensionSchemeName": "Flexibele regeling Voorbeeld",
"financialInformation": [
{
"entityType": "reportingPeriod",
"participationValuationDate": "2027-02-26"
}
],
"investment": [
{
"entityType": "pool",
"refKey": "POOL-MATCH",
"description": "Matchingpool",
"currencyType": "EUR",
"numberOfUnits": 356968.172112,
"preliminaryUnitValueAmount": 103.7903,
"unitsSummedValueAmount": 37049833.67
},
{
"entityType": "pool",
"refKey": "POOL-REND",
"description": "Rendementspool",
"currencyType": "EUR",
"numberOfUnits": 281186.218314,
"preliminaryUnitValueAmount": 108.1778,
"unitsSummedValueAmount": 30418106.49
},
{
"entityType": "pool",
"refKey": "POOL-RENTE",
"description": "Rentepool",
"currencyType": "EUR",
"numberOfUnits": 1649532.890637,
"preliminaryUnitValueAmount": 120.4195,
"unitsSummedValueAmount": 198635925.92
}
]
}
]
}
]
}Regels en verbandscontroles
- Twee momenten in de cyclus: een voorlopige NAV op T-4 (basis voor de orders) en een definitieve NAV op T+3 (basis voor de waardering en de betaalinformatie van bericht 14).
- Per pool: unitsSummedValueAmount (verplicht), numberOfUnits en preliminaryUnitValueAmount; currencyType in ISO 4217. In SIVI's voorbeeld is de poolwaarde het aantal units maal de unitwaarde.
- Release 2027 vereenvoudigde de NAV-structuur; issue #136 (nog open) stelt voor preliminaryUnitValueAmount te hernoemen omdat het veld ook de definitieve waarde draagt. In de definitieve Release 2027 heet het veld nog zo.
Valkuilen
- Een definitieve NAV verzonden met dezelfde messageId als de voorlopige wordt afgewezen (dubbele messageId na acceptatie); gebruik een nieuwe messageId en verwijs desgewenst met originalMessageId.
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.
- currencyType geen ISO 4217-codeSchemafout op currencyType (codelijst ISOVAL).
- Fout ontdekt na acceptatie: het correctieprotocolEen geaccepteerd en verwerkt bericht blijkt inhoudelijk fout (verkeerd bedrag, verkeerd cohort).
Verschil met Release 2026 (001.04 → 001.05)
Attributen verwijderd: investment.pool.marketValueAmount
Veelgestelde vragen
Hoe onderscheid ik de voorlopige van de definitieve waarde?
Aan het moment (T-4 versus T+3) en aan de rapportageperiode; het schema kent geen aparte statusvlag. Leg de conventie vast in de ketenafspraken tot SIVI issue #136 heeft verwerkt.
Wijzigingsgeschiedenis
- v1.1.0 (juli 2024): marketValueAmount, preliminaryUnitValueAmount en numberOfUnits toegevoegd.
- v1.4.0 (Release 2027): NAV-structuur vereenvoudigd; JSON Schema 2020-12.
Schema-bestand: VBPUO-001.00-Bericht_13._Waarde-informatie_beleggingspool_(00555b).json · JSON-schema (001.05) · GitHub
