Als gemeente wil ik (product)aanvragen bij ketenpartners die bijdragen aan het behandelen van mijn zaak op basis van de identificatie van die aanvraag kunnen registreren

[hdksi]

in plaats van op basis van de identificatie bij de zaak die deze ketenpartner naar aanleiding van die aanvraag eventueel gestart is, zodat bij zaakgerichte ketensamenwerking het 'standaardpatroon' voor levering van producten en diensten kan worden gevolgd.

Dat patroon ziet er als volgt uit:

Ten zien is de situatie dat de gemeente als behandelingsverantwoordelijke naar aanleiding van een aanvraag door een burger een zaak heeft gestart. Voor de behandeling van die zaak heeft de gemeente een product van een derde organisatie (de ketenpartner) nodig. Hiertoe dient de gemeente na het raadplegen van de catalogus van producten die deze ketenpartner aanbiedt (niet afgebeeld) bij de ketenpartner een aanvraag in voor levering van het benodigde product. Het eigen zaaknummer wordt daarbij meegegeven aan de ketenpartner zodat die weet (of kan weten) waaraan die bijdraagt.

Na het indienen ontvangt de gemeente een aanvraagnummer terug, dat bij de bij de eigen lopende zaak wordt geregistreerd. De ketenpartner start om de ontvangen aanvraag te behandelen zelf ook een zaak (of twee, drie of zeven zaken). Het bestaan van deze zaak is voor deze organisatie een puur interne aangelegenheid.

De gemeente wordt over de behandeling van de ingediende aanvraag geïnformeerd op basis van het aanvraagnummer, en hoeft dus van het bestaan van een zaak (of zaken) bij de ketenpartner niets te weten. Dat is logisch: de gemeente heeft een product besteld, geen zaak.

Als de zaakbehandeling bij de ketenpartner is afgerond ontvangt de gemeente de eindproducten daarvan: een besluit en het gevraagde product. Die kunnen vervolgens worden gebruikt om de eigen behandeling van de gemeentelijke zaak af te ronden. De eindproducten daarvan worden ten slotte aan de burger geleverd.

Dit patroon heeft consequenties voor de Zaken API. In versie 1.3.0-alpha5 is (aansluitend bij RGBZ 2.0) de mogelijkheid gecreëerd om een (en volgens mij niet meerdere) gerelateerdeExterneZaken vast te leggen. Deze mogelijkheid sluit niet aan bij bovenstaand patroon waarbinnen een organisaties werk kan uitbesteden door het bij een ketenpartner indienen van een aanvraag in plaats van het initiëren van een zaak.

Ik zou daarom willen voorstellen gerelateerdeExterneZaken niet op te nemen in een productieversie van de Zaken API, maar in plaats daarvan gerelateerdeExterneAanvragen o.i.d. toe te voegen. Daarbij geldt dat:

1. Het mogelijk zou moeten zijn om meerdere gerelateerde externe aanvragen aan een zaak te koppelen;
2. aardRelatie kan vervallen - een gerelateerde externe zaak wordt immers altijd door een opdrachtgever geregistreerd, een opdrachtnemer kent de zaak waaraan hij bijdraagt naar aanleiding van de bij de productaanvraag meegeleverde referentie (zie https://github.com/VNG-Realisatie/klantinteracties/issues/149);
3. Kan het lijstje attributen korter, waarbij mijns inziens volstaan kan worden met:
   1. (identificatienummer van) de organisatie waar de aanvraag is ingediend
   2. url-verwijzing naar de aanvraag in het aanvragenregister bij de ketenpartner
   3. het door de ketenpartner toegewezen aanvraagnummer
   4. datum van verzending van de aanvraag aan de ketenpartner
   5. datum dat de bevestiging van ontvangst van de aanvraag door de ketenpartner
   6. url-verwijzing naar het aangevraagde product in de PDC van de ketenpartner
   7. de door de ketenpartner toegewezen productcode bij dat product
   8. naam/omschrijving van dat product

[hdksi]

Conclusie van overleg hierover is dat het patroon voor zaakgericht werken in de keten nadere uitwerking verdient, en dat we hangende die uitwerking gerelateerdeExterneAanvragen gerelateerdeExterneZaken (edit) niet opnemen in release 1.3.0. van de Zaken API om breaking changes later te voorkomen.

[michielverhoef]

Even voor de zekerheid: Het gaat alleen om het attribuut gerelateerdeExterneAanvragen ? Zie ook #2026

[hdksi]

Dat kan ik bevestigen, gaat alleen om gerelateerdeExterneAanvragen gerelateerdeExterneZaken (edit).

[michielverhoef]

@hdksi RGBZ 2 kent gerelateerdeExterneAanvragen niet, wel gerelateerdeExterneZaken. Wordt dat misschien bedoeld?

[hdksi]

Sorry, ik had deze even gemist. gerelateerdeExterneAanvragen was een voorstel voor een mogelijke (latere) oplossing.

'gerelateerde externe zaak' (RGBZ) of gerelateerdeExterneZaken (Zaken API 1.3.0-rc1) inclusief onderliggende attributen is wat in de releaseversie van 1.3.0 niet moet worden opgenomen.

[hdksi]

Vraag is bij nader inzien of het nodig is om onderscheid te maken tussen 'exerne' en 'interne' gerelateerde verzoeken.