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.