> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# TEFCA Operations

> Monitor QHIN exchange activity, patient matching, and compliance status for the organization.

The TEFCA Operations screen displays the organization's health information exchange log via the Trusted Exchange Framework and Common Agreement (TEFCA) network, accessible at `/cl/tefca-operations`.

## Overview

The page opens with a KPI strip summarizing exchange activity loaded via `useTefcaExchangeList`, scoped to the current organization. Below the strip, a filter bar allows narrowing by status, direction, QHIN, purpose of use, and date range. Results are displayed in a sortable data table ordered by exchange date descending. Each row includes a "View" action that opens a `TefcaExchangeDetailDialog` with full exchange details. When no exchanges match the filters an empty state is shown; load errors display an inline destructive alert.

## Who it's for

Requires permission: `cl.tefca.view`

## Before you start

* Your account must have the `cl.tefca.view` permission.
* The organization must have QHIN connectivity configured (visible via `qhin_identifier` column values).

## Steps

<Steps>
  <Step title="Open TEFCA Operations">
    Navigate to `/cl/tefca-operations`. The KPI strip and exchange table load automatically for the current organization.
  </Step>

  <Step title="Filter exchanges">
    Use the filter bar to narrow by status (Completed, Failed, Pending, Blocked — No Consent), direction (Inbound / Outbound), QHIN identifier, purpose of use, or date range. Clear filters to return to the full list.
  </Step>

  <Step title="Review an exchange">
    Click "View" on any table row to open the exchange detail dialog. The dialog shows full exchange metadata for the selected `cl_tefca_exchange_log` record.
  </Step>
</Steps>

## Key concepts

<AccordionGroup>
  <Accordion title="Exchange statuses">
    Statuses visible in the table: **Completed** — exchange succeeded; **Failed** — exchange encountered an error; **Pending** — exchange in progress; **Blocked (No Consent)** — exchange blocked because the required consent record was absent.
  </Accordion>

  <Accordion title="Direction">
    **Inbound** — data received from a QHIN partner; **Outbound** — data sent to a QHIN partner.
  </Accordion>

  <Accordion title="Purpose of Use">
    Values from code: Treatment, Payment, Healthcare Operations, Public Health, Individual Access, Benefits Determination.
  </Accordion>

  <Accordion title="Empty and error states">
    Empty state: "No TEFCA exchanges yet — Run a query or exchange to populate activity." Error state: inline destructive banner "Unable to load TEFCA activity."
  </Accordion>
</AccordionGroup>

## Related

<Columns cols={2}>
  <Card title="Clinical" icon="stethoscope" href="/cl/overview">
    Overview of the Clinical core.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index">
    Documentation coverage and governance.
  </Card>
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/cl.tsx
  * src/cores/cl/pages/TefcaOperationsPage.tsx
  * src/cores/cl/hooks/useTefcaExchangeList.ts
  * src/cores/cl/types/tefca.ts
</Accordion>