> For the complete documentation index, see [llms.txt](https://dienstverleningsplatform.gitbook.io/platform-generieke-dienstverlening-public/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dienstverleningsplatform.gitbook.io/platform-generieke-dienstverlening-public/patronen/verzoeken/zaakverzoek.md).

# Zaakverzoek

**Auteur**: Niels Erkamp | Joeri Diederen | Rutger Haagsma | **Status**: Concept

### Inleiding

Een zaakverzoek en is een verzoek vanuit de initiator van de zaak binnen de context van een bestaande, lopende zaak. 

### Duiding

Het zaakverzoek is:

* In basis een formulierdefinitie met een typering, naam en inhoud, en
* heeft een specifieke use case
* is gerelateerd aan een fase binnen de zaak
* is onderdeel van de Producten- en Dienstencatalogus
* wordt getoond op het klantportaal wanneer van toepassing
* leidt tot een notificatie aan het afhandelcomponent 

### Voorbeelden

* De zaak verhuizing aanvragen heeft een Actie voor het **intrekken van de aanvraag,** actief gedurende de behandelfase.
* De zaak erfpacht behandelen heeft een Actie voor het **aanvullen van de aanvraag,** actief gedurende de intakefase.

{% hint style="info" %}
2024-09: Het zaakverzoek is qua definitie en patroon gelijk aan het productverzoek. \
\
Voor de vastlegging van de relatie tussen zaakverzoek en zaak wordt gewacht op de realisatie van de PDC.
{% endhint %}

## Sequences

Uit: <https://gzac.gitbook.io/product-docs/kennisbank/werken-met-componenten/communicatie-met-portalen>

**ZaakVerzoek**

Het ZaakVerzoek is een verzoek of voorval vanuit de klant of ketenpartner richting de gemeente, binnen de context van een bestaande zaak. Dit scenario komt voor bij langlopende, complexe aanvragen.

<figure><img src="https://gzac.gitbook.io/~gitbook/image?url=https%3A%2F%2F3213878061-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FSCQDxYxbCifWgW1LKPa7%252Fuploads%252FaPNyNSAOvyF0h52PQ5Vq%252FScreenshot%25202023-05-28%2520at%252015.00.32.png%3Falt%3Dmedia%26token%3D4aa296df-f9f3-4c1f-a91a-93521073621f&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=d7646a20&#x26;sv=1" alt=""><figcaption></figcaption></figure>

> Voorbeeld klantcommunicatie: de klant heeft de behoefte het evenement groter op te zetten, en wil weten of dit kan middels een aanpassing binnen de lopende aanvraag.
>
> Voorbeeld ketenpartnercommunicatie: de partij die trainingen geeft aan minder draagkrachtige inwoners in opdracht van de gemeente, meldt dat een deelnemer drie keer niet is verschenen.

{% @mermaid/diagram content="sequenceDiagram
participant klant AS Aanvraagcomponent
participant portaal AS Portaal
participant bericht AS Zaakverzoek<br/>(Objecten API)
participant gzac AS ZAC

activate klant
klant ->> portaal: Klikt op zaak
activate portaal
portaal -->> klant: Weergave zaak
deactivate portaal

klant ->> portaal: ZaakVerzoek starten
activate portaal
opt Meer informatie ZaakVerzoek
portaal -->> klant: Weergave formulier
klant ->> portaal: Fomulier verzonden
deactivate klant
end
portaal ->> bericht: ZaakVerzoek neerzetten
deactivate portaal
activate bericht
bericht ->> gzac : Genotificeerd van nieuw ZaakVerzoek
activate gzac
deactivate bericht
gzac -->> bericht: Bericht: ZaakVerzoek ontvangen
gzac ->> gzac: Aanpassing zaak
gzac -->> bericht: Bericht: ZaakVerzoek afgehandeld
gzac ->> bericht: Verwijderen ZaakVerzoek
deactivate gzac

" %}

## Vaststellingen

* Een ZaakVerzoek wordt geïnitieerd door de aanvrager (initiator) van de zaak.
* Een ZaakVerzoek wordt op de datalaag gezet en via notificaties wordt het juiste ZAC geinformeerd.
* Een ZaakVerzoek is altijd gekoppeld aan een reeds bestaande zaak.

## Functioneel

* ZaakVerzoeken kunnen worden geinitieerd tot een bepaald moment in de afhandeling van de Zaak. Bijvoorbeeld: na betaling kan geen aanpassing meer gemaakt worden in het oorspronkelijke Verzoek.&#x20;
* ZaakVerzoeken zijn gedefinieerd en gestructureerd.&#x20;

## Schema

<table><thead><tr><th width="222">Eigenschap</th><th width="142">Type</th><th>Beschrijving</th></tr></thead><tbody><tr><td>zaakId</td><td>UUID</td><td>ID van de zaak</td></tr><tr><td>type</td><td>String</td><td>Type zaakverzoek</td></tr><tr><td>status</td><td>String</td><td>Status</td></tr><tr><td>&#x3C;type></td><td>JSON</td><td>[Optioneel] Data gerelateerd aan zaakverzoek</td></tr><tr><td></td><td></td><td></td></tr></tbody></table>