Uitbreiding NVGA portefeuille-rapportage (4.1.3.4)

Achtergrond
De NVGA portefeuille-rapportage is aangepast en uitgebreid. Je kunt nu zowel algemene rapportgegevens als rapportdelen per verzekering opvragen en deze combineren tot één volledig rapport. Er is daarnaast een ingang beschikbaar die dit combineren automatisch uitvoert. 

Functionaliteit

• Opvragen van de algemene rapportgegevens, plus de identifiers van alle verzekeringen die mogelijk in het totaalrapport moeten worden opgenomen.
• Opvragen van de rapportgegevens van een enkele verzekering.
• Genereren van een volledig rapport, op basis van de andere twee ingangen of via een aparte ingang die dit combineren zelf uitvoert. 

WebApi-ingangen 

Algemene rapportgegevens

GET/api/v1/contracten/verzekeringen/rapporten/nvga/v2.0/portefeuille?volmachtgeverid={volmachtgeverid}&datumvanaf={datumvanaf}&datumtotenmet={datumtotenmet}

Resultaat:

{

"Rapport": "string",

"Verzekeringen": [

{

"VerzekeringId": 0

}

]

}

• Rapport: het NVGA-rapport voor de opgegeven volmachtgever en periode. Het rapport is in XML-formaat. Alle verzekering-gegevens ontbreken nog en moeten zelf worden toegevoegd.
• Verzekeringen: de identifiers van iedere verzekering die mogelijk aan het rapport toegevoegd moet worden. 

Rapportgegevens per verzekering

GET/api/v1/contracten/verzekeringen/{id}/rapporten/nvga/v2.0/portefeuille?volmachtgeverid={volmachtgeverid}&datumvanaf={datumvanaf}&datumtotenmet={datumtotenmet}

Resultaat:

{

"Rapport": "string"

}

Rapport: het rapportdeel van de verzekering voor het NVGA portefeuille-rapport. Komt in de vorm van een enkele XML-node. Als de verzekering niet thuishoort in het rapport, wordt een lege string geleverd.

Volledig rapport genereren

POST eps/document/api/rapporten/nvga/v2.0/portefeuille

Body:

{

"volmachtgeverId": 0,

"datumVanaf": "",

"datumTotEnMet": ""

}

Resultaat:

• Bij een succesvolle aanroep levert deze WebApi-ingang een Http-code 202 (Accepted). Het rapport wordt opgemaakt en geplaatst in het standaarddossier van de volmachtgever.
• Beperkingen: geen voortgangsinformatie, niet af te breken, fouten alleen zichtbaar in DIAS Systeemmeldingen of server event viewers. Rapportdelen van verzekeringen met fouten worden niet opgenomen, zonder directe waarschuwing.
• Techniek: parallellisatie met 10 processen, niet instelbaar. 

Impact 

• Je kunt nu gestructureerd NVGA portefeuille-rapportages opvragen en samenstellen.
• Het combineren van algemene gegevens en rapportdelen per verzekering levert een volledig rapport op.
• Voor gemak is er een ingang beschikbaar die dit combineren automatisch uitvoert.
• Houd rekening met de huidige beperkingen: geen voortgangsinformatie, geen foutmeldingen in de rapportage zelf, en een vaste mate van parallellisatie.