NMVS Upgrade – NMVS Release Core 1.10 - 2nd June 2022
The following interface and functional changes will be delivered with this release:
Web Services v3 Interface to be Turned Off
With the deployment of NMVS Core 1.10 the v3 web services interface will be turned off.
The existing v4 interface remains in place and will continue to be available until NMVS Core 2 is released in Spring 2023.
All active software suppliers have confirmed that their software will work with the v4 interface. All end users must ensure they are connected to the v4 interface through their software, or they will be unable to continue to scan medicines.
New Web Services v5 Interface Deployment
A new web services interface, version 5, will be deployed with this release. Software suppliers have already been made aware of the specification of the new interface and from the deployment of this release, connection to this new interface will be available.
New v5 Interface System Functionality
The v5 interface upgrade supports the following new functionality delivered with this release.
Note, the following will not be available if you are continuing to link to the NMVS via the v4 interface.
1. Unique Alert Return Codes
Currently there are a small number of scenarios where an Alert is raised but an Alert ID is not created because the situation is not a potentially falsified pack. For these scenarios separate response codes have been created.
The following table details the existing Alert codes with the related (new) additional response codes.
Existing Alert Codes |
New related response codes where there is no Alert ID |
||
Alert Code |
Description |
Response Code |
Description |
NMVS_FE_LOT_03 |
Failed to find Batch Number. |
NMVS_FE_LOT_15 |
Failed to find Batch Number (no alert). |
NMVS_FE_LOT_12 |
Expiry Date does not match Batch Number. |
NMVS_FE_LOT_17 |
Expiry Date does not match Batch Number (no alert). |
NMVS_FE_LOT_13 |
The Batch Number does not match Pack Serial Number |
NMVS_FE_LOT_18 |
The Batch Number does not match Pack Serial Number (no alert). |
NMVS_NC_PC_02 |
Pack Serial Number not recognised |
NMVS_NC_PC_14 |
Pack Serial Number not recognised (no alert). |
NMVS_NC_PCK_06 |
Undo attempt doesn't match the Pack status. |
NMVS_NC_PCK_29 |
Undo attempt doesn't match the Pack status (no alert). |
NMVS_NC_PCK_19 |
Status is already set on pack. |
NMVS_NC_PCK_28 |
Status is already set on pack (no alert). |
NMVS_NC_PCK_22 |
Pack is already inactive. |
NMVS_NC_PCK_30 |
Pack is already inactive (no alert). |
NMVS_NC_PCK_27 |
Status change could not be performed. |
NMVS_NC_PCK_31 |
Status change could not be performed (no alert). |
2. Product Name to be Returned for Local Verification Transactions
When a UKNI user performs a verification transaction using the new v5 interface, against a pack that has been uploaded to the UKNI NMVS, there will be an additional field returned to the user containing the Product Name. The purpose of this change is to enable the end user dispensing the pack to confirm that the pack in hand is the same as the product that is recorded in the NMVS.
In a future release this functionality will be enhanced to provide the product name even when the pack is not uploaded to the UKNI NMVS, and the request is fulfilled by the NMVS of another country.
3. Additional User Response Fields in the Verification
When a user performs a verification transaction against a pack that has already been dispensed (or decommissioned to another status) using the new v5 interface, the NMVS will return an additional field in the response to report whether the original dispense (or decommission) transaction was performed by the same user. If the previous dispense (or decommission) transaction was performed by the same user, then another field will be returned to identify whether the transaction is within 240 hours (10 days) and therefore an undo transaction can be successfully executed.
The purpose of this change is to inform the user whether they are able to successfully perform an undo transaction on the pack they have in their hand and thus prevent an unnecessary Alert.