HL7 Vietnam VN Core FHIR Implementation Guide

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

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

: Ví dụ: Yêu cầu thanh toán BHYT ngoại trú (Khám / XN / Thuốc)

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

{
  "resourceType" : "Claim",
  "id" : "ExampleClaimOutpatient",
  "meta" : {
    "profile" : [
      🔗 "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim"
    ]
  },
  "language" : "vi",
  "text" : {
    "status" : "extensions",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: Claim ExampleClaimOutpatient</b></p><a name=\"ExampleClaimOutpatient\"> </a><a name=\"hcExampleClaimOutpatient\"> </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-claim.html\">Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile</a></p></div><blockquote><p><b>Tổng chi phí theo nhóm — Claim Cost Summary Extension</b></p><ul><li>totalMedication: <span title=\"Vietnamese Dong\">₫3.200.000</span> (VND)</li><li>totalInsurance: <span title=\"Vietnamese Dong\">₫3.360.000</span> (VND)</li><li>totalPatientCopay: <span title=\"Vietnamese Dong\">₫840.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>identifier</b>: Mã liên kết hồ sơ BHYT/LK-2026-OUT-000315</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>subType</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-patient-visit-type-cs 1.1}\">KCB đúng cơ sở nơi đăng ký KCB BHYT ban đầu</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-19</p><p><b>provider</b>: <a href=\"Organization-ExampleOrganizationChoRay.html\">Bệnh viện Chợ Rẫy</a></p><p><b>priority</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/processpriority normal}\">Normal</span></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 K29.5}\">Viêm dạ dày mạn</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>Sequence</b></td><td><b>Focal</b></td><td><b>Coverage</b></td></tr><tr><td style=\"display: none\">*</td><td>1</td><td>true</td><td><a href=\"Coverage-ExampleCoverageBHYTNew.html\">BHYT Nguyễn Văn An — DN 80%</a></td></tr></table><blockquote><p><b>item</b></p><p><b>Khoa thực hiện — Claim Item Department Extension</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-department-cs K01}\">Khoa Khám bệnh</span></p><blockquote><p><b>Thông tin chi phí BHYT — Insurance Cost Info Extension</b></p><ul><li>scope: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-scope-cs 1}\">Trong phạm vi hưởng BHYT</span></li><li>paymentRatio: 100</li><li>benefitLevel: 80</li></ul></blockquote><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:{http://fhir.hl7.org.vn/core/CodeSystem/vn-examination-code-cs 02.05}\">Khám chuyên khoa Nội tiêu hóa (tái khám theo giấy hẹn)</span></p><h3>Nets</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>item</b></p><p><b>Khoa thực hiện — Claim Item Department Extension</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-department-cs K47}\">Khoa Xét nghiệm</span></p><blockquote><p><b>Thông tin chi phí BHYT — Insurance Cost Info Extension</b></p><ul><li>scope: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-scope-cs 1}\">Trong phạm vi hưởng BHYT</span></li><li>paymentRatio: 100</li><li>benefitLevel: 80</li></ul></blockquote><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:{http://loinc.org 58410-2}\">XN huyết học (CBC) + test hơi thở C13 chẩn đoán H. pylori</span></p><h3>Nets</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>850000</td><td>Vietnamese đồng</td></tr></table></blockquote><blockquote><p><b>item</b></p><p><b>Nguồn chi trả — Payment Source Extension</b>: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-payment-source-cs 1}\">Bảo hiểm y tế</span></p><blockquote><p><b>Thông tin chi phí BHYT — Insurance Cost Info Extension</b></p><ul><li>scope: <span title=\"Codes:{http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-scope-cs 1}\">Trong phạm vi hưởng BHYT</span></li><li>paymentRatio: 100</li><li>benefitLevel: 80</li></ul></blockquote><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:{http://terminology.hl7.org/CodeSystem/data-absent-reason unknown}\">Phác đồ diệt H. pylori (Esomeprazole + Amoxicillin + Clarithromycin, 14 ngày) + biệt dược bổ trợ</span></p><h3>Nets</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>3200000</td><td>Vietnamese đồng</td></tr></table></blockquote><h3>Totals</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>4200000</td><td>Vietnamese đồng</td></tr></table></div>"
  },
  "extension" : [
    {
      "extension" : [
        {
          "url" : "totalMedication",
          "valueMoney" : {
            "value" : 3200000,
            "currency" : "VND"
          }
        },
        {
          "url" : "totalInsurance",
          "valueMoney" : {
            "value" : 3360000,
            "currency" : "VND"
          }
        },
        {
          "url" : "totalPatientCopay",
          "valueMoney" : {
            "value" : 840000,
            "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)"
          }
        ]
      }
    }
  ],
  "identifier" : [
    {
      "type" : {
        "coding" : [
          {
            "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs",
            "code" : "MA_LK",
            "display" : "Mã liên kết hồ sơ BHYT"
          }
        ]
      },
      "system" : "http://fhir.hl7.org.vn/core/sid/ma-lk",
      "value" : "LK-2026-OUT-000315"
    }
  ],
  "status" : "active",
  "type" : {
    "coding" : [
      {
        "system" : "http://terminology.hl7.org/CodeSystem/claim-type",
        "code" : "professional",
        "display" : "Professional"
      }
    ]
  },
  "subType" : {
    "coding" : [
      {
        "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-patient-visit-type-cs",
        "code" : "1.1",
        "display" : "KCB đúng cơ sở nơi đăng ký KCB BHYT ban đầu"
      }
    ]
  },
  "use" : "claim",
  "patient" : {
    🔗 "reference" : "Patient/ExamplePatientNguyenVanAn",
    "display" : "Nguyễn Văn An"
  },
  "created" : "2026-04-19",
  "provider" : {
    🔗 "reference" : "Organization/ExampleOrganizationChoRay",
    "display" : "Bệnh viện Chợ Rẫy"
  },
  "priority" : {
    "coding" : [
      {
        "system" : "http://terminology.hl7.org/CodeSystem/processpriority",
        "code" : "normal",
        "display" : "Normal"
      }
    ]
  },
  "diagnosis" : [
    {
      "sequence" : 1,
      "diagnosisCodeableConcept" : {
        "coding" : [
          {
            "system" : "http://hl7.org/fhir/sid/icd-10",
            "code" : "K29.5",
            "display" : "Chronic gastritis, unspecified"
          }
        ],
        "text" : "Viêm dạ dày mạn"
      },
      "type" : [
        {
          "coding" : [
            {
              "system" : "http://terminology.hl7.org/CodeSystem/ex-diagnosistype",
              "code" : "principal",
              "display" : "Principal Diagnosis"
            }
          ]
        }
      ]
    }
  ],
  "insurance" : [
    {
      "sequence" : 1,
      "focal" : true,
      "coverage" : {
        🔗 "reference" : "Coverage/ExampleCoverageBHYTNew",
        "display" : "BHYT Nguyễn Văn An — DN 80%"
      }
    }
  ],
  "item" : [
    {
      "extension" : [
        {
          "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-item-department",
          "valueCodeableConcept" : {
            "coding" : [
              {
                "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-department-cs",
                "code" : "K01",
                "display" : "Khoa Khám bệnh"
              }
            ]
          }
        },
        {
          "extension" : [
            {
              "url" : "scope",
              "valueCodeableConcept" : {
                "coding" : [
                  {
                    "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-scope-cs",
                    "code" : "1",
                    "display" : "Trong phạm vi hưởng BHYT"
                  }
                ]
              }
            },
            {
              "url" : "paymentRatio",
              "valueDecimal" : 100
            },
            {
              "url" : "benefitLevel",
              "valueDecimal" : 80
            }
          ],
          "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info"
        }
      ],
      "sequence" : 1,
      "category" : {
        "coding" : [
          {
            "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-category-cs",
            "code" : "1",
            "display" : "Khám bệnh"
          }
        ]
      },
      "productOrService" : {
        "coding" : [
          {
            "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-examination-code-cs",
            "code" : "02.05",
            "display" : "Nội tiêu hóa"
          }
        ],
        "text" : "Khám chuyên khoa Nội tiêu hóa (tái khám theo giấy hẹn)"
      },
      "net" : {
        "value" : 150000,
        "currency" : "VND"
      }
    },
    {
      "extension" : [
        {
          "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-item-department",
          "valueCodeableConcept" : {
            "coding" : [
              {
                "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-department-cs",
                "code" : "K47",
                "display" : "Khoa Xét nghiệm"
              }
            ]
          }
        },
        {
          "extension" : [
            {
              "url" : "scope",
              "valueCodeableConcept" : {
                "coding" : [
                  {
                    "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-scope-cs",
                    "code" : "1",
                    "display" : "Trong phạm vi hưởng BHYT"
                  }
                ]
              }
            },
            {
              "url" : "paymentRatio",
              "valueDecimal" : 100
            },
            {
              "url" : "benefitLevel",
              "valueDecimal" : 80
            }
          ],
          "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info"
        }
      ],
      "sequence" : 2,
      "category" : {
        "coding" : [
          {
            "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-cost-category-cs",
            "code" : "3",
            "display" : "Xét nghiệm"
          }
        ]
      },
      "productOrService" : {
        "coding" : [
          {
            "system" : "http://loinc.org",
            "code" : "58410-2",
            "display" : "CBC panel - Blood by Automated count"
          }
        ],
        "text" : "XN huyết học (CBC) + test hơi thở C13 chẩn đoán H. pylori"
      },
      "net" : {
        "value" : 850000,
        "currency" : "VND"
      }
    },
    {
      "extension" : [
        {
          "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-source",
          "valueCodeableConcept" : {
            "coding" : [
              {
                "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-payment-source-cs",
                "code" : "1",
                "display" : "Bảo hiểm y tế"
              }
            ]
          }
        },
        {
          "extension" : [
            {
              "url" : "scope",
              "valueCodeableConcept" : {
                "coding" : [
                  {
                    "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-insurance-scope-cs",
                    "code" : "1",
                    "display" : "Trong phạm vi hưởng BHYT"
                  }
                ]
              }
            },
            {
              "url" : "paymentRatio",
              "valueDecimal" : 100
            },
            {
              "url" : "benefitLevel",
              "valueDecimal" : 80
            }
          ],
          "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info"
        }
      ],
      "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" : {
        "coding" : [
          {
            "system" : "http://terminology.hl7.org/CodeSystem/data-absent-reason",
            "code" : "unknown",
            "display" : "Unknown"
          }
        ],
        "text" : "Phác đồ diệt H. pylori (Esomeprazole + Amoxicillin + Clarithromycin, 14 ngày) + biệt dược bổ trợ"
      },
      "net" : {
        "value" : 3200000,
        "currency" : "VND"
      }
    }
  ],
  "total" : {
    "value" : 4200000,
    "currency" : "VND"
  }
}