Getting started

What is Tax Resolution Hub?

TRH is a Windows desktop application for tax professionals. It pulls IRS transcripts in bulk through IRS A2A (Auto-Login) authentication, analyzes balances and compliance, runs resolution calculators (OIC, IA, CNC, CSED, penalty abatement), and generates pre-filled IRS forms including 2848, 8821, 433-F, 433-A/B, 656, and 9465.

Who is TRH built for?

Enrolled agents, CPAs, tax attorneys, and resolution firms who represent taxpayers before the IRS. You need a CAF number and an active e-Services account to use the transcript features.

How long is the free trial?

Seven days, full feature access. The trial clock starts when you first launch the app, not when you download it. You'll get a reminder email on day 5 and day 6.

Do I have to enter a credit card to start the trial?

No. The trial is zero-cost with no card on file. You'll only enter payment if you decide to convert.

What should I do first after installing?
  1. Activate your license key on the activation screen.
  2. Open Tools & System → Firm Profile and enter your firm name, CAF number, PTIN/EIN, and address.
  3. Set default save paths in Tools & System → Paths.
  4. Configure IRS A2A authentication.
  5. Add or import your first clients.
Is there training material?

The Knowledge Base covers every workflow in the app. For live help, email support@taxhub-usa.com and we'll schedule a walkthrough.

Is there a Mac or Linux version?

Not at this time. TRH is Windows-only. It runs well in Parallels on Apple Silicon Macs if you have a Windows 11 ARM license.

Licensing & billing

Where do I find my license key?

It's emailed to the address you used at checkout (subject line "Your TRH license key" or "Your TRH 7-day trial"). Allow a few minutes for delivery and check your spam or promotions folder.

What does a license key look like?

Keys are formatted TRH-XXXX-XXXX-XXXX-XXXX. Paste the whole string including dashes.

I lost my license key. How do I recover it?

Email support@taxhub-usa.com from the address you bought under and we'll resend it.

Can I run TRH on more than one computer?

Each paid license activates on a single machine. If you need to move to a new computer, email support and we'll release the prior activation so you can re-activate on the new hardware.

We have multiple preparers in our firm. Do we need multiple licenses?

Yes, one license per active workstation. Contact us for volume pricing if you're rolling TRH out across a team.

How does renewal work?

Paid licenses are valid for 365 days from purchase. We send renewal reminders at 30 days and 7 days before expiration. Renew through the same checkout flow you used initially.

What's the refund policy?

14 days, no questions asked. Email support and we'll process the refund through Square.

How do I cancel?

TRH licenses are annual, not a recurring subscription. If you don't renew, the license simply expires at the end of the 365-day term. No cancellation needed.

Can I get an itemized invoice or receipt?

Square emails a receipt automatically. If you need a customized invoice with firm details, forward the Square receipt to support and we'll re-issue it.

What payment methods do you accept?

All major credit and debit cards through Square. We don't currently take ACH or checks.

Installation & system

What operating systems are supported?

Windows 10 version 1909 or newer, and Windows 11. See the full system requirements.

Where do I download the installer?

The download link is in your trial or purchase email. You can also grab it from the pricing page at taxhub-usa.com. The installer is named TRH-Setup.exe.

Windows SmartScreen says "Windows protected your PC." What do I do?

Click More info → Run anyway. This is a Windows reputation warning that shows on new installers until they've built up a trust history. The installer is code-signed; the warning is expected.

My antivirus is quarantining TRH. How do I fix it?

Webroot, Bitdefender, Avast, and Windows Defender occasionally flag new Electron apps on heuristic grounds. Add TRH.exe and the install folder (%LOCALAPPDATA%\TRH) to your AV's allowlist. If your AV keeps flagging after an update, email support with the detection name and we'll submit a false-positive report to the vendor.

Where does TRH install?

The app installs to %LOCALAPPDATA%\TRH per-user (no admin rights required). Logs and user data go under %APPDATA%\TRH.

Does TRH work offline?

Most local tasks do: form generation, analysis, report review, editing saved transcripts. Fresh transcript pulls and license validation need a connection.

What domains does TRH need to reach?
  • IRS A2A endpoints (*.irs.gov) for transcript pulls
  • TRH licensing API on AWS API Gateway
  • Amazon CloudFront (*.cloudfront.net) for app updates

If you're on a corporate firewall, allowlist those three.

How do I uninstall TRH?

Windows Settings → Apps → Installed apps → Tax Resolution Hub → Uninstall. Your client data stays in %APPDATA%\TRH unless you delete it manually.

IRS authentication (A2A / CAF)

What is A2A authentication?

A2A (Application-to-Application, also called Auto-Login) is the IRS's modern, high-throughput transcript API. It uses signed JWT tokens instead of browser-based login, which lets TRH pull transcripts in bulk without human intervention.

What do I need to use A2A?
  • An e-Services account with an approved CAF number.
  • TDS (Transcript Delivery System) authorization plus A2A enrollment (separate from e-file).
  • A registered key pair: private key on your machine, public key on file with the IRS.
I just applied for my CAF number. When can I start pulling?

CAF provisioning typically takes 4 to 6 weeks after the IRS approves your application. Until your CAF shows as active in e-Services, transcript calls will fail with a CAF-related error. There's no workaround — it's an IRS-side wait.

I don't have A2A set up yet. Can I still pull transcripts?

A2A is the supported mode. If you're still getting your A2A credentials squared away, contact support — we can talk through interim options, but the long-term path is A2A.

Do I need Form 2848 or Form 8821?

Either works for pulling transcripts. Form 2848 (Power of Attorney) lets you represent the taxpayer — speak with the IRS, negotiate, sign documents on their behalf. Form 8821 (Tax Information Authorization) only lets you view transcripts and receive copies. If all you need is transcripts, 8821 is faster to get processed.

I'm getting "CAF Not Valid" on every pull. What's wrong?

Three common causes: (1) the CAF number in your Firm Profile has a typo, (2) the CAF number doesn't match the one associated with your A2A credentials, or (3) your CAF was suspended by the IRS. Verify the CAF in your e-Services portal first. See the error reference for details.

How do I test my A2A credentials?

Go to Tools & System → IRS Authentication and click Test Connection. A green check means your credentials are accepted by the IRS; a red X returns the specific error code.

How often do I need to rotate the A2A signing key?

The IRS currently does not enforce a rotation interval, but we recommend rotating your key pair annually. Rotate sooner if you suspect compromise.

I lost my A2A User ID. How do I recover it?

Log in to e-Services and check your A2A client registration. If the UID isn't visible there, open a case with the IRS e-Help Desk (866-255-0654). TRH support can't retrieve IRS-side credentials.

Pulling transcripts

What transcript types can TRH pull?

TRH supports 96 IRS transcript types across individual and business filers. The most common:

  • Account Transcript — TC codes, balances, payments, penalties, statute dates
  • Return Transcript — line-by-line of the filed return
  • Wage & Income Transcript — W-2, 1099, 1098, K-1 data reported to the IRS
  • Record of Account — account + return combined
  • Entity Transcript — for businesses
  • Verification of Non-Filing

Pick any combination per client per year.

How many years back can I pull?

The IRS generally retains transcripts for the current year plus the prior 3 years for Return and Wage & Income. Account Transcripts go back 10 years or more depending on the module. For anything older, you'll likely need to file Form 4506.

Can TRH pull business transcripts?

Yes. TRH handles 1120, 1120S, 1065, 941, 940, and other business modules. Specify the EIN and entity type on the client record.

How do I pull transcripts in bulk?
  1. Open Transcript Request.
  2. Select clients, transcript types, and tax years.
  3. Click Queue to stage requests.
  4. Click Start Dispatch. TRH paces requests against IRS rate limits and retries transient errors automatically.
Can I make dispatches run faster?

TRH's default concurrency is already tuned for IRS rate limits. You can adjust it in Tools & System → Dispatch Settings, but raising it too high triggers 429 responses, which slow you down overall. Only increase if you're consistently seeing "idle" status on the dispatcher.

Why isn't a recently-filed return showing on the transcript?

IRS transcript data lags return processing. E-filed returns typically show on Account and Return Transcripts within 2 to 3 weeks; paper returns 6 to 8 weeks. Wage & Income data for the prior year is usually complete by late May.

My client filed MFJ but the transcript shows MFS (or vice versa). What's happening?

Either the return was filed under a different status than the client remembers, or the IRS adjusted it. Pull the Return Transcript and the Account Transcript side-by-side: Return Transcript shows what was filed, Account Transcript shows any post-filing adjustments (TC 290, TC 421, etc.).

Can I pull transcripts for a deceased taxpayer?

Yes, but you'll need Form 56 (Notice of Fiduciary Relationship) in addition to your 2848 or 8821, signed by the executor or personal representative. The IRS will often block transcript access until Form 56 is on file. See Deceased Taxpayer Flag in the error reference.

A transcript returned with an ID theft indicator. What now?

The IRS has placed an identity-theft marker on the account, which usually blocks A2A pulls. Your client will need to work through IRS identity verification (typically via IRS.gov ID verification or Form 14039). Once cleared, the indicator lifts and pulls resume. See ID Theft Indicator.

I keep getting "Information Mismatch" on one client. What should I check?

Verify the SSN, legal name spelling (especially hyphens and suffixes), and date of birth exactly as the IRS has them. Recently-married clients are a frequent cause: if the IRS still has the maiden name, use that. If everything looks right, confirm a valid 2848 or 8821 is on file.

Where does TRH save downloaded transcripts?

In the folder you set under Tools & System → Paths. By default, each client gets a subfolder and each pull is saved as a timestamped PDF plus a parsed JSON snapshot that the analyzers read from.

Resolution analysis

What resolution calculators does TRH include?

Eleven built-in calculators:

  • Installment Agreement (streamlined, guaranteed, partial-pay)
  • Offer in Compromise (RCP, lump-sum vs. periodic, 656 attachments)
  • Currently Not Collectible
  • Penalty Abatement (first-time, reasonable-cause)
  • CSED Strategy (five-scenario comparison)
  • Collection Alternatives (10-option ranked comparison)
  • Interest Projection
  • Hardship Modeling
  • Compliance Check
  • Statute Analysis
  • Tax Estimate Preview
Does TRH fill out Form 433-F automatically?

Yes. The 29-section Collection Information Statement auto-populates from client data, employment, income, assets, expenses, and liabilities. It applies IRS allowable-standards heuristics (housing, transportation, food/clothing) and feeds every resolution calculator in real time.

How accurate is the OIC calculator?

The reasonable collection potential (RCP) math follows the IRS Internal Revenue Manual formulas. It's only as good as the inputs — if the 433-A is off, so is the RCP. Always sanity-check the asset and income figures before relying on the number.

How does TRH determine first-time abatement eligibility?

It reads the Account Transcripts for the three years preceding the penalty year, checks for clean compliance (no unabated penalties, all returns filed, no outstanding balance other than this one), and flags eligible tax years. Always verify with the IRS before counseling the client.

How does TRH calculate CSED?

CSED (Collection Statute Expiration Date) is computed from the TC 150 assessment date plus 10 years, with tolling events (TC 520, OIC pending, bankruptcy, CDP) added in automatically from the Account Transcript codes. The CSED Strategy analyzer compares five strategies that interact with the statute.

Notices

How do I look up a notice?

Open Analyses → Notice Report. Paste any CP, LT, LTR, or 668 notice code and TRH returns the urgency tier (High / Medium / Low / None), plain-English meaning, and typical deadline language.

Can I get a multi-client notice report?

Yes. Notice Report → Generate Report reads TC 971 / TC 972 entries across every loaded transcript for a date range you pick, then produces a color-coded Word document sorted by urgency — red clients at the top.

What are the most common notices?
  • CP 14 — Balance due, first notice (Low)
  • CP 501 / 503 / 504 — Escalating balance-due reminders
  • LT 11 / 1058 — Final notice of intent to levy (High)
  • CP 2000 — Underreporter (Medium)
  • LTR 4624C — CNC confirmation
  • LTR 3852C — Entity classification mismatch (often needs Form 8832 or 2553)
A client received an LT 11. How urgent is that?

Very. LT 11 (and LT 1058) is a Final Notice of Intent to Levy with CDP rights. The client has 30 days from the notice date to request a Collection Due Process hearing (Form 12153). After that window, the IRS can levy wages, bank accounts, and other assets. TRH flags LT 11 as High urgency.

Updates & versions

How do updates work?

TRH checks for new versions every 4 hours and installs them atomically on app restart. Updates are cryptographically signed and delivered from Amazon CloudFront. You can also check manually from Tools & System → About → Check for Updates.

How do I see what version I'm on?

Tools & System → About. The version number is also in the app's window title bar.

Where's the changelog?

taxhub-usa.com/changelog.html. It lists every released version with notes.

Can I skip an update?

You can defer restarting, but TRH will install the update the next time you relaunch the app. We don't currently support pinning to an older version — keeping everyone on a current build is part of how we maintain IRS API compatibility.

The update failed. What do I do?

Common causes: a corporate firewall blocking *.cloudfront.net, antivirus quarantining the download, or a prior update interrupted mid-install. Email support@taxhub-usa.com with your log file (Tools & System → About → Open Logs).

Privacy & data

Where is my client data stored?

Locally on your machine under %APPDATA%\TRH. Transcripts, 433 data, and generated forms never leave your computer unless you explicitly export or email them.

Does TRH upload data to the cloud?

No client data. TRH communicates with the IRS directly for transcript pulls, with our licensing server for key validation (sends your license key and a hardware ID — no taxpayer data), and with our update server for new versions.

Does TRH collect telemetry?

Minimal. Crash reports include stack traces but are scrubbed of any PII. You can disable crash reporting in Tools & System → Privacy.

How do I back up my TRH data?

Back up the folder %APPDATA%\TRH. That contains your client database, saved transcripts, generated forms, and firm profile. Any backup tool that handles ordinary Windows folders will work.

How do I move my data to a new computer?
  1. On the old machine, copy %APPDATA%\TRH to a drive or cloud folder.
  2. Email support to release your activation.
  3. On the new machine, install TRH, activate with the same key, then paste the copied %APPDATA%\TRH folder back into place.
Is my local data encrypted?

Client records and saved transcripts are stored in the user-scoped Windows profile. Sensitive credentials (A2A private key, license key cache) are stored using Windows DPAPI, which encrypts them to your Windows user account. We recommend whole-disk encryption (BitLocker) on any machine running TRH.

Troubleshooting

TRH won't launch — nothing happens when I double-click.

Usually antivirus quarantined a file during an update. Check your AV's quarantine log and restore TRH.exe. If that doesn't fix it, uninstall and reinstall — your data in %APPDATA%\TRH is untouched by the installer.

My license says "invalid" but I just activated it.

Two common causes: the clipboard dropped a character when you pasted the key (paste it fresh), or the machine-identity file was lost from a recent OS reset. Email support to release and reissue the activation.

I'm seeing "Hardware ID Mismatch." What does that mean?

The machine fingerprint changed — usually after swapping a motherboard, reimaging the drive, or a major Windows reinstall. Email support with your license key and we'll re-bind it to the current machine. See Hardware ID Mismatch.

Transcript dispatch hangs on "In progress" forever.

Almost always an IRS-side throttle. TRH backs off and retries automatically. If it persists beyond 15 minutes, test your A2A credentials and check irs.gov e-Services status for an outage.

I'm getting IRS 401 Unauthorized errors.

Your A2A token is being rejected by the IRS. Re-run Test Connection under IRS Authentication. If the test fails, check your private key file, Client ID, User ID, and Key ID. See the full 401 remediation.

I'm getting IRS 403 Forbidden. Am I blocked?

The IRS has rejected access for this specific request. Common causes: no 2848/8821 on file for that taxpayer, the authority expired, or your account has been temporarily blocked for suspected abuse. Pause dispatches, review the 403 guidance, and if it persists across multiple clients, contact the IRS e-Help Desk.

I'm getting 429 Rate Limited.

You've exceeded IRS rate limits for the day. Best practice is to pause all dispatching for 24 to 48 hours before retrying. Lower the concurrency in Dispatch Settings going forward. See 429 remediation.

How do I send logs to support?

Tools & System → About → Open Logs. Zip the folder and attach to an email to support@taxhub-usa.com with a brief description of what happened and when.

How do I contact support?

Email support@taxhub-usa.com. We usually respond within one business day. Include your license key (or trial email), Windows version, TRH version, and a description of the issue with any error codes.