Release 2027 (pre-release) · Schemaversie001.05 · Actief
SIVI-bericht 10 (00553): Stuurinformatie beleggingspools (VB-PUO)
Bericht 10 vertelt de fiduciair manager per beleggingspool wat er netto gekocht of verkocht moet worden als gevolg van de mutaties in de deelnemersadministratie: de participatiewaarden en het geschatte kaseffect. Het is de stuurinformatie waarmee de fiduciair de operationele vermogensbeheerders en de LDI-manager instrueert.
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] · 2 attr.
- investment.pool[1..99] · 5 attr.
- pension.scheme[1..999] · 2 attr.
Attributen(35)
| Entiteit | Attribuut | Type | V/O | Codelijst | Omschrijving |
|---|---|---|---|---|---|
| chunking.default | currentChunkId | string | 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 | 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 | messageId | string · max 70 | V | Unique identification of the message. (AFD 2.0 only) | |
| commonTechnical.default | testMessage | boolean | O | Indicatie of sprake is van een testbericht. | |
| 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 | workPhoneNumber | string · max 60 | V | Telefoonnummer werk | |
| party.contact | emailWork | string · max 60 | V | E-mail adres werk | |
| document.default | refKey | string · max 70 | V | Entiteitsreferentie is een unieke referentie sleutel die aan een entiteit wordt toegekend. | |
| document.default | fileExtension | string | V | pdf | csv | txt | Extensienaam van het bestand waaronder de bijlage kan worden opgeslagen. Bijvoorbeeld "PDF", "DOC", etc. |
| document.default | fileName | string · max 60 | V | Naam van het bestand waaronder de bijlage kan worden opgeslagen. | |
| 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 | investmentOrderSettlementDate | string · format date | V | Datum waarop de volledige cyclus van de beleggingsorder afgewikkeld moet zijn. | |
| financialInformation.reportingPeriod | tradeDate | string · format date | V | Gewenste handelsdatum. | |
| investment.pool | refKey | string · max 70 | V | Entiteitsreferentie is een unieke referentie sleutel die aan een entiteit wordt toegekend. | |
| investment.pool | currencyType | string | V | ISOVAL | ISO valutacodetabel (ISO 4217) |
| investment.pool | description | string · max 60 | V | Omschrijving | |
| investment.pool | buySellId | string | V | sell | buy | Aan- en verkoopindicator. |
| investment.pool | tradeValueAmount | number · multipleOf 0.01 | V | Bedrag waarde in het economisch verkeer |
Voorbeeldbericht
Bron voorbeeld: Gegenereerd door WTP Data Lab. Waarden zijn fictief.
{
"commonFunctional": [
{
"entityType": "default",
"afdDefinitionVersion": "001.05",
"afdDefinitionName": "VBPUO-001.05-Bericht_10._Stuurinformatie_beleggingspools_(00553)",
"function": "01"
}
],
"commonTechnical": [
{
"entityType": "default",
"creationDateTime": "2026-09-30T17:00:00+02:00",
"messageId": "00553-20260930-000001",
"testMessage": true,
"party": [
{
"entityType": "receiver",
"refKey": "RECEIVER-001",
"organizationName": "Fiduciair Beheer Voorbeeld N.V.",
"rsinNumber": "123456789"
},
{
"entityType": "sender",
"refKey": "SENDER-002",
"applicationSenderName": "WTP Data Lab",
"organizationName": "Pensioenuitvoeringsorganisatie Voorbeeld B.V.",
"rsinNumber": "123456789",
"party": [
{
"entityType": "contact",
"workPhoneNumber": "+31201234567",
"emailWork": "[email protected]"
}
]
}
]
}
],
"party": [
{
"entityType": "pensionProvider",
"organizationName": "Stichting Pensioenfonds Voorbeeld",
"rsinNumber": "123456789",
"puvCode": "U0003",
"pension": [
{
"entityType": "scheme",
"refKey": "SCHEME-003",
"pensionSchemeName": "Solidaire premieregeling Voorbeeld",
"financialInformation": [
{
"entityType": "reportingPeriod",
"investmentOrderSettlementDate": "2026-10-02",
"tradeDate": "2026-09-28"
}
],
"investment": [
{
"entityType": "pool",
"refKey": "POOL-004",
"currencyType": "AED",
"description": "Voorbeeld",
"buySellId": "buy",
"tradeValueAmount": 250000
}
]
}
]
}
]
}Regels en verbandscontroles
- Per beleggingspool: buySellId (buy of sell), tradeValueAmount (kaseffect), unitsSummedValueAmount, preliminaryUnitValueAmount en numberOfUnits.
- Release 2027 heeft de cohortenpool-laag verwijderd; de gegevens landen direct op investment.pool. De velden dummyCashId, tradeQuantity, unitPrice en currencyExchangeRate zijn geschrapt (issue #133).
- Het bericht moet op T-4 bij de fiduciair zijn; te laat betekent dat de uitvoeringsvenster (T tot T+3) niet gehaald wordt.
Valkuilen
- Berichten opgesteld met het Release 2026-schema bevatten de pensionCohortPool-laag en worden door een Release 2027-ontvanger afgewezen (onbekend veld).
- Issue #92 ('SIVI 10 sell units'): een verkoop wordt uitgedrukt met buySellId = sell en positieve aantallen, niet met een negatief aantal.
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.
- 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.
- buySellId ongeldigSchemafout 'must be equal to one of the allowed values' op buySellId.
- tradeAmount of tradeQuantity negatiefSchema-valide, maar de ontvanger interpreteert het teken verschillend van de bedoeling.
- currencyType geen ISO 4217-codeSchemafout op currencyType (codelijst ISOVAL).
- Onbekend veld (additionalProperties = false)Schemafout 'must NOT have additional properties' met de naam van het extra veld.
Verschil met Release 2026(001.04 → 001.05)
Entiteitenverwijderd:pension.cohortPool
Attributenverwijderd:pension.cohortPool.refKey, pension.cohortPool.description, pension.cohortPool.currencyType, pension.cohortPool.cohortRef, investment.pool.currencyExchangeRate, investment.pool.dummyCashId, investment.pool.tradeQuantity, investment.pool.unitPrice
Veelgestelde vragen
Wie stuurt bericht 10: de PUO of de beleggingsadministrateur?
Dat hangt af van wie de unit-administratie voert. In een zelf uitvoerend fonds is dat de PUO; waar de beleggingsadministrateur de units administreert, stuurt de BA. SIVI is gevraagd de handleiding hierop te verduidelijken (issue #142).
Wijzigingsgeschiedenis
- v1.4.0 (Release 2027): cohortenpool-laag verwijderd; velden dummyCashId, tradeQuantity, unitPrice en currencyExchangeRate geschrapt; JSON Schema 2020-12.
Schema-bestand: VBPUO-001.00-Bericht_10._Stuurinformatiebeleggingspools_(00553)_v5.json · JSON-schema (001.05) · GitHub
