FHIR IG analytics
Resources that use this resource
Resources that this resource uses
Narrative
No narrative content found in resource
Source1
{
"resourceType": "StructureDefinition",
"id": "profile-claim-response-prior",
"url": "http://pharmacyeclaims.ca/FHIR/v1.0/StructureDefinition/profile-claim-response-prior",
"name": "COBPriorClaimResponse",
"title": "COB Prior Claim Response",
"status": "draft",
"description": "To convey the Prior Adjudication details, that will be shared with downstream adjudicators",
"purpose": "To convey the Prior Adjudication details, that will be shared with downstream adjudicators",
"fhirVersion": "4.0.1",
"kind": "resource",
"abstract": false,
"type": "ClaimResponse",
"baseDefinition": "http://hl7.org/fhir/StructureDefinition/ClaimResponse",
"derivation": "constraint",
"differential": {
"element": [
{
"id": "ClaimResponse",
"path": "ClaimResponse",
"comment": "Usage: This is used to convey the Prior Adjudication details, that will be shared with downstream adjudicators"
},
{
"id": "ClaimResponse.id",
"path": "ClaimResponse.id",
"mustSupport": true
},
{
"id": "ClaimResponse.meta",
"path": "ClaimResponse.meta",
"mustSupport": true
},
{
"id": "ClaimResponse.meta.profile",
"path": "ClaimResponse.meta.profile",
"comment": "Usage Note: This fixed value is useful to differentiate between the Claim Response profile and the prior calim response profile for validation purposes. \r\n\r\nIt is up to the server and/or other infrastructure of policy to determine whether/how these claims are verified and/or updated over time. The list of profile URLs is a set.",
"max": "1",
"fixedCanonical": "http://pharmacyeclaims.ca/FHIR/v1.0/StructureDefinition/profile-claim-response-prior",
"mustSupport": true
},
{
"id": "ClaimResponse.identifier",
"path": "ClaimResponse.identifier",
"slicing": {
"discriminator": [
{
"type": "value",
"path": "assigner.identifier.type.coding.system"
}
],
"rules": "open"
},
"comment": "Usage Note: This is an internal reference number assigned to each claim by the processor. As this is a prior claim response this is not required",
"max": "0"
},
{
"id": "ClaimResponse.status",
"path": "ClaimResponse.status",
"comment": "Usage Note: Reject claim responses may be included but are still considered active. Example: drug not covered may be included, but patient's coverage expired may not be sent\r\nCPHA Mapping: None\r\nThis element is labeled as a modifier because the status contains codes that mark the resource as not currently valid.",
"fixedCode": "active",
"mustSupport": true
},
{
"id": "ClaimResponse.type",
"path": "ClaimResponse.type",
"comment": "Usage: Value of \"pharmacy\" or \"professional\" to align with the claim type\r\n\r\nThis may contain the local bill type codes, for example the US UB-04 bill type code or the CMS bill type.",
"mustSupport": true
},
{
"id": "ClaimResponse.type.coding",
"path": "ClaimResponse.type.coding",
"mustSupport": true
},
{
"id": "ClaimResponse.type.text",
"path": "ClaimResponse.type.text",
"min": 1,
"fixedString": "pharmacy",
"mustSupport": true
},
{
"id": "ClaimResponse.subType",
"path": "ClaimResponse.subType",
"comment": "Conformance Rule: This will be used to convey the \"type\" of Claim/Claim Response in accordance with the Plan Type. Set value = \"public\" or \"private\", \"patientAssistedCard\" or \"unknown\".\r\nRationale: This value will be conveyed in downstream claim requests (eg secondary, tertiary), as part of the Prior Claim Response to assist in proper coordination of benefits. This will be mapped from prior claim responses\r\nCPHA Map: None: This is a new data element\r\nThis may contain the local bill type codes, for example the US UB-04 bill type code or the CMS bill type.",
"min": 1,
"mustSupport": true,
"binding": {
"strength": "example",
"valueSet": "http://pharmacyeclaims.ca/FHIR/CodeSystem/coverage-type"
}
},
{
"id": "ClaimResponse.subType.coding",
"path": "ClaimResponse.subType.coding",
"min": 1,
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.subType.coding.system",
"path": "ClaimResponse.subType.coding.system",
"comment": "Usage: Set value = http://pharmacyeclaims.ca/FHIR/CodeSystem/coverage-type\r\n\r\nThe URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should reference to some definition that establishes the system clearly and unambiguously.",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.subType.coding.code",
"path": "ClaimResponse.subType.coding.code",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.use",
"path": "ClaimResponse.use",
"fixedCode": "claim",
"mustSupport": true
},
{
"id": "ClaimResponse.patient",
"path": "ClaimResponse.patient",
"comment": "Usage Note: The same resource from the request may be included here or just an identifier included\r\nCPHA Mapping: None\r\n\r\nReferences SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.",
"type": [
{
"code": "Reference",
"targetProfile": [
"http://hl7.org/fhir/StructureDefinition/Patient",
"http://pharmacyeclaims.ca/FHIR/v1.0/StructureDefinition/profile-patient"
]
}
],
"mustSupport": true
},
{
"id": "ClaimResponse.patient.reference",
"path": "ClaimResponse.patient.reference",
"mustSupport": true
},
{
"id": "ClaimResponse.created",
"path": "ClaimResponse.created",
"comment": "CPHA Mapping: Adjudication Date E.01.03",
"mustSupport": true
},
{
"id": "ClaimResponse.insurer",
"path": "ClaimResponse.insurer",
"comment": "Usage Note: This may be considered as private in prior adjudication results; howver as this is a mandatory element a display value of \"unavailable\" may be used. \r\nReferences SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.",
"mustSupport": true
},
{
"id": "ClaimResponse.insurer.identifier",
"path": "ClaimResponse.insurer.identifier",
"comment": "Usage Note: Where the insurer identifier may be shared with downstream adjudicators, this may be included. Otherwise the display (\"unavailable) must be present.\r\n\r\nWhen an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy. \n\nWhen both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference\n\nApplications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.\n\nReference is intended to point to a structure that can potentially be expressed as a FHIR resource, though there is no need for it to exist as an actual FHIR resource instance - except in as much as an application wishes to actual find the target of the reference. The content referred to be the identifier must meet the logical constraints implied by any limitations on what resource types are permitted for the reference. For example, it would not be legitimate to send the identifier for a drug prescription if the type were Reference(Observation|DiagnosticReport). One of the use-cases for Reference.identifier is the situation where no FHIR representation exists (where the type is Reference (Any).",
"mustSupport": true
},
{
"id": "ClaimResponse.insurer.identifier.system",
"path": "ClaimResponse.insurer.identifier.system",
"min": 1,
"fixedUri": "http://pharmacyeclaims.ca/FHIR/CPHA-identifier/IIN",
"mustSupport": true
},
{
"id": "ClaimResponse.insurer.identifier.value",
"path": "ClaimResponse.insurer.identifier.value",
"comment": "CPHA Mapping: IIN ( Issuer Identification Number) A.01.01\r\n\r\nIf 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](extension-rendered-value.html). 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.",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.insurer.display",
"path": "ClaimResponse.insurer.display",
"mustSupport": true
},
{
"id": "ClaimResponse.request",
"path": "ClaimResponse.request",
"comment": "Usage Note: This field is limited to a single identifier. The number assigned, by the provider, to the transaction to which this response applies. This must be present when conveying Prior Claim Intervention Codes (extension)\r\r\nCPHA Mapping: Trace Number B.23.03 (in display)\r\n\r\nReferences SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc.). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.request.extension:PriorClaimInterventionCodes",
"path": "ClaimResponse.request.extension",
"sliceName": "PriorClaimInterventionCodes",
"definition": "Intervention codes from a prior claim",
"comment": "Usage Rule: For prior claims, this is the list of intervention codes contained in the prior claim. This is necessary as the prior adjudicator may support a different set of intervention codes as they use a different protocol (eg RAMQ, NeCST, CPHA3). The code system (assigning authority, which align to the protocol, eg RAMQ, NeCST) and the intervention/exception code. The display name associated with the code t is also recommended.",
"type": [
{
"code": "Extension",
"profile": [
"http://pharmacyeclaims.ca/FHIR/v1.0/StructureDefinition/ext-prior-intervention-codes"
]
}
],
"isModifier": false
},
{
"id": "ClaimResponse.request.identifier",
"path": "ClaimResponse.request.identifier",
"comment": "Usage Note: This will be the Claim.identifier (slice Claim-identifier) from the request message. As this is a prior claim response, this will only be used under certain conditions as established by the implementer.\r\n\r\nWhen an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy. \n\nWhen both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference\n\nApplications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.\n\nReference is intended to point to a structure that can potentially be expressed as a FHIR resource, though there is no need for it to exist as an actual FHIR resource instance - except in as much as an application wishes to actual find the target of the reference. The content referred to be the identifier must meet the logical constraints implied by any limitations on what resource types are permitted for the reference. For example, it would not be legitimate to send the identifier for a drug prescription if the type were Reference(Observation|DiagnosticReport). One of the use-cases for Reference.identifier is the situation where no FHIR representation exists (where the type is Reference (Any).",
"mustSupport": true
},
{
"id": "ClaimResponse.request.identifier.system",
"path": "ClaimResponse.request.identifier.system",
"min": 1,
"fixedUri": "http://pharmacyeclaims.ca/FHIR/CPHA-identifier/trace-number",
"mustSupport": true
},
{
"id": "ClaimResponse.request.identifier.value",
"path": "ClaimResponse.request.identifier.value",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.request.display",
"path": "ClaimResponse.request.display",
"comment": "Usage Note: This is limited to 6N in order to support backward compatibility to CPHA This will be the trace number from the Claim Request.identifier.value The number assigned, by the provider, to the transaction to which this response applies. This is limited to 6N, in order to maintain backward compatibility with CPHA. This is optional as the Trace number can be deprecated once all implementations natively support FHIR.\r\r\nCPHA Mapping: Trace Number B.23.03\r\n\r\nThis is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.",
"mustSupport": true
},
{
"id": "ClaimResponse.outcome",
"path": "ClaimResponse.outcome",
"comment": "Usage Note: This can be set to \"complete\" or \"error\" \r\nCPHA Map: E.05.03 Response Status The decision as set in the prior adjudication result. A value of \"A\" (accepted) or \"R\" rejected will be set in CPHA, which maps to \"complete\" or \"error\".\r\n\r\nThe 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).",
"mustSupport": true
},
{
"id": "ClaimResponse.disposition",
"path": "ClaimResponse.disposition",
"comment": "CPHA Map: Response Status E.05.03\r\nUsage: This indicates the status of the claim response or prior claim response and is crucial for downstream payors to understand the outcome of the adjudication. \r\n\r\nSet values = A or B or C, . as follows:\r\nA=accepted as transmitted - no adjustments\r\nB=accepted with Rx price adjustment\r\nR=rejected claim/reversal \r\n \r\nNote that FHIR strings SHALL NOT exceed 1MB in size",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.payeeType",
"path": "ClaimResponse.payeeType",
"comment": "Usage Rule: Determines who the adjudicator/insurer will issue payment to. Set value = \"subscriber\" or \"provider\". The pay subscriber option may be used if the network is down, and when the pharmacy has collected from the patient and is submitting on their behalf.\r\nUsage Note: This may not be present if the claim was rejected; otherwise this must be populated\r\nCPHA Mapping: Transaction code E,03,03. \r\nValue of \"provider\" maps to 51=response to a pay provider claim for real-time adjudication\r\nValue of \"subscriber\" maps to 54=response to a pay cardholder claim If value = subscriber, maps to CPHA \r\n\r\nNot all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination.",
"mustSupport": true
},
{
"id": "ClaimResponse.payeeType.coding",
"path": "ClaimResponse.payeeType.coding",
"min": 1,
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.payeeType.coding.system",
"path": "ClaimResponse.payeeType.coding.system",
"min": 1,
"fixedUri": "http://terminology.hl7.org/CodeSystem/payeetype",
"mustSupport": true
},
{
"id": "ClaimResponse.payeeType.coding.code",
"path": "ClaimResponse.payeeType.coding.code",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item",
"path": "ClaimResponse.item",
"comment": "Usage Note: Identifies the item submitted and the associated adjudication results. This is a sub-set of the claim response items returned.",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.itemSequence",
"path": "ClaimResponse.item.itemSequence",
"comment": "Usage Note: This is the claim.item.sequence from the request message. Currently, this will be a value of \"1\".\r\nCPHA Mapping: None\r\n\r\n32 bit number; for values larger than this, use decimal",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication",
"path": "ClaimResponse.item.adjudication",
"slicing": {
"discriminator": [
{
"type": "value",
"path": "category.coding.code"
}
],
"rules": "open"
},
"comment": "Usage Note: Only pertinent adjudication details for downstream payors should be included.",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication.category",
"path": "ClaimResponse.item.adjudication.category",
"comment": "Usage: This will indicate the type of adjudication, eg DrugCost, Cost Upcharge, etc. \r\nCPHA3: Used in field mapping\r\nFor example codes indicating: Co-Pay, deductible, eligible, benefit, tax, etc.",
"mustSupport": true,
"binding": {
"strength": "extensible"
}
},
{
"id": "ClaimResponse.item.adjudication.category.coding",
"path": "ClaimResponse.item.adjudication.category.coding",
"min": 1,
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication.category.coding.system",
"path": "ClaimResponse.item.adjudication.category.coding.system",
"fixedUri": "http://pharmacyeclaims.ca/FHIR/CodeSystem/adjudication-category-codes",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication.category.coding.code",
"path": "ClaimResponse.item.adjudication.category.coding.code",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication.category.coding.display",
"path": "ClaimResponse.item.adjudication.category.coding.display",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication.reason",
"path": "ClaimResponse.item.adjudication.reason",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication.amount",
"path": "ClaimResponse.item.adjudication.amount",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication.value",
"path": "ClaimResponse.item.adjudication.value",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:DrugCost",
"path": "ClaimResponse.item.adjudication",
"sliceName": "DrugCost",
"comment": "CPHA Map: E.08.03 Drug Cost/Product Value",
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:DrugCost.category",
"path": "ClaimResponse.item.adjudication.category",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:DrugCost.category.coding",
"path": "ClaimResponse.item.adjudication.category.coding",
"min": 1,
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:DrugCost.category.coding.code",
"path": "ClaimResponse.item.adjudication.category.coding.code",
"min": 1,
"fixedCode": "DrugCost",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:DrugCost.amount",
"path": "ClaimResponse.item.adjudication.amount",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:CostUpcharge",
"path": "ClaimResponse.item.adjudication",
"sliceName": "CostUpcharge",
"comment": "CPHA Map: E.09.03 Cost Upcharge",
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:CostUpcharge.category",
"path": "ClaimResponse.item.adjudication.category",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:CostUpcharge.category.coding",
"path": "ClaimResponse.item.adjudication.category.coding",
"min": 1,
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:CostUpcharge.category.coding.code",
"path": "ClaimResponse.item.adjudication.category.coding.code",
"min": 1,
"fixedCode": "Upcharge",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:CostUpcharge.amount",
"path": "ClaimResponse.item.adjudication.amount",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:GenericIncentive",
"path": "ClaimResponse.item.adjudication",
"sliceName": "GenericIncentive",
"comment": "Usage: No known use cases; this is only present for backward compatibility but not expected to be used.\r\nCPHA Map: E.10.03 Generic Incentive",
"max": "1"
},
{
"id": "ClaimResponse.item.adjudication:GenericIncentive.category",
"path": "ClaimResponse.item.adjudication.category",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:GenericIncentive.category.coding",
"path": "ClaimResponse.item.adjudication.category.coding",
"min": 1,
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:GenericIncentive.category.coding.code",
"path": "ClaimResponse.item.adjudication.category.coding.code",
"min": 1,
"fixedCode": "GenericIncentive",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:GenericIncentive.amount",
"path": "ClaimResponse.item.adjudication.amount",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ProfessionalFee",
"path": "ClaimResponse.item.adjudication",
"sliceName": "ProfessionalFee",
"comment": "CPHA: E.12.03 Professional Fee",
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ProfessionalFee.category",
"path": "ClaimResponse.item.adjudication.category",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ProfessionalFee.category.coding",
"path": "ClaimResponse.item.adjudication.category.coding",
"min": 1,
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ProfessionalFee.category.coding.code",
"path": "ClaimResponse.item.adjudication.category.coding.code",
"min": 1,
"fixedCode": "ProfFee",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ProfessionalFee.amount",
"path": "ClaimResponse.item.adjudication.amount",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:CompoundingCharge",
"path": "ClaimResponse.item.adjudication",
"sliceName": "CompoundingCharge",
"comment": "CPHA Map: E.13.03 Compounding Charge",
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:CompoundingCharge.category",
"path": "ClaimResponse.item.adjudication.category",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:CompoundingCharge.category.coding",
"path": "ClaimResponse.item.adjudication.category.coding",
"min": 1,
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:CompoundingCharge.category.coding.code",
"path": "ClaimResponse.item.adjudication.category.coding.code",
"min": 1,
"fixedCode": "CompoundingCharge",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:CompoundingCharge.amount",
"path": "ClaimResponse.item.adjudication.amount",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:SpecialServiceFee",
"path": "ClaimResponse.item.adjudication",
"sliceName": "SpecialServiceFee",
"comment": "CPHA Map: E.14.03 Special Services Fee",
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:SpecialServiceFee.category",
"path": "ClaimResponse.item.adjudication.category",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:SpecialServiceFee.category.coding",
"path": "ClaimResponse.item.adjudication.category.coding",
"min": 1,
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:SpecialServiceFee.category.coding.code",
"path": "ClaimResponse.item.adjudication.category.coding.code",
"min": 1,
"fixedCode": "SSF",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:SpecialServiceFee.amount",
"path": "ClaimResponse.item.adjudication.amount",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:CoPayToCollect",
"path": "ClaimResponse.item.adjudication",
"sliceName": "CoPayToCollect",
"comment": "Usage: The co pay amount which the provider collects from the beneficiary for a specific claim. This refers to \"co pay\" as defined in the carrier's benefit brochure.\r\nCPHA Map: Copay to Collect E.15.03 Optional D6",
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:CoPayToCollect.category",
"path": "ClaimResponse.item.adjudication.category",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:CoPayToCollect.category.coding",
"path": "ClaimResponse.item.adjudication.category.coding",
"min": 1,
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:CoPayToCollect.category.coding.code",
"path": "ClaimResponse.item.adjudication.category.coding.code",
"min": 1,
"fixedCode": "Co-Pay",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:CoPayToCollect.amount",
"path": "ClaimResponse.item.adjudication.amount",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:DeductibleToCollect",
"path": "ClaimResponse.item.adjudication",
"sliceName": "DeductibleToCollect",
"comment": "Usage: The deductible amount which the provider collects from the beneficiary for a specific claim. This refers to \"deductible\" as defined in the carrier's benefit brochure.\r\nCPHA Map: Deductible to Collect E.16.03 Optional D6",
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:DeductibleToCollect.category",
"path": "ClaimResponse.item.adjudication.category",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:DeductibleToCollect.category.coding",
"path": "ClaimResponse.item.adjudication.category.coding",
"min": 1,
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:DeductibleToCollect.category.coding.code",
"path": "ClaimResponse.item.adjudication.category.coding.code",
"min": 1,
"fixedCode": "Deductible",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:DeductibleToCollect.amount",
"path": "ClaimResponse.item.adjudication.amount",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:CoInsuranceToCollect",
"path": "ClaimResponse.item.adjudication",
"sliceName": "CoInsuranceToCollect",
"comment": "Usage: The co-insurance amount which the provider collects from the beneficiary for a specific claim. This refers to \"co-insurance\" as defined in the carrier's benefit brochure.\r\nCPHA Map: Co-Insurance to Collect E.17.03 Optional D6",
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:CoInsuranceToCollect.category",
"path": "ClaimResponse.item.adjudication.category",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:CoInsuranceToCollect.category.coding",
"path": "ClaimResponse.item.adjudication.category.coding",
"min": 1,
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:CoInsuranceToCollect.category.coding.code",
"path": "ClaimResponse.item.adjudication.category.coding.code",
"min": 1,
"fixedCode": "CoInsurance",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:CoInsuranceToCollect.amount",
"path": "ClaimResponse.item.adjudication.amount",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:SpecialAuthTotalQuantityDispenseAccumulated",
"path": "ClaimResponse.item.adjudication",
"sliceName": "SpecialAuthTotalQuantityDispenseAccumulated",
"comment": "Usage: Total Quantity Dispense Accumulated. The total number of pills \"adjudicated\" for a special auth number. An Adjudicator authorizes the number of pills against a special auth number; the dispenses may occur across several pharmacies. This accumulated total is returned as part of the adjudication result as informational data. \r\nUsage: Used in NFLD today and may be used by other provinces. \r\nCPHA Mapping: None; this is a new data element",
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:SpecialAuthTotalQuantityDispenseAccumulated.category",
"path": "ClaimResponse.item.adjudication.category",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:SpecialAuthTotalQuantityDispenseAccumulated.category.coding",
"path": "ClaimResponse.item.adjudication.category.coding",
"min": 1,
"max": "1",
"fixedCoding": {
"code": "SADispenseAccumulated"
},
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:SpecialAuthTotalQuantityDispenseAccumulated.value",
"path": "ClaimResponse.item.adjudication.value",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:SpecialAuthRemainingQuant",
"path": "ClaimResponse.item.adjudication",
"sliceName": "SpecialAuthRemainingQuant",
"comment": "Usage: Total special authorized quantity remaining on a prescription after this dispense (across all prescriptions). Recognizing that the quantity is relating to the unit and the strength of the product, this may also be specified. eg 10 tabs of 5mg strength is equivalent to 20 tabs and 2.5 mg. This will include the quantity and unit. \r\nRationale: The pharmacy does not currently have access to this data \r\nConformance Rule: The quantity remaining must be based upon the DIN strength in the claim request. \r\n\r\nUsage Note: . If there is no special authorization, this field will not be used. If the adjudicator is not currently returning this information, this may be left blank.",
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:SpecialAuthRemainingQuant.extension",
"path": "ClaimResponse.item.adjudication.extension",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:SpecialAuthRemainingQuant.extension:AuthQuantityUnitBasedOnStrength",
"path": "ClaimResponse.item.adjudication.extension",
"sliceName": "AuthQuantityUnitBasedOnStrength",
"comment": "Usage: Total special authorized quantity remaining on a prescription after this dispense (across all prescriptions). Recognizing that the quantity is relating to the unit and the strength of the product, this may also be specified. eg 10 tabs of 5mg strength is equivalent to 20 tabs and 2.5 mg. This will include the quantity and unit. \r\nRationale: The pharmacy does not currently have access to this data \r\nConformance Rule: The quantity remaining must be based upon the DIN strength in the claim request. \r\n\r\nThere 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.",
"min": 1,
"max": "1",
"type": [
{
"code": "Extension",
"profile": [
"http://pharmacyeclaims.ca/FHIR/v1.0/StructureDefinition/Ext-AuthQuantityBasedOnUnit"
]
}
],
"mustSupport": true,
"isModifier": false
},
{
"id": "ClaimResponse.item.adjudication:SpecialAuthRemainingQuant.category",
"path": "ClaimResponse.item.adjudication.category",
"fixedCodeableConcept": {
"coding": [
{
"code": "SARemainingQuantity"
}
]
},
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:SpecialAuthRemainingQuant.category.coding",
"path": "ClaimResponse.item.adjudication.category.coding",
"min": 1,
"max": "1",
"fixedCoding": {
"code": "SARemainingQuantity"
},
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:SpecialAuthRemainingQuant.value",
"path": "ClaimResponse.item.adjudication.value",
"comment": "Usage Note: The extension AuthQuantityUnitBasedOnStregth will include the value (quantity and unit) so this is not required.\r\n\r\nFor example: eligible percentage or co-payment percentage."
},
{
"id": "ClaimResponse.item.adjudication:SpecialAuthApprovedDaysSupply",
"path": "ClaimResponse.item.adjudication",
"sliceName": "SpecialAuthApprovedDaysSupply",
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:SpecialAuthApprovedDaysSupply.category",
"path": "ClaimResponse.item.adjudication.category",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:SpecialAuthApprovedDaysSupply.category.coding",
"path": "ClaimResponse.item.adjudication.category.coding",
"min": 1,
"max": "1",
"fixedCoding": {
"code": "SADaysSupply"
},
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:SpecialAuthApprovedDaysSupply.category.coding.code",
"path": "ClaimResponse.item.adjudication.category.coding.code",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:SpecialAuthApprovedDaysSupply.value",
"path": "ClaimResponse.item.adjudication.value",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:PertinentAdjudicationDetails",
"path": "ClaimResponse.item.adjudication",
"sliceName": "PertinentAdjudicationDetails",
"comment": "Usage Note: This field allows the first payor to pass on pertinent information to a secondary carrier. It allows for coding or textual data to be sent which may be useful as use cases evolve.\r\nConformance Rule: Only used by implementers with a specific use case, eg in BC today for BC does\r\nUsage Note: In BC, data is passed in a response code, which is then transposed into a downstream claim request in the special auth field. This field removes the requirement for the vendor to transposed the data. It is instead placed here. \r\nCPHA Mapping: None. Today, data is returned from the first payor in BC as a response code; this is then transposed into the request message for the secondary carrier.",
"max": "20",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:PertinentAdjudicationDetails.category",
"path": "ClaimResponse.item.adjudication.category",
"comment": "Usage Note: A coded value of \"BCCodes\" must be used for the existing use case. Other codes will be assigned as use cases evolve.",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:PertinentAdjudicationDetails.category.coding",
"path": "ClaimResponse.item.adjudication.category.coding",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:PertinentAdjudicationDetails.category.coding.code",
"path": "ClaimResponse.item.adjudication.category.coding.code",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:PertinentAdjudicationDetails.reason",
"path": "ClaimResponse.item.adjudication.reason",
"comment": "Usage Note: Adjudicators will used codes to convey the desired information. The codes will be determined by each implementer. Example: BC has existing codes that may be used.\r\n\r\nFor example may indicate that the funds for this benefit type have been exhausted.",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:PertinentAdjudicationDetails.reason.coding",
"path": "ClaimResponse.item.adjudication.reason.coding",
"min": 1,
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:PertinentAdjudicationDetails.reason.coding.code",
"path": "ClaimResponse.item.adjudication.reason.coding.code",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:PertinentAdjudicationDetails.amount",
"path": "ClaimResponse.item.adjudication.amount",
"mustSupport": false
},
{
"id": "ClaimResponse.item.adjudication:PertinentAdjudicationDetails.value",
"path": "ClaimResponse.item.adjudication.value",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ResponseCodes",
"path": "ClaimResponse.item.adjudication",
"sliceName": "ResponseCodes",
"comment": "Usage: To capture the response codes returned by the 1st /upstream payer. For example, if a drug where 1st payer in Quebec is returned as having been processed but 0$ paid, the error message is helpful to the secondary payor.\r\nUsage: These codes will be passed on to downstream payors.",
"max": "20",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ResponseCodes.category",
"path": "ClaimResponse.item.adjudication.category",
"comment": "Usage Note: Set value = \"ResponseCode\" In future, more granular categories may be defined.\r\n\r\nFor example codes indicating: Co-Pay, deductible, eligible, benefit, tax, DUR, etc.",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ResponseCodes.category.coding",
"path": "ClaimResponse.item.adjudication.category.coding",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ResponseCodes.category.coding.code",
"path": "ClaimResponse.item.adjudication.category.coding.code",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ResponseCodes.reason",
"path": "ClaimResponse.item.adjudication.reason",
"comment": "CPHA Map: Response Codes E.06.03 A/N10\r\nUsage Note: Codes to define responses that identify errors and other reasons that may cause the claim(s) to be altered or rejected. In CPHA, the Field length of 10 will accommodate 5 response codes per claim. In FHIR, this is a list with a practical maximum of 20 codes. Note: error codes may be moved out of the repsonse codes \r\n\r\nFor example may indicate that the funds for this benefit type have been exhausted.",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ResponseCodes.reason.coding",
"path": "ClaimResponse.item.adjudication.reason.coding",
"min": 1,
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ResponseCodes.reason.coding.system",
"path": "ClaimResponse.item.adjudication.reason.coding.system",
"comment": "Usage Note: Usage Note: This is recommended for use, but optional. All coding systems should be specified to identify the source system, including http://pharmacyeclaims.ca/FHIR/CodeSystem/CPHA3-response-codes. Other code systems, such as RAMQ and BC will also be supported. Refer to terminology section of this specification.\r\n\r\nUsage Note: This is not mandatory as it will only be required when code sets are not synchronized which may happen over time as codes become deprecated or new codes are added.\r\n\r\nThe URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should reference to some definition that establishes the system clearly and unambiguously.",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ResponseCodes.reason.coding.code",
"path": "ClaimResponse.item.adjudication.reason.coding.code",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ClinicalAlertCodes",
"path": "ClaimResponse.item.adjudication",
"sliceName": "ClinicalAlertCodes",
"max": "20",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ClinicalAlertCodes.category",
"path": "ClaimResponse.item.adjudication.category",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ClinicalAlertCodes.category.coding",
"path": "ClaimResponse.item.adjudication.category.coding",
"min": 1,
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ClinicalAlertCodes.category.coding.code",
"path": "ClaimResponse.item.adjudication.category.coding.code",
"min": 1,
"fixedCode": "ClinicalCode",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ClinicalAlertCodes.reason",
"path": "ClaimResponse.item.adjudication.reason",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ClinicalAlertCodes.reason.coding",
"path": "ClaimResponse.item.adjudication.reason.coding",
"min": 1,
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ClinicalAlertCodes.reason.coding.system",
"path": "ClaimResponse.item.adjudication.reason.coding.system",
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ClinicalAlertCodes.reason.coding.code",
"path": "ClaimResponse.item.adjudication.reason.coding.code",
"comment": "Usage: Alert Code\r\nNote that FHIR strings SHALL NOT exceed 1MB in size",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.item.adjudication:ClinicalAlertCodes.reason.text",
"path": "ClaimResponse.item.adjudication.reason.text",
"mustSupport": true
},
{
"id": "ClaimResponse.payment",
"path": "ClaimResponse.payment",
"comment": "Usage: The conveyes (in amount) the total amount payable, by the insurer, to the provider for product, services and taxes for a specific claim or to the patient. Refer to the payee type to understand who the payment was directed to. This includes all amounts in the \"ClaimResponse.item.adjudication\" section (eg DrugCostProductValue, CostUpcharge, GenericIncentive.. etc) less any amount paid by the beneficiary \r\nUsage: There is no size restriction on this dollar amount field",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.payment.type",
"path": "ClaimResponse.payment.type",
"comment": "CPHA Mapping: None. \r\nUsage: This amount must be derived. If the paid amount is less than submitted, value = \"partial\", else \"complete\"\r\n\r\nNot all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination.",
"mustSupport": true
},
{
"id": "ClaimResponse.payment.type.coding",
"path": "ClaimResponse.payment.type.coding",
"min": 1,
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.payment.type.coding.system",
"path": "ClaimResponse.payment.type.coding.system",
"comment": "Usage: This is a fixed value\r\nThe URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should reference to some definition that establishes the system clearly and unambiguously.",
"min": 1,
"fixedUri": "http://hl7.org/fhir/ValueSet/ex-paymenttype",
"mustSupport": true
},
{
"id": "ClaimResponse.payment.type.coding.code",
"path": "ClaimResponse.payment.type.coding.code",
"comment": "Usage: Set value = \"partial\" or \"complete\"\r\nNote that FHIR strings SHALL NOT exceed 1MB in size",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.payment.amount",
"path": "ClaimResponse.payment.amount",
"comment": "Usage: The total amount payable, by the insurer, to the provider or patient/insured party for product, services and taxes for a specific claim. This includes all amounts in the \"ClaimResponse.item.adjudication\" section (eg DrugCostProductValue, CostUpcharge, GenericIncentive.. etc) less any amount paid by the beneficiary.\r\nUsage: There is no size restriction on this dollar amount field\r\nCPHA Mapping: Plan Pays E.19.03 D6",
"mustSupport": true
},
{
"id": "ClaimResponse.payment.amount.value",
"path": "ClaimResponse.payment.amount.value",
"min": 1,
"mustSupport": true
},
{
"id": "ClaimResponse.processNote",
"path": "ClaimResponse.processNote",
"comment": "Usage: Detailed response information. Adjudicators to determine what if any process notes should be included for purposes of sharing with downstream adjudicators.\r\nConformance Rule: A maximum of 1000 characters may be returned for each note\r\nConformance Rule: A maximum of 10 notes can be returned; this allows for a given note to be returned in both english and french and therefore allows up to 20 instances. \r\nConformance Rule: Where possible adjudicators must return both english and french as this allows the vendor to display the note in the language of the user.\r\nConformance Rule: Vendors must co-relate french and english notes by assigning the same processNote.number\r\nConformance Rule: When the adjudicator does not know whether a note is french or english, the language.text must contain a value of \"unknown\".\r\n\r\nCPHA Map: Message Data Lines 1,2,3 E.20.03, E.21.03, E.22.03 A/N40",
"max": "20",
"mustSupport": true
},
{
"id": "ClaimResponse.processNote.number",
"path": "ClaimResponse.processNote.number",
"comment": "Usage Note: When an adjudicator returns the same note in both english and french, this number must be used to co-relate the notes. Vendors must co-relate french and english notes by assigning the same processNote.number\r\n\r\n32 bit number; for values larger than this, use decimal",
"mustSupport": true
},
{
"id": "ClaimResponse.processNote.type",
"path": "ClaimResponse.processNote.type",
"comment": "Usage Notes: Systems that natively support FHIR must support this\r\nCPHA Mapping: None\r\n\r\nNote that FHIR strings SHALL NOT exceed 1MB in size",
"mustSupport": true
},
{
"id": "ClaimResponse.processNote.text",
"path": "ClaimResponse.processNote.text",
"mustSupport": true
},
{
"id": "ClaimResponse.processNote.language",
"path": "ClaimResponse.processNote.language",
"comment": "Conformance Rule: This must be populated with a code of \"en\" for English or \"fr\" for French, OR, if unknown, do not use a code and instead populate the text value with \"unknown\". Where possible, both english and french messages should be included\r\nCPHA Mapping: None. New requirement\r\nOnly required if the language is different from the resource language.",
"min": 1,
"mustSupport": true,
"binding": {
"strength": "required",
"valueSet": "http://hl7.org/fhir/ValueSet/all-languages"
}
},
{
"id": "ClaimResponse.processNote.language.coding",
"path": "ClaimResponse.processNote.language.coding",
"comment": "Usage: Either system+ code must be present (for en and fr), or text must have a value of \"unknown\".\r\nCodes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labeled as UserSelected = true.",
"max": "1",
"mustSupport": true
},
{
"id": "ClaimResponse.processNote.language.coding.system",
"path": "ClaimResponse.processNote.language.coding.system",
"fixedUri": "urn:ietf:bcp:47",
"mustSupport": true
},
{
"id": "ClaimResponse.processNote.language.coding.code",
"path": "ClaimResponse.processNote.language.coding.code",
"mustSupport": true
},
{
"id": "ClaimResponse.processNote.language.text",
"path": "ClaimResponse.processNote.language.text",
"mustSupport": true
},
{
"id": "ClaimResponse.insurance",
"path": "ClaimResponse.insurance",
"comment": "Usage Note: When used in a claim response, this is not required as this resource is referenced through the coverage resource in the primary claim response. When used in a downstream laim request, this is also referenced through the coverage details in the request. \r\n\r\nAll 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.",
"max": "0"
}
]
}
}