HL7 Vietnam VN Core FHIR Implementation Guide

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

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

Hồ sơ tài nguyên: Đối soát và phân bổ khoản thanh toán BHYT — VN Core BHYT Payment Reconciliation

URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-payment-reconciliation Phiên bản: 0.10.0
Computable Name: VNCorePaymentReconciliation
Định danh khác: OID:2.25.161089673617632664299011809196868855799.42.102

Profile PaymentReconciliation cho thông báo chuyển tiền/remittance và phân bổ một khoản thanh toán BHYT tổng hợp về các yêu cầu hoặc giao dịch thành phần theo semantics FHIR R4. Resource này có thể tham chiếu kỳ nghiệp vụ và các Claim liên quan, nhưng không phải carrier chuẩn của Biên bản quyết toán Mẫu 06/BH. Dữ liệu 5 phần A–E và bộ chỉ tiêu quyết toán quý phải dùng LogicalModel VNCoreQuarterlyHealthcareCostSettlement; nếu cần văn bản ký, render LogicalModel rồi đóng gói bằng Composition/DocumentReference. Slice formNumber được giữ để tương thích dữ liệu cũ, không biến PaymentReconciliation thành biểu mẫu 06/BH. Căn cứ: [TT 12/2026/TT-BTC] (ban hành 10/02/2026, hiệu lực 10/02/2026) — Giám định, thanh toán và quyết toán chi phí KCB BHYT; [NĐ 188/2025/NĐ-CP] (ban hành 01/07/2025, hiệu lực 15/08/2025) — Hướng dẫn thi hành Luật BHYT; [NĐ 164/2025/NĐ-CP] (ban hành 29/06/2025, hiệu lực 01/07/2025) — Giao dịch điện tử trong lĩnh vực BHXH; [Luật 51/2024/QH15] (ban hành 27/11/2024, hiệu lực 01/07/2025) — Luật BHYT sửa đổi.

English summary: This profile represents a BHYT remittance or bulk payment and allocates that payment to underlying requests or transactions in accordance with FHIR R4 PaymentReconciliation semantics. It is not the canonical carrier for quarterly Form 06/BH; use VNCoreQuarterlyHealthcareCostSettlement for the five-section quarterly settlement dataset and render/package that model separately when a signed document is required. The formNumber slice remains only for backward compatibility.

Usages:

You can also check for usages in the FHIR IG Statistics

Các dạng xem hình thức của nội dung hồ sơ

Mô tả profile, differential, snapshot và các biểu diễn liên quan.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PaymentReconciliation C 0..* PaymentReconciliation PaymentReconciliation resource
Constraints: vn-payment-reconciliation-detail-amount-sum, vn-payment-reconciliation-money-vnd, vn-payment-reconciliation-detail-anchor
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:formNumber SO 0..1 string Tham chiếu biểu mẫu legacy để tương thích — Legacy form reference for compatibility
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-reconciliation-form
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
.... extension:auditStatus SO 0..1 CodeableConcept Trạng thái giám định BHYT (received | under-review | approved | rejected | disputed)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-audit-status
Binding: Trạng thái giám định BHYT — VN Claim Audit Status ValueSet (extensible)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... period SOΣ 1..1 Period Kỳ đối soát/phân bổ khoản thanh toán — Remittance or payment-allocation period
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... created SOΣ 1..1 dateTime Ngày tạo thông báo đối soát/remittance — Reconciliation creation date
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... paymentIssuer SOΣ 0..1 Reference(Organization) Cơ quan BHXH chi trả (BHXH cấp tỉnh/Trung ương)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... request SO 0..1 Reference(Task) Hồ sơ/đề nghị thanh toán liên quan (optional)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... outcome SO 0..1 code Kết quả tổng quát chuẩn FHIR (queued | complete | error | partial)
Binding: ClaimProcessingCodes (required): The outcome of the processing.
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... paymentDate Σ 1..1 date When payment issued
... paymentAmount SOΣ 1..1 Money Tổng khoản thanh toán/remittance BHXH — Total BHXH remittance amount
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
.... value Σ 1..1 decimal Numerical value (with implicit precision)
... detail SO 1..* BackboneElement Phân bổ khoản thanh toán theo giao dịch/Claim — Payment allocation by transaction or Claim
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... identifier S 0..1 Identifier Mã giao dịch thanh toán — một trong ba mỏ neo của vn-payment-reconciliation-detail-anchor
.... type S 1..1 CodeableConcept Loại giao dịch (payment | adjustment | advance...)
Binding: PaymentTypeCodes (example): The reason for the amount: payment, adjustment, advance.
.... request S 0..1 Reference(Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile) Claim hoặc yêu cầu được phân bổ khoản thanh toán — Claim/request receiving the allocation
.... response S 0..1 Reference(Kết quả giải quyết BHYT VN Core — VN Core ClaimResponse Profile) Kết quả giám định tương ứng với khoản phân bổ — adjudication being settled
.... amount S 1..1 Money Số tiền được phân bổ cho giao dịch (VND) — Amount allocated to the transaction
..... value Σ 1..1 decimal Numerical value (with implicit precision)

doco Documentation for this format
NameBên giám định BHYT (Adjudicator)Bên gửi hồ sơ BHYT (Submitter)doco
.. PaymentReconciliation
... Slices for extension
.... extension:formNumber
.... extension:auditStatus
... status
... period
... paymentIssuer
... request
... outcome
... paymentAmount
... detail

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PaymentReconciliation.​status Base required Financial Resource Status Codes 📍4.0.1 FHIR Std.
PaymentReconciliation.​outcome Base required Claim Processing Codes 📍4.0.1 FHIR Std.
PaymentReconciliation.​detail.type Base example Payment Type Codes 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error PaymentReconciliation If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PaymentReconciliation 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 error PaymentReconciliation 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 error PaymentReconciliation If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice PaymentReconciliation A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
vn-payment-reconciliation-detail-amount-sum error PaymentReconciliation Tổng khoản thanh toán phải bằng tổng số tiền được phân bổ ở các detail. The payment amount SHALL equal the sum of amounts allocated across all details. paymentAmount.value = detail.amount.value.aggregate($this + $total, 0)
vn-payment-reconciliation-detail-anchor error PaymentReconciliation Mỗi dòng phân bổ thanh toán phải có ít nhất một mỏ neo giao dịch BẰNG GIÁ TRỊ THẬT: identifier có value, hoặc request/response là reference giải quyết được — Identifier rỗng/Reference chỉ có display không đối soát được (siết P1 round 3, 14/08/2026, cùng khuôn vn-claim-response-correlation-anchor). Each payment allocation detail SHALL carry at least one usable transaction anchor: an identifier WITH a value, or a resolvable request/response reference. detail.all(identifier.value.exists() or request.reference.exists() or response.reference.exists())
vn-payment-reconciliation-money-vnd error PaymentReconciliation Mọi khoản phân bổ chi tiết và tổng khoản thanh toán phải dùng VND. Every detail allocation and the total payment amount SHALL use VND. detail.amount.all(currency.count() = 1 and currency = 'VND') and paymentAmount.currency.count() = 1 and paymentAmount.currency = 'VND'

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PaymentReconciliation C 0..* PaymentReconciliation PaymentReconciliation resource
Constraints: vn-payment-reconciliation-detail-amount-sum, vn-payment-reconciliation-money-vnd, vn-payment-reconciliation-detail-anchor
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:formNumber SO 0..1 string Tham chiếu biểu mẫu legacy để tương thích — Legacy form reference for compatibility
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-reconciliation-form
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
.... extension:auditStatus SO 0..1 CodeableConcept Trạng thái giám định BHYT (received | under-review | approved | rejected | disputed)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-audit-status
Binding: Trạng thái giám định BHYT — VN Claim Audit Status ValueSet (extensible)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... status SO 1..1 code Trạng thái resource (active | cancelled | draft | entered-in-error)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... period SO 1..1 Period Kỳ đối soát/phân bổ khoản thanh toán — Remittance or payment-allocation period
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... paymentIssuer SO 0..1 Reference(Organization) Cơ quan BHXH chi trả (BHXH cấp tỉnh/Trung ương)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... request SO 0..1 Reference(Task) Hồ sơ/đề nghị thanh toán liên quan (optional)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... outcome SO 0..1 code Kết quả tổng quát chuẩn FHIR (queued | complete | error | partial)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... paymentAmount SO 1..1 Money Tổng khoản thanh toán/remittance BHXH — Total BHXH remittance amount
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
.... value 1..1 decimal Numerical value (with implicit precision)
... detail SO 1..* BackboneElement Phân bổ khoản thanh toán theo giao dịch/Claim — Payment allocation by transaction or Claim
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
.... identifier S 0..1 Identifier Mã giao dịch thanh toán — một trong ba mỏ neo của vn-payment-reconciliation-detail-anchor
.... type S 1..1 CodeableConcept Loại giao dịch (payment | adjustment | advance...)
.... request S 0..1 Reference(Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile) Claim hoặc yêu cầu được phân bổ khoản thanh toán — Claim/request receiving the allocation
.... response S 0..1 Reference(Kết quả giải quyết BHYT VN Core — VN Core ClaimResponse Profile) Kết quả giám định tương ứng với khoản phân bổ — adjudication being settled
.... amount S 1..1 Money Số tiền được phân bổ cho giao dịch (VND) — Amount allocated to the transaction
..... value 1..1 decimal Numerical value (with implicit precision)

doco Documentation for this format
NameBên giám định BHYT (Adjudicator)Bên gửi hồ sơ BHYT (Submitter)doco
.. PaymentReconciliation
... Slices for extension
.... extension:formNumber
.... extension:auditStatus
... status
... period
... paymentIssuer
... request
... outcome
... paymentAmount
... detail

doco Documentation for this format

Constraints

Id Grade Path(s) Description Expression
vn-payment-reconciliation-detail-amount-sum error PaymentReconciliation Tổng khoản thanh toán phải bằng tổng số tiền được phân bổ ở các detail. The payment amount SHALL equal the sum of amounts allocated across all details. paymentAmount.value = detail.amount.value.aggregate($this + $total, 0)
vn-payment-reconciliation-detail-anchor error PaymentReconciliation Mỗi dòng phân bổ thanh toán phải có ít nhất một mỏ neo giao dịch BẰNG GIÁ TRỊ THẬT: identifier có value, hoặc request/response là reference giải quyết được — Identifier rỗng/Reference chỉ có display không đối soát được (siết P1 round 3, 14/08/2026, cùng khuôn vn-claim-response-correlation-anchor). Each payment allocation detail SHALL carry at least one usable transaction anchor: an identifier WITH a value, or a resolvable request/response reference. detail.all(identifier.value.exists() or request.reference.exists() or response.reference.exists())
vn-payment-reconciliation-money-vnd error PaymentReconciliation Mọi khoản phân bổ chi tiết và tổng khoản thanh toán phải dùng VND. Every detail allocation and the total payment amount SHALL use VND. detail.amount.all(currency.count() = 1 and currency = 'VND') and paymentAmount.currency.count() = 1 and paymentAmount.currency = 'VND'
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PaymentReconciliation C 0..* PaymentReconciliation PaymentReconciliation resource
Constraints: vn-payment-reconciliation-detail-amount-sum, vn-payment-reconciliation-money-vnd, vn-payment-reconciliation-detail-anchor
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:formNumber SO 0..1 string Tham chiếu biểu mẫu legacy để tương thích — Legacy form reference for compatibility
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-reconciliation-form
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
.... extension:auditStatus SO 0..1 CodeableConcept Trạng thái giám định BHYT (received | under-review | approved | rejected | disputed)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-audit-status
Binding: Trạng thái giám định BHYT — VN Claim Audit Status ValueSet (extensible)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier 0..* Identifier Business Identifier for a payment reconciliation
... status ?!SOΣ 1..1 code Trạng thái resource (active | cancelled | draft | entered-in-error)
Binding: FinancialResourceStatusCodes (required): A code specifying the state of the resource instance.
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... period SOΣ 1..1 Period Kỳ đối soát/phân bổ khoản thanh toán — Remittance or payment-allocation period
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... created SOΣ 1..1 dateTime Ngày tạo thông báo đối soát/remittance — Reconciliation creation date
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... paymentIssuer SOΣ 0..1 Reference(Organization) Cơ quan BHXH chi trả (BHXH cấp tỉnh/Trung ương)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... request SO 0..1 Reference(Task) Hồ sơ/đề nghị thanh toán liên quan (optional)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... requestor 0..1 Reference(Practitioner | PractitionerRole | Organization) Responsible practitioner
... outcome SO 0..1 code Kết quả tổng quát chuẩn FHIR (queued | complete | error | partial)
Binding: ClaimProcessingCodes (required): The outcome of the processing.
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... disposition 0..1 string Disposition message
... paymentDate Σ 1..1 date When payment issued
... paymentAmount SOΣ 1..1 Money Tổng khoản thanh toán/remittance BHXH — Total BHXH remittance amount
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... value Σ 1..1 decimal Numerical value (with implicit precision)
.... currency Σ 0..1 code ISO 4217 Currency Code
Binding: Currencies (required): A code indicating the currency, taken from ISO 4217.
... paymentIdentifier 0..1 Identifier Business identifier for the payment
... detail SO 1..* BackboneElement Phân bổ khoản thanh toán theo giao dịch/Claim — Payment allocation by transaction or Claim
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... identifier S 0..1 Identifier Mã giao dịch thanh toán — một trong ba mỏ neo của vn-payment-reconciliation-detail-anchor
.... predecessor 0..1 Identifier Business identifier of the prior payment detail
.... type S 1..1 CodeableConcept Loại giao dịch (payment | adjustment | advance...)
Binding: PaymentTypeCodes (example): The reason for the amount: payment, adjustment, advance.
.... request S 0..1 Reference(Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile) Claim hoặc yêu cầu được phân bổ khoản thanh toán — Claim/request receiving the allocation
.... submitter 0..1 Reference(Practitioner | PractitionerRole | Organization) Submitter of the request
.... response S 0..1 Reference(Kết quả giải quyết BHYT VN Core — VN Core ClaimResponse Profile) Kết quả giám định tương ứng với khoản phân bổ — adjudication being settled
.... date 0..1 date Date of commitment to pay
.... responsible 0..1 Reference(PractitionerRole) Contact for the response
.... payee 0..1 Reference(Practitioner | PractitionerRole | Organization) Recipient of the payment
.... amount S 1..1 Money Số tiền được phân bổ cho giao dịch (VND) — Amount allocated to the transaction
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... value Σ 1..1 decimal Numerical value (with implicit precision)
..... currency Σ 0..1 code ISO 4217 Currency Code
Binding: Currencies (required): A code indicating the currency, taken from ISO 4217.
... formCode 0..1 CodeableConcept Printed form identifier
Binding: Form Codes (example): The forms codes.
... processNote 0..* BackboneElement Note concerning processing
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... type 0..1 code display | print | printoper
Binding: NoteType (required): The presentation types of notes.
.... text 0..1 string Note explanatory text

doco Documentation for this format
NameBên giám định BHYT (Adjudicator)Bên gửi hồ sơ BHYT (Submitter)doco
.. PaymentReconciliation
... Slices for extension
.... extension:formNumber
.... extension:auditStatus
... status
... period
... paymentIssuer
... request
... outcome
... paymentAmount
... detail

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PaymentReconciliation.​language Base preferred Common Languages 📍4.0.1 FHIR Std.
PaymentReconciliation.​status Base required Financial Resource Status Codes 📍4.0.1 FHIR Std.
PaymentReconciliation.​outcome Base required Claim Processing Codes 📍4.0.1 FHIR Std.
PaymentReconciliation.​paymentAmount.currency Base required CurrencyCode 📍4.0.1 FHIR Std.
PaymentReconciliation.​detail.type Base example Payment Type Codes 📍4.0.1 FHIR Std.
PaymentReconciliation.​detail.amount.currency Base required CurrencyCode 📍4.0.1 FHIR Std.
PaymentReconciliation.​formCode Base example Forms 📍4.0.1 FHIR Std.
PaymentReconciliation.​processNote.type Base required NoteType 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error PaymentReconciliation If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PaymentReconciliation 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 error PaymentReconciliation 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 error PaymentReconciliation If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice PaymentReconciliation A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
vn-payment-reconciliation-detail-amount-sum error PaymentReconciliation Tổng khoản thanh toán phải bằng tổng số tiền được phân bổ ở các detail. The payment amount SHALL equal the sum of amounts allocated across all details. paymentAmount.value = detail.amount.value.aggregate($this + $total, 0)
vn-payment-reconciliation-detail-anchor error PaymentReconciliation Mỗi dòng phân bổ thanh toán phải có ít nhất một mỏ neo giao dịch BẰNG GIÁ TRỊ THẬT: identifier có value, hoặc request/response là reference giải quyết được — Identifier rỗng/Reference chỉ có display không đối soát được (siết P1 round 3, 14/08/2026, cùng khuôn vn-claim-response-correlation-anchor). Each payment allocation detail SHALL carry at least one usable transaction anchor: an identifier WITH a value, or a resolvable request/response reference. detail.all(identifier.value.exists() or request.reference.exists() or response.reference.exists())
vn-payment-reconciliation-money-vnd error PaymentReconciliation Mọi khoản phân bổ chi tiết và tổng khoản thanh toán phải dùng VND. Every detail allocation and the total payment amount SHALL use VND. detail.amount.all(currency.count() = 1 and currency = 'VND') and paymentAmount.currency.count() = 1 and paymentAmount.currency = 'VND'

Dạng xem phần tử chính

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PaymentReconciliation C 0..* PaymentReconciliation PaymentReconciliation resource
Constraints: vn-payment-reconciliation-detail-amount-sum, vn-payment-reconciliation-money-vnd, vn-payment-reconciliation-detail-anchor
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:formNumber SO 0..1 string Tham chiếu biểu mẫu legacy để tương thích — Legacy form reference for compatibility
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-reconciliation-form
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
.... extension:auditStatus SO 0..1 CodeableConcept Trạng thái giám định BHYT (received | under-review | approved | rejected | disputed)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-audit-status
Binding: Trạng thái giám định BHYT — VN Claim Audit Status ValueSet (extensible)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... period SOΣ 1..1 Period Kỳ đối soát/phân bổ khoản thanh toán — Remittance or payment-allocation period
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... created SOΣ 1..1 dateTime Ngày tạo thông báo đối soát/remittance — Reconciliation creation date
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... paymentIssuer SOΣ 0..1 Reference(Organization) Cơ quan BHXH chi trả (BHXH cấp tỉnh/Trung ương)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... request SO 0..1 Reference(Task) Hồ sơ/đề nghị thanh toán liên quan (optional)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... outcome SO 0..1 code Kết quả tổng quát chuẩn FHIR (queued | complete | error | partial)
Binding: ClaimProcessingCodes (required): The outcome of the processing.
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... paymentDate Σ 1..1 date When payment issued
... paymentAmount SOΣ 1..1 Money Tổng khoản thanh toán/remittance BHXH — Total BHXH remittance amount
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
.... value Σ 1..1 decimal Numerical value (with implicit precision)
... detail SO 1..* BackboneElement Phân bổ khoản thanh toán theo giao dịch/Claim — Payment allocation by transaction or Claim
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... identifier S 0..1 Identifier Mã giao dịch thanh toán — một trong ba mỏ neo của vn-payment-reconciliation-detail-anchor
.... type S 1..1 CodeableConcept Loại giao dịch (payment | adjustment | advance...)
Binding: PaymentTypeCodes (example): The reason for the amount: payment, adjustment, advance.
.... request S 0..1 Reference(Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile) Claim hoặc yêu cầu được phân bổ khoản thanh toán — Claim/request receiving the allocation
.... response S 0..1 Reference(Kết quả giải quyết BHYT VN Core — VN Core ClaimResponse Profile) Kết quả giám định tương ứng với khoản phân bổ — adjudication being settled
.... amount S 1..1 Money Số tiền được phân bổ cho giao dịch (VND) — Amount allocated to the transaction
..... value Σ 1..1 decimal Numerical value (with implicit precision)

doco Documentation for this format
NameBên giám định BHYT (Adjudicator)Bên gửi hồ sơ BHYT (Submitter)doco
.. PaymentReconciliation
... Slices for extension
.... extension:formNumber
.... extension:auditStatus
... status
... period
... paymentIssuer
... request
... outcome
... paymentAmount
... detail

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PaymentReconciliation.​status Base required Financial Resource Status Codes 📍4.0.1 FHIR Std.
PaymentReconciliation.​outcome Base required Claim Processing Codes 📍4.0.1 FHIR Std.
PaymentReconciliation.​detail.type Base example Payment Type Codes 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error PaymentReconciliation If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PaymentReconciliation 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 error PaymentReconciliation 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 error PaymentReconciliation If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice PaymentReconciliation A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
vn-payment-reconciliation-detail-amount-sum error PaymentReconciliation Tổng khoản thanh toán phải bằng tổng số tiền được phân bổ ở các detail. The payment amount SHALL equal the sum of amounts allocated across all details. paymentAmount.value = detail.amount.value.aggregate($this + $total, 0)
vn-payment-reconciliation-detail-anchor error PaymentReconciliation Mỗi dòng phân bổ thanh toán phải có ít nhất một mỏ neo giao dịch BẰNG GIÁ TRỊ THẬT: identifier có value, hoặc request/response là reference giải quyết được — Identifier rỗng/Reference chỉ có display không đối soát được (siết P1 round 3, 14/08/2026, cùng khuôn vn-claim-response-correlation-anchor). Each payment allocation detail SHALL carry at least one usable transaction anchor: an identifier WITH a value, or a resolvable request/response reference. detail.all(identifier.value.exists() or request.reference.exists() or response.reference.exists())
vn-payment-reconciliation-money-vnd error PaymentReconciliation Mọi khoản phân bổ chi tiết và tổng khoản thanh toán phải dùng VND. Every detail allocation and the total payment amount SHALL use VND. detail.amount.all(currency.count() = 1 and currency = 'VND') and paymentAmount.currency.count() = 1 and paymentAmount.currency = 'VND'

Dạng xem Differential

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PaymentReconciliation C 0..* PaymentReconciliation PaymentReconciliation resource
Constraints: vn-payment-reconciliation-detail-amount-sum, vn-payment-reconciliation-money-vnd, vn-payment-reconciliation-detail-anchor
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:formNumber SO 0..1 string Tham chiếu biểu mẫu legacy để tương thích — Legacy form reference for compatibility
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-reconciliation-form
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
.... extension:auditStatus SO 0..1 CodeableConcept Trạng thái giám định BHYT (received | under-review | approved | rejected | disputed)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-audit-status
Binding: Trạng thái giám định BHYT — VN Claim Audit Status ValueSet (extensible)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... status SO 1..1 code Trạng thái resource (active | cancelled | draft | entered-in-error)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... period SO 1..1 Period Kỳ đối soát/phân bổ khoản thanh toán — Remittance or payment-allocation period
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... paymentIssuer SO 0..1 Reference(Organization) Cơ quan BHXH chi trả (BHXH cấp tỉnh/Trung ương)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... request SO 0..1 Reference(Task) Hồ sơ/đề nghị thanh toán liên quan (optional)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... outcome SO 0..1 code Kết quả tổng quát chuẩn FHIR (queued | complete | error | partial)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... paymentAmount SO 1..1 Money Tổng khoản thanh toán/remittance BHXH — Total BHXH remittance amount
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
.... value 1..1 decimal Numerical value (with implicit precision)
... detail SO 1..* BackboneElement Phân bổ khoản thanh toán theo giao dịch/Claim — Payment allocation by transaction or Claim
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
.... identifier S 0..1 Identifier Mã giao dịch thanh toán — một trong ba mỏ neo của vn-payment-reconciliation-detail-anchor
.... type S 1..1 CodeableConcept Loại giao dịch (payment | adjustment | advance...)
.... request S 0..1 Reference(Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile) Claim hoặc yêu cầu được phân bổ khoản thanh toán — Claim/request receiving the allocation
.... response S 0..1 Reference(Kết quả giải quyết BHYT VN Core — VN Core ClaimResponse Profile) Kết quả giám định tương ứng với khoản phân bổ — adjudication being settled
.... amount S 1..1 Money Số tiền được phân bổ cho giao dịch (VND) — Amount allocated to the transaction
..... value 1..1 decimal Numerical value (with implicit precision)

doco Documentation for this format
NameBên giám định BHYT (Adjudicator)Bên gửi hồ sơ BHYT (Submitter)doco
.. PaymentReconciliation
... Slices for extension
.... extension:formNumber
.... extension:auditStatus
... status
... period
... paymentIssuer
... request
... outcome
... paymentAmount
... detail

doco Documentation for this format

Constraints

Id Grade Path(s) Description Expression
vn-payment-reconciliation-detail-amount-sum error PaymentReconciliation Tổng khoản thanh toán phải bằng tổng số tiền được phân bổ ở các detail. The payment amount SHALL equal the sum of amounts allocated across all details. paymentAmount.value = detail.amount.value.aggregate($this + $total, 0)
vn-payment-reconciliation-detail-anchor error PaymentReconciliation Mỗi dòng phân bổ thanh toán phải có ít nhất một mỏ neo giao dịch BẰNG GIÁ TRỊ THẬT: identifier có value, hoặc request/response là reference giải quyết được — Identifier rỗng/Reference chỉ có display không đối soát được (siết P1 round 3, 14/08/2026, cùng khuôn vn-claim-response-correlation-anchor). Each payment allocation detail SHALL carry at least one usable transaction anchor: an identifier WITH a value, or a resolvable request/response reference. detail.all(identifier.value.exists() or request.reference.exists() or response.reference.exists())
vn-payment-reconciliation-money-vnd error PaymentReconciliation Mọi khoản phân bổ chi tiết và tổng khoản thanh toán phải dùng VND. Every detail allocation and the total payment amount SHALL use VND. detail.amount.all(currency.count() = 1 and currency = 'VND') and paymentAmount.currency.count() = 1 and paymentAmount.currency = 'VND'

Dạng xem SnapshotView

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PaymentReconciliation C 0..* PaymentReconciliation PaymentReconciliation resource
Constraints: vn-payment-reconciliation-detail-amount-sum, vn-payment-reconciliation-money-vnd, vn-payment-reconciliation-detail-anchor
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:formNumber SO 0..1 string Tham chiếu biểu mẫu legacy để tương thích — Legacy form reference for compatibility
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-reconciliation-form
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
.... extension:auditStatus SO 0..1 CodeableConcept Trạng thái giám định BHYT (received | under-review | approved | rejected | disputed)
URL: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-audit-status
Binding: Trạng thái giám định BHYT — VN Claim Audit Status ValueSet (extensible)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier 0..* Identifier Business Identifier for a payment reconciliation
... status ?!SOΣ 1..1 code Trạng thái resource (active | cancelled | draft | entered-in-error)
Binding: FinancialResourceStatusCodes (required): A code specifying the state of the resource instance.
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... period SOΣ 1..1 Period Kỳ đối soát/phân bổ khoản thanh toán — Remittance or payment-allocation period
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... created SOΣ 1..1 dateTime Ngày tạo thông báo đối soát/remittance — Reconciliation creation date
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... paymentIssuer SOΣ 0..1 Reference(Organization) Cơ quan BHXH chi trả (BHXH cấp tỉnh/Trung ương)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... request SO 0..1 Reference(Task) Hồ sơ/đề nghị thanh toán liên quan (optional)
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... requestor 0..1 Reference(Practitioner | PractitionerRole | Organization) Responsible practitioner
... outcome SO 0..1 code Kết quả tổng quát chuẩn FHIR (queued | complete | error | partial)
Binding: ClaimProcessingCodes (required): The outcome of the processing.
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
... disposition 0..1 string Disposition message
... paymentDate Σ 1..1 date When payment issued
... paymentAmount SOΣ 1..1 Money Tổng khoản thanh toán/remittance BHXH — Total BHXH remittance amount
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... value Σ 1..1 decimal Numerical value (with implicit precision)
.... currency Σ 0..1 code ISO 4217 Currency Code
Binding: Currencies (required): A code indicating the currency, taken from ISO 4217.
... paymentIdentifier 0..1 Identifier Business identifier for the payment
... detail SO 1..* BackboneElement Phân bổ khoản thanh toán theo giao dịch/Claim — Payment allocation by transaction or Claim
ObligationsActor
SHALL:populate-if-known Bên giám định BHYT (Adjudicator)
SHALL:no-error & SHALL:handle Bên gửi hồ sơ BHYT (Submitter)
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... identifier S 0..1 Identifier Mã giao dịch thanh toán — một trong ba mỏ neo của vn-payment-reconciliation-detail-anchor
.... predecessor 0..1 Identifier Business identifier of the prior payment detail
.... type S 1..1 CodeableConcept Loại giao dịch (payment | adjustment | advance...)
Binding: PaymentTypeCodes (example): The reason for the amount: payment, adjustment, advance.
.... request S 0..1 Reference(Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile) Claim hoặc yêu cầu được phân bổ khoản thanh toán — Claim/request receiving the allocation
.... submitter 0..1 Reference(Practitioner | PractitionerRole | Organization) Submitter of the request
.... response S 0..1 Reference(Kết quả giải quyết BHYT VN Core — VN Core ClaimResponse Profile) Kết quả giám định tương ứng với khoản phân bổ — adjudication being settled
.... date 0..1 date Date of commitment to pay
.... responsible 0..1 Reference(PractitionerRole) Contact for the response
.... payee 0..1 Reference(Practitioner | PractitionerRole | Organization) Recipient of the payment
.... amount S 1..1 Money Số tiền được phân bổ cho giao dịch (VND) — Amount allocated to the transaction
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... value Σ 1..1 decimal Numerical value (with implicit precision)
..... currency Σ 0..1 code ISO 4217 Currency Code
Binding: Currencies (required): A code indicating the currency, taken from ISO 4217.
... formCode 0..1 CodeableConcept Printed form identifier
Binding: Form Codes (example): The forms codes.
... processNote 0..* BackboneElement Note concerning processing
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... type 0..1 code display | print | printoper
Binding: NoteType (required): The presentation types of notes.
.... text 0..1 string Note explanatory text

doco Documentation for this format
NameBên giám định BHYT (Adjudicator)Bên gửi hồ sơ BHYT (Submitter)doco
.. PaymentReconciliation
... Slices for extension
.... extension:formNumber
.... extension:auditStatus
... status
... period
... paymentIssuer
... request
... outcome
... paymentAmount
... detail

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PaymentReconciliation.​language Base preferred Common Languages 📍4.0.1 FHIR Std.
PaymentReconciliation.​status Base required Financial Resource Status Codes 📍4.0.1 FHIR Std.
PaymentReconciliation.​outcome Base required Claim Processing Codes 📍4.0.1 FHIR Std.
PaymentReconciliation.​paymentAmount.currency Base required CurrencyCode 📍4.0.1 FHIR Std.
PaymentReconciliation.​detail.type Base example Payment Type Codes 📍4.0.1 FHIR Std.
PaymentReconciliation.​detail.amount.currency Base required CurrencyCode 📍4.0.1 FHIR Std.
PaymentReconciliation.​formCode Base example Forms 📍4.0.1 FHIR Std.
PaymentReconciliation.​processNote.type Base required NoteType 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error PaymentReconciliation If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PaymentReconciliation 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 error PaymentReconciliation 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 error PaymentReconciliation If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice PaymentReconciliation A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
vn-payment-reconciliation-detail-amount-sum error PaymentReconciliation Tổng khoản thanh toán phải bằng tổng số tiền được phân bổ ở các detail. The payment amount SHALL equal the sum of amounts allocated across all details. paymentAmount.value = detail.amount.value.aggregate($this + $total, 0)
vn-payment-reconciliation-detail-anchor error PaymentReconciliation Mỗi dòng phân bổ thanh toán phải có ít nhất một mỏ neo giao dịch BẰNG GIÁ TRỊ THẬT: identifier có value, hoặc request/response là reference giải quyết được — Identifier rỗng/Reference chỉ có display không đối soát được (siết P1 round 3, 14/08/2026, cùng khuôn vn-claim-response-correlation-anchor). Each payment allocation detail SHALL carry at least one usable transaction anchor: an identifier WITH a value, or a resolvable request/response reference. detail.all(identifier.value.exists() or request.reference.exists() or response.reference.exists())
vn-payment-reconciliation-money-vnd error PaymentReconciliation Mọi khoản phân bổ chi tiết và tổng khoản thanh toán phải dùng VND. Every detail allocation and the total payment amount SHALL use VND. detail.amount.all(currency.count() = 1 and currency = 'VND') and paymentAmount.currency.count() = 1 and paymentAmount.currency = 'VND'

 

Biểu diễn khác của hồ sơ: CSV, Excel, Schematron