> For the complete documentation index, see [llms.txt](https://help.timemate.nl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.timemate.nl/koppelingen/yuki.md).

# Yuki koppelen

Yuki is een uitgebreid online boekhoudplatform dat automatisering combineert met professionele boekhouding. TimeMate kan worden gekoppeld aan Yuki via een API-sleutel.

## Voordelen van de koppeling

* **Geautomatiseerde facturatie**: Verstuur facturen direct naar Yuki
* **Klanten synchroniseren**: Importeer je relaties uit Yuki
* **Professionele integratie**: Naadloze samenwerking met je accountant

## Vereisten

* Een actief Yuki account
* API-toegang (mogelijk afhankelijk van je Yuki-pakket)
* Administrator-rechten in TimeMate

## API-sleutel verkrijgen

### 1. Log in bij Yuki

1. Ga naar het Yuki portal
2. Log in met je accountgegevens

### 2. Navigeer naar API-instellingen

1. Ga naar **Instellingen** of **Beheer**
2. Zoek de optie voor **API-toegang** of **Koppelingen**
3. Je hebt mogelijk hulp nodig van je Yuki-beheerder of accountant

### 3. Verkrijg de API-sleutel

1. Vraag een API-sleutel aan of genereer deze
2. Noteer ook eventuele aanvullende gegevens zoals:
   * Administratiecode
   * Domein
3. Kopieer alle benodigde gegevens

## Koppelen met TimeMate

### 1. Open de koppelingsopties

1. Ga naar **Instellingen** > **Koppelingen**
2. Zoek **Yuki** onder "Boekhoudprogramma's"
3. Klik om het paneel te openen

### 2. Voer de gegevens in

1. Plak je API-sleutel in het daarvoor bestemde veld
2. Vul eventuele aanvullende velden in:
   * Administratienummer (indien gevraagd)
   * Andere configuratieopties

### 3. Activeer de koppeling

1. Klik op **Koppelen**
2. Wacht tot de verbinding is geverifieerd
3. Bij succes zie je "Gekoppeld" verschijnen

## Gegevens synchroniseren

### Relaties importeren

1. Klik op **Importeren** naast Yuki
2. Selecteer **Klanten**
3. Je relaties worden geïmporteerd in TimeMate

### Artikelen importeren

1. Klik op **Importeren**
2. Selecteer **Materialen**
3. Je artikelen uit Yuki worden gesynchroniseerd

## Facturen versturen

1. Selecteer de uren of werkbonnen om te factureren
2. Klik op **Factureren**
3. Selecteer de klant
4. Controleer en pas de factuurgegevens aan
5. Klik op **Verstuur factuur**
6. De factuur wordt aangemaakt in Yuki

## Werken met je accountant

Yuki is vaak gekoppeld aan een accountantskantoor. Houd rekening met:

* **Afstemming**: Overleg met je accountant over het gebruik van de koppeling
* **Grootboekrekeningen**: Zorg dat de juiste grootboekrekeningen worden gebruikt
* **BTW-codes**: Controleer of de BTW-codes correct zijn ingesteld

## Problemen oplossen

### "API-sleutel wordt niet geaccepteerd"

* Controleer of je alle benodigde gegevens hebt ingevuld
* Vraag je Yuki-beheerder om de API-toegang te controleren
* Controleer of je Yuki-pakket API-toegang ondersteunt

### "Geen toegang tot administratie"

* Controleer of je toegang hebt tot de juiste administratie
* Vraag je accountant om de rechten te controleren
* Controleer het administratienummer

### "Factuur wordt niet verstuurd"

* Controleer of de klant bestaat in Yuki
* Controleer of alle verplichte velden zijn ingevuld
* Controleer de foutmelding voor specifieke details

## Tips

* Overleg met je accountant voordat je de koppeling activeert
* Test met een kleine factuur om de werking te controleren
* Houd een logboek bij van verstuurde facturen

## Koppeling verwijderen

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

Informeer je accountant als je de koppeling verwijdert, zodat zij hiervan op de hoogte zijn.