Tax Rules

1. What a Tax Rule Is

Tax Rule (HaloPSA):
An – an automation that, at the instant an invoice is saved or regenerated, evaluates a set ofdefined conditions (Top Level, Item Group, etc.) and writes the correct tax onto each invoice line.
Key propertiesEssentials
• Runs only on Save / Regenerate—ideal for testing with sample invoices..
• AppliesMore-specific inrules orderoutrank ofbroader specificity (narrowest conditions win).ones.
• Writes a permanent record; taxTax is notwritten anpermanently; overlay andamounts will not change unless the invoice is regenerated.

---

2. Core Building Blocks

TermElement	Purpose inat DTC’s configurationDTC	Example
Top Level	CombinedCombines Industry + Region/State labelto drivingdrive automations, including tax.automations	Dental MD (dental offices in Maryland)
Item Group	Restricts tax to certain product families.families	Recurring Items (technology-service contracts)
Tax Rule	Container forStores rate + conditions; firesexecutes at invoiceon save/regenerate.regenerate	3 % tax for Dental MD  on technology services

---

3. Production Tax Rules (Current)

1. Virginia – 0 % on technology services → Top Level Dental VA
2. Maryland – 3 % on technology services → Top Level Dental MD
3. Guardian Dentistry Partners – VA sites → Site-specific override
4. Guardian Dentistry Partners – MD sites → Site-specific override

Validation tip: Ignore the Client/Site “Tax Rule” column—createCreate and save a testsample invoiceinvoice; toinspect confirmline-item thetax correctamounts tax.and totals.

---

4. Feature Gaps & Work-arounds

Need	Current Work-around	Status
Region-code filtering ofin Tax Rules	Create separateSeparate site-specific rules for multi-state clients operating in multiple states	Not yet supported (feature request logged)
Additional Top Levels for non-dental industries (Technology, Government, etc.)	Temporarily map to state-based dental Top Levels so tax applies	Technology and Government Top Levels created

---

5. Lifecycle & Recalculation Rules

Scenario	Required action	Reason
Recurring invoice line items	SetEnable Recalculate Tax = On foron each line.line	Without it, thelines line retains itskeep original tax after rule changes.changes
Templates & recurring profiles	After any rule change, open the profile ➔→ enable/confirmactivate Recalculate Tax , then→ save.save	The flagFlag lives on the template; it is not retro-applied.applied
Invoices already generated	Use Regenerate (or recreate) so new rules apply.apply	Taxes are applied only apply at generation; existing invoices do not update automatically.generation
Draft one-off invoices	Simply saveSave again to trigger rule evaluation.evaluation	Save action recalculates tax.tax

---

6. Known UI / Logic Quirks

• The Client/Site “Tax Rule” togglesstatus cancolumn bemay out-of-date;lag relybehind onactual rule execution; always verify by viewing the saved invoice lines after save/regenerate.
• Test-invoice feedback sometimes appears inconsistent; stored invoice data is authoritative.lines.

---

7. Operational Checklist

1. Onboarding
   • Assign the most specific Top Level.
   • Place taxable products in the correct Item Group.
2. Testing
   • Generate & save a sample invoice; verify tax lines.
   • For recurring profiles, toggle Recalculate Tax and test.
3. When Tax Rules change
   • Update Templates/Recurring Invoices: ensure Recalculate Tax is enabled.
   • Regenerate outstanding invoices that must reflect new rules.
4. Rule maintenance
   • Keep the rule list lean—one rule per distinct scenario.
   • Document site-level overrides until Region-code support is released.arrives.
5. Permissions
   • Only staff with Tax Rule rights should create or edit rules.