Skip to content
English
Contact us
  • There are no suggestions because the search field is empty.

Integration setup for Dynamics 365 Business Central - Part 2: 365 Dynamics Business Central

How do I set up an integration between CleanManager and Dynamics 365 Business Central?

Note

CleanManager only supports Single tenant Business Central with authentication through Microsoft Azure.

 

To be able to integrate CleanManager with Dynamics 365 Business Central, the following three accesses are required:

  • Admin access to Azure
  • Admin access to Dynamics 365 Business Central
  • Admin access to CleanManager

Should you not have admin access to one of these three software, it is vital that you contact those who have, since without, it will not be possible to achieve a successful integration.

 

The required information from Dynamics 365 Business Central, for the integration to Cleanmanager is:

  • Environment
  • workflowCustomers URL
  • Permissions for CleanManager

 

Read more about the successful integration of Dynamics 365 Business Central with CleanManager: 



 

 

2. Part: This is how you set up Dynamics 365 Business Central for an integration with CleanManager

This part of the guide will focus on how to acquire the name of your Environment, as well as how to grant permission to CleanManager, to integrate with Dynamics 365 Business Central.

number_1_copy.png
Start by clicking on ?, followed by Help & Support 

2.png

number_2_copy.png

Scroll down to Report a problem, where you will find your Environment.

As a standard, the name of the Environment is Production. Should this not be the case, copy the name. 

2.png

number_3_copy.png
Insert your Environment under Environment in CleanManager
Environment.png
number_4_copy.png
Search thereafter for Azure Active Directory and click on it

3.png

number_5_copy.png
Click on + New

4.png

number_6_copy.png
Under Client ID insert your Application (client) ID from Azure
5.png
number_7_copy.png

Under Description we recommend writing CleanManager. This is to make it easier, in case of trouble transferring data, to trouble search.

6.png
number_8_copy.png
Set the State to Enabled
7.png
number_9_copy.png
Scroll down to the button of the page and Add a new permission under User Permission Sets
8.png
number_10_copy.png

Search the list for D365 Full access and click on OK.

Check the top right corner, if it says ✔Saved before proceeding with the following steps.

9.png

 

INFO:

If you do not wish to grant CleanManager full access to your Dynamics 365 Business Central account, it is important that CleanManager gets access to the following:

  • Customers
  • workflowCustomers
  • Items
  • Sales invoices
  • Sales invoice lines

  

 

 

Part 2.1 This is how you set up Web Services in Business Central

In this part, we will go through the process of how you find your workflowCustomer OData V4 URL.

number_1_copy.png
Search for Web Services in the search bar and click on it

2.2.1.png

number_2_copy.png

Look for workflowCustomers with the Object ID 6408 in the list.

 

If you cannot find workflowCustomers with the Object ID 6408, follow the steps from step 5 onwards. 

2.2.2.png

number_3_copy.png

Copy the OData V4 URL

Before proceeding to the next part, make sure that it says ✔Saved in the top right corner.

2.2.3.png
number_4_copy.png

Insert the link in your CleanManager under workflowCustomers

workflowcustomers.png

number_5_copy.png

In case you cannot find workflowCustomers with the objekt id 6408:


Click on + New and insert the following information:

  • Object Type: Page
  • Object ID: 6408
  • Service Name: workflowCustomers
  • Check the box published

2.2.5.png

number_6_copy.png

After the link (OData V4 URL) has appeared, copy it. Before proceeding to the next part, make sure that it says ✔Saved in the top right corner.

2.2.3.png

Note

From time to time, errors may occur in the link, when copying it directly from Business Central.

To avoid those errors, we recommend copying the link in the following way: 

number_7_copy.png
After the link (OData V4 URL) has appeared, click on it
2.2.3.png
number_8_copy.png

This will lead you to the following page.

Click on Cancel.

Cancel.png
number_9_copy.png
Copy the link 
Cancel_copy.png

 

 

 

 

Part 3: This is how you complete your integration set up between CleanManager and Business Central

number_1_copy.png
Insert the OData V4 URL link, which you copied under Web Services in Business Central, under workflowCustomers in CleanManager

workflowCM.png

number_2_copy.png
Click thereafter on Saved

Gem.png

number_3_copy.png

After the integration has been completed, choose the company, which you want to integrate to

Company.png

number_4_copy.png

Make sure that the company name fits the one found in the URL of the workflowCustomers

URL.png

number_5_copy.png

Choose if you want to use the item names from Business Central or if you want to use the Cleaning types, for invoicing and click on Save

Item_names.png
number_6_copy.png
Click on Customers in CleanManager, under Integrations and choose Business Central
Customer_list.png
number_7_copy.png

Click thereafter on Invoicing, under Integrations and choose Business Central 

Billing_list.png

 

NOTE

When your Client Secret expires, go back to integrations in CleanManager, click on Business Central and insert a new Client Secret. 

To be able to do this, you will have to log into Azure as an Admin, go to App registrations and find CleanManager. 

Click on it and afterwards go to Certificates and secrets. Create a new Client Secret and insert it into CleanManager.