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?

Ask AI Copilot

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