HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.5.0 - Draft for Community Review

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Local Development build (v0.5.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

## : Ví dụ: Giải trình quyền lợi BHYT — 80% BHYT, 20% cùng chi trả

Bản thô json | Tải xuống

    {
      "resourceType" : "ExplanationOfBenefit",
      "id" : "ExampleEOBPartialCoverage",
      "meta" : {
        "profile" : [
          🔗 "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-explanation-of-benefit"
        ]
      },
      "language" : "vi",
      "text" : {
        "status" : "extensions",
        "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: ExplanationOfBenefit ExampleEOBPartialCoverage</b></p><a name=\"ExampleEOBPartialCoverage\"> </a><a name=\"hcExampleEOBPartialCoverage\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Profile: <a href=\"StructureDefinition-vn-core-explanation-of-benefit.html\">Giải trình quyền lợi BHYT VN Core — VN Core ExplanationOfBenefit Profile</a></p></div><blockquote><p><b>Tổng chi phí theo nhóm — Claim Cost Summary Extension</b></p><ul><li>totalInsurance: <span title=\"Vietnamese Dong\">₫560.000</span> (VND)</li><li>totalPatientCopay: <span title=\"Vietnamese Dong\">₫140.000</span> (VND)</li><li>totalPatientSelfPay: <span title=\"Vietnamese Dong\">₫0</span> (VND)</li></ul></blockquote><blockquote><p><b>Kỳ thanh toán — Claim Payment Period Extension</b></p><ul><li>year: 2026</li><li>month: 4</li></ul></blockquote><p><b>Phương thức thanh toán — Payment Method Extension</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-payment-method-cs 1}\">Phí dịch vụ (FFS)</span></p><p><b>status</b>: Active</p><p><b>type</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/claim-type professional}\">Professional</span></p><p><b>use</b>: Claim</p><p><b>patient</b>: <a href=\"Patient-ExamplePatientNguyenVanAn.html\">Nguyễn Văn An</a></p><p><b>created</b>: 2026-04-20</p><p><b>insurer</b>: <a href=\"Organization-ExampleOrganizationBHXH.html\">Bảo hiểm xã hội Việt Nam</a></p><p><b>provider</b>: <a href=\"Organization-ExampleOrganizationChoRay.html\">Bệnh viện Chợ Rẫy</a></p><p><b>outcome</b>: Processing Complete</p><h3>Diagnoses</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Sequence</b></td><td><b>Diagnosis[x]</b></td><td><b>Type</b></td></tr><tr><td style=\"display: none\">*</td><td>1</td><td><span title=\"Codes:{http://hl7.org/fhir/sid/icd-10 I10}\">Tăng huyết áp nguyên phát</span></td><td><span title=\"Codes:{http://terminology.hl7.org/CodeSystem/ex-diagnosistype principal}\">Principal Diagnosis</span></td></tr></table><h3>Insurances</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Focal</b></td><td><b>Coverage</b></td></tr><tr><td style=\"display: none\">*</td><td>true</td><td><a href=\"Coverage-ExampleCoverageBHYTNew.html\">Coverage: extension = Người lao động trong doanh nghiệp,-&gt;Bệnh viện Chợ Rẫy; identifier = http://fhir.hl7.org.vn/core/sid/bhyt#VNBHYT#001085012345; status = active; type = Medical; relationship = Self; period = 2025-08-01 --&gt; 2026-07-31</a></td></tr></table><blockquote><p><b>item</b></p><p><b>sequence</b>: 1</p><p><b>category</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-category-cs 1}\">Khám bệnh</span></p><p><b>productOrService</b>: <span title=\"Codes:\">Khám chuyên khoa Tim mạch</span></p><blockquote><p><b>adjudication</b></p><p><b>category</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/adjudication submitted}\">Submitted Amount</span></p><h3>Amounts</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style=\"display: none\">*</td><td>150000</td><td>Vietnamese đồng</td></tr></table></blockquote><blockquote><p><b>adjudication</b></p><p><b>category</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/adjudication eligible}\">Eligible Amount</span></p><h3>Amounts</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style=\"display: none\">*</td><td>150000</td><td>Vietnamese đồng</td></tr></table></blockquote><blockquote><p><b>adjudication</b></p><p><b>category</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/adjudication benefit}\">Benefit Amount</span></p><h3>Amounts</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style=\"display: none\">*</td><td>120000</td><td>Vietnamese đồng</td></tr></table></blockquote></blockquote><blockquote><p><b>item</b></p><p><b>sequence</b>: 2</p><p><b>category</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-category-cs 3}\">Xét nghiệm</span></p><p><b>productOrService</b>: <span title=\"Codes:\">Xét nghiệm sinh hóa máu (Glucose, HbA1c, Lipid)</span></p><blockquote><p><b>adjudication</b></p><p><b>category</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/adjudication submitted}\">Submitted Amount</span></p><h3>Amounts</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style=\"display: none\">*</td><td>200000</td><td>Vietnamese đồng</td></tr></table></blockquote><blockquote><p><b>adjudication</b></p><p><b>category</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/adjudication eligible}\">Eligible Amount</span></p><h3>Amounts</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style=\"display: none\">*</td><td>200000</td><td>Vietnamese đồng</td></tr></table></blockquote><blockquote><p><b>adjudication</b></p><p><b>category</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/adjudication benefit}\">Benefit Amount</span></p><h3>Amounts</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style=\"display: none\">*</td><td>160000</td><td>Vietnamese đồng</td></tr></table></blockquote></blockquote><blockquote><p><b>item</b></p><p><b>sequence</b>: 3</p><p><b>category</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-category-cs 8}\">Thuốc, dịch truyền</span></p><p><b>productOrService</b>: <span title=\"Codes:\">Amlodipine 5mg x 30 viên + Atorvastatin 20mg x 30 viên</span></p><blockquote><p><b>adjudication</b></p><p><b>category</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/adjudication submitted}\">Submitted Amount</span></p><h3>Amounts</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style=\"display: none\">*</td><td>350000</td><td>Vietnamese đồng</td></tr></table></blockquote><blockquote><p><b>adjudication</b></p><p><b>category</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/adjudication eligible}\">Eligible Amount</span></p><h3>Amounts</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style=\"display: none\">*</td><td>350000</td><td>Vietnamese đồng</td></tr></table></blockquote><blockquote><p><b>adjudication</b></p><p><b>category</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/adjudication benefit}\">Benefit Amount</span></p><h3>Amounts</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style=\"display: none\">*</td><td>280000</td><td>Vietnamese đồng</td></tr></table></blockquote></blockquote><blockquote><p><b>total</b></p><p><b>category</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/adjudication submitted}\">Submitted Amount</span></p><h3>Amounts</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style=\"display: none\">*</td><td>700000</td><td>Vietnamese đồng</td></tr></table></blockquote><blockquote><p><b>total</b></p><p><b>category</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/adjudication benefit}\">Benefit Amount</span></p><h3>Amounts</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style=\"display: none\">*</td><td>560000</td><td>Vietnamese đồng</td></tr></table></blockquote><blockquote><p><b>payment</b></p><p><b>type</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/ex-paymenttype complete}\">Complete</span></p><h3>Amounts</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Value</b></td><td><b>Currency</b></td></tr><tr><td style=\"display: none\">*</td><td>560000</td><td>Vietnamese đồng</td></tr></table></blockquote><p><b>benefitPeriod</b>: 2026-01-01 --&gt; 2026-12-31</p></div>"
      },
      "extension" : [
        {
          "extension" : [
            {
              "url" : "totalInsurance",
              "valueMoney" : {
                "value" : 560000,
                "currency" : "VND"
              }
            },
            {
              "url" : "totalPatientCopay",
              "valueMoney" : {
                "value" : 140000,
                "currency" : "VND"
              }
            },
            {
              "url" : "totalPatientSelfPay",
              "valueMoney" : {
                "value" : 0,
                "currency" : "VND"
              }
            }
          ],
          "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-cost-summary"
        },
        {
          "extension" : [
            {
              "url" : "year",
              "valueInteger" : 2026
            },
            {
              "url" : "month",
              "valueInteger" : 4
            }
          ],
          "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-payment-period"
        },
        {
          "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-method",
          "valueCodeableConcept" : {
            "coding" : [
              {
                "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-payment-method-cs",
                "code" : "1",
                "display" : "Phí dịch vụ (FFS)"
              }
            ]
          }
        }
      ],
      "status" : "active",
      "type" : {
        "coding" : [
          {
            "system" : "http://terminology.hl7.org/CodeSystem/claim-type",
            "code" : "professional",
            "display" : "Professional"
          }
        ]
      },
      "use" : "claim",
      "patient" : {
        🔗 "reference" : "Patient/ExamplePatientNguyenVanAn",
        "display" : "Nguyễn Văn An"
      },
      "created" : "2026-04-20",
      "insurer" : {
        🔗 "reference" : "Organization/ExampleOrganizationBHXH",
        "display" : "Bảo hiểm xã hội Việt Nam"
      },
      "provider" : {
        🔗 "reference" : "Organization/ExampleOrganizationChoRay",
        "display" : "Bệnh viện Chợ Rẫy"
      },
      "outcome" : "complete",
      "diagnosis" : [
        {
          "sequence" : 1,
          "diagnosisCodeableConcept" : {
            "coding" : [
              {
                "system" : "http://hl7.org/fhir/sid/icd-10",
                "code" : "I10",
                "display" : "Essential (primary) hypertension"
              }
            ],
            "text" : "Tăng huyết áp nguyên phát"
          },
          "type" : [
            {
              "coding" : [
                {
                  "system" : "http://terminology.hl7.org/CodeSystem/ex-diagnosistype",
                  "code" : "principal",
                  "display" : "Principal Diagnosis"
                }
              ]
            }
          ]
        }
      ],
      "insurance" : [
        {
          "focal" : true,
          "coverage" : {
            🔗 "reference" : "Coverage/ExampleCoverageBHYTNew"
          }
        }
      ],
      "item" : [
        {
          "sequence" : 1,
          "category" : {
            "coding" : [
              {
                "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-category-cs",
                "code" : "1",
                "display" : "Khám bệnh"
              }
            ]
          },
          "productOrService" : {
            "text" : "Khám chuyên khoa Tim mạch"
          },
          "adjudication" : [
            {
              "category" : {
                "coding" : [
                  {
                    "system" : "http://terminology.hl7.org/CodeSystem/adjudication",
                    "code" : "submitted",
                    "display" : "Submitted Amount"
                  }
                ]
              },
              "amount" : {
                "value" : 150000,
                "currency" : "VND"
              }
            },
            {
              "category" : {
                "coding" : [
                  {
                    "system" : "http://terminology.hl7.org/CodeSystem/adjudication",
                    "code" : "eligible",
                    "display" : "Eligible Amount"
                  }
                ]
              },
              "amount" : {
                "value" : 150000,
                "currency" : "VND"
              }
            },
            {
              "category" : {
                "coding" : [
                  {
                    "system" : "http://terminology.hl7.org/CodeSystem/adjudication",
                    "code" : "benefit",
                    "display" : "Benefit Amount"
                  }
                ]
              },
              "amount" : {
                "value" : 120000,
                "currency" : "VND"
              }
            }
          ]
        },
        {
          "sequence" : 2,
          "category" : {
            "coding" : [
              {
                "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-category-cs",
                "code" : "3",
                "display" : "Xét nghiệm"
              }
            ]
          },
          "productOrService" : {
            "text" : "Xét nghiệm sinh hóa máu (Glucose, HbA1c, Lipid)"
          },
          "adjudication" : [
            {
              "category" : {
                "coding" : [
                  {
                    "system" : "http://terminology.hl7.org/CodeSystem/adjudication",
                    "code" : "submitted",
                    "display" : "Submitted Amount"
                  }
                ]
              },
              "amount" : {
                "value" : 200000,
                "currency" : "VND"
              }
            },
            {
              "category" : {
                "coding" : [
                  {
                    "system" : "http://terminology.hl7.org/CodeSystem/adjudication",
                    "code" : "eligible",
                    "display" : "Eligible Amount"
                  }
                ]
              },
              "amount" : {
                "value" : 200000,
                "currency" : "VND"
              }
            },
            {
              "category" : {
                "coding" : [
                  {
                    "system" : "http://terminology.hl7.org/CodeSystem/adjudication",
                    "code" : "benefit",
                    "display" : "Benefit Amount"
                  }
                ]
              },
              "amount" : {
                "value" : 160000,
                "currency" : "VND"
              }
            }
          ]
        },
        {
          "sequence" : 3,
          "category" : {
            "coding" : [
              {
                "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-category-cs",
                "code" : "8",
                "display" : "Thuốc, dịch truyền"
              }
            ]
          },
          "productOrService" : {
            "text" : "Amlodipine 5mg x 30 viên + Atorvastatin 20mg x 30 viên"
          },
          "adjudication" : [
            {
              "category" : {
                "coding" : [
                  {
                    "system" : "http://terminology.hl7.org/CodeSystem/adjudication",
                    "code" : "submitted",
                    "display" : "Submitted Amount"
                  }
                ]
              },
              "amount" : {
                "value" : 350000,
                "currency" : "VND"
              }
            },
            {
              "category" : {
                "coding" : [
                  {
                    "system" : "http://terminology.hl7.org/CodeSystem/adjudication",
                    "code" : "eligible",
                    "display" : "Eligible Amount"
                  }
                ]
              },
              "amount" : {
                "value" : 350000,
                "currency" : "VND"
              }
            },
            {
              "category" : {
                "coding" : [
                  {
                    "system" : "http://terminology.hl7.org/CodeSystem/adjudication",
                    "code" : "benefit",
                    "display" : "Benefit Amount"
                  }
                ]
              },
              "amount" : {
                "value" : 280000,
                "currency" : "VND"
              }
            }
          ]
        }
      ],
      "total" : [
        {
          "category" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/adjudication",
                "code" : "submitted",
                "display" : "Submitted Amount"
              }
            ]
          },
          "amount" : {
            "value" : 700000,
            "currency" : "VND"
          }
        },
        {
          "category" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/adjudication",
                "code" : "benefit",
                "display" : "Benefit Amount"
              }
            ]
          },
          "amount" : {
            "value" : 560000,
            "currency" : "VND"
          }
        }
      ],
      "payment" : {
        "type" : {
          "coding" : [
            {
              "system" : "http://terminology.hl7.org/CodeSystem/ex-paymenttype",
              "code" : "complete",
              "display" : "Complete"
            }
          ]
        },
        "amount" : {
          "value" : 560000,
          "currency" : "VND"
        }
      },
      "benefitPeriod" : {
        "start" : "2026-01-01",
        "end" : "2026-12-31"
      }
    }