Add docs for energyzero integration (#25437)

source/_integrations/energyzero.markdown

@@ -0,0 +1,53 @@
+---
+title: EnergyZero
+description: Instructions on how to integrate EnergyZero within Home Assistant.
+ha_category:
+  - Energy
+ha_release: 2023.2
+ha_iot_class: Cloud Polling
+ha_config_flow: true
+ha_codeowners:
+  - '@klaasnicolaas'
+ha_domain: energyzero
+ha_platforms:
+  - sensor
+ha_quality_scale: platinum
+ha_integration_type: integration
+---
+
+The EnergyZero integration integrates the [EnergyZero](https://www.energyzero.nl/) API platform with Home Assistant.
+
+The integration makes it possible to retrieve the dynamic energy/gas prices
+from EnergyZero in order to gain insight into the price trend of the day and
+to adjust your consumption accordingly.
+
+Partners who purchase their energy through EnergyZero:
+
+- [ANWB Energie](https://www.anwb.nl/huis/energie/anwb-energie)
+- [Mijndomein Energie](https://www.mijndomein.nl/energie)
+- [Energie van Ons](https://www.energie.vanons.org)
+- [GroeneStroomLokaal](https://www.groenestroomlokaal.nl)
+
+{% include integrations/config_flow.md %}
+
+## Sensors
+
+The EnergyZero integration creates a number of sensor entities for both gas and electricity prices.
+
+### Energy market price
+
+Every day around **14:00 UTC time**, the new prices are published for the following day.
+
+- The `current` and `next hour` electricity market price
+- Average electricity price of the day
+- Lowest energy price
+- Highest energy price
+- Time of day when the price is highest
+- Time of day when the price is at its lowest
+- Percentage of the current price compared to the maximum price
+
+### Gas market price
+
+For the dynamic gas prices, only entities are created that display the
+`current` and `next hour` price because the price is always fixed for
+24 hours; new prices are published every morning at **05:00 UTC time**.