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.10.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 - Draft for Community Review (v0.10.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Hồ sơ tài nguyên: Kết quả giải quyết BHYT VN Core — VN Core ClaimResponse Profile - Mô tả chi tiết

Draft tại thời điểm 2026-08-06

Các định nghĩa cho vn-core-claim-response hồ sơ tài nguyên

Guidance on how to interpret the contents of this table can be foundhere

0. ClaimResponse
Definition

This resource provides the adjudication details from the processing of a Claim resource.

ShortResponse to a claim predetermination or preauthorization
Control0..*
Is Modifierfalse
Summaryfalse
Alternate NamesRemittance Advice
Invariantsdom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources (contained.contained.empty())
dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource (contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty())
dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated (contained.meta.versionId.empty() and contained.meta.lastUpdated.empty())
dom-5: If a resource is contained in another resource, it SHALL NOT have a security label (contained.meta.security.empty())
dom-6: A resource should have narrative for robust management (text.`div`.exists())
vn-claim-response-error-outcome-coherent: Có lỗi xử lý thì outcome phải là `error`. When a processing error is present, outcome SHALL be `error`. (error.empty() or outcome = 'error')
vn-claim-response-denied-complete: Khoản tiền bị từ chối hoặc bị thu hồi phải có số tiền không âm, lý do và ít nhất một căn cứ pháp lý. A denied or recovered amount SHALL carry a non-negative amount, a reason and at least one legal basis. ((adjudication | item.adjudication | item.detail.adjudication | item.detail.subDetail.adjudication | addItem.adjudication | addItem.detail.adjudication | addItem.detail.subDetail.adjudication).where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).all(amount.value.exists() and amount.value >= 0 and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()))
vn-claim-response-itemized: Phản hồi giám định phải liệt kê từng dòng chi phí, trừ khi kết quả là lỗi kỹ thuật. An adjudication response SHALL be itemized unless its outcome is an error. (outcome = 'error' or item.exists())
vn-claim-response-total-matches-items: Mỗi tổng theo mã adjudication chuẩn phải bằng tổng các dòng cùng mã. Each total for a standard adjudication category SHALL equal the sum of the matching item adjudications. (item.empty() or ((total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.exists() and item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.exists() implies total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value = item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.aggregate($this + $total, 0)) and (total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.exists() and item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.exists() implies total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value = item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.aggregate($this + $total, 0)) and (total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'benefit').exists()).amount.value.exists() and item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'benefit').exists()).amount.value.exists() implies total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'benefit').exists()).amount.value = item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'benefit').exists()).amount.value.aggregate($this + $total, 0)) and (total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'copay').exists()).amount.value.exists() and item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'copay').exists()).amount.value.exists() implies total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'copay').exists()).amount.value = item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'copay').exists()).amount.value.aggregate($this + $total, 0))))
vn-claim-response-reduction-evidenced: Dòng chi phí có số đủ điều kiện thấp hơn số đề nghị phải mang bằng chứng tường minh: hoặc kết quả từ chối/thu hồi (category denied/recovered kèm lý do và căn cứ), hoặc dòng eligible mang lý do + căn cứ pháp lý (khoản ngoài phạm vi hưởng) — không được giảm tiền im lặng. An item whose eligible amount is lower than submitted SHALL carry either an explicit denied/recovered adjudication or a reason plus legal basis on the eligible adjudication. (item.all(adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.first() >= adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.first() or adjudication.where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).exists() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists() and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()).exists()))
vn-claim-response-reduction-evidenced-nested: Quy tắc giảm-tiền-phải-có-bằng-chứng áp cho MỌI đường adjudication còn lại: dòng chi tiết, chi tiết phụ, dòng bổ sung và chi tiết/chi tiết phụ của dòng bổ sung — hậu kiểm 13/08/2026 chỉ ra addItem.detail/subDetail chưa được phủ. The reduction-evidence rule SHALL hold on item.detail, item.detail.subDetail, addItem, addItem.detail and addItem.detail.subDetail adjudications. (item.detail.all(adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.first() >= adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.first() or adjudication.where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).exists() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists() and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()).exists()) and item.detail.subDetail.all(adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.first() >= adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.first() or adjudication.where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).exists() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists() and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()).exists()) and addItem.all(adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.first() >= adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.first() or adjudication.where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).exists() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists() and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()).exists()) and addItem.detail.all(adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.first() >= adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.first() or adjudication.where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).exists() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists() and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()).exists()) and addItem.detail.subDetail.all(adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.first() >= adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.first() or adjudication.where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).exists() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists() and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()).exists()))
vn-claim-response-reduction-evidenced-header: Quy tắc giảm-tiền-phải-có-bằng-chứng áp cho cả adjudication cấp tổng thể của ClaimResponse. The reduction-evidence rule SHALL also hold on the header-level ClaimResponse.adjudication. (adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.first() >= adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.first() or adjudication.where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).exists() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists() and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()).exists())
vn-claim-response-adjudication-unique-category: Trong một cụm adjudication (header, item, chi tiết, chi tiết phụ, dòng bổ sung và các tầng con của nó), mỗi category HL7 chuẩn chỉ xuất hiện một lần — hợp đồng mapping OHP mà phép so sánh giảm-tiền dựa vào. Within each adjudication set every standard HL7 category SHALL appear at most once. (adjudication.category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication').code.isDistinct() and item.all(adjudication.category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication').code.isDistinct()) and item.detail.all(adjudication.category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication').code.isDistinct()) and item.detail.subDetail.all(adjudication.category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication').code.isDistinct()) and addItem.all(adjudication.category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication').code.isDistinct()) and addItem.detail.all(adjudication.category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication').code.isDistinct()) and addItem.detail.subDetail.all(adjudication.category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication').code.isDistinct()))
vn-claim-response-correlation-anchor: Kết quả giám định đang hiệu lực phải đối soát được BẰNG GIÁ TRỊ THẬT: request phải là reference giải quyết được (không display-only) hoặc identifier phải có value — Identifier rỗng/Reference chỉ có display không đối soát được với hồ sơ nào (siết round 3, 13/08/2026). An active ClaimResponse SHALL carry a resolvable request reference or an identifier WITH a value. (status != 'active' or request.reference.exists() or identifier.value.exists())
vn-claim-response-money-vnd: Mọi khoản tiền của kết quả giám định phải dùng VND. Every monetary amount in the adjudication result SHALL use VND. (descendants().ofType(Money).all(currency = 'VND'))
2. ClaimResponse.implicitRules
Definition

A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc.

ShortA set of rules under which this content was created
Comments

Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc.

Control0..1
Typeuri
Is Modifiertrue because This element is labeled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Summarytrue
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
4. ClaimResponse.modifierExtension
Definition

May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

ShortExtensions that cannot be ignored
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Control0..*
TypeExtension
Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the resource that contains them
Summaryfalse
Requirements

Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

Alternate Namesextensions, user content
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
6. ClaimResponse.identifier
Definition

A unique identifier assigned to this claim response.

ShortĐịnh danh kết quả xử lý, bao gồm mã phản hồi gateway nếu cóBusiness Identifier for a claim response
NoteThis is a business identifier, not a resource identifier (see discussion)
Control0..*
TypeIdentifier
Is Modifierfalse
Must Supporttrue
Obligations
    ObligationsActor
    SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
    SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
    Summaryfalse
    Requirements

    Allows claim responses to be distinguished and referenced.

    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    SlicingThis element introduces a set of slices on ClaimResponse.identifier. The slices areUnordered and Open, and can be differentiated using the following discriminators:
    • value @ system
    • 8. ClaimResponse.identifier:gatewayResponseId
      Slice NamegatewayResponseId
      Definition

      Mã phản hồi của Cổng tiếp nhận dữ liệu cho hồ sơ/bảng XML1. Không dùng thay cho MA_LK.


      A unique identifier assigned to this claim response.

      ShortMã phản hồi Cổng tiếp nhận BHYT (XML1_ID)Business Identifier for a claim response
      NoteThis is a business identifier, not a resource identifier (see discussion)
      Control0..1*
      TypeIdentifier
      Is Modifierfalse
      Must Supporttrue
      Obligations
        ObligationsActor
        SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
        SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
        Summaryfalse
        Requirements

        Allows claim responses to be distinguished and referenced.

        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        10. ClaimResponse.identifier:gatewayResponseId.use
        Definition

        The purpose of this identifier.

        Shortusual | official | temp | secondary | old (If known)
        Comments

        Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

        Control0..1
        BindingThe codes SHALL be taken from IdentifierUsehttp://hl7.org/fhir/ValueSet/identifier-use|4.0.1
        (required to http://hl7.org/fhir/ValueSet/identifier-use|4.0.1)

        Identifies the purpose for this identifier, if known .

        Typecode
        Is Modifiertrue because This is labeled as "Is Modifier" because applications should not mistake a temporary id for a permanent one.
        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
        Summarytrue
        Requirements

        Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        12. ClaimResponse.identifier:gatewayResponseId.type
        Definition

        A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

        ShortDescription of identifier
        Comments

        This element deals only with general categories of identifiers. It SHOULD not be used for codes that correspond 1..1 with the Identifier.system. Some identifiers may fall into multiple categories due to common usage. Where the system is known, a type is unnecessary because the type is always part of the system definition. However systems often need to handle identifiers where the system is not known. There is not a 1:1 relationship between type and system, since many different systems have the same type.

        Control0..1
        BindingUnless not suitable, these codes SHALL be taken from Identifier Type Codeshttp://hl7.org/fhir/ValueSet/identifier-type|4.0.1
        (extensible to http://hl7.org/fhir/ValueSet/identifier-type|4.0.1)

        A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

        TypeCodeableConcept
        Is Modifierfalse
        Summarytrue
        Requirements

        Allows users to make use of identifiers when the identifier system is not known.

        Pattern Value{
          "coding" : [{
            "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs",
            "code" : "BHYT_XML1_ID"
          }]
        }
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        14. ClaimResponse.identifier:gatewayResponseId.system
        Definition

        Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

        ShortThe namespace for the identifier value
        Comments

        Identifier.system is always case sensitive.

        Control10..1
        Typeuri
        Is Modifierfalse
        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
        Summarytrue
        Requirements

        There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

        Fixed Valuehttp://fhir.hl7.org.vn/core/sid/bhyt-gateway-response-id
        ExampleGeneral: http://www.acme.com/identifiers/patient
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        16. ClaimResponse.identifier:gatewayResponseId.value
        Definition

        The portion of the identifier typically relevant to the user and which is unique within the context of the system.

        ShortGiá trị XML1_ID hoặc mã phản hồi tương đươngThe value that is unique
        Comments

        If the value is a full URI, then the system SHALL be urn:ietf:rfc:3986. The value's primary purpose is computational mapping. As a result, it may be normalized for comparison purposes (e.g. removing non-significant whitespace, dashes, etc.) A value formatted for human display can be conveyed using the Rendered Value extension. Identifier.value is to be treated as case sensitive unless knowledge of the Identifier.system allows the processer to be confident that non-case-sensitive processing is safe.

        Control10..1
        Typestring
        Is Modifierfalse
        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
        Must Supporttrue
        Summarytrue
        ExampleGeneral: 123456
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        18. ClaimResponse.status
        Definition

        The status of the resource instance.

        ShortTrạng thái kết quả: active | cancelled | draft | entered-in-erroractive | cancelled | draft | entered-in-error
        Comments

        This element is labeled as a modifier because the status contains codes that mark the resource as not currently valid.

        Control1..1
        BindingThe codes SHALL be taken from FinancialResourceStatusCodeshttp://hl7.org/fhir/ValueSet/fm-status|4.0.1
        (required to http://hl7.org/fhir/ValueSet/fm-status|4.0.1)

        A code specifying the state of the resource instance.

        Typecode
        Is Modifiertrue because This element is labeled as a modifier because it is a status element that contains status entered-in-error which means that the resource should not be treated as valid
        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
        Must Supporttrue
        Obligations
          ObligationsActor
          SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
          SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
          Summarytrue
          Requirements

          Need to track the status of the resource as 'draft' resources may undergo further edits while 'active' resources are immutable and may only have their status changed to 'cancelled'.

          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
          20. ClaimResponse.type
          Definition

          A finer grained suite of claim type codes which may convey additional information such as Inpatient vs Outpatient and/or a specialty service.

          ShortLoại: institutional (nội trú) | professional (ngoại trú)More granular claim type
          Comments

          This may contain the local bill type codes, for example the US UB-04 bill type code or the CMS bill type.

          Control1..1
          BindingUnless not suitable, these codes SHALL be taken from ClaimTypeCodeshttp://hl7.org/fhir/ValueSet/claim-type|4.0.1
          (extensible to http://hl7.org/fhir/ValueSet/claim-type|4.0.1)

          The type or discipline-style of the claim.

          TypeCodeableConcept
          Is Modifierfalse
          Must Supporttrue
          Obligations
            ObligationsActor
            SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
            SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
            Summarytrue
            Requirements

            Some jurisdictions need a finer grained claim type for routing and adjudication.

            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
            22. ClaimResponse.use
            Definition

            A code to indicate whether the nature of the request is: to request adjudication of products and services previously rendered; or requesting authorization and adjudication for provision in the future; or requesting the non-binding adjudication of the listed products and services which could be provided in the future.

            ShortMục đích: claim | preauthorization | predeterminationclaim | preauthorization | predetermination
            Control1..1
            BindingThe codes SHALL be taken from Usehttp://hl7.org/fhir/ValueSet/claim-use|4.0.1
            (required to http://hl7.org/fhir/ValueSet/claim-use|4.0.1)

            Claim, preauthorization, predetermination.

            Typecode
            Is Modifierfalse
            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
            Must Supporttrue
            Obligations
              ObligationsActor
              SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
              SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
              Summarytrue
              Requirements

              This element is required to understand the nature of the request for adjudication.

              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
              24. ClaimResponse.patient
              Definition

              The party to whom the professional services and/or products have been supplied or are being considered and for whom actual for facast reimbursement is sought.

              ShortBệnh nhânThe recipient of the products and services
              Control1..1
              TypeReference(Bệnh nhân VN Core — VN Core Patient Profile, Patient)
              Is Modifierfalse
              Must Supporttrue
              Obligations
                ObligationsActor
                SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                Summarytrue
                Requirements

                The patient must be supplied to the insurer so that confirmation of coverage and service hstory may be considered as part of the authorization and/or adjudiction.

                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                26. ClaimResponse.created
                Definition

                The date this resource was created.

                ShortNgày tạo kết quảResponse creation date
                Control1..1
                TypedateTime
                Is Modifierfalse
                Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                Must Supporttrue
                Obligations
                  ObligationsActor
                  SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                  SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                  Summarytrue
                  Requirements

                  Need to record a timestamp for use by both the recipient and the issuer.

                  Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                  28. ClaimResponse.insurer
                  Definition

                  The party responsible for authorization, adjudication and reimbursement.

                  ShortCơ quan BHXH giải quyếtParty responsible for reimbursement
                  Control1..1
                  TypeReference(Organization)
                  Is Modifierfalse
                  Must Supporttrue
                  Obligations
                    ObligationsActor
                    SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                    SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                    Summarytrue
                    Requirements

                    To be a valid claim, preauthorization or predetermination there must be a party who is responsible for adjudicating the contents against a policy which provides benefits for the patient.

                    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                    30. ClaimResponse.request
                    Definition

                    Original request resource reference.

                    ShortYêu cầu thanh toán gốc (VNCoreClaim)Id of resource triggering adjudication
                    Control0..1
                    TypeReference(Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile, Claim)
                    Is Modifierfalse
                    Must Supporttrue
                    Obligations
                      ObligationsActor
                      SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                      SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                      Summarytrue
                      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                      32. ClaimResponse.outcome
                      Definition

                      The outcome of the claim, predetermination, or preauthorization processing.

                      ShortKết quả: queued | complete | error | partialqueued | complete | error | partial
                      Comments

                      The resource may be used to indicate that: the request has been held (queued) for processing; that it has been processed and errors found (error); that no errors were found and that some of the adjudication has been undertaken (partial) or that all of the adjudication has been undertaken (complete).

                      Control1..1
                      BindingThe codes SHALL be taken from ClaimProcessingCodeshttp://hl7.org/fhir/ValueSet/remittance-outcome|4.0.1
                      (required to http://hl7.org/fhir/ValueSet/remittance-outcome|4.0.1)

                      The result of the claim processing.

                      Typecode
                      Is Modifierfalse
                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                      Must Supporttrue
                      Obligations
                        ObligationsActor
                        SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                        SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                        Summarytrue
                        Requirements

                        To advise the requestor of an overall processing outcome.

                        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                        34. ClaimResponse.item
                        Definition

                        A claim line. Either a simple (a product or service) or a 'group' of details which can also be a simple items or groups of sub-details.

                        ShortKết quả từng dòng chi phíAdjudication for claim line items
                        Control0..*
                        TypeBackboneElement
                        Is Modifierfalse
                        Must Supporttrue
                        Obligations
                          ObligationsActor
                          SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                          SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                          Summaryfalse
                          Requirements

                          The adjudication for items provided on the claim.

                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                          36. ClaimResponse.item.modifierExtension
                          Definition

                          May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

                          Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                          ShortExtensions that cannot be ignored even if unrecognized
                          Comments

                          There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                          Control0..*
                          TypeExtension
                          Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                          Summarytrue
                          Requirements

                          Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                          Alternate Namesextensions, user content, modifiers
                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                          ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                          38. ClaimResponse.item.itemSequence
                          Definition

                          A number to uniquely reference the claim item entries.

                          ShortClaim item instance identifier
                          Control1..1
                          TypepositiveInt
                          Is Modifierfalse
                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                          Must Supporttrue
                          Summaryfalse
                          Requirements

                          Necessary to provide a mechanism to link the adjudication result to the submitted claim item.

                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                          40. ClaimResponse.item.adjudication
                          Definition

                          If this item is a group then the values here are a summary of the adjudication of the detail items. If this item is a simple product or service then this is the result of the adjudication of this item.

                          ShortPhân bổ chi phí: đề nghị, đủ ĐK, cùng chi trả, BHYT thanh toánAdjudication details
                          Control1..*
                          TypeBackboneElement
                          Is Modifierfalse
                          Must Supporttrue
                          Summaryfalse
                          Requirements

                          The adjudication results conveys the insurer's assessment of the item provided in the claim under the terms of the patient's insurance coverage.

                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                          42. ClaimResponse.item.adjudication.extension
                          Definition

                          An Extension


                          May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                          ShortExtensionAdditional content defined by implementations
                          Comments

                          There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                          Control0..*
                          TypeExtension
                          Is Modifierfalse
                          Summaryfalse
                          Alternate Namesextensions, user content
                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                          ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                          SlicingThis element introduces a set of slices on ClaimResponse.item.adjudication.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                          • value @ url
                          • 44. ClaimResponse.item.adjudication.extension:legalEvidence
                            Slice NamelegalEvidence
                            Definition

                            Một căn cứ pháp lý cụ thể, có điều/khoản và tài liệu chứng minh, cho một kết quả giám định — đặc biệt cho khoản tiền mang category denied.

                            Vì sao bắt buộc với từ chối. NĐ 188/2025/NĐ-CP Điều 51 khoản 2 quy định việc từ chối thanh toán "phải nêu rõ căn cứ, lý do từ chối, số tiền bị từ chối thanh toán trong biên bản giám định". Ba yếu tố đó là điều kiện của chính hành vi từ chối, không phải siêu dữ liệu tuỳ chọn. Một bản ghi chỉ nói "bị từ chối" mà không dẫn được căn cứ thì không đủ để cơ sở khám bệnh, chữa bệnh thực hiện quyền kiến nghị tại Điều 51 khoản 3.

                            Vì sao áp cả cho khoản bị từ chối tự động. Cũng tại khoản 2, nghĩa vụ nêu căn cứ bao gồm "cả các chi phí khám bệnh, chữa bệnh bảo hiểm y tế đề nghị cơ quan bảo hiểm xã hội thanh toán trên môi trường điện tử được trả tự động khi cơ sở khám bệnh, chữa bệnh gửi dữ liệu". Từ chối do hệ thống tự sinh không được miễn nghĩa vụ này.

                            Ranh giới. Extension mang căn cứ mà bên giám định VIỆN DẪN; nó không chứng minh việc viện dẫn là đúng. Đánh giá tính đúng đắn thuộc quy trình kiến nghị và cơ quan có thẩm quyền.

                            ShortCăn cứ pháp lý của kết quả giám định (bắt buộc khi từ chối/thu hồi)
                            Control0..*
                            This element is affected by the following invariants: ele-1
                            TypeExtension(Bằng chứng pháp lý của kết quả giám định — Adjudication Legal Evidence) (Complex Extension)
                            Is Modifierfalse
                            Must Supporttrue
                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                            ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                            46. ClaimResponse.item.adjudication.modifierExtension
                            Definition

                            May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

                            Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                            ShortExtensions that cannot be ignored even if unrecognized
                            Comments

                            There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                            Control0..*
                            TypeExtension
                            Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                            Summarytrue
                            Requirements

                            Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                            Alternate Namesextensions, user content, modifiers
                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                            ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                            48. ClaimResponse.item.adjudication.category
                            Definition

                            Category giám định từng dòng. Ưu tiên HL7 adjudication (submitted, eligible, copay, benefit) cho line-level adjudication; các subtotal cục bộ của VN Core không dùng ở line-level.


                            A code to indicate the information type of this adjudication record. Information types may include the value submitted, maximum values or percentages allowed or payable under the plan, amounts that: the patient is responsible for in aggregate or pertaining to this item; amounts paid by other coverages; and, the benefit payable for this item.

                            ShortLoại: submitted | eligible | copay | benefit | denied | recoveredType of adjudication information
                            Comments

                            For example codes indicating: Co-Pay, deductible, eligible, benefit, tax, etc.

                            Control1..1
                            BindingUnless not suitable, these codes SHALL be taken from For example codes, see Loại adjudication BHYT — BHYT Adjudication Category ValueSethttp://hl7.org/fhir/ValueSet/adjudication|4.0.1
                            (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-adjudication-category-vs)
                            TypeCodeableConcept
                            Is Modifierfalse
                            Must Supporttrue
                            Summaryfalse
                            Requirements

                            Needed to enable understanding of the context of the other information in the adjudication.

                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                            50. ClaimResponse.item.adjudication.reason
                            Definition

                            Lý do nghiệp vụ dẫn tới kết quả này. Bắt buộc với category denied/recovered theo invariant vn-claim-response-denied-complete. Danh mục là taxonomy baseline cục bộ, KHÔNG phải catalog mã từ chối chính thức: NĐ 188/2025/NĐ-CP Điều 51 không ban hành danh mục mã lý do, chỉ buộc nêu rõ lý do.


                            A code supporting the understanding of the adjudication result and explaining variance from expected amount.

                            ShortLý do của kết quả giám định — bắt buộc khi category là denied hoặc recoveredExplanation of adjudication outcome
                            Comments

                            For example may indicate that the funds for this benefit type have been exhausted.

                            Control0..1
                            BindingUnless not suitable, these codes SHALL be taken from For example codes, see Issue tầng NGHIỆP VỤ — VN BHYT Adjudication Issue ValueSethttp://hl7.org/fhir/ValueSet/adjudication-reason|4.0.1
                            (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-adjudication-issue-vs)
                            TypeCodeableConcept
                            Is Modifierfalse
                            Must Supporttrue
                            Summaryfalse
                            Requirements

                            To support understanding of variance from adjudication expectations.

                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                            52. ClaimResponse.item.adjudication.amount
                            Definition

                            Số tiền của dòng giám định. Đồng Việt Nam KHÔNG có đơn vị nhỏ hơn đồng đang lưu hành, nên Money.value ghi thẳng số đồng: 200000 nghĩa là hai trăm nghìn đồng. KHÔNG nhân/chia 100 theo thói quen của các hệ tiền tệ có xu, và KHÔNG ghi phần thập phân.


                            Monetary amount associated with the category.

                            ShortSố tiền (VND, đơn vị đồng — xem quy ước đơn vị tiền bên dưới)Monetary amount
                            Comments

                            For example: amount submitted, eligible amount, co-payment, and benefit payable.

                            Control0..1
                            TypeMoney
                            Is Modifierfalse
                            Must Supporttrue
                            Summaryfalse
                            Requirements

                            Most adjuciation categories convey a monetary amount.

                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                            54. ClaimResponse.total
                            Definition

                            Categorized monetary totals for the adjudication.

                            ShortTổng adjudicationAdjudication totals
                            Comments

                            Totals for amounts submitted, co-pays, benefits payable etc.

                            Control0..*
                            TypeBackboneElement
                            Is Modifierfalse
                            Must Supporttrue
                            Obligations
                              ObligationsActor
                              SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                              SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                              Summarytrue
                              Requirements

                              To provide the requestor with financial totals by category for the adjudication.

                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                              56. ClaimResponse.total.modifierExtension
                              Definition

                              May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

                              Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                              ShortExtensions that cannot be ignored even if unrecognized
                              Comments

                              There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                              Control0..*
                              TypeExtension
                              Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                              Summarytrue
                              Requirements

                              Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                              Alternate Namesextensions, user content, modifiers
                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                              ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                              58. ClaimResponse.total.category
                              Definition

                              Category tổng hợp tài chính/adjudication. Dùng ConceptMap vn-cm-bhyt-financial-field-to-adjudication để map các trường tổng tiền BHYT như T_TONGCHI, T_TONGCHI_BH, T_BHTT, T_BNCCT, T_BNTT, T_NGUONKHAC, T_NGOAIDS, T_THUOC, T_VTYT. Không encode công thức quyền lợi hoặc adjudication business rule tại profile.


                              A code to indicate the information type of this adjudication record. Information types may include: the value submitted, maximum values or percentages allowed or payable under the plan, amounts that the patient is responsible for in aggregate or pertaining to this item, amounts paid by other coverages, and the benefit payable for this item.

                              ShortLoại tổng: submitted | eligible | copay | benefit hoặc category BHYT cục bộType of adjudication information
                              Comments

                              For example codes indicating: Co-Pay, deductible, eligible, benefit, tax, etc.

                              Control1..1
                              BindingUnless not suitable, these codes SHALL be taken from For example codes, see Loại adjudication BHYT — BHYT Adjudication Category ValueSethttp://hl7.org/fhir/ValueSet/adjudication|4.0.1
                              (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-adjudication-category-vs)
                              TypeCodeableConcept
                              Is Modifierfalse
                              Must Supporttrue
                              Summarytrue
                              Requirements

                              Needed to convey the type of total provided.

                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                              60. ClaimResponse.total.amount
                              Definition

                              Monetary total amount associated with the category.

                              ShortFinancial total for the category
                              Control1..1
                              TypeMoney
                              Is Modifierfalse
                              Must Supporttrue
                              Summarytrue
                              Requirements

                              Needed to convey the total monetary amount.

                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                              62. ClaimResponse.payment
                              Definition

                              Payment details for the adjudication of the claim.

                              ShortThông tin thanh toánPayment Details
                              Control0..1
                              TypeBackboneElement
                              Is Modifierfalse
                              Summaryfalse
                              Requirements

                              Needed to convey references to the financial instrument that has been used if payment has been made.

                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                              64. ClaimResponse.payment.modifierExtension
                              Definition

                              May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

                              Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                              ShortExtensions that cannot be ignored even if unrecognized
                              Comments

                              There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                              Control0..*
                              TypeExtension
                              Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                              Summarytrue
                              Requirements

                              Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                              Alternate Namesextensions, user content, modifiers
                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                              ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                              66. ClaimResponse.payment.type
                              Definition

                              Whether this represents partial or complete payment of the benefits payable.

                              ShortPartial or complete payment
                              Control1..1
                              BindingFor example codes, see ExamplePaymentTypeCodeshttp://hl7.org/fhir/ValueSet/ex-paymenttype|4.0.1
                              (example to http://hl7.org/fhir/ValueSet/ex-paymenttype|4.0.1)

                              The type (partial, complete) of the payment.

                              TypeCodeableConcept
                              Is Modifierfalse
                              Summaryfalse
                              Requirements

                              To advise the requestor when the insurer believes all payments to have been completed.

                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                              68. ClaimResponse.payment.amount
                              Definition

                              Benefits payable less any payment adjustment.

                              ShortSố tiền BHXH thanh toánPayable amount after adjustment
                              Control1..1
                              TypeMoney
                              Is Modifierfalse
                              Summaryfalse
                              Requirements

                              Needed to provide the actual payment amount.

                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                              70. ClaimResponse.error
                              Definition

                              CHỈ dùng cho processing error theo semantics FHIR R4 — payload không xử lý được, tham chiếu không resolve, hồ sơ sai cấu trúc. KHÔNG dùng cho từ chối thanh toán có căn cứ pháp lý: từ chối là KẾT QUẢ của giám định (NĐ 188/2025/NĐ-CP Điều 51 khoản 1 — chi phí được xác định không đúng quy định trong quá trình giám định), còn error là việc KHÔNG giám định được. Từ chối nghiệp vụ nằm ở adjudication category denied; thu hồi sau thanh toán nằm ở recovered.


                              Errors encountered during the processing of the adjudication.

                              ShortLỗi xử lý khiến hồ sơ không adjudicate đượcProcessing errors
                              Comments

                              If the request contains errors then an error element should be provided and no adjudication related sections (item, addItem, or payment) should be present.

                              Control0..*
                              TypeBackboneElement
                              Is Modifierfalse
                              Must Supporttrue
                              Obligations
                                ObligationsActor
                                SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                Summaryfalse
                                Requirements

                                Need to communicate processing issues to the requestor.

                                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                72. ClaimResponse.error.modifierExtension
                                Definition

                                May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

                                Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                                ShortExtensions that cannot be ignored even if unrecognized
                                Comments

                                There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                Control0..*
                                TypeExtension
                                Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                                Summarytrue
                                Requirements

                                Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                                Alternate Namesextensions, user content, modifiers
                                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                74. ClaimResponse.error.itemSequence
                                Definition

                                The sequence number of the line item submitted which contains the error. This value is omitted when the error occurs outside of the item structure.

                                ShortDòng chi phí liên quan nếu cóItem sequence number
                                Control0..1
                                TypepositiveInt
                                Is Modifierfalse
                                Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                Must Supporttrue
                                Summaryfalse
                                Requirements

                                Provides references to the claim items.

                                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                76. ClaimResponse.error.detailSequence
                                Definition

                                The sequence number of the detail within the line item submitted which contains the error. This value is omitted when the error occurs outside of the item structure.

                                ShortDetail sequence number
                                Control0..1
                                TypepositiveInt
                                Is Modifierfalse
                                Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                Must Supporttrue
                                Summaryfalse
                                Requirements

                                Provides references to the claim details within the claim item.

                                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                78. ClaimResponse.error.subDetailSequence
                                Definition

                                The sequence number of the sub-detail within the detail within the line item submitted which contains the error. This value is omitted when the error occurs outside of the item structure.

                                ShortSubdetail sequence number
                                Control0..1
                                TypepositiveInt
                                Is Modifierfalse
                                Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                Must Supporttrue
                                Summaryfalse
                                Requirements

                                Provides references to the claim sub-details within the claim detail.

                                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                80. ClaimResponse.error.code
                                Definition

                                Binding thu hẹp từ VNBHYTReviewIssueVS xuống VNBHYTProcessingIssueVS (từ 0.10.0): tập đầy đủ chứa cả mã kết quả giám định như LEGAL_NON_COMPLIANT_COST, và cho phép chúng ở đây chính là cách IG trước đây khuyến khích dùng sai element. Mã kết quả giám định nay thuộc VNBHYTAdjudicationIssueVS, dùng tại adjudication.reason.


                                An error code, from a specified code system, which details why the claim could not be adjudicated.

                                ShortMã lỗi xử lýError code detailing processing issues
                                Control1..1
                                BindingUnless not suitable, these codes SHALL be taken from For example codes, see Issue tầng XỬ LÝ — VN BHYT Processing Issue ValueSethttp://hl7.org/fhir/ValueSet/adjudication-error|4.0.1
                                (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-processing-issue-vs)
                                TypeCodeableConcept
                                Is Modifierfalse
                                Must Supporttrue
                                Summaryfalse
                                Requirements

                                Required to convey processing errors.

                                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))

                                Guidance on how to interpret the contents of this table can be foundhere

                                0. ClaimResponse
                                Invariantsvn-claim-response-error-outcome-coherent: Có lỗi xử lý thì outcome phải là `error`. When a processing error is present, outcome SHALL be `error`. (error.empty() or outcome = 'error')
                                vn-claim-response-denied-complete: Khoản tiền bị từ chối hoặc bị thu hồi phải có số tiền không âm, lý do và ít nhất một căn cứ pháp lý. A denied or recovered amount SHALL carry a non-negative amount, a reason and at least one legal basis. ((adjudication | item.adjudication | item.detail.adjudication | item.detail.subDetail.adjudication | addItem.adjudication | addItem.detail.adjudication | addItem.detail.subDetail.adjudication).where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).all(amount.value.exists() and amount.value >= 0 and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()))
                                vn-claim-response-itemized: Phản hồi giám định phải liệt kê từng dòng chi phí, trừ khi kết quả là lỗi kỹ thuật. An adjudication response SHALL be itemized unless its outcome is an error. (outcome = 'error' or item.exists())
                                vn-claim-response-total-matches-items: Mỗi tổng theo mã adjudication chuẩn phải bằng tổng các dòng cùng mã. Each total for a standard adjudication category SHALL equal the sum of the matching item adjudications. (item.empty() or ((total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.exists() and item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.exists() implies total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value = item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.aggregate($this + $total, 0)) and (total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.exists() and item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.exists() implies total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value = item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.aggregate($this + $total, 0)) and (total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'benefit').exists()).amount.value.exists() and item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'benefit').exists()).amount.value.exists() implies total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'benefit').exists()).amount.value = item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'benefit').exists()).amount.value.aggregate($this + $total, 0)) and (total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'copay').exists()).amount.value.exists() and item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'copay').exists()).amount.value.exists() implies total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'copay').exists()).amount.value = item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'copay').exists()).amount.value.aggregate($this + $total, 0))))
                                vn-claim-response-reduction-evidenced: Dòng chi phí có số đủ điều kiện thấp hơn số đề nghị phải mang bằng chứng tường minh: hoặc kết quả từ chối/thu hồi (category denied/recovered kèm lý do và căn cứ), hoặc dòng eligible mang lý do + căn cứ pháp lý (khoản ngoài phạm vi hưởng) — không được giảm tiền im lặng. An item whose eligible amount is lower than submitted SHALL carry either an explicit denied/recovered adjudication or a reason plus legal basis on the eligible adjudication. (item.all(adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.first() >= adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.first() or adjudication.where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).exists() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists() and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()).exists()))
                                vn-claim-response-reduction-evidenced-nested: Quy tắc giảm-tiền-phải-có-bằng-chứng áp cho MỌI đường adjudication còn lại: dòng chi tiết, chi tiết phụ, dòng bổ sung và chi tiết/chi tiết phụ của dòng bổ sung — hậu kiểm 13/08/2026 chỉ ra addItem.detail/subDetail chưa được phủ. The reduction-evidence rule SHALL hold on item.detail, item.detail.subDetail, addItem, addItem.detail and addItem.detail.subDetail adjudications. (item.detail.all(adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.first() >= adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.first() or adjudication.where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).exists() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists() and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()).exists()) and item.detail.subDetail.all(adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.first() >= adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.first() or adjudication.where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).exists() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists() and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()).exists()) and addItem.all(adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.first() >= adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.first() or adjudication.where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).exists() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists() and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()).exists()) and addItem.detail.all(adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.first() >= adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.first() or adjudication.where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).exists() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists() and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()).exists()) and addItem.detail.subDetail.all(adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.first() >= adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.first() or adjudication.where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).exists() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists() and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()).exists()))
                                vn-claim-response-reduction-evidenced-header: Quy tắc giảm-tiền-phải-có-bằng-chứng áp cho cả adjudication cấp tổng thể của ClaimResponse. The reduction-evidence rule SHALL also hold on the header-level ClaimResponse.adjudication. (adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.first() >= adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.first() or adjudication.where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).exists() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists() and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()).exists())
                                vn-claim-response-adjudication-unique-category: Trong một cụm adjudication (header, item, chi tiết, chi tiết phụ, dòng bổ sung và các tầng con của nó), mỗi category HL7 chuẩn chỉ xuất hiện một lần — hợp đồng mapping OHP mà phép so sánh giảm-tiền dựa vào. Within each adjudication set every standard HL7 category SHALL appear at most once. (adjudication.category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication').code.isDistinct() and item.all(adjudication.category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication').code.isDistinct()) and item.detail.all(adjudication.category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication').code.isDistinct()) and item.detail.subDetail.all(adjudication.category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication').code.isDistinct()) and addItem.all(adjudication.category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication').code.isDistinct()) and addItem.detail.all(adjudication.category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication').code.isDistinct()) and addItem.detail.subDetail.all(adjudication.category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication').code.isDistinct()))
                                vn-claim-response-correlation-anchor: Kết quả giám định đang hiệu lực phải đối soát được BẰNG GIÁ TRỊ THẬT: request phải là reference giải quyết được (không display-only) hoặc identifier phải có value — Identifier rỗng/Reference chỉ có display không đối soát được với hồ sơ nào (siết round 3, 13/08/2026). An active ClaimResponse SHALL carry a resolvable request reference or an identifier WITH a value. (status != 'active' or request.reference.exists() or identifier.value.exists())
                                vn-claim-response-money-vnd: Mọi khoản tiền của kết quả giám định phải dùng VND. Every monetary amount in the adjudication result SHALL use VND. (descendants().ofType(Money).all(currency = 'VND'))
                                2. ClaimResponse.identifier
                                ShortĐịnh danh kết quả xử lý, bao gồm mã phản hồi gateway nếu có
                                NoteThis is a business identifier, not a resource identifier (see discussion)
                                Must Supporttrue
                                Obligations
                                  ObligationsActor
                                  SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                  SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                  SlicingThis element introduces a set of slices on ClaimResponse.identifier. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                  • value @ system
                                  • 4. ClaimResponse.identifier:gatewayResponseId
                                    Slice NamegatewayResponseId
                                    Definition

                                    Mã phản hồi của Cổng tiếp nhận dữ liệu cho hồ sơ/bảng XML1. Không dùng thay cho MA_LK.

                                    ShortMã phản hồi Cổng tiếp nhận BHYT (XML1_ID)
                                    NoteThis is a business identifier, not a resource identifier (see discussion)
                                    Control0..1
                                    Must Supporttrue
                                    Obligations
                                      ObligationsActor
                                      SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                      SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                      6. ClaimResponse.identifier:gatewayResponseId.type
                                      Pattern Value{
                                        "coding" : [{
                                          "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs",
                                          "code" : "BHYT_XML1_ID"
                                        }]
                                      }
                                      8. ClaimResponse.identifier:gatewayResponseId.system
                                      Control1..?
                                      Fixed Valuehttp://fhir.hl7.org.vn/core/sid/bhyt-gateway-response-id
                                      10. ClaimResponse.identifier:gatewayResponseId.value
                                      ShortGiá trị XML1_ID hoặc mã phản hồi tương đương
                                      Control1..?
                                      Must Supporttrue
                                      12. ClaimResponse.status
                                      ShortTrạng thái kết quả: active | cancelled | draft | entered-in-error
                                      Must Supporttrue
                                      Obligations
                                        ObligationsActor
                                        SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                        SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                        14. ClaimResponse.type
                                        ShortLoại: institutional (nội trú) | professional (ngoại trú)
                                        Must Supporttrue
                                        Obligations
                                          ObligationsActor
                                          SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                          SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                          16. ClaimResponse.use
                                          ShortMục đích: claim | preauthorization | predetermination
                                          Must Supporttrue
                                          Obligations
                                            ObligationsActor
                                            SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                            SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                            18. ClaimResponse.patient
                                            ShortBệnh nhân
                                            TypeReference(Bệnh nhân VN Core — VN Core Patient Profile)
                                            Must Supporttrue
                                            Obligations
                                              ObligationsActor
                                              SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                              SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                              20. ClaimResponse.created
                                              ShortNgày tạo kết quả
                                              Must Supporttrue
                                              Obligations
                                                ObligationsActor
                                                SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                                SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                                22. ClaimResponse.insurer
                                                ShortCơ quan BHXH giải quyết
                                                Must Supporttrue
                                                Obligations
                                                  ObligationsActor
                                                  SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                                  SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                                  24. ClaimResponse.request
                                                  ShortYêu cầu thanh toán gốc (VNCoreClaim)
                                                  TypeReference(Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile)
                                                  Must Supporttrue
                                                  Obligations
                                                    ObligationsActor
                                                    SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                                    SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                                    26. ClaimResponse.outcome
                                                    ShortKết quả: queued | complete | error | partial
                                                    Must Supporttrue
                                                    Obligations
                                                      ObligationsActor
                                                      SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                                      SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                                      28. ClaimResponse.item
                                                      ShortKết quả từng dòng chi phí
                                                      Must Supporttrue
                                                      Obligations
                                                        ObligationsActor
                                                        SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                                        SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                                        30. ClaimResponse.item.itemSequence
                                                        Must Supporttrue
                                                        32. ClaimResponse.item.adjudication
                                                        ShortPhân bổ chi phí: đề nghị, đủ ĐK, cùng chi trả, BHYT thanh toán
                                                        Must Supporttrue
                                                        34. ClaimResponse.item.adjudication.extension
                                                        SlicingThis element introduces a set of slices on ClaimResponse.item.adjudication.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                                        • value @ url
                                                        • 36. ClaimResponse.item.adjudication.extension:legalEvidence
                                                          Slice NamelegalEvidence
                                                          ShortCăn cứ pháp lý của kết quả giám định (bắt buộc khi từ chối/thu hồi)
                                                          Control0..*
                                                          TypeExtension(Bằng chứng pháp lý của kết quả giám định — Adjudication Legal Evidence) (Complex Extension)
                                                          Must Supporttrue
                                                          38. ClaimResponse.item.adjudication.category
                                                          Definition

                                                          Category giám định từng dòng. Ưu tiên HL7 adjudication (submitted, eligible, copay, benefit) cho line-level adjudication; các subtotal cục bộ của VN Core không dùng ở line-level.

                                                          ShortLoại: submitted | eligible | copay | benefit | denied | recovered
                                                          BindingUnless not suitable, these codes SHALL be taken from Loại adjudication BHYT — BHYT Adjudication Category ValueSet
                                                          (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-adjudication-category-vs)
                                                          Must Supporttrue
                                                          40. ClaimResponse.item.adjudication.reason
                                                          Definition

                                                          Lý do nghiệp vụ dẫn tới kết quả này. Bắt buộc với category denied/recovered theo invariant vn-claim-response-denied-complete. Danh mục là taxonomy baseline cục bộ, KHÔNG phải catalog mã từ chối chính thức: NĐ 188/2025/NĐ-CP Điều 51 không ban hành danh mục mã lý do, chỉ buộc nêu rõ lý do.

                                                          ShortLý do của kết quả giám định — bắt buộc khi category là denied hoặc recovered
                                                          BindingUnless not suitable, these codes SHALL be taken from Issue tầng NGHIỆP VỤ — VN BHYT Adjudication Issue ValueSet
                                                          (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-adjudication-issue-vs)
                                                          Must Supporttrue
                                                          42. ClaimResponse.item.adjudication.amount
                                                          Definition

                                                          Số tiền của dòng giám định. Đồng Việt Nam KHÔNG có đơn vị nhỏ hơn đồng đang lưu hành, nên Money.value ghi thẳng số đồng: 200000 nghĩa là hai trăm nghìn đồng. KHÔNG nhân/chia 100 theo thói quen của các hệ tiền tệ có xu, và KHÔNG ghi phần thập phân.

                                                          ShortSố tiền (VND, đơn vị đồng — xem quy ước đơn vị tiền bên dưới)
                                                          Must Supporttrue
                                                          44. ClaimResponse.total
                                                          ShortTổng adjudication
                                                          Must Supporttrue
                                                          Obligations
                                                            ObligationsActor
                                                            SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                                            SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                                            46. ClaimResponse.total.category
                                                            Definition

                                                            Category tổng hợp tài chính/adjudication. Dùng ConceptMap vn-cm-bhyt-financial-field-to-adjudication để map các trường tổng tiền BHYT như T_TONGCHI, T_TONGCHI_BH, T_BHTT, T_BNCCT, T_BNTT, T_NGUONKHAC, T_NGOAIDS, T_THUOC, T_VTYT. Không encode công thức quyền lợi hoặc adjudication business rule tại profile.

                                                            ShortLoại tổng: submitted | eligible | copay | benefit hoặc category BHYT cục bộ
                                                            BindingUnless not suitable, these codes SHALL be taken from Loại adjudication BHYT — BHYT Adjudication Category ValueSet
                                                            (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-adjudication-category-vs)
                                                            Must Supporttrue
                                                            48. ClaimResponse.total.amount
                                                            Must Supporttrue
                                                            50. ClaimResponse.payment
                                                            ShortThông tin thanh toán
                                                            52. ClaimResponse.payment.amount
                                                            ShortSố tiền BHXH thanh toán
                                                            54. ClaimResponse.error
                                                            Definition

                                                            CHỈ dùng cho processing error theo semantics FHIR R4 — payload không xử lý được, tham chiếu không resolve, hồ sơ sai cấu trúc. KHÔNG dùng cho từ chối thanh toán có căn cứ pháp lý: từ chối là KẾT QUẢ của giám định (NĐ 188/2025/NĐ-CP Điều 51 khoản 1 — chi phí được xác định không đúng quy định trong quá trình giám định), còn error là việc KHÔNG giám định được. Từ chối nghiệp vụ nằm ở adjudication category denied; thu hồi sau thanh toán nằm ở recovered.

                                                            ShortLỗi xử lý khiến hồ sơ không adjudicate được
                                                            Must Supporttrue
                                                            Obligations
                                                              ObligationsActor
                                                              SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                                              SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                                              56. ClaimResponse.error.itemSequence
                                                              ShortDòng chi phí liên quan nếu có
                                                              Must Supporttrue
                                                              58. ClaimResponse.error.detailSequence
                                                              Must Supporttrue
                                                              60. ClaimResponse.error.subDetailSequence
                                                              Must Supporttrue
                                                              62. ClaimResponse.error.code
                                                              Definition

                                                              Binding thu hẹp từ VNBHYTReviewIssueVS xuống VNBHYTProcessingIssueVS (từ 0.10.0): tập đầy đủ chứa cả mã kết quả giám định như LEGAL_NON_COMPLIANT_COST, và cho phép chúng ở đây chính là cách IG trước đây khuyến khích dùng sai element. Mã kết quả giám định nay thuộc VNBHYTAdjudicationIssueVS, dùng tại adjudication.reason.

                                                              ShortMã lỗi xử lý
                                                              BindingUnless not suitable, these codes SHALL be taken from Issue tầng XỬ LÝ — VN BHYT Processing Issue ValueSet
                                                              (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-processing-issue-vs)
                                                              Must Supporttrue

                                                              Guidance on how to interpret the contents of this table can be foundhere

                                                              0. ClaimResponse
                                                              Definition

                                                              This resource provides the adjudication details from the processing of a Claim resource.

                                                              ShortResponse to a claim predetermination or preauthorization
                                                              Control0..*
                                                              Is Modifierfalse
                                                              Summaryfalse
                                                              Alternate NamesRemittance Advice
                                                              Invariantsdom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources (contained.contained.empty())
                                                              dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource (contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty())
                                                              dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated (contained.meta.versionId.empty() and contained.meta.lastUpdated.empty())
                                                              dom-5: If a resource is contained in another resource, it SHALL NOT have a security label (contained.meta.security.empty())
                                                              dom-6: A resource should have narrative for robust management (text.`div`.exists())
                                                              vn-claim-response-error-outcome-coherent: Có lỗi xử lý thì outcome phải là `error`. When a processing error is present, outcome SHALL be `error`. (error.empty() or outcome = 'error')
                                                              vn-claim-response-denied-complete: Khoản tiền bị từ chối hoặc bị thu hồi phải có số tiền không âm, lý do và ít nhất một căn cứ pháp lý. A denied or recovered amount SHALL carry a non-negative amount, a reason and at least one legal basis. ((adjudication | item.adjudication | item.detail.adjudication | item.detail.subDetail.adjudication | addItem.adjudication | addItem.detail.adjudication | addItem.detail.subDetail.adjudication).where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).all(amount.value.exists() and amount.value >= 0 and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()))
                                                              vn-claim-response-itemized: Phản hồi giám định phải liệt kê từng dòng chi phí, trừ khi kết quả là lỗi kỹ thuật. An adjudication response SHALL be itemized unless its outcome is an error. (outcome = 'error' or item.exists())
                                                              vn-claim-response-total-matches-items: Mỗi tổng theo mã adjudication chuẩn phải bằng tổng các dòng cùng mã. Each total for a standard adjudication category SHALL equal the sum of the matching item adjudications. (item.empty() or ((total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.exists() and item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.exists() implies total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value = item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.aggregate($this + $total, 0)) and (total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.exists() and item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.exists() implies total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value = item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.aggregate($this + $total, 0)) and (total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'benefit').exists()).amount.value.exists() and item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'benefit').exists()).amount.value.exists() implies total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'benefit').exists()).amount.value = item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'benefit').exists()).amount.value.aggregate($this + $total, 0)) and (total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'copay').exists()).amount.value.exists() and item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'copay').exists()).amount.value.exists() implies total.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'copay').exists()).amount.value = item.adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'copay').exists()).amount.value.aggregate($this + $total, 0))))
                                                              vn-claim-response-reduction-evidenced: Dòng chi phí có số đủ điều kiện thấp hơn số đề nghị phải mang bằng chứng tường minh: hoặc kết quả từ chối/thu hồi (category denied/recovered kèm lý do và căn cứ), hoặc dòng eligible mang lý do + căn cứ pháp lý (khoản ngoài phạm vi hưởng) — không được giảm tiền im lặng. An item whose eligible amount is lower than submitted SHALL carry either an explicit denied/recovered adjudication or a reason plus legal basis on the eligible adjudication. (item.all(adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.first() >= adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.first() or adjudication.where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).exists() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists() and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()).exists()))
                                                              vn-claim-response-reduction-evidenced-nested: Quy tắc giảm-tiền-phải-có-bằng-chứng áp cho MỌI đường adjudication còn lại: dòng chi tiết, chi tiết phụ, dòng bổ sung và chi tiết/chi tiết phụ của dòng bổ sung — hậu kiểm 13/08/2026 chỉ ra addItem.detail/subDetail chưa được phủ. The reduction-evidence rule SHALL hold on item.detail, item.detail.subDetail, addItem, addItem.detail and addItem.detail.subDetail adjudications. (item.detail.all(adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.first() >= adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.first() or adjudication.where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).exists() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists() and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()).exists()) and item.detail.subDetail.all(adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.first() >= adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.first() or adjudication.where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).exists() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists() and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()).exists()) and addItem.all(adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.first() >= adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.first() or adjudication.where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).exists() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists() and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()).exists()) and addItem.detail.all(adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.first() >= adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.first() or adjudication.where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).exists() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists() and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()).exists()) and addItem.detail.subDetail.all(adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.first() >= adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.first() or adjudication.where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).exists() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists() and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()).exists()))
                                                              vn-claim-response-reduction-evidenced-header: Quy tắc giảm-tiền-phải-có-bằng-chứng áp cho cả adjudication cấp tổng thể của ClaimResponse. The reduction-evidence rule SHALL also hold on the header-level ClaimResponse.adjudication. (adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.empty() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists()).amount.value.first() >= adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'submitted').exists()).amount.value.first() or adjudication.where(category.coding.where(system = 'http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs' and (code = 'denied' or code = 'recovered')).exists()).exists() or adjudication.where(category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication' and code = 'eligible').exists() and reason.exists() and extension.where(url = 'http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-adjudication-legal-evidence').exists()).exists())
                                                              vn-claim-response-adjudication-unique-category: Trong một cụm adjudication (header, item, chi tiết, chi tiết phụ, dòng bổ sung và các tầng con của nó), mỗi category HL7 chuẩn chỉ xuất hiện một lần — hợp đồng mapping OHP mà phép so sánh giảm-tiền dựa vào. Within each adjudication set every standard HL7 category SHALL appear at most once. (adjudication.category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication').code.isDistinct() and item.all(adjudication.category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication').code.isDistinct()) and item.detail.all(adjudication.category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication').code.isDistinct()) and item.detail.subDetail.all(adjudication.category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication').code.isDistinct()) and addItem.all(adjudication.category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication').code.isDistinct()) and addItem.detail.all(adjudication.category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication').code.isDistinct()) and addItem.detail.subDetail.all(adjudication.category.coding.where(system = 'http://terminology.hl7.org/CodeSystem/adjudication').code.isDistinct()))
                                                              vn-claim-response-correlation-anchor: Kết quả giám định đang hiệu lực phải đối soát được BẰNG GIÁ TRỊ THẬT: request phải là reference giải quyết được (không display-only) hoặc identifier phải có value — Identifier rỗng/Reference chỉ có display không đối soát được với hồ sơ nào (siết round 3, 13/08/2026). An active ClaimResponse SHALL carry a resolvable request reference or an identifier WITH a value. (status != 'active' or request.reference.exists() or identifier.value.exists())
                                                              vn-claim-response-money-vnd: Mọi khoản tiền của kết quả giám định phải dùng VND. Every monetary amount in the adjudication result SHALL use VND. (descendants().ofType(Money).all(currency = 'VND'))
                                                              2. ClaimResponse.id
                                                              Definition

                                                              The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.

                                                              ShortLogical id of this artifact
                                                              Comments

                                                              The only time that a resource does not have an id is when it is being submitted to the server using a create operation.

                                                              Control0..1
                                                              Typeid
                                                              Is Modifierfalse
                                                              Summarytrue
                                                              4. ClaimResponse.meta
                                                              Definition

                                                              The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content might not always be associated with version changes to the resource.

                                                              ShortMetadata about the resource
                                                              Control0..1
                                                              TypeMeta
                                                              Is Modifierfalse
                                                              Summarytrue
                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                              6. ClaimResponse.implicitRules
                                                              Definition

                                                              A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc.

                                                              ShortA set of rules under which this content was created
                                                              Comments

                                                              Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc.

                                                              Control0..1
                                                              Typeuri
                                                              Is Modifiertrue because This element is labeled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation
                                                              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                              Summarytrue
                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                              8. ClaimResponse.language
                                                              Definition

                                                              The base language in which the resource is written.

                                                              ShortLanguage of the resource content
                                                              Comments

                                                              Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource. Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute).

                                                              Control0..1
                                                              BindingThe codes SHOULD be taken from CommonLanguages
                                                              (preferred to http://hl7.org/fhir/ValueSet/languages|4.0.1)

                                                              A human language.

                                                              Additional BindingsPurpose
                                                              AllLanguagesMax Binding
                                                              Typecode
                                                              Is Modifierfalse
                                                              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                              Summaryfalse
                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                              10. ClaimResponse.text
                                                              Definition

                                                              A human-readable narrative that contains a summary of the resource and can be used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it "clinically safe" for a human to just read the narrative. Resource definitions may define what content should be represented in the narrative to ensure clinical safety.

                                                              ShortText summary of the resource, for human interpretation
                                                              Comments

                                                              Contained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied). This may be necessary for data from legacy systems where information is captured as a "text blob" or where text is additionally entered raw or narrated and encoded information is added later.

                                                              Control0..1
                                                              TypeNarrative
                                                              Is Modifierfalse
                                                              Summaryfalse
                                                              Alternate Namesnarrative, html, xhtml, display
                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                              12. ClaimResponse.contained
                                                              Definition

                                                              These resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope.

                                                              ShortContained, inline Resources
                                                              Comments

                                                              This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. Contained resources may have profiles and tags In their meta elements, but SHALL NOT have security labels.

                                                              Control0..*
                                                              TypeResource
                                                              Is Modifierfalse
                                                              Summaryfalse
                                                              Alternate Namesinline resources, anonymous resources, contained resources
                                                              14. ClaimResponse.extension
                                                              Definition

                                                              May be used to represent additional information that is not part of the basic definition of the resource. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                                                              ShortAdditional content defined by implementations
                                                              Comments

                                                              There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                              Control0..*
                                                              TypeExtension
                                                              Is Modifierfalse
                                                              Summaryfalse
                                                              Alternate Namesextensions, user content
                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                              ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                              16. ClaimResponse.modifierExtension
                                                              Definition

                                                              May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

                                                              Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                                                              ShortExtensions that cannot be ignored
                                                              Comments

                                                              There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                              Control0..*
                                                              TypeExtension
                                                              Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the resource that contains them
                                                              Summaryfalse
                                                              Requirements

                                                              Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                                                              Alternate Namesextensions, user content
                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                              ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                              18. ClaimResponse.identifier
                                                              Definition

                                                              A unique identifier assigned to this claim response.

                                                              ShortĐịnh danh kết quả xử lý, bao gồm mã phản hồi gateway nếu có
                                                              NoteThis is a business identifier, not a resource identifier (see discussion)
                                                              Control0..*
                                                              TypeIdentifier
                                                              Is Modifierfalse
                                                              Must Supporttrue
                                                              Obligations
                                                                ObligationsActor
                                                                SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                                                SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                                                Summaryfalse
                                                                Requirements

                                                                Allows claim responses to be distinguished and referenced.

                                                                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                SlicingThis element introduces a set of slices on ClaimResponse.identifier. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                                                • value @ system
                                                                • 20. ClaimResponse.identifier:gatewayResponseId
                                                                  Slice NamegatewayResponseId
                                                                  Definition

                                                                  Mã phản hồi của Cổng tiếp nhận dữ liệu cho hồ sơ/bảng XML1. Không dùng thay cho MA_LK.

                                                                  ShortMã phản hồi Cổng tiếp nhận BHYT (XML1_ID)
                                                                  NoteThis is a business identifier, not a resource identifier (see discussion)
                                                                  Control0..1
                                                                  TypeIdentifier
                                                                  Is Modifierfalse
                                                                  Must Supporttrue
                                                                  Obligations
                                                                    ObligationsActor
                                                                    SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                                                    SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                                                    Summaryfalse
                                                                    Requirements

                                                                    Allows claim responses to be distinguished and referenced.

                                                                    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                    22. ClaimResponse.identifier:gatewayResponseId.id
                                                                    Definition

                                                                    Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                                                    ShortUnique id for inter-element referencing
                                                                    Control0..1
                                                                    Typestring
                                                                    Is Modifierfalse
                                                                    XML FormatIn the XML format, this property is represented as an attribute.
                                                                    Summaryfalse
                                                                    24. ClaimResponse.identifier:gatewayResponseId.extension
                                                                    Definition

                                                                    May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                                                                    ShortAdditional content defined by implementations
                                                                    Comments

                                                                    There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                    Control0..*
                                                                    TypeExtension
                                                                    Is Modifierfalse
                                                                    Summaryfalse
                                                                    Alternate Namesextensions, user content
                                                                    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                    ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                    SlicingThis element introduces a set of slices on ClaimResponse.identifier.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                                                    • value @ url
                                                                    • 26. ClaimResponse.identifier:gatewayResponseId.use
                                                                      Definition

                                                                      The purpose of this identifier.

                                                                      Shortusual | official | temp | secondary | old (If known)
                                                                      Comments

                                                                      Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.

                                                                      Control0..1
                                                                      BindingThe codes SHALL be taken from IdentifierUse
                                                                      (required to http://hl7.org/fhir/ValueSet/identifier-use|4.0.1)

                                                                      Identifies the purpose for this identifier, if known .

                                                                      Typecode
                                                                      Is Modifiertrue because This is labeled as "Is Modifier" because applications should not mistake a temporary id for a permanent one.
                                                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                      Summarytrue
                                                                      Requirements

                                                                      Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers.

                                                                      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                      28. ClaimResponse.identifier:gatewayResponseId.type
                                                                      Definition

                                                                      A coded type for the identifier that can be used to determine which identifier to use for a specific purpose.

                                                                      ShortDescription of identifier
                                                                      Comments

                                                                      This element deals only with general categories of identifiers. It SHOULD not be used for codes that correspond 1..1 with the Identifier.system. Some identifiers may fall into multiple categories due to common usage. Where the system is known, a type is unnecessary because the type is always part of the system definition. However systems often need to handle identifiers where the system is not known. There is not a 1:1 relationship between type and system, since many different systems have the same type.

                                                                      Control0..1
                                                                      BindingUnless not suitable, these codes SHALL be taken from Identifier Type Codes
                                                                      (extensible to http://hl7.org/fhir/ValueSet/identifier-type|4.0.1)

                                                                      A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

                                                                      TypeCodeableConcept
                                                                      Is Modifierfalse
                                                                      Summarytrue
                                                                      Requirements

                                                                      Allows users to make use of identifiers when the identifier system is not known.

                                                                      Pattern Value{
                                                                        "coding" : [{
                                                                          "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs",
                                                                          "code" : "BHYT_XML1_ID"
                                                                        }]
                                                                      }
                                                                      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                      30. ClaimResponse.identifier:gatewayResponseId.system
                                                                      Definition

                                                                      Establishes the namespace for the value - that is, a URL that describes a set values that are unique.

                                                                      ShortThe namespace for the identifier value
                                                                      Comments

                                                                      Identifier.system is always case sensitive.

                                                                      Control1..1
                                                                      Typeuri
                                                                      Is Modifierfalse
                                                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                      Summarytrue
                                                                      Requirements

                                                                      There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers.

                                                                      Fixed Valuehttp://fhir.hl7.org.vn/core/sid/bhyt-gateway-response-id
                                                                      ExampleGeneral: http://www.acme.com/identifiers/patient
                                                                      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                      32. ClaimResponse.identifier:gatewayResponseId.value
                                                                      Definition

                                                                      The portion of the identifier typically relevant to the user and which is unique within the context of the system.

                                                                      ShortGiá trị XML1_ID hoặc mã phản hồi tương đương
                                                                      Comments

                                                                      If the value is a full URI, then the system SHALL be urn:ietf:rfc:3986. The value's primary purpose is computational mapping. As a result, it may be normalized for comparison purposes (e.g. removing non-significant whitespace, dashes, etc.) A value formatted for human display can be conveyed using the Rendered Value extension. Identifier.value is to be treated as case sensitive unless knowledge of the Identifier.system allows the processer to be confident that non-case-sensitive processing is safe.

                                                                      Control1..1
                                                                      Typestring
                                                                      Is Modifierfalse
                                                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                      Must Supporttrue
                                                                      Summarytrue
                                                                      ExampleGeneral: 123456
                                                                      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                      34. ClaimResponse.identifier:gatewayResponseId.period
                                                                      Definition

                                                                      Time period during which identifier is/was valid for use.

                                                                      ShortTime period when id is/was valid for use
                                                                      Control0..1
                                                                      TypePeriod
                                                                      Is Modifierfalse
                                                                      Summarytrue
                                                                      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                      36. ClaimResponse.identifier:gatewayResponseId.assigner
                                                                      Definition

                                                                      Organization that issued/manages the identifier.

                                                                      ShortOrganization that issued id (may be just text)
                                                                      Comments

                                                                      The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.

                                                                      Control0..1
                                                                      TypeReference(Organization)
                                                                      Is Modifierfalse
                                                                      Summarytrue
                                                                      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                      38. ClaimResponse.status
                                                                      Definition

                                                                      The status of the resource instance.

                                                                      ShortTrạng thái kết quả: active | cancelled | draft | entered-in-error
                                                                      Comments

                                                                      This element is labeled as a modifier because the status contains codes that mark the resource as not currently valid.

                                                                      Control1..1
                                                                      BindingThe codes SHALL be taken from FinancialResourceStatusCodes
                                                                      (required to http://hl7.org/fhir/ValueSet/fm-status|4.0.1)

                                                                      A code specifying the state of the resource instance.

                                                                      Typecode
                                                                      Is Modifiertrue because This element is labeled as a modifier because it is a status element that contains status entered-in-error which means that the resource should not be treated as valid
                                                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                      Must Supporttrue
                                                                      Obligations
                                                                        ObligationsActor
                                                                        SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                                                        SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                                                        Summarytrue
                                                                        Requirements

                                                                        Need to track the status of the resource as 'draft' resources may undergo further edits while 'active' resources are immutable and may only have their status changed to 'cancelled'.

                                                                        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                        40. ClaimResponse.type
                                                                        Definition

                                                                        A finer grained suite of claim type codes which may convey additional information such as Inpatient vs Outpatient and/or a specialty service.

                                                                        ShortLoại: institutional (nội trú) | professional (ngoại trú)
                                                                        Comments

                                                                        This may contain the local bill type codes, for example the US UB-04 bill type code or the CMS bill type.

                                                                        Control1..1
                                                                        BindingUnless not suitable, these codes SHALL be taken from ClaimTypeCodes
                                                                        (extensible to http://hl7.org/fhir/ValueSet/claim-type|4.0.1)

                                                                        The type or discipline-style of the claim.

                                                                        TypeCodeableConcept
                                                                        Is Modifierfalse
                                                                        Must Supporttrue
                                                                        Obligations
                                                                          ObligationsActor
                                                                          SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                                                          SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                                                          Summarytrue
                                                                          Requirements

                                                                          Some jurisdictions need a finer grained claim type for routing and adjudication.

                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                          42. ClaimResponse.subType
                                                                          Definition

                                                                          A finer grained suite of claim type codes which may convey additional information such as Inpatient vs Outpatient and/or a specialty service.

                                                                          ShortMore granular claim type
                                                                          Comments

                                                                          This may contain the local bill type codes, for example the US UB-04 bill type code or the CMS bill type.

                                                                          Control0..1
                                                                          BindingFor example codes, see ExampleClaimSubTypeCodes
                                                                          (example to http://hl7.org/fhir/ValueSet/claim-subtype|4.0.1)

                                                                          A more granular claim typecode.

                                                                          TypeCodeableConcept
                                                                          Is Modifierfalse
                                                                          Summaryfalse
                                                                          Requirements

                                                                          Some jurisdictions need a finer grained claim type for routing and adjudication.

                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                          44. ClaimResponse.use
                                                                          Definition

                                                                          A code to indicate whether the nature of the request is: to request adjudication of products and services previously rendered; or requesting authorization and adjudication for provision in the future; or requesting the non-binding adjudication of the listed products and services which could be provided in the future.

                                                                          ShortMục đích: claim | preauthorization | predetermination
                                                                          Control1..1
                                                                          BindingThe codes SHALL be taken from Use
                                                                          (required to http://hl7.org/fhir/ValueSet/claim-use|4.0.1)

                                                                          Claim, preauthorization, predetermination.

                                                                          Typecode
                                                                          Is Modifierfalse
                                                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                          Must Supporttrue
                                                                          Obligations
                                                                            ObligationsActor
                                                                            SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                                                            SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                                                            Summarytrue
                                                                            Requirements

                                                                            This element is required to understand the nature of the request for adjudication.

                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                            46. ClaimResponse.patient
                                                                            Definition

                                                                            The party to whom the professional services and/or products have been supplied or are being considered and for whom actual for facast reimbursement is sought.

                                                                            ShortBệnh nhân
                                                                            Control1..1
                                                                            TypeReference(Bệnh nhân VN Core — VN Core Patient Profile)
                                                                            Is Modifierfalse
                                                                            Must Supporttrue
                                                                            Obligations
                                                                              ObligationsActor
                                                                              SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                                                              SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                                                              Summarytrue
                                                                              Requirements

                                                                              The patient must be supplied to the insurer so that confirmation of coverage and service hstory may be considered as part of the authorization and/or adjudiction.

                                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                              48. ClaimResponse.created
                                                                              Definition

                                                                              The date this resource was created.

                                                                              ShortNgày tạo kết quả
                                                                              Control1..1
                                                                              TypedateTime
                                                                              Is Modifierfalse
                                                                              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                              Must Supporttrue
                                                                              Obligations
                                                                                ObligationsActor
                                                                                SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                                                                SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                                                                Summarytrue
                                                                                Requirements

                                                                                Need to record a timestamp for use by both the recipient and the issuer.

                                                                                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                50. ClaimResponse.insurer
                                                                                Definition

                                                                                The party responsible for authorization, adjudication and reimbursement.

                                                                                ShortCơ quan BHXH giải quyết
                                                                                Control1..1
                                                                                TypeReference(Organization)
                                                                                Is Modifierfalse
                                                                                Must Supporttrue
                                                                                Obligations
                                                                                  ObligationsActor
                                                                                  SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                                                                  SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                                                                  Summarytrue
                                                                                  Requirements

                                                                                  To be a valid claim, preauthorization or predetermination there must be a party who is responsible for adjudicating the contents against a policy which provides benefits for the patient.

                                                                                  Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                  52. ClaimResponse.requestor
                                                                                  Definition

                                                                                  The provider which is responsible for the claim, predetermination or preauthorization.

                                                                                  ShortParty responsible for the claim
                                                                                  Comments

                                                                                  Typically this field would be 1..1 where this party is responsible for the claim but not necessarily professionally responsible for the provision of the individual products and services listed below.

                                                                                  Control0..1
                                                                                  TypeReference(Practitioner, PractitionerRole, Organization)
                                                                                  Is Modifierfalse
                                                                                  Summaryfalse
                                                                                  Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                  54. ClaimResponse.request
                                                                                  Definition

                                                                                  Original request resource reference.

                                                                                  ShortYêu cầu thanh toán gốc (VNCoreClaim)
                                                                                  Control0..1
                                                                                  TypeReference(Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile)
                                                                                  Is Modifierfalse
                                                                                  Must Supporttrue
                                                                                  Obligations
                                                                                    ObligationsActor
                                                                                    SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                                                                    SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                                                                    Summarytrue
                                                                                    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                    56. ClaimResponse.outcome
                                                                                    Definition

                                                                                    The outcome of the claim, predetermination, or preauthorization processing.

                                                                                    ShortKết quả: queued | complete | error | partial
                                                                                    Comments

                                                                                    The resource may be used to indicate that: the request has been held (queued) for processing; that it has been processed and errors found (error); that no errors were found and that some of the adjudication has been undertaken (partial) or that all of the adjudication has been undertaken (complete).

                                                                                    Control1..1
                                                                                    BindingThe codes SHALL be taken from ClaimProcessingCodes
                                                                                    (required to http://hl7.org/fhir/ValueSet/remittance-outcome|4.0.1)

                                                                                    The result of the claim processing.

                                                                                    Typecode
                                                                                    Is Modifierfalse
                                                                                    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                    Must Supporttrue
                                                                                    Obligations
                                                                                      ObligationsActor
                                                                                      SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                                                                      SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                                                                      Summarytrue
                                                                                      Requirements

                                                                                      To advise the requestor of an overall processing outcome.

                                                                                      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                      58. ClaimResponse.disposition
                                                                                      Definition

                                                                                      A human readable description of the status of the adjudication.

                                                                                      ShortDisposition Message
                                                                                      Control0..1
                                                                                      Typestring
                                                                                      Is Modifierfalse
                                                                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                      Summaryfalse
                                                                                      Requirements

                                                                                      Provided for user display.

                                                                                      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                      60. ClaimResponse.preAuthRef
                                                                                      Definition

                                                                                      Reference from the Insurer which is used in later communications which refers to this adjudication.

                                                                                      ShortPreauthorization reference
                                                                                      Comments

                                                                                      This value is only present on preauthorization adjudications.

                                                                                      Control0..1
                                                                                      Typestring
                                                                                      Is Modifierfalse
                                                                                      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                      Summaryfalse
                                                                                      Requirements

                                                                                      On subsequent claims, the insurer may require the provider to quote this value.

                                                                                      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                      62. ClaimResponse.preAuthPeriod
                                                                                      Definition

                                                                                      The time frame during which this authorization is effective.

                                                                                      ShortPreauthorization reference effective period
                                                                                      Control0..1
                                                                                      TypePeriod
                                                                                      Is Modifierfalse
                                                                                      Summaryfalse
                                                                                      Requirements

                                                                                      To convey to the provider when the authorized products and services must be supplied for the authorized adjudication to apply.

                                                                                      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                      64. ClaimResponse.payeeType
                                                                                      Definition

                                                                                      Type of Party to be reimbursed: subscriber, provider, other.

                                                                                      ShortParty to be paid any benefits payable
                                                                                      Control0..1
                                                                                      BindingFor example codes, see Claim Payee Type Codes
                                                                                      (example to http://hl7.org/fhir/ValueSet/payeetype|4.0.1)

                                                                                      A code for the party to be reimbursed.

                                                                                      TypeCodeableConcept
                                                                                      Is Modifierfalse
                                                                                      Summaryfalse
                                                                                      Requirements

                                                                                      Need to know who should receive payment with the most common situations being the Provider (assignment of benefits) or the Subscriber.

                                                                                      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                      66. ClaimResponse.item
                                                                                      Definition

                                                                                      A claim line. Either a simple (a product or service) or a 'group' of details which can also be a simple items or groups of sub-details.

                                                                                      ShortKết quả từng dòng chi phí
                                                                                      Control0..*
                                                                                      TypeBackboneElement
                                                                                      Is Modifierfalse
                                                                                      Must Supporttrue
                                                                                      Obligations
                                                                                        ObligationsActor
                                                                                        SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                                                                        SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                                                                        Summaryfalse
                                                                                        Requirements

                                                                                        The adjudication for items provided on the claim.

                                                                                        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                        68. ClaimResponse.item.id
                                                                                        Definition

                                                                                        Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                                                                        ShortUnique id for inter-element referencing
                                                                                        Control0..1
                                                                                        Typestring
                                                                                        Is Modifierfalse
                                                                                        XML FormatIn the XML format, this property is represented as an attribute.
                                                                                        Summaryfalse
                                                                                        70. ClaimResponse.item.extension
                                                                                        Definition

                                                                                        May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                                                                                        ShortAdditional content defined by implementations
                                                                                        Comments

                                                                                        There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                        Control0..*
                                                                                        TypeExtension
                                                                                        Is Modifierfalse
                                                                                        Summaryfalse
                                                                                        Alternate Namesextensions, user content
                                                                                        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                        ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                        72. ClaimResponse.item.modifierExtension
                                                                                        Definition

                                                                                        May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

                                                                                        Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                                                                                        ShortExtensions that cannot be ignored even if unrecognized
                                                                                        Comments

                                                                                        There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                        Control0..*
                                                                                        TypeExtension
                                                                                        Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                                                                                        Summarytrue
                                                                                        Requirements

                                                                                        Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                                                                                        Alternate Namesextensions, user content, modifiers
                                                                                        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                        ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                        74. ClaimResponse.item.itemSequence
                                                                                        Definition

                                                                                        A number to uniquely reference the claim item entries.

                                                                                        ShortClaim item instance identifier
                                                                                        Control1..1
                                                                                        TypepositiveInt
                                                                                        Is Modifierfalse
                                                                                        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                        Must Supporttrue
                                                                                        Summaryfalse
                                                                                        Requirements

                                                                                        Necessary to provide a mechanism to link the adjudication result to the submitted claim item.

                                                                                        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                        76. ClaimResponse.item.noteNumber
                                                                                        Definition

                                                                                        The numbers associated with notes below which apply to the adjudication of this item.

                                                                                        ShortApplicable note numbers
                                                                                        Control0..*
                                                                                        TypepositiveInt
                                                                                        Is Modifierfalse
                                                                                        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                        Summaryfalse
                                                                                        Requirements

                                                                                        Provides a condensed manner for associating human readable descriptive explanations for adjudications on the line item.

                                                                                        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                        78. ClaimResponse.item.adjudication
                                                                                        Definition

                                                                                        If this item is a group then the values here are a summary of the adjudication of the detail items. If this item is a simple product or service then this is the result of the adjudication of this item.

                                                                                        ShortPhân bổ chi phí: đề nghị, đủ ĐK, cùng chi trả, BHYT thanh toán
                                                                                        Control1..*
                                                                                        TypeBackboneElement
                                                                                        Is Modifierfalse
                                                                                        Must Supporttrue
                                                                                        Summaryfalse
                                                                                        Requirements

                                                                                        The adjudication results conveys the insurer's assessment of the item provided in the claim under the terms of the patient's insurance coverage.

                                                                                        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                        80. ClaimResponse.item.adjudication.id
                                                                                        Definition

                                                                                        Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                                                                        ShortUnique id for inter-element referencing
                                                                                        Control0..1
                                                                                        Typestring
                                                                                        Is Modifierfalse
                                                                                        XML FormatIn the XML format, this property is represented as an attribute.
                                                                                        Summaryfalse
                                                                                        82. ClaimResponse.item.adjudication.extension
                                                                                        Definition

                                                                                        An Extension

                                                                                        ShortExtension
                                                                                        Control0..*
                                                                                        TypeExtension
                                                                                        Is Modifierfalse
                                                                                        Summaryfalse
                                                                                        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                        ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                        SlicingThis element introduces a set of slices on ClaimResponse.item.adjudication.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
                                                                                        • value @ url
                                                                                        • 84. ClaimResponse.item.adjudication.extension:legalEvidence
                                                                                          Slice NamelegalEvidence
                                                                                          Definition

                                                                                          Một căn cứ pháp lý cụ thể, có điều/khoản và tài liệu chứng minh, cho một kết quả giám định — đặc biệt cho khoản tiền mang category denied.

                                                                                          Vì sao bắt buộc với từ chối. NĐ 188/2025/NĐ-CP Điều 51 khoản 2 quy định việc từ chối thanh toán "phải nêu rõ căn cứ, lý do từ chối, số tiền bị từ chối thanh toán trong biên bản giám định". Ba yếu tố đó là điều kiện của chính hành vi từ chối, không phải siêu dữ liệu tuỳ chọn. Một bản ghi chỉ nói "bị từ chối" mà không dẫn được căn cứ thì không đủ để cơ sở khám bệnh, chữa bệnh thực hiện quyền kiến nghị tại Điều 51 khoản 3.

                                                                                          Vì sao áp cả cho khoản bị từ chối tự động. Cũng tại khoản 2, nghĩa vụ nêu căn cứ bao gồm "cả các chi phí khám bệnh, chữa bệnh bảo hiểm y tế đề nghị cơ quan bảo hiểm xã hội thanh toán trên môi trường điện tử được trả tự động khi cơ sở khám bệnh, chữa bệnh gửi dữ liệu". Từ chối do hệ thống tự sinh không được miễn nghĩa vụ này.

                                                                                          Ranh giới. Extension mang căn cứ mà bên giám định VIỆN DẪN; nó không chứng minh việc viện dẫn là đúng. Đánh giá tính đúng đắn thuộc quy trình kiến nghị và cơ quan có thẩm quyền.

                                                                                          ShortCăn cứ pháp lý của kết quả giám định (bắt buộc khi từ chối/thu hồi)
                                                                                          Control0..*
                                                                                          This element is affected by the following invariants: ele-1
                                                                                          TypeExtension(Bằng chứng pháp lý của kết quả giám định — Adjudication Legal Evidence) (Complex Extension)
                                                                                          Is Modifierfalse
                                                                                          Must Supporttrue
                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                          86. ClaimResponse.item.adjudication.modifierExtension
                                                                                          Definition

                                                                                          May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

                                                                                          Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                                                                                          ShortExtensions that cannot be ignored even if unrecognized
                                                                                          Comments

                                                                                          There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                          Control0..*
                                                                                          TypeExtension
                                                                                          Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                                                                                          Summarytrue
                                                                                          Requirements

                                                                                          Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                                                                                          Alternate Namesextensions, user content, modifiers
                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                          88. ClaimResponse.item.adjudication.category
                                                                                          Definition

                                                                                          Category giám định từng dòng. Ưu tiên HL7 adjudication (submitted, eligible, copay, benefit) cho line-level adjudication; các subtotal cục bộ của VN Core không dùng ở line-level.

                                                                                          ShortLoại: submitted | eligible | copay | benefit | denied | recovered
                                                                                          Comments

                                                                                          For example codes indicating: Co-Pay, deductible, eligible, benefit, tax, etc.

                                                                                          Control1..1
                                                                                          BindingUnless not suitable, these codes SHALL be taken from Loại adjudication BHYT — BHYT Adjudication Category ValueSet
                                                                                          (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-adjudication-category-vs)
                                                                                          TypeCodeableConcept
                                                                                          Is Modifierfalse
                                                                                          Must Supporttrue
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Needed to enable understanding of the context of the other information in the adjudication.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          90. ClaimResponse.item.adjudication.reason
                                                                                          Definition

                                                                                          Lý do nghiệp vụ dẫn tới kết quả này. Bắt buộc với category denied/recovered theo invariant vn-claim-response-denied-complete. Danh mục là taxonomy baseline cục bộ, KHÔNG phải catalog mã từ chối chính thức: NĐ 188/2025/NĐ-CP Điều 51 không ban hành danh mục mã lý do, chỉ buộc nêu rõ lý do.

                                                                                          ShortLý do của kết quả giám định — bắt buộc khi category là denied hoặc recovered
                                                                                          Comments

                                                                                          For example may indicate that the funds for this benefit type have been exhausted.

                                                                                          Control0..1
                                                                                          BindingUnless not suitable, these codes SHALL be taken from Issue tầng NGHIỆP VỤ — VN BHYT Adjudication Issue ValueSet
                                                                                          (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-adjudication-issue-vs)
                                                                                          TypeCodeableConcept
                                                                                          Is Modifierfalse
                                                                                          Must Supporttrue
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          To support understanding of variance from adjudication expectations.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          92. ClaimResponse.item.adjudication.amount
                                                                                          Definition

                                                                                          Số tiền của dòng giám định. Đồng Việt Nam KHÔNG có đơn vị nhỏ hơn đồng đang lưu hành, nên Money.value ghi thẳng số đồng: 200000 nghĩa là hai trăm nghìn đồng. KHÔNG nhân/chia 100 theo thói quen của các hệ tiền tệ có xu, và KHÔNG ghi phần thập phân.

                                                                                          ShortSố tiền (VND, đơn vị đồng — xem quy ước đơn vị tiền bên dưới)
                                                                                          Comments

                                                                                          For example: amount submitted, eligible amount, co-payment, and benefit payable.

                                                                                          Control0..1
                                                                                          TypeMoney
                                                                                          Is Modifierfalse
                                                                                          Must Supporttrue
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Most adjuciation categories convey a monetary amount.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          94. ClaimResponse.item.adjudication.value
                                                                                          Definition

                                                                                          A non-monetary value associated with the category. Mutually exclusive to the amount element above.

                                                                                          ShortNon-monetary value
                                                                                          Comments

                                                                                          For example: eligible percentage or co-payment percentage.

                                                                                          Control0..1
                                                                                          Typedecimal
                                                                                          Is Modifierfalse
                                                                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Some adjudication categories convey a percentage or a fixed value.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          96. ClaimResponse.item.detail
                                                                                          Definition

                                                                                          A claim detail. Either a simple (a product or service) or a 'group' of sub-details which are simple items.

                                                                                          ShortAdjudication for claim details
                                                                                          Control0..*
                                                                                          TypeBackboneElement
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          The adjudication for details provided on the claim.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          98. ClaimResponse.item.detail.id
                                                                                          Definition

                                                                                          Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                                                                          ShortUnique id for inter-element referencing
                                                                                          Control0..1
                                                                                          Typestring
                                                                                          Is Modifierfalse
                                                                                          XML FormatIn the XML format, this property is represented as an attribute.
                                                                                          Summaryfalse
                                                                                          100. ClaimResponse.item.detail.extension
                                                                                          Definition

                                                                                          May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                                                                                          ShortAdditional content defined by implementations
                                                                                          Comments

                                                                                          There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                          Control0..*
                                                                                          TypeExtension
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Alternate Namesextensions, user content
                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                          102. ClaimResponse.item.detail.modifierExtension
                                                                                          Definition

                                                                                          May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

                                                                                          Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                                                                                          ShortExtensions that cannot be ignored even if unrecognized
                                                                                          Comments

                                                                                          There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                          Control0..*
                                                                                          TypeExtension
                                                                                          Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                                                                                          Summarytrue
                                                                                          Requirements

                                                                                          Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                                                                                          Alternate Namesextensions, user content, modifiers
                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                          104. ClaimResponse.item.detail.detailSequence
                                                                                          Definition

                                                                                          A number to uniquely reference the claim detail entry.

                                                                                          ShortClaim detail instance identifier
                                                                                          Control1..1
                                                                                          TypepositiveInt
                                                                                          Is Modifierfalse
                                                                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Necessary to provide a mechanism to link the adjudication result to the submitted claim detail.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          106. ClaimResponse.item.detail.noteNumber
                                                                                          Definition

                                                                                          The numbers associated with notes below which apply to the adjudication of this item.

                                                                                          ShortApplicable note numbers
                                                                                          Control0..*
                                                                                          TypepositiveInt
                                                                                          Is Modifierfalse
                                                                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Provides a condensed manner for associating human readable descriptive explanations for adjudications on the line item.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          108. ClaimResponse.item.detail.adjudication
                                                                                          Definition

                                                                                          The adjudication results.

                                                                                          ShortDetail level adjudication details
                                                                                          Control1..*
                                                                                          TypeSeettp://hl7.org/fhir/StructureDefinition/ClaimResponse#ClaimResponse.item.adjudication
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          110. ClaimResponse.item.detail.subDetail
                                                                                          Definition

                                                                                          A sub-detail adjudication of a simple product or service.

                                                                                          ShortAdjudication for claim sub-details
                                                                                          Control0..*
                                                                                          TypeBackboneElement
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          The adjudication for sub-details provided on the claim.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          112. ClaimResponse.item.detail.subDetail.id
                                                                                          Definition

                                                                                          Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                                                                          ShortUnique id for inter-element referencing
                                                                                          Control0..1
                                                                                          Typestring
                                                                                          Is Modifierfalse
                                                                                          XML FormatIn the XML format, this property is represented as an attribute.
                                                                                          Summaryfalse
                                                                                          114. ClaimResponse.item.detail.subDetail.extension
                                                                                          Definition

                                                                                          May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                                                                                          ShortAdditional content defined by implementations
                                                                                          Comments

                                                                                          There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                          Control0..*
                                                                                          TypeExtension
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Alternate Namesextensions, user content
                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                          116. ClaimResponse.item.detail.subDetail.modifierExtension
                                                                                          Definition

                                                                                          May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

                                                                                          Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                                                                                          ShortExtensions that cannot be ignored even if unrecognized
                                                                                          Comments

                                                                                          There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                          Control0..*
                                                                                          TypeExtension
                                                                                          Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                                                                                          Summarytrue
                                                                                          Requirements

                                                                                          Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                                                                                          Alternate Namesextensions, user content, modifiers
                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                          118. ClaimResponse.item.detail.subDetail.subDetailSequence
                                                                                          Definition

                                                                                          A number to uniquely reference the claim sub-detail entry.

                                                                                          ShortClaim sub-detail instance identifier
                                                                                          Control1..1
                                                                                          TypepositiveInt
                                                                                          Is Modifierfalse
                                                                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Necessary to provide a mechanism to link the adjudication result to the submitted claim sub-detail.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          120. ClaimResponse.item.detail.subDetail.noteNumber
                                                                                          Definition

                                                                                          The numbers associated with notes below which apply to the adjudication of this item.

                                                                                          ShortApplicable note numbers
                                                                                          Control0..*
                                                                                          TypepositiveInt
                                                                                          Is Modifierfalse
                                                                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Provides a condensed manner for associating human readable descriptive explanations for adjudications on the line item.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          122. ClaimResponse.item.detail.subDetail.adjudication
                                                                                          Definition

                                                                                          The adjudication results.

                                                                                          ShortSubdetail level adjudication details
                                                                                          Control0..*
                                                                                          TypeSeettp://hl7.org/fhir/StructureDefinition/ClaimResponse#ClaimResponse.item.adjudication
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          124. ClaimResponse.addItem
                                                                                          Definition

                                                                                          The first-tier service adjudications for payor added product or service lines.

                                                                                          ShortInsurer added line items
                                                                                          Control0..*
                                                                                          TypeBackboneElement
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Insurers may redefine the provided product or service or may package and/or decompose groups of products and services. The addItems allows the insurer to provide their line item list with linkage to the submitted items/details/sub-details. In a preauthorization the insurer may use the addItem structure to provide additional information on authorized products and services.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          126. ClaimResponse.addItem.id
                                                                                          Definition

                                                                                          Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                                                                          ShortUnique id for inter-element referencing
                                                                                          Control0..1
                                                                                          Typestring
                                                                                          Is Modifierfalse
                                                                                          XML FormatIn the XML format, this property is represented as an attribute.
                                                                                          Summaryfalse
                                                                                          128. ClaimResponse.addItem.extension
                                                                                          Definition

                                                                                          May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                                                                                          ShortAdditional content defined by implementations
                                                                                          Comments

                                                                                          There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                          Control0..*
                                                                                          TypeExtension
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Alternate Namesextensions, user content
                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                          130. ClaimResponse.addItem.modifierExtension
                                                                                          Definition

                                                                                          May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

                                                                                          Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                                                                                          ShortExtensions that cannot be ignored even if unrecognized
                                                                                          Comments

                                                                                          There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                          Control0..*
                                                                                          TypeExtension
                                                                                          Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                                                                                          Summarytrue
                                                                                          Requirements

                                                                                          Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                                                                                          Alternate Namesextensions, user content, modifiers
                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                          132. ClaimResponse.addItem.itemSequence
                                                                                          Definition

                                                                                          Claim items which this service line is intended to replace.

                                                                                          ShortItem sequence number
                                                                                          Control0..*
                                                                                          TypepositiveInt
                                                                                          Is Modifierfalse
                                                                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Provides references to the claim items.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          134. ClaimResponse.addItem.detailSequence
                                                                                          Definition

                                                                                          The sequence number of the details within the claim item which this line is intended to replace.

                                                                                          ShortDetail sequence number
                                                                                          Control0..*
                                                                                          TypepositiveInt
                                                                                          Is Modifierfalse
                                                                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Provides references to the claim details within the claim item.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          136. ClaimResponse.addItem.subdetailSequence
                                                                                          Definition

                                                                                          The sequence number of the sub-details within the details within the claim item which this line is intended to replace.

                                                                                          ShortSubdetail sequence number
                                                                                          Control0..*
                                                                                          TypepositiveInt
                                                                                          Is Modifierfalse
                                                                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Provides references to the claim sub-details within the claim detail.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          138. ClaimResponse.addItem.provider
                                                                                          Definition

                                                                                          The providers who are authorized for the services rendered to the patient.

                                                                                          ShortAuthorized providers
                                                                                          Control0..*
                                                                                          TypeReference(Practitioner, PractitionerRole, Organization)
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Insurer may provide authorization specifically to a restricted set of providers rather than an open authorization.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          140. ClaimResponse.addItem.productOrService
                                                                                          Definition

                                                                                          When the value is a group code then this item collects a set of related claim details, otherwise this contains the product, service, drug or other billing code for the item.

                                                                                          ShortBilling, service, product, or drug code
                                                                                          Comments

                                                                                          If this is an actual service or product line, i.e. not a Group, then use code to indicate the Professional Service or Product supplied (e.g. CTP, HCPCS, USCLS, ICD10, NCPDP, DIN, RxNorm, ACHI, CCI). If a grouping item then use a group code to indicate the type of thing being grouped e.g. 'glasses' or 'compound'.

                                                                                          Control1..1
                                                                                          BindingFor example codes, see USCLSCodes
                                                                                          (example to http://hl7.org/fhir/ValueSet/service-uscls|4.0.1)

                                                                                          Allowable service and product codes.

                                                                                          TypeCodeableConcept
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Necessary to state what was provided or done.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          142. ClaimResponse.addItem.modifier
                                                                                          Definition

                                                                                          Item typification or modifiers codes to convey additional context for the product or service.

                                                                                          ShortService/Product billing modifiers
                                                                                          Comments

                                                                                          For example in Oral whether the treatment is cosmetic or associated with TMJ, or for Medical whether the treatment was outside the clinic or outside of office hours.

                                                                                          Control0..*
                                                                                          BindingFor example codes, see ModifierTypeCodes
                                                                                          (example to http://hl7.org/fhir/ValueSet/claim-modifiers|4.0.1)

                                                                                          Item type or modifiers codes, eg for Oral whether the treatment is cosmetic or associated with TMJ, or an appliance was lost or stolen.

                                                                                          TypeCodeableConcept
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          To support inclusion of the item for adjudication or to charge an elevated fee.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          144. ClaimResponse.addItem.programCode
                                                                                          Definition

                                                                                          Identifies the program under which this may be recovered.

                                                                                          ShortProgram the product or service is provided under
                                                                                          Comments

                                                                                          For example: Neonatal program, child dental program or drug users recovery program.

                                                                                          Control0..*
                                                                                          BindingFor example codes, see ExampleProgramReasonCodes
                                                                                          (example to http://hl7.org/fhir/ValueSet/ex-program-code|4.0.1)

                                                                                          Program specific reason codes.

                                                                                          TypeCodeableConcept
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Commonly used in in the identification of publicly provided program focused on population segments or disease classifications.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          146. ClaimResponse.addItem.serviced[x]
                                                                                          Definition

                                                                                          The date or dates when the service or product was supplied, performed or completed.

                                                                                          ShortDate or dates of service or product delivery
                                                                                          Control0..1
                                                                                          TypeChoice of: date, Period
                                                                                          [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
                                                                                          Is Modifierfalse
                                                                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Needed to determine whether the service or product was provided during the term of the insurance coverage.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          148. ClaimResponse.addItem.location[x]
                                                                                          Definition

                                                                                          Where the product or service was provided.

                                                                                          ShortPlace of service or where product was supplied
                                                                                          Control0..1
                                                                                          BindingFor example codes, see ExampleServicePlaceCodes
                                                                                          (example to http://hl7.org/fhir/ValueSet/service-place|4.0.1)

                                                                                          Place of service: pharmacy, school, prison, etc.

                                                                                          TypeChoice of: CodeableConcept, Address, Reference(Location)
                                                                                          [x] NoteSeeChoice of Data Typesfor further information about how to use [x]
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          The location can alter whether the item was acceptable for insurance purposes or impact the determination of the benefit amount.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          150. ClaimResponse.addItem.quantity
                                                                                          Definition

                                                                                          The number of repetitions of a service or product.

                                                                                          ShortCount of products or services
                                                                                          Control0..1
                                                                                          TypeQuantity(SimpleQuantity)
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Required when the product or service code does not convey the quantity provided.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          152. ClaimResponse.addItem.unitPrice
                                                                                          Definition

                                                                                          If the item is not a group then this is the fee for the product or service, otherwise this is the total of the fees for the details of the group.

                                                                                          ShortFee, charge or cost per item
                                                                                          Control0..1
                                                                                          TypeMoney
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          The amount charged to the patient by the provider for a single unit.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          154. ClaimResponse.addItem.factor
                                                                                          Definition

                                                                                          A real number that represents a multiplier used in determining the overall value of services delivered and/or goods received. The concept of a Factor allows for a discount or surcharge multiplier to be applied to a monetary amount.

                                                                                          ShortPrice scaling factor
                                                                                          Comments

                                                                                          To show a 10% senior's discount, the value entered is: 0.90 (1.00 - 0.10).

                                                                                          Control0..1
                                                                                          Typedecimal
                                                                                          Is Modifierfalse
                                                                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          When discounts are provided to a patient (example: Senior's discount) then this must be documented for adjudication.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          156. ClaimResponse.addItem.net
                                                                                          Definition

                                                                                          The quantity times the unit price for an additional service or product or charge.

                                                                                          ShortTotal item cost
                                                                                          Comments

                                                                                          For example, the formula: quantity * unitPrice * factor = net. Quantity and factor are assumed to be 1 if not supplied.

                                                                                          Control0..1
                                                                                          TypeMoney
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Provides the total amount claimed for the group (if a grouper) or the line item.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          158. ClaimResponse.addItem.bodySite
                                                                                          Definition

                                                                                          Physical service site on the patient (limb, tooth, etc.).

                                                                                          ShortAnatomical location
                                                                                          Comments

                                                                                          For example: Providing a tooth code allows an insurer to identify a provider performing a filling on a tooth that was previously removed.

                                                                                          Control0..1
                                                                                          BindingFor example codes, see OralSiteCodes
                                                                                          (example to http://hl7.org/fhir/ValueSet/tooth|4.0.1)

                                                                                          The code for the teeth, quadrant, sextant and arch.

                                                                                          TypeCodeableConcept
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Allows insurer to validate specific procedures.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          160. ClaimResponse.addItem.subSite
                                                                                          Definition

                                                                                          A region or surface of the bodySite, e.g. limb region or tooth surface(s).

                                                                                          ShortAnatomical sub-location
                                                                                          Control0..*
                                                                                          BindingFor example codes, see SurfaceCodes
                                                                                          (example to http://hl7.org/fhir/ValueSet/surface|4.0.1)

                                                                                          The code for the tooth surface and surface combinations.

                                                                                          TypeCodeableConcept
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Allows insurer to validate specific procedures.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          162. ClaimResponse.addItem.noteNumber
                                                                                          Definition

                                                                                          The numbers associated with notes below which apply to the adjudication of this item.

                                                                                          ShortApplicable note numbers
                                                                                          Control0..*
                                                                                          TypepositiveInt
                                                                                          Is Modifierfalse
                                                                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Provides a condensed manner for associating human readable descriptive explanations for adjudications on the line item.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          164. ClaimResponse.addItem.adjudication
                                                                                          Definition

                                                                                          The adjudication results.

                                                                                          ShortAdded items adjudication
                                                                                          Control1..*
                                                                                          TypeSeettp://hl7.org/fhir/StructureDefinition/ClaimResponse#ClaimResponse.item.adjudication
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          166. ClaimResponse.addItem.detail
                                                                                          Definition

                                                                                          The second-tier service adjudications for payor added services.

                                                                                          ShortInsurer added line details
                                                                                          Control0..*
                                                                                          TypeBackboneElement
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          168. ClaimResponse.addItem.detail.id
                                                                                          Definition

                                                                                          Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                                                                          ShortUnique id for inter-element referencing
                                                                                          Control0..1
                                                                                          Typestring
                                                                                          Is Modifierfalse
                                                                                          XML FormatIn the XML format, this property is represented as an attribute.
                                                                                          Summaryfalse
                                                                                          170. ClaimResponse.addItem.detail.extension
                                                                                          Definition

                                                                                          May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                                                                                          ShortAdditional content defined by implementations
                                                                                          Comments

                                                                                          There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                          Control0..*
                                                                                          TypeExtension
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Alternate Namesextensions, user content
                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                          172. ClaimResponse.addItem.detail.modifierExtension
                                                                                          Definition

                                                                                          May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

                                                                                          Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                                                                                          ShortExtensions that cannot be ignored even if unrecognized
                                                                                          Comments

                                                                                          There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                          Control0..*
                                                                                          TypeExtension
                                                                                          Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                                                                                          Summarytrue
                                                                                          Requirements

                                                                                          Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                                                                                          Alternate Namesextensions, user content, modifiers
                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                          174. ClaimResponse.addItem.detail.productOrService
                                                                                          Definition

                                                                                          When the value is a group code then this item collects a set of related claim details, otherwise this contains the product, service, drug or other billing code for the item.

                                                                                          ShortBilling, service, product, or drug code
                                                                                          Comments

                                                                                          If this is an actual service or product line, i.e. not a Group, then use code to indicate the Professional Service or Product supplied (e.g. CTP, HCPCS, USCLS, ICD10, NCPDP, DIN, RxNorm, ACHI, CCI). If a grouping item then use a group code to indicate the type of thing being grouped e.g. 'glasses' or 'compound'.

                                                                                          Control1..1
                                                                                          BindingFor example codes, see USCLSCodes
                                                                                          (example to http://hl7.org/fhir/ValueSet/service-uscls|4.0.1)

                                                                                          Allowable service and product codes.

                                                                                          TypeCodeableConcept
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Necessary to state what was provided or done.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          176. ClaimResponse.addItem.detail.modifier
                                                                                          Definition

                                                                                          Item typification or modifiers codes to convey additional context for the product or service.

                                                                                          ShortService/Product billing modifiers
                                                                                          Comments

                                                                                          For example in Oral whether the treatment is cosmetic or associated with TMJ, or for Medical whether the treatment was outside the clinic or outside of office hours.

                                                                                          Control0..*
                                                                                          BindingFor example codes, see ModifierTypeCodes
                                                                                          (example to http://hl7.org/fhir/ValueSet/claim-modifiers|4.0.1)

                                                                                          Item type or modifiers codes, eg for Oral whether the treatment is cosmetic or associated with TMJ, or an appliance was lost or stolen.

                                                                                          TypeCodeableConcept
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          To support inclusion of the item for adjudication or to charge an elevated fee.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          178. ClaimResponse.addItem.detail.quantity
                                                                                          Definition

                                                                                          The number of repetitions of a service or product.

                                                                                          ShortCount of products or services
                                                                                          Control0..1
                                                                                          TypeQuantity(SimpleQuantity)
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Required when the product or service code does not convey the quantity provided.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          180. ClaimResponse.addItem.detail.unitPrice
                                                                                          Definition

                                                                                          If the item is not a group then this is the fee for the product or service, otherwise this is the total of the fees for the details of the group.

                                                                                          ShortFee, charge or cost per item
                                                                                          Control0..1
                                                                                          TypeMoney
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          The amount charged to the patient by the provider for a single unit.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          182. ClaimResponse.addItem.detail.factor
                                                                                          Definition

                                                                                          A real number that represents a multiplier used in determining the overall value of services delivered and/or goods received. The concept of a Factor allows for a discount or surcharge multiplier to be applied to a monetary amount.

                                                                                          ShortPrice scaling factor
                                                                                          Comments

                                                                                          To show a 10% senior's discount, the value entered is: 0.90 (1.00 - 0.10).

                                                                                          Control0..1
                                                                                          Typedecimal
                                                                                          Is Modifierfalse
                                                                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          When discounts are provided to a patient (example: Senior's discount) then this must be documented for adjudication.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          184. ClaimResponse.addItem.detail.net
                                                                                          Definition

                                                                                          The quantity times the unit price for an additional service or product or charge.

                                                                                          ShortTotal item cost
                                                                                          Comments

                                                                                          For example, the formula: quantity * unitPrice * factor = net. Quantity and factor are assumed to be 1 if not supplied.

                                                                                          Control0..1
                                                                                          TypeMoney
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Provides the total amount claimed for the group (if a grouper) or the line item.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          186. ClaimResponse.addItem.detail.noteNumber
                                                                                          Definition

                                                                                          The numbers associated with notes below which apply to the adjudication of this item.

                                                                                          ShortApplicable note numbers
                                                                                          Control0..*
                                                                                          TypepositiveInt
                                                                                          Is Modifierfalse
                                                                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Provides a condensed manner for associating human readable descriptive explanations for adjudications on the line item.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          188. ClaimResponse.addItem.detail.adjudication
                                                                                          Definition

                                                                                          The adjudication results.

                                                                                          ShortAdded items detail adjudication
                                                                                          Control1..*
                                                                                          TypeSeettp://hl7.org/fhir/StructureDefinition/ClaimResponse#ClaimResponse.item.adjudication
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          190. ClaimResponse.addItem.detail.subDetail
                                                                                          Definition

                                                                                          The third-tier service adjudications for payor added services.

                                                                                          ShortInsurer added line items
                                                                                          Control0..*
                                                                                          TypeBackboneElement
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          192. ClaimResponse.addItem.detail.subDetail.id
                                                                                          Definition

                                                                                          Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                                                                          ShortUnique id for inter-element referencing
                                                                                          Control0..1
                                                                                          Typestring
                                                                                          Is Modifierfalse
                                                                                          XML FormatIn the XML format, this property is represented as an attribute.
                                                                                          Summaryfalse
                                                                                          194. ClaimResponse.addItem.detail.subDetail.extension
                                                                                          Definition

                                                                                          May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                                                                                          ShortAdditional content defined by implementations
                                                                                          Comments

                                                                                          There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                          Control0..*
                                                                                          TypeExtension
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Alternate Namesextensions, user content
                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                          196. ClaimResponse.addItem.detail.subDetail.modifierExtension
                                                                                          Definition

                                                                                          May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

                                                                                          Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                                                                                          ShortExtensions that cannot be ignored even if unrecognized
                                                                                          Comments

                                                                                          There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                          Control0..*
                                                                                          TypeExtension
                                                                                          Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                                                                                          Summarytrue
                                                                                          Requirements

                                                                                          Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                                                                                          Alternate Namesextensions, user content, modifiers
                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                          198. ClaimResponse.addItem.detail.subDetail.productOrService
                                                                                          Definition

                                                                                          When the value is a group code then this item collects a set of related claim details, otherwise this contains the product, service, drug or other billing code for the item.

                                                                                          ShortBilling, service, product, or drug code
                                                                                          Comments

                                                                                          If this is an actual service or product line, i.e. not a Group, then use code to indicate the Professional Service or Product supplied (e.g. CTP, HCPCS, USCLS, ICD10, NCPDP, DIN, RxNorm, ACHI, CCI). If a grouping item then use a group code to indicate the type of thing being grouped e.g. 'glasses' or 'compound'.

                                                                                          Control1..1
                                                                                          BindingFor example codes, see USCLSCodes
                                                                                          (example to http://hl7.org/fhir/ValueSet/service-uscls|4.0.1)

                                                                                          Allowable service and product codes.

                                                                                          TypeCodeableConcept
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Necessary to state what was provided or done.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          200. ClaimResponse.addItem.detail.subDetail.modifier
                                                                                          Definition

                                                                                          Item typification or modifiers codes to convey additional context for the product or service.

                                                                                          ShortService/Product billing modifiers
                                                                                          Comments

                                                                                          For example in Oral whether the treatment is cosmetic or associated with TMJ, or for Medical whether the treatment was outside the clinic or outside of office hours.

                                                                                          Control0..*
                                                                                          BindingFor example codes, see ModifierTypeCodes
                                                                                          (example to http://hl7.org/fhir/ValueSet/claim-modifiers|4.0.1)

                                                                                          Item type or modifiers codes, eg for Oral whether the treatment is cosmetic or associated with TMJ, or an appliance was lost or stolen.

                                                                                          TypeCodeableConcept
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          To support inclusion of the item for adjudication or to charge an elevated fee.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          202. ClaimResponse.addItem.detail.subDetail.quantity
                                                                                          Definition

                                                                                          The number of repetitions of a service or product.

                                                                                          ShortCount of products or services
                                                                                          Control0..1
                                                                                          TypeQuantity(SimpleQuantity)
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Required when the product or service code does not convey the quantity provided.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          204. ClaimResponse.addItem.detail.subDetail.unitPrice
                                                                                          Definition

                                                                                          If the item is not a group then this is the fee for the product or service, otherwise this is the total of the fees for the details of the group.

                                                                                          ShortFee, charge or cost per item
                                                                                          Control0..1
                                                                                          TypeMoney
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          The amount charged to the patient by the provider for a single unit.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          206. ClaimResponse.addItem.detail.subDetail.factor
                                                                                          Definition

                                                                                          A real number that represents a multiplier used in determining the overall value of services delivered and/or goods received. The concept of a Factor allows for a discount or surcharge multiplier to be applied to a monetary amount.

                                                                                          ShortPrice scaling factor
                                                                                          Comments

                                                                                          To show a 10% senior's discount, the value entered is: 0.90 (1.00 - 0.10).

                                                                                          Control0..1
                                                                                          Typedecimal
                                                                                          Is Modifierfalse
                                                                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          When discounts are provided to a patient (example: Senior's discount) then this must be documented for adjudication.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          208. ClaimResponse.addItem.detail.subDetail.net
                                                                                          Definition

                                                                                          The quantity times the unit price for an additional service or product or charge.

                                                                                          ShortTotal item cost
                                                                                          Comments

                                                                                          For example, the formula: quantity * unitPrice * factor = net. Quantity and factor are assumed to be 1 if not supplied.

                                                                                          Control0..1
                                                                                          TypeMoney
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Provides the total amount claimed for the group (if a grouper) or the line item.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          210. ClaimResponse.addItem.detail.subDetail.noteNumber
                                                                                          Definition

                                                                                          The numbers associated with notes below which apply to the adjudication of this item.

                                                                                          ShortApplicable note numbers
                                                                                          Control0..*
                                                                                          TypepositiveInt
                                                                                          Is Modifierfalse
                                                                                          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Provides a condensed manner for associating human readable descriptive explanations for adjudications on the line item.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          212. ClaimResponse.addItem.detail.subDetail.adjudication
                                                                                          Definition

                                                                                          The adjudication results.

                                                                                          ShortAdded items detail adjudication
                                                                                          Control1..*
                                                                                          TypeSeettp://hl7.org/fhir/StructureDefinition/ClaimResponse#ClaimResponse.item.adjudication
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          214. ClaimResponse.adjudication
                                                                                          Definition

                                                                                          The adjudication results which are presented at the header level rather than at the line-item or add-item levels.

                                                                                          ShortHeader-level adjudication
                                                                                          Control0..*
                                                                                          TypeSeettp://hl7.org/fhir/StructureDefinition/ClaimResponse#ClaimResponse.item.adjudication
                                                                                          Is Modifierfalse
                                                                                          Summaryfalse
                                                                                          Requirements

                                                                                          Some insurers will receive line-items but provide the adjudication only at a summary or header-level.

                                                                                          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                          216. ClaimResponse.total
                                                                                          Definition

                                                                                          Categorized monetary totals for the adjudication.

                                                                                          ShortTổng adjudication
                                                                                          Comments

                                                                                          Totals for amounts submitted, co-pays, benefits payable etc.

                                                                                          Control0..*
                                                                                          TypeBackboneElement
                                                                                          Is Modifierfalse
                                                                                          Must Supporttrue
                                                                                          Obligations
                                                                                            ObligationsActor
                                                                                            SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                                                                            SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                                                                            Summarytrue
                                                                                            Requirements

                                                                                            To provide the requestor with financial totals by category for the adjudication.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            218. ClaimResponse.total.id
                                                                                            Definition

                                                                                            Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                                                                            ShortUnique id for inter-element referencing
                                                                                            Control0..1
                                                                                            Typestring
                                                                                            Is Modifierfalse
                                                                                            XML FormatIn the XML format, this property is represented as an attribute.
                                                                                            Summaryfalse
                                                                                            220. ClaimResponse.total.extension
                                                                                            Definition

                                                                                            May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                                                                                            ShortAdditional content defined by implementations
                                                                                            Comments

                                                                                            There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                            Control0..*
                                                                                            TypeExtension
                                                                                            Is Modifierfalse
                                                                                            Summaryfalse
                                                                                            Alternate Namesextensions, user content
                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                            222. ClaimResponse.total.modifierExtension
                                                                                            Definition

                                                                                            May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

                                                                                            Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                                                                                            ShortExtensions that cannot be ignored even if unrecognized
                                                                                            Comments

                                                                                            There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                            Control0..*
                                                                                            TypeExtension
                                                                                            Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                                                                                            Summarytrue
                                                                                            Requirements

                                                                                            Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                                                                                            Alternate Namesextensions, user content, modifiers
                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                            224. ClaimResponse.total.category
                                                                                            Definition

                                                                                            Category tổng hợp tài chính/adjudication. Dùng ConceptMap vn-cm-bhyt-financial-field-to-adjudication để map các trường tổng tiền BHYT như T_TONGCHI, T_TONGCHI_BH, T_BHTT, T_BNCCT, T_BNTT, T_NGUONKHAC, T_NGOAIDS, T_THUOC, T_VTYT. Không encode công thức quyền lợi hoặc adjudication business rule tại profile.

                                                                                            ShortLoại tổng: submitted | eligible | copay | benefit hoặc category BHYT cục bộ
                                                                                            Comments

                                                                                            For example codes indicating: Co-Pay, deductible, eligible, benefit, tax, etc.

                                                                                            Control1..1
                                                                                            BindingUnless not suitable, these codes SHALL be taken from Loại adjudication BHYT — BHYT Adjudication Category ValueSet
                                                                                            (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-adjudication-category-vs)
                                                                                            TypeCodeableConcept
                                                                                            Is Modifierfalse
                                                                                            Must Supporttrue
                                                                                            Summarytrue
                                                                                            Requirements

                                                                                            Needed to convey the type of total provided.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            226. ClaimResponse.total.amount
                                                                                            Definition

                                                                                            Monetary total amount associated with the category.

                                                                                            ShortFinancial total for the category
                                                                                            Control1..1
                                                                                            TypeMoney
                                                                                            Is Modifierfalse
                                                                                            Must Supporttrue
                                                                                            Summarytrue
                                                                                            Requirements

                                                                                            Needed to convey the total monetary amount.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            228. ClaimResponse.payment
                                                                                            Definition

                                                                                            Payment details for the adjudication of the claim.

                                                                                            ShortThông tin thanh toán
                                                                                            Control0..1
                                                                                            TypeBackboneElement
                                                                                            Is Modifierfalse
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            Needed to convey references to the financial instrument that has been used if payment has been made.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            230. ClaimResponse.payment.id
                                                                                            Definition

                                                                                            Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                                                                            ShortUnique id for inter-element referencing
                                                                                            Control0..1
                                                                                            Typestring
                                                                                            Is Modifierfalse
                                                                                            XML FormatIn the XML format, this property is represented as an attribute.
                                                                                            Summaryfalse
                                                                                            232. ClaimResponse.payment.extension
                                                                                            Definition

                                                                                            May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                                                                                            ShortAdditional content defined by implementations
                                                                                            Comments

                                                                                            There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                            Control0..*
                                                                                            TypeExtension
                                                                                            Is Modifierfalse
                                                                                            Summaryfalse
                                                                                            Alternate Namesextensions, user content
                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                            234. ClaimResponse.payment.modifierExtension
                                                                                            Definition

                                                                                            May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

                                                                                            Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                                                                                            ShortExtensions that cannot be ignored even if unrecognized
                                                                                            Comments

                                                                                            There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                            Control0..*
                                                                                            TypeExtension
                                                                                            Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                                                                                            Summarytrue
                                                                                            Requirements

                                                                                            Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                                                                                            Alternate Namesextensions, user content, modifiers
                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                            236. ClaimResponse.payment.type
                                                                                            Definition

                                                                                            Whether this represents partial or complete payment of the benefits payable.

                                                                                            ShortPartial or complete payment
                                                                                            Control1..1
                                                                                            BindingFor example codes, see ExamplePaymentTypeCodes
                                                                                            (example to http://hl7.org/fhir/ValueSet/ex-paymenttype|4.0.1)

                                                                                            The type (partial, complete) of the payment.

                                                                                            TypeCodeableConcept
                                                                                            Is Modifierfalse
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            To advise the requestor when the insurer believes all payments to have been completed.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            238. ClaimResponse.payment.adjustment
                                                                                            Definition

                                                                                            Total amount of all adjustments to this payment included in this transaction which are not related to this claim's adjudication.

                                                                                            ShortPayment adjustment for non-claim issues
                                                                                            Comments

                                                                                            Insurers will deduct amounts owing from the provider (adjustment), such as a prior overpayment, from the amount owing to the provider (benefits payable) when payment is made to the provider.

                                                                                            Control0..1
                                                                                            TypeMoney
                                                                                            Is Modifierfalse
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            To advise the requestor of adjustments applied to the payment.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            240. ClaimResponse.payment.adjustmentReason
                                                                                            Definition

                                                                                            Reason for the payment adjustment.

                                                                                            ShortExplanation for the adjustment
                                                                                            Control0..1
                                                                                            BindingFor example codes, see PaymentAdjustmentReasonCodes
                                                                                            (example to http://hl7.org/fhir/ValueSet/payment-adjustment-reason|4.0.1)

                                                                                            Payment Adjustment reason codes.

                                                                                            TypeCodeableConcept
                                                                                            Is Modifierfalse
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            Needed to clarify the monetary adjustment.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            242. ClaimResponse.payment.date
                                                                                            Definition

                                                                                            Estimated date the payment will be issued or the actual issue date of payment.

                                                                                            ShortExpected date of payment
                                                                                            Control0..1
                                                                                            Typedate
                                                                                            Is Modifierfalse
                                                                                            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            To advise the payee when payment can be expected.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            244. ClaimResponse.payment.amount
                                                                                            Definition

                                                                                            Benefits payable less any payment adjustment.

                                                                                            ShortSố tiền BHXH thanh toán
                                                                                            Control1..1
                                                                                            TypeMoney
                                                                                            Is Modifierfalse
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            Needed to provide the actual payment amount.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            246. ClaimResponse.payment.identifier
                                                                                            Definition

                                                                                            Issuer's unique identifier for the payment instrument.

                                                                                            ShortBusiness identifier for the payment
                                                                                            Comments

                                                                                            For example: EFT number or check number.

                                                                                            NoteThis is a business identifier, not a resource identifier (see discussion)
                                                                                            Control0..1
                                                                                            TypeIdentifier
                                                                                            Is Modifierfalse
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            Enable the receiver to reconcile when payment received.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            248. ClaimResponse.fundsReserve
                                                                                            Definition

                                                                                            A code, used only on a response to a preauthorization, to indicate whether the benefits payable have been reserved and for whom.

                                                                                            ShortFunds reserved status
                                                                                            Comments

                                                                                            Fund would be release by a future claim quoting the preAuthRef of this response. Examples of values include: provider, patient, none.

                                                                                            Control0..1
                                                                                            BindingFor example codes, see Funds Reservation Codes
                                                                                            (example to http://hl7.org/fhir/ValueSet/fundsreserve|4.0.1)

                                                                                            For whom funds are to be reserved: (Patient, Provider, None).

                                                                                            TypeCodeableConcept
                                                                                            Is Modifierfalse
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            Needed to advise the submitting provider on whether the rquest for reservation of funds has been honored.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            250. ClaimResponse.formCode
                                                                                            Definition

                                                                                            A code for the form to be used for printing the content.

                                                                                            ShortPrinted form identifier
                                                                                            Comments

                                                                                            May be needed to identify specific jurisdictional forms.

                                                                                            Control0..1
                                                                                            BindingFor example codes, see Form Codes
                                                                                            (example to http://hl7.org/fhir/ValueSet/forms|4.0.1)

                                                                                            The forms codes.

                                                                                            TypeCodeableConcept
                                                                                            Is Modifierfalse
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            Needed to specify the specific form used for producing output for this response.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            252. ClaimResponse.form
                                                                                            Definition

                                                                                            The actual form, by reference or inclusion, for printing the content or an EOB.

                                                                                            ShortPrinted reference or actual form
                                                                                            Comments

                                                                                            Needed to permit insurers to include the actual form.

                                                                                            Control0..1
                                                                                            TypeAttachment
                                                                                            Is Modifierfalse
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            Needed to include the specific form used for producing output for this response.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            254. ClaimResponse.processNote
                                                                                            Definition

                                                                                            A note that describes or explains adjudication results in a human readable form.

                                                                                            ShortNote concerning adjudication
                                                                                            Control0..*
                                                                                            TypeBackboneElement
                                                                                            Is Modifierfalse
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            Provides the insurer specific textual explanations associated with the processing.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            256. ClaimResponse.processNote.id
                                                                                            Definition

                                                                                            Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                                                                            ShortUnique id for inter-element referencing
                                                                                            Control0..1
                                                                                            Typestring
                                                                                            Is Modifierfalse
                                                                                            XML FormatIn the XML format, this property is represented as an attribute.
                                                                                            Summaryfalse
                                                                                            258. ClaimResponse.processNote.extension
                                                                                            Definition

                                                                                            May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                                                                                            ShortAdditional content defined by implementations
                                                                                            Comments

                                                                                            There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                            Control0..*
                                                                                            TypeExtension
                                                                                            Is Modifierfalse
                                                                                            Summaryfalse
                                                                                            Alternate Namesextensions, user content
                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                            260. ClaimResponse.processNote.modifierExtension
                                                                                            Definition

                                                                                            May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

                                                                                            Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                                                                                            ShortExtensions that cannot be ignored even if unrecognized
                                                                                            Comments

                                                                                            There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                            Control0..*
                                                                                            TypeExtension
                                                                                            Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                                                                                            Summarytrue
                                                                                            Requirements

                                                                                            Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                                                                                            Alternate Namesextensions, user content, modifiers
                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                            262. ClaimResponse.processNote.number
                                                                                            Definition

                                                                                            A number to uniquely identify a note entry.

                                                                                            ShortNote instance identifier
                                                                                            Control0..1
                                                                                            TypepositiveInt
                                                                                            Is Modifierfalse
                                                                                            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            Necessary to provide a mechanism to link from adjudications.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            264. ClaimResponse.processNote.type
                                                                                            Definition

                                                                                            The business purpose of the note text.

                                                                                            Shortdisplay | print | printoper
                                                                                            Control0..1
                                                                                            BindingThe codes SHALL be taken from NoteType
                                                                                            (required to http://hl7.org/fhir/ValueSet/note-type|4.0.1)

                                                                                            The presentation types of notes.

                                                                                            Typecode
                                                                                            Is Modifierfalse
                                                                                            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            To convey the expectation for when the text is used.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            266. ClaimResponse.processNote.text
                                                                                            Definition

                                                                                            The explanation or description associated with the processing.

                                                                                            ShortNote explanatory text
                                                                                            Control1..1
                                                                                            Typestring
                                                                                            Is Modifierfalse
                                                                                            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            Required to provide human readable explanation.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            268. ClaimResponse.processNote.language
                                                                                            Definition

                                                                                            A code to define the language used in the text of the note.

                                                                                            ShortLanguage of the text
                                                                                            Comments

                                                                                            Only required if the language is different from the resource language.

                                                                                            Control0..1
                                                                                            BindingThe codes SHOULD be taken from CommonLanguages
                                                                                            (preferred to http://hl7.org/fhir/ValueSet/languages|4.0.1)

                                                                                            A human language.

                                                                                            Additional BindingsPurpose
                                                                                            AllLanguagesMax Binding
                                                                                            TypeCodeableConcept
                                                                                            Is Modifierfalse
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            Note text may vary from the resource defined language.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            270. ClaimResponse.communicationRequest
                                                                                            Definition

                                                                                            Request for additional supporting or authorizing information.

                                                                                            ShortRequest for additional information
                                                                                            Comments

                                                                                            For example: professional reports, documents, images, clinical resources, or accident reports.

                                                                                            Control0..*
                                                                                            TypeReference(CommunicationRequest)
                                                                                            Is Modifierfalse
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            Need to communicate insurer request for additional information required to support the adjudication.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            272. ClaimResponse.insurance
                                                                                            Definition

                                                                                            Financial instruments for reimbursement for the health care products and services specified on the claim.

                                                                                            ShortPatient insurance information
                                                                                            Comments

                                                                                            All insurance coverages for the patient which may be applicable for reimbursement, of the products and services listed in the claim, are typically provided in the claim to allow insurers to confirm the ordering of the insurance coverages relative to local 'coordination of benefit' rules. One coverage (and only one) with 'focal=true' is to be used in the adjudication of this claim. Coverages appearing before the focal Coverage in the list, and where 'subrogation=false', should provide a reference to the ClaimResponse containing the adjudication results of the prior claim.

                                                                                            Control0..*
                                                                                            TypeBackboneElement
                                                                                            Is Modifierfalse
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            At least one insurer is required for a claim to be a claim.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            274. ClaimResponse.insurance.id
                                                                                            Definition

                                                                                            Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                                                                            ShortUnique id for inter-element referencing
                                                                                            Control0..1
                                                                                            Typestring
                                                                                            Is Modifierfalse
                                                                                            XML FormatIn the XML format, this property is represented as an attribute.
                                                                                            Summaryfalse
                                                                                            276. ClaimResponse.insurance.extension
                                                                                            Definition

                                                                                            May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                                                                                            ShortAdditional content defined by implementations
                                                                                            Comments

                                                                                            There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                            Control0..*
                                                                                            TypeExtension
                                                                                            Is Modifierfalse
                                                                                            Summaryfalse
                                                                                            Alternate Namesextensions, user content
                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                            278. ClaimResponse.insurance.modifierExtension
                                                                                            Definition

                                                                                            May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

                                                                                            Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                                                                                            ShortExtensions that cannot be ignored even if unrecognized
                                                                                            Comments

                                                                                            There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                            Control0..*
                                                                                            TypeExtension
                                                                                            Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                                                                                            Summarytrue
                                                                                            Requirements

                                                                                            Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                                                                                            Alternate Namesextensions, user content, modifiers
                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                            280. ClaimResponse.insurance.sequence
                                                                                            Definition

                                                                                            A number to uniquely identify insurance entries and provide a sequence of coverages to convey coordination of benefit order.

                                                                                            ShortInsurance instance identifier
                                                                                            Control1..1
                                                                                            TypepositiveInt
                                                                                            Is Modifierfalse
                                                                                            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            To maintain order of the coverages.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            282. ClaimResponse.insurance.focal
                                                                                            Definition

                                                                                            A flag to indicate that this Coverage is to be used for adjudication of this claim when set to true.

                                                                                            ShortCoverage to be used for adjudication
                                                                                            Comments

                                                                                            A patient may (will) have multiple insurance policies which provide reimbursement for healthcare services and products. For example a person may also be covered by their spouse's policy and both appear in the list (and may be from the same insurer). This flag will be set to true for only one of the listed policies and that policy will be used for adjudicating this claim. Other claims would be created to request adjudication against the other listed policies.

                                                                                            Control1..1
                                                                                            Typeboolean
                                                                                            Is Modifierfalse
                                                                                            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            To identify which coverage in the list is being used to adjudicate this claim.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            284. ClaimResponse.insurance.coverage
                                                                                            Definition

                                                                                            Reference to the insurance card level information contained in the Coverage resource. The coverage issuing insurer will use these details to locate the patient's actual coverage within the insurer's information system.

                                                                                            ShortInsurance information
                                                                                            Control1..1
                                                                                            TypeReference(Coverage)
                                                                                            Is Modifierfalse
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            Required to allow the adjudicator to locate the correct policy and history within their information system.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            286. ClaimResponse.insurance.businessArrangement
                                                                                            Definition

                                                                                            A business agreement number established between the provider and the insurer for special business processing purposes.

                                                                                            ShortAdditional provider contract number
                                                                                            Control0..1
                                                                                            Typestring
                                                                                            Is Modifierfalse
                                                                                            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            Providers may have multiple business arrangements with a given insurer and must supply the specific contract number for adjudication.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            288. ClaimResponse.insurance.claimResponse
                                                                                            Definition

                                                                                            The result of the adjudication of the line items for the Coverage specified in this insurance.

                                                                                            ShortAdjudication results
                                                                                            Comments

                                                                                            Must not be specified when 'focal=true' for this insurance.

                                                                                            Control0..1
                                                                                            TypeReference(ClaimResponse)
                                                                                            Is Modifierfalse
                                                                                            Summaryfalse
                                                                                            Requirements

                                                                                            An insurer need the adjudication results from prior insurers to determine the outstanding balance remaining by item for the items in the curent claim.

                                                                                            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                            290. ClaimResponse.error
                                                                                            Definition

                                                                                            CHỈ dùng cho processing error theo semantics FHIR R4 — payload không xử lý được, tham chiếu không resolve, hồ sơ sai cấu trúc. KHÔNG dùng cho từ chối thanh toán có căn cứ pháp lý: từ chối là KẾT QUẢ của giám định (NĐ 188/2025/NĐ-CP Điều 51 khoản 1 — chi phí được xác định không đúng quy định trong quá trình giám định), còn error là việc KHÔNG giám định được. Từ chối nghiệp vụ nằm ở adjudication category denied; thu hồi sau thanh toán nằm ở recovered.

                                                                                            ShortLỗi xử lý khiến hồ sơ không adjudicate được
                                                                                            Comments

                                                                                            If the request contains errors then an error element should be provided and no adjudication related sections (item, addItem, or payment) should be present.

                                                                                            Control0..*
                                                                                            TypeBackboneElement
                                                                                            Is Modifierfalse
                                                                                            Must Supporttrue
                                                                                            Obligations
                                                                                              ObligationsActor
                                                                                              SHALL:populate-if-knownBên giám định BHYT (Adjudicator)
                                                                                              SHALL:no-error & SHALL:handleBên gửi hồ sơ BHYT (Submitter)
                                                                                              Summaryfalse
                                                                                              Requirements

                                                                                              Need to communicate processing issues to the requestor.

                                                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                              292. ClaimResponse.error.id
                                                                                              Definition

                                                                                              Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

                                                                                              ShortUnique id for inter-element referencing
                                                                                              Control0..1
                                                                                              Typestring
                                                                                              Is Modifierfalse
                                                                                              XML FormatIn the XML format, this property is represented as an attribute.
                                                                                              Summaryfalse
                                                                                              294. ClaimResponse.error.extension
                                                                                              Definition

                                                                                              May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

                                                                                              ShortAdditional content defined by implementations
                                                                                              Comments

                                                                                              There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                              Control0..*
                                                                                              TypeExtension
                                                                                              Is Modifierfalse
                                                                                              Summaryfalse
                                                                                              Alternate Namesextensions, user content
                                                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                              ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                              296. ClaimResponse.error.modifierExtension
                                                                                              Definition

                                                                                              May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

                                                                                              Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

                                                                                              ShortExtensions that cannot be ignored even if unrecognized
                                                                                              Comments

                                                                                              There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

                                                                                              Control0..*
                                                                                              TypeExtension
                                                                                              Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
                                                                                              Summarytrue
                                                                                              Requirements

                                                                                              Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

                                                                                              Alternate Namesextensions, user content, modifiers
                                                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                              ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
                                                                                              298. ClaimResponse.error.itemSequence
                                                                                              Definition

                                                                                              The sequence number of the line item submitted which contains the error. This value is omitted when the error occurs outside of the item structure.

                                                                                              ShortDòng chi phí liên quan nếu có
                                                                                              Control0..1
                                                                                              TypepositiveInt
                                                                                              Is Modifierfalse
                                                                                              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                              Must Supporttrue
                                                                                              Summaryfalse
                                                                                              Requirements

                                                                                              Provides references to the claim items.

                                                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                              300. ClaimResponse.error.detailSequence
                                                                                              Definition

                                                                                              The sequence number of the detail within the line item submitted which contains the error. This value is omitted when the error occurs outside of the item structure.

                                                                                              ShortDetail sequence number
                                                                                              Control0..1
                                                                                              TypepositiveInt
                                                                                              Is Modifierfalse
                                                                                              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                              Must Supporttrue
                                                                                              Summaryfalse
                                                                                              Requirements

                                                                                              Provides references to the claim details within the claim item.

                                                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                              302. ClaimResponse.error.subDetailSequence
                                                                                              Definition

                                                                                              The sequence number of the sub-detail within the detail within the line item submitted which contains the error. This value is omitted when the error occurs outside of the item structure.

                                                                                              ShortSubdetail sequence number
                                                                                              Control0..1
                                                                                              TypepositiveInt
                                                                                              Is Modifierfalse
                                                                                              Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
                                                                                              Must Supporttrue
                                                                                              Summaryfalse
                                                                                              Requirements

                                                                                              Provides references to the claim sub-details within the claim detail.

                                                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                                                                                              304. ClaimResponse.error.code
                                                                                              Definition

                                                                                              Binding thu hẹp từ VNBHYTReviewIssueVS xuống VNBHYTProcessingIssueVS (từ 0.10.0): tập đầy đủ chứa cả mã kết quả giám định như LEGAL_NON_COMPLIANT_COST, và cho phép chúng ở đây chính là cách IG trước đây khuyến khích dùng sai element. Mã kết quả giám định nay thuộc VNBHYTAdjudicationIssueVS, dùng tại adjudication.reason.

                                                                                              ShortMã lỗi xử lý
                                                                                              Control1..1
                                                                                              BindingUnless not suitable, these codes SHALL be taken from Issue tầng XỬ LÝ — VN BHYT Processing Issue ValueSet
                                                                                              (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-processing-issue-vs)
                                                                                              TypeCodeableConcept
                                                                                              Is Modifierfalse
                                                                                              Must Supporttrue
                                                                                              Summaryfalse
                                                                                              Requirements

                                                                                              Required to convey processing errors.

                                                                                              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))