Uitvoering

Uitvoering van een taak. Bekende typen hebben een variant met een const-waarde op type en type-specifieke velden. OnbekendeUitvoering dient als catch-all voor toekomstige of onbekende typen en zorgt ervoor dat oneOf altijd precies één match oplevert.

Discriminator: veld type.

oneOf

• UploadUitvoering
• FormulierUitvoering
• BetaalUitvoering
• OnbekendeUitvoering

typestring

Constant value: upload

fallbackUrlurirequired

Fallback-URL voor de uitvoering van de taak. Altijd aanwezig. Gebruikt als het portaal type niet ondersteunt of de type-specifieke velden niet lokaal kan verwerken.

In redirect-scenario's voegt het portaal een returnUrl toe vóór de redirect, zodat de externe partij de gebruiker na afloop terug kan sturen naar SCR-TAKEN-IN-CONTEXT. De precieze parameternaam is afhankelijk van de ontvangende partij.

Examples:

Example 1

Example: https://portaal.gemeente.nl/taken/550e8400/uitvoeren?returnUrl=https%3A%2F%2Fmijnoverheid.nl%2Ftaken%2Fcontext%2Fzaak-2026-00042

Example 2

Example: https://betalen.gemeente.nl/pay?kenmerk=REF-2026-00042&bedrag=6550&returnUrl=https%3A%2F%2Fmijnoverheid.nl%2Ftaken%2Fcontext%2Fzaak-2026-00042

submitUrlurirequired

API-endpoint voor het uploaden van bestanden (niet zichtbaar voor de gebruiker).

Example: https://api.gemeente.nl/documenten/upload

maxBestandeninteger

Maximum aantal bestanden dat geüpload mag worden.

Example: 5

toegestaneFormatenstring[]

Toegestane bestandsextensies.

Example: ["pdf","jpg","png"]

maxBestandsgrootteinteger

Maximale bestandsgrootte in bytes.

Example: 10485760

Uitvoering

{
  "type": "upload",
  "fallbackUrl": "https://portaal.gemeente.nl/taken/550e8400/uitvoeren?returnUrl=https%3A%2F%2Fmijnoverheid.nl%2Ftaken%2Fcontext%2Fzaak-2026-00042",
  "submitUrl": "https://api.gemeente.nl/documenten/upload",
  "maxBestanden": 5,
  "toegestaneFormaten": [
    "pdf",
    "jpg",
    "png"
  ],
  "maxBestandsgrootte": 10485760
}