FHIR for clinicians: understanding data standards without writing code

1. Do clinicians need to know FHIR?

Short answer: no, it isn't required. Clinicians don't need to read technical specifications, learn programming, or memorize the names of data resources. The EMR software handles all of that.

But three things are worth knowing — each takes less than five minutes to grasp:

• What FHIR is. It's a set of conventions that lets healthcare software exchange data in a standardized way — much like how banks agreed on shared account numbers and transaction codes.
• Codes versus free text. When recording a diagnosis, clinicians pick a code from a catalog instead of typing prose. Codes let social health insurance (BHYT) reimburse correctly and let AI interpret the data correctly.
• What the personal health record on VNeID is. Patients will ask about it. The standard answer is in section 7 below.

Think of FHIR like electricity. A clinician doesn't need to know how current flows through the wires to switch on the exam light. But knowing which outlet is for the ventilator and which is for the suction pump prevents accidents.

2. If you do understand FHIR, what do you gain?

Five concrete benefits that anyone in clinical practice will appreciate:

1. Read a transferred patient's history on arrival. A patient arrives from a provincial hospital — you open the record and see prior conditions, allergies, current medications, and the most recent labs immediately. No need to re-interview from scratch, no need to leaf through a paper transfer letter.
2. Outside lab results display in the same interface. Instead of opening a PDF, printing it, and pasting it into the chart, you see the result directly inside the EMR with a trend chart over time.
3. AI suggests screenings, drug interactions, and secondary diagnoses. AI is only trustworthy when it operates on coded data. Free text like "abdominal pain" tells AI nothing useful; a specific diagnosis code does.
4. Digitally signed prescriptions carry legal weight. Patients pick up medication at the pharmacy using VNeID — no paper slip needed. Discharge summaries are digitally signed, never lost, never disputed over a signature.
5. Fewer social health insurance reporting errors. When diagnosis codes are correct and properly linked to procedures, the system auto-generates the reimbursement file. Clinicians get fewer callback requests from billing.

3. A day in the life with a FHIR-ready system

This story features a fictional patient: Mrs. Nguyễn Thị Lan, 65 years old, from Hải Phòng, holds a social health insurance (BHYT) card, with a history of hypertension. She has been transferred from a provincial hospital to a Grade-I hospital in Hà Nội. The scenario below describes a workday for Dr. Minh in the Internal Medicine department — assuming the hospital has implemented its EMR per Circular 13/2025/TT-BYT (Ministry of Health).

What's different from the old system is not that the clinician does more work, but that the clinician does less wasted work. No re-interviewing the history, no PDF printing, no hand-typing prescriptions, no end-of-month BHYT report fixes.

4. Five changes clinicians will notice

When a hospital transitions to a standards-based EMR, clinicians notice five concrete differences:

1. Codes replace free text. The diagnosis field is no longer an open text box. Clinicians pick a code from the Vietnam ICD-10 catalog, with a search bar that suggests matches by keyword. After a brief learning curve, it's faster than typing.
2. Automatic data pull when patients have a personal health record. Past history, allergies, and current medications appear the moment you open the chart. Clinicians should still confirm the information directly with the patient, but they no longer need to start from zero.
3. The AI assistant displays suggestions as cards. Allergy alerts, drug interactions, secondary diagnosis hints — all surface in a visible spot, with a "Dismiss" button and a "Why this suggestion" explanation.
4. Digital signatures replace paper signatures. Prescriptions and discharge summaries are signed digitally (SmartCA, USB Token, or mobile digital signatures). No paper printing required, with full legal force under Decree 137/2024/NĐ-CP on electronic transactions.
5. Patients receive notifications via VNeID. When lab results, prescriptions, or follow-up schedules are ready, the patient is notified in the app. Clinicians get fewer "Is my result ready yet?" phone calls.

5. The clinician's role in terminology standardization

This is the part clinicians do directly and cannot delegate. Software suggests codes, but the person who picks the right one is the clinician. There are three primary code sets.

Vietnam ICD-10 — primary disease coding

Used for primary diagnosis and comorbidities. Required for social health insurance (BHYT) reimbursement. The Ministry of Health published this code set under Decision 4469/QĐ-BYT (28/10/2020), with COVID-19 codes added under Decision 98/QĐ-BYT (14/01/2022).

Rule of thumb: when the catalog has a more specific child code, use it. For example, "Gastritis, unspecified" maps to K29.7, which is more precise than the parent K29. But do not add your own suffix to a code if the catalog doesn't list it. The code I10 for essential hypertension is already a complete leaf — there is no I10.0 in ICD-10. Trust the catalog: if the system suggests a code, use it; if it doesn't, don't invent one.

Vietnam SNOMED CT — detailed clinical description

The Ministry of Health is rolling out Vietnam SNOMED CT in waves: anatomical structure (Decision 2427/QĐ-BYT), morphologic abnormality (Decision 2493/QĐ-BYT), and allergies plus clinical findings (Decision 2805/QĐ-BYT). It captures what ICD-10 cannot: specific allergens, detailed anatomical sites, severity grades, and non-disease findings (such as "atypical chest pain").

LOINC — laboratory test codes

Clinicians usually don't enter LOINC codes themselves; lab technicians and analyzer software handle that. Clinicians only see LOINC codes when reading results, e.g., "Total cholesterol — 5.2 mmol/L (LOINC 2093-3)." Knowing what they are prevents confusion when comparing results across different labs.

6. AI assistants — what every clinician must know

This is the area most prone to misunderstanding. AI in healthcare is not here to replace the clinician — it's here to reduce cognitive load: surfacing things easy to miss and warning about things easy to confuse.

Five things every clinician must know

1. AI is a suggestion, not the final decision. The final decision belongs to the clinician.
2. Clinicians always have the right to override an AI suggestion. The system records the decision; it does not penalize the clinician for ignoring AI.
3. AI can be wrong. There are false positives (flagging something that isn't there) and false negatives (missing something that is). Clinicians must still perform a complete clinical examination.
4. Every AI suggestion has a reason. A good system lets the clinician click "Why" to see what data and what model the suggestion is based on. If there is no reason, do not trust it.
5. The law requires a human in the decision loop. Vietnam's AI Law (Law 134/2025/QH15, effective 01/03/2026) classifies medical AI as high-risk and mandates a human-in-the-loop control mechanism. The clinician is that "human."

Three things clinicians should not do

• Trust AI absolutely — skipping clinical examination because "AI says it's fine."
• Shift blame to AI when something goes wrong ("the machine told me so"). By law, the clinician retains final professional responsibility.
• Reflexively dismiss every AI suggestion without reading the content. AI is wrong often, but sometimes it's right.

7. When patients ask about their personal health record

Patients increasingly ask things like: "Doctor, I opened VNeID and there's a Health / Personal Health Record section — what is that? Does the hospital send my data up there?"

Clinicians don't need to give a technical explanation. A short, accurate answer like the one below works in most situations:

"That's your personal health record. Under the Ministry of Health's Decision 1332/QĐ-BYT, our hospital uploads your discharge summary, prescriptions, and basic lab results to it. You can view them on your phone any time and share them with another hospital when you need to. Under the Personal Data Protection Law (Law 91/2025/QH15), you have the right to know, to consent or withdraw consent, and to demand data protection. In some specific cases, medical data may still be processed under the law — for example during emergencies when the information is needed to save a life, or when required by competent authorities."

That answer balances the patient's rights against the legitimate exceptions. Saying "only people you consent to can read it" would be incorrect — Law 91/2025 (Article 19) permits processing personal data without consent in specific situations such as life-saving emergencies, statutory obligations, or requests from competent state authorities.

If a patient wants more detail, direct them to the "My rights" section inside the VNeID app, or to the hospital's social work office.

8. Frequently asked questions

Do clinicians have to take a FHIR course?

No. Clinicians only need to use the new EMR software properly. Mastering the FHIR specification is the job of the hospital's technical team and the software vendor.

Doesn't picking an ICD-10 code each time slow me down?

A few seconds slower the first time. Once you're familiar with it, finding a code is usually faster than typing free text — the software suggests matches as soon as you type a few letters. The trade-off: fewer BHYT errors, AI that actually works, and accurate epidemiological statistics.

Can AI replace a clinician?

No. AI is a support tool. The clinician still makes the final call and bears professional responsibility. Law 134/2025 makes this explicit.

I don't trust AI — am I forced to use it?

Clinicians can dismiss any AI suggestion. But it's worth reading the suggestion before dismissing — sometimes AI catches an allergy, a drug interaction, or an abnormal result that a tired human eye can miss.

Does BHYT accept SNOMED CT diagnoses?

Currently, no. Vietnam Social Security (BHXH) requires reports in Vietnam ICD-10. SNOMED CT is used to add clinical detail; it does not replace ICD-10 for billing purposes.

When does my hospital have to have an EMR?

Under Circular 13/2025/TT-BYT (effective 21/07/2025), hospitals must complete EMR implementation by 30/09/2025; other healthcare facilities by 31/12/2026. The right question, then, isn't whether — it's how the hospital is preparing.

9. Further reading

Related pages in the HL7 Vietnam knowledge hub: