Skip to content

2024_november

Choose a tag to compare

View all tags
@dma61 dma61 released this 27 Nov 11:37
· 46 commits to main since this release
v1.2.0
c726986

Full Changelog: v1.1.0...v1.2.0

Release notes November 2024

Inleiding

De JSON-schema’s die horen bij de November release van de VBPUO-standaard zijn inmiddels gepubliceerd op de GitHub-omgeving. De bijbehorende nieuwe versie van de handleiding "20241127 Handleiding Standaard datauitwisseling VB-PUO November release" is gemaild en wordt binnenkort op de betreffende SIVI-webpagina gepubliceerd.

Wijzigingen

In deze release zijn de onderstaande wijzigingen doorgevoerd. Voor gedetailleerde informatie verwijzen we naar de bijbehorende issues op de GitHub-pagina (het overzicht is te vinden op: "mijlpaal" / "milestone" 202411).

  • Issue #41: Wijzigigingsverzoek toevoegen numberOfUnits aan FPR bericht 00542 order settlement
    Toelichting: Bericht 6 ordersettlement is hernoemd naar Orderconfirmation. Tevens is numberOfUnits toegevoegd onder investment.investmentDetails zodat de aankoop (in aantallen "stukken" (units)) kan worden vermeld. De OAS is hierop aangepast (versie 1.09). In samenhang hiermee is "6 ordersettlement" verwijderd van de GitHub code page.

  • Issue #65: Bericht 3 (1c) maxContains van financialTransactionPayment niet gelijk
    Toelichting: De wijziging heeft betrekking op bericht 3 (1c): Het maximum aantal financialTransaction.payment onder pension.cohort is gewijzigd naar 9999.
    financialTransaction.payment onder pension.scheme blijft 1..99999.

  • Issue #61: Bericht 4 - Beperking 2 decimalen bij percentages
    Toelichting: Het aantal decimalen is voor percentagevelden: protectionReturnPercentage, excessReturnPercentage, returnPercentage verhoogd van 2 naar 12 ter voorkoming van substantiële afrondingsverschillen.

  • Issue #68: De lengte van originalMessageId is gelijkgesteld aan die van messageId
    Toelichting: De lengte van originalMessageId is gelijkgesteld aan die van messageId (70 pos.).

  • Issue #60: May Schema puvCode references
    Toelichting: Referentie naar de puvcode-tabel (AFDIDP) is verbeterd.

  • Issue #71: Het aantal participatiestatussen is beperkt
    Toelichting: Het aantal participatiestatussen is beperkt tot: Actief (16), AO-actief (20), AO-niet actief (35), Slapend (40), Uitkerend (80). In deze release voor 2025 is ook Pensioentrekkende (60) opgenomen.

  • Issue #57: Verwijzingen naar AFDIDP-tabellen toegevoegd
    Toelichting: Verwijzingen naar AFD-online-tabellen zoals AFDIDP toegevoegd/aangepast.

  • Issue #59: afdDefinitionName and afdDefinitionVersion in the samples differs from constants specified in May schema release
    Toelichting: Nog niet opgenomen in de releasenotes. Toevoeging nodig.

  • Issue #67: Versiebeheer na in implementatie Pensioenakkoord & SIVI | Vraag aan Community
    Toelichting: In de handleiding opgenomen hoe we werken met versies. Vaststellen in KBG.

  • Issue #48: OAS - opnemen in documentatie
    Toelichting: Documentatie OAS toegevoegd.

  • Issue #47: Verduidelijk de documentatie rond transport van de berichten <= ondersteuning uitsluitend voor berichten via API
    Toelichting: Zie: "Transport van gegevens" in de handleiding.

  • Issue #43: Algemene vraag t.a.v. toevoegen hashes
    Toelichting: In de handleiding, bij transport / OpenAPI, is een beschrijving opgenomen over het testen op volledigheid.

  • Issue #35: Technical validations - expectation for error messages
    Toelichting: De handleiding is voor het feedbackbericht uitgebreid. O.a. is opgenomen dat in een foutresponse de informatie over de fout in de error-entiteit staat en dat het oorspronkelijke onjuiste bericht niet wordt meegestuurd.

Daarnaast zijn de voorbeeldberichten bijgewerkt.

Documentatie wijzigingen / handleiding

In de handleiding zijn diverse aanpassingen doorgevoerd, o.a. het processchema bij SPR en de inleidende tekst bij "Attributen in entiteiten.entiteitstypen".

  • 4.5.7 Feedback berichten: De paragraaf over feedbackbericht en het gebruik daarvan is herzien.
  • 7.4 Transport / OpenAPI: De paragraaf over dit onderwerp is herzien.
  • 7.5 Samenstellen berichten, versionering en publicatie: is ingevoegd.

Vervolg

Komende tijd worden nog de voorbeeldberichten toegevoegd en overzicht schema’s toegevoegd.

Versies OAS en JSON schemas in GitHub release 2024_11 | Tag v1.2.0

Open API specificatie 1.09 maakt deel uit van deze versie
JSON-schemas berichten 1 t/m 14 (AOS) 001.03 (afdDefinitionVersion)
JSON-schema VBPUO_Feedback_Message (AOS) 001.00 (afdDefinitionVersion)

Referentie gegevens: 20241127 JSON schema commit (Release commit 202411) / AOS 001.03 - Model base 20241127 0049 / OAS 1.09 / "20241127 Handleiding Standaard datauitwisseling VB-PUO November release"
GitHub releases en releasenotes: GitHub Releases / Release Tag v1.2.0Hier is de Engelse versie van de

--- English version ----------------------

Release Notes November 2024

Introduction

The JSON schemas associated with the November release of the VBPUO standard have been published on the GitHub environment. The accompanying new version of the manual, "20241127 Manual Standard Data Exchange VB-PUO November Release," has been emailed and will soon be published on the relevant SIVI web page.

Changes

The following changes have been implemented in this release. For detailed information, please refer to the corresponding issues on the GitHub page (an overview can be found at: "milestone" 202411).

  • Issue #41: Change request to add numberOfUnits to FPR message 00542 order settlement
    Details: Message 6 ordersettlement has been renamed to Orderconfirmation. Additionally, numberOfUnits has been added under investment.investmentDetails to allow purchases (in "units") to be specified. The OAS has been updated accordingly (version 1.09). In conjunction with this, "6 ordersettlement" has been removed from the GitHub code page.

  • Issue #65: Message 3 (1c) maxContains for financialTransactionPayment not matching
    Details: The change concerns Message 3 (1c): The maximum number of financialTransaction.payment under pension.cohort has been changed to 9999.
    financialTransaction.payment under pension.scheme remains 1..99999.

  • Issue #61: Message 4 - Limitation of 2 decimals for percentages
    Details: The number of decimals for percentage fields (protectionReturnPercentage, excessReturnPercentage, returnPercentage) has been increased from 2 to 12 to prevent substantial rounding differences.

  • Issue #68: Length of originalMessageId equalized with messageId
    Details: The length of originalMessageId has been equalized with messageId (70 positions).

  • Issue #60: May Schema puvCode references
    Details: Reference to the puvcode table (AFDIDP) has been improved.

  • Issue #71: Number of participation statuses limited
    Details: The number of participation statuses has been limited to: Active (16), AO-active (20), AO-not active (35), Dormant (40), Receiving benefits (80). In this release for 2025, "Receiving Pension" (60) has also been included.

  • Issue #57: References to AFDIDP tables added
    Details: References to AFD-online tables such as AFDIDP have been added/adjusted.

  • Issue #59: afdDefinitionName and afdDefinitionVersion in the samples differ from constants specified in May schema release
    Details: Not yet included in the release notes. Addition needed.

  • Issue #67: Version management in the implementation of the Pension Agreement & SIVI | Community Question
    Details: Instructions on how we work with versions have been included in the manual. To be determined in KBG.

  • Issue #48: OAS - include in documentation
    Details: OAS documentation has been added.

  • Issue #47: Clarify the documentation on message transport <= support exclusively for messages via API
    Details: See: "Transport of data" in the manual.

  • Issue #43: General question about adding hashes
    Details: A description of completeness testing has been added to the manual, under transport/OpenAPI.

  • Issue #35: Technical validations - expectation for error messages
    Details: The manual has been expanded for the feedback message. It now includes information that error details are contained in the error entity in a fault response and that the original incorrect message is not included.

Additionally, the example messages have been updated.

Documentation changes/manual

Several updates have been made to the manual, including the process diagram for SPR and the introductory text for "Attributes in entities.entity types."

  • 4.5.7 Feedback messages: The section on feedback messages and their usage has been revised.
  • 7.4 Transport/OpenAPI: The section on this topic has been updated.
  • 7.5 Assembling messages, versioning, and publication: This section has been added.

Next Steps

In the coming period, additional example messages and a schema overview will be added.

Versions of OAS and JSON schemas in GitHub release 2024_11 | Tag v1.2.0

Open API specification 1.09 is part of this version
JSON schemas messages 1 through 14 (AOS) 001.03 (afdDefinitionVersion)
JSON schema VBPUO_Feedback_Message (AOS) 001.00 (afdDefinitionVersion)

Reference data: 20241127 JSON schema commit (Release commit 202411) / AOS 001.03 - Model base 20241127 0049 / OAS 1.09 / "20241127 Manual Standard Data Exchange VB-PUO November Release"
GitHub releases and release notes: GitHub Releases / Release Tag v1.2.0

Assets 2
Loading