HL7 Vietnam VN Core FHIR Implementation Guide

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.9.0 - Draft for Community Review Viet Nam cờ

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Local Development build (v0.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Ví dụ Binary: Ví dụ: Quyết toán chi phí KCB BHYT Quý II/2026 — Example: Q2/2026 quarterly BHYT healthcare cost settlement

This content is an example of the Quyết toán chi phí KCB BHYT theo quý — VN Core Quarterly Healthcare Cost Settlement Logical Model and is not a FHIR Resource

    
{
  "resourceType": "http://fhir.hl7.org.vn/core/StructureDefinition/vnCoreQuarterlyHealthcareCostSettlement",
  "indicator": [
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "1"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 14300000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
            "valueCode": "not-applicable"
          }
        ]
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "2"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 14000000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
            "valueCode": "not-applicable"
          }
        ]
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "3"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 4000000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
            "valueCode": "not-applicable"
          }
        ]
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "4"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 10500000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 21000000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "5"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 10000000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 20000000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "6"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 1000000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 2000000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "7"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 500000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 1000000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "8"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 500000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 1000000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "9"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 6000000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 12000000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "10"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 8000000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
            "valueCode": "not-applicable"
          }
        ]
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "11"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 300000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 600000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "12"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 7100000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 14000000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "13"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 200000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 200000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "14"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 6700000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 13400000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "15"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 6000000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 12000000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "16"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 500000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 1000000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "17"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 200000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 400000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "18"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 200000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 400000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "19"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 300000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 600000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "20"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 100000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 200000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "21"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 6400000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 12600000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "22"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 6300000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 12600000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "23"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 6000000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 12000000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "24"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 300000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 600000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "25"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 100000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 200000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "26"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 200000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 400000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "27"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 400000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 600000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "28"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 0
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 0
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "29"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 0
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 0
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "30"
      },
      "quarterAmount": {
        "currency": "VND",
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
            "valueCode": "not-applicable"
          }
        ]
      },
      "yearToDateAmount": {
        "currency": "VND",
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
            "valueCode": "not-applicable"
          }
        ]
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "31"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 0
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 0
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "32"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 200000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 200000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "33"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 5500000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 12000000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "34"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 5500000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 12000000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "35"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 5500000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 12000000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "36"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 0
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 0
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "37"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 0
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 0
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "38"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 0
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 0
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "39"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 0
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 0
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "40"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 100000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 200000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "41"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 6200000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 12400000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "42"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 0
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 0
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "43"
      },
      "quarterAmount": {
        "currency": "VND",
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
            "valueCode": "not-applicable"
          }
        ]
      },
      "yearToDateAmount": {
        "currency": "VND",
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
            "valueCode": "not-applicable"
          }
        ]
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "44"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 0
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 0
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "45"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 900000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 600000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "46"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 0
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 0
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "47"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 300000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 300000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "48"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 0
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 0
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "49"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 0
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 200000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "50"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 300000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 100000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "51"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 0
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 0
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "52"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 300000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 300000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "53"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 400000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 800000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "54"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 100000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 200000
      }
    },
    {
      "code": {
        "system": "http://fhir.hl7.org.vn/core/CodeSystem/vn-quarterly-settlement-indicator-cs",
        "code": "55"
      },
      "quarterAmount": {
        "currency": "VND",
        "value": 600000
      },
      "yearToDateAmount": {
        "currency": "VND",
        "value": 900000
      }
    }
  ],
  "identifier": [
    {
      "system": "http://fhir.hl7.org.vn/core/sid/quarterly-healthcare-cost-settlement",
      "value": "QTS-BHYT-79001-2026-Q2"
    }
  ],
  "period": {
    "start": "2026-04-01",
    "end": "2026-06-30"
  },
  "payer": {
    "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"
  },
  "contractIdentifier": {
    "system": "http://fhir.hl7.org.vn/core/sid/bhyt-healthcare-contract",
    "value": "HD-KCB-BHYT-79001-2026"
  },
  "contractDate": "2026-01-05",
  "supportingDocument": [
    {
      "type": "DocumentReference",
      "identifier": {
        "system": "http://fhir.hl7.org.vn/core/sid/document-number",
        "value": "HD-KCB-BHYT-79001-2026-BAN-DIEN-TU"
      },
      "display": "Bản điện tử hợp đồng KCB BHYT hư cấu — Fictional electronic BHYT healthcare contract"
    }
  ],
  "providerBankAccount": "1020007900101",
  "providerBankName": "Ngân hàng Minh Họa Việt Nam — Chi nhánh Thành phố Hồ Chí Minh",
  "payerOpinion": "Đồng ý với số liệu quyết toán hư cấu Quý II trong ví dụ.",
  "providerOpinion": "Đồng ý đối chiếu và xác nhận số liệu hư cấu Quý II trong ví dụ.",
  "attester": [
    {
      "party": {
        "reference": "PractitionerRole/ExamplePractitionerRole",
        "display": "Đại diện Bệnh viện Chợ Rẫy (minh họa)"
      },
      "role": {
        "coding": [
          {
            "code": "AUT",
            "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType"
          }
        ],
        "text": "Người ký phía cơ sở KCB — Healthcare provider signer"
      },
      "time": "2026-07-15T09:00:00+07:00"
    },
    {
      "party": {
        "reference": "PractitionerRole/ExamplePractitionerRoleBHXHReviewer",
        "display": "Đại diện cơ quan BHXH (minh họa)"
      },
      "role": {
        "coding": [
          {
            "code": "VRF",
            "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType"
          }
        ],
        "text": "Người xác minh phía cơ quan BHXH — BHXH payer verifier"
      },
      "time": "2026-07-15T09:15:00+07:00"
    }
  ]
}