Legacy Debt Payment (舊帳收款)

Also known as: Pre-system debt collection · legacy_debt · Pre-adoption receivable

Recording payment for debts a customer accumulated before adopting MeiYe Zhan. Counts toward cash collection but NOT toward performance — prevents inflated performance via backfilling pre-system history.

Full definition

Legacy Debt Payment (舊帳收款) is the entry type for collecting debts originated outside MeiYe Zhan — e.g., a customer owed NT$5,000 on paper-card bookkeeping before the shop adopted the system. The shop wants to record the collection event, but the original service was performed outside the system, with no treatment record. The system tags these entries `serviceType: 'legacy_debt'` and `awardsPerformance: false`, excluding them from all performance calculations at the source.

Why this concept matters

New shops onboarding often have unsettled paper-era debts. If "backfill" entries counted toward performance: (1) beauticians would collect commission on revenue they already earned long ago — shop loses money; (2) dashboards would show artificially inflated post-launch performance, misleading management; (3) monthly trend charts would show fake startup spikes. Cleanly excluding "backfilled legacy debt" preserves both commercial integrity and analytical accuracy.

How MeiYe Zhan handles it

Added `legacy_debt` to `Treatment.serviceType` enum. `isPerformanceEligible(svc)` filters this at every performance entry point (v1.0.38 finally consolidated three parallel mirror implementations into one shared helper). **Reports has a special route**: legacy_debt with `awardsPerformance=true` (rare owner choice) → counts toward "product revenue"; with `awardsPerformance=false` → counts toward "package revenue" (matching i18n copy "treated as package revenue, not awarded as performance"). Customer detail page, dashboard, and attendance payroll exclude these entries entirely.

Concrete example

Shop adopts MeiYe Zhan April 2026; client A owes NT$3,000 from prior paper bookkeeping. Shop records "Legacy Debt Payment NT$3,000, paid 2026-05-01, cash". Client account: +NT$3,000 settled. Shop cash inflow: +NT$3,000. Beautician performance: +0. Dashboard performance card: +0. Month-end reports show this NT$3,000 in product/package columns (per policy setting) but the beautician performance table strictly remains 0.

Related terms

Option A Performance Recognition

MeiYe Zhan's revenue-recognition model: performance is credited to the beautician on the day the customer pays cash. Unpaid balances are credited only when paid back later.

Deep-dive articles

Paper to Cloud: 30-Day Transition Schedules for 3 Beauty Shop Sizes

Solo studio, 3-person shop, 10-person operation — concrete 30-day migration schedules from paper cards to cloud SaaS, with each day's tasks mapped out.

Labor Law in Beauty Industry: 6 Leave Types and Salary Deduction

Scheduled, annual, public holiday, sick, personal, bereavement — the 6 leave types beauty shops most confuse, with each one's deduction rules and calculation examples.

Comparisons

MeiYe Zhan vs Paper Customer Cards | Cloud SaaS vs Paper Comparison

If you've used paper customer cards for 20 years, is switching to cloud SaaS actually worth it? 12-dimension comparison, with honest cases where paper still wins.

MeiYe Zhan vs Excel + LINE | Structured SaaS vs DIY Solutions

Excel spreadsheets + LINE messages — beauty shops' most common DIY combo. Cheap, flexible, but how does it actually compare to a professional SaaS? Real time-cost analysis.

See how MeiYe Zhan handles Legacy Debt Payment (舊帳收款) in practice?

30-day free trial, no credit card required. From NT$999/month.

Start free trial