Technische regels

Op deze pagina wordt een overzicht getoond van alle technische regels die onderdeel zijn van iPgb 2.4.

CodeTitelDocumentatieRetourcodeControleniveau
TR016TR016: De geldigheidsduur van een FunctieBudget moet vallen binnen de geldigheidsduur van het Budget.0001bericht inhoud (xslt)
TR056TR056: Identificatie moet per berichtsoort uniek zijn voor de verzendende partij.9056berichtoverstijgend
TR101TR101: Binnen een bestand zijn dubbele regels niet toegestaan.Dat betekent dat voor iedere berichtklasse de logische sleutel in combinatie met de logische sleutels van de bovenliggende berichtklassen uniek moet zijn.0001bericht inhoud (xslt)
TR134TR134: Afgiftedatum vullen met een bestaande datum die niet groter is dan de Dagtekening van het bestand.0001bericht inhoud (xslt)
TR135TR135: Dagtekening moet gevuld worden met een bestaande datum die niet in de toekomst ligt.0001bericht inhoud (xslt)
TR502TR502: Wanneer binnen dit toekenningsbericht dezelfde Zorgfunctie meer dan één keer aan dezelfde Budgethouder is toegekend, mogen de geldigheidsduren van deze toekenningen niet overlappen, tenzij er sprake is van een intrekking.

Scenario: Overlap is alleen toegestaan als het een ingetrokken functiebudget betreft

Een ingetrokken functiebudget heeft ingangsdatum gelijk aan einddatum, en FunctieBudgetBedrag 0

Gegeven gemeente “A” kent “Persoonlijke verzorging” toe aan budgethouder “123456789” voor heel het jaar 2027

Stel gemeente “A” heeft voor budgethouder “123456789”, zorgfunctie “Persoonlijke verzorging” ingetrokken in toekenningsbericht met budgetidentificatie “TR502-001”
Als gemeente “A” het opnieuw toegekende budget in onderstaand toekenningsbericht aan het PGB-Portaal stuurt

BudgethouderBudget identificatieBudgetidentificatie oudZorgfunctieIngangsdatum zorgfunctieEinddatum zorgfunctieBedrag zorgfunctie
123456789TR502-002TR502-001Persoonlijke verzorging1-3-20271-3-2027€ 0
123456789TR502-002TR502-001Persoonlijke verzorging1-1-202731-12-2027€ 24.000

Dan wordt dit toekenningsbericht niet afgekeurd op basis van TR502

Stel gemeente “A” heeft voor budgethouder “123456789”, zorgfunctie “Persoonlijke verzorging” eerder toegekend voor de maand mei van 2027 in toekenningsbericht met budgetidentificatie “TR502-001”
Als gemeente “A” het opnieuw toegekende budget in onderstaand toekenningsbericht aan het PGB-Portaal stuurt

BudgethouderBudget identificatieBudgetidentificatie oudZorgfunctieIngangsdatum zorgfunctieEinddatum zorgfunctieBedrag zorgfunctie
123456789TR502-002TR502-001Persoonlijke verzorging1-5-202731-5-2027€ 2.000
123456789TR502-002TR502-001Persoonlijke verzorging1-1-202731-12-2027€ 24.000

Dan wordt dit toekenningsbericht wel afgekeurd op basis van TR502

9502bericht inhoud (xslt)
TR503TR503: Het VerantwoordingsvrijBedrag moet kleiner zijn dan of gelijk zijn aan de som van de FunctieBudgetBedragen van alle aan het Budget gekoppelde FunctieBudgetten.

Het verantwoordingsvrij bedrag is onderdeel van het budget bedrag. Om die reden kan het verantwoordingsvrij bedrag nooit groter zijn dan de som van de functiebudget bedragen.

Voorbeelden

#language: nl-NL

Scenario: Het VerantwoordingsvrijBedrag moet kleiner zijn dan of gelijk zijn aan de som van de FunctieBudgetBedragen van alle aan het Budget gekoppelde FunctieBudgetten
    Het verantwoordingsvrij bedrag dat op het niveau van het budget wordt vastgelegd moet
    kleiner dan of gelijk zijn aan de som van de in het budget opgenomen functiebudgetten.

    Als gemeente dit toekenningsbericht verstuurt aan het PGB-Portaal
    | Budgethouder bsn | Budget identificatie | Afgiftedatum    | Budget periode                      | Verantwoordingsvrij bedrag |
    | 123456789        | BI-R-1               | 5 november 2025 | 1 januari 2026 t/m 31 december 2026 | € 1.500                    |
    | Zorgfunctie             | Bedrag   | Periode                             |
    | Begeleiding             | € 18.000 | 1 januari 2026 t/m 31 december 2026 |
    | Hulp bij het huishouden | € 12.000 | 1 januari 2026 t/m 31 december 2026 |
    Dan keurt het PGB-Portaal dit toekenningsbericht niet af op deze technische regel

    Als gemeente dit toekenningsbericht verstuurt aan het PGB-Portaal
    | Budgethouder bsn | Budget identificatie | Afgiftedatum    | Budget periode                      | Verantwoordingsvrij bedrag |
    | 123456789        | BI-R-1               | 5 november 2025 | 1 januari 2026 t/m 31 december 2026 | € 150.000                  |
    | Zorgfunctie             | Bedrag   | Periode                             |
    | Begeleiding             | € 18.000 | 1 januari 2026 t/m 31 december 2026 |
    | Hulp bij het huishouden | € 12.000 | 1 januari 2026 t/m 31 december 2026 |
    Dan keurt het PGB-Portaal dit toekenningsbericht af op deze technische regel

    Als gemeente dit toekenningsbericht verstuurt aan het PGB-Portaal
    | Budgethouder bsn | Budget identificatie | Afgiftedatum    | Budget periode                      | Verantwoordingsvrij bedrag |
    | 234567890        | BI-A-1               | 5 november 2025 | 1 januari 2026 t/m 31 december 2026 | € 20.000                   |
    | Zorgfunctie       | Bedrag   | Periode                             |
    | Totaal zorgpakket | € 20.000 | 1 januari 2026 t/m 31 december 2026 |
    Dan keurt het PGB-Portaal dit toekenningsbericht niet af op deze technische regel

    Als gemeente dit toekenningsbericht verstuurt aan het PGB-Portaal
    | Budgethouder bsn | Budget identificatie | Afgiftedatum    | Budget periode                      | Verantwoordingsvrij bedrag |
    | 234567890        | BI-A-1               | 5 november 2025 | 1 januari 2026 t/m 31 december 2026 | € 25.000                   |
    | Zorgfunctie       | Bedrag   | Periode                             |
    | Totaal zorgpakket | € 20.000 | 1 januari 2026 t/m 31 december 2026 |
    Dan keurt het PGB-Portaal dit toekenningsbericht af op deze technische regel
0001bericht inhoud (xslt)
TR504TR504: Bsn moet voorkomen in de BRP.9504externe bron
TR507TR507: Opvolgende berichten mogen pas verzonden worden wanneer van het voorgaande bericht een retourbericht ontvangen is.Een opvolgend bericht is een bericht over hetzelfde budget voor dezelfde client van dezelfde afzender.9507berichtoverstijgend
TR508TR508: In de Wlz betreft het vervangen van informatie behorend bij een Budget altijd hetzelfde budgetjaar.Het jaar van de FunctieBudgetPeriode/Ingangsdatum van het Budget met BudgetIdentificatieOud die vervangen wordt, moet gelijk zijn aan het jaar van de FunctieBudgetPeriode/Ingangsdatum van het nieuw aangeleverde Budget met BudgetIdentificatie.9508berichtoverstijgend
TR509TR509: Indien een Budgetafsluiting gestuurd wordt, dan moet een eerder Toekenningsbericht met eenzelfde Bsn verstuurd zijn.Een Budgetafsluiting heeft betrekking op een eerder, door een bepaalde budgetverstrekker, ter beschikking gesteld Budget aan een bepaalde Client onder een bepaalde wet.9509berichtoverstijgend
TR512TR512: Een bestedingsconflict moet kenbaar gemaakt worden.Het FunctieBudgetBesteed van dit FunctieBudget is hoger dan het toegekende FunctieBudget zoals aangeleverd in het Toekenningsbericht, maar dit is niet kenbaar gemaakt met RedenAfgifte ‘Bestedingsconflict - boven budget en/of buiten budgetperiode’.9512berichtoverstijgend
TR513TR513: Een bestedingsconflict op een VerantwoordingsvrijBedrag moet kenbaar gemaakt worden.

Het VerantwoordingsvrijBedragBesteed van dit Budget is hoger dan het VerantwoordingsvrijBedrag dat is toegekend binnen dit Budget zoals aangeleverd in het Toekenningsbericht, maar dit is niet kenbaar gemaakt met RedenAfgifte ‘Bestedingsconflict - boven budget en/of buiten budgetperiode’.

Voorbeelden

#language: nl-NL

Scenario: Een bestedingsconflict op een VerantwoordingsvrijBedrag moet kenbaar gemaakt worden
    Het PGB-Portaal bewaakt dat er geen declaraties op verantwoordingsvrij bedrag ingediend kunnen
    worden, wanneer deze niet passen binnen de resterende ruimte.
    Bij het geval waarbij, na een correctie op een eerder verstuurd toekenningsbericht, het
    gecorrigeerde verantwoordingsvrij bedrag lager is dan het totaal aan reeds goedgekeurde
    declaraties op verantwoordingsvrij bedrag, dient de betaalinstantie dit aan de verstrekker
    kenbaar te maken als een bestedingsconflict via het budget afsluit bericht. Als dit verzuimd
    wordt, en er een "regulier" budget afsluit bericht ontvangen wordt door de verstrekker, dan zal
    de verstrekker dit "regulier" budget afsluit bericht afkeuren.

    Gegeven gemeente kent per 5 november 2025 aan budgethouder met bsn "123456789" een pgb toe
    En stuurt hiervoor dit toekenningsbericht aan het PGB-Portaal
    | Budgethouder bsn | Budget identificatie | Afgiftedatum    | Budget periode                      | Verantwoordingsvrij bedrag |
    | 123456789        | BI-R-1               | 5 november 2025 | 1 januari 2026 t/m 31 december 2026 | € 1.500                    |
    | Zorgfunctie             | Bedrag   | Periode                             |
    | Begeleiding             | € 18.000 | 1 januari 2026 t/m 31 december 2026 |
    | Hulp bij het huishouden | € 12.000 | 1 januari 2026 t/m 31 december 2026 |
    En het PGB-Portaal verwerkt dit toekenningsbericht

    Gegeven de volgende declaraties zijn goedgekeurd op het pgb voor budgethouder met bsn "123456789"
    | Zorgfunctie             | Bedrag  | Leveringsperiode                |
    | Begeleiding             | € 9.000 | 1 januari 2026 t/m 30 juni 2026 |
    | Hulp bij het huishouden | € 6.000 | 1 januari 2026 t/m 30 juni 2026 |
    | Verantwoordingsvrij     | € 1.500 | N.v.t.                          |

    Stel gemeente corrigeert op 7 juli 2026 het pgb voor budgethouder met bsn "123456789"
    En stuurt hiervoor dit toekenningsbericht aan het PGB-Portaal
    | Budgethouder bsn | Budget identificatie | Budget identificatie oud | Afgiftedatum    | Budget periode                      | Verantwoordingsvrij bedrag |
    | 123456789        | BI-R-2               | BI-R-1                   | 5 november 2025 | 1 januari 2026 t/m 31 december 2026 | € 1.000                    |
    | Zorgfunctie             | Bedrag   | Periode                             |
    | Begeleiding             | € 16.000 | 1 januari 2026 t/m 31 december 2026 |
    | Hulp bij het huishouden | € 10.000 | 1 januari 2026 t/m 31 december 2026 |
    En het PGB-Portaal verwerkt dit toekenningsbericht
    Als de betaalinstantie 14 weken na 31 december 2026 een budget afsluit bericht aan gemeente
    | Budgethouder bsn | Budget identificatie | Verantwoordingsvrij bedrag besteed | Reden budget afsluiting        |
    | 123456789        | BI-R-2               | € 1.500                            | Einddatum functiebudgetperiode |
    | Zorgfunctie       | Bestedingsperiode                   | Functiebudget besteed |
    | Totaal zorgpakket | 1 januari 2026 t/m 31 december 2026 | € 26.000              | 
    Dan keurt gemeente dit budget afsluit bericht af met retourcode "9513"

    Stel gemeente corrigeert op 7 juli 2026 het pgb voor budgethouder met bsn "123456789"
    En stuurt hiervoor dit toekenningsbericht aan het PGB-Portaal
    | Budgethouder bsn | Budget identificatie | Budget identificatie oud | Afgiftedatum    | Budget periode                      | Verantwoordingsvrij bedrag |
    | 123456789        | BI-R-2               | BI-R-1                   | 5 november 2025 | 1 januari 2026 t/m 31 december 2026 | € 1.000                    |
    | Zorgfunctie             | Bedrag   | Periode                             |
    | Begeleiding             | € 16.000 | 1 januari 2026 t/m 31 december 2026 |
    | Hulp bij het huishouden | € 10.000 | 1 januari 2026 t/m 31 december 2026 |
    En het PGB-Portaal verwerkt dit toekenningsbericht
    Als de betaalinstantie binnen 24 uur na verwerking van dit toekenningsbericht een budget afsluit bericht aan gemeente stuurt
    | Budgethouder bsn | Budget identificatie | Verantwoordingsvrij bedrag besteed | Reden budget afsluiting                                      |
    | 123456789        | BI-R-2               | € 1.500                            | Bestedingsconflict - boven budget en/of buiten budgetperiode |
    | Zorgfunctie       | Bestedingsperiode                   | Functiebudget besteed |
    | Totaal zorgpakket | 1 januari 2026 t/m 31 december 2026 | € 26.000              | 
    Dan keurt gemeente dit budget afsluit bericht niet af met retourcode "9513"
9513berichtoverstijgend
TR520TR520: In het toekenningsbericht mogen door de verstrekker maximaal 5 vertegenwoordigers worden opgenomen.0001bericht inhoud (xslt)
TR521TR521: De geldigheidsduur van een FunctieBudget mag niet groter zijn dan een kalenderjaar.De periode van het Functiebudget moet altijd kleiner of gelijk zijn aan een kalenderjaar, dus de periode loopt maximaal van 01-01 t/m maximaal 31-12 van datzelfde jaar.0001bericht inhoud (xslt)
TR522TR522: De in het toekenningsbericht opgenomen vertegenwoordiger moet op dagtekening van het bericht 18 jaar of ouder zijn.9522externe bron
TR523TR523: Het in het toekenningsbericht opgenomen KvK nummer moet voorkomen in het KvK-register.9523externe bron
TR562TR562: Iedere mutatie moet gerelateerd zijn aan een eerder verzonden bericht op basis van sleutelvelden.BudgetIdentificatieOud wordt gevuld met BudgetIdentificatie van het budget dat wordt gewijzigd en dat al eerder is aangeleverd en is goedgekeurd. Door de wijziging krijgt het budget een nieuw Budgetidentificatie. Het is niet toegestaan om BudgetIdentificatieOud te vullen met een BudgetIdentificatie waarop eerder een mutatie is doorgegeven die is goedgekeurd en is verwerkt.9562berichtoverstijgend
TR574TR574: Ieder Budget krijgt een unieke BudgetIdentificatie per Client per verstrekker.Dit betekent dat de combinatie van Afzender, Bsn en BudgetIdentificatie, over berichten heen, uniek moet zijn.9574externe bron
TR575TR575: Vullen met een bestaande gemeentecode uit het overzicht van CBS.De gemeentecode moet voorkomen in de Gemeentelijke indeling (zie website Centraal Bureau voor de Statistiek (CBS)).9575externe bron
TR576TR576: Binnen dezelfde wet mag geen eerder verwerkt WMO501 bericht zijn van een andere gemeente, waarvan de budgetperiode overlapt.Er mag geen reeds verwerkt budget zijn voor deze budgethouder naar aanleiding van een eerder verwerkt WMO501 bericht, waarvan de afzender een andere gemeente is dan de afzender van dit bericht en de budgetperiode overlapt met de budgetperiode uit dit bericht.9576berichtoverstijgend
TR577TR577: Binnen dezelfde wet mag geen eerder verwerkt WLZ501 bericht zijn van een ander zorgkantoor, waarvan de budgetperiode overlapt.Er mag geen reeds verwerkt budget zijn voor deze budgethouder naar aanleiding van een eerder verwerkt WLZ501 bericht, waarvan de afzender een ander zorgkantoor is dan de afzender van dit bericht en de budgetperiode overlapt met de budgetperiode uit dit bericht.9577berichtoverstijgend
TR578TR578: Binnen dezelfde wet mag geen eerder verwerkt JW501 bericht zijn van een andere gemeente, waarvan de budgetperiode overlapt.Er mag geen reeds verwerkt budget zijn voor deze budgethouder naar aanleiding van een eerder verwerkt JW501 bericht, waarvan de afzender een andere gemeente is dan de afzender van dit bericht en de budgetperiode overlapt met de budgetperiode uit dit bericht.9578berichtoverstijgend