SIVI-bericht 2 (0001b): Cashflow (VB-PUO)

Regels en verbandscontroles

• Sinds de definitieve Release 2027 draagt elk cashflowblok netAmount en netDate: direct onder de regeling, per cohort en per beleggingsportefeuille. contributionAmount en withdrawalAmount zijn een optionele aanvulling, onder de regeling en per portefeuille met contributionDate en withdrawalDate; SIVI's eigen voorbeeldbericht vult ze alle drie. netAmount is het saldo van inleg en onttrekking, dus drie bedragen die niet op elkaar aansluiten spreken elkaar tegen. In Release 2026 mag het saldo, de aparte stromen of allebei.
• Het totaal staat in beide routes direct onder de regeling (financialTransaction.cashflow). Wat elkaar per regeling uitsluit, is de uitsplitsing: per cohort (SPR-route; de bedragen staan op het cohort zelf) óf per beleggingsportefeuille (FPR-route; elke gebruikte portefeuille heeft precies één cashflow). Een bericht dat binnen één regeling beide uitsplitsingen gebruikt, is "niet geldig". De uitsplitsing zelf is in bericht 2 optioneel, maar elke regeling bevat minstens één cashflow (handleiding §6.3.1 en §3.2.5).
• Wordt de cashflow per cohort uitgesplitst, dan tellen de cohortbedragen op tot het bedrag op regelingniveau. Release 2027 legt dat vast als verbandscontrole (handleiding §6.3.1 en §3.2.5: scheme.netAmount is de som van cohort.netAmount, en hetzelfde voor contributionAmount en withdrawalAmount); in Release 2026 is het een aansluiting die de ontvanger kan toetsen. In de FPR-route draagt het totaal in de regel de som van de portefeuilles, maar of die moet aansluiten, is "niet vastgelegd". Let op bij contributionAmount en withdrawalAmount: de in- en uitstroom per cohort bevat ook de verschuivingen tussen cohorten (§3.2.2); die vallen weg in netAmount, niet in de in- en uitstroom afzonderlijk. Houd de cohortindeling gelijk aan die van bericht 1.
• Alle datums vallen binnen de rapportageperiode (financialInformation.reportingPeriod.startDate tot endDate).

Valkuilen

• Een prospectief bericht (verwachte stromen) dat later niet wordt gevolgd door de gerealiseerde stromen laat de beleggingsadministratie met een schatting achter; spreek af welke variant leidend is.
• netDate ontbreekt vaak, vooral per cohort. Sinds de definitieve Release 2027 is dat een schemafout: netAmount en netDate zijn verplicht in elk cashflowblok. Het gepubliceerde schema telt alleen de geldige cohorten (issue #63), dus een generieke validator laat het door; een ontvanger die elk cohort toetst niet. SIVI's eigen voorbeeld van de pre-release had dit gebrek.

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.
• startAmount niet in twee decimalen (multipleOf 0.01)Schemafout 'must be multiple of 0.01'.
• reportingPeriod: endDate ligt vóór startDateHet schema accepteert het bericht; de ontvanger wijst het functioneel af of boekt de stromen in de verkeerde periode.
• Cohort-cardinaliteit overschreden (minContains / maxContains)Schemafout 'must contain at least 1 valid item' of 'must contain at most 99999 valid items' op pension.
• participationStatus ongeldig (ADNDNS)Schemafout 'must match exactly one schema in oneOf' op pension.cohort.participationStatus.
• reserveType ongeldig (AFDRES)Schemafout 'must match exactly one schema in oneOf' op reserveType.
• reserveIndicator zonder reserveType, of reserveType 99 zonder reserveDescriptionOnder Release 2027 een fout van de verbandscontrole bij reserveType. Onder Release 2026 schema-valide, maar de ontvanger kan de reserve niet typeren en boekt hem als gewoon cohort; bij reserveType 99 zonder omschrijving weet hij niet welke reserve is bedoeld.
• endAge kleiner dan startAge, of geen geheel getalBij decimalen een schemafout 'must be integer'; bij verwisselde grenzen accepteert het schema en wijst de ontvanger af.
• Cohortsom wijkt af van het regelingtotaalSchema-valide, maar de fiduciair of beleggingsadministrateur meldt een reconciliatieverschil op regelingniveau.
• netAmount is niet het saldo van contributionAmount en withdrawalAmountSchema-valide; de ontvanger weet niet welk bedrag leidend is, of telt de stromen dubbel.
• netAmount of netDate ontbreekt in een cashflowblok (bericht 2)Schemafout 'must have required property' op netDate of netAmount, bij een cohort, bij de cashflow onder de regeling of bij een beleggingsportefeuille. Een generieke JSON Schema-validator ziet de fout bij een cohort vaak niet.
• Regeling met cohorten én portefeuilles, of zonder uitsplitsing of cashflow (berichten 2 en 3)Schema-valide, maar de ontvanger kan de stromen of de projectie niet aan de juiste route toewijzen. De validator van WTP Data Lab meldt een fout bij de regeling.
• 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)

Entiteiten toegevoegd: investment.portfolio

Attributen toegevoegd: investment.portfolio.refKey, investment.portfolio.description, pension.cohort.netDate

Verplichting gewijzigd: financialTransaction.cashflow.netAmount (O → V), financialTransaction.cashflow.netDate (O → V), pension.cohort.netAmount (O → V)

Wijzigingsgeschiedenis

• v1.3.0 (Release 2026): documentatie netDate (issue #82); chunking.
• v1.4.0 (Release 2027): SPR-route en FPR-route; JSON Schema 2020-12.
• Definitieve Release 2027 (12 oktober 2026): netAmount en netDate verplicht in elk cashflowblok, ook per cohort; de cashflow per portefeuille mag ook in- en uitstroom dragen; de routes in §6.3.1 en de nieuwe §3.2.5.

Schema-bestand: VBPUO-001.00-Bericht_2._Cashflow_(0001b).json · JSON-schema (001.05) · GitHub