A. Setup and Configuration

 

There are a few VERY important things that need to be setup correctly in order for this to work.

 

1. Master Account

 

A Master Account needs to be created for the NHLS in the Administration > General > Accounts management section. 

 

Please make the “Account Number: NHLS” and the “Account Type: Programme”.

 

We NEED this when creating the request as these are going to be captured as “Request Type: Corporate”.

 

2. Client

 

A Client needs to be created for the NHLS in Administration > General > Client Management.

 

It is extremely important to set “Exclude From Disease Reporting: Yes” as NHLS will do their own reporting to NICD and preLink MUST NOT upload to the NICD. This setting will prevent preLink from automatically adding the NICD as a “Copy Doctor”.

 

The “Edi Type: NHLS” must be set as well otherwise requests will not be uploaded back to NHLS.

 

3. Client Location

 

A Client Location will need to be created for each of the NHLS labs that will be sending work through to NCG. 

 

e.g. the NHLS referral file contains a “Current User Site Code” and a “Current User Site name” that indicates the NHLS lab that is sending the specimen.

 

4. Service – Test Mapping

 

The test code used to identify the SARS-CoV-2 test NEEDS to be linked in the test mapping of the NHLS service in Administration > General > System Configuration > Service Options > NHLS Service > “Tests” link.

 

Select the correct SARS-CoV-2 test being run by NCG and the “Code” field value must exactly match the “Test Code” field value received in the NHLS CSV file. 

 

5. Service – Client Location Mapping

 

The code used to identify the NHLS lab NEEDS to be linked in the doctors mapping of the NHLS service in Administration > General > System Configuration > Service Options > NHLS Service > “Doctors” link.

 

Select the correct NHLS Client Location and the “Code” field value must exactly match the “Current User Site Code” field value received in the NHLS CSV file. 

 

B. Process flow

 

The interface periodically checks the NHLS sFTP site for new files to process. If a file(s) is found, the interface will retrieve the pipe delimited CSV file(s) (which contains sample and patient information) and then process each line at a time and do the following:

 

  1. Generate a new Request with the “Request Type: Corporate”,
  2. The Request “Doctor Reference” is set to the “Episode No” (their unique specimen reference) from the CSV,
  3. The Request Master Account is set to the Account retrieved using “Account Number: NHLS”,
  4. The Referring Doctor is set by using the mapping of the “Current User Site Code” from the CSV and a Client Location in the Service_ClientLocation table,
  5. Generate a new Patient with ID Number “NA” but using the other demographics in the CSV,
  6. Order the test using the mapping of the “Test Code” from the CSV and a Test in the Service_Test table