HL7 Vietnam VN Core FHIR Implementation Guide

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

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Draft for Community Review (v0.5.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-03-21

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())
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
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
    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
    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
    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
    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
    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
    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(Cơ sở y tế VN Core — VN Core Organization Profile, Organization)
    Is Modifierfalse
    Must Supporttrue
    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
    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
    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
    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.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())
    44. 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 | benefitType 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 AdjudicationValueCodeshttp://hl7.org/fhir/ValueSet/adjudication|4.0.1
    (extensible to http://hl7.org/fhir/ValueSet/adjudication)
    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()))
    46. ClaimResponse.item.adjudication.amount
    Definition

    Monetary amount associated with the category.

    ShortSố tiền (VND)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()))
    48. 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
    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()))
    50. 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())
    52. 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()))
    54. 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()))
    56. 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()))
    58. 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())
    60. 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()))
    62. 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()))
    64. ClaimResponse.error
    Definition

    Issue-level carrier cho phản hồi giám định, giảm trừ, yêu cầu điều chỉnh hoặc lỗi tiếp nhận có liên kết tới claim. VNBHYTReviewIssueVS chỉ là taxonomy baseline cục bộ từ TT 12/2026; không phải catalog payer/gateway chính thức đầy đủ.


    Errors encountered during the processing of the adjudication.

    ShortNhóm issue giám định/từ chối hoặc yêu cầu điều chỉnhProcessing 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
    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()))
    66. 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())
    68. 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()))
    70. ClaimResponse.error.code
    Definition

    Mã nhóm issue để liên kết ClaimResponse với OperationOutcome, bảng kê từ chối hoặc biên bản giám định. Căn cứ pháp lý chi tiết và số tiền vẫn nằm ở tài liệu giám định/payer response cụ thể.


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

    ShortNhóm issue/lý do BHYTError code detailing processing issues
    Control1..1
    BindingUnless not suitable, these codes SHALL be taken from For example codes, see Nhóm issue giám định BHYT cục bộ — VN BHYT Review Issue ValueSethttp://hl7.org/fhir/ValueSet/adjudication-error|4.0.1
    (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-review-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
    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
    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
      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
      14. ClaimResponse.type
      ShortLoại: institutional (nội trú) | professional (ngoại trú)
      Must Supporttrue
      16. ClaimResponse.use
      ShortMục đích: claim | preauthorization | predetermination
      Must Supporttrue
      18. ClaimResponse.patient
      ShortBệnh nhân
      TypeReference(Bệnh nhân VN Core — VN Core Patient Profile)
      Must Supporttrue
      20. ClaimResponse.created
      ShortNgày tạo kết quả
      Must Supporttrue
      22. ClaimResponse.insurer
      ShortCơ quan BHXH giải quyết
      TypeReference(Cơ sở y tế VN Core — VN Core Organization Profile)
      Must Supporttrue
      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
      26. ClaimResponse.outcome
      ShortKết quả: queued | complete | error | partial
      Must Supporttrue
      28. ClaimResponse.item
      ShortKết quả từng dòng chi phí
      Must Supporttrue
      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.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
      BindingUnless not suitable, these codes SHALL be taken from AdjudicationValueCodes
      (extensible to http://hl7.org/fhir/ValueSet/adjudication)
      Must Supporttrue
      36. ClaimResponse.item.adjudication.amount
      ShortSố tiền (VND)
      Must Supporttrue
      38. ClaimResponse.total
      ShortTổng adjudication
      Must Supporttrue
      40. 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
      42. ClaimResponse.total.amount
      Must Supporttrue
      44. ClaimResponse.payment
      ShortThông tin thanh toán
      46. ClaimResponse.payment.amount
      ShortSố tiền BHXH thanh toán
      48. ClaimResponse.error
      Definition

      Issue-level carrier cho phản hồi giám định, giảm trừ, yêu cầu điều chỉnh hoặc lỗi tiếp nhận có liên kết tới claim. VNBHYTReviewIssueVS chỉ là taxonomy baseline cục bộ từ TT 12/2026; không phải catalog payer/gateway chính thức đầy đủ.

      ShortNhóm issue giám định/từ chối hoặc yêu cầu điều chỉnh
      Must Supporttrue
      50. ClaimResponse.error.itemSequence
      ShortDòng chi phí liên quan nếu có
      Must Supporttrue
      52. ClaimResponse.error.code
      Definition

      Mã nhóm issue để liên kết ClaimResponse với OperationOutcome, bảng kê từ chối hoặc biên bản giám định. Căn cứ pháp lý chi tiết và số tiền vẫn nằm ở tài liệu giám định/payer response cụ thể.

      ShortNhóm issue/lý do BHYT
      BindingUnless not suitable, these codes SHALL be taken from Nhóm issue giám định BHYT cục bộ — VN BHYT Review Issue ValueSet
      (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-review-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())
      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
      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
        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
          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
          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
          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
          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
          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(Cơ sở y tế VN Core — VN Core Organization Profile)
          Is Modifierfalse
          Must Supporttrue
          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
          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
          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
          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

          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())
          84. 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())
          86. 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
          Comments

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

          Control1..1
          BindingUnless not suitable, these codes SHALL be taken from AdjudicationValueCodes
          (extensible to http://hl7.org/fhir/ValueSet/adjudication)
          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()))
          88. ClaimResponse.item.adjudication.reason
          Definition

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

          ShortExplanation of adjudication outcome
          Comments

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

          Control0..1
          BindingFor example codes, see AdjudicationReasonCodes
          (example to http://hl7.org/fhir/ValueSet/adjudication-reason|4.0.1)

          The adjudication reason codes.

          TypeCodeableConcept
          Is Modifierfalse
          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()))
          90. ClaimResponse.item.adjudication.amount
          Definition

          Monetary amount associated with the category.

          ShortSố tiền (VND)
          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()))
          92. 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()))
          94. 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()))
          96. 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
          98. 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())
          100. 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())
          102. 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()))
          104. 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()))
          106. 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()))
          108. 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()))
          110. 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
          112. 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())
          114. 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())
          116. 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()))
          118. 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()))
          120. 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()))
          122. 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()))
          124. 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
          126. 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())
          128. 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())
          130. 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()))
          132. 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()))
          134. 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()))
          136. 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()))
          138. 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()))
          140. 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()))
          142. 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()))
          144. 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()))
          146. 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()))
          148. 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()))
          150. 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()))
          152. 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()))
          154. 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()))
          156. 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()))
          158. 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()))
          160. 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()))
          162. 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()))
          164. 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()))
          166. 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
          168. 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())
          170. 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())
          172. 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()))
          174. 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()))
          176. 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()))
          178. 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()))
          180. 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()))
          182. 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()))
          184. 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()))
          186. 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()))
          188. 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()))
          190. 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
          192. 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())
          194. 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())
          196. 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()))
          198. 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()))
          200. 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()))
          202. 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()))
          204. 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()))
          206. 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()))
          208. 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()))
          210. 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()))
          212. 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()))
          214. 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
          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()))
          216. 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
          218. 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())
          220. 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())
          222. 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()))
          224. 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()))
          226. 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()))
          228. 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
          230. 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())
          232. 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())
          234. 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()))
          236. 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()))
          238. 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()))
          240. 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()))
          242. 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()))
          244. 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()))
          246. 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()))
          248. 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()))
          250. 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()))
          252. 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()))
          254. 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
          256. 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())
          258. 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())
          260. 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()))
          262. 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()))
          264. 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()))
          266. 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()))
          268. 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()))
          270. 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()))
          272. 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
          274. 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())
          276. 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())
          278. 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()))
          280. 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()))
          282. 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()))
          284. 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()))
          286. 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()))
          288. ClaimResponse.error
          Definition

          Issue-level carrier cho phản hồi giám định, giảm trừ, yêu cầu điều chỉnh hoặc lỗi tiếp nhận có liên kết tới claim. VNBHYTReviewIssueVS chỉ là taxonomy baseline cục bộ từ TT 12/2026; không phải catalog payer/gateway chính thức đầy đủ.

          ShortNhóm issue giám định/từ chối hoặc yêu cầu điều chỉnh
          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
          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()))
          290. 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
          292. 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())
          294. 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())
          296. 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()))
          298. 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
          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()))
          300. 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
          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()))
          302. ClaimResponse.error.code
          Definition

          Mã nhóm issue để liên kết ClaimResponse với OperationOutcome, bảng kê từ chối hoặc biên bản giám định. Căn cứ pháp lý chi tiết và số tiền vẫn nằm ở tài liệu giám định/payer response cụ thể.

          ShortNhóm issue/lý do BHYT
          Control1..1
          BindingUnless not suitable, these codes SHALL be taken from Nhóm issue giám định BHYT cục bộ — VN BHYT Review Issue ValueSet
          (extensible to http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-review-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()))