Yuki API documentatie

Developer? Voor het ontwikkelen van een nieuwe koppeling of updaten van een bestaande koppeling verwijzen we je graag door naar onze API documentatie voor alle technische info.

Wat is een API? 

Een application programming interface (API) is verzameling programmeeropdrachten (vaak ook als interfaces aangeduid) die de functies van een programma aanroepen. Het is een methode die het mogelijk maakt om twee programma's met elkaar te laten communiceren.

Deze API maakt het dus mogelijk om applicaties/diensten van externe partijen informatie met Yuki uit te laten wisselen op de domeinen waarin je toegangsrechten hebt.

AANDACHT!

Voor jouw veiligheid verbetert Yuki vanaf 1 april 2019 haar SOAP-webservices beveiliging. 

Onze koppelingen zullen dan enkel verbindingen met beveiliging TLS 1.2 en hoger accepteren. Dit levert voor de meeste koppeling implementaties (dit is voor applicaties die verbonden zijn met Yuki om data te versturen of op te halen) geen problemen op.

Zelf een koppeling bouwen?
Om te starten met het ontwikkelen van een koppeling met Yuki kan je onze API-documentatie raadplegen.
Via onze webservices is het mogelijk om facturen aan te maken, te beheren en te versturen via Peppol. Hiervoor dien je jou domein eerst aan te melden op het peppol netwerk:
Peppol via Yuki - Registreren en afmelden

Technische set-up

Om te kunnen ontwikkelen heb je het volgende nodig:

• Een Yuki-domein (productie of test).
  
  
• Een API-sleutel (Application Key) die je kan aanmaken binnen het domein van de klant of in je testomgeving.
  
  
• De Webservices URL: https://api.yukiworks.be/ws/ (of .nl voor Belgische domeinen).
  
  
• Een omgeving zoals Postman of een eigen applicatie waarmee je SOAP- of REST-verzoeken kan verzenden.
  
  
• Authenticatie gebeurt via de SOAP-header met jouw ApplicationKey en eventueel UserToken als dat vereist is.
  
  
  
  

Testomgeving aanvragen

Wil je eerst testen? Dan kan je een testdomein aanvragen door een e-mail te sturen naar koppelingen@yuki.be met de volgende informatie:

• Welke functionaliteiten of webservices je wil gebruiken, en het doel van de koppeling.
  
  
• Of het gaat om een koppeling voor één specifieke klant, of een integratie voor meerdere klanten.
  
  
• Het e-mailadres waarmee je wil inloggen in de testomgeving.
  
  

Beschikbare webservices

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

• Accounting webservice
  • Ophalen van financiële rapportage
  • Aanmaken van memoriaalboekingen
• AccountingInfo webservice
  • Opvragen informatie over grootboekrekeningen en transacties
• Sales webservice
  • Aanmaken van verkoopfacturen
• Upload webservice 
  • Aanleveren van documenten
• Archive webservice
  • Ophalen en insturen van documenten
  • Inzicht (via app) in het archief.
• PettyCash webservice
  • Importeren van kastransacties
• Contact webservice
  • Contacten opzoeken, aanmaken en wijzigen
• Project webservice
  • Aanmaken en updaten van projecten

Kosten Yuki webservices

Op dit moment bieden wij onze webservices aan op basis van een staffel met een maximum aantal webservice calls per dag per domein.

Bij onrechtmatig gebruik van onze webservices kunnen wij de toegang tot onze API blokkeren.