Prepare and export PBJ reports
RehabAlpha is still under active development. It is not yet HIPAA compliant and should only be used with dummy data.
Use Reports → PBJ to review licensed therapy staffing hours and prepare monthly or quarterly exports for a nursing home's Payroll-Based Journal (PBJ) submission. Download a CSV for review and a separate XML file for each PBJ reporting facility.
Before you start
- You need Owner or Admin access to run PBJ reports and manage employee mappings. This access also includes creating and correcting other members' timesheet entries.
- Configure each service location's PBJ settings and each reporting member's employee ID for that location.
- Check that the member's allowed Work classification has PBJ selected in the organization's timesheet settings.
- Record actual timesheet hours at the correct service location. Hours must already exclude meals, unpaid time, and other nonreportable work. Clock out for those periods or correct the timesheet entries before reporting.
- Finish the period's clinical documentation. Record actual service minutes and Number of patients for group services.
Understand PBJ reporting facilities
| Term | Meaning |
|---|---|
| RehabAlpha facility | The building, campus, or operating site your team manages, with its own patients, schedules, and other work. |
| Service location | A specific care setting within a RehabAlpha facility, such as a nursing-home wing or an outpatient clinic. PBJ settings and employee mappings are configured for each service location. |
| PBJ reporting facility | The nursing home whose staffing hours are being reported. RehabAlpha combines resident-care service locations with the same state and PBJ facility ID into one reporting facility. |
| PBJ facility ID | The identifier used for the nursing home's CMS PBJ submissions. RehabAlpha includes this ID in the XML export. |
| CMS Certification Number (CCN) | The nursing home's six-character certification number. Keep any leading zeros. This appears as PROVNUM in the review CSV and CMS PBJ public datasets. |
A PBJ reporting facility is derived from the service locations' PBJ settings; there is no separate reporting-facility field to complete during setup. See facilities and service locations for examples of how to organize where your team works.
Configure service locations
Open a facility's Locations tab, select a service location, and edit its Reporting designation under PBJ settings. When creating a location, the first place-of-service selection suggests a designation if you have not already chosen one:
| Place of service | PBJ designation |
|---|---|
| 31 — Skilled nursing facility; 32 — Nursing facility | PBJ resident care |
| 11 — Office; 19/22 — Outpatient hospital; 49 — Independent clinic; 62 — Outpatient rehabilitation facility | Outpatient |
| All others | Not included |
Review the suggested designation and change it if needed. The saved designation stays in place when the location's place of service changes.
For a PBJ resident care service location, enter both its PBJ facility ID and CMS Certification Number (CCN). These are separate identifiers; confirm both with the reporting nursing home's PBJ administrator. Service locations with the same state and PBJ facility ID are combined in one report. Their CCN and time zone must agree.
In this fictional example, Example Nursing Home has two service locations: East wing and West wing. Both use the same state, PBJ facility ID, CCN, and time zone. Staff record their work at the actual wing, and RehabAlpha combines the eligible hours into one PBJ reporting facility's report and XML export.
Configure employee IDs
Open a member's Settings and find the PBJ settings card. This card is available to Owners and Admins for every member, including associates, physicians, and therapists. Choose Service location; each option shows the RehabAlpha facility and service location. Enter PBJ employee ID, select PBJ pay type, and select Save mapping. Use Edit on an existing mapping to change it. An employee ID can differ between PBJ reporting facilities. Service locations that belong to the same PBJ reporting facility must use the same employee ID and pay type for that member.
Use the employee ID assigned by the reporting nursing home. Each person needs a distinct employee ID within that PBJ reporting facility. Configure a mapping for every resident-care service location where the person records labor, even when those locations share a reporting facility. In the East wing and West wing example, a member working at both needs a mapping for each wing, with the same employee ID and pay type. A linked user account is not required.
Contract is the default pay type for therapy staff employed by a contractor. Use Exempt or Non-exempt only when that describes the employee's relationship to the reporting nursing home.
Check therapy roles
The report supports OT, OTA, PT, PTA, and SLP. With Automatic from credentials on a timesheet entry, it selects a role only when the therapist's licenses identify exactly one supported role for the service-location state and work date. Student credentials do not qualify.
When more than one role qualifies, edit the timesheet entry and choose PBJ role. That choice must still match the therapist's credentials for the location and date. Record separate entries for work in different roles. Review the therapist's Details → Licenses if a role remains unresolved. Employee mappings alone do not qualify an associate or physician for therapy staffing hours.
Run and review the report
- Open Reports → PBJ.
- Choose Month or Fiscal quarter, then select the year and period.
- Leave PBJ reporting facility set to All reporting facilities for the first review, or select a reporting facility from a previous result. The choices become available after you run a report.
- Select Run report.
- Review Daily staffing hours and Outpatient allocation.
- Resolve the messages under Resolve before XML export. Use Member details to review credentials or navigate to Settings → PBJ settings for employee mappings. Use Timesheet to correct the source entries, then run the report again.
- Select Download review CSV for internal review. When the reporting facility's report is ready, download its XML file and give it to the nursing home staff responsible for the combined submission.
The Timesheet link opens the message's date when one is shown. For a message without a date, it opens the first month of the reporting period. When reviewing a fiscal quarter, adjust the timesheet dates to check the remaining months.
After changing the period or PBJ reporting facility filter, select Run report again before downloading. Exports recalculate from the current saved information, so changes made after your review can cause XML validation to fail; run the report again to see the current messages.
The CSV remains available when there are staffing rows to review, even if XML is blocked. Each reporting facility's XML requires staffing rows and no applicable validation messages. A message for one reporting facility blocks that facility's XML; a message without a reporting facility can block all XML exports. Downloading a file does not submit it to CMS.
The XML uses merge processing. Submitting an employee's day replaces that employee's existing hours for that entire day, including other roles. The receiving facility must combine complete daily records before submission.
Understand the hours
PBJ starts with completed timesheet entries and dated manual hours at PBJ resident care service locations. Time-off classifications, work classifications saved as ineligible for PBJ, custom work locations, and labor at Not included service locations are excluded. Labor recorded at Outpatient locations is used to reconcile outpatient deductions and does not contribute to resident-care labor hours. Time ranges, including entries spanning several days, are allocated to local calendar dates using the reporting location's time zone; only hours within the selected period are included.
PBJ eligibility comes from the classification saved on each timesheet entry. Changing the organization's classification settings does not update existing entries, and saving an entry with the same classification keeps its saved eligibility. Review affected entries when changing classifications.
Outpatient clinical minutes are calculated from submitted treatments with Completed or Completed - Partial Session selected, plus submitted evaluations and re-evaluations at outpatient locations:
- Individual service minutes count in full.
- Each outpatient patient's group minutes are divided by the group's Number of patients.
- Concurrent minutes count at half their recorded value. They are already part of service-item minutes and are not added again.
- Co-treatment annotations are not added as extra time.
For each therapist, RehabAlpha facility, and date, the report subtracts outpatient labor already recorded separately from the calculated outpatient clinical minutes. It spreads any remaining deduction proportionally across that day's eligible hours by PBJ reporting facility and role. Review this allocation when a therapist works at several locations. Selecting one PBJ reporting facility keeps this shared allocation; Outpatient allocation still includes the totals for that reporting facility's RehabAlpha facilities.
The report combines hours by reporting facility, employee, date, role, and pay type, then rounds PBJ hours to two decimal places. The report blocks XML when an employee's total at one reporting facility exceeds 22.50 hours in a day across all roles, using either the unrounded or rounded total. This PBJ export check applies even though timesheets do not impose a duration maximum.
Resolve missing or inconsistent information
| Report problem | What to review |
|---|---|
| Missing service location | Assign the actual service location on the affected clinical document or timesheet entry. A facility alone is insufficient for PBJ allocation. Custom work locations are excluded from PBJ. |
| Open or overlapping labor | Correct a missed clock-out or correct overlapping time ranges. Open labor is not counted as completed PBJ hours and can block XML. |
| Missing or conflicting identifiers | Check the service location's PBJ facility ID and CMS Certification Number (CCN), and the member's employee ID and pay type at every resident-care service location. |
| Unresolved role | Check the therapist's licenses and the entry's PBJ role using the role requirements. |
| Missing outpatient services or minutes | Complete the source document's actual service minutes, including untimed services, group Number of patients, and concurrent minutes where applicable. |
| Outpatient deduction exceeds labor | Compare Outpatient allocation with clinical documentation and separately logged outpatient hours for that therapist, facility, and date. |
| Daily hours exceed 22.50 | Check for duplicate hours, incorrect dates, and nonreportable time across all roles for that employee and reporting facility. |
Review validation messages even when the page says No reportable labor was found for this period. Missing locations, unfinished labor, or configuration problems can prevent usable rows from appearing.
Understand reporting periods
| Federal fiscal quarter | Months |
|---|---|
| Q1 | October–December of the preceding calendar year |
| Q2 | January–March |
| Q3 | April–June |
| Q4 | July–September |
For example, October–December 2026 is FY2027 Q1 in the XML. The CSV's CY_QTR column uses calendar quarters, so the same dates show 2026Q4. Monthly exports contain daily rows, just like quarterly exports.