Vroegsignalering via SKP (tbv Experiment BD & DT)
Inleiding
Het Schuldenknooppunt faciliteert de uitwisseling van Vroegsignalen tussen Signaalpartners ('schuldeisers' die achterstandssignalen doorgeven) en Vroegsignaalverwerkende partijen (BKR met VPS en Xxllnc met RIS) die door gemeenten zijn gecontracteerd om de achterstandssignalen om te zetten in Vroegsignalen waar actieve inzet voor kan worden geïnitieerd.
Het Schuldenknooppunt stelt Signaalpartners in staat om één bestand met achterstandssignalen aan te leveren aan het Schuldenknooppunt, waarna vanuit het Schuldenknooppunt wordt zorg gedragen voor de distributie van de signalen naar de door gemeenten gecontracteerde organisaties; Signaalpartners hoeven dus geen afzonderlijke koppelingen meer te maken/onderhouden naar én RIS én VPS.
Deze toepassing van het Schuldenknooppunt is opgezet voor Belastingdienst en Dienst Toeslagen, maar wordt generiek doorontwikkeld voor andere signaalpartners. Onderstaande uitwerking is vooral opgesteld vanuit de kaders voor het experiment met Belastingdienst en Dienst Toeslagen.
Inhoudsopgave
Beschrijving
In het userportaal wordt functionaliteit toegevoegd om een CSV bestand te uploaden. Dit bestand wordt ingelezen en verwerkt naar losse conversaties. De ontvanger kan bepaald worden obv de kolom gemeentenaam/code . In het SKP wordt bijgehouden welke gemeente bij welke Vroegsignaalverwerkende partij hoort. De Vroegsignaalverwerkende partij is een organisatie in het SKP. Er zijn nu twee Vroegsignaalverwerkende partijen. Dit zijn RIS (https://xxllnc.nl/applicaties/vroegsignalering) en VPS (www.bkr.nl)
De vroegsignaalService haalt dit bericht op (en slaat deze tijdelijk op in een beveiligde omgeving) en stuurt deze melding door naar de Vroegsignaalverwerkende partij**. Deze geeft per melding direct het resultaat van de verzending terug (synchroon). De service stuurt dit resultaat van de verzending terug naar het Schuldenknoooppunt met als ontvanger de afzender van de conversatie. De afzender ontvangt alle verzendresultaten van de en kan deze downloaden als CSV.
Als de afzender het bericht heeft gedownload en bevestigd worden alle inhoudelijke gegevens gewist door de vroegsignaalService.
** RIS heeft een rate limit van 100 meldingen per minuut
Flow tbv SKP
Berichten
Vroegsignaal Publiek
VPS heeft validatieregels mbt de lengte van de velden. Deze zijn overgenomen in onderstaand schema. RIS heeft deze validatie niet volgens de API documentatie
Element | Waarden | Type | Omschrijving | Verplicht |
|---|---|---|---|---|
GemeenteCode |
| String (4) | Gemeentecode | ☒ |
GemeenteNaam |
| String (100) | Naam van de gemeente | ☒ |
Batchnr |
| String (50) | Unieke identificatie van de melding. Voorbeeld: 0086-wk43-00005 (combinatie van gemeentecode en weeknummer met regelnummer uit CSV) | ☒ |
Label |
| String (100) |
| ☐ |
Soort |
| String (50) | Zie * voor mogelijke waardes per organisatie | ☐ |
Datum |
| Datum | dd-mm-yyyy | ☒ |
BSN |
| Numeriek | BSN van de klant. Minimaal 8 max 9 karakters | ☒ |
Voorletters |
| String (16) |
| ☒ |
Tussenvoegsels |
| String (50) |
| ☐ |
Achternaam |
| String (250) |
| ☒ |
Geboortedatum |
| Datum | dd-mm-yyyy | ☒ |
Straatnaam |
| String (250) |
| ☒ |
Huisnummer |
| Numeriek |
| ☒ |
Huisnummer toevoeging |
| String (100) |
| ☐ |
Postcode |
| String (7) |
| ☒ |
Plaatsnaam |
| String (250) |
| ☒ |
Telefoonnummer |
| String (14) |
| ☒ |
Telefoonnummer 2 |
| String (14) |
| ☐ |
Telefoonnummer 3 |
| String (14) |
| ☐ |
Bedrag achterstand |
| Bedrag | example: 10.78 | ☒ |
Aantal maanden achterstand |
| Numeriek | 0-99 | ☒ |
Soort kan per organisatie afwijkende waardes bevatten: Op dit moment zijn de volgende waardes vastgelegd:
De Belastingdienst
inkomstenbelasting
omzetbelasting
loonbelasting
Dienst Toeslagen
huurtoeslag
zorgtoeslag
kinderopvangtoeslag
kindgebonden_budget
Voorbeeld CSV:
Resultaat Succesvol
Element | Waarden | Type | Omschrijving | Verplicht |
|---|---|---|---|---|
GemeenteCode |
| String (4) | Gemeentecode | ☒ |
Gemeentenaam |
| String (100) | naam van de gemeente | ☒ |
BatchNr |
| String (50) |
|
|
Referentie |
| String | Referentie welke de vroegsignaal partner terug geeft bij een succesvolle melding | ☒ |
Voorbeeld CSV
Resultaat niet succesvol
Groep | Element | Waarden | Type | Omschrijving | Verplicht |
|---|---|---|---|---|---|
| GemeenteCode |
| String (4) | Gemeentecode | ☒ |
| Gemeentenaam |
| String (100) | naam van de gemeente | ☒ |
| BatchNr |
| String (50) |
|
|
Foutcodes [lijst] | Foutcode | Lijst | String (100) | Foutcode welke terug wordt gegeven door de Vroegsignaalverwerkende partij | ☒ |
Voorbeeld CSV
Gemeentecodes
Voor het experiment worden de volgende gemeentecodes gebruikt:
GEMEENTECODE | GEMEENTENAAM | API |
|---|---|---|
0086 | OPSTERLAND | VPS |
0106 | ASSEN | RIS |
0200 | APELDOORN | RIS |
0202 | ARNHEM | RIS |
0268 | NIJMEGEN | VPS |
0363 | AMSTERDAM | RIS |
0546 | LEIDEN | RIS |
0855 | TILBURG | RIS |
0 | DEN HAAG | RIS |
1911 | HOLLANDS KROON | RIS |
Welke data worden opgeslagen?
Voor het correct verwerken van de resultaten worden de volgende gegevens opgeslagen:
ConversatieReferentie
Berichtreferentie
Gemeentecode
Gemeentenaam
BatchNo
Documentatie
https://app.swaggerhub.com/apis-docs/Inforing/MatchingAPI/1.2.0
Vertaling signaal
VPS | Verplicht | RIS | Verplicht | SKP | Typeveld | Verplicht | Opmerking |
|---|---|---|---|---|---|---|---|
|
|
|
| Gemeente |
| J |
|
Label | N | MeldingLabel | N | Label | String | N |
|
Signal Reference | N |
|
|
|
|
|
|
Signal Date | N | MeldingDatum | J | Datum | Datum | J | “yyyy-mm-dd“ |
Signal Type | N | MeldingType | J | Type | String | J | VPS: “Early“ RIS: “Vroeg“ |
Debtor Relation Number | N |
|
|
|
|
|
|
Citizen Service Number | N | Relatienummer | N | BSN | Numeriek (9) | J | minimaal 8 maximaal 9 |
First Name | N | Voornaam | N |
|
|
|
|
Initials | N | Voorletters | N | Voorletters | String (6) | J |
|
Prefix | N | Tussenvoegsels | N | Tussenvoegsels | String (50) | N |
|
Last Name | J | Achternaam | J | Achternaam | String (250) | J |
|
Date of Birth | N | Geboortedatum | N | Geboortedatum | Datum | N | “yyyy-mm-dd“ |
Gender | N | Geslacht | N |
|
|
|
|
Street Name | N | Straatnaam | N | Straatnaam | String | N |
|
House Number | J | Huisnummer | J | Huisnummer | Numeriek | J |
|
House Number Letter | N |
|
|
|
|
|
|
House Number Addition | N | Huisnummer toevoeging | N | Huisnummer toevoeging | String (100) | N |
|
Postal Code | J | Postcode | J | Postcode | String ( 6 of7) | J |
|
City | N | Woonplaats | N | Plaatsnaam | String (250) | N |
|
Amount Debt Overdue | J | Bedrag achterstand | N | Bedrag achterstand | Bedrag | J |
|
Date Debt Overdue | N | Datum achterstand | N |
|
|
|
|
Number Of Months Debt Overdue | N | Aantal maanden achterstand | J | Aantal maanden achterstand | Numeriek | J |
|
Period Amount | N | Periodebedrag | N |
|
|
|
|
Phone Numbers (3x) | N | Telefoonnummer 1,2,3 | J (1x) | Telefoonnummer | String(14) | J |
|
Email Address | N | Emailadres | N |
|
|
|
|
Comments | N |
|
|
|
|
|
|
|
| Aanmaningsbrief 1 | N |
|
|
|
|
|