softwaresuppliers

SOFTWARE SUPPLIERS

Connecting users to the verification system 

Users (wholesalers, pharmacies and hospitals) who have received approval from BeMVO to access the verification system NMVS, have to implement the technical connection to the NMVS.

Their selected software provider or own IT department need to develop and implement a connection module to the NMVS. The first step is to connect to the development portal (sandbox): www.sws-nmvs.eu

The different steps are:

sandbox
iqe
production

Functionalities for end users 

In summary:

Functionalities for end users
Decommissioning transactions and Undo’s in this case the status of the pack is changed and set to ‘Inactive’ or reset to ‘Active in case of an ‘Undo’. Be aware that for the transaction types ‘Destroy’ and ‘Stolen’ the undo is not possible. It might be wise to include a confirmation step for the user to execute such a transaction. Further, wholesalers can run a ‘Homogeneous Bulk’ and pharmacies a ‘Mixed Bulk’ transaction.
Information the possibility to download at any moment the Product Master Data file for a selection of pack codes or for all. This extract contains by product code the ‘Designated Wholesalers’ (distributing in name of the MAH) and the MAH. If the MAH has filled in the national code (CNK), this information will also be present (be aware it is the information entered by the MAH).
Management a set of processes to manage the end user connection: password renewal (needed every 90 days), Certificate renewal (every 2 years) and acceptance of the T&C (mandatory).
GUI the possibility for the end user, in case of emergency due to technical problems, to connect to the NMVS using his internet browser. To do so his certificate must be installed in the browser.

Consult here the table with more details on these processes: table1 hieronder te downloaden

End user interactions with NMVS 

When a transaction is submitted to the NMVS, the NMVS will respond with a return code and description, indicating if the transaction was processed successfully or if an issue occurred.

Consult here the complete list of return codes, what can be the root cause and what should be done: return codes nl; return codes fr

Some of these return codes indicate that the verified or decommissioned pack is a potential falsification. The processes to follow in case of a potential falsification can be found in the section ALERTS.

From a software perspective, it is critical that the user is made clearly aware about the alerts he is generating and that a trace (log file) keeps track of all the transactions and generated alerts, and most important the alert-ID, so the concerned pack information can be traced back in case the user is contacted by BeMVO or by the authorities when the alert would have been escalated to them.

Most common ‘technical’ causes for False Alerts

Scanner configuration

Where the scanner of the end user is provided by his software supplier, the software supplier must make certain that this scanner is correctly configured and also remains in that state.

A typical issue is that the scanner is configured for QWERTY or German keyboard, where the user uses a AZERTY keyboard. Another cause can be that the scanner does not correctly read the GS-1 separator and  that different data elements are concatenated together. 

Transformation of scanned data

The (correctly) scanned information should be used as such to construct the transaction to be sent to the verification system. It should be avoided that the data elements received from the scanner are transformed based on any internal software logic.

Transaction repetition

It still happens that some transactions are running into a loop whereby the same transaction is re-sent to the verification system every x minutes.

Besides these causes, there are also the process errors made by the end users, e.g., multiple decommissioning of the same packs.

Problem shooting 

User cannot perform the verification/transaction

Different reasons can be led to the user being unable to perform verifications. In general the reason can be identified based on the return code the user receives when trying to perform a transaction.

In these cases where the user cannot set up a valid connection to the NMVS, or he cannot immediately solve the technical issue preventing him from performing the verification, he can nevertheless continue to distribute and dispense the medicinal product. 

However, in such case, the transactions performed must be stored in the user’s system and submitted to the NMVS when the connection is re-established (D.R. art.29).

User has no connection or certain transactions are rejected

1

Invalid password

The user receives a notification 10 days before expiry of the password.

If not changed, the user will be locked after 3 connections with the wrong password.

 

Solution

Option a) BeMVO unlocks the user.
The user has then to run first the password change before any other (3) transactions, otherwise he will be locked again. 

Option b) Request BeMVO to be unlocked and receive a new password.

! Attention: the new password provided is to be processed as a new ‘initial’ password. The first transaction to run is the G445 Password change where the provided password is to be used as the ‘old’ password.

2

Invalid password for one of multiple systems not interconnected

When the password has been changed in one of multiple not interconnected systems from the end user, the other system(s) will receive a notification that they have to update with the changed password within 5 days.

If not changed in time, the user will be locked after 3 attempts.

 

Solution

Option a) BeMVO unlocks the user.
The user has then to run first the password change on that system(s) before any other (3) transactions, otherwise he will be locked again.

Option b) Request BeMVO to be unlocked and receive a new password.

! Attention: the new password provided is to be processed as a new ‘initial’ password. The first transaction to run is the G445 Password change on all systems where the provided password is to be used as the ‘old’ password.

3

No Certificate or expired

There is no certificate installed in the system of the user or the certificate used is expired.

When the certificate is going to expire, the user receives an email with the link to the PKI server and the TAN code for downloading the certificate. As from day 30, he receives an email every day.

If not installed, the user will be locked.

 

Solution

Download and install the new certificate if still available (before expiry of the current one).

Otherwise, contact BeMVO for a new certificate and download + install asap.

4

T&C not accepted

The end user receives a notification by when a new ‘mandatory’ version of the T&C has to be accepted.

If not accepted in time, the transactions will not be processed.

 

Solution

Accept the T&C immediately. The version to accept is mentioned in the system response when service G482 (current version 6001)

5

Error in the XML structure

These error codes indicate that the xml of the submitted web service is incorrect. Most frequent errors are:

–          A mandatory field is empty

–          The data in the field is invalid (e.g. invalid expiry date format)

–          Field too long (e.g. SN has more than 20 characters)

–          The input contains non-GS1 compliant characters

 

Solution

The end user software should validate these elements before the web service is submitted.

6

No system response with an intermarket transaction

When the end user receives the return code NMVS_TE_REQ_01, this indicates that the user tries an Intermarket Transaction (IMT), i.e., the verification of a non-BE/LU pack in the system of another country. The return code indicates that the EU Hub or the other system did not respond in time.

 

Solution

The user has to run the transaction again at a later moment.

Consult here the table with all return codes from the system and possible actions for the end user and his FMD module

Table 1
Verification and Decommissioning web service transactions

Process ID

Process

Pharmacy/
Hospital

Wholesaler

Undo Y/N

Comment

G110

Verify Single Pack

Y

Y

na

Verification can be done at any moment. 

G112

Manual Verification Single Pack

Y

Y

na

Only to be used if pack cannot be scanned. Requires only PC and SN as input.

G120

Dispense Single Pack

Y

Y

Y

Reminder : Undo only possible within 10 days and by same user.

G122

Manual Dispense Single Pack

Y

Y

Y

Only to be used if pack cannot be scanned. Requires only PC and SN as input.

G130

Destroy Single Pack

Y

Y

N

No UNDO possible. Add safety by requesting (double) confirmation.

G140

Export Single Pack

N

Y

Y

  

G150

Sample Single Pack

Y

Y

Y

  

G160

Free Sample Single Pack

N

Y

Y

  

G170

Lock Single Pack

N

Y

Y

  

G180

Stolen Single Pack

N

Y

N

No UNDO possible. Add safety by requesting (double) confirmation.

 

G115-G185

Submit Homogeneous Bulk

N

Y

Undo possible for transactions where it is also possible for the Single Pack transaction.

G188

Request Bulk transaction result

N

Y

Be aware that a ‘Bulk’ transaction is not possible for non-BE/LU packs

G195

Submit Mixed Bulk

Y

N

Undo possible for transactions where it is also possible for the Single Pack transaction.

G196

Request Mixed Bulk result

Y

N

Be aware that a ‘Bulk’ transaction is not possible for non-BE/LU packs

G101

Download Master Data

Y

Y

This web service allows to download the product master file from NMVS, containing all GTINS in the system, the Marketing Authorisation Holder having uploaded the Product Code and the national code uploaded by the MAH.

 User management

Process ID

Process

Comment

G445

Change password

This web service allows to change the password of the user. The password needs to be renewed every 90 days.

G482

Load Terms & Conditions

Download the T&C document from the NMVS. The NMVS response XML contains also the Version ID to be used for the Confirmation step (currently version 6001).

G483

Confirm Terms & Conditions

This webservice allows the mandatory acceptance of the T&C.

G615

Download client certificate PKI

This webservice allows to download the certificate. Consult the documentation explaining the 2 ways to access and download/renew the certificate.

GUI

Graphical User Interface

The verification, single pack transactions, password change and T&C confirmation is also possible for the user by accessing the NMVS with the GUI in the internet browser. To be able to access the NMVS with the GUI, the certificate needs to be installed in the browser.

List of Software versions that have passed the Baseline Testing and are ready for implementing the connection to the LIVE environment of the National Medicines Verification System for End Users in Belgium and Luxembourg.

Update: April 2021

CompanySoftwareVersionPharm.Single TransactionsPharm.Bulk TransactionsWHS Single TransactionsWHS Bulk Transactions
ADC NVADC-FMD1.0XXXX
ADENTSADENTS DISPAX0.5.0XXXX
ADHERTEC S.R.O.NMVS.ONLINE1.00X
ALN TECHNOLOGY LTDFMDPLUS1.2XXXX
ARVATO SYSTEMS GMBHARVATO SMART LOGISTICS PLATFORMS – HEALTH CARE SUITE1.2XXX
BECTON DICKINSON AND COMPANYBD PYXISTM FMD VERIFY1.0.0.0X
C. CONSULT ADVICEADMED/PHARMA201501X
CENTRE HOSPITALIER BOIS DE L’ABBAYE (CHBA)CHBAPHA1.0XX
CENTRE SPECIALITES PHARMACEUTIQUECSPPRODUCT1.0XXX
CERPNPI11.0XXXX
CHIPSOFTCHIPSOFT HIX6X
CHRHGINET1.0X
CORILUSCARECONNECT PHARMACIST1.00.66X
CPLCPLWEB4.0.0XX
CVBA VOORUITVOORUIT PRODUCT1XXXX
DAXANT SACHECKFMD1.0.0XX
DEBISCOM BVBAMERCATORV3X
EPC FAMILIAEPC02XXX
FARMADTWINBETA 2X
FEBELCOPDC FMD0.1XX
FRESENIUS NETCARE GMBHSAP OER7X
GOED ICTVIANOVA (PHARMACY) -ESCAPO (WHOLESALER)20.9.2XXXX
H. ESSERSH. ESSERS WMS5.8X
HANFF GLOBAL HEALTH SOLUTIONSHANFF1.0.0XX
INEOMERCATOR1.0.0.0XXXX
INFOHOSNMVS-CONNECTOR1.0XX
IPHARMA LOGISTICIPHARMA1.18X
LOGIPHARMLOGIPHARM1.105.0.1XX
MEDASPIS B.V.MEDASPIS CONNECTOR PLUS (FOR PHARMACIES AND HOSPITALS)2018.08.27XX
MEDASPIS B.V.MEDASPIS CONNECTOR PLUS (FOR WHOLESALERS)2018.08.27XX
MEDITECHMTULTRAFICTUS1.0XX
MEDSOCAPOMEDSOC1XXXX
MMS-SOLUTIONSYGLOBAL8.0XXXX
MOVILITASMOVILITAS.CLOUD-ARVATO CONNECTOR1.2.0XXXX
MULTIPHARMA SCRLMULTIPHARMA-FMD2.0XX
NEWPHARMASOAP UI5.4.0XX
NEXTPHARMNEXTV22X
OBASIOBASI SOFTWARE1.0XX
OCPPORTAIL1.0X
OFFICINALLOFFICINALL19X
OPTEL GROUPOPTEL CERTA1.0XX
OPTIMA SYSTEMSMEDTRACS1.0XXXX
PHARMABELGIUM-BELMEDISPHBFMD1.0XX
PHARMAGESTFMD-ENGINE1.0.0XX
PHARMONY SAPHARMONY ONE1.1.564XXXX
PROPHACPRONAV1XXXX
QUICK PHARM SOLUTIONS LIMITEDEASYFMD1.0.5.6XXXX
RFXCEL CORPORATIONRFXCEL TRACEABILITY SYSTEM (RTS)5.8.2XXXX
S.A. LOGALEVOLUTIVE COMPTA79XX
SBIMGCLWIN1B40X
TCK GMBHNMVS CONNECT1.1XXXX
TRACELINKTRACELINK LIFE SCIENCES CLOUD2018.5XX
TRACINGINMOTION BVBATRACFMD1.0XX
UZ ANTWERPENUZA ZIS-APOTHEEK9.7XX
UZ LEUVENUZL-DUMMY21.0X
VPHARMAVPHARMA1.0XXXX
VZW NETWERK HIERONYMUSDIBROSI INFORMATIE SYSTEEM1.0XX
XPERTHISXPERTHISFMD0.1XX
ZETES UK LTD.ZETESOLYMPUSFMD1.0.0XXXX
MAUVE MAILORDER SOFTWARE GMBHMAUVE SYSTEM 32020.2 FFXXXX
EASI SASOFT ADFINITY1.6XXXX