Calculate savings
Estimate what a household saves per year on this plan against the tariff it pays today, or against the market benchmark when none is given. All amounts are EUR per year, gross.
The household is described by its base consumption plus one object per asset it owns. Presence is the signal: send assets.ev and the household has an electric vehicle. The optimization rate and the §14a EnWG eligibility follow from that mix and from what the plan sells; they cannot be requested, because a household that qualifies is quoted as qualifying and whether it later declines the registration is a signup answer rather than a property of the setup.
The saving is the difference between two quotes on this plan with the same usage, one at market prices without §14a EnWG and one at the derived rate with the eligible modules, so components is that difference line by line and sums to savings. Nothing is read or written; the calculation is performed and discarded.
The fields the response and Calculate a quote share are named and shaped the same: post usage, optimization_rate and grid_fee_reductions back unchanged to price the same household there and reconcile every figure. Feed-in plans are rejected with 400 BAD_REQUEST.
Authorizations
Body
The household to calculate the savings for
What the household owns. Presence is the signal: send the object and the household has that asset, leave it out and it has none. Send {} for a household with none of them. The optimization rate and the §14a EnWG eligibility on the response are derived from this mix, they cannot be requested.
Response
The savings breakdown
The two bills the saving is the difference between, EUR gross per year, all-in: supplier base fee, grid and metering fees, levies, taxes and energy. Neither includes the imputed cost of self-generated solar or feed-in revenue, so this is what gets invoiced. before is the market benchmark, or the current_tariff that was sent.
Where the saving comes from, in the order it stacks up: tariff compares the plan against the comparison tariff before §14a EnWG and before optimization, grid_fee_reductions is what the modules deduct on top of that, and optimization is what load shifting adds again. Each line compares against what the ones before it left off, so the amounts are strictly additive and sum to savings.