@ampeco/public-api-mcp 3.251.10 → 3.252.0

package/dist/generated/response-schemas.json

@@ -1631,9 +1631,16 @@
             "type": "string",
             "enum": [
               "corporate_billing_policy_inactive",
+              "corporate_billing_limit_exceeded",
+              "corporate_billing_currency_mismatch",
+              "corporate_billing_charger_type_not_covered",
+              "corporate_billing_location_not_covered",
+              "corporate_billing_cross_operator_not_opted_in",
+              "corporate_billing_exchange_rate_unavailable",
+              "corporate_billing_ad_hoc_tariff_unavailable",
               "cannot_use_payment_method"
             ],
-            "description": "The reason the requested payment method was rejected before the session start fell back to the user's default payment method."
+            "description": "The reason the requested payment method was rejected before the session start fell back to the user's default payment method:\n  * `corporate_billing_policy_inactive` - The assigned corporate billing policy is inactive, so corporate billing cannot be used for the new session.\n  * `corporate_billing_limit_exceeded` - The partner-wide or individual corporate billing limit has been reached.\n  * `corporate_billing_currency_mismatch` - The corporate billing limit currency differs from the session currency and the policy does not cover the session.\n  * `corporate_billing_charger_type_not_covered` - The charge point's charger type is not covered by the corporate billing policy.\n  * `corporate_billing_location_not_covered` - The location, its country, its tags or the roaming network is not covered by the corporate billing policy.\n  * `corporate_billing_cross_operator_not_opted_in` - The charge point belongs to another operator that the partner has not opted in to cover.\n  * `corporate_billing_exchange_rate_unavailable` - No exchange rate is available between the session currency and the corporate billing limit currency.\n  * `corporate_billing_ad_hoc_tariff_unavailable` - The corporate tariff flagged for ad-hoc use at another operator's charge point is not applicable to the session.\n  * `cannot_use_payment_method` - The requested payment method is not allowed or the related subscription is cancelled.\n"
           }
         }
       }
@@ -3911,9 +3918,16 @@
             "type": "string",
             "enum": [
               "corporate_billing_policy_inactive",
+              "corporate_billing_limit_exceeded",
+              "corporate_billing_currency_mismatch",
+              "corporate_billing_charger_type_not_covered",
+              "corporate_billing_location_not_covered",
+              "corporate_billing_cross_operator_not_opted_in",
+              "corporate_billing_exchange_rate_unavailable",
+              "corporate_billing_ad_hoc_tariff_unavailable",
               "cannot_use_payment_method"
             ],
-            "description": "The reason the requested payment method was rejected before the session start fell back to the user's default payment method."
+            "description": "The reason the requested payment method was rejected before the session start fell back to the user's default payment method:\n  * `corporate_billing_policy_inactive` - The assigned corporate billing policy is inactive, so corporate billing cannot be used for the new session.\n  * `corporate_billing_limit_exceeded` - The partner-wide or individual corporate billing limit has been reached.\n  * `corporate_billing_currency_mismatch` - The corporate billing limit currency differs from the session currency and the policy does not cover the session.\n  * `corporate_billing_charger_type_not_covered` - The charge point's charger type is not covered by the corporate billing policy.\n  * `corporate_billing_location_not_covered` - The location, its country, its tags or the roaming network is not covered by the corporate billing policy.\n  * `corporate_billing_cross_operator_not_opted_in` - The charge point belongs to another operator that the partner has not opted in to cover.\n  * `corporate_billing_exchange_rate_unavailable` - No exchange rate is available between the session currency and the corporate billing limit currency.\n  * `corporate_billing_ad_hoc_tariff_unavailable` - The corporate tariff flagged for ad-hoc use at another operator's charge point is not applicable to the session.\n  * `cannot_use_payment_method` - The requested payment method is not allowed or the related subscription is cancelled.\n"
           }
         }
       }
@@ -13990,14 +14004,16 @@
                     "description": "Whether the policy's overall cost-per-kWh cap reduced coverage."
                   },
                   "restrictionCause": {
-                    "description": "Corporate billing restriction dimension that withheld coverage for the session:\n- **partner**: A partner restriction prevented corporate billing from covering the session\n- **country**: A country restriction prevented corporate billing from covering the session\n- **location**: A location restriction prevented corporate billing from covering the session\n- **location_tag**: A location tag restriction prevented corporate billing from covering the session\n- **roaming**: A roaming restriction prevented corporate billing from covering the session\n",
+                    "description": "Corporate billing restriction dimension that withheld coverage for the session:\n- **partner**: A partner restriction prevented corporate billing from covering the session\n- **country**: A country restriction prevented corporate billing from covering the session\n- **location**: A location restriction prevented corporate billing from covering the session\n- **location_tag**: A location tag restriction prevented corporate billing from covering the session\n- **roaming**: A roaming restriction prevented corporate billing from covering the session\n- **cross_operator_not_opted_in**: The service operator and the corporate account home operator have not both opted in to cross-operator corporate billing\n- **exchange_rate_unavailable**: No exchange rate was available to convert the session currency into the corporate account billing currency\n",
                     "type": "string",
                     "enum": [
                       "partner",
                       "country",
                       "location",
                       "location_tag",
-                      "roaming"
+                      "roaming",
+                      "cross_operator_not_opted_in",
+                      "exchange_rate_unavailable"
                     ]
                   },
                   "breakdown": {
@@ -79331,28 +79347,465 @@
         }
       }
     },
-    "422": {
-      "schema": {
-        "type": "object",
-        "required": [
-          "message"
-        ],
-        "properties": {
-          "message": {
-            "type": "string"
-          },
-          "errors": {
-            "type": "object",
-            "additionalProperties": {
-              "type": "array",
-              "items": {
-                "type": "string"
-              }
-            }
-          }
-        }
-      }
-    },
+    "422": {
+      "schema": {
+        "type": "object",
+        "required": [
+          "message"
+        ],
+        "properties": {
+          "message": {
+            "type": "string"
+          },
+          "errors": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "429": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  },
+  "ocpiCommandsListing": {
+    "200": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "description": "A command received from an eMSP over OCPI and the result returned for it.",
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "integer",
+                  "readOnly": true,
+                  "description": "Identifier of the command."
+                },
+                "type": {
+                  "description": "The command the roaming partner sent:\n- **cancel_reservation**: Cancel a reservation\n- **reserve_now**: Reserve an EVSE\n- **start_session**: Start a charging session\n- **stop_session**: Stop a charging session\n- **unlock_connector**: Unlock a connector\n- **change_availability**: Change the availability of an EVSE (protocol extension)\n- **get_diagnostics**: Request charge point diagnostics (protocol extension)\n- **reset_evse**: Reset an EVSE (protocol extension)\n- **unknown**: Any command outside this set\n",
+                  "type": "string",
+                  "enum": [
+                    "cancel_reservation",
+                    "reserve_now",
+                    "start_session",
+                    "stop_session",
+                    "unlock_connector",
+                    "change_availability",
+                    "get_diagnostics",
+                    "reset_evse",
+                    "unknown"
+                  ]
+                },
+                "result": {
+                  "description": "The result the platform returned to the roaming partner:\n- **accepted**: The command was accepted\n- **rejected**: The command was rejected\n- **not_supported**: The command is not supported for this charge point\n- **timeout**: The charge point did not respond in time\n- **unknown_session**: The referenced session is unknown\n- **failed**: The command failed during execution\n- **evse_occupied**: The EVSE is already in use\n- **evse_inoperative**: The EVSE is not operational\n- **unknown_reservation**: The referenced reservation is unknown\n- **canceled_reservation**: The reservation was cancelled\n- **unknown**: Any result outside the OCPI result set\n",
+                  "type": "string",
+                  "enum": [
+                    "accepted",
+                    "rejected",
+                    "not_supported",
+                    "timeout",
+                    "unknown_session",
+                    "failed",
+                    "evse_occupied",
+                    "evse_inoperative",
+                    "unknown_reservation",
+                    "canceled_reservation",
+                    "unknown"
+                  ]
+                },
+                "failureReason": {
+                  "description": "The reason a command did not succeed:\n\nAuthorization and access:\n- **charging_not_allowed**: Charging is not allowed for the authorizing token\n- **location_is_closed**: The location was closed when the command was received\n- **access_restricted**: Access to the charge point is restricted for the authorizing token\n- **user_verification_not_complete**: The user behind the token has not completed verification\n- **terms_not_accepted**: The user has not accepted the required terms and policies\n- **user_is_disabled**: The user account is disabled\n- **authorization_failed**: The authorization of the token was refused\n- **pre_authorization_failed**: The payment pre-authorization for the session failed\n- **token_not_authorized_for_booking**: The token is not authorized to book the requested EVSE\n- **operator_in_migration_mode**: The operator is in migration mode and does not accept new charging\n\nPayment, subscription and billing:\n- **subscription_required**: A subscription plan is required to start charging\n- **unpaid_subscription_fees**: The user has unpaid subscription fees\n- **previous_session_not_paid**: An earlier session of the user is still unpaid\n- **payment_method_required**: The user has no payment method that can be charged\n- **payment_method_expired**: The user's payment method has expired\n- **payment_method_not_allowed**: The user's payment method is not allowed for this charge point\n- **payment_method_doesnt_have_sufficient_funds**: The user's payment method has insufficient funds\n- **cannot_bill_payment_method**: The user's payment method could not be billed\n- **invalid_payment_method_for_direct_charges**: The user's payment method cannot be used for direct charges\n- **user_invoice_details_not_provided**: The user has not provided the invoice details required to be billed\n\nCorporate billing:\n- **corporate_billing_policy_inactive**: The corporate billing policy is not active\n- **corporate_billing_limit_exceeded**: The corporate billing policy limit is exceeded\n- **corporate_account_limit_reached**: The corporate account limit is reached\n- **corporate_billing_currency_mismatch**: The session currency differs from the corporate billing currency\n- **corporate_billing_cross_operator_not_opted_in**: The operator serving the session is not opted in to the partner's cross-operator corporate billing\n- **corporate_billing_exchange_rate_unavailable**: No exchange rate is available to convert the session amount into the corporate billing currency\n- **corporate_billing_charger_type_not_covered**: The charger type is not covered by the corporate billing policy\n- **corporate_billing_partner_not_covered**: The partner is not covered by the corporate billing policy\n- **corporate_billing_country_not_covered**: The country is not covered by the corporate billing policy\n- **corporate_billing_location_not_covered**: The location is not covered by the corporate billing policy\n- **corporate_billing_location_tag_not_covered**: The location tag is not covered by the corporate billing policy\n- **corporate_billing_roaming_not_covered**: Roaming is not covered by the corporate billing policy\n\nTariffs:\n- **tariff_charging_not_allowed**: The applicable tariff does not allow charging\n- **no_tariff_group_configured**: No tariff group is configured for the charge point\n- **tariff_resolution_failed**: No tariff could be resolved for the requested charging\n\nCharge point and EVSE state:\n- **evse_disabled**: The requested EVSE is disabled\n- **evse_out_of_order**: The requested EVSE is out of order\n- **evse_occupied**: The requested EVSE is already in use\n- **evse_inoperative**: The requested EVSE is not operational\n- **evse_has_queued_reservations**: The requested EVSE has queued reservations\n- **ev_not_connected_to_evse**: No vehicle is connected to the requested EVSE\n- **session_already_running**: A charging session is already running\n\nRFID tokens:\n- **rfid_tag_expired**: The RFID tag has expired\n- **rfid_tag_disabled**: The RFID tag is disabled\n- **rfid_tag_suspended**: The RFID tag is suspended\n- **rfid_charge_point_scope_mismatch**: The RFID tag may not be used on the requested charge point\n\nRoaming setup:\n- **ocpi_roaming_not_setup**: The OCPI roaming configuration needed to serve the command is missing\n- **internal_roaming_not_setup**: The internal roaming configuration needed to serve the command is missing\n\nCommand execution:\n- **remote_start_failed**: The charge point refused or failed the remote start\n- **rejected**: The charge point rejected the command\n- **failed**: The command failed while it was being executed\n- **not_supported**: The command is not supported for the requested charge point\n- **timeout**: The charge point did not respond within the command timeout\n- **command_expired**: The command was no longer valid by the time it could be executed\n- **unknown_session**: The referenced charging session is unknown to the platform\n- **unknown_reservation**: The referenced reservation is unknown to the platform\n- **canceled_reservation**: The reservation was cancelled instead of being honoured\n",
+                  "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"
+                  ]
+                },
+                "sessionId": {
+                  "type": "integer",
+                  "description": "The related charging session ID."
+                },
+                "reservationId": {
+                  "type": "integer",
+                  "description": "The related reservation ID."
+                },
+                "evseId": {
+                  "type": "integer",
+                  "description": "The targeted EVSE ID."
+                },
+                "roamingEmspId": {
+                  "type": "integer",
+                  "description": "The roaming eMSP ID (`resources/roaming-emsps/v1.0`) the command was received from."
+                },
+                "roamingConnectionId": {
+                  "type": "integer",
+                  "description": "The roaming connection ID."
+                },
+                "createdAt": {
+                  "type": "string",
+                  "format": "date-time",
+                  "description": "ISO 8601 formatted date",
+                  "readOnly": true
+                }
+              },
+              "required": [
+                "id",
+                "type",
+                "createdAt"
+              ]
+            }
+          },
+          "links": {
+            "type": "object",
+            "properties": {
+              "first": {
+                "type": "string",
+                "description": "The URL to fetch the first page",
+                "nullable": true
+              },
+              "last": {
+                "type": "string",
+                "description": "The URL to fetch the last page",
+                "nullable": true
+              },
+              "prev": {
+                "type": "string",
+                "description": "The URL to fetch the previous page",
+                "nullable": true
+              },
+              "next": {
+                "type": "string",
+                "description": "The URL to fetch the next page. Use this link always in order to utilize the cursor pagination",
+                "nullable": true
+              }
+            }
+          },
+          "meta": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string",
+                "description": "The base route of the endpoint (unpaginated)"
+              },
+              "per_page": {
+                "type": "integer",
+                "description": "The max number of items in each page"
+              },
+              "next_cursor": {
+                "type": "string",
+                "description": "The cursor to fetch the next page. Do not use this directly. It will be populated by using the previous response's links.next.",
+                "nullable": true
+              },
+              "prev_cursor": {
+                "type": "string",
+                "description": "The cursor to fetch the previous page. Do not use this directly. It will be populated by using the previous response's links.prev.",
+                "nullable": true
+              }
+            }
+          }
+        }
+      }
+    },
+    "401": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "403": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string",
+            "default": "This action is unauthorized."
+          }
+        }
+      }
+    },
+    "422": {
+      "schema": {
+        "type": "object",
+        "required": [
+          "message"
+        ],
+        "properties": {
+          "message": {
+            "type": "string"
+          },
+          "errors": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "429": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  },
+  "ocpiCommandRead": {
+    "200": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "description": "A command received from an eMSP over OCPI and the result returned for it.",
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "integer",
+                "readOnly": true,
+                "description": "Identifier of the command."
+              },
+              "type": {
+                "description": "The command the roaming partner sent:\n- **cancel_reservation**: Cancel a reservation\n- **reserve_now**: Reserve an EVSE\n- **start_session**: Start a charging session\n- **stop_session**: Stop a charging session\n- **unlock_connector**: Unlock a connector\n- **change_availability**: Change the availability of an EVSE (protocol extension)\n- **get_diagnostics**: Request charge point diagnostics (protocol extension)\n- **reset_evse**: Reset an EVSE (protocol extension)\n- **unknown**: Any command outside this set\n",
+                "type": "string",
+                "enum": [
+                  "cancel_reservation",
+                  "reserve_now",
+                  "start_session",
+                  "stop_session",
+                  "unlock_connector",
+                  "change_availability",
+                  "get_diagnostics",
+                  "reset_evse",
+                  "unknown"
+                ]
+              },
+              "result": {
+                "description": "The result the platform returned to the roaming partner:\n- **accepted**: The command was accepted\n- **rejected**: The command was rejected\n- **not_supported**: The command is not supported for this charge point\n- **timeout**: The charge point did not respond in time\n- **unknown_session**: The referenced session is unknown\n- **failed**: The command failed during execution\n- **evse_occupied**: The EVSE is already in use\n- **evse_inoperative**: The EVSE is not operational\n- **unknown_reservation**: The referenced reservation is unknown\n- **canceled_reservation**: The reservation was cancelled\n- **unknown**: Any result outside the OCPI result set\n",
+                "type": "string",
+                "enum": [
+                  "accepted",
+                  "rejected",
+                  "not_supported",
+                  "timeout",
+                  "unknown_session",
+                  "failed",
+                  "evse_occupied",
+                  "evse_inoperative",
+                  "unknown_reservation",
+                  "canceled_reservation",
+                  "unknown"
+                ]
+              },
+              "failureReason": {
+                "description": "The reason a command did not succeed:\n\nAuthorization and access:\n- **charging_not_allowed**: Charging is not allowed for the authorizing token\n- **location_is_closed**: The location was closed when the command was received\n- **access_restricted**: Access to the charge point is restricted for the authorizing token\n- **user_verification_not_complete**: The user behind the token has not completed verification\n- **terms_not_accepted**: The user has not accepted the required terms and policies\n- **user_is_disabled**: The user account is disabled\n- **authorization_failed**: The authorization of the token was refused\n- **pre_authorization_failed**: The payment pre-authorization for the session failed\n- **token_not_authorized_for_booking**: The token is not authorized to book the requested EVSE\n- **operator_in_migration_mode**: The operator is in migration mode and does not accept new charging\n\nPayment, subscription and billing:\n- **subscription_required**: A subscription plan is required to start charging\n- **unpaid_subscription_fees**: The user has unpaid subscription fees\n- **previous_session_not_paid**: An earlier session of the user is still unpaid\n- **payment_method_required**: The user has no payment method that can be charged\n- **payment_method_expired**: The user's payment method has expired\n- **payment_method_not_allowed**: The user's payment method is not allowed for this charge point\n- **payment_method_doesnt_have_sufficient_funds**: The user's payment method has insufficient funds\n- **cannot_bill_payment_method**: The user's payment method could not be billed\n- **invalid_payment_method_for_direct_charges**: The user's payment method cannot be used for direct charges\n- **user_invoice_details_not_provided**: The user has not provided the invoice details required to be billed\n\nCorporate billing:\n- **corporate_billing_policy_inactive**: The corporate billing policy is not active\n- **corporate_billing_limit_exceeded**: The corporate billing policy limit is exceeded\n- **corporate_account_limit_reached**: The corporate account limit is reached\n- **corporate_billing_currency_mismatch**: The session currency differs from the corporate billing currency\n- **corporate_billing_cross_operator_not_opted_in**: The operator serving the session is not opted in to the partner's cross-operator corporate billing\n- **corporate_billing_exchange_rate_unavailable**: No exchange rate is available to convert the session amount into the corporate billing currency\n- **corporate_billing_charger_type_not_covered**: The charger type is not covered by the corporate billing policy\n- **corporate_billing_partner_not_covered**: The partner is not covered by the corporate billing policy\n- **corporate_billing_country_not_covered**: The country is not covered by the corporate billing policy\n- **corporate_billing_location_not_covered**: The location is not covered by the corporate billing policy\n- **corporate_billing_location_tag_not_covered**: The location tag is not covered by the corporate billing policy\n- **corporate_billing_roaming_not_covered**: Roaming is not covered by the corporate billing policy\n\nTariffs:\n- **tariff_charging_not_allowed**: The applicable tariff does not allow charging\n- **no_tariff_group_configured**: No tariff group is configured for the charge point\n- **tariff_resolution_failed**: No tariff could be resolved for the requested charging\n\nCharge point and EVSE state:\n- **evse_disabled**: The requested EVSE is disabled\n- **evse_out_of_order**: The requested EVSE is out of order\n- **evse_occupied**: The requested EVSE is already in use\n- **evse_inoperative**: The requested EVSE is not operational\n- **evse_has_queued_reservations**: The requested EVSE has queued reservations\n- **ev_not_connected_to_evse**: No vehicle is connected to the requested EVSE\n- **session_already_running**: A charging session is already running\n\nRFID tokens:\n- **rfid_tag_expired**: The RFID tag has expired\n- **rfid_tag_disabled**: The RFID tag is disabled\n- **rfid_tag_suspended**: The RFID tag is suspended\n- **rfid_charge_point_scope_mismatch**: The RFID tag may not be used on the requested charge point\n\nRoaming setup:\n- **ocpi_roaming_not_setup**: The OCPI roaming configuration needed to serve the command is missing\n- **internal_roaming_not_setup**: The internal roaming configuration needed to serve the command is missing\n\nCommand execution:\n- **remote_start_failed**: The charge point refused or failed the remote start\n- **rejected**: The charge point rejected the command\n- **failed**: The command failed while it was being executed\n- **not_supported**: The command is not supported for the requested charge point\n- **timeout**: The charge point did not respond within the command timeout\n- **command_expired**: The command was no longer valid by the time it could be executed\n- **unknown_session**: The referenced charging session is unknown to the platform\n- **unknown_reservation**: The referenced reservation is unknown to the platform\n- **canceled_reservation**: The reservation was cancelled instead of being honoured\n",
+                "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"
+                ]
+              },
+              "sessionId": {
+                "type": "integer",
+                "description": "The related charging session ID."
+              },
+              "reservationId": {
+                "type": "integer",
+                "description": "The related reservation ID."
+              },
+              "evseId": {
+                "type": "integer",
+                "description": "The targeted EVSE ID."
+              },
+              "roamingEmspId": {
+                "type": "integer",
+                "description": "The roaming eMSP ID (`resources/roaming-emsps/v1.0`) the command was received from."
+              },
+              "roamingConnectionId": {
+                "type": "integer",
+                "description": "The roaming connection ID."
+              },
+              "createdAt": {
+                "type": "string",
+                "format": "date-time",
+                "description": "ISO 8601 formatted date",
+                "readOnly": true
+              }
+            },
+            "required": [
+              "id",
+              "type",
+              "createdAt"
+            ]
+          }
+        }
+      }
+    },
+    "401": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "403": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string",
+            "default": "This action is unauthorized."
+          }
+        }
+      }
+    },
+    "404": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
     "429": {
       "schema": {
         "type": "object",
@@ -129176,14 +129629,16 @@
                       "description": "Whether the policy's overall cost-per-kWh cap reduced coverage."
                     },
                     "restrictionCause": {
-                      "description": "Corporate billing restriction dimension that withheld coverage for the session:\n- **partner**: A partner restriction prevented corporate billing from covering the session\n- **country**: A country restriction prevented corporate billing from covering the session\n- **location**: A location restriction prevented corporate billing from covering the session\n- **location_tag**: A location tag restriction prevented corporate billing from covering the session\n- **roaming**: A roaming restriction prevented corporate billing from covering the session\n",
+                      "description": "Corporate billing restriction dimension that withheld coverage for the session:\n- **partner**: A partner restriction prevented corporate billing from covering the session\n- **country**: A country restriction prevented corporate billing from covering the session\n- **location**: A location restriction prevented corporate billing from covering the session\n- **location_tag**: A location tag restriction prevented corporate billing from covering the session\n- **roaming**: A roaming restriction prevented corporate billing from covering the session\n- **cross_operator_not_opted_in**: The service operator and the corporate account home operator have not both opted in to cross-operator corporate billing\n- **exchange_rate_unavailable**: No exchange rate was available to convert the session currency into the corporate account billing currency\n",
                       "type": "string",
                       "enum": [
                         "partner",
                         "country",
                         "location",
                         "location_tag",
-                        "roaming"
+                        "roaming",
+                        "cross_operator_not_opted_in",
+                        "exchange_rate_unavailable"
                       ]
                     },
                     "breakdown": {
@@ -130456,14 +130911,16 @@
                     "description": "Whether the policy's overall cost-per-kWh cap reduced coverage."
                   },
                   "restrictionCause": {
-                    "description": "Corporate billing restriction dimension that withheld coverage for the session:\n- **partner**: A partner restriction prevented corporate billing from covering the session\n- **country**: A country restriction prevented corporate billing from covering the session\n- **location**: A location restriction prevented corporate billing from covering the session\n- **location_tag**: A location tag restriction prevented corporate billing from covering the session\n- **roaming**: A roaming restriction prevented corporate billing from covering the session\n",
+                    "description": "Corporate billing restriction dimension that withheld coverage for the session:\n- **partner**: A partner restriction prevented corporate billing from covering the session\n- **country**: A country restriction prevented corporate billing from covering the session\n- **location**: A location restriction prevented corporate billing from covering the session\n- **location_tag**: A location tag restriction prevented corporate billing from covering the session\n- **roaming**: A roaming restriction prevented corporate billing from covering the session\n- **cross_operator_not_opted_in**: The service operator and the corporate account home operator have not both opted in to cross-operator corporate billing\n- **exchange_rate_unavailable**: No exchange rate was available to convert the session currency into the corporate account billing currency\n",
                     "type": "string",
                     "enum": [
                       "partner",
                       "country",
                       "location",
                       "location_tag",
-                      "roaming"
+                      "roaming",
+                      "cross_operator_not_opted_in",
+                      "exchange_rate_unavailable"
                     ]
                   },
                   "breakdown": {
@@ -142194,6 +142651,29 @@
                     "maximum": 99,
                     "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.",
                     "nullable": true
+                  },
+                  "stopWhenPreAuthorizedAmountFallsBelow": {
+                    "type": "number",
+                    "format": "decimal",
+                    "minimum": 0,
+                    "description": "Tariff-level override that stops the session when the remaining pre-authorised amount drops below this value. When unset, the global default from User billing settings applies. 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.\n"
+                  },
+                  "autoStopAmount": {
+                    "type": "number",
+                    "format": "decimal",
+                    "minimum": 0,
+                    "description": "Tariff-level override that stops the session when the user's available balance drops below this value. When unset, the global default from User billing settings applies. 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.\n"
+                  }
+                }
+              },
+              "startSessionRestrictions": {
+                "type": "object",
+                "properties": {
+                  "minimumBalance": {
+                    "type": "number",
+                    "format": "decimal",
+                    "minimum": 0,
+                    "description": "Tariff-level override for the minimum balance a user must have before a session is allowed to start. When unset, the global default from User billing settings applies. 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.\n"
                   }
                 }
               },
@@ -143348,6 +143828,29 @@
                       "maximum": 99,
                       "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.",
                       "nullable": true
+                    },
+                    "stopWhenPreAuthorizedAmountFallsBelow": {
+                      "type": "number",
+                      "format": "decimal",
+                      "minimum": 0,
+                      "description": "Tariff-level override that stops the session when the remaining pre-authorised amount drops below this value. When unset, the global default from User billing settings applies. 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.\n"
+                    },
+                    "autoStopAmount": {
+                      "type": "number",
+                      "format": "decimal",
+                      "minimum": 0,
+                      "description": "Tariff-level override that stops the session when the user's available balance drops below this value. When unset, the global default from User billing settings applies. 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.\n"
+                    }
+                  }
+                },
+                "startSessionRestrictions": {
+                  "type": "object",
+                  "properties": {
+                    "minimumBalance": {
+                      "type": "number",
+                      "format": "decimal",
+                      "minimum": 0,
+                      "description": "Tariff-level override for the minimum balance a user must have before a session is allowed to start. When unset, the global default from User billing settings applies. 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.\n"
                     }
                   }
                 },
@@ -144629,6 +145132,29 @@
                     "maximum": 99,
                     "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.",
                     "nullable": true
+                  },
+                  "stopWhenPreAuthorizedAmountFallsBelow": {
+                    "type": "number",
+                    "format": "decimal",
+                    "minimum": 0,
+                    "description": "Tariff-level override that stops the session when the remaining pre-authorised amount drops below this value. When unset, the global default from User billing settings applies. 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.\n"
+                  },
+                  "autoStopAmount": {
+                    "type": "number",
+                    "format": "decimal",
+                    "minimum": 0,
+                    "description": "Tariff-level override that stops the session when the user's available balance drops below this value. When unset, the global default from User billing settings applies. 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.\n"
+                  }
+                }
+              },
+              "startSessionRestrictions": {
+                "type": "object",
+                "properties": {
+                  "minimumBalance": {
+                    "type": "number",
+                    "format": "decimal",
+                    "minimum": 0,
+                    "description": "Tariff-level override for the minimum balance a user must have before a session is allowed to start. When unset, the global default from User billing settings applies. 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.\n"
                   }
                 }
               },
@@ -145795,6 +146321,29 @@
                     "maximum": 99,
                     "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.",
                     "nullable": true
+                  },
+                  "stopWhenPreAuthorizedAmountFallsBelow": {
+                    "type": "number",
+                    "format": "decimal",
+                    "minimum": 0,
+                    "description": "Tariff-level override that stops the session when the remaining pre-authorised amount drops below this value. When unset, the global default from User billing settings applies. 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.\n"
+                  },
+                  "autoStopAmount": {
+                    "type": "number",
+                    "format": "decimal",
+                    "minimum": 0,
+                    "description": "Tariff-level override that stops the session when the user's available balance drops below this value. When unset, the global default from User billing settings applies. 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.\n"
+                  }
+                }
+              },
+              "startSessionRestrictions": {
+                "type": "object",
+                "properties": {
+                  "minimumBalance": {
+                    "type": "number",
+                    "format": "decimal",
+                    "minimum": 0,
+                    "description": "Tariff-level override for the minimum balance a user must have before a session is allowed to start. When unset, the global default from User billing settings applies. 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.\n"
                   }
                 }
               },
@@ -146949,6 +147498,29 @@
                     "maximum": 99,
                     "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.",
                     "nullable": true
+                  },
+                  "stopWhenPreAuthorizedAmountFallsBelow": {
+                    "type": "number",
+                    "format": "decimal",
+                    "minimum": 0,
+                    "description": "Tariff-level override that stops the session when the remaining pre-authorised amount drops below this value. When unset, the global default from User billing settings applies. 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.\n"
+                  },
+                  "autoStopAmount": {
+                    "type": "number",
+                    "format": "decimal",
+                    "minimum": 0,
+                    "description": "Tariff-level override that stops the session when the user's available balance drops below this value. When unset, the global default from User billing settings applies. 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.\n"
+                  }
+                }
+              },
+              "startSessionRestrictions": {
+                "type": "object",
+                "properties": {
+                  "minimumBalance": {
+                    "type": "number",
+                    "format": "decimal",
+                    "minimum": 0,
+                    "description": "Tariff-level override for the minimum balance a user must have before a session is allowed to start. When unset, the global default from User billing settings applies. 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.\n"
                   }
                 }
               },
@@ -148178,6 +148750,29 @@
                     "maximum": 99,
                     "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.",
                     "nullable": true
+                  },
+                  "stopWhenPreAuthorizedAmountFallsBelow": {
+                    "type": "number",
+                    "format": "decimal",
+                    "minimum": 0,
+                    "description": "Tariff-level override that stops the session when the remaining pre-authorised amount drops below this value. When unset, the global default from User billing settings applies. 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.\n"
+                  },
+                  "autoStopAmount": {
+                    "type": "number",
+                    "format": "decimal",
+                    "minimum": 0,
+                    "description": "Tariff-level override that stops the session when the user's available balance drops below this value. When unset, the global default from User billing settings applies. 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.\n"
+                  }
+                }
+              },
+              "startSessionRestrictions": {
+                "type": "object",
+                "properties": {
+                  "minimumBalance": {
+                    "type": "number",
+                    "format": "decimal",
+                    "minimum": 0,
+                    "description": "Tariff-level override for the minimum balance a user must have before a session is allowed to start. When unset, the global default from User billing settings applies. 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.\n"
                   }
                 }
               },
@@ -154943,12 +155538,14 @@
                 },
                 "invoiceId": {
                   "type": "integer",
-                  "nullable": true
+                  "nullable": true,
+                  "description": "The ID of the transaction's current valid invoice. When an invoice is fully reversed by a\ncredit note and a replacement invoice is issued for the transaction, this points at the\nreplacement, not at the reversed original. The value is therefore not stable for the lifetime\nof the transaction - re-read it rather than caching the transaction-to-invoice mapping.\n"
                 },
                 "invoiceNo": {
                   "deprecated": true,
                   "type": "string",
-                  "nullable": true
+                  "nullable": true,
+                  "description": "**This property is deprecated. Use `invoiceId` instead.**\n\nThe number of the transaction's current valid invoice. When an invoice is fully reversed by a\ncredit note and a replacement invoice is issued for the transaction, this carries the\nreplacement's number, not the reversed original's.\n"
                 },
                 "receiptId": {
                   "type": "integer",
@@ -155505,12 +156102,14 @@
               },
               "invoiceId": {
                 "type": "integer",
-                "nullable": true
+                "nullable": true,
+                "description": "The ID of the transaction's current valid invoice. When an invoice is fully reversed by a\ncredit note and a replacement invoice is issued for the transaction, this points at the\nreplacement, not at the reversed original. The value is therefore not stable for the lifetime\nof the transaction - re-read it rather than caching the transaction-to-invoice mapping.\n"
               },
               "invoiceNo": {
                 "deprecated": true,
                 "type": "string",
-                "nullable": true
+                "nullable": true,
+                "description": "**This property is deprecated. Use `invoiceId` instead.**\n\nThe number of the transaction's current valid invoice. When an invoice is fully reversed by a\ncredit note and a replacement invoice is issued for the transaction, this carries the\nreplacement's number, not the reversed original's.\n"
               },
               "receiptId": {
                 "type": "integer",
@@ -155805,6 +156404,19 @@
         }
       }
     },
+    "424": {
+      "schema": {
+        "type": "object",
+        "required": [
+          "message"
+        ],
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
     "429": {
       "schema": {
         "type": "object",
@@ -155939,12 +156551,14 @@
           },
           "invoiceId": {
             "type": "integer",
-            "nullable": true
+            "nullable": true,
+            "description": "The ID of the transaction's current valid invoice. When an invoice is fully reversed by a\ncredit note and a replacement invoice is issued for the transaction, this points at the\nreplacement, not at the reversed original. The value is therefore not stable for the lifetime\nof the transaction - re-read it rather than caching the transaction-to-invoice mapping.\n"
           },
           "invoiceNo": {
             "deprecated": true,
             "type": "string",
-            "nullable": true
+            "nullable": true,
+            "description": "**This property is deprecated. Use `invoiceId` instead.**\n\nThe number of the transaction's current valid invoice. When an invoice is fully reversed by a\ncredit note and a replacement invoice is issued for the transaction, this carries the\nreplacement's number, not the reversed original's.\n"
           },
           "receiptId": {
             "type": "integer",
@@ -156384,12 +156998,14 @@
               },
               "invoiceId": {
                 "type": "integer",
-                "nullable": true
+                "nullable": true,
+                "description": "The ID of the transaction's current valid invoice. When an invoice is fully reversed by a\ncredit note and a replacement invoice is issued for the transaction, this points at the\nreplacement, not at the reversed original. The value is therefore not stable for the lifetime\nof the transaction - re-read it rather than caching the transaction-to-invoice mapping.\n"
               },
               "invoiceNo": {
                 "deprecated": true,
                 "type": "string",
-                "nullable": true
+                "nullable": true,
+                "description": "**This property is deprecated. Use `invoiceId` instead.**\n\nThe number of the transaction's current valid invoice. When an invoice is fully reversed by a\ncredit note and a replacement invoice is issued for the transaction, this carries the\nreplacement's number, not the reversed original's.\n"
               },
               "receiptId": {
                 "type": "integer",
@@ -156684,6 +157300,19 @@
         }
       }
     },
+    "424": {
+      "schema": {
+        "type": "object",
+        "required": [
+          "message"
+        ],
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
     "429": {
       "schema": {
         "type": "object",
@@ -157413,6 +158042,120 @@
       }
     }
   },
+  "userGroupReplace": {
+    "200": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "integer",
+                "readOnly": true
+              },
+              "operatorId": {
+                "type": "integer",
+                "readOnly": true,
+                "description": "The ID of the operator this resource belongs to",
+                "example": 1
+              },
+              "name": {
+                "type": "string"
+              },
+              "partnerId": {
+                "type": "integer",
+                "description": "The partnerId can be updated only if there are no users added to the user group",
+                "nullable": true
+              },
+              "description": {
+                "type": "string",
+                "nullable": true
+              },
+              "externalId": {
+                "type": "string",
+                "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",
+                "readOnly": true
+              }
+            },
+            "required": [
+              "id",
+              "operatorId",
+              "name"
+            ]
+          }
+        }
+      }
+    },
+    "401": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "403": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string",
+            "default": "This action is unauthorized."
+          }
+        }
+      }
+    },
+    "404": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "422": {
+      "schema": {
+        "type": "object",
+        "required": [
+          "message"
+        ],
+        "properties": {
+          "message": {
+            "type": "string"
+          },
+          "errors": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "429": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  },
   "userGroupDelete": {
     "401": {
       "schema": {