collabreefhirdocumentation - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Medication Catalog

Collabree Medication Catalog Documentation

Profile Definition: MedicationProfile

Overview

The CollabreeMedication profile supports medications from different countries and catalogs within the Collabree system. The medication catalog app downloads different data depending on the provider.

Profile Structure

The CollabreeMedication profile includes:

Common Attributes (All Medications)

• Identifiers:
  • country-code: Identifies the country (CH, SA)
  • data-provider-id: Identifies the data source (HCI, CHI_GOV_SAUDI_ARABIA)
  • gtin: Global Trade Item Number (optional)
• Extensions:
  • medication-expiration-in-months: Medication shelf life
  • medication-image-url: Visual representation of medication packaging
• Code: SNOMED CT medication code with translations

HCI Data Provider Attributes (Optional)

• Amount: Package quantity information (e.g., "20 tablets per package")
• Multilingual Support: German and French translations

CHI_GOV_SAUDI_ARABIA Data Provider Attributes (Optional)

• Form: Administrable dose form (tablet, capsule, etc.)
• Ingredient: Detailed ingredient information with strength
• Arabic Terminology: Arabic display names and scientific codes

Country-Specific Use Cases

Swiss Medication Catalog (HCI)

Data Provider: HCI (Swiss Health Information System) Country Code: CH Key Characteristics:

1. Package-Focused: Swiss medications emphasize package quantities
   • amount.numerator: Number of units (e.g., 20 tablets)
   • amount.denominator: Package type (e.g., 1 package)
2. Multilingual Support:
   • German (de): Primary language
   • French (fr): Secondary language
   • Extensions provide translations for medication names
3. Visual Support:
   • Image URLs for medication packaging

Example Use Case:

Swiss Pharmacy System → HCI Catalog → CollabreeMedication
- Retrieves package information (20 tablets/package)
- Provides German/French translations
- Includes medication images

Saudi Arabian Medication Catalog (NPHIES)

Data Provider: CHI_GOV_SAUDI_ARABIA (National Platform for Health Information Exchange Services) Country Code: SA Key Characteristics:

1. Ingredient-Focused: Saudi medications emphasize active ingredients
   • ingredient.itemCodeableConcept: Scientific ingredient codes
   • ingredient.strength: Detailed strength information (500mg per tablet)
2. Form Specification:
   • form.coding: Administrable dose form (tablet, capsule, etc.)
   • Uses HL7 FHIR dose form terminology
3. Arabic Terminology:
   • Arabic display names (باراسيتامول 500 مجم أقراص)
   • Scientific codes from NPHIES system

Example Use Case:

Saudi Health System → NPHIES Catalog → CollabreeMedication
- Retrieves ingredient details (Paracetamol 500mg)
- Provides Arabic terminology
- Specifies dose form (tablet)

Medication Catalog Retriever Implementation

Data Source Handling

The medication catalog retriever processes different data sources and maps them to the unified profile:

HCI Data Provider Processing

// HCI medication processing
if (dataProviderId == "HCI") {
  medication.amount = parseSwissPackageInfo(data);
  medication.code.extension = addTranslations(data, ["de", "fr"]);
  medication.extension[imageUrl] = data.imageUrl;
}

CHI_GOV_SAUDI_ARABIA Data Provider Processing

// CHI_GOV_SAUDI_ARABIA medication processing
if (dataProviderId == "CHI_GOV_SAUDI_ARABIA") {
  medication.form = parseDoseForm(data);
  medication.ingredient = parseIngredientDetails(data);
  medication.code.display = data.arabicName;
}

Attribute Population Strategy

The retriever uses conditional logic to populate attributes based on the data source:

1. Always Populated:
   • identifier[country]: Source country
   • identifier[dataProviderId]: Data provider
   • code: SNOMED CT code
   • extension[expirationInMonths]: Expiration period
2. Conditionally Populated:
   • HCI: amount, extension[imageUrl], code.extension[translation]
   • CHI_GOV_SAUDI_ARABIA: form, ingredient, Arabic code.display
3. Optional Everywhere:
   • identifier[gtin]: May not be available in all catalogs

Benefits for Catalog Retriever

1. Single Processing Pipeline: One profile to validate and process
2. Flexible Mapping: Can handle different data structures from various sources
3. Consistent Validation: Same FHIR validation rules apply to all medications
4. Easy Extension: Adding new countries requires only mapping logic, not new profiles

Implementation Considerations

Where Medications Come From

The medication catalog app retrieves data from different providers:

• HCI: Swiss Health Information System
• CHI_GOV_SAUDI_ARABIA: National Platform for Health Information Exchange Services (Saudi Arabia)

Validation Rules

• All medications must have country and data provider identifiers
• HCI medications should have amount information
• CHI_GOV_SAUDI_ARABIA medications should have form and ingredient information
• GTIN is optional but recommended when available

This unified approach provides a robust, flexible foundation for handling diverse medication catalogs while maintaining FHIR compliance and system consistency.