| name | commerce-accounts-receivable |
| description | Manage customer receivables, collections, credit memos, and AR aging. Use when tracking overdue invoices, sending dunning letters, creating write-offs, or generating customer statements. |
Commerce Accounts Receivable
Track customer receivables, manage collections, issue credit memos, and monitor AR aging.
How It Works
- Monitor AR aging to identify overdue accounts.
- Log collection activities (dunning letters, calls, emails).
- Issue credit memos for returns, pricing errors, or goodwill.
- Apply payments and credit memos to outstanding invoices.
- Write off uncollectible balances with approval.
- Generate customer statements.
Usage
- MCP tools:
get_ar_aging, get_customer_ar_aging, log_collection_activity, create_credit_memo, apply_credit_memo, apply_payment_to_invoice, create_write_off, get_customer_statement, get_customer_ar_summary.
- Writes require
--apply.
Collection Statuses
- None -> Reminder1Sent -> Reminder2Sent -> Reminder3Sent -> InCollections -> SentToAgency (or WrittenOff/PromiseToPay/PaymentPlan)
Dunning Letter Types
- Reminder1, Reminder2, Reminder3, DemandLetter, CollectionNotice
Credit Memo Reasons
- ReturnedGoods, PricingError, Overpayment, Damaged, ServiceCredit, GoodwillAdjustment, Other
Write-Off Reasons
- Uncollectible, Bankruptcy, CustomerDispute, SmallBalance, AccountClosed, Deceased, Other
Aging Buckets
- Current, 1-30 days, 31-60 days, 61-90 days, 90+ days
Output
{"status":"dunning_sent","customer_id":"cust_123","dunning_type":"Reminder2","total_overdue":3250.00,"invoices_overdue":3}
Present Results to User
- Customer name and total outstanding balance.
- Aging breakdown by bucket.
- Collection activity history and next recommended action.
- Credit memo and write-off totals.
Troubleshooting
- Credit memo won't apply: verify memo status is Open and invoice has remaining balance.
- Write-off rejected: ensure approver and GL account are provided.
- Aging mismatch: confirm invoice dates and payment applications are current.
References
- references/ar-collections.md
- /home/dom/stateset-icommerce/crates/stateset-core/src/models/accounts_receivable.rs
- /home/dom/stateset-icommerce/crates/stateset-embedded/src/accounts_receivable.rs
