Health Data Interoperability
Clinical, operational, and financial complexity where patient outcomes, revenue, and compliance all intersect.
This interactive experience is the shipped product itself — the same application code customers run in production, mounted read-only in your browser over a real sample journey. Not a video, not a mockup: because the demo and the product are one codebase, it can never drift from the real thing.
Inside this journey
-
Integration Discovery
Align on current systems, data flows, stakeholders, compliance constraints, and measurable success signals for interoperability.
Discovery Questions
Starting Point: Quick System Snapshot
- Which major clinical, lab, billing, and public health systems does your organization actively exchange data with today?
- How many active interfaces does your integration team currently manage?
- Who on your team is the primary owner for interface health and incident response?
- Walk me through a typical data flow in your environment, for example an outbound lab result from your lab system to the ordering clinician — who touches the message and where does it transform?
- Which message standards do you run in production today for clinical and administrative exchanges?
- When was the last time your team performed an interface topology review, and what has changed since then?
When Interfaces Fail: The Real Costs
- What single recent interface failure in your environment would have justified moving to a different integration approach?
- Describe the operational impact in your organization when that failure happened, including delayed results, clinical risk, and staff hours spent resolving it.
- How often do critical failures that require manual intervention occur in your environment in an average month?
- Who in your organization is the first person or team alerted when an interface stops passing messages after hours?
- If those failures continued during a regulated reporting window, could your organization face penalties or contractual consequences, and what are they?
- Name the one operational constraint in your environment that would stop you from moving forward with an integration partner within 90 days.
Mapping, Transformations, and Standards: Hidden Complexity
- If a new payer-to-payer FHIR workflow were required tomorrow, which mapping or data gap in your estate would block you from complying?
- List the top three message types in your environment that demand the most custom mapping effort.
- How many unique field-level mappings do you estimate exist across your live interfaces?
- Do you rely more on point mappings, orchestration and routing rules, or a mix for your most complex interfaces?
- Tell me about a recent mapping change in your environment that caused unexpected downstream impacts, and how long it took your team to detect and fix it.
- What single metric or test during validation would convince you that mapping quality meets your acceptance criteria?
Compliance, Privacy, and Audit: The Gatekeepers
- Identify the compliance review or data use agreement in your organization that could block an integration project.
- On average at your organization, how many distinct sign-off groups must approve a new data sharing relationship?
- Name the roles in your organization that must sign off on external regulated data exchanges and indicate whether they are available on your target schedule.
- Are there any state or federal reporting obligations for your exchanges, such as public health reporting or TEFCA participation, that impose format or timeline constraints we must design for?
- Would lacking built-in immutable audit trails in your current infrastructure stop you from approving an integration project without adding extra tooling?
People, Process, and Pipeline: Do You Have the Bandwidth?
- Confirm the dedicated resources your organization can assign for mapping, testing, and cutover, and whether those resources can meet your timeline.
- Estimate the number of full-time equivalents your organization can allocate to this project over the next 3 months.
- Describe your team's experience with the primary standards involved, for example HL7 v2 and FHIR, and any notable gaps.
- List the internal teams in your organization needed for testing and sign off during pilot, and identify which team typically approves fastest.
- Would lack of available internal resources on your timeline pause the project, or could you accept a phased approach with vendor-managed tasks?
Hidden Risks and Obstacles: Timeline Killers
- Pinpoint the dependency in your program that, if delayed by one week, would cause the entire go-live to slip.
- Are there vendor contracts, gateway certificates, or third-party approvals with fixed lead times your project cannot change?
- Provide details about your development, testing, and production environments and any data access gaps that would affect build and verification.
- How long does it typically take your team to obtain representative test data from a trading partner, including deidentification or masking steps?
- Does lack of realistic test data block your organization from running an effective pilot?
The Other Paths You Are Considering
- Under what conditions would your organization keep the incumbent or an internal build instead of switching to an external integration partner?
- Provide the highest priority criterion that will tilt your decision toward each option you are evaluating.
- Do you have an internal effort to build the integration layer instead of buying, and if so, who proposed that approach in your organization?
- Imagine the incumbent added pre-built connectors and reduced maintenance by 50 percent, would your organization still switch this quarter?
- Tell me which internal metric in your organization would need to improve to justify staying with the current approach.
Acceptance Criteria and Next Steps
- Assuming the pilot hits the target metric, which final internal decision would allow your organization to sign within one week?
- Enumerate the measurable acceptance criteria your team will use for pilot success, including throughput, error rate, and provider acceptance.
- How quickly would you expect the first integration to move from design to UAT in your environment, measured in weeks?
- Explain the monitoring and alerting expectations your team requires to be demonstrably in place at cutover before accepting operational ownership.
- Choose which action your organization would take if the pilot meets all acceptance criteria but legal negotiations stall.
-
Solution Evaluation
Validate the platform against throughput, standards support, connector fit, and the buyer's acceptance criteria using representative interfaces and test data.
- current_state
- success_criteria
- stakeholders
- gaps
- desired_state
- decision_readiness
- gaps
- current_state
- desired_state
- success_criteria
- stakeholders
- decision_readiness
- gaps
- stakeholders
- current_state
- decision_readiness
- success_criteria
- desired_state
- current_state
- decision_readiness
- decision_readiness
- decision_readiness
- decision_readiness
-
Solution Scope
Define interfaces, transformation and routing modules, connector inventory, responsibilities, and measurable acceptance criteria.
Scope Configuration
- Build HL7v2 Interface
- Develop FHIR API Integration
- Configure CDA Document Exchange
- Implement X12 Claims/Electronic Transactions
- Create Message Transformations and Mappings
- Deploy Pre-built Connectors
- Configure Routing and Orchestration Flows
- Set Up Real-time Monitoring and Alerts
- Configure Compliance and Audit Dashboards
- Implement Error Handling and Retry Automation
- Message Replay and Resubmission
- Perform Interface Testing and Validation
- Go-live Cutover and Hypercare Support
- Provide Ongoing Interface Management Services
Scope Questions
Build HL7v2 Interface
- Which HL7v2 message types do you need supported (for example ADT, ORU, ORM)?
- How many concurrent HL7v2 messages per minute must the interface sustain at peak?
- Do you require support for specific transport protocols for HL7v2 (for example MLLP, TLS over TCP, SFTP for batch files)?
- Which ACK/NACK handling behavior is required when receivers reject messages (for example synchronous ACK,M-style retries, detailed NACK logging)?
- Specify any HL7v2 custom Z-segments, local extensions, or non-standard fields we must preserve during mapping.
- What acceptance criteria will confirm the HL7v2 interface meets throughput, ACK handling, and message fidelity requirements (include target throughput, max acceptable error rate, and sample message validation)?
Develop FHIR API Integration
- Which FHIR resources and interactions must be implemented (for example Patient read/search, Observation create, DiagnosticReport search)?
- What FHIR API authorization method will your systems use (for example OAuth 2.0 / SMART on FHIR or mutual TLS)?
- Provide the expected SLA for FHIR response times on read/search operations (average and P95 targets in milliseconds).
- Which FHIR conformance or profiling documents must the API validate against (for example a local Implementation Guide or US Core profile)?
- Who will own FHIR resource model updates and versioning for Patient and Observation resources in your environment?
- Define the success criteria for FHIR API validation and performance that will be used to accept the integration (include required conformance tests and response-time thresholds).
Configure CDA Document Exchange
- Which CDA document types must be supported (for example Continuity of Care Document, Discharge Summary, Referral Note)?
- How will CDA documents be transported into your environment (for example SFTP inbound, SOAP, API endpoint)?
- Specify any mandatory sections or LOINC/document templates that must be preserved in incoming CDA files.
- Are there signing or document integrity requirements such as digital signatures or checksum verification for CDA payloads?
- Do you need automated extraction of discrete data from CDA (for example problem list, medication list, allergies) into discrete FHIR resources or downstream systems?
- Who will approve sample CDA documents for mapping and validation prior to configuration?
Implement X12 Claims/Electronic Transactions
- Which X12 transaction sets are in scope (for example 837 claims, 835 remittance, 270/271 eligibility)?
- Do partner trading agreements require specific X12 versions (for example 4010, 5010) or payer-specific loops?
- How should ISA/GS interchange envelopes and control numbers be handled for partner reconciliation and acknowledgments (for example adjust, preserve, or re-sequence)?
- Specify required business validation rules and rejection handling for X12 transactions (for example missing subscriber ID, invalid provider NPI).
- Are there specific acknowledgements required (TA1, 999) and what turnaround time do trading partners expect?
- Which payer or clearinghouse endpoints will be used for certification and production connectivity (provide endpoint type: SFTP/AS2/API)?
Create Message Transformations and Mappings
- Which source-to-target mapping pairs are required (for example HL7v2 ORU to FHIR Observation, X12 837 to FHIR Claim)?
- Do any transformations require lookup tables or external reference data (for example code set mappings between local codes and LOINC/ICD-10)?
- Provide the expected data quality rules for mappings (for example reject if patient identifier missing, default unknown codes), and whether you want transformations to fail or to enrich.
- Who owns the canonical data model and the source-to-target mapping sign-off for each interface?
- List any code systems that must be translated during mapping (for example LOINC, SNOMED CT, ICD-10, CPT).
- When will you provide representative message samples for each mapping pair (attach timeline)?
Deploy Pre-built Connectors
- Which endpoint types require pre-built connectors (for example major EHR interfaces, lab vendor interface, public health registry)?
- How many distinct target systems need connectors deployed at go-live?
- Do any connectors require local installation behind your firewall or in a specific VPC/subnet?
- Provide the credentials and connection test accounts required for each connector, or indicate if your security team will provision them.
- Are there validation or certification steps required by the endpoint vendor before connectors move to production?
- Specify any scheduling requirements for connector deployments to avoid disruption to clinical systems (preferred maintenance windows).
Configure Routing and Orchestration Flows
- Which routing rules must be implemented (for example by facility, by sending application, by message type, by patient identifier)?
- Do you require content-based routing that inspects fields (for example route all ORU with LOINC X to public health)?
- Specify orchestration behaviors needed such as fan-out to multiple recipients, parallel transforms, or transactional two-phase commits.
- Who is the owner for routing rule changes after go-live and what is the expected SLA for change requests?
- Are there permitted hours or blackout periods when routing changes cannot be applied to production systems?
- Provide any business rules that must be enforced in orchestration (for example patient consent flags blocking sharing, data minimization rules).
Set Up Real-time Monitoring and Alerts
- Which message health indicators should be monitored in real time (for example message throughput, error rate, latency, queue depth)?
- What alert thresholds should trigger notifications for HL7v2 message failures and FHIR API errors (for example error rate > 1% over 15 minutes)?
- Which notification channels do you prefer for alerts (for example email, SMS, webhook to PagerDuty or equivalent)?
- Do you require role-based alert routing so that operations, clinical informatics, and security receive different notifications?
- Specify retention and log aggregation needs for message traces and audit logs (for example 1 year, 7 years, HIPAA-required retention).
- Who will be the on-call rotation for first responder to monitoring alerts at go-live?
Configure Compliance and Audit Dashboards
- Which regulatory or program dashboards are required (for example ONC information blocking metrics, TEFCA participation stats, public health submission success rates)?
- What specific audit fields must be captured with each message (for example user ID, source system, message ID, timestamp, patient identifier)?
- Do you require automated reporting for certification or attestation (for example monthly information-blocking evidence bundles)?
- Specify the export formats and frequency for audit reports (for example CSV nightly export, PDF monthly report).
- Are there role- or team-specific dashboards needed (for example clinical operations view vs compliance officer view)?
- Who will own compliance report sign-off for regulatory submissions and attestations?
Implement Error Handling and Retry Automation
- Which error classes require automated retry (for example transient network failures vs data validation errors)?
- How many retry attempts and what backoff strategy should be used for transient failures?
- Do you require quarantine or dead-letter queues for messages that fail after retries, and what retention should apply?
- Provide required notifications and escalation flow when retry automation fails to deliver a message.
- Are there types of clinical messages that must never be retried automatically (for example amended reports where duplicate submission causes issues)?
- Who will be the accountable owner for managing the dead-letter queue and manual remediation workflows?
-
Mutual Commit
Finalize commercial and legal terms, confirm deliverables, timelines, SLAs, and governance for implementation and ongoing management.
Agreement Modules
- Master Services Agreement (MSA)
- Subscription Agreement & Order Form
- Statement of Work (SOW)
- Service Level Agreement (SLA)
- Data Processing Agreement (DPA) / HIPAA Business Associate Addendum (BAA)
- Implementation Acceptance Certificate
- Change Order Agreement
- Implementation & Ongoing Governance Charter
- Payment Schedule and Invoice Terms
-
Deployment
Lock readiness facts and configuration values before execution begins.
-
Pre-Deployment Readiness
Capture concrete readiness facts — environments, data access, owners, and go-live windows the deployment depends on.
Pre-Deployment Questions
Environment and access
- Which environments are provisioned and reachable for the interfaces in scope? (select all that apply — so we know where we can build and test)
- If any environment is not yet provisioned, what is the expected availability date? (name a date or 'TBD' — so we can sequence build and testing)
- Are the necessary system accounts/service accounts created and is a secure handoff method confirmed for the deployment team to receive credentials when needed? (we will not ask for the credentials here; this confirms account readiness)
Data and configuration
- Have authoritative responsibilities been assigned for each data flow (source owner, target owner, and mapping owner)? (this lets us know who will sign off mappings and validation)
- Is any bulk data migration, backfill, or pre-cutover reconciliation required before go‑live? (so we can schedule exports and validation)
- If bulk data or reconciliation is required, is a data owner and a target completion date confirmed? (provide owner name/role and date or 'TBD')
People and ownership
- For these workstreams, are named owners confirmed? Select all that apply (integration build, QA/testing, security/compliance, cutover/operations, training/change management) — we need owners to assign tasks and approvals.
- Who is the primary contact authorized to approve go‑live decisions (name, role) and who is their backup? (this is the formal approval path for cutover)
Timing and constraints
- Are there operational blackout windows, maintenance freezes, or other scheduling constraints that would restrict deployment activity? (if yes, indicate whether they are date-specific, recurring, or regulatory — so we avoid blocked windows)
- What is the confirmed target go‑live window or acceptable date range? If not confirmed, provide the regulatory deadline or earliest acceptable date. (we'll use this to plan cutover sequencing and communication)
-
Configuration Details
Record exact configuration values the deployment team will use — connector credentials, API endpoints, field mappings, routing rules, and monitoring thresholds.
Configuration Details
Environments & Endpoints
- Enter the production integration endpoint URL (format: https://... ). This exact URL will be configured in the platform connector settings.
- Enter the non-production environment name to configure (single value). Default: 'staging'. Example: 'staging' or 'uat'.
Connector & Authentication
- Connector type to configure for this endpoint (select one):
- Authentication method for this connector (select one). Default: 'OAuth2 (client ID only)'. Do NOT paste secrets here — secrets are exchanged via the secure channel specified later.
- Enter the non-secret identifier used for authentication (single value): client ID, integration username, certificate name, or API key name. Example: 'int-client-123' or 'svc_integration_user'.
Field Mappings & Transformations
- Canonical incoming message standard for this connector (select one):
- Provide the exact path or URL to the mapping document the platform should import (format: https://... or file://... ). This file is consumed verbatim by the transformation engine.
Routing, Delivery & Monitoring
- Primary routing key used to select destination (select one):
- Delivery retry policy — number of retries before moving message to dead-letter (numeric). Default: 5.
- Alert threshold for interface failures in a rolling 15-minute window (numeric). Default: 5.
-
Deployment
Execute interface builds, transformations, testing, cutover sequencing, monitoring enablement, and go-live support with clear owners and milestones.
-
-
Success
Confirm interoperability outcomes against acceptance criteria and maintain a shared channel for issues, enhancements, and operational handover.
Success Reviews
- Go-live Health Check (weeks 1-4)
- First Measurement Review (weeks 4-10)
- Acceptance Gate Meeting (around day 90)
- Operational Monthly Review (months 4-6 then as needed)
- Quarterly Operational Review and Compliance Check
Issues & Enhancements
- Publish the monthly operational summary with KPI trends and open-ticket status.
- Publish the formal acceptance record with pass/fail per criterion and the buyer's named signatory.
- If applicable, publish the incumbent wind-down completion checklist and archive confirmation.
- List remediation tasks for any conditional acceptances with target completion and verification steps.
- KPI dashboard review
- Confirm interface error rate and MTTR remain within the Solution Scope thresholds or have agreed remediation plans.
- Drive to zero the high-severity open incidents and reduce the remediation backlog per the agreed timeline.
- Ensure runbooks and monitoring thresholds are documented and handed over to the buyer's operations team.
- Re-confirm acceptance criteria and ownership
- List the remaining remediation tasks with target completion dates and verification steps.
- Update runbook documents to reflect any agreed operational changes.
- Trend review of KPIs
- Validate quarterly KPI trends for interface error rate and active integrations in production relative to Solution Scope targets.
- Confirm compliance reporting processes and readiness for any upcoming regulatory deadlines.
- Agree any governance-level remediation or process changes for persistent operational issues.
- Produce the quarterly KPI and compliance packet for the buyer's records.
- Document any governance actions and target dates for resolution of persistent issues.
- If additional enablement is required, publish a short enablement plan with milestones for completion.
- Confirm the deployment completed and all critical connectors are able to exchange messages end-to-end.
- Document the current open defects and agree remediation actions with target dates.
- Ensure owners for each acceptance criterion recorded in Solution Scope are named and reachable.
- Publish a go-live health summary listing open defects, owners, and target resolution dates.
- Collect and share logs and sample payloads for any failing interfaces for root-cause analysis.
- Confirm access to monitoring dashboards for the buyer's operations team.
- Present first outcome data
- Establish whether interface error rate and MTTR are trending toward the targets recorded in Solution Scope.
- Agree a short list of corrective actions with resolution dates to close any gaps before the acceptance gate.
- Confirm the data sources and reports that will be used at the acceptance gate to demonstrate compliance with each numeric target in Solution Scope.
- Produce a metric pack showing interface error rate, MTTR, and throughput for the next review and the acceptance gate.
- List and prioritize failing interfaces and required mapping fixes with completion dates.
- Schedule the acceptance gate meeting and distribute the agenda and required evidence checklist.
- Restate acceptance criteria and targets
- Produce a documented acceptance decision for each criterion recorded in Solution Scope, with the buyer's named signatory captured in the meeting record.
- Confirm the incumbent system is decommissioned or formally retained read-only and that data migration or archival is complete.
- Agree remediation items with clear resolution dates for any conditional or failed criteria.
- Incident and ticket burn-down
- Compliance and reporting status
- Present outcome data against each criterion
- Diagnose gaps and root causes
- Deployment and migration validation
- Runbook and operational handover status
- Document pass/fail per criterion and signatory decision
- Persistent issues and escalation
- Corrective actions and timelines
- Early adoption and usage signals
- Operational handover and maturity plan
- Open defects and blockers
- Confirm readiness to proceed to acceptance gate
- Operational backlog triage
- Incumbent wind-down status
- Immediate remediation plan
- Remediation items and resolution timelines