Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

XML File

...

Excel File

...

Template 

Use one of the following templates to fill in encounters:

  1. The default format - Encounter.Submission Default_Template.xlsx.
  2. The MBDS format - Encounter.Submission MBDS_Template.xlsx.

Data description

The table below describes each column in expected Excel file.

Encounter
WorksheetColumn (Default Template)Column (MBDS Template)Description
Header
SenderID
Possible Values or Format
Encounters



















Sender IDSender ID
ReceiverIDEncounter ID
An identification code of a healthcare provider that is the sender of the transaction.
Receiver ID
TransactionDate
= Encounter.Start
RecordCount
= Encounters count
DispositionFlag
DispositionFlag = DispositionFlagEnum.ProductionEncounter
Id
Receiver IDAn identification code of the receiver of the transaction. Predefined value is MOH.MOH
Encounter IDEncounter NumberA unique key that is generated by a healthcare provider. Cannot be re-assigned to another encounter/visit.
ProviderCode

Provider CodeUnique Health Care Facility IdentifierA healthcare provider identification code. Unique for each facility.
ProviderType

Provider TypeHealthcare Facility Sector IdentifierType of a healthcare provider dealing with specified group of patients according to a certain set of regulations.
NationalId
Codes
National IDPatient National Identity Number (KSA-ID)/Entry NumberA national identifier
that uniquely identifies an individual
of a person.
PatientId

Patient IDPatient
ID
Identifier (UMRN)A patient medical record number. The number is used by the hospital as a systematic documentation of a patient's medical history and care during each hospital stay or visit.
BirthDate

Patient Primary EligibilityPatient Primary EligibilityThis field describes the health sector to which the Patient belongs.
Birth DateDate of BirthThe date of birth of a patient as per identification document.
BirthCountry
dd/mm/yyyy
Birth CountryCountry of BirthA code of a country in which the
person
patient was born. It refers to a country if the person was born outside Saudi Arabia. The geographic location is specified according to boundaries current at the time the data
are
is collected, not the boundaries at the time of birth.

Codes

GenderGenderA code which defines the sex of a patient.Codes
NationalityNationalityA code which defines the nationality of a patient as stated in the identification document used for patient identity proof.
ResidenceCountry
Codes
Residence CountryCountry of ResidenceA code of a country of residence of a patient as stated in the identification document used for patient identity proof.
ResidenceCity
Codes
Residence CityCity of ResidenceA code of a city of residence of a patient.Codes
ReligionReligionA religion which is a patient self-identification as having a connection or affiliation with any religious denomination, group. For infants or children, religion refers to the specific religiousgroup or denomination in which they are being raised, if any.
PilgrimType
Codes
Pilgrim TypeHAJJ/Umrah Season PatientA flag to indicate if a patient is internal/external Hajj, as represented by a code.Codes
MaritalStatus
Marital StatusMarital StatusA code that defines marital status of a patient.Codes
OccupationOccupationSelf-reported employment status of a patient, immediately prior to receiving healthcare services.
MobileNumber
Codes
Mobile NumberMobile phone numberContact mobile telephone number of a patient as stated by the individual.
TypeEncounter Type

A type of the encounter/visit, as represented by a code

:

1= Hospital Inpatient - patient occupys inpatient bed and stays overnight;

2= Day Case - patient occupies bed and is disharged on the same day;

3= Emergency - patient is seen in Emergency Department and is not admitted to Inpatient Bed;

4= Outpatient - patient not admttted and not seen in Emergency Department.

AdmissionType

.


Codes
Admission TypeAdmission TypeA code which identifies how a patient was admitted to hospital.Codes
EmergencyArrivalCodeEmergency Arrival CodeThe mode of transport by which the patient arrives at the emergency department, as represented by a code.CareTypeStartStart
Service Event TypeInitial or Subsequent Service EventAn indicator of whether the service event is the first service event for a new referral or a follow up service event.
Care TypeCare Type

The nature of clinical service provided to an admitted patient during an episode of care, acute vs. sub-acute, as represented by a code.

01= Acute Care;

02= Rehabiitation;

03=General Maintenance;

04= Complex Maintenance;

05= Boarder;

06= Palliative.


Codes

StartAdmission Date/Outpatient Service Event Date/Encounter Start Date & TimeIP and OP: The date the patient is admitted to hospital at the sart of a hospital stay.
ED: The date (time) on which non-admitted patient emergency department clinical care commences.
dd/mm/yyyy hh:mm
EndDischarge Date/Encounter End Date & TimeThe date the patient is discharged from the inpatient care referenced in the applicable hospitalization or hospice date.
TriageDate
dd/mm/yyyy hh:mm
Triage DateTriage Date/TimeThe date on which the patient is triaged.
TriageCategory
dd/mm/yyyy hh:mm
Triage CategoryTriage CategoryA catetory assigned to a patient as a result of an initial assessment by medial or nursing staff in an Accident and Emergency Deparment. Used to determine the patient's priorty for treatment, and to informa the patient of their waiting time.
WaitingTime
Codes
Emergency Arrival CodeED Arrival Mode (Transport)The mode of transport by which the patient arrives at the emergency department, as represented by a code.Codes
Emergency Service StartED Service Commencement Date/TimeThis is the date and time the clinician starts to treat the patient.
Emergency Waiting TimeED Waiting TimeThe time elapsed in minutes for a patient from presentation in the emergency department to a service occurrence of a speicifed event related to service delivery.
AdmissionSpecialty

Admission SpecialtySpecialty on Admission
Specialty
An identifier of the specialty practiced by the health practitioner.Codes
AdmissionWeight
Admission WeightAdmission Weight < 1-year-oldBirth weight and Neonatal Weight are defined separately.
IntendedLos

Intended LosIntended
Los
LOSThe intention of the responsible clinician at the time of the patient's admission to hospital or at the time the patient is placed on an elective surgery waiting list, to discharge the patient either on the day of admission or a subsequent date, as represented by a code.
LeaveDuration
Codes
Leave DurationDuration of LeaveSum of the length of leave (date returned from leave minus date went on leave) for all periods within the hospital stay.
DischargeMode

Discharge ModeDischarge Mode/Status/DispositionA code which defines the circumstances under which a patient left hospital. For the majority of patients this is when they are discharged by the consultant.
EmergencyDispositionCodeDischargeSpecialtyDischarge Specialty
Codes
Emergency Disposition CodeED Disposition Code

The status of the patient at the end of the non-admitted patient emergency department service episode, as representd by a code.

1= admitted to this hospital;

2= Non-admtted patient ED eptisde completed-departed without being admtted or referred to aother hospital;

3= non admitted patient ED episode completed -referred to aother hospital for admission;

4= did not wait to be attended by a health care professional;

5= left at own risk after being attended by a health care professional, but before the non-admitted patient ED service episode was completed.


Codes

Discharge SpecialtySpecialty at DischargeAn identifier of the specialty practiced by the health practioner.
EmergencyMajorDiagnosticBlock
Codes
Emergency Major Diagnostic BlockED Major Diagnostic Block (MDB) Category CodeEmergency department major diagnostic block.Codes
MDCMDCThe category into which the patient diagnosis and the assocated Australian refined diagnosis related group (ARDRG) falls, as represented by a code.Codes
PCCLPCCLA measure of the cumulative effect of a patient’s complications and comorbidities (CCs) that is calculated for each episode of admitted patient care. Each diagnosis is assigned CCL (Clinical Complexity Level).
DiagnosisDiagnosis
Codes
CommentsCommentsThis field contains comments related to the encounter.
DiagnosesEncounter ID
Type
Encounter NumberReference to Encounter ID on Encounters worksheet
Diagnosis Type-

A diagnosis type, as reprsented by a code.

Note:


1 = Principal
2 = Secondary
3 = Morphology
4 = DeathCauseCode

 This field is not expected for MBDS format.

Codes


Diagnosis CodeOPD Primary Diagnosis CodeThe main diagnoses refelecting the main injuries, disease condition, paitent characteristics or cirumstances impacting the outpatient service event, as determinied by the physician at the conclusion of the visit.
ConditionOnsetFlag

Principal Diagnosis (ICD-10-AM 6th edn)
Additional Diagnosis (ICD-10-AM 6th edn)
Morphology
Cause of Death
Condition Onset FlagCondition Onset FlagA qualifier for each coded diagnosis to indicate the onset of the condition relative to the beginning of the episode of care, as represented by a code.
Activity
Codes
Activity
Activities



Encounter ID
Id
Encounter NumberReference to Encounter ID on Encounter worksheet
Activity IDActivity NumberActivity id sent by a healthcare provider. An activity is unique within an encounter.
Activity Type
Activity TypeCodeActivity Code
-

Activity type, as represented by a code.

Note:


1 = ACHI;
2 = Trade Drug;
3 = AR-DRG.

This field is not expected for MBDS format.

Codes

Activity CodeAR-DRGA patient's classification scheme which provides a clinically meaningful way of relating the number and types of patients treated in a hospital to the resources required by the hospital, as represented by a code.
OrderingClinicianCode

Procedure Codes
Laboratory Code
Drug Item Codes
QuantityDrug Item Units (Quantity)The quantity of each drug item defined in "Drug Item Codes" dispensed for the treatment of ill health during this encounter.
Ordering Clinician CodeHealthcare Practitioner IDA unique identificatoin code of a clinician provided by the Saudi Commission for Health Specialties for the Consultant
(
.NNAANNNN… Alpha numeric, 5-16 characters
).
Observation
Comments
Observation
Encounter IDActivity IDTypeObservation TypeAn observation type:
1 = LOINC;
2 = Text;
3 = File.CodeObservation CodeThe tests, measurements, and observations conducted with value and unit, as represented by a code.ValueObservation ValueAn observation value for the activity.

ValueType

Observation Value TypeUnit of measure for an observation value
CommentsThis field contains comments related to the activity.