Veterinary Terminology & Standards - Va Md College of Veterinary Medicine - Va Tech
VetSCT Browser Education Login/Register

USDA Veterinary Services - NAHLN Support

Terminology Resources | NAHLN Messaging Support | AHRMS Messaging Support

Message Schemas

The following link is designed to give users a generic url (without the schema version) that users can include as the schema in their xml. This would allow you to be sure that you are always validating against this latest posted schema without having to download a new copy and update your xml each time a new version is created. If you prefer to have a local copy of the current schema, you can follow the instructions below for downloading a copy. Previous versions are also available below.

Current Base Schema (V2.1):https://vtsl.vetmed.vt.edu/vs/Documents/NAHLNMessageSchemas/NAHLNResultBase.xsd
(To Save a copy locally: In Chrome or Edge, right-click and select Save Link As.. In Safari, Control+Click and select Download Linked File)

Please note that for messaging, file name must include the version number, but without the file extension. See sample text below.

<MSH.21>
   <EI.1>NAHLNResultBaseV2.1</EI.1>
   <EI.3>2.16.840.1.113883.3.5.9</EI.3>
   <EI.4>ISO</EI.4>
</MSH.21>

Previous Schemas:

(To Save a copy locally: In IE or Netscape, right-click and select Save Target As.. In Foxfire, right-click and select Save Link As...)
Base Schema Version 2.0
Base Schema Version 1.9.5
Base Schema Version 1.9.4

Message Transformation

An xsl transformation file is provided here to give users an easy way to render your xml result messages into a human-readable format. Copy/paste the following into your XML message on Line 2, immediately following the "". Download and put the .xsl file in the same folder with your XML document. You should then be able to point your web browser or favorite XML program at the XML file and view it in a more human-readable format. Please post any comments or suggestions regarding the Transformation on the NAHLN documents forum.

<?xml-stylesheet type='text/xsl' href='NAHLNResultHTML.xsl'?>

To download a copy of the transform and save it locally, right click on the following link and save the file to your disk.

https://vtsl.vetmed.vt.edu/vs/Documents/NAHLNMessageTransforms/NAHLNResultHTML.xsl

Documents

VS SSL Certificate (March 2023) zip file
VS SSL Certificate (March 2023) 7-zip file
Once downloaded: Extract files, Choose appropriate type, Remove ".rename"

The NAHLN Electronic Messaging Guide, NVSL-WI-1781, contains requirements and guidance for electronically messaging test results. It is a controlled document and available through your lab's quality management system.


Quick User Guide to HL7 Messaging (uploaded Sept 2016)

NAHLN Result Messaging Implementation Guide (V.5 updated May 2020)

NAHLN Order & Response Messaging Implementation Guide (V.5 updated May 2020)

Hitchhiker's Guide to NAHLN Messaging (updated May 2021)

NAHLN Message Map Template (updated October 2018)

USALIMS NAHLN Messaging Guide (Updated February 2022)

NAHLN IS Lab Registry Job Aid

NAHLN IS OID User Guide


Helpful Links

LOINC®
AAVLD OID Registration & Search
Integrated Taxonomic Information System (ITIS)
Animal Diversity Web
World Bird Guide

©2025 VTS, a division of the Veterinary Medical Informatics Laboratory at Virginia-Maryland College of Veterinary Medicine | +01 (540) 231-5193 | vtsl.info@vt.edu