Help Center/Plan Configurator & Compensation Models/How to record a service use against a benefit account
Plan Configurator & Compensation Models•Last updated: 2026-10-20•4 min read
How to record a service use against a benefit account
Draw down a benefit account by one use of a valued service. Known defect: as written, the screen sends both prompt answers under lower-case field names the server does not read.
Have questions or need step-by-step guidance on this topic?
Step-by-Step Procedure
1
Find the account
Under "Service-benefit accounts" locate the member and read "target, used, remaining".
2
Click "Record use"
The screen asks for "serviceId (service id)" and then "useId (unique use id)". The useId makes a retry safe.
3
Read the result
The server rejects the use if the service has no approved valuation (decision PB-D1) or the remaining benefit is smaller than the value.
Expected Operational Outcome
The account's "used" figure increases by the service value. Nothing here moves cash.
Troubleshooting & Failure Modes
Symptom: Fails although you typed both values
Likely Cause: Known defect: the answers are sent as serviceid and useid, while the server reads serviceId and useId (bookings/page.tsx, line 36).
Resolution: Report it to engineering; until fixed this button cannot succeed from the screen.
Symptom: Error SERVICE_NOT_VALUED
Likely Cause: No approved valuation.
Resolution: Record a valuation first.
Symptom: Error INSUFFICIENT_BENEFIT
Likely Cause: The remaining benefit is below the value.
Resolution: Check "remaining".
Was this guide helpful?
Help us refine our platform documentation