Webservices in domein en/of administratie instellen

Het is afhankelijk van de gekozen bundel (en evt. extra toegevoegde features) en de rol(len) die je hebt als gebruiker in het domein welke instellingen je in een domein kunt vastleggen.

Je kunt in Yuki een integratie realiseren met Mollie (online betalingsprovider), webservices (methodes voor gegevensuitwisseling met applicaties van externe partijen), Peppol (e-facturering) en de Rabobank (automatische aanlevering van banktransacties. 

Een webservice bevat één of meerdere methodes voor de uitwisseling van informatie met applicaties/diensten van externe partijen. Je kunt hierbij o.a. denken aan financiële gegevens, aanleveren van gegevens van verkoopfacturen en het benaderen van en uploaden naar het Yuki archief. 

Alleen een gebruiker met een 'Backoffice' rol in het domein of de rol 'Directie' kan d.m.v. de webservice API-sleutel en Administratie-ID de (toegangs)rechten tot webservices in het domein en/of de administratie(s) instellen.

Toegang tot Webservices

Alle instellingen voor web services zijn gecentraliseerd binnen je domein en onderverdeeld in logische categorieën.

Om toegang te krijgen tot deze instellingen:

• klik je op het icoon Instellingen in de navigatiebalk
• klik je vervolgens in het nu geopende scherm in de sectie Integraties op Webservices.

Webservice koppelingen

Elk domein heeft standaard gratis 1000 webservice aanroepen (calls) per dag beschikbaar.

Mocht er behoefte zijn aan meer webservice aanroepen (calls) dan heeft een gebruiker met de rol 'Portaalbeheerder' de mogelijkheid om één van de volgende accountant features aan het domein toe te voegen:

• Yuki Webservice (vanaf 1.000 tot maximaal 5000 calls per dag)
• Yuki Webservice Uitgebreid (vanaf 5.000 tot maximaal 10.000 calls per dag).

Beschikbare webservices
Op dit moment zijn er twaalf webservices beschikbaar. Deze webservices bevatten één of meerdere methodes voor de uitwisseling van informatie:

• Accounting webservice: Ophalen van financiële rapportage (zoals openstaande posten en het huidige saldibalans en Aanmakenvan memoriaalboekingen.
• AccountingInfo webservice: Opvragen informatie over grootboekrekeningen en transacties
• Sales webservice: Aanmaken van verkoopfacturen
  
  LET OP!
  Bij het aanleveren van verkoopfacturen vanuit bijv. een Webshop moet de bundel Small, Medium, Large of Unlimited door een gebruiker met de rol 'Directie' zijn gekozen via de Yuki Store in het domein omdat op basis van de data vanuit de koppeling de verkoopfacturen in Yuki worden gegenereerd en verwerkt.
  
  LET OP!
  In een domein met de Minimal versie van Yuki moet de Sales webservice (1.000 calls per dag) als accountant feature aan het domein worden toegevoegd. In alle andere bundels is de Sales webservice gratis inbegrepen.
  
  
• Upload webservice: Ophalen en aanleveren van documenten
• Archive webservice: Ophalen en insturen van documenten en Inzage (via app) in het archief.
• Contact webservice: Ophalen van relatiegegevens en Relatie bijwerken of aanmaken.
• PettyCash webservice: Importeren van kastransacties
• Domains webservice: Aanmaken van actieve en proefdomeinen door accountant en Ophalen en aanmaken gebruikers in een domein.
• Projects webservice: Aanmaken van nieuwe projecten (dossiers) en Aanpassen van bestaande projecten (dossiers).
• Backoffice webservice: Controleren van openstaande vragen voor backoffice in administratie, Ophalen van backoffice workflow van administratie, Controleren van specifieke backoffice rollen van portaalgebruikers in domein en Specifieke backoffice rollen van portaalgebruikers in domein bijwerken.
• VAT webservice: Ophalen van statussen van ingediende btw-aangiften in Yuki (vanuit AdminPulse).
  
  Voor een uitgebreide beschrijving van de koppeling tussen Yuki en Adminpulse, zie artikel Status ingediende btw-aangifte doorsturen vanuit Yuki.
  
  
• Purchase webservice: Aanmaken van inkoopfacturen.
  
  LET OP!
  Om gebruik te kunnen maken van de Purchase webservice moet per e-mail een formeel verzoek worden verstuurd naar support@yuki.nl.
  Vervolgens zal je van Yuki per e-mail een Client-ID/Secret ontvangen. Deze heb je naast de API-sleutel nodig voor de authenticatie om zodoende toegang te verkrijgen tot de Purchase webservice.

Voor een uitgebreide beschrijving van alle beschikbare webservices in Yuki zie artikel Yuki API koppeling. 

Toegang webservice koppelingen

Voor een succesvolle koppeling met externe software zijn de volgende stappen vereist:

1. API-sleutel en Administratie-ID:
   Deze moeten in Yuki worden gegenereerd om externe software toegang te verlenen zonder dat inloggen vereist is.
2. Rechtenbeheer:
   De toegangsrechten voor webservices ingesteld op domein- of administratieniveau zijn leidend en 'overrulen' dus de instellingen op portaalniveau.
3. Toegang realiseren tot externe software:
   API-sleutel en/of de Administratie-ID toevoegen in software

Als het software pakket waarmee je wilt koppelen al een koppeling heeft, dan moeten een aantal instellingen vastgelegd worden in die software of bij de derde partij die de koppeling voorziet. 

Stap 1. Webservice API-sleutel (WebserviceAccessKey) en Administratie-ID genereren

De webservice API-sleutel en Administratie-ID kunnen vanuit verschillende plaatsen in Yuki worden gegenereerd:

• klik op het icoon Wissel domein boven de navigatiebalk
• klik op Mijn domein
• klik op de naam van de administratie
• klik vervolgens in het nu geopende scherm op Webservices.
  OF
• Klik op het icoon Start in de navigatiebalk op het icoon Start
• klik op Mijn domein
• klik op de naam van de administratie
• klik vervolgens in het nu geopende scherm op Webservices
  OF
• klik op het icoon Instellingen in de navigatiebalk
• klik vervolgens in het nu geopende scherm op Webservices.

TIPS!

• Wil je meerdere administraties koppelen dan moet je meerdere webservice API-sleutels aanmaken.
• Vertrouw je de beveiliging van een API-sleutel niet meer, genereer dan een nieuwe!

Het volgende scherm wordt geopend:

Klik op de knop + om voor het domein of de administratie de webservices te activeren en een webservice API-sleutel te genereren.

Het volgende scherm wordt geopend:

Stap 2. Rechtenbeheer

Geef in het bovenstaande scherm aan of je een webservice API-sleutel wilt genereren voor een 'Domein' of een 'Administratie' (selecteer ook de juiste administratie), selecteer tot welke webservices je (toegangs)rechten wilt verlenen (alle webservices of een selectie daarvan) en klik op de knop Bewaren.

TIPS!

• Selecteer alleen specifieke webservices tot welke je toegang wilt verlenen wanneer je zelf een koppeling bouwt. 
• Wil je een koppeling leggen met een bestaand software pakket dan moet je 'Alle webservices' selecteren.
  
  

Stap 3. Toegang realiseren tot externe software

Kopieer vervolgens de API-sleutel en/of de Administratie-ID om deze in je toepassing te gebruiken. In veel software pakketten is het veld 'Toegangscode' aanwezig.