NAVcommerce is a Microsoft Dynamics NAV add-on & integration framework. NAVcommerce is developed from an ERP perspective, which means that the main thought behind all development is; customers use their Dynamics NAV for everything, so for e-commerce, we should just extend that NAV system with what is missing.
In short; NAVcommerce adds everything that is missing from standard NAV, and it takes care of all Magento integration.
NAVcommerce users never have to log in to Magento backend for everything related to items, customers, inventory, prices, sales orders/shipments/invoices. 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 NAVcommerce item card, which might help to illustrate this concept:
Below is the list of what NAVcommerce expects on the Magento-side.
- Magento 2.X system without data
- REST API & integration enabled
- NAVcommerce Magento extension installed
Magento API + NAV setup
To connect NAV 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 NAV, select NAVcommerce and go to; Administration > Setup In the Magento section, set the Magento version to 2.X, and fill the following fields:
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. Click on ‘apply settings’ and you should see a green status indicator with the text; Magento Connection Status: Available.
NAV is now connected to Magento.
You can obtain the latest version of the NAVcommerce 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 > NAVcommerce > General.
And fill in the following fields:
Hub URL – Looks like https://data.west-europe.navcommerce.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 NAV data hub.
- If you have not received the hub URL, App ID and Secret key, please contact your NAV customer. They should have received these credentials from their 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/NAV 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 that data in NAV, 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 NAV.
What’s next for Magento
Please be aware that you should not create categories, attributes, attribute sets, items or customers via the Magento backend. That is all done in the NAV ERP system. If you already have attributes, products or categories in Magento, for testing or development purposes, please remove this data.
What still has to be done in Magento is configuring additional store views in case you want to use those. After creating new stores and store views, in NAV > NAVcommerce > Administration > Setup > Stores click on Update from Magento, to pull in the new store data, so that it can be used within NAV.