> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.rabot.energy/llms.txt > Use this file to discover all available pages before exploring further. # Tariff Calculator # Price Components Response All monetary values are returned **gross (including 19% VAT)** unless otherwise noted. ## §41a EnWG Compliance Note > Under the §41a EnWG pre-contractual information requirements, all fields marked **§41a Required** must > be displayed to the customer before contract conclusion. For **fixed-price (Fix) tariffs**, the total > price must additionally be disclosed as an **annual figure** (`pricePerMonth × 12`) based on the > stated annual consumption. ## RABOT Recommended Breakdown display ### workPriceComponents / Geschätzter Arbeitspreis pro kWh brutto * averageExchangePrice / Energiebeschaffung * greenCertificateSurcharge + workPriceAdjustment + serviceFee / Sonstige Beschaffungskosten * powerFee / Stromsteuer * gridFee / Netznutzungsentgelt * powerHeatCouplingFee / KWKG-Umlage * concessionFee / Konzessionsabgabe * offshoreFee / Offshore-Umlage * p19Fee / §19 StromNEV-Umlage #### basePriceComponents / Grundpreis brutto * gridFee / Netznutzung * meteringFee / Messstellenbetrieb * baseServiceFee / Servicegebühr *** ## Top-Level Fields | Field | Type | Unit | Description | §41a Required | | ---------------------- | ------ | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | | `pricePerMonth` | number | €/Monat | The estimated average monthly pre-payment amount to be quoted to the customer. Calculated as `(estimatedWorkPrice × estimatedConsumption) + basePricePerMonth`. | ✅ Yes | | `unitPrice` | number | ct/kWh | The working price per kWh to be quoted to the customer. Equivalent to `effectiveWorkPrice` when no price cap is active. | ✅ Yes | | `basePricePerMonth` | number | €/Monat | The total monthly base price (Grundpreis), inclusive of grid fixed fee, metering fee, and the Rabot/WL partner service fee. | ✅ Yes | | `estimatedConsumption` | number | kWh/Monat | The `yearlyConsumptionKwh` from the request body divided by 12. Used to calculate `pricePerMonth`. | ⚙️ Calculation input | | `estimatedWorkPrice` | number | ct/kWh | The working price per kWh before any price cap is applied. Equals `unitPrice` when no price cap campaign is active. | ✅ Yes | | `expectedWorkPrice` | number | €/Monat | `estimatedWorkPrice × estimatedConsumption`. The estimated monthly electricity cost before base price. Displayed as *Arbeitspreis gesamt*. | ✅ Yes | | `effectiveWorkPrice` | number | ct/kWh | The final working price per kWh after any price cap discount is applied. Equals `estimatedWorkPrice` when no cap is active. Use this value — not `estimatedWorkPrice` — when displaying the Arbeitspreis to customers. | ✅ Yes | | `baseServiceFee` | number | €/Monat | The Rabot + WL partner margin component of the base price (Servicegebühr). Displayed separately in the Grundpreis breakdown. | ✅ Yes | | `variableServiceFee` | number | ct/kWh | The Rabot + WL partner margin component of the working price, expressed in ct/kWh. Repeated as `workPriceDetails.serviceFee`. Zero for fix tariffs where the margin is captured in the fixed-price reconciliation. | ✅ Yes (if non-zero) | *** ## `basePriceDetail.fees` Breakdown of the components that make up `basePricePerMonth`, excluding the `baseServiceFee`. | Field | Type | Unit | Description | §41a Required | | --------------------- | -------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | | `gridFee` | number | €/Monat | Fixed monthly grid usage fee (*Netznutzung*) charged by the Verteilnetzbetreiber (DSO) for access to the distribution grid. Location-dependent. | ✅ Yes | | `meteringFee` | number | €/Monat | Fixed monthly metering/meter operation fee (*Messstellenbetrieb*) charged by the Verteilnetzbetreiber, gMSB, or wMSB. | ✅ Yes | | `basePriceAdjustment` | number \| null | €/Monat | Additional base price adjustment (*Sonstige Verrechnungskosten*). `null` when no adjustment applies. | ✅ Yes (if non-null) | *** ## `workPriceDetails` Full per-kWh breakdown of all components making up `estimatedWorkPrice` / `effectiveWorkPrice`. | Field | Type | Unit | Description | §41a Required | | ---------------------- | ------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | | `serviceFee` | number | ct/kWh | Variable Rabot + WL partner margin component of the working price (*Servicegebühr*). Identical to `variableServiceFee` above. Zero for fix tariffs. | ✅ Yes (if non-zero) | | `averageExchangePrice` | number | ct/kWh | EPEX Spot Day-Ahead Market average price used to generate the quote (*Energiebeschaffung*). Typically the average of the last 3, 6, or 12 months. | ✅ Yes | ### `workPriceDetails.fees` | Field | Type | Unit | German Display Label | Description | §41a Required | | ------------------------------ | -------------- | ------ | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | | `greenCertificateSurcharge` | number | ct/kWh | *sonstige Beschaffungskosten* | Cost of the HKN (Herkunftsnachweis) green electricity certificate, certifying the power as coming from renewable sources. Combined with `workPriceAdjustment` and `serviceFee` for display. | ✅ Yes (grouped) | | `powerFee` | number | ct/kWh | *Stromsteuer* | German federal electricity excise tax (*Stromsteuergesetz*). Fixed federal levy; currently \~2.05 ct/kWh net / \~2.44 ct/kWh gross (incl. VAT). | ✅ Yes | | `gridFee` | number | ct/kWh | *Netznutzungsentgelt* | Variable per-kWh grid usage fee charged by the Verteilnetzbetreiber (DSO). Location-dependent (varies by postal code / grid area). | ✅ Yes | | `powerHeatCouplingFee` | number | ct/kWh | *KWKG-Umlage* | Surcharge under the Combined Heat and Power Act (*Kraft-Wärme-Kopplungsgesetz*) to fund CHP plant operators. | ✅ Yes | | `concessionFee` | number | ct/kWh | *Konzessionsabgabe* | Municipal concession levy paid by the grid operator to municipalities for use of public rights-of-way for power lines. Varies by municipality size (1.32–2.39 ct/kWh, capped by *Konzessionsabgabenverordnung* KAV). | ✅ Yes | | `offshoreFee` | number | ct/kWh | *Offshore-Umlage* | Surcharge to fund costs and liabilities for offshore wind farm grid connections (*Offshore-Netzumlage*). | ✅ Yes | | `p19Fee` | number | ct/kWh | *§19 StromNEV-Umlage* | Surcharge to compensate grid operators for revenue lost from customers granted individual reduced grid fees under §19(2) of the Electricity Network Charges Ordinance (*Stromnetzentgeltverordnung*). | ✅ Yes | | `workPriceAdjustment` | number \| null | ct/kWh | *sonstige Beschaffungskosten* | Additional working price procurement cost adjustment. Combined with `greenCertificateSurcharge` and `serviceFee` for display. `null` when no adjustment applies. | ✅ Yes (if non-null, grouped) | | `effectiveWorkPriceAdjustment` | number \| null | ct/kWh | *Differenz zur Preisobergrenze* | Discount delta applied when an active price cap campaign reduces the `effectiveWorkPrice` below the `estimatedWorkPrice`. `null` when no price cap is active. | ✅ Yes (if non-null) | *** ## RabotShare rabotShare is not required to be displayed for whitelabel or affiliate tariffs. ## Display Notes ### Dynamic tariffs Display all components individually as shown in the funnel. The `sonstige Beschaffungskosten` line is computed as: ``` sonstige Beschaffungskosten = greenCertificateSurcharge + workPriceAdjustment + serviceFee ``` ### Fix tariffs (additional §41a requirement) In addition to the per-component breakdown, the total price must be disclosed as an **annual figure** based on the stated annual consumption: | Display Label | Computation | | ----------------------------------- | ---------------------------------------------------------- | | Gesamtpreis pro Jahr (Arbeitspreis) | `effectiveWorkPrice (ct/kWh) × yearlyConsumptionKwh / 100` | | Gesamtpreis pro Jahr (Grundpreis) | `basePricePerMonth × 12` | | **Gesamtpreis pro Jahr (Brutto)** | `pricePerMonth × 12` |