ADT A28: Create a new medical record
This message will either create or update a medical record in PKB. If the specified medical record (identified by the PID segment) is not found, it will be created. Otherwise, it will be updated.
If an update is performed, then the entire set of medications, allergies or diagnoses sent by your Organisation will be replaced, depending on what is sent. Note - this includes any medications, allergies or diagnoses added by a Professional from your Organisation. For example, if a Professional from your Organisation manually adds an allergy, but then a different allergy is provided in an A28 message from your Organisation, the entry manually added by the Professional will be replaced.
If an update is performed to a medical record that sits outside of your Organisation then the update will be performed to that medical record but the record will remain in it's current Organisation / Organisation Network. The act of sending an A28 from your Organisation will not automatically add or invite the patient to your Organisation.
If you provide an email address in the message then this will be added to the record and the patient will be sent an email invitation to register (unless they have already registered, in which case they are sent a request to confirm the newly added email address). See here for more information on how PKB handles email addresses.
Patient demographic information is used to populate [[Patient]] entities, including [[Contact]], [[National ID]], [[Organisation Level ID]] and [[Team Level ID]] entities. [[National ID Type]], [[Organisation Level ID Type]] and [[Team Level ID Type]] must match pre-agreed information; new types cannot be created via HL7 messaging.
Allergy information is used to populate [[Allergy]] entities
Diagnosis information is used to populate [[Diagnosis]] entities
Medication information is used to populate [[Medication]] entities
Please click through to the Data Model to explore the presentation of these entities in the web interface.
Create a new patient with these IDs, demographics, medications list, allergies, and diagnoses.