Release 2027 · Schemaversie 001.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 richting (buySellId) en het netto kaseffect (tradeValueAmount). Het is de stuurinformatie waarmee de fiduciair de operationele vermogensbeheerders en de LDI-manager instrueert.

Verzender

Beleggingsadministrateur (BA); de PUO alleen als die de rol van BA zelf vervult (issue #142)

Ontvanger

Fiduciair manager (FM)

Moment

T-4 (vier werkdagen voor de transactiedatum)

Regeling

FPR: beleggingspools (berichten 10, 13, 14 en 15)

afdDefinitionName

VBPUO-001.00-Bericht_10._Stuurinformatiebeleggingspools_(00553)

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.

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_10._Stuurinformatiebeleggingspools_(00553)	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	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	description	string · max 60	V		Omschrijving
investment.pool	currencyType	string	V	ISOVAL	ISO valutacodetabel (ISO 4217)
investment.pool	buySellId	string	V	sell \| buy	Aan- verkoopindicator; ID voor aan-/verkoop per beleggingspool per regeling
investment.pool	tradeValueAmount	number · multipleOf 0.01	V		Waarde transactie per beleggingspool per regeling

Voorbeeldbericht

✓ Gevalideerd tegen schema VBPUO-001.05 · 2026-10-14

Bron voorbeeld: SIVI voorbeeldbericht (Voorbeeldbericht_10). Waarden zijn fictief.

{
  "commonTechnical": [
    {
      "entityType": "default",
      "creationDateTime": "2027-03-01T09:00:00+01:00",
      "messageId": "VB-00553-0001",
      "testMessage": true,
      "party": [
        {
          "entityType": "sender",
          "refKey": "BA01",
          "organizationName": "Beleggingsadministrateur Voorbeeld",
          "applicationSenderName": "VoorbeeldApplicatie"
        },
        {
          "entityType": "receiver",
          "refKey": "FM01",
          "organizationName": "Fiduciair Manager Voorbeeld"
        }
      ]
    }
  ],
  "commonFunctional": [
    {
      "entityType": "default",
      "afdDefinitionName": "VBPUO-001.00-Bericht_10._Stuurinformatiebeleggingspools_(00553)",
      "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",
              "tradeDate": "2027-03-26",
              "investmentOrderSettlementDate": "2027-03-30"
            }
          ],
          "investment": [
            {
              "entityType": "pool",
              "refKey": "POOL-REND",
              "description": "Rendementspool",
              "currencyType": "EUR",
              "buySellId": "buy",
              "tradeValueAmount": 1218373.59
            },
            {
              "entityType": "pool",
              "refKey": "POOL-MATCH",
              "description": "Matchingpool",
              "currencyType": "EUR",
              "buySellId": "sell",
              "tradeValueAmount": 1421216.76
            },
            {
              "entityType": "pool",
              "refKey": "POOL-RENTE",
              "description": "Rentepool",
              "currencyType": "EUR",
              "buySellId": "buy",
              "tradeValueAmount": 1054178.85
            }
          ]
        }
      ]
    }
  ]
}

Regels en verbandscontroles

Per beleggingspool (investment.pool): refKey, description, currencyType, buySellId (buy of sell) en tradeValueAmount, het netto kaseffect. Aantallen units en unitwaarden staan niet in bericht 10 maar in bericht 13.
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.
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.
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)

Entiteiten verwijderd: pension.cohortPool

Attributen verwijderd: pension.cohortPool.refKey, pension.cohortPool.description, pension.cohortPool.currencyType, pension.cohortPool.cohortRef, investment.pool.currencyExchangeRate, investment.pool.dummyCashId, investment.pool.unitPrice, investment.pool.tradeQuantity

Veelgestelde vragen

Wie stuurt bericht 10: de PUO of de beleggingsadministrateur?

De beleggingsadministrateur. De definitieve handleiding van Release 2027 (12 oktober 2026) legt vast dat de rol BA de berichten 10 en 14 verstuurt; een PUO doet dat alleen als die zelf de rol van BA vervult (issue #142).

Wijzigingsgeschiedenis

v1.4.0 (Release 2027): cohortenpool-laag verwijderd; velden dummyCashId, tradeQuantity, unitPrice en currencyExchangeRate geschrapt; JSON Schema 2020-12.
Definitieve Release 2027 (12 oktober 2026): afzender de beleggingsadministrateur (issue #142).

Schema-bestand: VBPUO-001.00-Bericht_10._Stuurinformatiebeleggingspools_(00553).json · JSON-schema (001.05) · GitHub