Setup blueprint with Business Central Cloud

E-mail notifications

Adrian Ursu

Posted on 07/07/2025 09:31:08

Hi guys,

I am trying to set up an integration with Business Central cloud.

I have read the documentation and (I believe) I have managed to set up the right Authentication (OAuth 2.0 Service to Service).The Dynamicweb Scode unit/App is installed in Business Central.
I have managed to install the Blueprints which successfully generated 4 sets of activities.
I am now struggling with defining the right endpoints.
I have tried following these instructions:
https://doc.dynamicweb.dev/manual/dynamicweb10/integration/guides/plugin-unit-integration/bc-cloud.html

https://doc.dynamicweb.dev/manual/dynamicweb10/integration/guides/blueprints/bc-odata-default-api.html

https://doc.dynamicweb.dev/manual/dynamicweb10/integration/guides/blueprints/bc-odata-v4-blueprint.html

https://doc.dynamicweb.com/documentation-9/integration/integration-framework/endpoint-management#sideNavTitle1-1

And I have to admit I am a bit confused. I have managed to make some of the SOAP requests work (Languages request works, the Customers request does not return anything), but I am not sure if the Blueprint is supposed to use the SOAP requests or other requests.
In the Business Central OData default API blueprint section of the documentation, there is a mention for "Select predefined source endpoint" but I can;t figure out if there is a step-by-step guide on how to define these predefined endpoints for this specific use case. I see a lot of formats for the URL, obviously each of them for a different purpose.
Can anybody share a simple "BC integration for dummies" guide and best practice?

Thank you,

Adrian

Replies

Rasmus Sanggaard

Posted on 07/07/2025 10:09:05

Hi Adrian,

Let me see if I can help clear up some of your confusion. Overall, there are two approaches—either through the code unit using the SOAP web services or through OData endpoints / API.

In very simple terms, you do not want to use SOAP with Business Central Cloud. It's a deprecated technology and should only be used if the project requires a Live Integration setup.

The Blueprints provide a starting point for setting up batch integration with the most common entities in Business Central—either using the API or OData v4 endpoints. The latter gives you access to almost all fields in BC, but comes with some caveats. All of this is explained in the documentation:

The predefined endpoint and how to set it up is explained at the top of the page. Please take a look at the guide again, as everything you’re looking for is covered there.

Have you looked at our implementation tutorials? The tutorial also includes a "how to integrate with BC" guide:
https://doc.dynamicweb.dev/documentation/implementing/tutorials/creating-an-integrated-webshop.html

BR
Rasmus Sanggaard

Adrian Ursu

Posted on 07/07/2025 10:15:48

Hi Rasmus,

Thank you very much for the details. I completely missed the Tutorial.
It should clarify my blindspots.
I will get back if I still have any questions.

Thank you,

Adrian

Adrian Ursu

Posted on 07/07/2025 11:06:41

Hi Rasmus,

The Tutorial clarified all the blindspots regarding the Endpoints.

One question, though. The Blueprint is supposed to also have the mappings, right? In my setup, I have the activities but the Mappings are gone:

In the Tutorial, I see that a prerequisite is installing the OdataProvider and EcomProvider, which, in my case (clean solution), seem to be already installed.
I have created the mappings manually for customers, and the data was imported.
Is there anything else I am missing?

Thank you,

Adrian

Rasmus Sanggaard

Posted on 07/07/2025 11:17:12

Hi,

Yes, it is supposed to look like this:

So you're likely facing some kind of bug, possibly related to Schema Management. Please contact support—they will assist you further.

BR Rasmus Sanggaard

You must be logged in to post in the forum

Developer forum

Setup blueprint with Business Central Cloud

Replies