Install the Yokoy connector in Business Central Cloud

For Microsoft Dynamics 365 Business Central Cloud implementations, you can choose to install the Yokoy Spend Management Connector from the AppSource or as an extension.

The extension needs to be registered and configured with Microsoft Entra to allow Yokoy access to the Business Central API endpoints.

To set up the connector for Business Central Cloud:

To install the Yokoy connector, search for the extension in the AppSource by typing Yokoy and click Get it now.

This installs the extension in your Microsoft 365 Dynamics Business Central tenant.

To install the Yokoy connector as an extension, you need to have access to the connector package (.app). You must open a service request to obtain access to the connector package.

Once you have access to this file, you can proceed to install the app using the Extension Management page.

The extension package uses these ID ranges for the objects listed below:

Extensions may be uninstalled automatically after a Business Central update without data loss. See Uninstalling the extension.

Since Business Central is responsible for retrieving data from Yokoy, you need to create the web service in Business Central to handle this process.

First you need to register an app on the MS Azure portal for the Yokoy connector.
See Register an app in the Microsoft identity platform for guidance.

Create the basic definition of the application by configuring the Overview, Authentication, Certificates & secrets, and API permission sections.

Overview section:

Authentication tab:

Click + Add a platform.

API permissions section:

Certificates & Secrets section:

Create a new client secret. We recommend you set the expiry as 24 months. Copy the Value and Secret ID.

Enter “Microsoft Entra Applications” in the Business Central global search tool (top right corner) to access the application setup.

You need to create a new application in Business Central:

You need to set up the application so it has super admin permissions.

More specifically, you need to add these permission sets in the User Groups section in the Microsoft Entra Application card you’ve just created.

Once the initial installation has been completed, standard users need the Yokoy BC permission set (PERMISSIONSET YKY) to make any subsequent changes to the integration and synchronize data.

Next, you should configure the Yokoy Integrations Setup page in Business Central before continuing to set up the expense or invoice export in Yokoy.

You need to add the web services in the Business Central for each module you plan to integrate (i.e. one web service for Yokoy Invoice and another for Yokoy Expense).

To do this:

Yokoy is responsible for exporting the expense data to the general ledger in Business Central. Expense receipts and attachments can be attached to journal entries as required.

If the company plans to process credit notes, you need to have enabled credit notes for the legal entity.

You need to set up the Expense export tab (Admin > Integrations, Expense export) to send expense data (expense, card transaction, travel expenses) to Business Central.

You can’t use the Yokoy connector to export per diems/mileage separately.

To do this:

Make sure to disable any popup blockers in your browser window. MS Dynamics authentication uses a popup window to make the authentication request to MS Entra.

Once connection has been established, you can configure the export settings:

To process invoices with Business Central, Yokoy uses webhooks to notify Business Central about changes in the document status. There is a specific invoice export facility in Yokoy to handle the webhook response. Currently, the webhooks are synchronous. This means that the provider must wait until the webhook has finished processing to get a response.

To allow Business Central to connect to Yokoy, you need to set up the integration in Yokoy:

You need to do this for each legal entity that you want to link to a Business Central company.