Documentation

Runnel One Partner Guide

Version 1.0 | February 2026 For Business Partners, Operations Teams, Non-Technical Stakeholders

Table of Contents

1. What is Runnel One?

Runnel One is a billing management platform designed for behavioral health providers. It helps organizations:

Think of it as the central hub that connects what therapists do (visits) with what insurance companies pay (EOBs), and ensures everything adds up correctly.

2. How the System Works

The Big Picture

THERAPISTS RUNNEL ONE INSURANCE COMPANIES provide manages pay for services the billing services │ │ │ ▼ ▼ ▼ ┌────────┐ ┌─────────────┐ ┌──────────┐ │ VISITS │ ───► │ RECONCILE │ ◄───── │ EOB PDFs │ │(Excel) │ │ & REPORT │ │(Payments)│ └────────┘ └──────┬──────┘ └──────────┘ │ ┌────┴────┐ ▼ ▼ ┌──────────┐ ┌──────────┐ │ PAYROLL │ │ REPORTS │ │for Staff │ │for Mgmt │ └──────────┘ └──────────┘

Data Flow Summary

  1. Visits are imported from Excel files (therapist session data)
  2. Insurance EOBs are uploaded as PDF files (payment documents)
  3. The system automatically matches visits to insurance payments
  4. Discrepancies are flagged for review (mismatches, denials)
  5. Reports are generated for payroll, billing, and financial analysis

3. Getting Started - Initial Setup

Before using Runnel One, the system must be configured in a specific order. Each step depends on the previous one.

Setup Order

Step What to Configure Why It's Needed
1 Company Settings Sets your organization name, and billing period type
2 Insurance Providers Defines which insurance companies you work with and their CPT code rates
3 Clients Adds your clients with their insurance information and specific billing rates
4 Therapists/Contractors Registers therapists with their credentials, rates, and system access
5 User Roles Defines who can access what features in the system
6 Billing Periods Sets up your pay period schedule (biweekly or monthly)

Company Settings

When first logging in, you'll be directed to set up your company:

4. Managing Insurance Providers

Insurance providers are the companies that pay for therapy services. Each provider has specific CPT codes (service codes) and payment rates.

What You Need to Configure

For each insurance provider:

Supported Insurance Formats for EOB Upload

The system can automatically read payment PDFs from these insurance companies:

Insurance Provider Supported Formats
Aetna Better HealthDirect, Availity, MeriTain
CarelonDirect
CCP (Community Care Plan)Direct
CignaDirect
Florida BlueVia Availity
HumanaDirect, PaySpan
MedicaidDirect
MolinaDirect
SunshineCMS format
United HealthcareOptum, Availity

5. Managing Clients

Clients are the individuals receiving therapy services. Each client must be linked to their insurance and have billing rates configured.

Required Information

Field Description Why It Matters
Client Name Full name (must match exactly in all imports) Used to match visits with insurance claims
Medicaid Member ID Insurance member number Required for insurance claim matching
Alternative Insurance ID Secondary insurance identifier For clients with multiple insurances
Assigned Insurances Which insurance covers this client Determines billing rates
CPT Rate Configuration Per-CPT code rates Controls billing amounts

Rate Configuration Per Client

Each client can have customized rates per insurance and CPT code:

Rate Type Description
Company Rate What your company pay to the contractor per unit
Forced Rate (CMS 80%) Override rate for specific programs (like Medicaid CMS at 80%)

Example:
Client: Maria Garcia
Insurance: Aetna Better Health
  CPT 97153 → Company Rate: $7/unit, Insurance Rate: $12/unit
  CPT 97151 → Company Rate: $12/unit, Insurance Rate: $15/unit

6. Managing Therapists (Contractors)

Therapists and staff members who provide services are registered as contractors.

Required Information

Field Description
NameFull legal name
EmailUsed for system login access
RoleTHERAPIST or STAFF
Therapist TypeRBT, BCBA, LBA, etc.
Provider NPINational Provider Identifier number
Hourly RateBase pay rate for payroll calculation

System Access

Contractors can be assigned system roles that control what they can see and do in Runnel One. For example, a therapist might only see their own clients and visits, while a billing manager can access all financial reports.

7. Working with Visits

Visits represent therapy sessions - the core of your billing data.

How Visits Get Into the System

  1. Excel Import (most common) - Upload an Excel file with visit data
  2. Manual Entry - Create visits one by one through the interface

What a Visit Contains

Field Example
Client NameJohn Smith
TherapistJane Doe
Service DateJanuary 15, 2025
Start Time9:00 AM
End Time10:00 AM
CPT Code97153
Units4 (1 hour x 4)
PeriodPP01-2026

Visit Statuses

Each visit has two important statuses:

Entity Status - Is the visit record valid?

StatusMeaning
ACTIVATEDActive, valid visit
DELETEDRemoved (soft-deleted)
DUPLICATEDFlagged as a duplicate of another visit

Reconciliation Status - Has insurance paid for this visit?

StatusMeaning
PENDINGWaiting for insurance payment
RECONCILEDInsurance payment matches the visit
MISMATCHInsurance paid a different amount than expected
DENIEDInsurance denied the claim
SKIPPEDManually marked to skip reconciliation

Import Validation

When importing visits, the system checks:

If any check fails, the visit goes to the "Not Imported" list with the reason.

8. Understanding Billing Periods

Billing periods define time windows for grouping visits and generating payroll.

Period Types

TypeDurationExample
Biweekly14 daysP2501: Jan 1-14, P2502: Jan 15-28
MonthlyCalendar monthP2501: Jan 1-31, P2502: Feb 1-28

Important Rules

Always verify the correct period:

  • Before importing visits
  • Before importing EOBs
  • Before generating payroll

9. EOB Processing (Insurance Payments)

An EOB (Explanation of Benefits) is a document from an insurance company that shows what they paid for specific therapy claims.

How EOB Processing Works

  1. Step 1: Download the EOB PDF from your insurance portal
  2. Step 2: Upload the PDF to Runnel One (select the insurance type)
  3. Step 3: System reads the PDF and extracts claim information
  4. Step 4: Claims are created in the system
  5. Step 5: System automatically matches claims to existing visits
  6. Step 6: Review results - reconciled, mismatched, or failed imports

What the System Extracts from EOBs

Common Import Issues

ProblemCauseSolution
"Client not found" Client name on EOB doesn't match exactly Update client name to match insurance records
"CPT code not configured" CPT code exists on EOB but not in system Add the CPT code to the insurance provider
"Medicaid ID missing" Client's insurance ID not entered Update client profile with member ID
"Duplicate check" Same EOB already imported Skip - it's already in the system

10. Understanding Reconciliation

Reconciliation is the process of matching therapy visits with insurance payments. This is the core value of Runnel One.

How Matching Works

The system matches a visit to an EOB claim when ALL of these match:

  1. Same client (by name)
  2. Same insurance provider
  3. Same service date
  4. Same CPT code

What Happens After Matching

ScenarioResult
Visit amount = EOB paymentRECONCILED - Everything matches
Visit amount ≠ EOB paymentMISMATCH - Amounts differ, needs review
EOB shows denialDENIED - Insurance denied the claim
No matching EOB foundPENDING - Still waiting for insurance payment

Handling Mismatches

When a visit and EOB don't match perfectly, you have options:

  1. Recalculate - Re-run the matching algorithm (useful after fixing data)
  2. Split Visit - Divide the visit into two records:
    • One matching the EOB payment (RECONCILED)
    • One for the remaining amount (PENDING)
  3. Skip - Manually mark as resolved if the difference is acceptable

11. Dashboard Overview

The dashboard gives you a real-time snapshot of your billing status for any period.

Dashboard Cards

CardShows
Total VisitsNumber of visits imported for the period
ReconciledVisits matched to insurance payments
PendingVisits waiting for insurance payment
DeniedVisits where insurance denied the claim
MismatchedVisits where payment doesn't match expected amount
Payment IssuesVisits with incorrect company payment calculations
Total EOB ClaimsNumber of insurance claims processed
Per InsuranceBreakdown by insurance provider

Dashboard Charts

Dashboard Filters

12. Reports

Runnel One provides several reports for different business needs.

Available Reports

ReportWho Uses ItWhat It Shows
Client Summary Billing Team All visits per client, grouped by insurance and CPT code, with payment totals
Client Profitability Billing Team All visits per client, profit calculation, and reconciliation status
EOB Summary Billing Team All insurance payments by check number and period
Payroll Period HR / Payroll Therapist hours, rates, and gross pay per period
Therapist Rate Operations All configured rates per therapist per client (for verification before payroll)

Export Options

All reports can be exported to Excel (.xlsx) for further analysis or sharing with external systems.

13. User Roles & Permissions

The system uses role-based access control - different users see and can do different things.

Example Roles

RoleCan Do
Admin Everything - full access to all features
Billing Manager Manage visits, EOBs, clients, reports; cannot change settings or roles
Analyst View visits, generate reports; cannot modify data
Therapist View their own clients, submit timesheets, view payroll

How Permissions Work

14. Common Issues & Solutions

Before Import Checklist

Before importing visits or EOBs, verify:

Troubleshooting

SymptomLikely CauseFix
Visits showing $0 payment Missing rate configuration Configure CPT rates for the client
Many PENDING visits after EOB import Client name mismatch Ensure names match exactly
EOB claims not matching Missing alternative insurance ID Add it to client profile
Dashboard shows "Payment Issues" Rate misconfiguration or XP code issue Review affected visits, check rates
Cannot access a feature Missing permission Contact admin to update your role
Import shows "not imported" items Validation failures Review the error messages and fix data

Data Quality Tips

  1. Client names must be consistent - "John Smith" and "JOHN SMITH" or "John Smith" (extra space) will NOT match
  2. Verify periods before every import - Wrong period = wrong billing
  3. Run Therapist Rate Report before payroll - Catches rate issues early
  4. Process EOBs promptly - Reconciliation happens automatically when EOBs are imported
  5. Review the dashboard regularly - Spot issues before they become problems

15. Step-by-Step Workflows

Workflow 1: Monthly Billing Cycle

Week 1: Import Data

  1. Verify correct billing period is selected
  2. Verify correct therapists rate
  3. Collect therapist visit data (Excel files)
  4. Import visit files
  5. Review "Not Imported" and "Duplicated" list, fix any issues
  6. Re-import or Delete to fix the data

Week 2: Process Insurance Payments

  1. Download EOB PDFs from insurance portals
  2. Upload each EOB to Runnel One (select correct insurance type)
  3. Review reconciliation results
  4. Handle mismatches (recalculate, split, or skip)
  5. Review denied claims

Week 3: Generate Reports & Payroll

  1. Run Therapist Rate Report - verify all rates
  2. Fix any rate issues
  3. Generate Payroll Period report
  4. Export payroll data
  5. Run Client Summary for billing review

Week 4: Review & Close

  1. Check Dashboard for any outstanding PENDING items
  2. Generate EOB Summary for financial records
  3. Export reports for accounting
  4. Verify period is ready to close

Workflow 2: Adding a New Client

  1. Navigate to Clients section
  2. Click "Add New Client"
  3. Enter client information:
    • Full name (EXACTLY as it appears on insurance documents)
    • Medicaid Member ID
    • Alternative Insurance ID (if applicable)
  4. Assign insurance provider(s)
  5. Configure CPT codes for each insurance:
    • Select CPT code
    • Set company rate (what you charge)
    • Set insurance rate (what insurance pays)
    • Set forced rate if applicable (CMS 80%)
  6. Save
  7. Verify: Run Therapist Rate Report to confirm rates are correct

Workflow 3: Handling a Denied Claim

  1. Dashboard shows denied visits
  2. Navigate to Visits, filter by DENIED status
  3. For each denied visit:
    1. Review the linked EOB claim details
    2. Check the denial code/reason
    3. Options:
      • Contact insurance to dispute
      • Re-submit claim with corrections
      • Accept denial and mark as SKIPPED
      • Split the visit if partial payment expected
  4. After resolution:
    • Update visit status
    • Recalculate if needed
    • Verify dashboard reflects changes

Workflow 4: Onboarding a New Organization (Tenant)

  1. Runnel One prepares the infrastructure
  2. First-time login:
    1. Admin logs in with initial credentials
    2. System redirects to Company Settings
    3. Configure:
      • Billing cadence (biweekly/monthly)
      • Period start date
  3. Configure master data (in order):
    1. Insurance providers + CPT codes
    2. Contractors + credentials
    3. Clients + insurance assignments + rates
    4. User roles + permissions
  4. Test cycle:
    1. Import a small batch of test visits
    2. Upload a test EOB
    3. Verify reconciliation
    4. Generate test reports
  5. Go live:
    1. Import full visit data
    2. Process all pending EOBs
    3. Verify dashboard accuracy

16. Glossary

TermDefinition
CPT CodeCurrent Procedural Terminology - a 5-digit code identifying a specific medical service (e.g., 97153 = Adaptive Behavior Treatment)
EOBExplanation of Benefits - a document from an insurance company showing what they paid for specific claims
ReconciliationThe process of matching a therapy visit to the corresponding insurance payment
PeriodA billing time window (e.g., biweekly: Jan 1-14) used to group visits and generate payroll
TenantAn organization using the system; each tenant's data is completely isolated
NPINational Provider Identifier - a unique 10-digit number for healthcare providers
UnitA billing unit; typically 4 units = 1 hour of service
MismatchWhen the amount billed for a visit differs from what insurance paid
Soft DeleteMarking a record as deleted without physically removing it
RBTRegistered Behavior Technician - a type of therapist
BCBABoard Certified Behavior Analyst - a senior therapist type
Medicaid Member IDThe client's unique identifier with their insurance provider
Check NumberThe reference number on an insurance payment
Company RateWhat the therapy company charges per unit
Insurance RateWhat the insurance company pays per unit
Forced RateAn override rate applied for specific programs (e.g., CMS 80%)
Split VisitDividing a visit into two records when insurance pays a different amount than billed
RecalculateRe-running the matching algorithm to update reconciliation status
DashboardThe main overview screen showing billing status at a glance
PayrollThe calculated payment for therapists based on their visits and hours