Deploy preview for PR 1 🛫

Author: Govert-Claus

pr-preview/pr-1/vroegsignalering/VraagEnAntwoord/index.html

@@ -788,6 +788,22 @@ <h1 id="vraag-en-antwoord">Vraag en Antwoord</h1>
 <p>In uitzonderlijke gevallen is het mogelijk dat de gemeentecode onbekend is van de gemeente onder wiens verantwoordelijkheid schuldhulp wordt uitgevoerd. Bijvoorbeeld bij samenwerkingsorganisaties die deze gemeente niet administreren. </p>
 <p>De verantwoordelijke gemeente is één van de belangrijke startpunten voor de statistiek die door CBS wordt opgesteld. Dus sporen aan dit wel in de systemen op te nemen. Wel zijn we erg blij met aan te leveren gegevens, en kunnen we die gebruiken voor diverse andere statistieken. In dergelijke gevallen kan bij de trajecten in het veld gemeentecode de waarde “Onbekend” worden opgenomen.</p>
 </details>
+<details class="question">
+<summary>Waarom is het belangrijk dat contactpersonen bij aanleverende_organisatie contactpersonen goed wordt ingevuld?</summary>
+<p>Bij aanlevering van gegevens via API's worden de gegevens van contactpersonen gebruikt om het 'op-orde-rapport' naartoe te sturen. Hiermee kunnen organisaties controleren of er correcte gegevens aan CBS zijn aangeboden. Hiervoor gebruikt het CBS het emailadres.</p>
+</details>
+<details class="question">
+<summary>Telefoonnummer hebben wij soms 2 telefoonnummers voor, hoe vul ik dit veld in?</summary>
+<p>Je kunt in het veld meerdere telefoonnummers kwijt. Graag gesplitst met een '/'</p>
+</details>
+<details class="question">
+<summary>EnumSignaalstatus status "opgepakt" mist. Moeten wij deze invullen? Of gaan jullie ervan uit dat wanneer dit veld leeg is het signaal is opgepakt?</summary>
+<p>Als een signaal onderdeel is van een zaak, dan zien we het als opgepakt </p>
+</details>
+<details class="question">
+<summary>Wanneer geldt een dossier als 'opgepakt'? We hebben een aantal verschillende datums die we hiervoor kunnen hanteren, maar weten niet goed welke we hiervoor moeten gebruiken.</summary>
+<p>Gebruik hiervoor het moment van aanmaken van het dossier.</p>
+</details>
 
 
 

pr-preview/pr-1/vroegsignalering/api/berichten/index.html

@@ -1409,11 +1409,18 @@ <h2 id="vraagbericht-request">Vraagbericht (request)</h2>
 <li>
 <p>Aanleverende_organisatie (string, default alle – alleen relevant als over meer dan 1 organisatie (gemeente/ schuldhulpverlener) gegevens aangeleverd worden)</p>
 </li>
+<li>
+<p>page (welke pagina gegevens opgevraagd wordt, als er meerdere pagina's aan gegevens zijn - zie ook <a href="../non-functionals/">niet-functionele eisen</a>, default de eerste pagina)</p>
+</li>
+<li>
+<p>pageSize (aantal records/ signalen dat in één responsebericht meegestuurd wordt, default leeg - schuldhulpverlener bepaalt dan het aantal)</p>
+</li>
 </ul>
 <p>Het bericht wordt met <a href="https://geonovum.github.io/KP-APIs/API-strategie-modules/signing-jades/">JAdES</a> ondertekend met de private sleutel van de verzender van het vraagbericht - in dit geval CBS. Zie het hoofdstuk <a href="../signing-encryptie/">Signing en Versleuteling</a> voor de specificaties van de ondertekening.</p>
 <h2 id="antwoordbericht-response">Antwoordbericht (response)</h2>
 <p>Dit is het antwoordbericht van de gegevensbeheerder (systeem dat de bron beheert) met de gewenste gegevens in JSON formaat.
 De payload is gebaseerd op het uitwisselformaat zoals dat is beschreven voor <a href="https://vng-realisatie.github.io/ddas/v1.0/uitwisselspecificatie/">schuldhulpgegevens</a> en <a href="https://vng-realisatie.github.io/ddas-vroegsignalering/v1.0/uitwisselspecificatie/">vroegsignaleringsgegevens</a>.</p>
+<p>Naast de vroegsignalen worden gegevens voor de paginering meegegeven. Deze zijn nodig als niet alle vroegsignalen in één responsebericht passen - zie de <a href="../non-functionals/">niet-functionele eisen</a> voor meer uitleg.</p>
 <p>Ook dit bericht wordt ondertekend met <a href="https://geonovum.github.io/KP-APIs/API-strategie-modules/signing-jades/">JAdES</a> met gebruik van de eigen private sleutel. Zie het hoofdstuk <a href="../signing-encryptie/">Signing en Versleuteling</a> voor de specificaties van de ondertekening.
 Versleutelen van de payload is niet nodig.</p>
 <p>Mogelijke responses:</p>

pr-preview/pr-1/vroegsignalering/api/non-functionals/index.html

@@ -911,7 +911,74 @@ <h2 id="beschikbaarheid">Beschikbaarheid</h2>
 <p>De toepassing is niet kritisch: er is geen hoge beschikbaarheid vereist.<br />
 De services moeten beschikbaar zijn op de momenten dat CBS de gegevens verzameld. Hierover moeten nog afspraken gemaakt worden.</p>
 <h2 id="performance">Performance</h2>
-<p>De berichtenuitwisseling is synchroon. De API moet daarom binnen de "time-out" tijd reageren op een request. Er is nog geen afspraak over de maximale response tijd die geaccepteerd wordt.</p>
+<p>De berichtenuitwisseling is synchroon. De API moet daarom binnen de "time-out" tijd reageren op een request. Er is nog te weinig ervaring met het koppelvlak om een goed onderbouwde maximale response-tijd en daaraan gekoppeld een maximaal aantal records.
+Vooralsnog wordt uitgegaan van de volgende maximale aantallen records:<br />
+- Schuldhulptrajecten:  <strong>25.000</strong>
+- Vroegsignalen:  <strong>50.000</strong></p>
+<p>Als het maximaal aantal records overschreven dreigt te worden, moeten de gegevens over verschillende berichten verdeeld worden. In het response-bericht worden dan de velden in het object <strong>paginering</strong> gevuld worden.<br />
+Dit gebeurt volgens de volgende definities:</p>
+<table>
+<thead>
+<tr>
+<th>Veld</th>
+<th>Betekenis</th>
+<th>Waarde</th>
+<th>Default</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>pageSize</strong></td>
+<td>Het aantal trajecten/vroegsignalen per pagina</td>
+<td>integer (min: 1, max: 25.000 of 50.000)</td>
+<td>totaal aantal trajecten/vroegsignalen</td>
+</tr>
+<tr>
+<td><strong>currentPage</strong></td>
+<td>De huidige pagina</td>
+<td>integer (min: 1)</td>
+<td>1</td>
+</tr>
+<tr>
+<td><strong>totalPages</strong></td>
+<td>Het totaal aantal beschikbare pagina's</td>
+<td>integer (min: 1)</td>
+<td>1</td>
+</tr>
+<tr>
+<td><strong>totalRecords</strong></td>
+<td>Het totaal aantal te versturen trajecten/vroegsignalen</td>
+<td>integer (min: 0)</td>
+<td>totaal aantal trajecten/vroegsignalen</td>
+</tr>
+</tbody>
+</table>
+<p>Alle velden zijn technisch optioneel in verband met terugwaartse compabiliteit, maar als er gebruik gemaakt wordt van paginering, <strong>moeten</strong> alle paginering-velden gevuld zijn.<br />
+In het request-bericht van CBS worden dan ook de volgende paginering velden meegestuurd:</p>
+<table>
+<thead>
+<tr>
+<th>Veld</th>
+<th>Betekenis</th>
+<th>Waarde</th>
+<th>Opmerking</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>page</strong></td>
+<td>De opgevraagde pagina</td>
+<td>integer (min: 1)</td>
+<td>Als een niet bestaande pagina opgevraagd wordt, wordt een response-bericht teruggestuurd zonder gegevens, maar wel met paginering-gegevens. Als er geen page in het request-bericht zit, maar er wel gepagineerd moet worden, wordt de eerste pagina in het response-bericht gestuurd.</td>
+</tr>
+<tr>
+<td><strong>pageSize</strong></td>
+<td>Het aantal trajecten/vroegsignalen dat in het response-bericht opgenomen mag worden</td>
+<td>integer</td>
+<td>Als PageSize in het request-bericht zit en er meer trajecten/vroegsignalen verstuurd moeten worden, <strong>moet</strong> er gebruik gemaakt worden van paginering</td>
+</tr>
+</tbody>
+</table>
 <p>Om belasting van de productiesystemen te beperken mag een cache gebruikt worden, onder de volgende voorwaarden:</p>
 <ul>
 <li>

pr-preview/pr-1/vroegsignalering/definities/Detail_Model Vroegsignalering/index.html

@@ -1373,7 +1373,7 @@ <h3 id="signaalpartner">Signaalpartner</h3>
 <blockquote>
 <p><strong>Definitie Signaalpartner:</strong> </p>
 <p>Een signaalpartner is een organisatie die op grond van artikel 2.2.1 van de Wet gemeentelijke schuldhulpverlening (Wgs) bevoegd is om signalen van betalingsachterstanden door te geven aan de gemeente met het doel vroegtijdige hulpverlening bij schulden mogelijk te maken. Signaalpartners zijn dienstverleners met een maatschappelijk belang, zoals zorgverzekeraars, energieleveranciers, drinkwaterbedrijven en woningverhuurders.
- Een signaalpartner verstrekt een vroegsignaal aan de gemeente wanneer bij een klant of huurder sprake is van een betalingsachterstand die voldoet aan de wettelijke en/of contractuele criteria voor signalering.</p>
+Een signaalpartner verstrekt een vroegsignaal aan de gemeente wanneer bij een klant of huurder sprake is van een betalingsachterstand die voldoet aan de wettelijke en/of contractuele criteria voor signalering.</p>
 </blockquote>
 <details class="info">
 <summary>Kenmerken Model Signaalpartner</summary>
@@ -1437,7 +1437,7 @@ <h3 id="vroegsignaal">Vroegsignaal</h3>
 <blockquote>
 <p><strong>Definitie Vroegsignaal:</strong> </p>
 <p>Een Vroegsignaal is een bericht dat door een signaalpartner (zoals een zorgverzekeraar, energieleverancier of verhuurder) aan de gemeente wordt verstrekt, met als doel de gemeente te informeren over een mogelijk beginnende schuldsituatie van een inwoner. Het vroegsignaal vormt het startpunt van het gemeentelijk proces van vroegsignalering van schulden.
- De juridische grondslag voor het ontvangen en verwerken van vroegsignalen is vastgelegd in artikel 2.2.1 van de Wet gemeentelijke schuldhulpverlening (Wgs). Deze wet verplicht gemeenten om vroegtijdig signalen van betalingsachterstanden te ontvangen en op basis daarvan inwoners passende hulp aan te bieden.</p>
+De juridische grondslag voor het ontvangen en verwerken van vroegsignalen is vastgelegd in artikel 2.2.1 van de Wet gemeentelijke schuldhulpverlening (Wgs). Deze wet verplicht gemeenten om vroegtijdig signalen van betalingsachterstanden te ontvangen en op basis daarvan inwoners passende hulp aan te bieden.</p>
 </blockquote>
 <details class="info">
 <summary>Kenmerken Model Vroegsignaal</summary>

pr-preview/pr-1/vroegsignalering/search/search_index.json

@@ -2,66 +2,66 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
     <url>
          <loc>https://vngrealisatie.github.io/ddas-vroegsignalering/</loc>
-         <lastmod>2026-04-30</lastmod>
+         <lastmod>2026-05-21</lastmod>
     </url>
     <url>
          <loc>https://vngrealisatie.github.io/ddas-vroegsignalering/404/</loc>
-         <lastmod>2026-04-30</lastmod>
+         <lastmod>2026-05-21</lastmod>
     </url>
     <url>
          <loc>https://vngrealisatie.github.io/ddas-vroegsignalering/Achtergrond/</loc>
-         <lastmod>2026-04-30</lastmod>
+         <lastmod>2026-05-21</lastmod>
     </url>
     <url>
          <loc>https://vngrealisatie.github.io/ddas-vroegsignalering/Hoofdlijnen_Model%20Vroegsignalering/</loc>
-         <lastmod>2026-04-30</lastmod>
+         <lastmod>2026-05-21</lastmod>
     </url>
     <url>
          <loc>https://vngrealisatie.github.io/ddas-vroegsignalering/VraagEnAntwoord/</loc>
-         <lastmod>2026-04-30</lastmod>
+         <lastmod>2026-05-21</lastmod>
     </url>
     <url>
          <loc>https://vngrealisatie.github.io/ddas-vroegsignalering/uitleg_Model%20Vroegsignalering/</loc>
-         <lastmod>2026-04-30</lastmod>
+         <lastmod>2026-05-21</lastmod>
     </url>
     <url>
          <loc>https://vngrealisatie.github.io/ddas-vroegsignalering/uitwisselspecificatie/</loc>
-         <lastmod>2026-04-30</lastmod>
+         <lastmod>2026-05-21</lastmod>
     </url>
     <url>
          <loc>https://vngrealisatie.github.io/ddas-vroegsignalering/api/</loc>
-         <lastmod>2026-04-30</lastmod>
+         <lastmod>2026-05-21</lastmod>
     </url>
     <url>
          <loc>https://vngrealisatie.github.io/ddas-vroegsignalering/api/berichten/</loc>
-         <lastmod>2026-04-30</lastmod>
+         <lastmod>2026-05-21</lastmod>
     </url>
     <url>
          <loc>https://vngrealisatie.github.io/ddas-vroegsignalering/api/iam/</loc>
-         <lastmod>2026-04-30</lastmod>
+         <lastmod>2026-05-21</lastmod>
     </url>
     <url>
          <loc>https://vngrealisatie.github.io/ddas-vroegsignalering/api/non-functionals/</loc>
-         <lastmod>2026-04-30</lastmod>
+         <lastmod>2026-05-21</lastmod>
     </url>
     <url>
          <loc>https://vngrealisatie.github.io/ddas-vroegsignalering/api/overzicht/</loc>
-         <lastmod>2026-04-30</lastmod>
+         <lastmod>2026-05-21</lastmod>
     </url>
     <url>
          <loc>https://vngrealisatie.github.io/ddas-vroegsignalering/api/signing-encryptie/</loc>
-         <lastmod>2026-04-30</lastmod>
+         <lastmod>2026-05-21</lastmod>
     </url>
     <url>
          <loc>https://vngrealisatie.github.io/ddas-vroegsignalering/api/transport/</loc>
-         <lastmod>2026-04-30</lastmod>
+         <lastmod>2026-05-21</lastmod>
     </url>
     <url>
          <loc>https://vngrealisatie.github.io/ddas-vroegsignalering/api/uitgangspunten/</loc>
-         <lastmod>2026-04-30</lastmod>
+         <lastmod>2026-05-21</lastmod>
     </url>
     <url>
          <loc>https://vngrealisatie.github.io/ddas-vroegsignalering/definities/Detail_Model%20Vroegsignalering/</loc>
-         <lastmod>2026-04-30</lastmod>
+         <lastmod>2026-05-21</lastmod>
     </url>
 </urlset>