Skip to main content

Smart Vaccination Certificates

OpenSRP FHIR Core for Smart Vaccination Certificates for Android implements the Smart Certificates protocol for recording, storing, validation, and generating certificates verifying vaccination status. All the Patient data is eventually going to be mapped as an International Patient Summary (IPS) document, i.e. as an electronic health record extract containing essential healthcare information about a subject of care. As specified in EN 17269 and ISO/DIS 27269, it is designed to support 'unplanned, cross border care', but it is not limited to this. It is intended to be international by providing a generic solutions for global application beyond a particular region or country.

For information on the codebase, contributing, and sample data see the code documentation for the FHIR Core application.

Building and running the Android application in Android Studio

  1. Complete the build instructions for FHIR Core generic to all FHIR Core applications
  2. In Android Studio, select the app build profile
  3. In Android Studio, from the Run menu select the Run 'app' option

Currently supported Smart Vaccination Certificates


In a mission to help digitize the management of the immunization process against Covid-19, OpenSRP FHIR Core can enroll people in a digital health platform, track their vaccination status, and produce Digital Smart Vaccine Certificates embedded in QR codes. This is inline with the WHO Digital Documentation of COVID-19 Certificates: Vaccination Status (DDCC:VS) protocol.

For continuity of care the application supports the following use cases

  1. Paper first - A guideline-based vaccine administration is recorded on paper. After the vaccination event, data about it can be entered into a Digital Health Solution.
  2. Offline digital - A guideline-based vaccine administration is recorded using an offline secure Digital Health Solution, with the content subsequently uploaded to an online Digital Health Solution.
  3. Online digital - A guideline-based vaccine administration is recorded using an online secure Digital Health Solution which updates the content in real time.

While for Proof of Vaccination

  1. A Verifier service verifies a DDCC:VS using digital cryptographic processes in an offline/online mode.

The application supports the following workflow:

  1. Patient arrives at a clinic or a facility in which they seek to be Immunized against the Covid-19 virus
  2. The patient presents any form of identification at the vaccination clinic and is authenticated by healthcare worker (HCW) (authentication process depends on the country norm, e.g. an ID card or only name and date of birth).
  3. HCW registers the patient by capturing their name and date of birth only.
  4. The HCW will first query the system via a search by name (first name or last name) to ensure that the patient details are not preexisting.
  5. The HCW retrieves a new paper card with a Health Certificate ID (HCID) which could be in the form of a barcode.
  6. The HCW scans the barcode with the HCID and links this to the patient's details.
  7. After the details are captured and verified, the HCW will give the patient the vaccine dose, and record the vaccination details in app
  8. The following vaccination data elements will be recorded:
    • Vaccine or prophylaxis,
    • Vaccine brand,
    • Vaccine manufacturer,
    • Vaccine market authorization holder,
    • Vaccine batch number,
    • Date of vaccination,
    • Dose number,
    • Total doses,
    • Country of vaccination,
    • Administering center,
    • Health worker identifier,
    • Disease or agent targeted,
    • Due date of next dose (if applicable)
  9. Once all the fields are validated, the vaccination bundle is submitted to the health portal that will be used to collect and track the Immunization details
  10. The HCW at the facility can then use the web portal to view certificates generated by the certificate generation service, which also returns a QR code that can be printed on a paper card or sent as a digital receipt.

In-progress Smart Vaccination Certificates

  • Yellow Fever
  • Measles Mumps, and Rubella (MMR)