Cardinal Prescription Angular Component 🇧🇪

This is a Belgian-specific Angular application for healthcare professionals to manage electronic prescriptions.
It integrates iCure's APIs — @icure/be-fhc-lite-api, @icure/cardinal-be-sam-sdk, and @icure/medication-sdk — to streamline:

• Practitioner certificate management
• Medication search
• Electronic prescription creation & editing
• Prescription overview & sending
• Printing of prescriptions

This component is designed for integration with Belgium’s SAM platform and can easily be embedded into other medical software projects as a drop-in feature for prescription management.

Table of Contents

• About iCure and Cardinal
• Features
• Technologies
• Prerequisites
• Getting Started
• Available Components and How to Use Them
• Available Services and How to Use Them
• SAM and Recip-e Requirements
• Medications of Interest for Tests
• Example Demo Application

About iCure and Cardinal

iCure is the company that provides a secure, end-to-end encrypted backend-as-a-service for Health-Tech, allowing companies to build fully compliant medical solutions faster.

Cardinal is iCure’s backend platform that provides data management, security, and interoperability features. In this project, we do not use the Cardinal backend directly — we integrate with iCure's public API to access its SAM and FHC features.

Free Health Connector (FHC) The Cardinal Free Health Connector (FHC) is iCure’s open-source implementation of Belgium’s eHealth infrastructure. It enables secure, standards-based connections to government and regional healthcare systems

Features

• Designed specifically for Belgian healthcare professionals
• Practitioner certificate upload & verification
• Medication search powered by iCure's SAM SDK
• Create, edit, list, send, and print prescriptions
• Structured and unstructured posology support
• Interacts with Recip-e to send prescriptions
• Ready to integrate into medical apps
• Secure token and certificate storage in IndexedDB
• Fully internationalized with on-demand translation (French, Dutch, German, English)

Technologies

• Angular 19.x Standalone components
• iCure SDKs ( @icure/be-fhc-lite-api, @icure/cardinal-be-sam-sdk, @icure/medication-sdk)
• RxJS for reactive data handling
• IndexedDB for token & certificate persistence
• SCSS for component styles
• TypeScript for strict typing
• ESLint + Prettier for code style & linting
• UUID.js for unique identifiers
• jsBarcode for barcode generation in printed prescriptions

Prerequisites

Before starting, make sure you have:

• Node.js v16+ and Yarn installed
• A valid Belgian practitioner certificate file that you can load into the app
• The practitioner credentials for iCure authentication — these must be generated on your side.
  You can do this inside your application using the @icure/cardinal-sdk for a more scalable approach (we will add How-To), or via the iCure Cockpit (we recommend this only for testing purposes or for very small projects):
  • Create a HCP in Cockpit
  • Generate the authentication token for the HCP
    Once generated, you will need the HCP’s email address and the authentication token.
• Patient and healthcare professional information to populate prescriptions
• A valid Free Health Connector URL, which depends on the certificate you use: for the acceptance certificate, use https://fhcacc.icure.cloud, and for the production certificate, use https://fhcprd.icure.cloud.
• A valid iCure URL that will be used for SAM. You should use: https://api.icure.cloud.
• Vendor and SamPackage

const practitionerCredentials = {
username: 'xxx@xxx.com',
password: 'xxxxxxxxxxx',
}
const ICURE_URL = 'https://api.icure.cloud'
const FHC_URL = 'https://fhcacc.icure.cloud'
const CARDINAL_PRESCRIPTION_LANGUAGE = 'fr'

const vendor = {
vendorName: 'vendorName',
vendorEmail: 'support@test.be',
vendorPhone: '+3200000000',
}
const samPackage = {
packageName: 'test[test/1.0]-freehealth-connector',
packageVersion: '1.0]-freehealth-connector',
}

Getting started

Install the library:

yarn add @icure/cardinal-prescription-be-angular

npm i @icure/cardinal-prescription-be-angular

Available Components and How to Use Them

This library provides modular, standalone Angular components to integrate Belgian prescription workflows into your app.

<cardinal-practitioner-certificate />

Handles practitioner certificate upload, decryption, and validation.

<cardinal-practitioner-certificate
[hcp]="hcp"
[certificateUploaded]="certificateUploaded"
[certificateValid]="certificateValid"
[errorWhileVerifyingCertificate]="errorMessage"
(onUploadCertificate)="handleCertificateUpload($event)"
></cardinal-practitioner-certificate>

<cardinal-medication-search />

Displays a medication search interface using SAM. Triggers an event when a medication is selected for prescription.

<cardinal-medication-search
  [deliveryEnvironment]="'P'"
  (addPrescription)="onCreatePrescription($event)"
></cardinal-medication-search>

<cardinal-prescription-list />

Lists created prescriptions and exposes actions to send, modify, print, or delete them.

<cardinal-prescription-list
  [prescribedMedications]="prescriptions"
  [sending]="sending"
  [printing]="printing"
  (handleModifyPrescription)="onModify($event)"
  (handleDeletePrescription)="onDelete($event)"
  (sendPrescriptions)="onSend()"
  (printPrescriptions)="onPrint()"
  (sendAndPrintPrescriptions)="onSendAndPrint()"
></cardinal-prescription-list>

<cardinal-prescription-modal />

Modal for creating or modifying prescriptions with structured/unstructured posology.

<cardinal-prescription-modal
  [modalTitle]="'New prescription'"
  [medicationToPrescribe]="medication"
  (handleSubmit)="onSubmit($event)"
  (handleCancel)="onClose()"
></cardinal-prescription-modal>

<cardinal-print-prescription-modal />

Generates a printable PDF view of one or more prescriptions.

<cardinal-print-prescription-modal
  [prescribedMedications]="prescriptions"
  [prescriber]="hcp"
  [patient]="patient"
  (onCloseModal)="onClosePrintModal()"
></cardinal-print-prescription-modal>

Available Services and How to Use Them

These services can be injected in your Angular components or other services to handle backend logic, certificates, and translation.

SamSdkService

Wraps the iCure SAM SDK. Manages SDK instance and exposes SAM search/version APIs.

import { CardinalBeSamSdk, Credentials } from '@icure/cardinal-be-sam-sdk';

constructor(private samSdkService: SamSdkService) {}

const instance = await CardinalBeSamSdk.initialize(
  undefined,
  this.ICURE_URL,
  new Credentials.UsernamePassword(
    USER_NAME,
    PASSWORD
  )
);

await samSdkService.setSdk(instance.sam);
const samVersion = await samSdkService.getSamVersion();

FhcService

Handles interactions with the iCure Free Health Connector (FHC) API, including certificate verification and prescription sending.

constructor(private fhcService: FhcService) {}

await fhcService.sendRecipe(
  FHC_URL,
  samVersion!,
  vendor,
  package,
  hcp,
  patient,
  medication,
  passphrase!,
  indexedDbTokenStore!
);

UploadPractitionerCertificateService

Provides helper methods for encrypting, decrypting, saving, and validating practitioner certificates using IndexedDB.

constructor(private certificateService: UploadPractitionerCertificateService) {}

const db = await this.certificateService.openCertificatesDatabase();
await this.certificateService.loadCertificateInformation(
  this.db,
  this.hcp.ssin!
);

TranslationService

Handles translations based on a predefined dictionary and active language. Set and get the app’s language. Supports fr - French, en - English, nl - Dutch, and de - German.

constructor(private translationService: TranslationService) {}

ngOnInit() {
  this.translationService.setLanguage('fr');
  const lang = this.translationService.getCurrentLanguage();
}

const label = translationService.translate('prescription.createTitle');

SAM and Recip-e requirements

When the prescriber selects a medication, this application integrates with the SAMv2 database to provide all up-to-date metadata. This includes:

• Links to the leaflet & SPC.

• Special status indicators:

  • Black triangle (additional monitoring).
  • RMA material links.
  • DHPC communications.
  • Temporary supply problems.
  • End of commercialization or future commercialization.
  • VMP group information and switch statuses.
  • Conditions of delivery/prescription and risk minimization messages.
  • Reimbursement details (chapters, categories, extra reimbursement for youth contraception).

More information is available on the SAM portal.

Medications of interest for tests

Commercialization & supply problems

• Polydexa 10 mg/ml
• Crestor
• Cisplatine Teva 1 mg/ml inf. sol. (conc.) i.v. vial 50 ml

Future commercialization

• Kaftrio (black triangle)
• Increlex (black/orange triangle)

Doping status

• Ultiva
• Rapifen

Black triangle (additional monitoring), RMA

• Increlex

💡Note: This module is built for integration with Belgium’s SAM platform, is modular, and can be easily adapted for use in other medical solutions.

Example: Demo Application

To see the full working version, you can clone the GitHub repository and run the included demo app.

git clone https://github.com/icure/cardinal-prescription-angular
cd cardinal-prescription-angular
yarn install
ng serve

Make sure to set up your .env variables or hardcode your credentials and HCP/Patient data for testing.