Je Yuki-webservicesleutel aanmaken
In Yuki maak je eenmalig een webservice API-sleutel aan en plak je die in Schakel. Kost ongeveer een minuut. De sleutel hoort bij je Yuki-domein, dus als hij meerdere administraties bereikt, kies je daarna in Schakel welke.
Wat je overhoudtEen webservice API-sleutel uit je eigen Yuki-domein, ingevuld in Schakel.
- 01
Ga naar Instellingen, Webservices
Log in op Yuki en klik linksonder in de zijbalk op Instellingen. Klik daarna in de linkerkolom, onder Integraties, op Webservices. Je ziet nu de pagina Webservice API-sleutels met de sleutels die al bestaan.
- 02
Voeg een sleutel toe
Klik linksboven de lijst op de plusknop. Zet bij Opmerking de naam Schakel, zodat je later in de lijst ziet waar de sleutel bij hoort, en klik op Bewaren.
- 03
Kopieer de sleutel naar Schakel
Kopieer de API-sleutel uit de nieuwe regel en plak hem in Schakel op de pagina Verbindingen. Schakel probeert de sleutel meteen en laat zien welke administraties eraan hangen. Zijn dat er meerdere, dan kies je daar de administratie waarin geboekt moet worden.
Goed om te weten
- De regel in Yuki laat per sleutel zien welk type, welke administratie en welke rechten eraan hangen. Boekt Schakel straks in de verkeerde administratie, dan is dat de plek om het te controleren.
- Yuki telt standaard 1000 webservice-calls per dag per domein. Bovenin dezelfde pagina staat Aantal webservice-calls per dag, waar je je verbruik ziet. Meer calls is bij Yuki een betaalde uitbreiding, die je zelf bij Yuki regelt.
- Geen enkele Yuki-API geeft je BTW-tarieven terug. In de instellingen van de koppeling typ je ze daarom zelf over uit Yuki, onder Instellingen en BTW-tarieven: per situatie een type en een percentage. Bestaat dat paar niet in jouw domein, dan annuleert Yuki de hele factuur, niet alleen de regel.
- Voor een marktplaatskoppeling maak je in Yuki ook een betaalmethode aan die naar een tussenrekening wijst. Zonder die betaalmethode landt elke verkoop op debiteuren en blijft daar staan, terwijl Yuki gewoon meldt dat het gelukt is. Schakel laat de koppeling daarom pas opslaan als de betaalmethode echt bestaat.
- Een factuur met een datum vóór de startdatum van je administratie wordt door Yuki als beginbalans geboekt: geen omzet en geen BTW, terwijl elke laag meldt dat het gelukt is. Schakel slaat die bestellingen daarom over in plaats van ze stil verkeerd te boeken.
Als er iets misgaat
- Schakel zegt dat de sleutel niet werkt.
- Een half gekopieerde sleutel is de gewoonste oorzaak. Kopieer hem opnieuw uit de regel op de pagina Webservice API-sleutels en plak hem er nog een keer in. Staat er niets in de lijst, dan is de sleutel niet bewaard.
- Er worden geen facturen geboekt.
- Waarschijnlijk is de koppeling nog niet compleet ingesteld. Zonder omzetrekening, tussenrekening, betaalmethode en alle vier de BTW-codes boekt hij bewust niets. Je vindt ze in de instellingen van de koppeling.
- Yuki weigert mijn facturen in dollars of ponden.
- Vreemde valuta is bij Yuki een betaalde contractoptie. Zit die niet in je contract, dan weigert Yuki elke factuur in een andere valuta dan die van je domein. Dat regel je bij Yuki, niet bij ons.
- Yuki annuleert een factuur zonder duidelijke reden.
- Bijna altijd een BTW-code die in jouw domein niet bestaat. Yuki zoekt de code op via het paar type en percentage, en vindt hij dat paar niet, dan gaat de hele factuur eraan. Vergelijk je vier codes met de lijst in Yuki onder Instellingen, BTW-tarieven.
Koppelingen die je Yuki-toegang gebruiken
Heb je de sleutels binnen, dan gaan ze hierheen. Elke koppeling hieronder praat met Yuki.
Loop je vast op een stap?
Schermen verschuiven weleens. Ziet het er bij jou anders uit dan op de schermafbeeldingen, stuur ons dan een bericht. Dan kijken we mee en passen we de pagina aan.