Neues COM Messwert (#1042)

addresses #994 
Neues COM Messwert ergänzt, wie im Workshop vom 11.11.2025 beschlossen

Author: XaMa928

src/bo4e/__init__.py

@@ -149,6 +149,7 @@
     "Messart",
     "Messgroesse",
     "Messpreistyp",
+    "Messwert",
     "Messwerterfassung",
     "Messwertstatus",
     "Messwertstatuszusatz",
@@ -277,6 +278,7 @@
 from .com.lastprofil import Lastprofil
 from .com.marktgebietinfo import MarktgebietInfo
 from .com.menge import Menge
+from .com.messwert import Messwert
 from .com.positionsaufabschlag import PositionsAufAbschlag
 from .com.preis import Preis
 from .com.preisgarantie import Preisgarantie

src/bo4e/com/messwert.py

@@ -0,0 +1,43 @@
+"""
+Contains Messwert class
+"""
+
+from typing import TYPE_CHECKING, Annotated, Literal, Optional
+
+import pydantic
+from pydantic import Field
+
+from ..enum.comtyp import ComTyp
+from ..utils import postprocess_docstring
+from .com import COM
+
+if TYPE_CHECKING:
+    from ..com.menge import Menge
+    from ..enum.messwertstatus import Messwertstatus
+    from ..enum.messwertstatuszusatz import Messwertstatuszusatz
+
+
+@postprocess_docstring
+class Messwert(COM):
+    """
+    Abbildung eines Messwertes mit Stati, Zeitpunkt und Wert.
+
+    .. raw:: html
+
+        <object data="../_static/images/bo4e/com/Messwert.svg" type="image/svg+xml"></object>
+
+    .. HINT::
+        `Messwert JSON Schema <https://json-schema.app/view/%23?url=https://raw.githubusercontent.com/BO4E/BO4E-Schemas/{__gh_version__}/src/bo4e_schemas/com/Messwert.json>`_
+
+    """
+
+    typ: Annotated[Literal[ComTyp.MESSWERT], Field(alias="_typ")] = ComTyp.MESSWERT
+
+    messwertstatus: Optional["Messwertstatus"] = None
+    """Gibt den Status des Messwerts an."""
+    messwertstatuszusatz: Optional["Messwertstatuszusatz"] = None
+    """Gibt den Status Zusatz des Messwerts an."""
+    zeitpunkt: Optional[pydantic.AwareDatetime] = None
+    """Gibt den Zeitpunkt des Messwerts an."""
+    wert: Optional["Menge"] = None
+    """Gibt die gemessene Menge an."""

src/bo4e/enum/comtyp.py

@@ -38,6 +38,7 @@ class ComTyp(StrEnum):
     LASTPROFIL = "LASTPROFIL"
     MARKTGEBIETINFO = "MARKTGEBIETINFO"
     MENGE = "MENGE"
+    MESSWERT = "MESSWERT"
     POSITIONSAUFABSCHLAG = "POSITIONSAUFABSCHLAG"
     PREIS = "PREIS"
     PREISGARANTIE = "PREISGARANTIE"

tests/test_messwert.py

@@ -0,0 +1,28 @@
+from datetime import datetime, timezone
+
+import pytest
+
+from bo4e import Menge, Messwert, Messwertstatus, Messwertstatuszusatz
+from tests.serialization_helper import assert_serialization_roundtrip
+
+
+class TestMesswert:
+    @pytest.mark.parametrize(
+        "messwert",
+        [
+            pytest.param(
+                Messwert(
+                    messwertstatus=Messwertstatus.ABGELESEN,
+                    messwertstatuszusatz=Messwertstatuszusatz.Z84_LEERSTAND,
+                    zeitpunkt=datetime(2022, 2, 1, 0, 0, 0, tzinfo=timezone.utc),
+                    wert=Menge(),
+                ),
+                id="all attributes at first level",
+            ),
+        ],
+    )
+    def test_serialization_roundtrip(self, messwert: Messwert) -> None:
+        """
+        Test de-/serialisation roundtrip.
+        """
+        assert_serialization_roundtrip(messwert)