​Oteo Products Implementation Guide - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

index

Official URL: https://ig.oteo.co.uk/OteoProductsImplementationGuide				Version: 0.1.0
Draft as of 2025-10-06				Computable Name: OteoProductsImplementationGuide
Copyright/Legal: © 2025 OTEO Health Technologies. All rights reserved.

Overview

This Implementation Guide (IG) defines the technical specifications, conventions, and guidelines for integrating with OTEO’s national digital health solutions using the HL7® FHIR® R4 standard. The guide serves as a comprehensive reference for healthcare software vendors, government health agencies, hospital IT departments, and any stakeholders developing or maintaining systems that are part of—or interoperable with—OTEO’s product portfolio.

OTEO’s health information platforms, including but not limited to Electronic Medical Records (EMRs), Public Health Management Systems (PHMS), Medical Imaging Platforms, Referral and Appointment Management Tools, and National Screening Applications, have been designed with interoperability at their core. Leveraging HL7 FHIR R4 ensures these platforms can exchange clinical and administrative data accurately, securely, and in real time.

This guide provides implementation instructions to ensure semantic and technical consistency across connected systems. It includes resource-level constraints (profiles), business rules, terminology bindings, usage scenarios, and examples that reflect real-world use cases tailored to the national healthcare infrastructure. All systems intending to interface with OTEO solutions must adhere to the guidelines outlined herein.

Terminology Services

All value sets and code systems referenced in this guide are accessible through OTEO’s centralized terminology server. Implementers can query, browse, and validate codes dynamically using the [Terminology Service Endpoint] provided as part of this guide. This ensures consistency in data representation across systems and supports semantic interoperability.

Custom terminologies are included where necessary to support national programs (e.g., cancer screening campaigns, vaccination programs, risk tracking tools) that are not fully covered by international standards. Each ValueSet is versioned and maintained according to a strict governance process.

Each FHIR Profile in this IG is labeled as either Must Support, Mandatory, or Optional to guide implementers in achieving the desired level of compatibility. Systems are expected to validate their conformance through the use of automated FHIR validation tools and reference implementations where available. Test instances and sandbox environments will be provided for selected modules.

All integrations must follow the canonical URIs, extensions, and search parameters defined in this IG. Deviation from these rules may result in rejected transactions or misinterpretation of clinical data.

This Implementation Guide is not only a technical specification but also a strategic enabler for unified, scalable, and future-proof digital health architecture. By adhering to the structures, profiles, and terminologies defined herein, implementers contribute to a safer, more connected, and patient-centered healthcare environment across the country.