Merge pull request #138 from BerriJ/automated-postman-update

Update Postman Documentation

Author: BerriJ

misc/endpoints/Balancing/IFs mFRR 9.9, aFRR 9.6&9.8 Changes to Bid Availability Archives.json

@@ -0,0 +1,48 @@
+{
+  "name": "IFs mFRR 9.9, aFRR 9.6&9.8 Changes to Bid Availability Archives",
+  "method": "GET",
+  "query": [
+    {
+      "key": "documentType",
+      "value": "B45",
+      "description": "[M] B45 = Bid Availability Document"
+    },
+    {
+      "key": "processType",
+      "value": "A47",
+      "description": "[M] A47"
+    },
+    {
+      "key": "Domain",
+      "value": "10YDE-VE-------2",
+      "description": "[M] EIC code of a Scheduling Area or LFA"
+    },
+    {
+      "key": "periodStart",
+      "value": "202309232200",
+      "description": "[M] Pattern yyyyMMddHHmm e.g. 201601010000"
+    },
+    {
+      "key": "periodEnd",
+      "value": "202309242200",
+      "description": "[M] Pattern yyyyMMddHHmm e.g. 201601010000"
+    },
+    {
+      "key": "storageType",
+      "value": "archive",
+      "description": "[M] Used to request archives"
+    },
+    {
+      "key": "businessType",
+      "value": "C46",
+      "description": "[O] C40 = Conditional bid; C41 = Thermal limit; C42 = Frequency limit; C43 = Voltage limit; C44 = Current limit; C45 = Short-circuit current limits; C46 = Dynamic stability limit",
+      "disabled": true
+    },
+    {
+      "key": "offset",
+      "value": "100",
+      "description": "[O] Integer: Zero‑based index of the first archive to return. The offset parameter paginates the response in batches of 100 archives (e.g., offset = n returns the archives in the range n+1 to n+100).",
+      "disabled": true
+    }
+  ]
+}

misc/endpoints/Market/11.1 Continuous Allocations - Offered Transfer Capacity.json

@@ -42,12 +42,6 @@
       "value": "20240515123900",
       "description": "[O] For Offered Capacity Evolution can be quried with datetime in numeric. For example 20210803113900000 for evolution update date time 03.08.2021 13:39:00.000. If there is no OC evolution version with requested update_DateAndOrTime the system selects OC version valid in the given time (e.g., closest previous update_DateAndOrTime). The most recent publish OC version is provided in case the update_DateAndOrTime parameter is omitted. The most recent published OC version and intermediate OC versions is distinguished by document type: −   Intermediate OC values: A31 −   Most recent published OC values: B33",
       "disabled": true
-    },
-    {
-      "key": "offset",
-      "value": "0",
-      "description": "[O] Integer: Zero‑based index of the first TimeSeries to return. The offset parameter paginates the response in batches of 100 TimeSeries (e.g., offset = n returns the TimeSeries in the range n+1 to n+100).",
-      "disabled": true
     }
   ]
 }

misc/endpoints/README.md

@@ -66,6 +66,7 @@ To regenerate this list, run:
 - [12.3.B&C Balancing energy bids](Balancing/12.3.B%26C%20Balancing%20energy%20bids.json)
 - [12.3.B&C Balancing energy bids archives](Balancing/12.3.B%26C%20Balancing%20energy%20bids%20archives.json)
 - [IFs mFRR 9.9, aFRR 9.6&9.8 Changes to Bid Availability](Balancing/IFs%20mFRR%209.9%2C%20aFRR%209.6%269.8%20Changes%20to%20Bid%20Availability.json)
+- [IFs mFRR 9.9, aFRR 9.6&9.8 Changes to Bid Availability Archives](Balancing/IFs%20mFRR%209.9%2C%20aFRR%209.6%269.8%20Changes%20to%20Bid%20Availability%20Archives.json)
 - [12.3.E Aggregated Balancing Energy Bids (GL EB)](Balancing/12.3.E%20Aggregated%20Balancing%20Energy%20Bids%20%28GL%20EB%29.json)
 - [IFs 3.10, 3.16 & 3.17 Netted and Exchanged Volumes](Balancing/IFs%203.10%2C%203.16%20%26%203.17%20Netted%20and%20Exchanged%20Volumes.json)
 - [IFs 3.10, 3.16 & 3.17 Netted and Exchanged Volumes per Border](Balancing/IFs%203.10%2C%203.16%20%26%203.17%20Netted%20and%20Exchanged%20Volumes%20per%20Border.json)

misc/endpoints/all_endpoints.json

@@ -77,6 +77,7 @@
       "12.3.B&C Balancing energy bids",
       "12.3.B&C Balancing energy bids archives",
       "IFs mFRR 9.9, aFRR 9.6&9.8 Changes to Bid Availability",
+      "IFs mFRR 9.9, aFRR 9.6&9.8 Changes to Bid Availability Archives",
       "12.3.E Aggregated Balancing Energy Bids (GL EB)",
       "IFs 3.10, 3.16 & 3.17 Netted and Exchanged Volumes",
       "IFs 3.10, 3.16 & 3.17 Netted and Exchanged Volumes per Border",

src/entsoe/Balancing/__init__.py

@@ -12,6 +12,7 @@
     BalancingEnergyBids,
     BalancingEnergyBidsArchives,
     ChangesToBidAvailability,
+    ChangesToBidAvailabilityArchives,
     CrossBorderMarginalPricesForAFRR,
     CurrentBalancingState,
     ElasticDemands,
@@ -43,6 +44,7 @@
     "BalancingEnergyBidsArchives",
     "BalancingEnergyBids",
     "ChangesToBidAvailability",
+    "ChangesToBidAvailabilityArchives",
     "CrossBorderMarginalPricesForAFRR",
     "CurrentBalancingState",
     "ElasticDemands",

src/entsoe/Balancing/specific_params.py

@@ -1183,6 +1183,68 @@ def __init__(
         )
 
 
+class ChangesToBidAvailabilityArchives(Balancing):
+    """Parameters for IFs mFRR 9.9, aFRR 9.6&9.8 Changes to Bid Availability Archives.
+
+    Data view:
+    https://transparency.entsoe.eu/balancing/r2/changesToBidAvailability/show
+
+    Fixed parameters:
+
+    - documentType: B45 (Bid Availability Document)
+    - processType: A47 (Manual frequency restoration reserve)
+    - storageType: archive
+
+    Optional parameters:
+    - businessType: C40=Conditional bid, C41=Thermal limit, C42=Frequency limit,
+                   C43=Voltage limit, C44=Current limit,
+                   C45=Short-circuit current limits,
+                   C46=Dynamic stability limit
+
+    Notes:
+    - This is the archived version of changes to bid availability
+    - The offset parameter paginates the response in batches of 100 archives
+    """
+
+    code = "IF_mFRR_aFRR_9.6_9.8_9.9_Archives"
+
+    def __init__(
+        self,
+        period_start: int,
+        period_end: int,
+        domain: str,
+        # Optional balancing-specific parameters
+        business_type: Optional[str] = None,
+        # Additional common parameters
+        offset: int = 0,
+    ):
+        """
+        Initialize changes to bid availability archives parameters.
+
+        Args:
+            period_start: Start period (YYYYMMDDHHMM format)
+            period_end: End period (YYYYMMDDHHMM format)
+            domain: EIC code of Scheduling Area or LFA
+            business_type: C40=Conditional bid, C41=Thermal limit, C42=Frequency limit,
+                          C43=Voltage limit, C44=Current limit, C45=Short-circuit limit,
+                          C46=Dynamic stability limit
+            offset: Zero-based index of the first archive to return (batches of 100)
+        """
+        # Initialize with preset and user parameters
+        super().__init__(
+            document_type="B45",
+            period_start=period_start,
+            period_end=period_end,
+            domain=domain,
+            process_type="A47",
+            business_type=business_type,
+            offset=offset,
+        )
+
+        # Add the storageType parameter specific to archives endpoint
+        self.add_optional_param("storageType", "archive")
+
+
 class BalancingBorderCapacityLimitations(Balancing):
     """Parameters for IFs 4.3 & 4.4 Balancing Border Capacity Limitations.
 

src/entsoe/utils/utils.py

@@ -31,10 +31,10 @@ def format_entsoe_datetime(dt: datetime) -> int:
     """
     Format datetime object to ENTSOE datetime format (YYYYMMDDHHMM).
 
-    Convert a (tz-aware) datetime to UTC and format it as an integer in the 
-    ENTSOE format. If the datetime is naive, it is assumed to be in UTC.This 
-    function can be used to convert pd.Timestamp and pl.Datetime objects to the 
-    required format for ENTSOE API calls. Please have a look at the 
+    Convert a (tz-aware) datetime to UTC and format it as an integer in the
+    ENTSOE format. If the datetime is naive, it is assumed to be in UTC.This
+    function can be used to convert pd.Timestamp and pl.Datetime objects to the
+    required format for ENTSOE API calls. Please have a look at the
     documentation for more details and examples.
 
     Args: