Profile Comparison between http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim-response vs http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim-response

Messages

Metadata

Name	Value		Comments
abstract	false
baseDefinition	http://hl7.org/fhir/StructureDefinition/ClaimResponse
copyright
date	2026-03-21
description	Profile ClaimResponse cho Việt Nam. Kết quả xử lý yêu cầu thanh toán BHYT. Bao gồm adjudication chi tiết: tổng đề nghị, đủ điều kiện, cùng chi trả, BHYT thanh toán. Cặp đôi với VNCoreClaim — Claim là yêu cầu, ClaimResponse là kết quả. Mã phản hồi gateway như XML1_ID được biểu diễn bằng identifier slice riêng; không thay thế MA_LK của Claim/Bundle. Căn cứ: - QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT (chuẩn dữ liệu BHXH hiện hành) - QĐ 697/QĐ-BYT (19/3/2026) — Mẫu bảng kê chi phí KCB - Luật 51/2024/QH15 (27/11/2024) — sửa đổi Luật BHYT, hiệu lực 01/7/2025 - NĐ 188/2025/NĐ-CP — ban hành 01/7/2025, hiệu lực 15/8/2025 — Hướng dẫn Luật BHYT - NĐ 90/2026/NĐ-CP (ban hành 30/03/2026, hiệu lực 15/05/2026 — future-effective) — xử phạt VPHC y tế, tham chiếu khi hồ sơ giám định/thanh toán sai lệch Nguồn thiết kế: OHP Data Processor (ClaimResponse adjudication mapping).
experimental
fhirVersion	4.0.1
jurisdiction
jurisdiction[0]	urn:iso:std:iso:3166#VN
kind	resource
name	VNCoreClaimResponse
publisher	Omi HealthTech / VN Core FHIR Community Initiative
purpose
status	draft
title	Kết quả giải quyết BHYT VN Core — VN Core ClaimResponse Profile
type	ClaimResponse
url	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim-response
version	0.5.0	0.5.1	Values Differ

Structure

Name	L Flags	L Card.	L Type	L Description & Constraints	R Flags	R Card.	R Type	R Description & Constraints	Comments
ClaimResponse		0..*	ClaimResponse	Response to a claim predetermination or preauthorization		0..*	ClaimResponse	Response to a claim predetermination or preauthorization
id	Σ	0..1	id	Logical id of this artifact	Σ	0..1	id	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource	Σ	0..1	Meta	Metadata about the resource
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created	?!Σ	0..1	uri	A set of rules under which this content was created
language		0..1	code	Language of the resource content Binding: ?? (preferred): A human language. Additional Bindings Purpose ?? Max Binding		0..1	code	Language of the resource content Binding: ?? (preferred): A human language. Additional Bindings Purpose ?? Max Binding
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		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		0..*	Resource	Contained, inline Resources
extension		0..*	Extension	Additional content defined by implementations		0..*	Extension	Additional content defined by implementations
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	S	0..*	Identifier	Định danh kết quả xử lý, bao gồm mã phản hồi gateway nếu có Slice: Unordered, Open by value:system	S	0..*	Identifier	Định danh kết quả xử lý, bao gồm mã phản hồi gateway nếu có Slice: Unordered, Open by value:system
status	?!SΣ	1..1	code	Trạng thái kết quả: active | cancelled | draft | entered-in-error Binding: ?? (required): A code specifying the state of the resource instance.	?!SΣ	1..1	code	Trạng thái kết quả: active | cancelled | draft | entered-in-error Binding: ?? (required): A code specifying the state of the resource instance.
type	SΣ	1..1	CodeableConcept	Loại: institutional (nội trú) | professional (ngoại trú) Binding: ?? (extensible): The type or discipline-style of the claim.	SΣ	1..1	CodeableConcept	Loại: institutional (nội trú) | professional (ngoại trú) Binding: ?? (extensible): The type or discipline-style of the claim.
subType		0..1	CodeableConcept	More granular claim type Binding: ?? (example): A more granular claim typecode.		0..1	CodeableConcept	More granular claim type Binding: ?? (example): A more granular claim typecode.
use	SΣ	1..1	code	Mục đích: claim | preauthorization | predetermination Binding: ?? (required): Claim, preauthorization, predetermination.	SΣ	1..1	code	Mục đích: claim | preauthorization | predetermination Binding: ?? (required): Claim, preauthorization, predetermination.
patient	SΣ	1..1	Reference(Bệnh nhân VN Core — VN Core Patient Profile)	Bệnh nhân	SΣ	1..1	Reference(Bệnh nhân VN Core — VN Core Patient Profile)	Bệnh nhân
created	SΣ	1..1	dateTime	Ngày tạo kết quả	SΣ	1..1	dateTime	Ngày tạo kết quả
insurer	SΣ	1..1	Reference(Cơ sở y tế VN Core — VN Core Organization Profile)	Cơ quan BHXH giải quyết	SΣ	1..1	Reference(Cơ sở y tế VN Core — VN Core Organization Profile)	Cơ quan BHXH giải quyết
requestor		0..1	Reference(Practitioner | PractitionerRole | Organization)	Party responsible for the claim		0..1	Reference(Practitioner | PractitionerRole | Organization)	Party responsible for the claim
request	SΣ	0..1	Reference(Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile)	Yêu cầu thanh toán gốc (VNCoreClaim)	SΣ	0..1	Reference(Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile)	Yêu cầu thanh toán gốc (VNCoreClaim)
outcome	SΣ	1..1	code	Kết quả: queued | complete | error | partial Binding: ?? (required): The result of the claim processing.	SΣ	1..1	code	Kết quả: queued | complete | error | partial Binding: ?? (required): The result of the claim processing.
disposition		0..1	string	Disposition Message		0..1	string	Disposition Message
preAuthRef		0..1	string	Preauthorization reference		0..1	string	Preauthorization reference
preAuthPeriod		0..1	Period	Preauthorization reference effective period		0..1	Period	Preauthorization reference effective period
payeeType		0..1	CodeableConcept	Party to be paid any benefits payable Binding: ?? (example): A code for the party to be reimbursed.		0..1	CodeableConcept	Party to be paid any benefits payable Binding: ?? (example): A code for the party to be reimbursed.
item	S	0..*	BackboneElement	Kết quả từng dòng chi phí	S	0..*	BackboneElement	Kết quả từng dòng chi phí
id		0..1	string	Unique id for inter-element referencing		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
itemSequence	S	1..1	positiveInt	Claim item instance identifier	S	1..1	positiveInt	Claim item instance identifier
noteNumber		0..*	positiveInt	Applicable note numbers		0..*	positiveInt	Applicable note numbers
adjudication	S	1..*	BackboneElement	Phân bổ chi phí: đề nghị, đủ ĐK, cùng chi trả, BHYT thanh toán	S	1..*	BackboneElement	Phân bổ chi phí: đề nghị, đủ ĐK, cùng chi trả, BHYT thanh toán
id		0..1	string	Unique id for inter-element referencing		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
category	S	1..1	CodeableConcept	Loại: submitted | eligible | copay | benefit Binding: ?? (extensible)	S	1..1	CodeableConcept	Loại: submitted | eligible | copay | benefit Binding: ?? (extensible)
reason		0..1	CodeableConcept	Explanation of adjudication outcome Binding: ?? (example): The adjudication reason codes.		0..1	CodeableConcept	Explanation of adjudication outcome Binding: ?? (example): The adjudication reason codes.
amount	S	0..1	Money	Số tiền (VND)	S	0..1	Money	Số tiền (VND)
value		0..1	decimal	Non-monetary value		0..1	decimal	Non-monetary value
detail		0..*	BackboneElement	Adjudication for claim details		0..*	BackboneElement	Adjudication for claim details
id		0..1	string	Unique id for inter-element referencing		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
detailSequence		1..1	positiveInt	Claim detail instance identifier		1..1	positiveInt	Claim detail instance identifier
noteNumber		0..*	positiveInt	Applicable note numbers		0..*	positiveInt	Applicable note numbers
adjudication		1..*	See adjudication (ClaimResponse)	Detail level adjudication details		1..*	See adjudication (ClaimResponse)	Detail level adjudication details
subDetail		0..*	BackboneElement	Adjudication for claim sub-details		0..*	BackboneElement	Adjudication for claim sub-details
id		0..1	string	Unique id for inter-element referencing		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
subDetailSequence		1..1	positiveInt	Claim sub-detail instance identifier		1..1	positiveInt	Claim sub-detail instance identifier
noteNumber		0..*	positiveInt	Applicable note numbers		0..*	positiveInt	Applicable note numbers
adjudication		0..*	See adjudication (ClaimResponse)	Subdetail level adjudication details		0..*	See adjudication (ClaimResponse)	Subdetail level adjudication details
addItem		0..*	BackboneElement	Insurer added line items		0..*	BackboneElement	Insurer added line items
id		0..1	string	Unique id for inter-element referencing		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
itemSequence		0..*	positiveInt	Item sequence number		0..*	positiveInt	Item sequence number
detailSequence		0..*	positiveInt	Detail sequence number		0..*	positiveInt	Detail sequence number
subdetailSequence		0..*	positiveInt	Subdetail sequence number		0..*	positiveInt	Subdetail sequence number
provider		0..*	Reference(Practitioner | PractitionerRole | Organization)	Authorized providers		0..*	Reference(Practitioner | PractitionerRole | Organization)	Authorized providers
productOrService		1..1	CodeableConcept	Billing, service, product, or drug code Binding: ?? (example): Allowable service and product codes.		1..1	CodeableConcept	Billing, service, product, or drug code Binding: ?? (example): Allowable service and product codes.
modifier		0..*	CodeableConcept	Service/Product billing modifiers Binding: ?? (example): Item type or modifiers codes, eg for Oral whether the treatment is cosmetic or associated with TMJ, or an appliance was lost or stolen.		0..*	CodeableConcept	Service/Product billing modifiers Binding: ?? (example): Item type or modifiers codes, eg for Oral whether the treatment is cosmetic or associated with TMJ, or an appliance was lost or stolen.
programCode		0..*	CodeableConcept	Program the product or service is provided under Binding: ?? (example): Program specific reason codes.		0..*	CodeableConcept	Program the product or service is provided under Binding: ?? (example): Program specific reason codes.
serviced[x]		0..1	date, Period	Date or dates of service or product delivery		0..1	date, Period	Date or dates of service or product delivery
location[x]		0..1	CodeableConcept, Address, Reference(Location)	Place of service or where product was supplied Binding: ?? (example): Place of service: pharmacy, school, prison, etc.		0..1	CodeableConcept, Address, Reference(Location)	Place of service or where product was supplied Binding: ?? (example): Place of service: pharmacy, school, prison, etc.
quantity		0..1	??	Count of products or services		0..1	??	Count of products or services
unitPrice		0..1	Money	Fee, charge or cost per item		0..1	Money	Fee, charge or cost per item
factor		0..1	decimal	Price scaling factor		0..1	decimal	Price scaling factor
net		0..1	Money	Total item cost		0..1	Money	Total item cost
bodySite		0..1	CodeableConcept	Anatomical location Binding: ?? (example): The code for the teeth, quadrant, sextant and arch.		0..1	CodeableConcept	Anatomical location Binding: ?? (example): The code for the teeth, quadrant, sextant and arch.
subSite		0..*	CodeableConcept	Anatomical sub-location Binding: ?? (example): The code for the tooth surface and surface combinations.		0..*	CodeableConcept	Anatomical sub-location Binding: ?? (example): The code for the tooth surface and surface combinations.
noteNumber		0..*	positiveInt	Applicable note numbers		0..*	positiveInt	Applicable note numbers
adjudication		1..*	See adjudication (ClaimResponse)	Added items adjudication		1..*	See adjudication (ClaimResponse)	Added items adjudication
detail		0..*	BackboneElement	Insurer added line details		0..*	BackboneElement	Insurer added line details
id		0..1	string	Unique id for inter-element referencing		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
productOrService		1..1	CodeableConcept	Billing, service, product, or drug code Binding: ?? (example): Allowable service and product codes.		1..1	CodeableConcept	Billing, service, product, or drug code Binding: ?? (example): Allowable service and product codes.
modifier		0..*	CodeableConcept	Service/Product billing modifiers Binding: ?? (example): Item type or modifiers codes, eg for Oral whether the treatment is cosmetic or associated with TMJ, or an appliance was lost or stolen.		0..*	CodeableConcept	Service/Product billing modifiers Binding: ?? (example): Item type or modifiers codes, eg for Oral whether the treatment is cosmetic or associated with TMJ, or an appliance was lost or stolen.
quantity		0..1	??	Count of products or services		0..1	??	Count of products or services
unitPrice		0..1	Money	Fee, charge or cost per item		0..1	Money	Fee, charge or cost per item
factor		0..1	decimal	Price scaling factor		0..1	decimal	Price scaling factor
net		0..1	Money	Total item cost		0..1	Money	Total item cost
noteNumber		0..*	positiveInt	Applicable note numbers		0..*	positiveInt	Applicable note numbers
adjudication		1..*	See adjudication (ClaimResponse)	Added items detail adjudication		1..*	See adjudication (ClaimResponse)	Added items detail adjudication
subDetail		0..*	BackboneElement	Insurer added line items		0..*	BackboneElement	Insurer added line items
id		0..1	string	Unique id for inter-element referencing		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
productOrService		1..1	CodeableConcept	Billing, service, product, or drug code Binding: ?? (example): Allowable service and product codes.		1..1	CodeableConcept	Billing, service, product, or drug code Binding: ?? (example): Allowable service and product codes.
modifier		0..*	CodeableConcept	Service/Product billing modifiers Binding: ?? (example): Item type or modifiers codes, eg for Oral whether the treatment is cosmetic or associated with TMJ, or an appliance was lost or stolen.		0..*	CodeableConcept	Service/Product billing modifiers Binding: ?? (example): Item type or modifiers codes, eg for Oral whether the treatment is cosmetic or associated with TMJ, or an appliance was lost or stolen.
quantity		0..1	??	Count of products or services		0..1	??	Count of products or services
unitPrice		0..1	Money	Fee, charge or cost per item		0..1	Money	Fee, charge or cost per item
factor		0..1	decimal	Price scaling factor		0..1	decimal	Price scaling factor
net		0..1	Money	Total item cost		0..1	Money	Total item cost
noteNumber		0..*	positiveInt	Applicable note numbers		0..*	positiveInt	Applicable note numbers
adjudication		1..*	See adjudication (ClaimResponse)	Added items detail adjudication		1..*	See adjudication (ClaimResponse)	Added items detail adjudication
adjudication		0..*	See adjudication (ClaimResponse)	Header-level adjudication		0..*	See adjudication (ClaimResponse)	Header-level adjudication
total	SΣ	0..*	BackboneElement	Tổng adjudication	SΣ	0..*	BackboneElement	Tổng adjudication
id		0..1	string	Unique id for inter-element referencing		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
category	SΣ	1..1	CodeableConcept	Loại tổng: submitted | eligible | copay | benefit hoặc category BHYT cục bộ Binding: ?? (extensible)	SΣ	1..1	CodeableConcept	Loại tổng: submitted | eligible | copay | benefit hoặc category BHYT cục bộ Binding: ?? (extensible)
amount	SΣ	1..1	Money	Financial total for the category	SΣ	1..1	Money	Financial total for the category
payment		0..1	BackboneElement	Thông tin thanh toán		0..1	BackboneElement	Thông tin thanh toán
id		0..1	string	Unique id for inter-element referencing		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
type		1..1	CodeableConcept	Partial or complete payment Binding: ?? (example): The type (partial, complete) of the payment.		1..1	CodeableConcept	Partial or complete payment Binding: ?? (example): The type (partial, complete) of the payment.
adjustment		0..1	Money	Payment adjustment for non-claim issues		0..1	Money	Payment adjustment for non-claim issues
adjustmentReason		0..1	CodeableConcept	Explanation for the adjustment Binding: ?? (example): Payment Adjustment reason codes.		0..1	CodeableConcept	Explanation for the adjustment Binding: ?? (example): Payment Adjustment reason codes.
date		0..1	date	Expected date of payment		0..1	date	Expected date of payment
amount		1..1	Money	Số tiền BHXH thanh toán		1..1	Money	Số tiền BHXH thanh toán
identifier		0..1	Identifier	Business identifier for the payment		0..1	Identifier	Business identifier for the payment
fundsReserve		0..1	CodeableConcept	Funds reserved status Binding: ?? (example): For whom funds are to be reserved: (Patient, Provider, None).		0..1	CodeableConcept	Funds reserved status Binding: ?? (example): For whom funds are to be reserved: (Patient, Provider, None).
formCode		0..1	CodeableConcept	Printed form identifier Binding: ?? (example): The forms codes.		0..1	CodeableConcept	Printed form identifier Binding: ?? (example): The forms codes.
form		0..1	Attachment	Printed reference or actual form		0..1	Attachment	Printed reference or actual form
processNote		0..*	BackboneElement	Note concerning adjudication		0..*	BackboneElement	Note concerning adjudication
id		0..1	string	Unique id for inter-element referencing		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
number		0..1	positiveInt	Note instance identifier		0..1	positiveInt	Note instance identifier
type		0..1	code	display | print | printoper Binding: ?? (required): The presentation types of notes.		0..1	code	display | print | printoper Binding: ?? (required): The presentation types of notes.
text		1..1	string	Note explanatory text		1..1	string	Note explanatory text
language		0..1	CodeableConcept	Language of the text Binding: ?? (preferred): A human language. Additional Bindings Purpose ?? Max Binding		0..1	CodeableConcept	Language of the text Binding: ?? (preferred): A human language. Additional Bindings Purpose ?? Max Binding
communicationRequest		0..*	Reference(CommunicationRequest)	Request for additional information		0..*	Reference(CommunicationRequest)	Request for additional information
insurance		0..*	BackboneElement	Patient insurance information		0..*	BackboneElement	Patient insurance information
id		0..1	string	Unique id for inter-element referencing		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
sequence		1..1	positiveInt	Insurance instance identifier		1..1	positiveInt	Insurance instance identifier
focal		1..1	boolean	Coverage to be used for adjudication		1..1	boolean	Coverage to be used for adjudication
coverage		1..1	Reference(Coverage)	Insurance information		1..1	Reference(Coverage)	Insurance information
businessArrangement		0..1	string	Additional provider contract number		0..1	string	Additional provider contract number
claimResponse		0..1	Reference(ClaimResponse)	Adjudication results		0..1	Reference(ClaimResponse)	Adjudication results
error	S	0..*	BackboneElement	Nhóm issue giám định/từ chối hoặc yêu cầu điều chỉnh	S	0..*	BackboneElement	Nhóm issue giám định/từ chối hoặc yêu cầu điều chỉnh
id		0..1	string	Unique id for inter-element referencing		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
itemSequence	S	0..1	positiveInt	Dòng chi phí liên quan nếu có	S	0..1	positiveInt	Dòng chi phí liên quan nếu có
detailSequence		0..1	positiveInt	Detail sequence number		0..1	positiveInt	Detail sequence number
subDetailSequence		0..1	positiveInt	Subdetail sequence number		0..1	positiveInt	Subdetail sequence number
code	S	1..1	CodeableConcept	Nhóm issue/lý do BHYT Binding: ?? (extensible)	S	1..1	CodeableConcept	Nhóm issue/lý do BHYT Binding: ?? (extensible)
Documentation for this format