Overview
The health of the connection between MV2 and Business Central is integral to ensuring the data in both systems is accurate and up to date. This article details how to view the status of the integration and also how to configure an email notification if the communication between MV2 and Business Central fails.
Table of Contents
- ERP Health Status
- Data is missing in Business Central
- Received an email titled "Provider API Error Notification"
ERP Health Status
This page provides a general status of one of the main components that support communication between MV2 and Business Central, the Provider Api. The Provider Api is an MV2 product that manages the synchronization of data from Business Central into MV2 and also manages the publishing of MV2 transactions to the subscribing application(s), which in this case is the MV2 BC Sync Service.
To navigate to the Health Status in MV2, select Administration -> System Administration -> ERP/General from the menu bar.
At the bottom of the page you will find the ‘ERP Integration Health Status’ section.
A status of icon of a red circle with an exclamation mark means there is a communication error between MV2 and the Provider Api, which ultimately means MV2 is not communicating with Business Central. This affects the flow of data from Business Central to MV2 and also the transaction data from MV2 back to Business Central.
This condition requires assistance from the MV2 Team.
A status of an icon with a green circle with a checkmark indicates the communication between MV2 and the Provider API are working as intended and ultimately the communication between MV2 and Business Central is functioning also.
There are scenarios where the communication may be working as intended, however validation errors may result in data not being transferred between MV2 and Business Central. In that situation, it is recommended that the information the Knowledge Base Article <TODO: Insert link to the Log Viewer KB here> be reviewed to diagnose the issue.
Provider API notification email
The Provider Api is responsible for managing the flow of data between Business Central and MV2 and this includes synchronizing data from Business Central to MV2 and sending transaction data from MV2 to Business Central.
There will be instances where the Provider Api fails to send transaction data to Business Central, or when MV2 fails to Post the sent data in Business Central. In this case, the Provider Api will send an email notification to the configured email address(es) indicating an error and where to go to resolve the issue.
To support this, a new Role has been created named ‘Provider Api Notifications’.
In MV2, there are two methods to assign email addresses to a Role.
Any user assigned to this specific Role will receive the email, provided their User is configured with an email address in MV2.
One or more email addresses can be added to the Role itself.
Adding Users to the Role
Confirming the Email address of a User
If the preferred method of associating an email address with a Role is to assign a User to the Role, first confirm the User has an email address associated with their User by navigating to Administration -> System Administration -> User Info.
Adding user to the Provider Api Notifications Role
To add one or many Users to a Role, navigate to Administration -> System Administration -> Roles.
This page displays all the Roles available within MV2. Locate the ‘Provider Api Notifications’ Role.
Click the ‘Manage Users’ icon to modify the Users associated with this Role.
Select the desired User(s) to add to the Role by clicking the checkbox in the left column for each User. Once all of the Users are selected, click the ‘Add Selected Users to Role’ link.
The screen will refresh and the added Users will now have their ‘Is In Role’ column checked.
To remove Users from the Role, again select the desired Users and click the ‘Remove Selected Users from Role’ link. The screen will refresh and the ‘Is In Role’ column will be unchecked.
Add email address(es) directly to the Role
To add email addresses directly to the Role, navigate to Administration -> System Administration -> Roles.
Locate the ‘Provider Api Notifications’ role and Edit the Role.
Enter one or more email addresses, comma separated, in the ‘Email Addresses’ section and press Update.
Notification emails
When the Provider Api determines an error has occurred with an MV2 transaction, it will send an email to the email address(es) associated with the ‘Provider Api Notifications’ Role, detailed above. Below is an example of that email and how to process it.
Sample email
The email message will come from ‘mv2’ and have a subject of “URGENT – Provider API Error Notification”.
The body of the email will contain a general message that the Provider API encountered error when attempting to process a transaction in ERP. There will be a hyperlink to the MV2 Log Viewer page, which will display the details of the issue.
Issue Resolution
The process of interpreting the 'MV2 Provider Errors log tab' referred to in the email message above, and the subsequent resolution of any issues, is detailed in the following KB Article
<TODO: Insert link to the Log Viewer or List of Common Errors KB (which links to the Log Viewer KB) here>