@ampeco/public-api-mcp 3.251.9 → 3.252.0

package/dist/generated/endpoints.json

@@ -390,7 +390,7 @@
           "description": "The payload you provided is invalid"
         },
         "424": {
-          "description": "The requested operation cannot be completed because it depends on communication with an external system (e.g., charge point) that is currently disconnected or unreachable"
+          "description": "The requested operation cannot be completed because something it depends on is currently unavailable, such as an external system (e.g., a charge point) that is disconnected or unreachable, or required reference data (e.g., an exchange rate) that is missing. The `message` property carries the reason."
         },
         "429": {
           "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
@@ -515,7 +515,7 @@
           "description": "The payload you provided is invalid"
         },
         "424": {
-          "description": "The requested operation cannot be completed because it depends on communication with an external system (e.g., charge point) that is currently disconnected or unreachable"
+          "description": "The requested operation cannot be completed because something it depends on is currently unavailable, such as an external system (e.g., a charge point) that is disconnected or unreachable, or required reference data (e.g., an exchange rate) that is missing. The `message` property carries the reason."
         },
         "429": {
           "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
@@ -817,7 +817,7 @@
           "description": "The payload you provided is invalid"
         },
         "424": {
-          "description": "The requested operation cannot be completed because it depends on communication with an external system (e.g., charge point) that is currently disconnected or unreachable"
+          "description": "The requested operation cannot be completed because something it depends on is currently unavailable, such as an external system (e.g., a charge point) that is disconnected or unreachable, or required reference data (e.g., an exchange rate) that is missing. The `message` property carries the reason."
         },
         "429": {
           "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
@@ -4946,7 +4946,7 @@
       "method": "POST",
       "operationId": "sessionChangeTariff",
       "summary": "Session / Change tariff",
-      "description": "Change the tariff for a session and trigger recalculation of charging periods. This action supports loyalty program integrations where discounts need to be applied mid-session. The tariff change is only available when: - Billing status is NOT \"Completed\" - For running sessions: duration is under 3 hours - For roaming sessions (Ampeco as eMSP): session must be finished and have a CDR received - No recalculation is already in progress - For local charge point sessions: a StartTransaction message must exist",
+      "description": "Change the tariff for a session and trigger recalculation of charging periods. This action supports loyalty program integrations where discounts need to be applied mid-session. The tariff change is only available when: - Billing status is NOT \"Completed\" - For running sessions: duration is under 3 hours - For roaming sessions (the platform as eMSP): session must be finished and have a CDR received - No recalculation is already in progress - For local charge point sessions: a StartTransaction message must exist - The selected tariff already has usable concrete pricing",
       "tags": [
         "action / session"
       ],
@@ -4959,7 +4959,7 @@
               "properties": {
                 "tariffId": {
                   "type": "integer",
-                  "description": "The ID of the tariff to apply to the session"
+                  "description": "The ID of the tariff to apply to the session. The tariff must already have usable concrete pricing; unresolved markup or discount tariff definitions cannot be assigned directly and produce a tariffId validation error (422)."
                 }
               },
               "required": [
@@ -5466,7 +5466,7 @@
           "description": "The payload you provided is invalid"
         },
         "424": {
-          "description": "The requested operation cannot be completed because it depends on communication with an external system (e.g., charge point) that is currently disconnected or unreachable"
+          "description": "The requested operation cannot be completed because something it depends on is currently unavailable, such as an external system (e.g., a charge point) that is disconnected or unreachable, or required reference data (e.g., an exchange rate) that is missing. The `message` property carries the reason."
         },
         "429": {
           "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
@@ -6631,7 +6631,7 @@
           "description": "The payload you provided is invalid"
         },
         "424": {
-          "description": "The requested operation cannot be completed because it depends on communication with an external system (e.g., charge point) that is currently disconnected or unreachable"
+          "description": "The requested operation cannot be completed because something it depends on is currently unavailable, such as an external system (e.g., a charge point) that is disconnected or unreachable, or required reference data (e.g., an exchange rate) that is missing. The `message` property carries the reason."
         },
         "429": {
           "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
@@ -32822,6 +32822,192 @@
         }
       }
     },
+    {
+      "path": "/public-api/resources/ocpi-commands/v1.0",
+      "method": "GET",
+      "operationId": "ocpiCommandsListing",
+      "summary": "OCPI commands / Listing",
+      "description": "List commands received from eMSPs over OCPI.",
+      "tags": [
+        "resource / ocpi commands"
+      ],
+      "parameters": {
+        "query": {
+          "per_page": {
+            "description": "The number of items to return per page.",
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "default": 100
+          },
+          "cursor": {
+            "description": "The cursor to fetch the next page. **Do not construct this value manually.** Use one of the following methods: - Use the value from the previous response's `links.next` to fetch the next page - Pass an empty string (e.g., `?cursor` or `?cursor=`) to initiate cursor pagination on the first page",
+            "type": "string"
+          },
+          "filter": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "roamingConnectionId": {
+                  "type": "integer",
+                  "description": "Filter by roaming connection ID."
+                },
+                "result": {
+                  "type": "string",
+                  "enum": [
+                    "accepted",
+                    "rejected",
+                    "not_supported",
+                    "timeout",
+                    "unknown_session",
+                    "failed",
+                    "evse_occupied",
+                    "evse_inoperative",
+                    "unknown_reservation",
+                    "canceled_reservation",
+                    "unknown"
+                  ],
+                  "description": "The result the platform returned to the roaming partner: - **accepted**: The command was accepted - **rejected**: The command was rejected - **not_supported**: The command is not supported for this charge point - **timeout**: The charge point did not respond in time - **unknown_session**: The referenced session is unknown - **failed**: The command failed during execution - **evse_occupied**: The EVSE is already in use - **evse_inoperative**: The EVSE is not operational - **unknown_reservation**: The referenced reservation is unknown - **canceled_reservation**: The reservation was cancelled - **unknown**: Any result outside the OCPI result set"
+                },
+                "type": {
+                  "type": "string",
+                  "enum": [
+                    "cancel_reservation",
+                    "reserve_now",
+                    "start_session",
+                    "stop_session",
+                    "unlock_connector",
+                    "change_availability",
+                    "get_diagnostics",
+                    "reset_evse",
+                    "unknown"
+                  ],
+                  "description": "The command the roaming partner sent: - **cancel_reservation**: Cancel a reservation - **reserve_now**: Reserve an EVSE - **start_session**: Start a charging session - **stop_session**: Stop a charging session - **unlock_connector**: Unlock a connector - **change_availability**: Change the availability of an EVSE (protocol extension) - **get_diagnostics**: Request charge point diagnostics (protocol extension) - **reset_evse**: Reset an EVSE (protocol extension) - **unknown**: Any command outside this set"
+                },
+                "failureReason": {
+                  "type": "string",
+                  "enum": [
+                    "charging_not_allowed",
+                    "location_is_closed",
+                    "access_restricted",
+                    "user_verification_not_complete",
+                    "terms_not_accepted",
+                    "subscription_required",
+                    "cannot_bill_payment_method",
+                    "session_already_running",
+                    "previous_session_not_paid",
+                    "unpaid_subscription_fees",
+                    "payment_method_required",
+                    "corporate_billing_policy_inactive",
+                    "corporate_billing_limit_exceeded",
+                    "corporate_account_limit_reached",
+                    "corporate_billing_currency_mismatch",
+                    "corporate_billing_cross_operator_not_opted_in",
+                    "corporate_billing_exchange_rate_unavailable",
+                    "corporate_billing_charger_type_not_covered",
+                    "corporate_billing_partner_not_covered",
+                    "corporate_billing_country_not_covered",
+                    "corporate_billing_location_not_covered",
+                    "corporate_billing_location_tag_not_covered",
+                    "corporate_billing_roaming_not_covered",
+                    "payment_method_expired",
+                    "payment_method_not_allowed",
+                    "payment_method_doesnt_have_sufficient_funds",
+                    "internal_roaming_not_setup",
+                    "rfid_tag_expired",
+                    "rfid_tag_disabled",
+                    "rfid_tag_suspended",
+                    "user_invoice_details_not_provided",
+                    "invalid_payment_method_for_direct_charges",
+                    "user_is_disabled",
+                    "token_not_authorized_for_booking",
+                    "evse_has_queued_reservations",
+                    "evse_disabled",
+                    "evse_out_of_order",
+                    "tariff_charging_not_allowed",
+                    "no_tariff_group_configured",
+                    "tariff_resolution_failed",
+                    "operator_in_migration_mode",
+                    "rfid_charge_point_scope_mismatch",
+                    "remote_start_failed",
+                    "rejected",
+                    "canceled_reservation",
+                    "evse_occupied",
+                    "evse_inoperative",
+                    "failed",
+                    "not_supported",
+                    "timeout",
+                    "unknown_reservation",
+                    "ev_not_connected_to_evse",
+                    "authorization_failed",
+                    "pre_authorization_failed",
+                    "unknown_session",
+                    "ocpi_roaming_not_setup",
+                    "command_expired"
+                  ],
+                  "description": "The reason a command did not succeed: Authorization and access: - **charging_not_allowed**: Charging is not allowed for the authorizing token - **location_is_closed**: The location was closed when the command was received - **access_restricted**: Access to the charge point is restricted for the authorizing token - **user_verification_not_complete**: The user behind the token has not completed verification - **terms_not_accepted**: The user has not accepted the required terms and policies - **user_is_disabled**: The user account is disabled - **authorization_failed**: The authorization of the token was refused - **pre_authorization_failed**: The payment pre-authorization for the session failed - **token_not_authorized_for_booking**: The token is not authorized to book the requested EVSE - **operator_in_migration_mode**: The operator is in migration mode and does not accept new charging Payment, subscription and billing: - **subscription_required**: A subscription plan is required to start charging - **unpaid_subscription_fees**: The user has unpaid subscription fees - **previous_session_not_paid**: An earlier session of the user is still unpaid - **payment_method_required**: The user has no payment method that can be charged - **payment_method_expired**: The user's payment method has expired - **payment_method_not_allowed**: The user's payment method is not allowed for this charge point - **payment_method_doesnt_have_sufficient_funds**: The user's payment method has insufficient funds - **cannot_bill_payment_method**: The user's payment method could not be billed - **invalid_payment_method_for_direct_charges**: The user's payment method cannot be used for direct charges - **user_invoice_details_not_provided**: The user has not provided the invoice details required to be billed Corporate billing: - **corporate_billing_policy_inactive**: The corporate billing policy is not active - **corporate_billing_limit_exceeded**: The corporate billing policy limit is exceeded - **corporate_account_limit_reached**: The corporate account limit is reached - **corporate_billing_currency_mismatch**: The session currency differs from the corporate billing currency - **corporate_billing_cross_operator_not_opted_in**: The operator serving the session is not opted in to the partner's cross-operator corporate billing - **corporate_billing_exchange_rate_unavailable**: No exchange rate is available to convert the session amount into the corporate billing currency - **corporate_billing_charger_type_not_covered**: The charger type is not covered by the corporate billing policy - **corporate_billing_partner_not_covered**: The partner is not covered by the corporate billing policy - **corporate_billing_country_not_covered**: The country is not covered by the corporate billing policy - **corporate_billing_location_not_covered**: The location is not covered by the corporate billing policy - **corporate_billing_location_tag_not_covered**: The location tag is not covered by the corporate billing policy - **corporate_billing_roaming_not_covered**: Roaming is not covered by the corporate billing policy Tariffs: - **tariff_charging_not_allowed**: The applicable tariff does not allow charging - **no_tariff_group_configured**: No tariff group is configured for the charge point - **tariff_resolution_failed**: No tariff could be resolved for the requested charging Charge point and EVSE state: - **evse_disabled**: The requested EVSE is disabled - **evse_out_of_order**: The requested EVSE is out of order - **evse_occupied**: The requested EVSE is already in use - **evse_inoperative**: The requested EVSE is not operational - **evse_has_queued_reservations**: The requested EVSE has queued reservations - **ev_not_connected_to_evse**: No vehicle is connected to the requested EVSE - **session_already_running**: A charging session is already running RFID tokens: - **rfid_tag_expired**: The RFID tag has expired - **rfid_tag_disabled**: The RFID tag is disabled - **rfid_tag_suspended**: The RFID tag is suspended - **rfid_charge_point_scope_mismatch**: The RFID tag may not be used on the requested charge point Roaming setup: - **ocpi_roaming_not_setup**: The OCPI roaming configuration needed to serve the command is missing - **internal_roaming_not_setup**: The internal roaming configuration needed to serve the command is missing Command execution: - **remote_start_failed**: The charge point refused or failed the remote start - **rejected**: The charge point rejected the command - **failed**: The command failed while it was being executed - **not_supported**: The command is not supported for the requested charge point - **timeout**: The charge point did not respond within the command timeout - **command_expired**: The command was no longer valid by the time it could be executed - **unknown_session**: The referenced charging session is unknown to the platform - **unknown_reservation**: The referenced reservation is unknown to the platform - **canceled_reservation**: The reservation was cancelled instead of being honoured"
+                },
+                "createdAfter": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "Filter by commands received at or after this timestamp (ISO 8601)."
+                },
+                "createdBefore": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "Filter by commands received at or before this timestamp (ISO 8601)."
+                }
+              },
+              "description": "Filters for the OCPI commands listing."
+            }
+          }
+        }
+      },
+      "responses": {
+        "200": {
+          "description": "Success"
+        },
+        "401": {
+          "description": "Access token is missing or invalid"
+        },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
+        "422": {
+          "description": "The payload you provided is invalid"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
+    {
+      "path": "/public-api/resources/ocpi-commands/v1.0/{ocpiCommand}",
+      "method": "GET",
+      "operationId": "ocpiCommandRead",
+      "summary": "OCPI command / Read",
+      "description": "Get a command received from an eMSP over OCPI.",
+      "tags": [
+        "resource / ocpi commands"
+      ],
+      "responses": {
+        "200": {
+          "description": "Success"
+        },
+        "401": {
+          "description": "Access token is missing or invalid"
+        },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
+        "404": {
+          "description": "The record is not found"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
     {
       "path": "/public-api/resources/operators/v1.0",
       "method": "GET",
@@ -49961,7 +50147,7 @@
       "method": "GET",
       "operationId": "rfidTagsListingDeprecated",
       "summary": "RFID Tags / Listing",
-      "description": "Get all rfid tags",
+      "description": "**Deprecated:** Use `/resources/id-tags/v2.0` instead. Get all rfid tags",
       "deprecated": true,
       "tags": [
         "resource / rfids"
@@ -50050,7 +50236,7 @@
       "method": "POST",
       "operationId": "rfidTagCreateDeprecated",
       "summary": "RFID Tag / Create",
-      "description": "Create new RFID Tag",
+      "description": "**Deprecated:** Use `/resources/id-tags/v2.0` instead. Create new RFID Tag",
       "deprecated": true,
       "tags": [
         "resource / rfids"
@@ -50135,7 +50321,7 @@
       "method": "GET",
       "operationId": "rfidTagReadDeprecated",
       "summary": "RFID Tag / Read",
-      "description": "Get a RFID Tag",
+      "description": "**Deprecated:** Use `/resources/id-tags/v2.0/{idTag}` instead. Get a RFID Tag",
       "deprecated": true,
       "tags": [
         "resource / rfids"
@@ -50163,7 +50349,7 @@
       "method": "DELETE",
       "operationId": "rfidTagDeleteDeprecated",
       "summary": "RFID Tag / Delete",
-      "description": "Delete a RFID Tag",
+      "description": "**Deprecated:** Use `/resources/id-tags/v2.0/{idTag}` instead. Delete a RFID Tag",
       "deprecated": true,
       "tags": [
         "resource / rfids"
@@ -50188,7 +50374,7 @@
       "method": "PATCH",
       "operationId": "rfidTagUpdateDeprecated",
       "summary": "RFID Tag / Update",
-      "description": "Update a RFID Tag",
+      "description": "**Deprecated:** Use `/resources/id-tags/v2.0/{idTag}` instead. Update a RFID Tag",
       "deprecated": true,
       "tags": [
         "resource / rfids"
@@ -52104,7 +52290,7 @@
       "method": "GET",
       "operationId": "securityEventLogsListingDeprecated",
       "summary": "Security Events Logs / Listing",
-      "description": "Get all Security Events Log",
+      "description": "**Deprecated:** Use `/resources/security-events/v2.0` instead. Get all Security Events Log",
       "deprecated": true,
       "tags": [
         "resource / security event logs"
@@ -52171,7 +52357,7 @@
       "method": "GET",
       "operationId": "securityEventLogReadDeprecated",
       "summary": "Security Event Log / Read",
-      "description": "Get a Security Event Log",
+      "description": "**Deprecated:** Use `/resources/security-events/v2.0/{securityEvent}` instead. Get a Security Event Log",
       "deprecated": true,
       "tags": [
         "resource / security event logs"
@@ -58145,22 +58331,28 @@
                 "stopSession": {
                   "type": "object",
                   "properties": {
-                    "timeLimitMinutes": {
+                    "stopWhenPreAuthorizedAmountFallsBelow": {
                       "type": "number",
-                      "nullable": true,
-                      "description": "Session max time. The maximum minutes a session is allowed to run. Skip for no time limit."
+                      "format": "decimal",
+                      "minimum": 0,
+                      "nullable": false
                     },
-                    "stopWhenEnergyExceedsKwh": {
+                    "autoStopAmount": {
                       "type": "number",
-                      "nullable": true,
-                      "description": "The maximum energy (kWh) allowed per session. Skip for no limit."
-                    },
-                    "stopWhenSocExceedsPercent": {
-                      "type": "integer",
-                      "minimum": 70,
-                      "maximum": 99,
-                      "nullable": true,
-                      "description": "Stop the session when the vehicle's reported State of Charge reaches or exceeds this value. If the charge point does not report SoC, this criterion is ignored. Accepts values between 70 and 99."
+                      "format": "decimal",
+                      "minimum": 0,
+                      "nullable": false
+                    }
+                  }
+                },
+                "startSessionRestrictions": {
+                  "type": "object",
+                  "properties": {
+                    "minimumBalance": {
+                      "type": "number",
+                      "format": "decimal",
+                      "minimum": 0,
+                      "nullable": false
                     }
                   }
                 },
@@ -58424,7 +58616,7 @@
       "method": "PUT",
       "operationId": "tariffUpdate",
       "summary": "Tariff / Update",
-      "description": "Update a tariff",
+      "description": "Update a tariff. Derived tariffs are read-only.",
       "tags": [
         "resource / tariffs"
       ],
@@ -59281,6 +59473,32 @@
                       "maximum": 99,
                       "nullable": true,
                       "description": "Stop the session when the vehicle's reported State of Charge reaches or exceeds this value. If the charge point does not report SoC, this criterion is ignored. Accepts values between 70 and 99."
+                    },
+                    "stopWhenPreAuthorizedAmountFallsBelow": {
+                      "type": "number",
+                      "format": "decimal",
+                      "minimum": 0,
+                      "nullable": true,
+                      "description": "Tariff-level override that stops the session when the remaining pre-authorised amount drops below this value. Send `null` to clear the override and revert to the global default from User billing settings. Honoured only when the tariff's billing strategy is `Require payment method and authorize certain amount before starting session` or `Require payment method OR minimum amount in balance`, and currently only for tariff types `Duration + Energy`, `Duration + Energy ToD`, and `Power Levels`. Values set on a tariff with an incompatible billing strategy are reset to the global default on save."
+                    },
+                    "autoStopAmount": {
+                      "type": "number",
+                      "format": "decimal",
+                      "minimum": 0,
+                      "nullable": true,
+                      "description": "Tariff-level override that stops the session when the user's available balance drops below this value. Send `null` to clear the override and revert to the global default from User billing settings. Honoured only when the tariff's billing strategy is `Require payment method OR minimum amount in balance`. Values set on a tariff with an incompatible billing strategy are reset to the global default on save."
+                    }
+                  }
+                },
+                "startSessionRestrictions": {
+                  "type": "object",
+                  "properties": {
+                    "minimumBalance": {
+                      "type": "number",
+                      "format": "decimal",
+                      "minimum": 0,
+                      "nullable": true,
+                      "description": "Tariff-level override for the minimum balance a user must have before a session is allowed to start. Send `null` to clear the override and revert to the global default from User billing settings. Honoured only when the tariff's billing strategy is `Require payment method OR minimum amount in balance`. Values set on a tariff with an incompatible billing strategy are reset to the global default on save."
                     }
                   }
                 },
@@ -59520,7 +59738,7 @@
       "method": "DELETE",
       "operationId": "tariffDelete",
       "summary": "Tariff / Delete",
-      "description": "Delete a tariff",
+      "description": "Delete a tariff. Derived tariffs are read-only.",
       "tags": [
         "resource / tariffs"
       ],
@@ -59550,7 +59768,7 @@
       "method": "PATCH",
       "operationId": "tariffPartialUpdate",
       "summary": "Tariff / Partial Update",
-      "description": "Partially update a tariff. Only the fields included in the request body are updated. Omitted fields retain their current values. Nested objects are merged recursively, while arrays are fully replaced. The tariff type cannot be changed via PATCH — use PUT with the full payload instead.",
+      "description": "Partially update a tariff. Only the fields included in the request body are updated. Omitted fields retain their current values. Nested objects are merged recursively, while arrays are fully replaced. The tariff type cannot be changed via PATCH — use PUT with the full payload instead. Derived tariffs are read-only.",
       "tags": [
         "resource / tariffs"
       ],
@@ -60407,6 +60625,32 @@
                       "maximum": 99,
                       "nullable": true,
                       "description": "Stop the session when the vehicle's reported State of Charge reaches or exceeds this value. If the charge point does not report SoC, this criterion is ignored. Accepts values between 70 and 99."
+                    },
+                    "stopWhenPreAuthorizedAmountFallsBelow": {
+                      "type": "number",
+                      "format": "decimal",
+                      "minimum": 0,
+                      "nullable": true,
+                      "description": "Tariff-level override that stops the session when the remaining pre-authorised amount drops below this value. Send `null` to clear the override and revert to the global default from User billing settings. Honoured only when the tariff's billing strategy is `Require payment method and authorize certain amount before starting session` or `Require payment method OR minimum amount in balance`, and currently only for tariff types `Duration + Energy`, `Duration + Energy ToD`, and `Power Levels`. Values set on a tariff with an incompatible billing strategy are reset to the global default on save."
+                    },
+                    "autoStopAmount": {
+                      "type": "number",
+                      "format": "decimal",
+                      "minimum": 0,
+                      "nullable": true,
+                      "description": "Tariff-level override that stops the session when the user's available balance drops below this value. Send `null` to clear the override and revert to the global default from User billing settings. Honoured only when the tariff's billing strategy is `Require payment method OR minimum amount in balance`. Values set on a tariff with an incompatible billing strategy are reset to the global default on save."
+                    }
+                  }
+                },
+                "startSessionRestrictions": {
+                  "type": "object",
+                  "properties": {
+                    "minimumBalance": {
+                      "type": "number",
+                      "format": "decimal",
+                      "minimum": 0,
+                      "nullable": true,
+                      "description": "Tariff-level override for the minimum balance a user must have before a session is allowed to start. Send `null` to clear the override and revert to the global default from User billing settings. Honoured only when the tariff's billing strategy is `Require payment method OR minimum amount in balance`. Values set on a tariff with an incompatible billing strategy are reset to the global default on save."
                     }
                   }
                 },
@@ -60702,7 +60946,7 @@
       "method": "POST",
       "operationId": "tariffScheduledChangeCreate",
       "summary": "Tariff / Scheduled Change / Create",
-      "description": "Create a new scheduled pricing change for the tariff",
+      "description": "Create a new scheduled pricing change for the tariff. Not allowed on derived tariffs.",
       "tags": [
         "resource / tariffs"
       ],
@@ -61612,7 +61856,7 @@
       "method": "DELETE",
       "operationId": "tariffScheduledChangeDelete",
       "summary": "Tariff / Scheduled Change / Delete",
-      "description": "Delete a scheduled pricing change",
+      "description": "Delete a scheduled pricing change. Not allowed on derived tariffs.",
       "tags": [
         "resource / tariffs"
       ],
@@ -61639,7 +61883,7 @@
       "method": "PATCH",
       "operationId": "tariffScheduledChangeUpdate",
       "summary": "Tariff / Scheduled Change / Update",
-      "description": "Update a pending scheduled pricing change",
+      "description": "Update a pending scheduled pricing change. Not allowed on derived tariffs.",
       "tags": [
         "resource / tariffs"
       ],
@@ -63484,7 +63728,7 @@
                 },
                 "invoiceNumber": {
                   "type": "string",
-                  "description": "Filter transactions by invoice number string (e.g., \"INV-2024-001\"). Use this when you have the human-readable invoice number. To filter by the invoice's database ID, use invoiceId instead."
+                  "description": "Filter transactions by invoice number string (e.g., \"INV-2024-001\"). Use this when you have the human-readable invoice number. To filter by the invoice's database ID, use invoiceId instead. Matches only the transaction's current valid invoice. A transaction whose invoice was fully reversed and replaced is matched by the replacement's number, not by the reversed original's."
                 },
                 "status": {
                   "type": "string",
@@ -63571,7 +63815,7 @@
                 "invoiceId": {
                   "type": "string",
                   "format": "integer",
-                  "description": "Filter transactions by invoice's internal database ID as returned in the transaction response. Use this when you have the invoiceId from a previous API response. To filter by the human-readable invoice number string, use invoiceNumber instead."
+                  "description": "Filter transactions by invoice's internal database ID as returned in the transaction response. Use this when you have the invoiceId from a previous API response. To filter by the human-readable invoice number string, use invoiceNumber instead. Matches only the transaction's current valid invoice. A transaction whose invoice was fully reversed and replaced is matched by the replacement's ID, not by the reversed original's."
                 },
                 "purchaseType": {
                   "type": "array",
@@ -64232,6 +64476,9 @@
         "422": {
           "description": "The payload you provided is invalid"
         },
+        "424": {
+          "description": "The requested operation cannot be completed because something it depends on is currently unavailable, such as an external system (e.g., a charge point) that is disconnected or unreachable, or required reference data (e.g., an exchange rate) that is missing. The `message` property carries the reason."
+        },
         "429": {
           "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
         }
@@ -64527,6 +64774,9 @@
         "422": {
           "description": "The payload you provided is invalid"
         },
+        "424": {
+          "description": "The requested operation cannot be completed because something it depends on is currently unavailable, such as an external system (e.g., a charge point) that is disconnected or unreachable, or required reference data (e.g., an exchange rate) that is missing. The `message` property carries the reason."
+        },
         "429": {
           "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
         }
@@ -64776,7 +65026,7 @@
                 "partnerId": {
                   "type": "integer",
                   "nullable": true,
-                  "description": "The partnerId can be updated only if there are no users added to the user group"
+                  "description": "The partner ID. It must belong to the token's operator. For sub-operator tokens it is required and non-null on create, and must reference a partner assigned to that sub-operator. On PATCH it may be omitted to retain the existing partner; when supplied it must be non-null and assigned to that sub-operator. For partner tokens it is always the token's own partner: it defaults to that partner when omitted on create, and any other value, including null, is rejected. Optional and nullable for global and operator tokens. The partner can be updated only if there are no users added to the user group."
                 },
                 "description": {
                   "type": "string",
@@ -64847,6 +65097,75 @@
         }
       }
     },
+    {
+      "path": "/public-api/resources/user-groups/v1.0/{userGroup}",
+      "method": "PUT",
+      "operationId": "userGroupReplace",
+      "summary": "User Group / Replace",
+      "description": "Replace a user group. Unlike `PATCH`, the request body is a complete representation: any writable property that is omitted is reset rather than preserved. Use `PATCH` to change a subset of properties.",
+      "tags": [
+        "resource / user-groups"
+      ],
+      "requestBody": {
+        "required": true,
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string"
+                },
+                "partnerId": {
+                  "type": "integer",
+                  "nullable": true,
+                  "description": "The partner ID. It must belong to the token's operator. For sub-operator tokens it is required and non-null on create, and must reference a partner assigned to that sub-operator. On PATCH it may be omitted to retain the existing partner; when supplied it must be non-null and assigned to that sub-operator. For partner tokens it is always the token's own partner: it defaults to that partner when omitted on create, and any other value, including null, is rejected. Optional and nullable for global and operator tokens. The partner can be updated only if there are no users added to the user group."
+                },
+                "description": {
+                  "type": "string",
+                  "maxLength": 2000,
+                  "nullable": true
+                },
+                "externalId": {
+                  "type": "string",
+                  "maxLength": 255,
+                  "nullable": true,
+                  "description": "Used to store custom information, usually used for external references or metadata to the resource."
+                },
+                "lastUpdatedAt": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "ISO 8601 formatted date"
+                }
+              },
+              "required": [
+                "name"
+              ]
+            }
+          }
+        }
+      },
+      "responses": {
+        "200": {
+          "description": "Replaced successfully"
+        },
+        "401": {
+          "description": "Access token is missing or invalid"
+        },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
+        "404": {
+          "description": "The record is not found"
+        },
+        "422": {
+          "description": "The payload you provided is invalid"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
     {
       "path": "/public-api/resources/user-groups/v1.0/{userGroup}",
       "method": "DELETE",
@@ -64899,7 +65218,7 @@
                 "partnerId": {
                   "type": "integer",
                   "nullable": true,
-                  "description": "The partnerId can be updated only if there are no users added to the user group"
+                  "description": "The partner ID. It must belong to the token's operator. For sub-operator tokens it is required and non-null on create, and must reference a partner assigned to that sub-operator. On PATCH it may be omitted to retain the existing partner; when supplied it must be non-null and assigned to that sub-operator. For partner tokens it is always the token's own partner: it defaults to that partner when omitted on create, and any other value, including null, is rejected. Optional and nullable for global and operator tokens. The partner can be updated only if there are no users added to the user group."
                 },
                 "description": {
                   "type": "string",
@@ -72605,7 +72924,7 @@
   ],
   "info": {
     "title": "Public API",
-    "version": "3.251.9",
+    "version": "3.252.0",
     "description": "The Public API provides server-to-server integration capabilities for your EV charging platform.\n\n**Authentication.** Existing integrations continue to work unchanged — long-lived UUID admin tokens are sent in `Authorization: Bearer ...` with no exchange required. Two security schemes are documented for OpenAPI client tooling, both resulting in the same Bearer header at the wire level:\n   - `bearerAuth` — the token in the `Authorization: Bearer ...` header is either a long-lived UUID admin token (issued via the admin UI, used directly) or a short-lived access token previously obtained via OAuth.\n   - `oauth2ClientCredentials` - a `client_id` / `client_secret` pair should be exchanged for a short-lived access token at `/public-api/oauth/token` per RFC 6749 Section 4.4 (Client Credentials Grant), and the short-lived token should be used in the `Authorization: Bearer ...` header. The OAuth `client_secret` itself cannot be sent directly as a bearer token — it must be exchanged first.\n"
   },
   "servers": [
@@ -72619,18 +72938,18 @@
       }
     }
   ],
-  "buildTimestamp": "2026-09-22T14:55:30.238Z",
+  "buildTimestamp": "2026-09-23T11:49:39.805Z",
   "stats": {
-    "totalEndpoints": 648,
-    "originalSize": 6020721,
-    "optimizedSize": 1671968,
-    "reductionPercent": 72.23,
-    "buildDuration": 1631,
+    "totalEndpoints": 651,
+    "originalSize": 6087481,
+    "optimizedSize": 1691316,
+    "reductionPercent": 72.22,
+    "buildDuration": 1588,
     "responseSchemas": {
-      "total": 648,
-      "withSchemas": 648,
-      "totalSchemaSize": 3455237,
-      "averageSchemaSize": 5332
+      "total": 651,
+      "withSchemas": 651,
+      "totalSchemaSize": 3494211,
+      "averageSchemaSize": 5367
     }
   }
 }