ADT-A01 to FHIR Mapping Rules

FHIR Resource HL7v251ADTA01-FHIR.ems Details
AllergyIntolerance The AL1 segment (Patient Allergy Information). Information about the Patient(AllergyIntolerance/patient) for this resource is received from the PID(Patient Identification) segment.  
Patient The PID segment (Patient Identification) and additional information such as address, gender, and so on is received from the NK1 segment (Next of Kin / Associated Parties). PatientID is the SHA-256 code of concatenated fields: Given Name (PID.05.02), Surname (PID.05.01.01 or PID.05.01.03 when PID.05.01.01 is missing, or PID.05.01.05 when PID.05.01.01 and PID.05.01.03 are missing) and the first eight characters (CCYYMMDD) from the Patient`s Date/Time of Birth (PID.07). If all these fields are empty, the resource is considered "Unknown".
Communication Internal properties and the system date. The Communication resource is created for the Patient resource.
DetectedIssue The AL1 segment (AllergyIntolerance information). Information about the Patient(DetectedIssue/patient) for this resource is received from the PID(Patient Identification) segment. Mapping is suppressed, since there is no information about what is different from the AllergyIntolerance resource.
Procedure The PR1 segment (Procedures) and the PV1 segment (Patient Visit). Information about the Practitioner for this resource is received from the PR1.12 segment for Practitioner(ProcedurePractitioner1), the PR1.11segment for the Practitioner(Surgeon), the PR1.8 segment for the Practitioner(Anesthesiologist), and the ROL.4 and ROL.3 segment roles for the Practitioner(ProcedurePractitioner2). Information about the Patient for this resource is received from the PID(Patient Identification) segment. Procedure is mapped only when ProcedureID(PR1.1) and PatientID are present. Only one Patient from the HL7 data can be mapped at a time.
Practitioner The segment OBX.16 (Observation/Result) has information on the Practitioner(ResponsibleObserver). Mapping is suppressed.
  The Segment Role (ROL.4, ROL.3) has information on the Practitioner(EncounterPractitioner).  
  The PV1.17 segment has information on the Practitioner(AdmittingDoctor).  
  The PV1.7 segment has information on the Practitioner(AttendingDoctor).  
  The PR1.12 segment has information on the Practitioner(ProcedurePractitioner1).  
  The PR1.11segment has information on the Practitioner(Surgeon).  
  The PR1.8 segment has information on the Practitioner(Anesthesiologist).  
  The segment roles ROL.4, ROL.3 have information on the Practitioner(ProcedurePractitioner2).  
Encounter The PV1 segment (Patient Visit). Information about the Patient(Encounter/subject) for this resource is received from the PID(Patient Identification) segment. Information for the Participant(Encounter Practitioner) for this resource is received from the ROL (Role) segment, the Participant(Attending Doctor) is received from the PV1.7 segment (Patient Visit.Attending Doctor), the Participant(Admitting Doctor) is received from the PV1.17 segment (Patient Visit.Admitting Doctor). Admitting and Attending Doctor can be mapped as Participant only if the ID is present. Encounter/participant/period/start and Encounter/participant/period/end date is received from ROL.04.19 and ROL.04.20 for the Encounter Practitioner and from EVN.02 for the Admitting Doctor and the Attending Doctor.

Limitations:

  1. A lot of FHIR elements with the ID type have patterns similar to the following: [A-Za-z0-9\-\.]. To avoid invalid FHIR data, characters that are supported by the HL7 standard, but not supported by the FHIR standard are suppressed in this map.
  2. Only one Patient for a transaction is processed.