Implementation Guide
23.1.0 - R4 APIs

Publish Box goes here

Resource Profile: AthenaMedicationStatement - Mappings

Active as of 2022-03-01

Mappings for the athena-medstatement-profile resource profile.

Mappings for athenaFlow (http://unknown.org/athenaFlow)

AthenaMedicationStatement
MedicationStatementFHIRR4_MEDICATIONSTATEMENTVIEW
   id%MEDICATEGROUPID%
   meta
      versionId%RESOURCEID%
      lastUpdated%WHENUPDATED%
      security
      security (SENSITIVECHART)CheckSensitive(%SENSITIVECHART%)
      security (CONFABBR)
         systemgetSiteCodeSystem("ConfidentialDocument")
         code%CONFABBR%
      tagMakeChangeTagList(%CHANGE%)
   extension
   extension (ndc)
      value[x]MakeConcept(%NDCNUM%,"http://hl7.org/fhir/sid/ndc",null)
   extension (ddid)
      value[x]MakeConcept(%DDID%,"http://docs.wolterskluwercdi.com/codesystems/ddid",null)
   extension (rxnorm)MakeRxnormExtensionList(%RXNORM%,"http://www.nlm.nih.gov/research/umls/rxnorm",null, "https://docs.mydata.athenahealth.com/fhir-r4/StructureDefinition/athena-medstatement-extension-rxnorm")
   extension (medcategory)
      value[x]%MEDCATEGORY%
   identifierMakeIdentifier("U",getSiteIdSystem("ExtMedication"),%EXTMEDICATEID%)
   statusIsActiveOrMapCode(%STOPDATE%,"active",%STOPREASON%,"MEDSTOPREASON")
   medication[x]MakeMedicationReference("MEDINFO",%DDID%,"Medication",%DESCRIPTION%,%NDCNUM%)
   subjectMakeReference("PATIENT",%PID%,"Patient")
   contextMakeReference("MEDICATE",%SDID%,"Encounter")
   effective[x]MakePeriod(%STARTDATE%,%STOPDATE%)
   dateAsserted%WHENCREATED%
   informationSourceMakeReference("USR",%CREATOR%,"Practitioner")
   derivedFromMakeReferenceList("PRESCRIB",%PTID%,"MedicationRequest")
   reasonReferenceMakeReference("PRESCRIB",%PROBID%,"Condition")
   notemakeAnnotation(%COMMENTS%)
   dosage
      text%INSTRUCTIONS%
      timingMakeTiming(%PERIOD%,%PERIOD_UNIT%)
      routeMapConcept(%ROUTE%,"MEDICATIONROUTE")
      doseAndRate
         dose[x]MakeNonZeroQuantity(%DOSE%,%DOSE_UNIT%)

Mappings for athenaPractice (http://unknown.org/athenaPractice)

AthenaMedicationStatement
MedicationStatementFHIRR4_MEDICATIONSTATEMENTVIEW
   id%MEDICATEGROUPID%
   meta
      versionId%RESOURCEID%
      lastUpdated%WHENUPDATED%
      security
      security (SENSITIVECHART)CheckSensitive(%SENSITIVECHART%)
      security (CONFABBR)
         systemgetSiteCodeSystem("ConfidentialDocument")
         code%CONFABBR%
      tagMakeChangeTagList(%CHANGE%)
   extension
   extension (ndc)
      value[x]MakeConcept(%NDCNUM%,"http://hl7.org/fhir/sid/ndc",null)
   extension (ddid)
      value[x]MakeConcept(%DDID%,"http://docs.wolterskluwercdi.com/codesystems/ddid",null)
   extension (rxnorm)MakeRxnormExtensionList(%RXNORM%,"http://www.nlm.nih.gov/research/umls/rxnorm",null, "https://docs.mydata.athenahealth.com/fhir-r4/StructureDefinition/athena-medstatement-extension-rxnorm")
   extension (medcategory)
      value[x]%MEDCATEGORY%
   identifierMakeIdentifier("U",getSiteIdSystem("ExtMedication"),%EXTMEDICATEID%)
   statusIsActiveOrMapCode(%STOPDATE%,"active",%STOPREASON%,"MEDSTOPREASON")
   medication[x]MakeMedicationReference("MEDINFO",%DDID%,"Medication",%DESCRIPTION%,%NDCNUM%)
   subjectMakeReference("PATIENT",%PID%,"Patient")
   contextMakeReference("MEDICATE",%SDID%,"Encounter")
   effective[x]MakePeriod(%STARTDATE%,%STOPDATE%)
   dateAsserted%WHENCREATED%
   informationSourceMakeReference("USR",%CREATOR%,"Practitioner")
   derivedFromMakeReferenceList("PRESCRIB",%PTID%,"MedicationRequest")
   reasonReferenceMakeReference("PRESCRIB",%PROBID%,"Condition")
   notemakeAnnotation(%COMMENTS%)
   dosage
      text%INSTRUCTIONS%
      timingMakeTiming(%PERIOD%,%PERIOD_UNIT%)
      routeMapConcept(%ROUTE%,"MEDICATIONROUTE")
      doseAndRate
         dose[x]MakeNonZeroQuantity(%DOSE%,%DOSE_UNIT%)

Mappings for Workflow Pattern (http://hl7.org/fhir/workflow)

AthenaMedicationStatement
MedicationStatementEvent
   identifierEvent.identifier
   basedOnEvent.basedOn
   partOfEvent.partOf
   statusEvent.status
   statusReasonEvent.statusReason
   medication[x]Event.code
   subjectEvent.subject
   contextEvent.context
   effective[x]Event.occurrence[x]
   reasonCodeEvent.reasonCode
   reasonReferenceEvent.reasonReference
   noteEvent.note

Mappings for RIM Mapping (http://hl7.org/v3)

AthenaMedicationStatement
MedicationStatementEntity. Role, or Act, SubstanceAdministration
   meta
      idn/a
      extensionn/a
      security
      security (SENSITIVECHART)
      security (CONFABBR)
         idn/a
         extensionn/a
         system./codeSystem
         version./codeSystemVersion
         code./code
         displayCV.displayName
         userSelectedCD.codingRationale
   textAct.text?
   containedN/A
   extension
   extension (ndc)
      idn/a
      extensionn/a
      urlN/A
      value[x]N/A
   extension (ddid)
      idn/a
      extensionn/a
      urlN/A
      value[x]N/A
   extension (rxnorm)
   extension (medcategory)
      idn/a
      extensionn/a
      urlN/A
      value[x]N/A
   modifierExtensionN/A
   identifier.id
   basedOn.outboundRelationship[typeCode=FLFS].target[classCode=SBADM or PROC or PCPR or OBS, moodCode=RQO orPLAN or PRP]
   partOf.outboundRelationship[typeCode=COMP]/target[classCode=SPLY or SBADM or PROC or OBS,moodCode=EVN]
   status.statusCode
   statusReason.inboundRelationship[typeCode=SUBJ].source[classCode=CACT, moodCode=EVN].reasonCOde
   category.inboundRelationship[typeCode=COMP].source[classCode=OBS, moodCode=EVN, code="type of medication usage"].value
   medication[x].participation[typeCode=CSM].role[classCode=ADMM or MANU]
   subject.participation[typeCode=SBJ].role[classCode=PAT]
   context.inboundRelationship[typeCode=COMP].source[classCode=ENC, moodCode=EVN, code="type of encounter or episode"]
   effective[x].effectiveTime
   dateAsserted.participation[typeCode=AUT].time
   informationSource.participation[typeCode=INF].role[classCode=PAT, or codes for Practioner or Related Person (if PAT is the informer, then syntax for self-reported =true)
   derivedFrom.outboundRelationship[typeCode=SPRT]/target[classCode=ACT,moodCode=EVN]
   reasonCode.reasonCode
   reasonReference.outboundRelationship[typeCode=RSON]/target[classCode=OBS,moodCode=EVN, code="reason for use"].value
   note.inboundRelationship[typeCode=SUBJ]/source[classCode=OBS,moodCode=EVN,code="annotation"].value
   dosagerefer dosageInstruction mapping
      idn/a
      extensionn/a
      modifierExtensionN/A
      sequence.text
      text.text
      additionalInstruction.text
      patientInstruction.text
      timing.effectiveTime
      asNeeded[x].outboundRelationship[typeCode=PRCN].target[classCode=OBS, moodCode=EVN, code="as needed"].value=boolean or codable concept
      site.approachSiteCode
      route.routeCode
      method.doseQuantity
      doseAndRate
         idn/a
         extensionn/a
         dose[x].doseQuantity
         rate[x].rateQuantity
      maxDosePerPeriod.maxDoseQuantity
      maxDosePerAdministrationnot supported
      maxDosePerLifetimenot supported

Mappings for FiveWs Pattern Mapping (http://hl7.org/fhir/fivews)

AthenaMedicationStatement
MedicationStatement
   identifierFiveWs.identifier
   statusFiveWs.status
   categoryFiveWs.class
   medication[x]FiveWs.what[x]
   subjectFiveWs.subject[x], FiveWs.subject
   effective[x]FiveWs.done[x]
   dateAssertedFiveWs.recorded
   informationSourceFiveWs.source
   reasonCodeFiveWs.why[x]
   reasonReferenceFiveWs.why[x]

Mappings for HL7 v2 Mapping (http://hl7.org/v2)

AthenaMedicationStatement
MedicationStatement
   meta
      security
      security (SENSITIVECHART)
      security (CONFABBR)
         systemC*E.3
         versionC*E.7
         codeC*E.1
         displayC*E.2 - but note this is not well followed
         userSelectedSometimes implied by being first
   subjectPID-3-Patient ID List
   dosage
      sequenceTQ1-1
      textRXO-6; RXE-21
      additionalInstructionRXO-7
      patientInstructionRXO-7
      asNeeded[x]TQ1-9
      siteRXR-2
      routeRXR-1
      methodRXR-4
      doseAndRateTQ1-2
         typeRXO-21; RXE-23
         dose[x]RXO-2, RXE-3
         rate[x]RXE22, RXE23, RXE-24
      maxDosePerPeriodRXO-23, RXE-19