FHIR © HL7.org  |  Server Home  |  XIG Home  |  Server Source  |  FHIR  

FHIR IG Statistics: StructureDefinition/Cost

Packagehl7.fhir.uv.omop
TypeStructureDefinition
IdCost
FHIR VersionR5
Sourcehttp://hl7.org/fhir/uv/omop/https://build.fhir.org/ig/HL7/fhir-omop-ig/StructureDefinition-Cost.html
URLhttp://hl7.org/fhir/uv/omop/StructureDefinition/Cost
Version1.0.0-ballot
Statusactive
Date2025-07-22T19:48:02+00:00
NameCost
TitleCost OMOP Table
Realmuv
Authorityhl7
DescriptionThe COST table captures records containing the cost of any medical event recorded in one of the OMOP clinical event tables such as DRUG_EXPOSURE, PROCEDURE_OCCURRENCE, VISIT_OCCURRENCE, VISIT_DETAIL, DEVICE_OCCURRENCE, OBSERVATION or MEASUREMENT. Each record in the cost table account for the amount of money transacted for the clinical event. So, the COST table may be used to represent both receivables (charges) and payments (paid), each transaction type represented by its COST_CONCEPT_ID. The COST_TYPE_CONCEPT_ID field will use concepts in the Standardized Vocabularies to designate the source (provenance) of the cost data. A reference to the health plan information in the PAYER_PLAN_PERIOD table is stored in the record for information used for the adjudication system to determine the persons benefit for the clinical event.
Typehttp://hl7.org/fhir/uv/omop/StructureDefinition/Cost
Kindlogical

Resources that use this resource

No resources found


Resources that this resource uses

StructureDefinition
PayerPlanPeriodPayer Plan Period OMOP Table

Narrative

Note: links and images are rebased to the (stated) source

Generated Narrative: StructureDefinition Cost

NameFlagsCard.TypeDescription & Constraintsdoco
.. Cost 0..*BaseCost OMOP Table
Instances of this logical model can be the target of a Reference
... cost_id 1..1codeCost Identifier
... cost_event_id 1..1integerCost Event Identifier
... cost_domain_id 1..1stringCost Domain Identifier
... cost_type_concept_id 1..1codeCost Type
... currency_concept_id 0..1codeCurrency
... total_charge 0..1integerTotal Charge
... total_cost 0..1integerTotal Cost
... total_paid 0..1integerTotal Paid
... paid_by_payer 0..1integerPaid by Payer
... paid_by_patient 0..1integerPaid by Patient
... paid_patient_copay 0..1integerPaid Patient Copay
... paid_patient_coinsurance 0..1integerPaid Patient Coinsurance
... paid_patient_deductible 0..1integerPaid Patient Deductible
... paid_by_primary 0..1integerPaid by Primary
... paid_ingredient_cost 0..1integerPaid Ingredent Cost
... paid_dispensing_fee 0..1integerPaid Dispensing Fee
... payer_plan_period_id 0..1Reference(Payer Plan Period OMOP Table)Payer Plan Period
... amount_allowed 0..1integerAmount Allowed
... revenue_code_concept_id 0..1codeRevenue Code
... revenue_code_source_value 0..1stringRevenue Code Source Value
... drg_concept_id 0..1integerDiagnosis Related Groups
... drg_source_value 0..1stringDiagnosis Related Groups Source Value

doco Documentation for this format

Source

{
  "resourceType": "StructureDefinition",
  "id": "Cost",
  "text": {
    "status": "extensions",
    "div": "<!-- snip (see above) -->"
  },
  "extension": [
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-type-characteristics",
      "valueCode": "can-be-target"
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
      "valueCode": "brr"
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
      "valueInteger": 1,
      "_valueInteger": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical": "http://hl7.org/fhir/uv/omop/ImplementationGuide/hl7.fhir.uv.omop"
          }
        ]
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
      "valueCode": "informative",
      "_valueCode": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical": "http://hl7.org/fhir/uv/omop/ImplementationGuide/hl7.fhir.uv.omop"
          }
        ]
      }
    }
  ],
  "url": "http://hl7.org/fhir/uv/omop/StructureDefinition/Cost",
  "version": "1.0.0-ballot",
  "name": "Cost",
  "title": "Cost OMOP Table",
  "status": "active",
  "date": "2025-07-22T19:48:02+00:00",
  "publisher": "HL7 International / Biomedical Research and Regulation",
  "contact": [
    {
      "name": "HL7 International / Biomedical Research and Regulation",
      "telecom": [
        {
          "system": "url",
          "value": "http://www.hl7.org/Special/committees/rcrim"
        }
      ]
    }
  ],
  "description": "The COST table captures records containing the cost of any medical event recorded in one of the OMOP clinical event tables such as DRUG_EXPOSURE, PROCEDURE_OCCURRENCE, VISIT_OCCURRENCE, VISIT_DETAIL, DEVICE_OCCURRENCE, OBSERVATION or MEASUREMENT.\n\nEach record in the cost table account for the amount of money transacted for the clinical event. So, the COST table may be used to represent both receivables (charges) and payments (paid), each transaction type represented by its COST_CONCEPT_ID. The COST_TYPE_CONCEPT_ID field will use concepts in the Standardized Vocabularies to designate the source (provenance) of the cost data. A reference to the health plan information in the PAYER_PLAN_PERIOD table is stored in the record for information used for the adjudication system to determine the persons benefit for the clinical event.",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "http://unstats.un.org/unsd/methods/m49/m49.htm",
          "code": "001",
          "display": "World"
        }
      ]
    }
  ],
  "fhirVersion": "5.0.0",
  "mapping": [
    {
      "identity": "rim",
      "uri": "http://hl7.org/v3",
      "name": "RIM Mapping"
    }
  ],
  "kind": "logical",
  "abstract": false,
  "type": "http://hl7.org/fhir/uv/omop/StructureDefinition/Cost",
  "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Base",
  "derivation": "specialization",
  "snapshot": {
    "extension": [
      {
        "url": "http://hl7.org/fhir/tools/StructureDefinition/snapshot-base-version",
        "valueString": "5.0.0"
      }
    ],
    "element": [
      {
        "id": "Cost",
        "path": "Cost",
        "short": "Cost OMOP Table",
        "definition": "The COST table captures records containing the cost of any medical event recorded in one of the OMOP clinical event tables such as DRUG_EXPOSURE, PROCEDURE_OCCURRENCE, VISIT_OCCURRENCE, VISIT_DETAIL, DEVICE_OCCURRENCE, OBSERVATION or MEASUREMENT.\n\nEach record in the cost table account for the amount of money transacted for the clinical event. So, the COST table may be used to represent both receivables (charges) and payments (paid), each transaction type represented by its COST_CONCEPT_ID. The COST_TYPE_CONCEPT_ID field will use concepts in the Standardized Vocabularies to designate the source (provenance) of the cost data. A reference to the health plan information in the PAYER_PLAN_PERIOD table is stored in the record for information used for the adjudication system to determine the persons benefit for the clinical event.",
        "min": 0,
        "max": "*",
        "base": {
          "path": "Base",
          "min": 0,
          "max": "*"
        },
        "isModifier": false,
        "mapping": [
          {
            "identity": "rim",
            "map": "n/a"
          }
        ]
      },
      {
        "id": "Cost.cost-id",
        "path": "Cost.cost_id",
        "short": "Cost Identifier",
        "definition": "Cost Identifier",
        "min": 1,
        "max": "1",
        "base": {
          "path": "Cost.cost_id",
          "min": 1,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ]
      },
      {
        "id": "Cost.cost-event-id",
        "path": "Cost.cost_event_id",
        "short": "Cost Event Identifier",
        "definition": "Cost Event Identifier",
        "min": 1,
        "max": "1",
        "base": {
          "path": "Cost.cost_event_id",
          "min": 1,
          "max": "1"
        },
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.cost-domain-id",
        "path": "Cost.cost_domain_id",
        "short": "Cost Domain Identifier",
        "definition": "Cost Domain Identifier",
        "min": 1,
        "max": "1",
        "base": {
          "path": "Cost.cost_domain_id",
          "min": 1,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ]
      },
      {
        "id": "Cost.cost-type-concept-id",
        "path": "Cost.cost_type_concept_id",
        "short": "Cost Type",
        "definition": "Cost Type",
        "min": 1,
        "max": "1",
        "base": {
          "path": "Cost.cost_type_concept_id",
          "min": 1,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ]
      },
      {
        "id": "Cost.currency-concept-id",
        "path": "Cost.currency_concept_id",
        "short": "Currency",
        "definition": "Currency",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Cost.currency_concept_id",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ]
      },
      {
        "id": "Cost.total-charge",
        "path": "Cost.total_charge",
        "short": "Total Charge",
        "definition": "Total Charge",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Cost.total_charge",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.total-cost",
        "path": "Cost.total_cost",
        "short": "Total Cost",
        "definition": "Total Cost",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Cost.total_cost",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.total-paid",
        "path": "Cost.total_paid",
        "short": "Total Paid",
        "definition": "Total Paid",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Cost.total_paid",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.paid-by-payer",
        "path": "Cost.paid_by_payer",
        "short": "Paid by Payer",
        "definition": "Paid by Payer",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Cost.paid_by_payer",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.paid-by-patient",
        "path": "Cost.paid_by_patient",
        "short": "Paid by Patient",
        "definition": "Paid by Patient",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Cost.paid_by_patient",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.paid-patient-copay",
        "path": "Cost.paid_patient_copay",
        "short": "Paid Patient Copay",
        "definition": "Paid Patient Copay",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Cost.paid_patient_copay",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.paid-patient-coinsurance",
        "path": "Cost.paid_patient_coinsurance",
        "short": "Paid Patient Coinsurance",
        "definition": "Paid Patient Coinsurance",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Cost.paid_patient_coinsurance",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.paid-patient-deductible",
        "path": "Cost.paid_patient_deductible",
        "short": "Paid Patient Deductible",
        "definition": "Paid Patient Deductible",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Cost.paid_patient_deductible",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.paid-by-primary",
        "path": "Cost.paid_by_primary",
        "short": "Paid by Primary",
        "definition": "Paid by Primary",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Cost.paid_by_primary",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.paid-ingredient-cost",
        "path": "Cost.paid_ingredient_cost",
        "short": "Paid Ingredent Cost",
        "definition": "Paid Ingredent Cost",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Cost.paid_ingredient_cost",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.paid-dispensing-fee",
        "path": "Cost.paid_dispensing_fee",
        "short": "Paid Dispensing Fee",
        "definition": "Paid Dispensing Fee",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Cost.paid_dispensing_fee",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.payer-plan-period-id",
        "path": "Cost.payer_plan_period_id",
        "short": "Payer Plan Period",
        "definition": "Payer Plan Period",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Cost.payer_plan_period_id",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "Reference",
            "targetProfile": [
              "http://hl7.org/fhir/uv/omop/StructureDefinition/PayerPlanPeriod"
            ]
          }
        ]
      },
      {
        "id": "Cost.amount-allowed",
        "path": "Cost.amount_allowed",
        "short": "Amount Allowed",
        "definition": "Amount Allowed",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Cost.amount_allowed",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.revenue-code-concept-id",
        "path": "Cost.revenue_code_concept_id",
        "short": "Revenue Code",
        "definition": "Revenue Code",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Cost.revenue_code_concept_id",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ]
      },
      {
        "id": "Cost.revenue-code-source-value",
        "path": "Cost.revenue_code_source_value",
        "short": "Revenue Code Source Value",
        "definition": "Revenue codes are a method to charge for a class of procedures and conditions in the U.S. hospital system.",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Cost.revenue_code_source_value",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ]
      },
      {
        "id": "Cost.drg-concept-id",
        "path": "Cost.drg_concept_id",
        "short": "Diagnosis Related Groups",
        "definition": "Diagnosis Related Groups",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Cost.drg_concept_id",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.drg-source-value",
        "path": "Cost.drg_source_value",
        "short": "Diagnosis Related Groups Source Value",
        "definition": "Diagnosis Related Groups are US codes used to classify hospital cases into one of approximately 500 groups.",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Cost.drg_source_value",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ]
      }
    ]
  },
  "differential": {
    "element": [
      {
        "id": "Cost",
        "path": "Cost",
        "short": "Cost OMOP Table",
        "definition": "The COST table captures records containing the cost of any medical event recorded in one of the OMOP clinical event tables such as DRUG_EXPOSURE, PROCEDURE_OCCURRENCE, VISIT_OCCURRENCE, VISIT_DETAIL, DEVICE_OCCURRENCE, OBSERVATION or MEASUREMENT.\n\nEach record in the cost table account for the amount of money transacted for the clinical event. So, the COST table may be used to represent both receivables (charges) and payments (paid), each transaction type represented by its COST_CONCEPT_ID. The COST_TYPE_CONCEPT_ID field will use concepts in the Standardized Vocabularies to designate the source (provenance) of the cost data. A reference to the health plan information in the PAYER_PLAN_PERIOD table is stored in the record for information used for the adjudication system to determine the persons benefit for the clinical event."
      },
      {
        "id": "Cost.cost-id",
        "path": "Cost.cost_id",
        "short": "Cost Identifier",
        "definition": "Cost Identifier",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ]
      },
      {
        "id": "Cost.cost-event-id",
        "path": "Cost.cost_event_id",
        "short": "Cost Event Identifier",
        "definition": "Cost Event Identifier",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.cost-domain-id",
        "path": "Cost.cost_domain_id",
        "short": "Cost Domain Identifier",
        "definition": "Cost Domain Identifier",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ]
      },
      {
        "id": "Cost.cost-type-concept-id",
        "path": "Cost.cost_type_concept_id",
        "short": "Cost Type",
        "definition": "Cost Type",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ]
      },
      {
        "id": "Cost.currency-concept-id",
        "path": "Cost.currency_concept_id",
        "short": "Currency",
        "definition": "Currency",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ]
      },
      {
        "id": "Cost.total-charge",
        "path": "Cost.total_charge",
        "short": "Total Charge",
        "definition": "Total Charge",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.total-cost",
        "path": "Cost.total_cost",
        "short": "Total Cost",
        "definition": "Total Cost",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.total-paid",
        "path": "Cost.total_paid",
        "short": "Total Paid",
        "definition": "Total Paid",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.paid-by-payer",
        "path": "Cost.paid_by_payer",
        "short": "Paid by Payer",
        "definition": "Paid by Payer",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.paid-by-patient",
        "path": "Cost.paid_by_patient",
        "short": "Paid by Patient",
        "definition": "Paid by Patient",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.paid-patient-copay",
        "path": "Cost.paid_patient_copay",
        "short": "Paid Patient Copay",
        "definition": "Paid Patient Copay",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.paid-patient-coinsurance",
        "path": "Cost.paid_patient_coinsurance",
        "short": "Paid Patient Coinsurance",
        "definition": "Paid Patient Coinsurance",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.paid-patient-deductible",
        "path": "Cost.paid_patient_deductible",
        "short": "Paid Patient Deductible",
        "definition": "Paid Patient Deductible",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.paid-by-primary",
        "path": "Cost.paid_by_primary",
        "short": "Paid by Primary",
        "definition": "Paid by Primary",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.paid-ingredient-cost",
        "path": "Cost.paid_ingredient_cost",
        "short": "Paid Ingredent Cost",
        "definition": "Paid Ingredent Cost",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.paid-dispensing-fee",
        "path": "Cost.paid_dispensing_fee",
        "short": "Paid Dispensing Fee",
        "definition": "Paid Dispensing Fee",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.payer-plan-period-id",
        "path": "Cost.payer_plan_period_id",
        "short": "Payer Plan Period",
        "definition": "Payer Plan Period",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "Reference",
            "targetProfile": [
              "http://hl7.org/fhir/uv/omop/StructureDefinition/PayerPlanPeriod"
            ]
          }
        ]
      },
      {
        "id": "Cost.amount-allowed",
        "path": "Cost.amount_allowed",
        "short": "Amount Allowed",
        "definition": "Amount Allowed",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.revenue-code-concept-id",
        "path": "Cost.revenue_code_concept_id",
        "short": "Revenue Code",
        "definition": "Revenue Code",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ]
      },
      {
        "id": "Cost.revenue-code-source-value",
        "path": "Cost.revenue_code_source_value",
        "short": "Revenue Code Source Value",
        "definition": "Revenue codes are a method to charge for a class of procedures and conditions in the U.S. hospital system.",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ]
      },
      {
        "id": "Cost.drg-concept-id",
        "path": "Cost.drg_concept_id",
        "short": "Diagnosis Related Groups",
        "definition": "Diagnosis Related Groups",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "integer"
          }
        ]
      },
      {
        "id": "Cost.drg-source-value",
        "path": "Cost.drg_source_value",
        "short": "Diagnosis Related Groups Source Value",
        "definition": "Diagnosis Related Groups are US codes used to classify hospital cases into one of approximately 500 groups.",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ]
      }
    ]
  }
}