Yuki API link

Modified on Wed, 5 Mar at 11:51 AM

What is an API?

An application programming interface (API) is a collection of programming jobs (often indicated as interfaces) that calls the functions of a program. It is a method that makes it possible for two programs to communicate with each other.


So this API makes it possible for applications or services of external parties to exchange information with Yuki for the domains in which you have access rights.


ATTENTION!

For your safety Yuki will improve her SOAP web services security from the 1st of April 2019.

Our links will then only accept connections with TLS 1.2 security or higher. For most of the link implementations (this is for applications that are connected with Yuki in order to send or retrieve data) no problems will arise. 


This article describes the capabilities of a Yuki API link and how to establish an API link.


What can I do with the Yuki API link?


Financial monitor widgets

The financial monitor offers several charts with respect to the financial data in Yuki. Yuki makes these charts available as widgets so for example, they can be shown on an own intranet.


For a detailed description of the financial monitor widgets see article Financial monitor widgets.


Web services

By default, each domain has 1,000 web service calls (calls) per day available for free.


To increase the number of available web service calls, a user with the “Portal administrator” role has the option to add one of the following accountant features to the domain

  • Yuki Webservice (from 1,000 to a maximum of 5,000 calls per day)
  • Yuki Webservice Extended (from 5,000 to a maximum of 10,000 calls per day).


ATTENTION!

  • In a domain with the Minimal version of Yuki, the Sales web service (1,000 calls per day) must be added to the domain as an accountant feature. In all other bundles, the Sales web service is included for free.
  • To use the Purchase web service, a formal request must be sent by email to [email protected].
    You will then receive a Client ID/Secret by email from Yuki. You will need this in addition to the API key for authentication in order to gain access to the Purchase web service.


At this moment there are twelve web services available. These web services contain one or more methods for the exhange of information:

ATTENTION!

In case of illegal use we can block the access to our API.


How do I establish an API link?

The first step is to check whether there is already a link with the software with which you want to link Yuki. You can find all links here:  IntegrationsHere you will find information about the specific link.

Is the software with which you want to connect not yet listed? Then we recommend asking the external party if they want to set up a link with Yuki. Yuki has a completely open API environment, which makes it very easy for other software to connect to Yuki.


If the software you want to link with already has a link, some settings need to be defined in that software or with the third-party provider of the link. 

To give external software access to information in Yuki, you have to generate a web service API key and Administration ID (or have it generated) in Yuki with which the external software can access a Yuki domain without logging in.


This web service API key can be used to give a web service access on portal, domain or administration level.

The (access) rights to webservices in a domain or administration are leading and 'overrule' the (access) rights to web services as they are set on portal level.


For a detailed description of web service access at portal level, see article Set up web services in portal.

For a detailed description of web service access at domain or administration level, see article Set up web services in domain and/or administration.


Source code examples of links with the Yuki API



At the bottom of this article you can download the 'voorbeeldbestanden resultaten webservices.zip' file.

This file contains a dozen examples of XML results of web services.



Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article