Instructie
difficulty level:
Beheer > Integraties > Moneybird
Moneybird einrichten: OAuth, Administration und Mapping
Die Moneybird-Verbindung überträgt Kontakte und Verkaufsrechnungen aus i-Reserve über OAuth2 an eine Moneybird-Administration. Zusätzlich kann ein in Moneybird geänderter Kontakt über einen Webhook zurück nach i-Reserve gelangen.
1. Auf der Moneybird-Seite (einmalig)
- Registrieren Sie eine OAuth-App im Moneybird-Developer-Portal und notieren Sie Client ID und Client Secret.
- Setzen Sie die Redirect-URL, die i-Reserve anzeigt, auf die Liste der zugelassenen Adressen.
- Stellen Sie sicher, dass die gewünschte Administration existiert und dass die MwSt.-Sätze (tax rates) eingerichtet sind.
2. Auf der i-Reserve-Seite — Reiter Authentifizierung
| Feld | Was einzutragen ist |
|---|---|
| Client ID | Client-ID Ihrer Moneybird-OAuth-App. Erforderlich. |
| Client Secret | Client-Secret Ihrer Moneybird-OAuth-App. Erforderlich. |
| Redirect-URL | Wird automatisch von i-Reserve ausgefüllt; muss in der Moneybird-App als zugelassener Redirect eingetragen sein. |
Durchlaufen Sie danach Schritt 1 – Zustimmung und Schritt 2 – verbinden. Bei Schritt 2 ruft i-Reserve die Liste der Administrations ab und wählt automatisch die richtige (oder die erste).
3. Reiter Details
| Feld | Was es bewirkt |
|---|---|
| Administration | Die Moneybird-Administration; wird beim Verbinden automatisch gesetzt. |
| Rechnungsfeld | i-Reserve-Feld, in dem die externe Rechnungs-ID gespeichert wird. |
| Kundenfeld | i-Reserve-Feld, in dem die Moneybird-Kontakt-ID gespeichert wird. |
| Kundennummer-Präfix / -Länge | (Optional) Präfix und Zero-Padding für die Kundennummer am Kontakt. |
| Externe Rechnung erstellen | Ja = eine externe Verkaufsrechnung (leichtgewichtig, ohne vollständigen Buchungs-Workflow); Nein = eine normale Verkaufsrechnung. Nach der Nutzung nicht wechseln — bestehende Rechnungen werden dann nicht mehr gefunden. |
| Rechnung endgültig machen | Ja = Rechnung in Moneybird endgültig machen (bei einer externen Rechnung ignoriert). |
| E-Mail aus Moneybird versenden | Ja = Moneybird versendet die Rechnung per E-Mail; Nein = manuell. |
4. Mapping & Rückmeldung
- MwSt.-Mapping (erforderlich) — verbinden Sie jeden i-Reserve-MwSt.-Satz mit dem richtigen Moneybird-tax rate. Ohne Mapping schlägt die Rechnung fehl.
- Webhook zurück — Moneybird kann ein Kontakt-geändert-Event zurücksenden, sodass ein angepasster Kontakt die Kundendaten in i-Reserve aktualisiert.
5. Aktivieren & Checkliste
- ☐ OAuth-App in Moneybird erstellt; Client ID/Secret notiert; Redirect-URL zugelassen.
- ☐ Administration existiert; MwSt.-Sätze eingerichtet.
- ☐ Reiter Authentifizierung ausgefüllt; Schritt 1 und Schritt 2 erfolgreich; Administration gefüllt.
- ☐ Reiter Details: Rechnungs-/Kundenfeld, Externe-Rechnung-Wahl (bewusst!), Endgültig/E-Mail eingestellt.
- ☐ MwSt.-Mapping vollständig für alle verwendeten Sätze.
- ☐ Testrechnung übertragen und in Moneybird geprüft (Kontakt + Positionen + MwSt. stimmen).
- ☐ Webhook-Rückmeldung getestet (falls gewünscht).
- ☐ Rollback bekannt: die Verbindung auf inaktiv setzen stoppt neue Syncs.
Moneybird: Wechseln Sie "externe Rechnung erstellen" nicht mehr, nachdem Rechnungen übertragen wurden. Die IDs von normalen und externen Verkaufsrechnungen sind getrennt, wodurch bestehende Rechnungen andernfalls nicht wiedergefunden werden.
Das MwSt.-Mapping ist verpflichtend: Jeder verwendete i-Reserve MwSt.-Satz muss mit einer Moneybird tax rate verknüpft sein, andernfalls schlägt die Rechnung fehl.
