TownSq

Recurring Charges

Core information for recurring assessments or fees applied automatically to accounts based on unit type and schedule. This is how regular HOA dues, maintenance fees, and other periodic charges are defined.

Migration Requirements

Required for Import

Yes - Required

Retention History

Include all currently active recurring charges for each association. Retain historical recurring charge definitions that were active within the last 2 fiscal years for audit trail and historical billing reconciliation.

Usage Notes

Each recurring charge applies to all units of a specific type within the association
Best practice: Use consistent frequency across all charges for an association
Unit Type field can match Unit Types by ID, name, or any unique identifier
Assessment Amount is charged per occurrence based on frequency (e.g., $250 monthly = $3,000/year)
Include On Direct Debit determines if homeowners with ACH setup will have this charge auto-withdrawn

Fields (10)

Expand a field to see example values and, where necessary, additional business context

FieldTypeDescriptionAttributes
Recurring Charge Main
Recurring Charge IDTextUnique identifier for the source system Recurring Charge
Required

Recurring Charge ID

Unique identifier for the source system Recurring Charge

Examples

RC-001
12345
REC_CHG_001

Business Context

This field identifies unique recurring charge records from your source system, enabling updates after initial import. Provide any unique identifier from your system—numeric IDs, text codes, or concatenated values all work.

Association IDTextYour system's unique identifier for the HOA/association
Required
Include on Direct Debit?True/FalseWhether this charge should be included in automatic bank drafts
Required
Unit TypeTextThe type of unit this charge applies to
Required
Charge TypeTextCategory or name of this recurring charge
Required
Assessment AmountNumberThe dollar amount charged per period
Required
Schedule
FrequencyTextHow often this charge is applied (e.g., Monthly, Quarterly, Annual, Semi-Annual)
Required
Begin DateDateWhen this recurring charge starts
Required
End DateDateWhen this recurring charge ends
Required
Additional Data
Additional DataJSON ObjectAny extra information from your source system
Optional

Relations

associationAssociationsmany-to-one

The HOA/community this recurring charge belongs to

unit_typeUnit Typesmany-to-one

The unit type this charge applies to (matched by ID, name, or any unique identifier)

Recurring Charges