Skip to main content

Charge Item Definition

Summary

The ChargeItemDefinition in CARE specifies how clinical activities (like lab tests or medications) are priced. It allows each ActivityDefinition, Medication, or other healthcare service to be tied to a dynamic billing rule that governs how much a service costs under specific conditions.

CARE’s billing model works behind the scenes: as practitioners record data (ServiceRequests, MedicationRequests, etc.), billing objects are automatically created using the relevant ChargeItemDefinition.

Core Relationships

Related ResourcePurpose
ActivityDefinitionResource whose execution will generate this charge
MedicationMedication product that incurs a cost
Encounter, PatientUsed in condition evaluation for dynamic pricing

Supported Fields

Field NameDescriptionExample
titleName for human readability"CBC Test Standard Rate"
slugUnique internal reference"cbc-charge"
derivedFromUriCanonical URL reference if derived from standard"http://example.org/rates/cbc"
statusLifecycle status (draft, active, etc.)"active"
facilityThe facility where this pricing appliesFacility/medicity
descriptionFree-text description of the charge definition"Pricing for CBC including lab work"
purposeRationale for the charge"Used to generate automated bills"
codeInternal or external billing/product code"CBC01"
instance[]List of linked resources (ActivityDefinition, Medication)[ActivityDefinition/cbc]
propertyGroup[]Array of pricing conditions and breakdownsSee below
baseprice[]Base Charge for a lab testSee below
discounts[]Price reduction applied to the base amount before taxSee below
taxes[]Applicable government taxesSee below

### Billing Workflow in CARE

1. Practitioner creates a `ServiceRequest` for CBC.
2. The system checks the associated `ActivityDefinition` and its linked `ChargeItemDefinition`.
3. Based on patient and encounter details (age, location, tags), applicable pricing rules are evaluated.
4. A **charge item is instantiated** and added to the patient’s bill automatically.
5. Taxes and discounts are computed, total is stored with a detailed breakdown.