Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Added specimen information from messaging guide


Panel
titleNAHLN Messaging Resources

LMS_PRV_Messaging_ Guide_v1.0.pdf

NAHLN Certificate from Test URL 2.2019.cer


Panel
titleNAHLN Job Interface Setup

API - Message Setup for NAHLN PRV

Message Profile (MSH)

  • To report to NAHLN: Username, Password, and Auth Token or Certificate are required.
  • The Schema Definition is not required, but if present the API will validate the message before posting it to the NAHLN website.
  • Failure Email should go to a VetView user with admin privileges who is able to monitor the messages.

Message Type:  NAHLN OPU_R25 - HL7

  • MSH.3 Sending Application is your Laboratories OID. OID Registry
  • MSH.4 Sending Facility is your Laboratories Premise ID
  • MSH 5 & 6 are NAHLN's information.

Patient PV1

Role ROL1

ROL13/PL6 Person Location Type

Use the Client Identifier of Premises ID.


Next of Kin NK1

Patient Identifier PID3 Settings

PID.38 Production Class Code

This field should be linked to a Catalog Test Question that is required for all catalog items that include this test. 

Info
titleLinking Value Lists to NALHN Forms using Catalog Test Questions

In VetView, required Questions are automatically added to accessions for tests using the Catalog.   These can be filled out by the submitting client.

These questions can then be linked to the NALHN messaging forms to ensure that the required information is sent in a valid format. 

Step 1: Create a value list with the valid types under Value List Setup.  (Some NALHN messages have identical lists and you can reuse them on new questions.  In this example, PRV will reuse the ASF list.)

Step 2: Create a question using this value list under Question Setup.  

Step 3:  Add this question to the Catalog item to link it to the tests that will send this message to NAHLN.  (You may choose to set this as Required to ensure it is filled out by the client on the Portal, or have the question answered during Accession Receiving.)

Image Added

OBX Patient Observations - Include Age Group

This is a value list that should also be linked to a Catalog Test Question for all catalog items that include this test.  

Image Added

Specimen SPM

Image Added

SPM.14 Specimen Description

This should also be value list linked to a Catalog Test Question for all catalog items that include this test. 

Image RemovedImage Added


Panel
titleSpecimen Setup

Specimen Setup

NAHLN restricts the specimens for each test.  (Include the list of permitted codes for this disease, if known.)  

Serum is the only permitted specimen for PRV.

Image Added

Ensure that the appropriate SNOMED codes are in the Specimen Setup for correct matching.

Image Added


Panel
titleTest Setup - Messaging Definition

Test Setup - Messaging Definition

In addition to the settings on the Job and Interface for NAHLN, you will need to add the Electronic Messaging Setup for each test that will report (disease name) to NAHLN.

Image Modified

Message Profile Name

Choose the profile name you created under the Job and Interface Settings above.

Image Modified

OCR.4 Placer Group Number

When selecting Reference Number Authority, please ensure that there is a Reference Number included in the header of each accession for this test.

Image Modified

OBR.31 Reason for Submission

Set up up a Catalog Test Question that is restricted to a value list of acceptable reasons for submission for PRV.

Image Modified

OBX.5 Observation Value

This value should be the result name that holds the CT value in test setup.  

Image Modified

OBX.8 Abnormal Flags Interpretation

This field should be disabled for this test (it may be identical to OBX.5), or should use a valid list of allowed interpretations.


Table of Contents