Contract Hub¶
The Contract Hub is the central command center for managing payer contracts and their associated pricing rules. It allows you to link specific customizations (like Fee Schedules and DRG Tables) to contracts for defined time periods.
Overview¶
A Contract in Bedrock Billing represents a specific agreement with a payer (e.g., "Aetna Commercial" or "Blue Cross Medicare Advantage").
Because contracts change over time, Bedrock Billing uses Configuration Periods (or "Temporal Configs"). A Configuration Period defines exactly which pricing rules apply between a specific Effective Date and Termination Date.
managing Contracts¶
Creating a Contract¶
- Navigate to Customizations → Contract Hub.
- Click New Contract.
- Enter the Contract Name (e.g., "UnitedHealthcare PPO").
- Enter a unique Contract ID (this is the identifier used in your data files).
- (Optional) Toggle Use Medicare Base Fallback if you want the system to default to standard CMS pricing when no custom provider data is found.
Editing a Contract¶
- Click on a Contract in the list to view its details.
- Click the Edit button in the top right to change the name, description, or fallback settings.
Configuration Periods¶
The power of the Contract Hub lies in its ability to handle changing terms over time. You don't need to create a new contract ID when rates change; you simply add a new Configuration Period.
Adding a Period¶
- Inside a Contract Detail view, go to the Configuration Periods tab.
- Click Add Period.
- Effective Date: The start date of these rules.
- Termination Date: The end date (leave blank if open-ended).
- Link Pricing Rules:
- Fee Schedule: Select a Custom Fee Schedule to override CPT/HCPCS pricing.
- Custom DRG Table: Select a Custom DRG Table to override MS-DRG weights.
- IOCE Bypass: Select an IOCE Bypass Config to change edit logic.
- Click Create.
[!IMPORTANT] Configuration periods for the same contract cannot overlap. The system will prevent you from creating conflicting date ranges.
Example Scenario¶
- Period A (Jan 1, 2023 - Dec 31, 2023): Uses "2023 Commercial Rates" Fee Schedule.
- Period B (Jan 1, 2024 - Open): Uses "2024 Commercial Rates" Fee Schedule and "2024 Custom DRG Weights".
When a claim is processed with a Service Date of Feb 15, 2024, the system automatically selects Period B.
Claims Processing Integration¶
The Contract Hub connects your customizations to the core claims engine.
- Provider Lookup: When a claim is received, the system checks the billing provider's record.
- Contract Resolution: The provider record points to a specific Contract ID.
- Time-Based Selection: The system looks at the claim's date of service and finds the matching Configuration Period in the Contract Hub.
- Rule Application:
- Fee Schedules: If a Custom Fee Schedule is linked, it replaces standard CMS inputs.
- Custom DRG Tables: If a Custom DRG Table is linked, its weights and LOS values are used.
- IOCE Bypass Policies: If an IOCE Bypass Config is linked, specific edits are overridden or skipped.
- Provider Data: Use the Medicare Base Fallback setting to control whether the system should error or proceed with standard CMS data if a specific custom provider record is missing.