# Engyon koppelen voor budget en planning

> Een Engyon service account koppelen, zodat AIRA het budget op de taken van een Engyon-dossier bouwt en de taaktoewijzing terugzet.

- Te vinden in AIRA: Beheer › Instellingen › Integraties
- Benodigd recht: Kantoorinstellingen beheren (Kantoor). Geen rol heeft dit recht standaard. Een beheerder kent het per gebruiker toe; beheerders hebben het zelf altijd.
- Licentiemodule: Integraties. Zonder deze module staat het onderdeel grijs met een slotje.
- Bron: https://help.aira.jlfintech.nl/beheer/engyon-koppeling
- Laatst bijgewerkt: 15-10-2026

Beantwoordt de vragen:
- Hoe koppel ik Engyon aan AIRA?
- Welke rol heeft het Engyon service account nodig?
- Waar vind ik de client-id en het client-secret van Engyon?
- Wat betekent De koppeling met Engyon werkt niet meer?
- Hoe vervang ik het Engyon-secret?
- Wat gebeurt er als ik de Engyon-koppeling verwijder?
- Moet ik deze koppeling instellen voor de bankafschriften van Engyon?

Met de Engyon-koppeling bouw je in AIRA het budget op de taken van een Engyon-dossier, en zet je de taaktoewijzing terug in dat dossier. Je koppelt één keer voor het hele kantoor, met een service account uit Engyon. Hiervoor heb je in AIRA het recht **Kantoorinstellingen beheren** nodig. De koppeling is nog in bèta.

## Een service account maken in Engyon

1. Ga in Engyon naar **Opties** › **Organisatie** › **Service accounts**.
2. Maak een service account aan met alleen de rol **API audit manager**.
3. Noteer de client-id en het client-secret. Engyon toont het secret maar één keer; bewaar het in de wachtwoordmanager van je kantoor.

> [!let-op] Geef niet meer rechten dan nodig
> De rol **API account manager** is niet nodig. Die kan dossiers aanmaken en daarmee credits uitgeven.

## Engyon koppelen in AIRA

1. Ga in AIRA naar **Beheer** › **Instellingen**.
2. Kies onder **Kantoor** het onderdeel **Integraties**.
3. Vul op de kaart **Engyon — Budget en planning** de **Client-id** en het **Client-secret** in.
4. Klik op **Koppelen met Engyon**.

AIRA controleert de gegevens eerst bij Engyon; je ziet even **Controleren bij Engyon…**. Kloppen ze, dan toont de kaart **Gekoppeld met Engyon**, met de datum van koppelen en van de laatste controle. De gegevens zijn daarna versleuteld opgeslagen en niet meer in te zien.

Na het koppelen ziet elke medewerker de taken van het gekoppelde dossier in het budget, binnen zijn eigen rechten. Op een taak komen alleen medewerkers die op het team van het Engyon-dossier staan.

## Meldingen bij het koppelen

| Melding | Oplossing |
|---------|-----------|
| *Engyon accepteert de client-id en client-secret niet. Controleer beide waarden of maak een nieuw secret aan.* | Controleer of je beide waarden volledig hebt overgenomen, of maak in Engyon een nieuw secret aan. |
| *Het service account mist de rol API audit manager. Ken die rol in Engyon toe en probeer opnieuw.* | Geef het service account in Engyon de rol **API audit manager**. |
| *Engyon is op dit moment niet bereikbaar. Probeer het later opnieuw.* | Wacht even en probeer het opnieuw. |

## Een nieuw secret gebruiken

Maak je in Engyon een nieuw secret aan, of toont de kaart **De koppeling met Engyon werkt niet meer**, dan vervang je de gegevens zo:

1. Klik op de kaart op **Koppeling verwijderen** en bevestig de vraag.
2. Vul de **Client-id** en het nieuwe **Client-secret** in.
3. Klik op **Koppelen met Engyon**.

## Veelgestelde vragen

### Welke rol heeft het Engyon service account nodig?

Alleen de rol **API audit manager**. De rol API account manager is niet nodig.

### Wat betekent De koppeling met Engyon werkt niet meer?

Engyon accepteert de opgeslagen client-id en client-secret niet meer, bijvoorbeeld omdat het secret is vervangen of het service account is verwijderd. Verwijder de koppeling en voer nieuwe gegevens in.

### Wat gebeurt er als ik de Engyon-koppeling verwijder?

De Engyon-taken en de Sync verdwijnen voor alle gebruikers. Bestaande budgetregels blijven bewaard als gewone taken.

### Moet ik deze koppeling instellen voor de bankafschriften van Engyon?

Nee. De bankafschriftanalyse vanuit Engyon werkt los van deze koppeling en vraagt geen instelling in AIRA.