From eb44138fd1050ecf69fc2b7627ba8a33be404948 Mon Sep 17 00:00:00 2001
From: jb101010-2 <168106462+jb101010-2@users.noreply.github.com>
Date: Mon, 26 May 2025 12:54:51 +0200
Subject: [PATCH] Update suez_water describe statistics (#35882)

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
---
 source/_integrations/suez_water.markdown | 55 +++++++++++++++++++-----
 1 file changed, 44 insertions(+), 11 deletions(-)

diff --git a/source/_integrations/suez_water.markdown b/source/_integrations/suez_water.markdown
index b55246ba2ef..afabfa5e51b 100644
--- a/source/_integrations/suez_water.markdown
+++ b/source/_integrations/suez_water.markdown
@@ -23,6 +23,50 @@ The **Suez Water** {% term integration %} fetches your water consumption data fr
 - The **Water usage yesterday** sensor shows yesterday's water consumption data if that data is available.
 - The **Water price** sensor shows the current water price in euros per cubic meter (€/m3).
 
+### Extra attributes
+
+Extra attributes of `Water usage yesterday` sensor:
+
+- Daily consumption for the current month
+- Daily consumption for the previous month
+- Monthly consumption for the last 26 months
+- Highest monthly consumption
+- Last year total consumption
+- Current year total consumption
+
+## Energy
+
+The integration provides statistics containing all available data from Suez.
+The data is fetched every 12 hours and is updated once a day by Suez.
+
+You can find the statistics in {% my developer_statistics title="**Developer Tools** > **Statistics**"%} and search for "suez_water".
+**Note: Due to Suez's daily update schedule, data for the current day will not be available, and yesterday's data may be delayed depending on when you check**
+
+At the initial setup, the integration pulls historical daily usage since the counter installation.
+
+{% details "Prerequisites" %}
+
+- The Energy dashboard must be enabled in your Home Assistant instance. If you haven't set it up yet, please refer to the [Energy dashboard documentation](/home-assistant-energy/).
+
+{% enddetails %}
+
+In the configuration of the energy dashboard ({% my config_energy title="**Settings** > **Dashboards** > **Energy**" %}):
+
+1. Select **Add consumption** for **Water source**.
+2. Select **Suez water Consumption** followed by your counter ID (e.g., "Suez water Consumption 123456789") for the **consumed water**.
+3. Select **Suez water Cost** followed by your counter ID for the **total price**
+
+### Statistics details
+
+- **Suez water consumption** (`suez_water_water_consumption_statistics_{counter_id}`):
+  - Contains daily water consumption in liters
+  - Provides both state and sum statistics for each day
+
+- **Suez water cost** (`suez_water_water_cost_statistics_{counter_id}`):
+  - Contains daily cost calculations in euros
+  - Provides both state and sum statistics for each day
+  - **Important**: Historical costs are calculated using the current water price since historical price information is not available. If water prices have changed over time, the calculated historical costs may not match your actual bills.
+
 {% include integrations/config_flow.md %}
 
 {% configuration_basic %}
@@ -50,17 +94,6 @@ Counter ID:
 
 {% endconfiguration_basic %}
 
-## Extra attributes
-
-Extra attributes of `Water usage yesterday` sensor:
-
-- Daily consumption for the current month
-- Daily consumption for the previous month
-- Monthly consumption for the last 26 months
-- Highest monthly consumption
-- Last year total consumption
-- Current year total consumption
-
 ## Removing the integration
 
 This integration can be removed by following these steps: