The Movilitas.Cloud application enables Marketing Authorization Holders (MAHs) to connect to the EU Hub through the EU Hub channel.
The EU Hub channel can be used in the following applications and setups:
Application | Setup |
---|---|
Manufacturer for Pharma | One of the following:
Movilitas.Cloud Support can activate one of them upon request. |
Repacker FMD | One of the following:
Movilitas.Cloud Support can activate one of them upon request. |
Serialized Manufacturing | Sending the requests from Movilitas.Cloud to the EU Hub. Contact Movilitas.Cloud Support to set up the connection to the EU Hub. |
The EU Hub channel can operate in both setups at the same time. For example, sending JSON report file to an email address for Repacker FMD and Manufacturer for Pharma while sending the requests from Movilitas.Cloud to the EU Hub for Serialized Manufacturing.
When using the Serialized Manufacturing application, it is possible to import master data from the EU Hub to Movilitas.Cloud.
List of Procedures
- Creating an EU Hub Channel
- Configuring the EU Hub Settings
- Importing Master Data from the EU Hub (Serialized Manufacturing Application Only)
- Viewing EU Hub Requests
- Viewing EU Hub Alerts
- Viewing Master Data Imports
For more information on the general channel actions, see Managing Channels for a Tenant (Overview).
Creating an EU Hub Channel
Procedure
1. Go to Movilitas.Cloud Console --> My tenants.
2. Select the tenant or click Open tenant next to it.
3. On the Tenant Dashboard, select the Channels tab. The application displays the list of channels assigned to the tenant.
4. Click the + icon (Create channel). The application displays the Create channel dialog.
5. Select Business channel as the type and click Create.
The application displays the Create Channel page with an empty form to give the basic parameters of the channel.
6. Enter a name for the channel and select EU Hub as the source.
7. Click Create Channel.
The application informs you about the additional costs. After confirming the creation, the application displays the Edit Channel page with:
- A panel where:
- You can provide the report email address
- You can provide the MAHs.
- You can fetch master data from the EU Hub.
- A table for the EU Hub requests, EU Hub alerts, and master data imports.
Example:
8. Contact Movilitas.Cloud Support to set up the automated connection to the EU Hub.
- If your company does not have access to the EU Hub, you may need to go through a complex onboarding procedure. A proper setup is required to have a connection to the EU Hub.
- If you want to use the EU Hub channel in Manufacturer for Pharma / Repacker FMD applications and you do not want to directly connect to the EU Hub, you can receive JSON report files to the email address specified on the EU Hub channel. You can use the JSON report files to update the EU Hub manually through the Melior gateway. Movilitas.Cloud Support can activate this setup upon request.
Next Steps
Configure the EU Hub channel by giving the report email address, the default MAH, and other MAHs.
Back to the list of procedures
Configuring the EU Hub Settings
Provide the report email address and the MAH data for your EU Hub channel.
Procedure
1. Go to Movilitas.Cloud Console --> My tenants.
2. Select the tenant or click Open tenant next to it.
3. On the Tenant Dashboard, select the Channels tab. The application displays the list of channels assigned to the tenant.
4. To search for an EU Hub channel, use the search field and the filters:
- Enter the channel name in the search field.
- Select the status.
- Select EU Hub as the source.
- Select Business channel as the type.
5. To view the channel information, click on the channel name or the edit icon (Edit channel) next to the channel. The application displays the Edit Channel page with the current channel settings, EU Hub requests, EU Hub alerts, and master data imports.
6. Under the Settings tab, provide the EU Hub settings as explained in the table below.
Parameter | Action |
---|---|
Connection status | Displays the status of the connection to the EU Hub. Click on the status message to refresh the status and verify that the connection is up and running. If the connection is not set up or there is a failure in the connection, the application displays the message Not connected to EU Hub. Note: When using the new Serialized Manufacturing application in parallel with the old applications, Manufacturer for Pharma and Repacker FMD, you can request from Movilitas.Cloud Support to activate dual mode for the channel:
|
Report email | Provide a report email address to receive messages from Movilitas.Cloud, as detailed below. Direct Connection to the EU Hub (Automated Connection) Enter the email address where Movilitas.Cloud can send notifications about:
The application checks for new failed requests and new alerts each hour and sends a separate notification about the failed requests and about the alerts, respectively. No Direct Connection to the EU Hub (Manufacturer for Pharma and Repacker FMD applications only) |
Example:
7. Click Save Settings.
8. Select the MAHs tab. The application displays the list of MAHs (if any) and indicates the default MAH with a green checkmark icon.
The following example illustrates that one MAH was previously added by the user to the list. The MAH that is added first automatically becomes the default MAH (green checkmark icon on the left):
9. Add further MAHs by clicking on the Add MAH button. The application displays a form in a window.
10. Fill in the form as described in the table below.
Note: You register the MAH by giving the MAH name and address. Otherwise, uploading product master data to the EU Hub is blocked from Movilitas.Cloud to avoid unnecessary errors raised in the EU Hub. Giving the ID is optional. The required fields are marked with an asterisk (*) in the form.
Parameter | Action |
---|---|
Help me icon | Click on the Help me icon on the top-right corner to get hints about what data to provide. |
Default checkbox | Select the checkbox if you want to make the MAH the default one. |
ID | Optionally, enter the MAH ID. |
Name | Enter the name of the MAH. The field is required. |
City | Enter the city where the MAH is located. The field is required. |
Street | Enter the street of the MAH. The form offers three rows (levels) for the street data. One level of street is required. |
State | Optionally, enter the state. |
ZIP code | Enter the postal code. The field is required. |
Select country | Select the country. Start entering the country name to filter on the countries. The field is required. |
Example:
11. Click Save. The MAH is added to the list.
Example:
- To edit the MAH, click on the edit icon, modify the data in the Edit MAH form, and click Save.
- To delete the MAH from the list, click on the delete icon and confirm the deletion.
Note: If you delete the default MAH, the application sets the first non-default MAH in the list to be the default MAH. Verify the default MAH and change it if needed.
Next Steps
Configure the application where the EU Hub channel will be used:
- When using the Serialized Manufacturing application, create the EU market profile and select the EU Hub channel for it.
- When using the Manufacturer for Pharma and the Repacker FMD applications, set the EU Hub channel.
Back to the list of procedures
Importing Master Data from the EU Hub (Serialized Manufacturing Application Only)
If the EU Hub already stores master data, you can import the data to Movilitas.Cloud and you do not need to register the products, the MAHs, and the contracted wholesalers (3PLs) one by one. This function reduces the time to populate Movilitas.Cloud with your existing master data. After the import, you can manage your master data in the Serialized Manufacturing application and on the EU Hub channel page.
Importing master data requires attention when you have already registered products, MAHs, and 3PLs in Movilitas.Cloud:
- EU Hub is the single source of truth.
- The application identifies the products, the MAHs, and the 3PLs that will be overwritten in Movilitas.Cloud by using the information in the EU Hub.
- The products, the MAHs, and the 3PLs that cannot be identified are left as is in Movilitas.Cloud (no deletion). These objects might require adjustments from your side.
Note: The import function is restricted to the Serialized Manufacturing application.
Procedure
1. Go to Movilitas.Cloud Console --> My tenants.
2. Select the tenant or click Open tenant next to it.
3. On the Tenant Dashboard, select the Channels tab. The application displays the list of channels assigned to the tenant.
4. To search for an EU Hub channel, use the search field and the filters:
- Enter the channel name in the search field.
- Select the status.
- Select EU Hub as the source.
- Select Business channel as the type.
5. To view the channel information, click on the channel name or the edit icon (Edit channel) next to the channel. The application displays the Edit Channel page with the current channel settings, EU Hub requests, EU Hub alerts, and master data imports.
6. On the EU Hub settings panel, click Fetch Master Data.
System Response 1
If the EU market profile is not created in the Serialized Manufacturing application, the system offers automatic actions: the creation of the EU market profile, associating the EU Hub channel with the market profile, and proceeding with the master data import.
System Response 2
If the EU market profile is created in the Serialized Manufacturing application but the EU Hub channel is not associated with the market profile, the system offers automatic actions: associating the EU Hub channel with the market profile and proceeding with the master data import.
System Response 3
If the EU market profile is available in the Serialized Manufacturing application and the EU Hub channel is associated with the market profile, the system asks you to confirm the action because it overwrites the existing product data, MAH data, and 3PL data.
Note:
- The application identifies the products, the MAHs, and the 3PLs that will be overwritten in Movilitas.Cloud by using the information in the EU Hub.
- The products, the MAHs, and the 3PLs that cannot be identified are left as is in Movilitas.Cloud (no deletion).
7. Click Yes or Yes, Fetch Master Data, respectively.
- The master data is fetched into a CSV file in the background and then the data is imported to the Serialized Manufacturing application and to the EU Hub channel.
- The requests sent to the EU Hub are logged and listed on the EU Hub requests tab. To refresh the status, click on the Refresh icon in the top-right corner.
- The import action is logged separately and is listed on the Master data import tab. Refresh the browser to verify the latest log and its status.
- If the creation of the EU market profile is also part of the process but the creation fails for any reason, the application displays an error message. Create the EU market profile manually and associate the EU Hub channel with the market profile in the Serialized Manufacturing application. Then, retry the master data import on the EU Hub channel.
Next Steps
Verify the imported master data:
- MAH data on the EU Hub channel page under the MAHs tab.
- 3PL data under the Serialized Manufacturing application --> Site management --> 3PLs tab.
- Product data under the Serialized Manufacturing application --> Products --> Products tab.
Back to the list of procedures
Viewing EU Hub Requests
You can view the requests sent to the EU Hub, for example, master data upload or commissioning, and the responses received from the EU Hub.
Procedure
1. Go to Movilitas.Cloud Console --> My tenants.
2. Select the tenant or click Open tenant next to it.
3. On the Tenant Dashboard, select the Channels tab. The application displays the list of channels assigned to the tenant.
4. To search for an EU Hub channel, use the search field and the filters:
- Enter the channel name in the search field.
- Select the status.
- Select EU Hub as the source.
- Select Business channel as the type.
5. To view the channel information, click on the channel name or the edit icon (Edit channel) next to the channel. The application displays the Edit Channel page with the current channel settings, EU Hub requests, EU Hub alerts, and master data imports.
6. Go to the bottom of the page and select the EU Hub requests tab (displayed by default).
By default, the application displays the list of requests for the past ~30 days with the latest request on top. To refresh the list, click on the Refresh icon in the top-right corner.
For each request, you can view:
- A status icon.
- The type of request. It is derived from the response by the EU Hub.
- The date and time of creation.
- The correlation ID.
You can also expand a request for further details.
Example:
Status | Description |
---|---|
Green (Successful) | The EU Hub has successfully processed the request. |
Circular arrows (Pending) | Processing of the request is in progress. |
Red (Failed) | A request can fail due to one of the following reasons:
|
7. Search for a request by using the search field and setting the time period. In the search field, you can enter one of the following:
- Product code
- Batch
- Serial number
- The correlation ID of the message
Note: You need to enter at least three characters to activate filtering.
8. Expand the request by clicking > (Expand) icon next to the request on the left. The application displays the request details and the response from the EU Hub (if any).
Case | Description | Action |
---|---|---|
Green | The response from the EU Hub reflects successful processing (status VALID or SUCCESS). | No further action. |
Circular arrows | Pending | Wait for the response from the EU Hub. |
Red (Failed) | The response from the EU Hub reflects an error or invalid request (status INVALID or ERROR). Example - #A16 Missing National Code for market The National code is required for the product but it is not provided while uploading the product master data. There is a mismatch between the data provided in Movilitas.Cloud and what is expected in the EU Hub. | A configuration detail is missing, a configuration detail is wrong, or you missed a step. Find the root cause and make sure the configuration in Movilitas.Cloud is consistent and is in line with what is expected in the EU Hub. For the mentioned example, provide the National code for the product under the Serialized Manufacturing --> Products --> Products --> EU countries tab, and retry the master data upload. The resolution depends on the issue. You cannot fix the issue in all cases on your own in the UI. When it is necessary, contact Movilitas.Cloud Support. |
Red (Failed) | The connection to the EU Hub is down. EU Hub is down. | Contact Movilitas.Cloud Support. You can still get the JSON content by expanding the request, copying the Data part, and saving it to a file. |
The following example illustrates a successful commissioning request of ten packs (VALID and SUCCESS status in the response). The serial number of a pack was entered in the search field:
Back to the list of procedures
Viewing EU Hub Alerts
You can view the EU Hub alerts. For alerts "A2 Batch Not Found" and "A52 Expiry Date Mismatch", you can also check the batch details stored in Movilitas.Cloud. Based on the available information, you can take the necessary actions to resolve the conflict with the EU Hub.
For more information on alerts, see EMVS Alert Codes.
Procedure
1. Go to Movilitas.Cloud Console --> My tenants.
2. Select the tenant or click Open tenant next to it.
3. On the Tenant Dashboard, select the Channels tab. The application displays the list of channels assigned to the tenant.
4. To search for an EU Hub channel, use the search field and the filters:
- Enter the channel name in the search field.
- Select the status.
- Select EU Hub as the source.
- Select Business channel as the type.
5. To view the channel information, click on the channel name or the edit icon (Edit channel) next to the channel. The application displays the Edit Channel page with the current channel settings, EU Hub requests, EU Hub alerts, and master data imports.
6. Go to the bottom of the page and select the EU Hub alerts tab.
The application displays the list of alerts with the latest alert on top. To refresh the list, click on the Refresh icon in the top-right corner.
For each alert, the following is displayed:
- Date and time
- Alert code
- Message
- Alert ID
- Action - Show batch (if applicable)
Example:
7. Search for an alert by entering the GTIN, the serial number, the alert ID, the alert code, or any other relevant data from the alert in the search field.
Note: You need to enter at least three characters to activate filtering.
In the following example, we are searching for all alerts that contain the product code "26836349527634":
8. Expand an alert by clicking > (Expand) icon next to the alert on the left. You can view the details of the alert including the error, the date and time, the pack data, the source, and the market details.
The following example shows the details of the previously filtered alert (truncated screenshot):
9. For alerts "A2 Batch Not Found" and "A52 Expiry Date Mismatch" triggered by the EU Hub, check the batch details stored in Movilitas.Cloud.
10. Click Show batch. The application displays either the batch details or an error message if the batch is unknown.
Batch details are displayed as follows:
- When using the Serialized Manufacturing application, you are redirected to the Products --> Batches tab where you can verify the batch details.
- When using the Manufacturer for Pharma or the Repacker FMD application, a pop-up is displayed with the batch details.
Example:
Back to the list of procedures
Viewing Master Data Imports
You can view the master data imports from the EU Hub.
Procedure
1. Go to Movilitas.Cloud Console --> My tenants.
2. Select the tenant or click Open tenant next to it.
3. On the Tenant Dashboard, select the Channels tab. The application displays the list of channels assigned to the tenant.
4. To search for an EU Hub channel, use the search field and the filters:
- Enter the channel name in the search field.
- Select the status.
- Select EU Hub as the source.
- Select Business channel as the type.
5. To view the channel information, click on the channel name or the edit icon (Edit channel) next to the channel. The application displays the Edit Channel page with the current channel settings, EU Hub requests, EU Hub alerts, and master data imports.
6. Go to the bottom of the page and select the Master data imports tab.
The application displays the list of imports. To refresh the list, refresh the browser.
For each request, you can view:
- A status icon.
- The date and time of creation.
- The request ID.
- A comment.
You can also expand a request for further details.
Example:
Status | Description |
---|---|
Green (Successful) | The import was successful. |
Circular arrows (Processing) | The import is in progress. |
Red (Failed) | The import failed. |
7. Expand a log by clicking > (Expand) icon next to the log on the left. You can view the details of the import, including the fetched CSV.
The following example illustrates a successful import:
Back to the list of procedures