Release 2027 · Schemaversie 001.05 · v1.4.0-prerelease → v1.4.0
Release 2027: pre-release versus definitief (wat veranderde op 12 oktober 2026)
Op 12 oktober 2026 publiceerde SIVI de definitieve Release 2027 (tag v1.4.0). Die vervangt de pre-release van 17 juli 2026, die nu tag v1.4.0-prerelease heet. Beide dragen afdDefinitionVersion 001.05 (het feedbackbericht 001.02): aan het versienummer is niet te zien op welke van de twee een bericht is gebouwd. Een bericht van de pre-release kan dus 001.05 vermelden en toch worden afgewezen. Hieronder per bericht wat er veranderde, wat dat betekent voor een bericht dat op de pre-release is gebouwd en wat de validator dan meldt.
Pre-release
17 juli 2026, tag v1.4.0-prerelease
Definitief
12 oktober 2026, tag v1.4.0 (commit a603372)
Versienummer
001.05 (feedback 001.02), ongewijzigd
In gebruik
vanaf 1 januari 2027
Per bericht
| Bericht | Wat veranderde | Een bericht van de pre-release | Wat de validator meldt |
|---|---|---|---|
| Alle berichten | afdDefinitionName heeft weer een vaste waarde: de bestandsnaam van het schema met 001.00, bijvoorbeeld VBPUO-001.00-Bericht_2._Cashflow_(0001b). De versie staat alleen in afdDefinitionVersion (#140, handleiding §7.5.1.1). Verder: chunking.currentChunkId maximaal 70 tekens en bij elk attribuut een Nederlandse toelichting van SIVI (customDescription). | In de pre-release was de naam vrij; SIVI's eigen chunkvoorbeelden droegen Pensioenprojectie_0001c. Elke andere waarde dan de vaste naam is nu een schemafout. | Fout bij afdDefinitionName, met de verwachte waarde en de reden. |
| 2 Cashflow | netAmount en netDate zijn verplicht in elk cashflowblok: direct onder de regeling, per cohort en per beleggingsportefeuille. De cashflow per portefeuille mag nu ook contributionAmount en withdrawalAmount met hun datum dragen (twee decimalen). Een portefeuille naast de cashflow direct onder de regeling is de FPR-route zelf; alleen een uitsplitsing per cohort én per portefeuille in één regeling is niet geldig. Per regeling minstens één cashflow (handleiding §6.3.1, §3.2.5). | Een cohort zonder netDate wordt afgewezen; SIVI's eigen voorbeeld van de pre-release had dat. Het gepubliceerde schema telt alleen de geldige array-items (#63), dus een generieke validator ziet het niet; een ontvanger die elk item toetst wel. | Fout: verplicht veld netDate ontbreekt, per cohort. Fout bij een regeling zonder enige cashflow. |
| 3 Pensioenprojectie | Nieuw: de FPR-route met per regeling 0 tot 99 beleggingsportefeuilles, elk met 0 tot 9999 geprojecteerde betalingen. Betalingen onder een cohort of portefeuille zijn optioneel. Per regeling wordt precies één uitsplitsing gebruikt: per cohort of per portefeuille (handleiding §6.3.1). | Een regeling met alleen betalingen op regelingniveau, zonder cohorten, is niet meer geldig. SIVI paste daarom zijn eigen voorbeeld aan. | Fout bij een regeling zonder uitsplitsing en bij een regeling met cohorten én portefeuilles. Niet op een chunk. |
| 5 Orderopdracht | De orderregels staan nu in de nieuwe §6.3.2 (de oude §4.4.1 bestaat niet meer). Per order precies één van tradeAmount en tradeQuantity; beide leeg alleen bij de order van een switch die niet stuurt, en dat mag elk van beide orders zijn. Per switchpaar draagt precies één order een bedrag of aantal. switchType kent de codes 1 (volgtijdelijk) en 2 (op één dag), via het codelijstbestand naast het schema; een validator die dat bestand niet vindt, kan het schema niet compileren. | Bedrag en aantal samen was in de pre-release al verboden (§4.4.1), maar SIVI's eigen drie voorbeelden deden het; de definitieve voorbeelden niet meer. Nieuw toegestaan: een lege switchfrom-order als de switchto-order stuurt. | Fout bij bedrag en aantal samen of allebei leeg; fout als geen of beide orders van een switch sturen. |
| 6 Orderconfirmation | Komen tradeQuantity en tradePrice beide voor, dan geldt per trade: aantal × koers = tradeAmount. Bij een switch gaat het bedrag van de switchfrom-order de switchto-order in, behalve tussen producten in verschillende valuta (handleiding §6.3.2). switchType als in bericht 5. | Een bevestiging waarin aantal × koers niet het bedrag is, wordt afgewezen. SIVI's koopvoorbeeld rekent 102 × 98,04 = 10000,08. | Fout als aantal × koers meer dan een halve cent afwijkt (plus de afronding van de koers); waarschuwing als de bedragen van een switch in dezelfde valuta verschillen. |
| 14 Betaalinformatie | Per regeling 1 tot 999 betalingen in één bericht (was precies één, #149). collectionAccountIban maximaal 34 tekens, bij de betaling en bij de begunstigde (was 10, #135). De afzender is de beleggingsadministrateur; de PUO alleen als die die rol zelf vervult (#142). | Een bericht van de pre-release blijft geldig. Andersom niet: met volledige IBAN's of meerdere betalingen is het bericht alleen onder Release 2027 geldig; Release 2026 (001.04, ook v1.3.2) laat 10 tekens en één betaling toe. | Onder Release 2026: fout op de lengte van de IBAN en op het aantal betalingen. |
| 15 Corporate Actions | De lege financialInformation.reportingPeriod is uit het bericht. corporateActionType gebruikt codelijst AFDCOA: 1 cash dividend, 2 stock dividend, 3 productverandering, 99 anders; een rebate valt onder 99. AFDCAE bestaat niet meer. De dividendvelden hebben twee decimalen. | Elk bericht 15 van de pre-release wordt afgewezen: de codes cashDividend, stockDividend, productChange en rebate bestaan niet meer, en financialInformation is een onbekend veld. | Fout: waarde komt niet voor in de codelijst; fout: onbekend veld financialInformation. |
| Feedbackbericht | afdDefinitionName is vast VBPUO_Feedback_Message-001.00-VBPUO_Feedback_Message (de pre-release had …-001.02-…); de versie blijft 001.02. originalMessageType kent de tien actieve berichten, 00557 erbij en de vervallen berichten eruit. | Elk feedbackbericht van de pre-release wordt afgewezen op afdDefinitionName. Feedback op bericht 15 kan nu wel. | Fout bij afdDefinitionName, met de verwachte waarde. |
| 1 tot en met 4: reserves | De handleiding legt een verbandscontrole vast: is reserveIndicator true, dan is reserveType verplicht (§6.3). Het schema laat beide velden optioneel. reserveDescription is gewenst bij code 99. | Het schema laat een reservecohort zonder reserveType door; een ontvanger die de verbandscontroles toepast niet. | Fout onder Release 2027, waarschuwing onder Release 2026. |
Wat er in de handleiding veranderde
- Eén FPR-model: het onderscheid tussen een direct en een gelaagd ordermodel is vervallen, en daarmee de cohortenpool (#124). De procesflow onderscheidt twee administratieve inrichtingen (collectief deel in units of in euro's), geen twee modellen.
- Verbandscontroles: §6.3.1 voor de berichten 2 en 3 en de nieuwe §6.3.2 voor de berichten 5 en 6; de SPR- en FPR-route in de nieuwe §3.2.5. De validationRules-bestanden zijn nog leeg ("nog niet gemodelleerd").
- Zenders: bericht 5 gaat van de PUO naar de beleggingsadministrateur (BA), bericht 6 van de BA naar de PUO; de berichten 10 en 14 verstuurt de BA, de PUO alleen als die die rol zelf vervult (#142).
- Beveiliging: OAuth 2.0 is het vaste mechanisme; x-api-key en x-jws-signature zijn opties (§2.7, §7.4).
- Cohorten met waarde 0: meesturen met 0 of weglaten, ook bij reserves; een veld zonder waarde (null) kent de standaard niet (#100).
- De voorbeeldberichten staan in een eigen map per release op main, waar main leidend is: ze kunnen tussen releases veranderen.
Gebouwd op de pre-release? Dit past u aan
- Zet afdDefinitionName op de vaste naam van het bericht (de lijst staat bij de codelijst afdDefinitionName).
- Bericht 2: geef netAmount en netDate in elk cashflowblok, ook per cohort; gebruik per regeling óf cohorten óf portefeuilles.
- Bericht 3: geef elke regeling precies één uitsplitsing.
- Bericht 5: per order een bedrag óf een aantal; per switch stuurt één order.
- Bericht 6: laat aantal × koers uitkomen op het bedrag.
- Bericht 15: gebruik de AFDCOA-codes 1, 2, 3 en 99 en laat financialInformation weg.
- Feedbackbericht: de nieuwe vaste afdDefinitionName.
- Validator: los de verwijzing naar het codelijstbestand naast het schema op (berichten 5, 6 en 15), naast de codelijsten op sivi.org.
- Controleer uw berichten opnieuw in de validator, met Release 2027 (of automatisch) gekozen.
Gemeten
- De definitieve schema's wijzen 9 van de 17 voorbeeldberichten van de pre-release af: vier chunkvoorbeelden en het feedbackvoorbeeld op afdDefinitionName, het voorbeeld van bericht 2 op netDate per cohort (alleen zichtbaar bij controle van elk array-item, #63) en de drie voorbeelden van bericht 5 op bedrag en aantal samen.
- Onze validator op de pre-release (de versie van 2 oktober 2026) keurde 6 van SIVI's 24 definitieve voorbeeldberichten af: bericht 14, bericht 15, de FPR-voorbeelden van de berichten 2 en 3 en beide feedbackvoorbeelden. Sinds de update van 14 oktober keurt hij alle 24 goed.
- Gemeten op 14 oktober 2026 met de schema's van de tags v1.4.0-prerelease en v1.4.0.
Bron: Releasenotes v1.4.0 (SIVI, GitHub) · Handleiding Release 2027 (definitief) · Handleiding van de pre-release (online tot april 2027)