# MoneyBird koppelen

MoneyBird is een gebruiksvriendelijk online boekhoudprogramma. TimeMate biedt een directe integratie met MoneyBird via OAuth, zodat je facturen eenvoudig kunt aanmaken en versturen.

## Voordelen van de koppeling

* **Directe facturatie**: Verstuur facturen rechtstreeks naar MoneyBird
* **Klanten synchroniseren**: Importeer je contacten uit MoneyBird
* **Producten synchroniseren**: Importeer je producten en diensten
* **Veilige OAuth-koppeling**: Geen API-sleutel nodig

## Vereisten

* Een actief MoneyBird account
* Administrator-rechten in TimeMate
* Toegang tot je MoneyBird administratie

## Stappen om te koppelen

### 1. Open de koppelingsopties

1. Ga naar **Instellingen** > **Koppelingen**
2. Zoek **MoneyBird** onder het kopje "Boekhoudprogramma's"
3. Klik op MoneyBird om het paneel uit te klappen

### 2. Start het koppelingsproces

1. Klik op de knop **Koppelen**
2. Je wordt doorgestuurd naar MoneyBird

### 3. Log in bij MoneyBird

1. Voer je MoneyBird inloggegevens in
2. Als je al ingelogd bent, word je direct doorgestuurd naar de toestemmingspagina

### 4. Geef toestemming

1. MoneyBird toont welke rechten TimeMate vraagt
2. Klik op **Autoriseren** om toestemming te geven
3. Je wordt teruggestuurd naar TimeMate

### 5. Bevestig de koppeling

1. Bij succes zie je een groene badge "Gekoppeld"
2. Je kunt nu facturen versturen naar MoneyBird

## Gegevens importeren

### Contacten importeren

1. Klik op **Importeren** naast de gekoppelde MoneyBird
2. Selecteer **Klanten**
3. Je contacten uit MoneyBird worden geïmporteerd in TimeMate

### Producten importeren

1. Klik op **Importeren**
2. Selecteer **Materialen**
3. Je producten uit MoneyBird worden geïmporteerd

## Facturen versturen naar MoneyBird

1. Ga naar je uren of werkbonnen
2. Selecteer de items die je wilt factureren
3. Klik op **Factureren**
4. Configureer de factuur:
   * Selecteer de klant
   * Controleer de regels
   * Pas indien nodig de beschrijvingen aan
5. Klik op **Verstuur factuur**
6. De factuur wordt aangemaakt in MoneyBird

## MoneyBird-specifieke opties

Bij het factureren naar MoneyBird heb je extra opties:

* **Concept factuur**: Maak een concept aan dat je later in MoneyBird kunt bewerken
* **Directe factuur**: Maak direct een definitieve factuur aan
* **BTW-codes**: TimeMate gebruikt automatisch de juiste BTW-codes uit MoneyBird

## Problemen oplossen

### "Autorisatie mislukt"

* Controleer of je de juiste MoneyBird-account gebruikt
* Probeer uit te loggen bij MoneyBird en opnieuw te koppelen
* Controleer of je voldoende rechten hebt in MoneyBird

### "Contact niet gevonden"

* Importeer eerst je contacten uit MoneyBird
* Controleer of de klant bestaat in je MoneyBird administratie
* Controleer of de klantnaam exact overeenkomt

### "Koppeling werkt niet meer"

OAuth-tokens kunnen verlopen. Vernieuw de koppeling:

1. Klik op **Ontkoppelen**
2. Klik opnieuw op **Koppelen**
3. Doorloop het autorisatieproces opnieuw

## Tips

* Synchroniseer regelmatig je contacten om nieuwe klanten te importeren
* Controleer je facturen in MoneyBird na het versturen
* Gebruik duidelijke omschrijvingen zodat facturen overzichtelijk zijn in MoneyBird

## Koppeling verwijderen

1. Ga naar **Instellingen** > **Koppelingen**
2. Klik op MoneyBird
3. Klik op **Ontkoppelen**
4. Bevestig de actie

Na het ontkoppelen kun je nog steeds de eerder verstuurde facturen zien in MoneyBird. Nieuwe facturen kunnen pas weer verstuurd worden na het opnieuw koppelen.