> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.robaws.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Hoe werkt de Yuki koppeling?

[Yuki](https://www.yukisoftware.com/) is één van de boekhoudprogramma's waarmee Robaws een rechtstreekse integratie heeft.
Door de API-koppeling tussen Robaws en **Yuki** werken deze pakketten naadloos samen.  
Je kan vanuit Robaws jouw volledige boekhouding voorbereiden, zodat deze één op één overgenomen wordt in Yuki.

*Navigeer snel naar:*
* [Mogelijkheden](#2-mogelijkheden-met-deze-koppeling)
* [Hoe activeer ik de koppeling?](#2-activeren-van-de-koppeling)
* [BTW tarieven koppelen](#2-btw-tarieven-koppelen)
* [Grootboekrekeningen importeren](#2-grootboekrekeningen-importeren)
* [Instellingen](#2-instellingen)
* [Foutmeldingen](#2-foutmeldingen)


## Mogelijkheden met deze koppeling

De koppeling tussen Robaws en Yuki ondersteunt heel wat mogelijkheden:
* [Aan- en verkoopfacturen doorsturen](https://support.robaws.com/nl/article/hoe-verstuur-ik-mijn-aan-en-verkoopfacturen-naar-de-boekhouder-1o1pkv7/) naar Yuki
* [Betaalstatus aan- en verkoopfacturen terugkoppelen](https://support.robaws.com/nl/article/flow-synchroniseren-betaalstatussen-uit-boekhoudprogramma-tzukcc/) naar Robaws
* [Grootboekrekeningen importeren](https://support.robaws.com/nl/article/grootboekrekeningen-1bnmhku/)/synchroniseren met Robaws

## Activeren van de koppeling

|| Om van de API koppeling gebruik te kunnen maken, moet in Yuki de module "Yuki Sales Webservice" geactiveerd zijn of inbegrepen zijn in je bundel.

Via **instellingen > integraties > Yuki** kan je de koppeling activeren.
Je doorloopt volgende stappen:

1. Maak een 'webservice sleutel' aan in uw Yuki portaal. (meer info via volgend artikel op de support van Yuki: [artikel Yuki webservice sleutel](https://support.yuki.be/nl/support/solutions/articles/80000787687-hoe-leg-ik-een-koppeling-)
2. Klik in Robaws op 'API key toevoegen'
3. Kies de juiste Yuki-omgeving België of Nederland
4. Vul de API Key in en klik op toevoegen
5. Kies uit de lijst met mogelijke administraties
6. Klik op 'verbinden met Yuki'

Nadat je deze stappen doorlopen hebt, is de koppeling tussen Robaws gelegd.  Om de facturen correct door te sturen, zet je nog volgende stappen:
* zet de [instellingen van Yuki](#2-instellingen) juist
* [koppel de BTW-tarieven](#2-btw-tarieven-koppelen)
* [importeer de grootboekrekeningen](#2-grootboekrekeningen-importeren).

||| Indien je in Robaws meerdere bedrijven hebt, kan je met elk bedrijf afzonderlijk een aparte koppeling leggen door linksboven in de instellingen op 'default' te klikken.

|| API beperking vanuit Yuki: Elk domein heeft standaard gratis 1000 webservice aanroepen (calls) per dag beschikbaar. Mits betaling kan dit verhoogd worden, informeer hiervoor bij Yuki.

## BTW tarieven koppelen

In Robaws staan bepaalde BTW tarieven actief in je omgeving.  Deze moeten correct met Yuki gekoppeld worden. 

1. Ga in Robaws naar instellingen > algemeen > BTW tarieven > klik een BTW tarief open
2. Als Yuki gekoppeld is zal je hier een link zien staan naar Yuki > klik op het potloodje
3. In Yuki heeft elk BTW tarief een code, geef hier de correcte code in en het percentage
 ![Yuki BTW tarief koppelen](https://storage.crisp.chat/users/helpdesk/website/-/e/a/d/f/eadf6dec760ec000/image_bqt6mk.png =750x161)

**Opgelet:** Maak je gebruik van een BTW-tarief verlegd? Dan moet je het percentage van het BTW tarief in Robaws op 0% zetten en moet je in Yuki het percentage correct instellen. Door de koppeling met de juiste BTW-code wordt in Yuki juist uitgerekend.

## Grootboekrekeningen importeren

|| Werk je met meerdere bedrijven? Dan worden de geïmporteerde grootboekrekeningen aan het juiste bedrijf gekoppeld: een grootboekrekening die voor een specifiek bedrijf geïmporteerd wordt, is enkel bij dat bedrijf beschikbaar, en grootboekrekeningen die niet aan een specifiek bedrijf gekoppeld zijn, blijven bij alle bedrijven beschikbaar. Meer uitleg in [Gebruik van grootboekrekeningen](/nl/article/gebruik-van-grootboekrekeningen-1bnmhku/).

Je kan de [grootboekrekeningen](https://support.robaws.com/nl/article/gebruik-van-grootboekrekeningen-1bnmhku/) uit Yuki in Robaws importeren, om ze al toe te wijzen aan bepaalde artikelen, leveranciers, klanten, ...

1. Ga naar instellingen > algemeen > grootboekrekeningen
2. Zet het vinkje aan, en klik door.
3. Als Yuki gekoppeld is zal je bovenaan een actieknop zien om de grootboekrekeningen te importeren.  Klik hierop, de GBR worden uit Yuki geïmporteerd.
4. Activeer de instellingen.
5. Nu kan je deze GBR [gebruiken in Robaws](https://support.robaws.com/nl/article/gebruik-van-grootboekrekeningen-1bnmhku/).

## Instellingen

| Instelling | Uitleg |
| ---- |
| Standaard grootboek verkoop | Hier kan je de standaard [grootboekrekening](https://support.robaws.com/nl/article/gebruik-van-grootboekrekeningen-1bnmhku/) instellen voor verkoopfacturen. Op een artikel of klant kan je een afwijkend grootboekrekening bijhouden. Je kan op een factuurlijn manueel ook de grootboekrekening aanpassen.   Het is NIET mogelijk om dit leeg te laten, Yuki verwacht altijd een GBR. |
| Standaard grootboek aankoop | Hier kan je de standaard [grootboekrekening](https://support.robaws.com/nl/article/gebruik-van-grootboekrekeningen-1bnmhku/) instellen voor aankoopfacturen. Op een artikel of leverancier kan je een afwijkend grootboekrekening bijhouden. Je kan op een factuurlijn manueel ook de grootboekrekening aanpassen.  Het is NIET mogelijk om dit leeg te laten, Yuki verwacht altijd een GBR. |
| [Synchroniseer betaalstatus aankoopfacturen/verkoopfacturen](/nl/article/flow-synchroniseren-betaalstatussen-uit-boekhoudprogramma-tzukcc/) | Als je deze opties aanzet, zal Robaws 's nachts informatie gaan opvragen bij Yuki over de openstaande bedragen. Deze zullen dan bijgewerkt worden in Robaws. Zo kan je op een eenvoudige manier de betaalopvolging doen vanuit Robaws. |
| Automatisch inboeken (IBAN verplicht) | Als je deze optie uit zet, ben je niet meer verplicht om de IBAN en BIC op de leverancier van aankoopfacturen in te vullen.  Echter is het wel mogelijk dat de factuurdatum verspringt, tijdens het manueel inboeken in Yuki. (Dit is gedrag van Yuki zelf.) |


## Foutmeldingen

| Foutmelding | Uitleg | Oplossing |
| ---- |
| [Yuki] Ongekend probleem: [Yuki] Active purchase taxcode with percentage "21.0" and type "1" for date "01/03/2026 00:00:00" cannot be found. | De BTW codes zijn niet correct met elkaar gekoppeld. | Controleer in Robaws welk BTW tarief gekoppeld staat, en kijk dan in Yuki na of deze BTW codes van Yuki wel degelijk voor verkoop of aankoop is, en of het overeenkomt met het BTW tarief in Robaws. |
| [Yuki] Ongekend probleem: [Yuki] De transactieregels kunnen niet worden geboekt omdat de grootboekrekening (600000 Aankopen van grondstoffen) is uitgeschakeld. | In Yuki is de GBR uitgeschakeld om boekingen te ontvangen. | Schakel in Yuki dit GBR in voor API boekingen |
| The domain is not licensed for this functionality | Deze foutmelding houdt in dat je geen toegang hebt tot de verkoop functionaliteiten. | Je kan een bundel kiezen waar verkoop in de licentie zit, of je kan een de accountancy feature aanleggen via je accountant. Neem contact op met Yuki om dit op te lossen. |


Daarnaast zijn er 2 zaken die niet kunnen in de koppeling met Yuki omwille van de beperkingen in Yuki en de API van Yuki:

* **Aankoopfactuur met verschillende BTW-tarieven:** Yuki kan geen aankoopfacturen met verschillende BTW-tarieven verwerken. Je zal deze factuur moeten opsplitsen in Yuki.
* **Financiële korting:** We kunnen via de API geen specifieke financiële korting meegeven. We geven dit meer als een extra lijn op de factuur die in Yuki aangemaakt zal worden.