Commerce 365 is a Microsoft Dynamics 365 Business Central extension & integration framework. Commerce 365 is developed from an ERP perspective, which means that the main thought behind all development is; customers use their Dynamics 365 Business Central system for everything, so for e-commerce, we should just extend that system with what is missing.
In short; Commerce 365 adds everything that is missing from standard Business Central, and it takes care of all Magento integration.
Commerce 365 users never have to logon to the Magento backend for everything related to items, customers, inventory, prices, sales orders, shipments, invoices, etc.. Only in case the site/shop also has CMS pages, blogs or other non-ERP content they have to access the Magento backend.
Below is a screenshot of a Commerce 365 item card, which might help to illustrate this concept:
Below is the list of what Commerce 365 expects on the Magento-side.
- Magento 2.X system without data
- REST API & integration enabled
- Commerce 365 Magento extension installed
Magento API + Microsoft Dynamics 365 Business Central setup
To connect Business Central to Magento you have to follow the procedure below.
- Make sure that REST API is enabled and fully accessible.
There are known cases where Magento hosting providers are blocking (parts) of the Magento API.
When using Byte/Hypernode, please check the following KB item: https://support.hypernode.com/knowledgebase/protecting-the-magento-2-api/
- Create an integration under; System > Integrations, and make sure it has access to all resources.
Also make sure that you mark it as Authorized.
- Open Microsoft Dynamics 365 Business Central, select the e-commerce manager role and go to; Administration Setup and fill the following fields:
REST API URL – Should look like https://www.yourdomain.com/rest/
Access Token – The token that was generated by Magento when creating the integration.
That’s it. The system will automatically validate your input, and if all is well, you should see a green status indicator that shows; Magento Connection: Available.
Business Central is now connected to Magento.
You can obtain the latest version of the Commerce 365 Magento extensions via https://www.idyn.nl/ > my idyn. Log in with your partner or customer credentials and go to the download section. If you don’t have a login, please contact your partner or partner account manager.
- As a prerequisite you have to install Guzzle. Guzzle is a component that is used by our extensions to communicate with our Azure data platform. Before installing it, you might want to check whether it is already installed on your system. This might be the case because there are other extensions that also use Guzzle for communication.
To install Guzzle simply follow the procedure on: https://docs.guzzlephp.org/en/stable/overview.html#installation
Practically it’s 1 or 2 SSH commands and that is it.
- Next step is to upload the extension you have downloaded. And after uploading you have to execute the following commands to install and activate the extension.
php bin/magento setup:upgrade
php bin/magento cache:clean
- Login to the Magento backend and go to Stores > Commerce 365 > General.
And fill in the following fields:
Hub URL – Looks like https://data.west-europe.commerce365.io/ (depending on your region)
App ID – A set of 32 random characters
Secret key – Another set of 32 random characters
After doing this, select the modules you want to enable and click Save Config.
Magento is now connected to the Business Central data hub.
- If you have not received the hub URL, App ID and Secret key, please contact your customer. They should have received these credentials from their implementation partner. And they can also obtain them by logging on to the idyn customer portal.
- In some cases, with some templates, it might be needed to alter cache settings for the B2B/Business Central pricing extension to function properly. We have included a few examples for the standard Luma theme and the widely used Porto theme in the download file.
After you have created the integration in Magento, entered those credentials in Business Central, and installed and configured the Magento extension, you have completed the initial setup. The 2 systems should now be able to communicate. The next step is to start working on the item data in Business Central.
What’s next for Magento
Please be aware that you should not create categories or items via the Magento backend. That is all done in the Business Central ERP system. During test/development it’s not a big deal. but when switching to production mode, or if you want to test the integration properly, please remove this data first.
What still has to be done in Magento is configuring additional store views in case you want to use those. After creating new websites or store views, go to Business Central Master Data and click on Update Websites or Update Store Views, to pull in the new configuration so that it can be used within Business Central.