Instructie
Moeilijkheidsgraad:
Beheer > Integraties > Moneybird
Moneybird instellen: OAuth, administration en mapping
De Moneybird-koppeling zet contacten en verkoopfacturen vanuit i-Reserve door naar een Moneybird administration, via OAuth2. Daarnaast kan een gewijzigd contact in Moneybird via een webhook terug naar i-Reserve.
1. Aan de Moneybird-kant (eenmalig)
- Registreer een OAuth-app in het Moneybird developer-portal en noteer Client ID en Client Secret.
- Zet de redirect-URL die i-Reserve toont op de toegestane lijst.
- Zorg dat de gewenste administration bestaat en dat de BTW-tarieven (tax rates) zijn ingericht.
2. Aan de i-Reserve-kant — Authenticatie-tab
| Veld | Wat in te vullen |
|---|---|
| Client ID | Client-id van je Moneybird OAuth-app. Verplicht. |
| Client Secret | Client-secret van je Moneybird OAuth-app. Verplicht. |
| Redirect-URL | Automatisch ingevuld door i-Reserve; moet in de Moneybird-app als toegestane redirect staan. |
Doorloop daarna Stap 1 – toestemming en Stap 2 – verbinden. Bij stap 2 haalt i-Reserve de lijst met administrations op en kiest automatisch de juiste (of de eerste).
3. Details-tab
| Veld | Wat het doet |
|---|---|
| Administration | De Moneybird-administratie; automatisch gezet bij verbinden. |
| Factuurveld | i-Reserve-veld waarin het externe factuur-id wordt bewaard. |
| Klantveld | i-Reserve-veld waarin het Moneybird contact-id wordt bewaard. |
| Klantnummer-prefix / -lengte | (Optioneel) prefix en zero-padding voor het klantnummer op het contact. |
| Externe factuur aanmaken | Ja = een externe verkoopfactuur (lichtgewicht, zonder volledige boekingsworkflow); Nee = een gewone verkoopfactuur. Niet wisselen na gebruik — bestaande facturen worden dan niet teruggevonden. |
| Factuur definitief maken | Ja = factuur in Moneybird definitief maken (bij een externe factuur genegeerd). |
| E-mail versturen vanuit Moneybird | Ja = Moneybird stuurt de factuur per e-mail; Nee = handmatig. |
4. Mapping & terugkoppeling
- BTW-mapping (verplicht) — koppel elk i-Reserve BTW-tarief aan het juiste Moneybird tax rate. Zonder mapping mislukt de factuur.
- Webhook terug — Moneybird kan een contact gewijzigd-event terugsturen, zodat een aangepast contact de klantgegevens in i-Reserve bijwerkt.
5. Activeren & checklist
- ☐ OAuth-app in Moneybird gemaakt; Client ID/Secret genoteerd; redirect-URL toegestaan.
- ☐ Administration bestaat; BTW-tarieven ingericht.
- ☐ Auth-tab gevuld; Stap 1 en Stap 2 geslaagd; administration gevuld.
- ☐ Details-tab: factuur-/klantveld, externe-factuur-keuze (bewust!), definitief/e-mail ingesteld.
- ☐ BTW-mapping volledig voor alle gebruikte tarieven.
- ☐ Testfactuur doorgezet en gecontroleerd in Moneybird (contact + regels + BTW kloppen).
- ☐ Webhook-terugkoppeling getest (indien gewenst).
- ☐ Rollback bekend: koppeling op inactief zetten stopt nieuwe syncs.
Moneybird: wissel "externe factuur aanmaken" niet meer nadat er facturen zijn doorgezet. De id's van gewone en externe verkoopfacturen zijn gescheiden, waardoor bestaande facturen anders niet worden teruggevonden.
BTW-mapping is verplicht: elk gebruikt i-Reserve BTW-tarief moet aan een Moneybird tax rate gekoppeld zijn, anders mislukt de factuur.
