withhold_earnback
What a measure result is worth under a capitation withhold. A state holds back a share of capitation from a managed care organisation and releases it on measure performance; declare the capitation, the withhold share and the menu of measures with their earn-back shares and their results, and this says what came back and what did not. Route here whenever somebody is asking what passing or missing a measure cost them under a withhold arrangement. `capitation` is the amount the withhold is taken out of, a positive number of dollars. `withhold_percent` is the share of it held back, written as a decimal share rather than as a whole-number percentage, and a whole number is refused rather than divided on your behalf. `menu` is the list of measures the withheld pool is released against: each entry carries the measure's name, its earn-back share of the pool, and a declared result of passed or not passed. The shares must sum to one, because the menu accounts for the whole pool, and shares that do not are refused rather than rescaled: shares below one mean part of the pool is released on something you have not declared, shares above one mean the same result is being paid for twice, and normalising either would hide which of the two it was. THE ANSWER IS TWO TOTALS AND THERE IS NO THIRD. Money released comes back as `earned`, money not released as `forfeited`, each with the measures behind it, and no field anywhere on the payload is the two put together, by addition or by subtraction. That absence is the design rather than an omission. Forfeited money is revenue that never arrived, not a cost that was incurred, and a single figure across the two reads as the second; revenue that never arrived and spending that happened point at different remedies, and the figure that collapses them tells a reader which one they are looking at by hiding it. If you need a single number to quote, build it yourself in the open. The withheld pool is served beside the two totals and is not that third figure: it is the capitation multiplied by the withhold share, fixed before any result is known, and it is what makes a forfeit readable, because a forfeit means one thing against a pool twice its size and another against a pool ten times it. Every dollar figure carries its money kind, because dollars of different kinds arrive in the same shape and nothing in a number tells them apart. Every figure carries a basis of assumption, because you declared all of it: this tool reads no data compartment and measures nothing. WHAT THIS TOOL WILL NOT DO IS SUPPLY YOUR CONTRACT OR FORECAST YOUR YEAR. An argument naming a state is refused by name rather than ignored, because a state's actual withhold measure menu is a contract fact rather than a literature fact: which measures the pool is released against, what share each carries and what counts as passing are written in the contract between that state and the plan, and they differ by plan and by contract year within a single state. A menu this world invented would decide every figure served back. An argument asking how likely a measure is to pass is refused for the same reason in the other direction: that is a forecast about your own future performance, and this tool holds the numbers you typed and no history of your measure rates at all.
Use this form for new arguments. Follow concrete links for known values. Fetch-only readers may be unable to submit new URLs.
Exact input contract
{
"additionalProperties": false,
"properties": {
"capitation": {
"description": "The capitation the withhold is taken out of, as a positive number of dollars. Required; this world ships no default. A share of nothing puts nothing at stake, so a capitation of nothing is refused rather than served as two totals of nothing.",
"exclusiveMinimum": 0,
"type": "number"
},
"menu": {
"description": "The measures the withheld pool is released against. Required, and at least one, because the pool is released against measures and neither total means anything without them. The earn-back shares must sum to one and are refused rather than rescaled if they do not.",
"items": {
"additionalProperties": false,
"properties": {
"earn_back_share": {
"description": "This measure's share of the withheld pool, between zero and one inclusive. The shares across the menu must sum to one.",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"measure": {
"description": "The measure's name, as you write it. Never matched against any vocabulary: this world holds no measure register, so a name it did not recognise would be a name it had no grounds to reject.",
"type": "string"
},
"passed": {
"description": "Whether this measure passed, as you declare it. A declared result rather than a measurement. A score, a percentile or a rate is refused rather than compared against a threshold, because this world holds no thresholds and any bar it compared against would be one it invented.",
"type": "boolean"
}
},
"required": [
"measure",
"earn_back_share",
"passed"
],
"type": "object"
},
"minItems": 1,
"type": "array"
},
"withhold_percent": {
"description": "The share of capitation held back, as a decimal share between zero and one inclusive. Required; this world ships no default. A withhold quoted as a percentage is written here as its decimal share, and a whole-number percentage is refused rather than divided on your behalf, because dividing would answer a question you did not ask.",
"maximum": 1,
"minimum": 0,
"type": "number"
}
},
"required": [
"capitation",
"withhold_percent",
"menu"
],
"type": "object"
}