DocumentationSupportCosta Rica · Contact
The starting point

The ecosystem is already defined. The question is which side your organization lands on.

Once a country defines its interoperability architecture, connecting stops being optional. Your organization will have to answer queries, publish what it produces, or both — and prove it can do so before being let in. Most find out late: three or four capabilities were missing that never appeared in any project, and they surface during testing, when the date is already committed. Our job is for you to know that today.

Roles

Consumer, producer, custodian: almost nobody is just one

Exchange is organized by role, not by type of institution. A single hospital usually carries all three at once, and the obligations are not a choice: they stack.

Queries in order to decide

Consumer

Needs to see information someone else generated — a result, a vaccination, an earlier episode — at the moment of caring for the patient.

What you will be required to do

Prove who is querying, on whose behalf and for what purpose; and that every query is on the record.

What is almost always missing

Nobody defined the purpose of use or where consent is recorded. The query works in testing and stalls in legal review.

Typically
  • Emergency services
  • Outpatient care
  • Pharmacy
  • Referral and back-referral
Generates the data

Producer

Produces clinical information the rest of the ecosystem needs: laboratory results, notifications, imaging reports, vaccinations administered.

What you will be required to do

Publish conforming to the national profile, with terminology bound, at the moment the event happens — not in a batch at the end of the month.

What is almost always missing

The system generating the data cannot produce the profile, and the project finds out once that system has already been bought.

Typically
  • Laboratories
  • Imaging services
  • Immunization
  • Notifiable disease reporting
Answers for the data

Custodian

Holds the information and answers for it: who may see it, how long it is kept and what is handed over when the ecosystem asks. Sometimes it is the same party that produces it; sometimes it is a role of its own.

What you will be required to do

Be available when queried, hand over only what is authorized, and be able to reconstruct who accessed what, months later.

What is almost always missing

The repository exists, but there is no committed availability, no queryable audit trail and no written retention policy.

Typically
  • Institutional repositories
  • Provider networks
  • National registries
  • PACS operators

If your organization produces and also queries, you do not get to pick: both columns apply. And if it holds what it produces, all three do. That stacking is why connection projects run to twice the estimate.

Gaps

What do you still have to build?

Seven capabilities. Open the ones your role binds you to and you will recognize which you are ready for and which are not in any project your organization is running today.

CapabilityConsumerProducerCustodian
Patient identity resolutionConsumerRequiredProducerRequiredCustodianRequired
What it is

Knowing that the record you hold and the one the ecosystem returns belong to the same person, even when the identifiers do not match.

If you don't have it

It merges or splits the wrong histories. It is the error that escalates fastest to a clinical incident and costs the most to unwind.

How it gets solved

You query the ecosystem's index instead of replicating it, with a written policy for the cases that do not resolve automatically.

  • IHE PIX / PDQm
  • FHIR Patient $match
Locating the informationConsumerRequiredProducerCase by caseCustodianRequired
What it is

Finding out what information exists about a patient and who holds it, before retrieving anything.

If you don't have it

Without it you can only ask whoever you already knew had something — the exact opposite of why an HIE exists.

How it gets solved

You query the ecosystem's document registry and retrieve only what the clinical decision at hand actually needs.

  • IHE XDS.b / XCA
  • IHE MHD
  • FHIR DocumentReference
Consent and purpose of useConsumerRequiredProducerCase by caseCustodianRequired
What it is

Declaring why you are querying and verifying there are grounds to do so, on every access rather than once at the beginning.

If you don't have it

This is where projects that already worked technically come to a halt. Nobody signs off a production release with it open.

How it gets solved

Purpose of use is defined per case, the legal basis is recorded, and it is bound to the authorization the request travels with — not to a checkbox on a form.

  • IHE BPPC / APPC
  • FHIR Consent
  • SMART scopes
Publishing conformant to the profileConsumerCase by caseProducerRequiredCustodianRequired
What it is

Handing over what you produce with the structure, mandatory elements and terminology the national guide requires.

If you don't have it

What you publish gets rejected. Or worse: it is accepted incomplete and reaches whoever queries it that way, unnoticed until it matters.

How it gets solved

It is validated against the profile before publishing and corrected at source. If the source system cannot produce it, an exposure layer solves it without replacing the system.

  • HL7 FHIR
  • IHE MHD / XDS.b
Answering queries in real timeConsumerCase by caseProducerCase by caseCustodianRequired
What it is

Being available to answer when the ecosystem asks, within a committed response time.

If you don't have it

A custodian that does not answer stops being one in practice, and whoever was asking makes the clinical decision without that data.

How it gets solved

Availability is committed as a measurable number, with monitoring, and the external query path is separated from the system that runs daily operations.

  • IHE XCA / XCPD
  • FHIR RESTful API
Access auditingConsumerRequiredProducerRequiredCustodianRequired
What it is

Being able to reconstruct, months later, who accessed what information, when and on what grounds.

If you don't have it

It is the first thing you will be asked for when a complaint arrives. If the logs have rotated, the institutional answer is that nobody knows.

How it gets solved

It is designed as a component, with defined retention and its own query path, and the event is emitted on every ecosystem transaction — not only in the local system.

  • IHE ATNA
  • FHIR AuditEvent
System identity, clock and non-repudiationConsumerRequiredProducerRequiredCustodianRequired
What it is

The ecosystem knowing that the one asking is you, every log sharing the same time, and what was exchanged being provable.

If you don't have it

Without clock synchronization the audit trail reconstructs nothing. Without signing, an exchanged document proves neither who issued it nor that it arrived intact.

How it gets solved

Certificates per organization and per subsystem, clock synchronization, and signing and sealing on the exchanges that carry evidentiary weight.

  • IHE ATNA / CT
  • JAdES
  • mTLS
RequiredCase by case

That board is exactly the first deliverable of a gap assessment: these rows, filled in with what your organization already has, what is missing and what each gap costs.

Transactions

How your architecture talks to the HIE

No integration is a single call. This is the real sequence, and at every step there is something concrete your architecture has to be able to do.

  1. 01

    Identify the patient

    Toward the ecosystem

    Before asking for anything you have to settle who is being talked about. You query the ecosystem's index with the identifiers you hold and get back the one everyone else knows them by.

    • PIX / PDQm
  2. 02

    Find out what exists

    Toward the ecosystem

    With identity resolved, you ask what information exists about that person: who holds it, what kind it is and how recent. Nothing is retrieved yet.

    • XDS.b / MHD
  3. 03

    Retrieve only what is needed

    Toward the ecosystem

    You pull the document or resource the decision at hand requires, not the whole record. Whatever you pull beyond that is now outside your control.

    • XCA / FHIR read
  4. 04

    Answer when you are the one asked

    Toward your organization

    The same circuit from the other side: someone identifies the patient, sees that you hold information and asks for it. Your architecture has to answer in time, authorize per use case and trim the response.

    • XCA / XCPD
  5. 05

    Publish what you produce

    Toward the ecosystem

    Every time a relevant clinical event occurs it is published conforming to the profile, with terminology bound, at the moment it happens. The monthly batch no longer works.

    • MHD / FHIR create
  6. 06

    Log every step

    At both ends

    Each of the transactions above emits an audit event, at both ends and on the same clock. That is what later lets you answer a complaint with facts.

    • ATNA
    • CT
Compliance

What you have to prove before they let you connect

Entering a national ecosystem is not a technical agreement between two teams: there are requirements proven with evidence. Worth knowing before you commit to a date, not after.

Conformance to the national profile

What is required

That what you publish meets the implementation guide in force, with mandatory elements and terminology bound.

How you prove it

Validation report against the profile, with test cases covering real scenarios and not just the happy path.

Correct, current terminology

What is required

That the codes you send exist, are current and belong to the ValueSet the guide requires.

How you prove it

Automated terminology validation at the publication point, and a written plan for what happens when a ValueSet changes version.

Identity and authorization

What is required

Organization and subsystem certificates, and authorization per use case rather than general access to the system.

How you prove it

Registration in the ecosystem, proof of mutual authentication and a matrix of what each consumer may ask for.

A reconstructable audit trail

What is required

A record of every access, with defined retention and the ability to answer a specific query.

How you prove it

A live demonstration: who viewed this person's record in the last six months, answered in minutes.

Evidentiary weight of the exchange

What is required

That what was exchanged can be attributed to whoever issued it and proven unaltered, in the cases that require it.

How you prove it

Signing and sealing of documents or resources, validated on the receiving end. Meddyg provided technical assistance to the Banco Central de Costa Rica to enable JAdES signing of FHIR resources.

Connection testing passed

What is required

Passing the ecosystem's test cycle with data resembling the real thing, before touching production.

How you prove it

A test environment with synthetic data, an agreed set of cases and evidence of every transaction executed end to end.

Method

From deciding to connect to the first transaction in production

Six stages. The first settles your role, because everything else — scope, cost and date — follows from it.

  1. 01

    Role and use-case definition

    We establish which roles your organization carries, service by service, and which concrete use cases it enters the ecosystem with. Without this, any estimate is a guess.

    What it leaves behind
    • Roles assigned per service
    • Prioritized use cases
    • Scope of the first connection
  2. 02

    Gap assessment

    We test the capabilities your role requires against what your architecture does today, and separate what has to be built from what only has to be configured. This is where the date becomes realistic.

    What it leaves behind
    • Gap board by role
    • Effort estimate per gap
    • Connection risks
  3. 03

    Integration design

    We define which component talks to the ecosystem, which transactions it supports, how it authenticates and what gets trimmed from each response.

    What it leaves behind
    • Transaction design
    • Exposure point and controls
    • Authorization matrix per use case
  4. 04

    Build and conformance

    What is missing gets built, and it is validated against the national profile at source rather than at the end. Where the source system cannot produce the profile, an exposure layer solves it instead of a replacement.

    What it leaves behind
    • Integration components
    • Validation reports
    • Automated test cases
  5. 05

    Testing with the ecosystem

    We run the test cycle end to end, including the scenarios that fail: the patient that does not resolve, the document that does not conform, the other end that does not answer.

    What it leaves behind
    • Test evidence
    • Findings and fixes
    • Connection approval
  6. 06

    Go-live and operations

    We stand by the first real transaction and leave the monitoring, the auditing and the procedure for when the one failing is the other end.

    What it leaves behind
    • Go-live and rollback plan
    • Monitoring and alerting
    • Handover to the internal team
Deliverables

What the organization is left holding

Material you estimate, procure and demonstrate compliance with — not a slide deck.

Gap board by role

The capabilities your role requires, what you already have, what is missing and what each gap costs.

Integration design

Which component talks to the ecosystem, which transactions it supports and under what identity, authorization and audit controls.

Compliance dossier

The technical and regulatory requirements with the evidence that proves them, ordered to be submitted as is.

Test case set

The connection scenarios, failures included, automated so they can be re-run on every change.

Staged connection plan

Which use case goes first, with which dependencies, and in what order so something reaches production early.

Monitoring and operations

What gets measured, what raises an alert and what to do when the end that stops answering is the other one.

Cases

Connections that are running

Each of these projects resolved a specific role inside an exchange ecosystem, and stayed in operation.

The role it resolvedTransactions with the ecosystem

National exchange over X-Road

Proofs of concept with the National Digital Government Agency to validate FHIR resource transactions over the national platform, within Costa Rica's functional interoperability demonstration: secure exchange between different systems, without centralizing the data.

The role it resolvedCustodian on the receiving end

National FHIR notification server for EDUS/CCSS

Design, production deployment and operation of the first FHIR server receiving notifiable disease, vaccination and laboratory result notifications from EDUS/CCSS, and later from other health facilities.

The role it resolvedProducer into a regional ecosystem

Regional AEFI notification

Part of the Meddyg team took part as consultants in designing the first HL7© FHIR© implementation guide for regional AEFI (adverse events following immunization) notification, and in designing and implementing the infrastructure that would receive those notifications.

The role it resolvedCustodian of studies

Medical image exchange under DICOM

Implementation of PACS architectures and diagnostic workstations for medical image exchange under the DICOM standard, in public hospitals of the Dominican Republic's National Health Service.

The models and profiles we name on this page — OpenHIE, IHE, HL7 FHIR — are the method we work with, not clients. When a case belongs to a client, we say so by name.

Who it is for

Who has this conversation pending

It serves both those who already have a connection date and those who do not yet know which role they were assigned.

Public health institutions

Social security funds, ministries and hospitals the national ecosystem has already assigned a role — and often a date.

Private providers and networks

Clinics, hospitals and networks that need to take part without opening up their network or rebuilding their record system.

Laboratories and imaging services

Producers of results who will be required to publish conforming to a profile, at the moment the event happens.

IT and integration teams

Teams that have to answer how long connecting takes and what it costs, and today have nothing to estimate with.

Health software vendors

Manufacturers whose product has to meet the national profile for their client to be able to connect.

National and regional programmes

Initiatives that need to connect dozens of organizations on the same terms, rather than negotiating one by one.

Self-assessment

Signs the connection will cost more than estimated

You were assigned a role in the ecosystem and are not sure what it means in concrete obligations.
You can publish what you produce, but you do not know whether it conforms to the national profile until someone rejects it.
You could not reconstruct who queried a given person's record in the last six months.
Every query to the ecosystem is solved with a different piece of development, by whichever vendor is on hand.
You were asked for a connection date and the estimate rests on what you expect, not on what you measured.
You know you will have to answer real-time queries, and today the only thing that could answer is the system running daily operations.

If you recognize three or more, what you are missing is not a project — it is a diagnosis. That first step is measured in weeks, and it is what stops the date from being a bet.

Do you know which role you were given, and what you are missing to meet it?

We tell you exactly which capabilities your role requires, which you already have, which are missing and in what order to build them — with the evidence the ecosystem is going to ask you for.