Release 2027 (pre-release) · Schemaversie001.05 · Nieuw in Release 2027

SIVI-bericht 15 (00557): Corporate Actions (VB-PUO)

Bericht 15 is nieuw in Release 2027 en meldt corporate actions op beleggingsproducten die in de vermogensadministratie zijn verwerkt maar niet vanzelf zichtbaar zijn in de systemen van de PUO: contant dividend, stockdividend, productwijzigingen en rebates (retourprovisies). Zo blijft de PUO-administratie synchroon met die van de vermogensbeheerder en worden geld- en unitmutaties correct verwerkt.

Verzender

De vermogensbeheerketen (beleggingsadministrateur, custodian of fiduciair)

Ontvanger

Pensioenuitvoeringsorganisatie (PUO)

Moment

Ad hoc, gebeurtenisgedreven

Regeling

SPR en FPR

afdDefinitionName

VBPUO-001.05-Bericht_15._Corporate_Actions_(00557)

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] · 0 attr.
  - investment.investmentDetails[1..999] · 2 attr.
    - investment.corporateAction[1..99] · 13 attr.

Attributen(43)

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	afdDefinitionName	string · max 80	V		De AFD definitienaam van o.a. webservices en verzekeringsproducten.
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	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	fileName	string · max 60	V		Naam van het bestand waaronder de bijlage kan worden opgeslagen.
document.default	fileExtension	string	V	pdf \| csv \| txt	Document bestandsextensie.
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.
investment.investmentDetails	refKey	string · max 70	V		Entiteitsreferentie is een unieke referentie sleutel die aan een entiteit wordt toegekend.
investment.investmentDetails	description	string · max 60	V		Omschrijving
investment.corporateAction	refKey	string · max 70	V		Entiteitsreferentie is een unieke referentie sleutel die aan een entiteit wordt toegekend.
investment.corporateAction	description	string · max 60	V		Omschrijving
investment.corporateAction	corporateActionType	string	V	AFDCAE	Type corporate action
investment.corporateAction	instructionDate	string · format date	V		Instructiedatum (datum van de bestelling verzonden door de PUO.
investment.corporateAction	tradeDate	string · format date	V		Gewenste handelsdatum.
investment.corporateAction	paymentDate	string · format date	V		Datum waarop de betaling plaatsvindt of plaatsvond.
investment.corporateAction	cashDividendTotalAmount	number	O		Totaal contant dividendbedrag over alle aangehouden eenheden.
investment.corporateAction	cashDividendPerUnitAmount	number	O		Contant dividendbedrag per aangehouden eenheid.
investment.corporateAction	currencyType	string · max 3	O	ISOVAL	Valuta van het contante bedrag.
investment.corporateAction	stockDividendPerUnitNumber	number	O		Aantal extra units dat per aangehouden eenheid wordt uitgekeerd als stock dividend.
investment.corporateAction	stockDividendTotalNumber	number	O		Totaal aantal extra units dat wordt uitgekeerd als stock dividend.
investment.corporateAction	newProductName	string · max 60	O		Nieuwe naam van het product na een naamswijziging.
investment.corporateAction	newProductIdentifier	string · max 60	O		Nieuwe identifier van het product na een naamswijziging van het product.

Voorbeeldbericht

✓ Gevalideerd tegen schema VBPUO-001.05 · 2026-09-05

Bron voorbeeld: Gegenereerd door WTP Data Lab. Waarden zijn fictief.

{
  "commonFunctional": [
    {
      "entityType": "default",
      "afdDefinitionName": "VBPUO-001.05-Bericht_15._Corporate_Actions_(00557)",
      "afdDefinitionVersion": "001.05",
      "function": "01"
    }
  ],
  "commonTechnical": [
    {
      "entityType": "default",
      "creationDateTime": "2026-09-30T17:00:00+02:00",
      "messageId": "00557-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"
            }
          ],
          "investment": [
            {
              "entityType": "investmentDetails",
              "refKey": "INVESTME-004",
              "description": "Voorbeeld",
              "investment": [
                {
                  "entityType": "corporateAction",
                  "refKey": "CORPORAT-005",
                  "description": "Voorbeeld",
                  "corporateActionType": "rebate",
                  "instructionDate": "2026-09-24",
                  "tradeDate": "2026-09-28",
                  "paymentDate": "2026-10-05",
                  "cashDividendTotalAmount": 250000,
                  "cashDividendPerUnitAmount": 12.345678,
                  "currencyType": "AED"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Regels en verbandscontroles

corporateActionType komt uit de codelijst AFDCAE (hernoemd naar AFDCOA, issue #137): cashDividend, stockDividend, productChange en rebate.
Een rebate wordt gemodelleerd als corporateActionType = rebate met het bedrag in cashDividendTotalAmount en cashDividendPerUnitAmount.
Een productwijziging vult newProductIdentifier en newProductName; een stockdividend vult stockDividendTotalNumber en stockDividendPerUnitNumber.
instructionDate, tradeDate en paymentDate beschrijven de tijdlijn van de gebeurtenis; investment.investmentDetails identificeert het product en het aantal units.

Valkuilen

Het feedbackschema 001.02 kent 00557 nog niet in de lijst van originalMessageType; een feedbackbericht op een corporate action kan dat veld dus (nog) niet vullen. Gebruik originalMessageId en meld het bij SIVI.
De codelijstnaam in het schema is nog AFDCAE terwijl SIVI de lijst naar AFDCOA hernoemt (issue #137); controleer bij elke release welke naam het schema gebruikt.

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.
corporateActionType ongeldig (AFDCAE, wordt AFDCOA)Schemafout 'must match exactly one schema in oneOf' op corporateActionType.
originalMessageType 00557 wordt niet geaccepteerd door feedbackschema 001.02Een feedbackbericht op een corporate action (bericht 15) met originalMessageType = 00557 geeft een schemafout op originalMessageType.
currencyType geen ISO 4217-codeSchemafout op currencyType (codelijst ISOVAL).

Veelgestelde vragen

Waarom een apart bericht voor corporate actions?

Omdat dividenden, rebates en productwijzigingen geld- en unitmutaties veroorzaken die niet uit orders (5/6) of waarde-informatie (13) volgen; zonder melding loopt de PUO-administratie uit de pas met de vermogensbeheerder.

Wijzigingsgeschiedenis

v1.4.0 (Release 2027): nieuw bericht; AFD 2.0-release april 2026 voegde het entityType corporateAction toe.

Schema-bestand: VBPUO-001.00-Bericht_15._Corporate_Actions_(00557)_v5.json · JSON-schema (001.05) · GitHub