FHIR Implementation Guide for NJSAMS


1.0.0 - release

NJSAMS - Local Development build (v1.0.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Behavior: Capability Statements

The following artifacts define the specific capabilities that different types of systems are expected to have in order to comply with this implementation guide. Systems conforming to this implementation guide are expected to declare conformance to one or more of the following capability statements.

NJSAMSCapabilities

Structures: Questionnaires

These define forms used by systems conforming to this implementation guide to capture or expose data to end users.

Addiction Severity Index Questionnaire
AdmissionQuestionnaire
Alcohol Use Disorder Criteria

Criteria for Alcohol Use Disorder

BioPsychoSocial Questionnaire
Caffeine related Disorder Criteria

Criteria for Caffeine Use Disorder

Cannabis Use Disorder Criteria

Criteria for Cannabis Use Disorder

DASIE - Income and Program Eligibility Questionnaire
Dimension 1: Acute Intoxication / Withdrawal Potential

Justification for level of care score (see ServiceRequest) in Dimension 1

Dimension 2: Biomedical Conditions and Complications

Justification for level of care score (see ServiceRequest) in Dimension 2

Dimension 3: Emotional, Behavioral, Or Cognitive Conditions and Complication

Justification for level of care score (see ServiceRequest) in Dimension 3

Dimension 4: Readiness To Change

Justification for level of care score (see ServiceRequest) in Dimension 4

Dimension 5: Relapse, Continued Use, Or Continued Problem Potential

Justification for level of care score (see ServiceRequest) in Dimension 5

Dimension 6: Recovery Environment

Justification for level of care score (see ServiceRequest) in Dimension 1

DischargeQuestionnaire
Hallucinogen Use Disorder Criteria

Criteria for Hallucinogen Use Disorder

Inhalent Use Disorder Criteria

Criteria for Inhalent Use Disorder

Non Substance Disorder Criteria

Criteria for Non Substance Disorder

Opioid Treatment Program (OTP) - LOCI

Justification for level of care score (see ServiceRequest) in Opioid Treatment Program

Opioid Use Disorder Criteria

Criteria for Opioid Use Disorder

Other (or Unknown) Substance Disorder Criteria

Criteria for Other (or Unknown) Substance Disorder

Sedative, Hypnotic, Anxiolytic Disorder Criteria

Criteria for Sedative Hypnotic Anxiolytic Use Disorder

Stimulant Use Disorder Criteria

Criteria for Stimulant Use Disorder

Tobacco Use Disorder Criteria

Criteria for Tobacco Use Disorder

Structures: Resource Profiles

These define constraints on FHIR resources for systems conforming to this implementation guide.

NJSAMSBasePatient

NJSAMS Patient (Considered legacy, due to some data not having been available at time of creation)

NJSAMSBaseServiceRequest

NJSAMS Base ServiceRequest

NJSAMSClaim

NJSAMS Claim

NJSAMSCondition
NJSAMSCoocurringCondition
NJSAMSCoverage

NJSAMS Coverage

NJSAMSDSM5Practitioner

NJSAMS counselor/supervisor for DSM-5 conditions

NJSAMSEncounter

NJSAMS Encounter

NJSAMSLOCI3Practitioner

NJSAMS counselor/supervisor for LOCI3

NJSAMSLOCIDimensionServiceRequest

NJSAMS LOCI Dimension ServiceRequest

NJSAMSLOCIOTPServiceRequest

NJSAMS LOCI OTP ServiceRequest

NJSAMSLOCIServiceRequest

NJSAMS LOCI Final Score ServiceRequest

NJSAMSLocation

NJSAMS Location

NJSAMSOrganization

NJSAMS Organization

NJSAMSPatient

NJSAMS Patient

NJSAMSPayor

NJSAMS Funding Sources

Structures: Extension Definitions

These define constraints on FHIR data types for systems conforming to this implementation guide.

AdmitCounty

Admission county if IDRC referral

ContactJobTitle

Job title for contact at organization

ContactName

Contact details for member of NJSAMS site

Counselor

Reference to LOCI-3 Practitioner

CounselorCredentials

Credentials for counselor providing diagnosis for co-ocurring DSM5 conditions

CounselorName

Name of the counselor providing co-ocurring condition diagnosis

DistrictMunicipality

The municipality where the patient resides

GenderIdentity

Additional Gender

IncomeEligibilityScreening

Does the patient wish to complete income eligibility and screening

IsCorePackage

If the claim is a core, or enhanced package

MainDisorder

Main co-ocurring DSM5 condition

OtherAdmitSource

User specified admission (referral) source

OtherLanguage

User specified language

PackageName

Name of service package

PractitionerType

Type of Practitioners

Sequence

Clinician ranking of conditions by importance

SubDisorder

Sub co-ocurring DSM5 condition

SubstanceUsed

Name of the substance used by the client

USCitizenship

Is the patient a US citizen

UpdatedDate

Date record was last updated

UseSpecifiers

Duration and location specifiers for a substance

Terminology: Value Sets

These define sets of codes used by systems conforming to this implementation guide.

Additional NJSAMS Gender

Additional Gender of the NJSAMS Clients

NJSAMS Yes No Responses

Yes or No answer responses

NJSAMS ASI Client Companion

Companion spending most time with client in free time for ASI Questionnaire

NJSAMS ASI Crimes And Offenses

Crimes and offenses by the client, if any for ASI Questionnaire

NJSAMS ASI Employment Status

Employment status of client for ASI Questionnaire

NJSAMS ASI Marital Status

Marital status of client for ASI Questionnaire

NJSAMS ASI Oral Route of Administration

Instances where the substance can only be orally used

NJSAMS ASI Qualitative Rating

Ratings for difficulty and importance of ASI concepts

NJSAMS ASI Route Of Administration

Route of administration for drug/alcohol use by client for ASI

NJSAMS ASI Satisfied Status

Status of client satisfaction for ASI Questionnaire

NJSAMS ASI Substances

Type of substances used by client for ASI Questionnaire

NJSAMS ASI Usual Living Arrangement

Usual living arrangement for client for ASI Questionnaire

NJSAMS BioPsycho Thought Content homicidal ideation

homicidal ideation for BioPsychoSocial Questionnaire

NJSAMS BioPsycho Thought Content ideation active/passive

ideation active/passive for BioPsychoSocial Questionnaire

NJSAMS BioPsycho Thought Content suicidal ideation

suicidal ideation for BioPsychoSocial Questionnaire

NJSAMS BioPsycho affect type

types of affect for BioPsychoSocial Questionnaire

NJSAMS BioPsycho appearance type

types of appearance for BioPsychoSocial Questionnaire

NJSAMS BioPsycho attitude type

types of attitude for BioPsychoSocial Questionnaire

NJSAMS BioPsycho behavior type

types of behavior for BioPsychoSocial Questionnaire

NJSAMS BioPsycho insight/judgment type

types of insight/judgment for BioPsychoSocial Questionnaire

NJSAMS BioPsycho memory/concentration type

types of memory/concentration for BioPsychoSocial Questionnaire

NJSAMS BioPsycho mood type

types of mood for BioPsychoSocial Questionnaire

NJSAMS BioPsycho orientation type

types of orientation for BioPsychoSocial Questionnaire

NJSAMS BioPsycho perception type

types of perception for BioPsychoSocial Questionnaire

NJSAMS BioPsycho speech type

types of speech for BioPsychoSocial Questionnaire

NJSAMS BioPsycho thought content

types of thought content for BioPsychoSocial Questionnaire

NJSAMS BioPsycho thought process

types of thought process for BioPsychoSocial Questionnaire

NJSAMS Client Chronic Conditions

Client's Chronic health conditions at time of admission

NJSAMS Client Need Rating

Quantitative Rating for Need for Treatment and Services

NJSAMS Client Type

Client or Co-dependent

NJSAMS Client/Lab Response to Testing

Client/lab results for HIV testing

NJSAMS Client/Lab Response to Testing

Client/lab results for Hepatitis and Tuberculin testing

NJSAMS Client/Lab Response to Testing HIV

Did client have HIV test during treatment at this facility?

NJSAMS Co-ocurring disease counselors

Counselor credentials for diagnosing NJSAMS clients with co-ocurring diseases

NJSAMS Condition Severity

A list of severity codes for conditions, and option for non-applicable

NJSAMS Continue Care Type

Discharge Continuing Care Type

NJSAMS Counties

The county where the patient resides, or is referred from

NJSAMS Credentials

Credentials for DSM-5 and LOCI-3 counselors and supervisors

NJSAMS Current Legal Status

Legal Status at the time of admission and discharge

NJSAMS Dasie County Of Referral

Dasie County of referral for Dasie Questionnaire

NJSAMS Dasie SEPLocation

SEPLocations for Dasie Questionnaire

NJSAMS Dasie SPBOffice

SPBOffices for Dasie Questionnaire

NJSAMS Delayed Treatment

Reason to Wait for Treatment

NJSAMS Dependent/Supervised Living Arrangement

Client Dependent/Supervised living arrangements at the time of admission and discharge

NJSAMS Dimension Scores

This ValueSet contains all of the codes for the 6 LOCI Dimensions

NJSAMS Discharge Substance Use

Is Client using drugs or alcohol at Discharge?

NJSAMS Discharge goal achievement

Discharge goal achievment

NJSAMS Drug Route of Administration

Drug/alcohol Route of Administration

NJSAMS Drug Use Frequency

Frequency of drug use by client

NJSAMS Drugs Used

Substances used by NJSAMS clients

NJSAMS Education Level

The education level of the client at the time of admission

NJSAMS Employment Situation

Client Employment situation at the time of admission and discharge

NJSAMS Enrollment in School/Job Training

Client enrollment in school or job training

NJSAMS Frequency of attendance to self-help recovery groups

Client attendance to self help groups

NJSAMS Gender

Gender of the NJSAMS Clients

NJSAMS Hepatitis Types

Hepatitis Types

NJSAMS ICD10 Codes

ICD-10 Codes used in the DSM-5 Clinical Application for diagnosing severity

NJSAMS Inactive Clients

Stage in treatement where the client is no longer considered active

NJSAMS Insurance Types

Insurance Types

NJSAMS LOCI OTP Score

The LOCI Score for OTP (Opioid Treatment Program)

NJSAMS Living Arrangement

Client living arrangements at the time of admission and discharge

NJSAMS Main Disorder

Selecting main disorder for NJSAMS clients with co-ocurring diseases

NJSAMS Municipalities

The municipality where a client resides

NJSAMS Naloxone Administrator

Administrator of Naloxone to Client in last 30 Days

NJSAMS Practitioner Type

Type of practitioners for DSM-5 and LOCI-3

NJSAMS Prescription/Dispensation Medication

Entity Prescribing/Dispensing Medication

NJSAMS Reason For Discharge

Reason for Client Discharge

NJSAMS Referral Sources

Referral source list

NJSAMS Self-Help Groups

Self help Groups for admission and discharge

NJSAMS Source Of Income

Source of Income/Support

NJSAMS Stimulant

Selecting Stimulant for Stimulant Use Disorder

NJSAMS Sub Disorder

Selecting sub disorder for NJSAMS clients with co-ocurring diseases

NJSAMS Substance Induced Conditions

A list of condition codes for substance induced conditions

NJSAMS Target Populations

Target/Special populations receiving treatment

NJSAMS Tobacco Products

Tobacco Products used

NJSAMS Tobacco Treatment Agencies

Tobacco Cessation Agencies

NJSAMS Tobacco Use Treatments

Treatment techniques/tools were effective for client to end tobacco use

NJSAMS Total LOCI Scores

The Total LOCI Score for an NJSAMS Client

NJSAMS Treatment Level of Care

Level of Care for treatment

NJSAMS Treatment Medications

The medications that a client might use in treatment

NJSAMS Treatment Not Completed

Discharge reason for treatment not completed

NJSAMS Use Specifiers

The stage (if present) that the client is in with regards to substance abuse.

NJSAMS reasons why client is not in School/Job Training

Reasons for not being enrolled in school or job training

Terminology: Code Systems

These define new code systems used by systems conforming to this implementation guide.

ASI Route Of Administration

Route of administration for drug/alcohol use by client for ASI

Active/Passive Status

Active/Passive

Additional Patient Gender

Expanded Gender identity for the patient gender

Affect Type

Type of affect

Appearance Type

Type of appearance

Attitude Type

Type of attitude

Behavior Type

Type of behavior

Client Companion

Companion spending most time with client in free time

Co-ocurring Condition Main Disorder

Main DSM5 condition for client

Co-ocurring Condition Sub Disorder

Sub DSM5 condition for client

Co-ocurring condition counselors

Credentials for counselors inputting co-occurring diseases

Continuing Care Type

Discharge Continuing Care Type

Counselor And Supervisor Credentials

Clinician licensure

Crimes And Offenses

Crimes and offenses by the client, if any

Current Legal Status

Current Legal Status

DSM Codes

Codes used to rank conditions identified by clinician

Dasie County of Referral

County of Referral

Delayed Treatment Reason

Reason to Wait for Treatment

Dependant/Supervised Living Arrangement

Client info if in Dependent/Supervised Living

Dimension 1 LOCI Score

Recommended Level of Care for Dimension 1

Dimension 2 LOCI Score

Recommended Level of Care for Dimension 2

Dimension 3 LOCI Score

Recommended Level of Care for Dimension 3

Dimension 4 LOCI Score

Recommended Level of Care for Dimension 4

Dimension 5 LOCI Score

Recommended Level of Care for Dimension 5

Dimension 6 LOCI Score

Recommended Level of Care for Dimension 6

Discharge Current Legal Status

Current Legal Status

Discharge Self Help Groups

Self help Group at time of discharge

Discharge Substance Use

Drug use at time of discharge

Drug Use Frequency

Frequency of drug use by client

Drugs

Substances used by NJSAMS clients

Employment Status
EmploymentSituation

Client Employment Status

Encounter Client Type

Type of client

Encounter Education Level

The education level of the client

Encounter Enrollment Status

Client enrollment in school or job training

Encounter Referral Source

Referral source list

Gambling Use Specifiers
Goal Acheivement

Discharge goal achievment

HIV Test Administration Status

Client/lab results for HIV

HIV Test Result

Client/lab results for HIV testing

Insight/Judgment Type

Type of insight/judgment

Insurance Types

Insurance Types

LOCI OTP Score

LOCI Score for OTP (Opioid Treatment Program)

Level of Care

Level of Care for treatment

Living Arrangement

Client living arrangement

Marital Status

Marital status for the client

Memory/Concentration Type

Type of memory/concentration

Mood Type

Type of mood

Naloxone Administrator

Administrator of Naloxone to Client in last 30 Days

Need Rating

Client rating for need for treatments and services

Non-Enrollment Reason

Reasons for not being enrolled in school or job training

Orientation Type

Type of orientation

Patient County

County where patient resides (primarily New Jersey counties)

Patient Current Status

Status of the admission/encounter for a patient

Patient Ethnicity

Ethnicity of the patient

Patient Gender

Administrative gender for the patient

Patient Language

Primary language for the patient

Patient Marital Status

Marital status for the patient

Patient Municipality

Municipality where client resides

Patient Race

Race of the patient

Patient State

Current residency of the patient

Perception Type

Type of perception

Practitioner Type

Type of Practitioners

Prescription Dispensation Source

Entity Prescribing/Dispensing Medication

Qualitative Rating
Reason for Discharge

Reason for Client Discharge

Route Of Administration

Route of administration for drug use by client

SEP Locations

SEP Locations:

SPB Office

SPB District Office:

Satisfied Status

Status of client satisfaction

Self Help Attendance

Client attendance to self help groups

Self Help Groups

Self help Groups

Source of Income

Source of Income/Support

Speech Type

Type of speech

Substances

Problematic substance used by clients

Target Populations

Target/Special populations receiving treatment

Testing Services Response

Client/lab results for Hepatitis and Tuberculin testing

Thought Content (Homicidal Ideation)

Homicidal Ideation

Thought Content (Suicidal Ideation)

Suicidal Ideation

Tobacco Cessation Agencies

Agencies that treat tobacco use

Tobacco Treatment Techniques

Treatment techniques/tools were effective for client

Total LOCI Score

Level of Care Indicated in LOCI-3

Treatment Not Completed

Discharge treatment not completed

Types of Thought Content

Type of thought content

Types of Thought Process

Type of thought process

Uncategorizable Codes

The following codes stand as catch-all for undefined and no-value

Use Specifier

Specifiers describing features of substance abuse

Usual Living Arrangement

Usual living arrangement for client

Yes No Responses
stimulant

Terminology: Concept Maps

These define transformations to convert between codes by systems conforming with this implementation guide.

LevelOfCareToEncounterClass
NJSAMSEthnicityMap
NJSAMSGenderMap
NJSAMSLanguageMap
NJSAMSMaritalStatusMap
NJSAMSRaceMap
NJSAMSRouteOfAdministrationMap
NJSAMSStateMap

Example: Example Instances

These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like.

AlcoholDisorder

Example Condition: Alcohol Disorder, No Specifiers

CoverageComplete

Example Coverage

DSM5Counselor

Example of complete DSM-5 Counselor

DSM5Supervisor

Example of complete DSM-5 Counselor

EncounterComplete

Example Active Encounter

FFSClaimComplete

Example Fee For Service Claim

InhalantDisorder

Example Condition: Inhalant Use Disorder

LOCI3Counselor

Example of complete LOCI-3 Counselor

LOCI3Supervisor

Example of complete LOCI-3 supervisor

LocationComplete

Example for NJSAMS TX Program Name

MedicaidClaimComplete

Example Medicaid Claim

MedicaidCoverage

Example Medicaid Coverage

OpioidInducedDisorder

Example Condition: Opioid Induced Disorder, No Specifiers

OrganizationComplete

Example Organization with Director

PatientComplete

Example of complete patient details

PatientDetailedEthnicity

Example of a patient with detailed ethnicity

PatientOtherEthnicity

Example of a patient with other ethnicity

PatientOtherLanguage

Example of a patient with other language

PayorPrimary

Example of Complete Payor

PayorSecondary

Example of Complete Payor

ServiceRequestComplete

Example of complete ServiceRequest with discharge plan and recommendation

ServiceRequestDimensionScore

Example ServiceRequest with discharge plan

ServiceRequestOTPScore

Example LOCI ServiceRequest for OTP Patient

UnspecifiedOpioidRelatedDisorder

Example Condition: Unspecified Opioid Related Disorder

Other

These are resources that are used within this implementation guide that do not fit into one of the other categories.

AdmissionQuestionnaireResponse

Admission Questionnaire Response

DischargeQuestionnaireResponse

Discharge Questionnaire Response