Salary Attachments in Odoo 18
By Braincuber Team
Published on December 28, 2025
HR managers handling court-ordered wage garnishments create payroll chaos: employee receives child support order requiring $500 monthly deduction, payroll processor manually remembers to subtract $500 each month until Excel reminder missed causing non-compliance, another employee has loan garnishment but HR doesn't track total paid vs total owed so deduction continues 3 months after paid off overpaying $1,500, and audit reveals 12 garnishments across 8 employees with inconsistent deduction amounts—creating legal liability and employee complaints from manual garnishment tracking without systematic automation.
Odoo 18 Salary Attachments automate payroll deductions with attachment types (Child Support/Assignment/Garnishment), automatic payslip deductions each pay period, total amount tracking showing remaining balance, start/end date management, completion status workflow, document attachment for court orders, employee-specific configuration, and integrated payslip reporting—eliminating manual deduction tracking and ensuring legal compliance reducing garnishment errors 95% while maintaining transparent recordkeeping for audits.
Attachment Features: Automated deductions, Multiple types (child support/garnishment/assignment), Amount tracking, Date management, Status workflow, Document storage, Payslip integration, Compliance assurance
What is Salary Attachment?
Legal or administrative function enabling employers to deduct specific amounts from employee paychecks to satisfy:
- Child Support: Court-ordered support payments
- Wage Garnishments: Debt repayments (credit cards, loans, taxes)
- Court Fines: Legal penalties or settlements
- Salary Assignments: Voluntary payment commitments
System guarantees legal compliance while automating deduction process.
Benefits of Salary Attachments
- Automated Deductions: System calculates and applies deductions every pay period
- Legal Adherence: Ensures compliance with court orders and regulations
- Transparent Recordkeeping: Complete audit trail of all deductions
- Secure Transactions: Confidential handling of sensitive information
- Time Savings: Eliminates manual tracking and calculations
- Integrated Reporting: Payslips automatically show deductions
- Error Reduction: 95% fewer mistakes vs manual processing
- Customized Configuration: Flexible setup per employee needs
- Easier Audits: Complete documentation for compliance reviews
Creating Salary Attachment
- Open Payroll module from dashboard
- Go to Contracts → Salary Attachments
- Click New
Attachment Configuration Fields:
- Employee: Select employee from existing list
- Description: Details about attachment (e.g., "Child Support - Case #12345")
- Type: Choose from:
- Child Support: Court-ordered support payments
- Assignment of Salary: Voluntary salary assignments
- Attachment of Salary: Wage garnishments/liens
- Document: Attach court order, legal notice, or agreement
- Pay Slip Amount: Deduction amount per pay period (e.g., $500/month)
- Total Amount: Total owed (e.g., $6,000)
- Start Date: When deductions begin
- Estimated End Date: Auto-calculated based on total/monthly amount
Example Setup:
Child Support Attachment:
- Employee: John Smith
- Description: "Child Support - County Court Order 2024-CS-1234"
- Type: Child Support
- Document: court_order.pdf (uploaded)
- Pay Slip Amount: $500
- Total Amount: $6,000
- Start Date: Jan 1, 2024
- Estimated End Date: Dec 31, 2024 (12 months × $500)
- Status: Running
Attachment Workflow
Status: Running
Once created, attachment enters Running state:
- Deductions applied automatically every pay period
- Amount deducted from employee payslip
- Remaining balance tracked
- Continues until total amount reached or manually completed
Automatic Deduction Process:
- Payroll period processed (e.g., monthly on Jan 31)
- System checks active salary attachments for employee
- Deducts $500 from gross salary
- Shows deduction line on payslip: "Child Support Attachment: -$500"
- Updates remaining balance: $6,000 - $500 = $5,500 remaining
- Repeats next pay period
Marking as Completed:
Two completion scenarios:
1. Automatic Completion:
When total amount paid ($6,000 deducted across 12 months):
- System automatically marks as Completed
- Stops future deductions
- Attachment archived
2. Manual Completion:
If court order terminated early or employee settles debt:
- Open attachment record
- Click Mark as Completed button
- Status changes to Completed
- Deductions stop immediately
Payslip Integration
Salary attachments appear on employee payslips automatically:
Payslip Display Example:
| Description | Amount |
| Gross Salary | $5,000 |
| Tax Withholding | -$750 |
| Child Support Attachment | -$500 |
| Net Salary | $3,750 |
Best Practices
Always Attach Legal Documents: Document field not optional—upload court order, garnishment notice, or written agreement. Audit requires proof deduction authorized. Missing documentation = legal liability if employee disputes deduction.
Set Accurate Total Amounts: Total Amount = sum of all payments owed, not monthly amount. Child support $500/month for 12 months = $6,000 total. Wrong total ($500) = deduction stops after 1 month not 12 months.
Review Running Attachments Monthly: Monthly payroll check: which attachments active? Any completed but still Running? Prevents over-deduction. Employee paid $6,000 but attachment still Running = extra deduction until manually stopped.
Multiple Attachments
Employees can have multiple simultaneous attachments:
Example: Employee has 3 attachments:
- Child Support: $500/month
- Loan Garnishment: $200/month
- Court Fine: $100/month
- Total Deductions: $800/month automatically
Note: Check local laws for maximum garnishment percentages (often 25% disposable income). Odoo doesn't enforce limits—HR responsibility.
Conclusion
Odoo 18 Salary Attachments automate payroll deductions through type-specific configuration, automatic payslip integration, total amount tracking, and status workflow management. Ensure legal compliance and eliminate manual garnishment errors reducing mistakes 95% while maintaining transparent audit trails for regulatory compliance.
