@ampeco/public-api-mcp 3.258.1 → 3.259.1

package/dist/generated/response-schemas.json

@@ -1849,17 +1849,19 @@
               "PAYMENT_METHOD_REQUIRED",
               "CANNOT_BILL_PAYMENT_METHOD",
               "CORPORATE_ACCOUNT_LIMIT_REACHED",
+              "corporate_billing_disabled",
               "corporate_billing_policy_inactive",
               "corporate_billing_limit_exceeded",
               "CANNOT_USE_EXPIRED_PAYMENT_METHOD",
               "CANNOT_USE_PAYMENT_METHOD",
               "PAYMENT_NO_FUNDS"
             ],
-            "description": "Reason for the error causing the session to fail starting:\n  * `BILLING_NOT_ASSOCIATED` - The selected corporate billing is not associated with the user\n  * `BILLING_NOT_PARTNER_ASSOCIATED` - The selected corporate billing is allowed on EVSEs that are not associated with the partner\n  * `INTERNAL_ISSUE` - Internal issue\n  * `SESSION_EXISTS` - Session already exists\n  * `CHARGING_NOT_ALLOWED` - The tariff does not allow to charge on this evse\n  * `LOCATION_IS_CLOSED` - Charge point's location is closed\n  * `USER_VALIDATION_NOT_COMPLETE` - Either your email or phone is not verified or your profile is not completed\n  * `TERMS_NOT_ACCEPTED` - User hasn't accepted latest Terms\n  * `USER_IS_DISABLED` - Your account is disabled\n  * `SUBSCRIPTION_REQUIRED` - You do not have an active subscription for this charging point\n  * `SESSION_ALREADY_RUNNING` - Having another running session is not allowed\n  * `PREVIOUS_SESSION_NOT_PAID` - Cannot start new session before paying the previous one\n  * `UNPAID_SUBSCRIPTION_FEES` - Cannot start a session when you have unpaid post-paid subscription fees\n  * `ACCESS_RESTRICTED` - You do not have access to this charge point\n  * `PAYMENT_METHOD_REQUIRED` - Cannot start a session without a payment method\n  * `CANNOT_BILL_PAYMENT_METHOD` - The payment method either is invalid or the partner does not allow billing\n  * `CORPORATE_ACCOUNT_LIMIT_REACHED` - Corporate billing is not allowed, corporate billing is not set up, corporate billing limit is reached or your payment method has insufficient funds.\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  * `CANNOT_USE_EXPIRED_PAYMENT_METHOD` - The payment method has expired\n  * `CANNOT_USE_PAYMENT_METHOD` - Payment method is not allowed or your subscription is cancelled\n  * `PAYMENT_NO_FUNDS` - The current balance is below the needed minimum amount or there are not enough funds in the credit card (works only if you use Stripe)\n"
+            "description": "Reason for the error causing the session to fail starting:\n  * `BILLING_NOT_ASSOCIATED` - The selected corporate billing is not associated with the user\n  * `BILLING_NOT_PARTNER_ASSOCIATED` - The selected corporate billing is allowed on EVSEs that are not associated with the partner\n  * `INTERNAL_ISSUE` - Internal issue\n  * `SESSION_EXISTS` - Session already exists\n  * `CHARGING_NOT_ALLOWED` - The tariff does not allow to charge on this evse\n  * `LOCATION_IS_CLOSED` - Charge point's location is closed\n  * `USER_VALIDATION_NOT_COMPLETE` - Either your email or phone is not verified or your profile is not completed\n  * `TERMS_NOT_ACCEPTED` - User hasn't accepted latest Terms\n  * `USER_IS_DISABLED` - Your account is disabled\n  * `SUBSCRIPTION_REQUIRED` - You do not have an active subscription for this charging point\n  * `SESSION_ALREADY_RUNNING` - Having another running session is not allowed\n  * `PREVIOUS_SESSION_NOT_PAID` - Cannot start new session before paying the previous one\n  * `UNPAID_SUBSCRIPTION_FEES` - Cannot start a session when you have unpaid post-paid subscription fees\n  * `ACCESS_RESTRICTED` - You do not have access to this charge point\n  * `PAYMENT_METHOD_REQUIRED` - Cannot start a session without a payment method\n  * `CANNOT_BILL_PAYMENT_METHOD` - The payment method either is invalid or the partner does not allow billing\n  * `CORPORATE_ACCOUNT_LIMIT_REACHED` - Legacy corporate-account refusal code; disabled billing is reported as `corporate_billing_disabled`, and spending-limit exhaustion as `corporate_billing_limit_exceeded`.\n  * `corporate_billing_disabled` - Corporate billing is switched off for the partner or the user's accepted invite.\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  * `CANNOT_USE_EXPIRED_PAYMENT_METHOD` - The payment method has expired\n  * `CANNOT_USE_PAYMENT_METHOD` - Payment method is not allowed or your subscription is cancelled\n  * `PAYMENT_NO_FUNDS` - The current balance is below the needed minimum amount or there are not enough funds in the credit card (works only if you use Stripe)\n"
           },
           "rejectedPaymentMethodErrorCode": {
             "type": "string",
             "enum": [
+              "corporate_billing_disabled",
               "corporate_billing_policy_inactive",
               "corporate_billing_limit_exceeded",
               "corporate_billing_currency_mismatch",
@@ -1870,7 +1872,7 @@
               "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:\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"
+            "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_disabled` - Corporate billing is switched off for the partner or the user's accepted invite.\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"
           }
         }
       }
@@ -4136,17 +4138,19 @@
               "PAYMENT_METHOD_REQUIRED",
               "CANNOT_BILL_PAYMENT_METHOD",
               "CORPORATE_ACCOUNT_LIMIT_REACHED",
+              "corporate_billing_disabled",
               "corporate_billing_policy_inactive",
               "corporate_billing_limit_exceeded",
               "CANNOT_USE_EXPIRED_PAYMENT_METHOD",
               "CANNOT_USE_PAYMENT_METHOD",
               "PAYMENT_NO_FUNDS"
             ],
-            "description": "Reason for the error causing the session to fail starting:\n  * `BILLING_NOT_ASSOCIATED` - The selected corporate billing is not associated with the user\n  * `BILLING_NOT_PARTNER_ASSOCIATED` - The selected corporate billing is allowed on EVSEs that are not associated with the partner\n  * `INTERNAL_ISSUE` - Internal issue\n  * `SESSION_EXISTS` - Session already exists\n  * `CHARGING_NOT_ALLOWED` - The tariff does not allow to charge on this evse\n  * `LOCATION_IS_CLOSED` - Charge point's location is closed\n  * `USER_VALIDATION_NOT_COMPLETE` - Either your email or phone is not verified or your profile is not completed\n  * `TERMS_NOT_ACCEPTED` - User hasn't accepted latest Terms\n  * `USER_IS_DISABLED` - Your account is disabled\n  * `SUBSCRIPTION_REQUIRED` - You do not have an active subscription for this charging point\n  * `SESSION_ALREADY_RUNNING` - Having another running session is not allowed\n  * `PREVIOUS_SESSION_NOT_PAID` - Cannot start new session before paying the previous one\n  * `UNPAID_SUBSCRIPTION_FEES` - Cannot start a session when you have unpaid post-paid subscription fees\n  * `ACCESS_RESTRICTED` - You do not have access to this charge point\n  * `PAYMENT_METHOD_REQUIRED` - Cannot start a session without a payment method\n  * `CANNOT_BILL_PAYMENT_METHOD` - The payment method either is invalid or the partner does not allow billing\n  * `CORPORATE_ACCOUNT_LIMIT_REACHED` - Corporate billing is not allowed, corporate billing is not set up, corporate billing limit is reached or your payment method has insufficient funds.\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  * `CANNOT_USE_EXPIRED_PAYMENT_METHOD` - The payment method has expired\n  * `CANNOT_USE_PAYMENT_METHOD` - Payment method is not allowed or your subscription is cancelled\n  * `PAYMENT_NO_FUNDS` - The current balance is below the needed minimum amount or there are not enough funds in the credit card (works only if you use Stripe)\n"
+            "description": "Reason for the error causing the session to fail starting:\n  * `BILLING_NOT_ASSOCIATED` - The selected corporate billing is not associated with the user\n  * `BILLING_NOT_PARTNER_ASSOCIATED` - The selected corporate billing is allowed on EVSEs that are not associated with the partner\n  * `INTERNAL_ISSUE` - Internal issue\n  * `SESSION_EXISTS` - Session already exists\n  * `CHARGING_NOT_ALLOWED` - The tariff does not allow to charge on this evse\n  * `LOCATION_IS_CLOSED` - Charge point's location is closed\n  * `USER_VALIDATION_NOT_COMPLETE` - Either your email or phone is not verified or your profile is not completed\n  * `TERMS_NOT_ACCEPTED` - User hasn't accepted latest Terms\n  * `USER_IS_DISABLED` - Your account is disabled\n  * `SUBSCRIPTION_REQUIRED` - You do not have an active subscription for this charging point\n  * `SESSION_ALREADY_RUNNING` - Having another running session is not allowed\n  * `PREVIOUS_SESSION_NOT_PAID` - Cannot start new session before paying the previous one\n  * `UNPAID_SUBSCRIPTION_FEES` - Cannot start a session when you have unpaid post-paid subscription fees\n  * `ACCESS_RESTRICTED` - You do not have access to this charge point\n  * `PAYMENT_METHOD_REQUIRED` - Cannot start a session without a payment method\n  * `CANNOT_BILL_PAYMENT_METHOD` - The payment method either is invalid or the partner does not allow billing\n  * `CORPORATE_ACCOUNT_LIMIT_REACHED` - Legacy corporate-account refusal code; disabled billing is reported as `corporate_billing_disabled`, and spending-limit exhaustion as `corporate_billing_limit_exceeded`.\n  * `corporate_billing_disabled` - Corporate billing is switched off for the partner or the user's accepted invite.\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  * `CANNOT_USE_EXPIRED_PAYMENT_METHOD` - The payment method has expired\n  * `CANNOT_USE_PAYMENT_METHOD` - Payment method is not allowed or your subscription is cancelled\n  * `PAYMENT_NO_FUNDS` - The current balance is below the needed minimum amount or there are not enough funds in the credit card (works only if you use Stripe)\n"
           },
           "rejectedPaymentMethodErrorCode": {
             "type": "string",
             "enum": [
+              "corporate_billing_disabled",
               "corporate_billing_policy_inactive",
               "corporate_billing_limit_exceeded",
               "corporate_billing_currency_mismatch",
@@ -4157,7 +4161,7 @@
               "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:\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"
+            "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_disabled` - Corporate billing is switched off for the partner or the user's accepted invite.\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"
           }
         }
       }
@@ -15100,7 +15104,7 @@
         "type": "object",
         "properties": {
           "data": {
-            "description": "Reimbursement record read schema. A record is one immutable computed reimbursement entry for a single charging session, and has no general resource write surface. Reversing (credit) records are records too — they carry negated amounts and point at the record they reverse.\n",
+            "description": "⚠️ Experimental feature — not yet a stable contract. This schema ships as experimental / beta. While experimental, it may change without a version bump — including breaking changes — wherever it is returned, including the session `reimbursementRecords` include. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed.\n\nReimbursement record read schema. A record is one immutable computed reimbursement entry for a single charging session, and has no general resource write surface. Reversing (credit) records are records too — they carry negated amounts and point at the record they reverse.\n",
             "type": "object",
             "properties": {
               "id": {
@@ -15535,7 +15539,7 @@
         ],
         "properties": {
           "data": {
-            "description": "Reimbursement record read schema. A record is one immutable computed reimbursement entry for a single charging session, and has no general resource write surface. Reversing (credit) records are records too — they carry negated amounts and point at the record they reverse.\n",
+            "description": "⚠️ Experimental feature — not yet a stable contract. This schema ships as experimental / beta. While experimental, it may change without a version bump — including breaking changes — wherever it is returned, including the session `reimbursementRecords` include. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed.\n\nReimbursement record read schema. A record is one immutable computed reimbursement entry for a single charging session, and has no general resource write surface. Reversing (credit) records are records too — they carry negated amounts and point at the record they reverse.\n",
             "type": "object",
             "properties": {
               "id": {
@@ -29146,7 +29150,7 @@
               "anyOf": [
                 {
                   "title": "Create Booking Base",
-                  "description": "Base properties for create booking request (shared between input and response)",
+                  "description": "Base properties for create booking requests, shared between input and response.\n\nExisting commercial-public selection is unchanged. Commercial-private eligibility additionally requires the booking user's accepted partner-invite access-policy grants for own or shared charge points; other charging authorization cannot replace these grants. Personal charge points are excluded. See the location check booking availability action for the eligibility policy.\n\nIf no candidate can be selected, the created request is rejected. Its persisted rejectionReason can include booking-enabled EVSEs that are not accessible to the user, separately from EVSEs with booking disabled and other selection failures.\n",
                   "type": "object",
                   "properties": {
                     "id": {
@@ -29173,7 +29177,7 @@
                     },
                     "rejectionReason": {
                       "type": "string",
-                      "description": "Human-readable reason for rejection.\n\nResponse behavior: Only present when status is \"rejected\". Omitted for \"pending\" and \"approved\" requests.\n",
+                      "description": "Human-readable business rejection reason, persisted with the booking request and returned by its listing and read operations. Access-related rejections use this existing property, not a separate error code. See the create and update request schema descriptions for access-rejection conditions.\n\nResponse behavior: Only present when status is \"rejected\". Omitted for \"pending\" and \"approved\" requests.\n",
                       "readOnly": true
                     },
                     "createdAt": {
@@ -29188,7 +29192,7 @@
                     },
                     "userId": {
                       "type": "integer",
-                      "description": "ID of the user for whom the booking is made"
+                      "description": "ID of the booking user, who must be visible to the requesting admin. This user's accepted partner-invite access-policy grants determine commercial-private booking eligibility; commercial-public selection remains unchanged."
                     },
                     "locationId": {
                       "type": "integer",
@@ -29211,7 +29215,7 @@
                     },
                     "evseId": {
                       "type": "integer",
-                      "description": "Specific EVSE ID to book.\n\nResponse behavior: Only present when a specific EVSE was requested. Omitted when EVSE selection was based on criteria or left to the system.\n"
+                      "description": "Specific EVSE ID to book. The reference must be visible to the requesting admin and belong to the requested location. A valid commercial-private reference still requires the booking user's private eligibility; lack of that eligibility is a business rejection, not an unknown-reference validation error.\n\nResponse behavior: Only present when a specific EVSE was requested. Omitted when EVSE selection was based on criteria or left to the system.\n"
                     },
                     "evseCriteria": {
                       "type": "object",
@@ -29383,7 +29387,7 @@
                 },
                 {
                   "title": "Update Booking Base",
-                  "description": "Base properties for update booking request (shared between input and response)",
+                  "description": "Base properties for update booking requests, shared between input and response.\n\nAccess is evaluated for the resulting booking user and time slot at the booking's location. Omitting userId retains the current user. The supported update input does not carry evseId, evseCriteria or parkingSpaceCriteria from the original create request; original create criteria are not reapplied by this input.\n\nWhen no candidate remains, the request is rejected for lack of user access if a caller-visible, booking-enabled, access-excluded commercial-private EVSE satisfies the effective update selection requirements. This access attribution is independent of occupancy. Other empty selection results retain the time-slot-unavailable rejection. A successful selection takes precedence over these rejection reasons.\n\nAn access rejection persists the booking request with status \"rejected\" and rejectionReason \"The booking cannot be updated because the user has no access to a bookable EVSE at the location.\" The existing booking's user, held EVSEs, dates, reservation and reservation cycle remain unchanged.\n",
                   "type": "object",
                   "properties": {
                     "id": {
@@ -29410,7 +29414,7 @@
                     },
                     "rejectionReason": {
                       "type": "string",
-                      "description": "Human-readable reason for rejection.\n\nResponse behavior: Only present when status is \"rejected\". Omitted for \"pending\" and \"approved\" requests.\n",
+                      "description": "Human-readable business rejection reason, persisted with the booking request and returned by its listing and read operations. Access-related rejections use this existing property, not a separate error code. See the create and update request schema descriptions for access-rejection conditions.\n\nResponse behavior: Only present when status is \"rejected\". Omitted for \"pending\" and \"approved\" requests.\n",
                       "readOnly": true
                     },
                     "createdAt": {
@@ -29429,7 +29433,7 @@
                     },
                     "userId": {
                       "type": "integer",
-                      "description": "ID of the user for whom the booking is made"
+                      "description": "ID of the proposed booking user, who must be visible to the requesting admin. Access is evaluated for this resulting user; when omitted, the booking's current user is retained and evaluated. A rejected update does not change the booking's user."
                     },
                     "externalId": {
                       "type": "string",
@@ -29524,7 +29528,7 @@
                     },
                     "rejectionReason": {
                       "type": "string",
-                      "description": "Human-readable reason for rejection.\n\nResponse behavior: Only present when status is \"rejected\". Omitted for \"pending\" and \"approved\" requests.\n",
+                      "description": "Human-readable business rejection reason, persisted with the booking request and returned by its listing and read operations. Access-related rejections use this existing property, not a separate error code. See the create and update request schema descriptions for access-rejection conditions.\n\nResponse behavior: Only present when status is \"rejected\". Omitted for \"pending\" and \"approved\" requests.\n",
                       "readOnly": true
                     },
                     "createdAt": {
@@ -29651,7 +29655,7 @@
             "anyOf": [
               {
                 "title": "Create Booking Base",
-                "description": "Base properties for create booking request (shared between input and response)",
+                "description": "Base properties for create booking requests, shared between input and response.\n\nExisting commercial-public selection is unchanged. Commercial-private eligibility additionally requires the booking user's accepted partner-invite access-policy grants for own or shared charge points; other charging authorization cannot replace these grants. Personal charge points are excluded. See the location check booking availability action for the eligibility policy.\n\nIf no candidate can be selected, the created request is rejected. Its persisted rejectionReason can include booking-enabled EVSEs that are not accessible to the user, separately from EVSEs with booking disabled and other selection failures.\n",
                 "type": "object",
                 "properties": {
                   "id": {
@@ -29678,7 +29682,7 @@
                   },
                   "rejectionReason": {
                     "type": "string",
-                    "description": "Human-readable reason for rejection.\n\nResponse behavior: Only present when status is \"rejected\". Omitted for \"pending\" and \"approved\" requests.\n",
+                    "description": "Human-readable business rejection reason, persisted with the booking request and returned by its listing and read operations. Access-related rejections use this existing property, not a separate error code. See the create and update request schema descriptions for access-rejection conditions.\n\nResponse behavior: Only present when status is \"rejected\". Omitted for \"pending\" and \"approved\" requests.\n",
                     "readOnly": true
                   },
                   "createdAt": {
@@ -29693,7 +29697,7 @@
                   },
                   "userId": {
                     "type": "integer",
-                    "description": "ID of the user for whom the booking is made"
+                    "description": "ID of the booking user, who must be visible to the requesting admin. This user's accepted partner-invite access-policy grants determine commercial-private booking eligibility; commercial-public selection remains unchanged."
                   },
                   "locationId": {
                     "type": "integer",
@@ -29716,7 +29720,7 @@
                   },
                   "evseId": {
                     "type": "integer",
-                    "description": "Specific EVSE ID to book.\n\nResponse behavior: Only present when a specific EVSE was requested. Omitted when EVSE selection was based on criteria or left to the system.\n"
+                    "description": "Specific EVSE ID to book. The reference must be visible to the requesting admin and belong to the requested location. A valid commercial-private reference still requires the booking user's private eligibility; lack of that eligibility is a business rejection, not an unknown-reference validation error.\n\nResponse behavior: Only present when a specific EVSE was requested. Omitted when EVSE selection was based on criteria or left to the system.\n"
                   },
                   "evseCriteria": {
                     "type": "object",
@@ -29888,7 +29892,7 @@
               },
               {
                 "title": "Update Booking Base",
-                "description": "Base properties for update booking request (shared between input and response)",
+                "description": "Base properties for update booking requests, shared between input and response.\n\nAccess is evaluated for the resulting booking user and time slot at the booking's location. Omitting userId retains the current user. The supported update input does not carry evseId, evseCriteria or parkingSpaceCriteria from the original create request; original create criteria are not reapplied by this input.\n\nWhen no candidate remains, the request is rejected for lack of user access if a caller-visible, booking-enabled, access-excluded commercial-private EVSE satisfies the effective update selection requirements. This access attribution is independent of occupancy. Other empty selection results retain the time-slot-unavailable rejection. A successful selection takes precedence over these rejection reasons.\n\nAn access rejection persists the booking request with status \"rejected\" and rejectionReason \"The booking cannot be updated because the user has no access to a bookable EVSE at the location.\" The existing booking's user, held EVSEs, dates, reservation and reservation cycle remain unchanged.\n",
                 "type": "object",
                 "properties": {
                   "id": {
@@ -29915,7 +29919,7 @@
                   },
                   "rejectionReason": {
                     "type": "string",
-                    "description": "Human-readable reason for rejection.\n\nResponse behavior: Only present when status is \"rejected\". Omitted for \"pending\" and \"approved\" requests.\n",
+                    "description": "Human-readable business rejection reason, persisted with the booking request and returned by its listing and read operations. Access-related rejections use this existing property, not a separate error code. See the create and update request schema descriptions for access-rejection conditions.\n\nResponse behavior: Only present when status is \"rejected\". Omitted for \"pending\" and \"approved\" requests.\n",
                     "readOnly": true
                   },
                   "createdAt": {
@@ -29934,7 +29938,7 @@
                   },
                   "userId": {
                     "type": "integer",
-                    "description": "ID of the user for whom the booking is made"
+                    "description": "ID of the proposed booking user, who must be visible to the requesting admin. Access is evaluated for this resulting user; when omitted, the booking's current user is retained and evaluated. A rejected update does not change the booking's user."
                   },
                   "externalId": {
                     "type": "string",
@@ -30029,7 +30033,7 @@
                   },
                   "rejectionReason": {
                     "type": "string",
-                    "description": "Human-readable reason for rejection.\n\nResponse behavior: Only present when status is \"rejected\". Omitted for \"pending\" and \"approved\" requests.\n",
+                    "description": "Human-readable business rejection reason, persisted with the booking request and returned by its listing and read operations. Access-related rejections use this existing property, not a separate error code. See the create and update request schema descriptions for access-rejection conditions.\n\nResponse behavior: Only present when status is \"rejected\". Omitted for \"pending\" and \"approved\" requests.\n",
                     "readOnly": true
                   },
                   "createdAt": {
@@ -30139,7 +30143,7 @@
             "anyOf": [
               {
                 "title": "Create Booking Base",
-                "description": "Base properties for create booking request (shared between input and response)",
+                "description": "Base properties for create booking requests, shared between input and response.\n\nExisting commercial-public selection is unchanged. Commercial-private eligibility additionally requires the booking user's accepted partner-invite access-policy grants for own or shared charge points; other charging authorization cannot replace these grants. Personal charge points are excluded. See the location check booking availability action for the eligibility policy.\n\nIf no candidate can be selected, the created request is rejected. Its persisted rejectionReason can include booking-enabled EVSEs that are not accessible to the user, separately from EVSEs with booking disabled and other selection failures.\n",
                 "type": "object",
                 "properties": {
                   "id": {
@@ -30166,7 +30170,7 @@
                   },
                   "rejectionReason": {
                     "type": "string",
-                    "description": "Human-readable reason for rejection.\n\nResponse behavior: Only present when status is \"rejected\". Omitted for \"pending\" and \"approved\" requests.\n",
+                    "description": "Human-readable business rejection reason, persisted with the booking request and returned by its listing and read operations. Access-related rejections use this existing property, not a separate error code. See the create and update request schema descriptions for access-rejection conditions.\n\nResponse behavior: Only present when status is \"rejected\". Omitted for \"pending\" and \"approved\" requests.\n",
                     "readOnly": true
                   },
                   "createdAt": {
@@ -30181,7 +30185,7 @@
                   },
                   "userId": {
                     "type": "integer",
-                    "description": "ID of the user for whom the booking is made"
+                    "description": "ID of the booking user, who must be visible to the requesting admin. This user's accepted partner-invite access-policy grants determine commercial-private booking eligibility; commercial-public selection remains unchanged."
                   },
                   "locationId": {
                     "type": "integer",
@@ -30204,7 +30208,7 @@
                   },
                   "evseId": {
                     "type": "integer",
-                    "description": "Specific EVSE ID to book.\n\nResponse behavior: Only present when a specific EVSE was requested. Omitted when EVSE selection was based on criteria or left to the system.\n"
+                    "description": "Specific EVSE ID to book. The reference must be visible to the requesting admin and belong to the requested location. A valid commercial-private reference still requires the booking user's private eligibility; lack of that eligibility is a business rejection, not an unknown-reference validation error.\n\nResponse behavior: Only present when a specific EVSE was requested. Omitted when EVSE selection was based on criteria or left to the system.\n"
                   },
                   "evseCriteria": {
                     "type": "object",
@@ -30376,7 +30380,7 @@
               },
               {
                 "title": "Update Booking Base",
-                "description": "Base properties for update booking request (shared between input and response)",
+                "description": "Base properties for update booking requests, shared between input and response.\n\nAccess is evaluated for the resulting booking user and time slot at the booking's location. Omitting userId retains the current user. The supported update input does not carry evseId, evseCriteria or parkingSpaceCriteria from the original create request; original create criteria are not reapplied by this input.\n\nWhen no candidate remains, the request is rejected for lack of user access if a caller-visible, booking-enabled, access-excluded commercial-private EVSE satisfies the effective update selection requirements. This access attribution is independent of occupancy. Other empty selection results retain the time-slot-unavailable rejection. A successful selection takes precedence over these rejection reasons.\n\nAn access rejection persists the booking request with status \"rejected\" and rejectionReason \"The booking cannot be updated because the user has no access to a bookable EVSE at the location.\" The existing booking's user, held EVSEs, dates, reservation and reservation cycle remain unchanged.\n",
                 "type": "object",
                 "properties": {
                   "id": {
@@ -30403,7 +30407,7 @@
                   },
                   "rejectionReason": {
                     "type": "string",
-                    "description": "Human-readable reason for rejection.\n\nResponse behavior: Only present when status is \"rejected\". Omitted for \"pending\" and \"approved\" requests.\n",
+                    "description": "Human-readable business rejection reason, persisted with the booking request and returned by its listing and read operations. Access-related rejections use this existing property, not a separate error code. See the create and update request schema descriptions for access-rejection conditions.\n\nResponse behavior: Only present when status is \"rejected\". Omitted for \"pending\" and \"approved\" requests.\n",
                     "readOnly": true
                   },
                   "createdAt": {
@@ -30422,7 +30426,7 @@
                   },
                   "userId": {
                     "type": "integer",
-                    "description": "ID of the user for whom the booking is made"
+                    "description": "ID of the proposed booking user, who must be visible to the requesting admin. Access is evaluated for this resulting user; when omitted, the booking's current user is retained and evaluated. A rejected update does not change the booking's user."
                   },
                   "externalId": {
                     "type": "string",
@@ -30517,7 +30521,7 @@
                   },
                   "rejectionReason": {
                     "type": "string",
-                    "description": "Human-readable reason for rejection.\n\nResponse behavior: Only present when status is \"rejected\". Omitted for \"pending\" and \"approved\" requests.\n",
+                    "description": "Human-readable business rejection reason, persisted with the booking request and returned by its listing and read operations. Access-related rejections use this existing property, not a separate error code. See the create and update request schema descriptions for access-rejection conditions.\n\nResponse behavior: Only present when status is \"rejected\". Omitted for \"pending\" and \"approved\" requests.\n",
                     "readOnly": true
                   },
                   "createdAt": {
@@ -30686,14 +30690,15 @@
                 },
                 "failureReason": {
                   "readOnly": true,
-                  "description": "Recorded cause of a failed booking:\n- **request_not_processed**: The booking request could not be processed.\n- **booking_holds_no_evse**: The booking had no EVSE candidates to reserve.\n- **evse_occupied_or_reserved**: The EVSE was occupied or already reserved.\n- **charge_point_rejected_or_unresponsive**: The charge point rejected the reservation or was unresponsive.\n- **could_not_be_reserved**: The booking could not be reserved without an established more specific cause, including overdue recovery.\n\nIntegrations must tolerate future unknown values as new failure reasons may be added.\n",
+                  "description": "Recorded cause of a failed booking:\n- **request_not_processed**: The booking request could not be processed.\n- **booking_holds_no_evse**: The booking had no EVSE candidates to reserve.\n- **evse_occupied_or_reserved**: The EVSE was occupied or already reserved.\n- **charge_point_rejected_or_unresponsive**: The charge point rejected the reservation or was unresponsive.\n- **could_not_be_reserved**: The booking could not be reserved without an established more specific cause, including overdue recovery.\n- **user_no_longer_has_access**: At reservation time, the booking user no longer had access to any held EVSE. Inaccessible candidates are skipped; if none remain accessible, the accepted booking fails immediately. Revocation does not cancel an already reserved booking.\n\nIntegrations must tolerate future unknown values as new failure reasons may be added.\n",
                   "type": "string",
                   "enum": [
                     "request_not_processed",
                     "booking_holds_no_evse",
                     "evse_occupied_or_reserved",
                     "charge_point_rejected_or_unresponsive",
-                    "could_not_be_reserved"
+                    "could_not_be_reserved",
+                    "user_no_longer_has_access"
                   ],
                   "example": "evse_occupied_or_reserved"
                 },
@@ -30932,14 +30937,15 @@
               },
               "failureReason": {
                 "readOnly": true,
-                "description": "Recorded cause of a failed booking:\n- **request_not_processed**: The booking request could not be processed.\n- **booking_holds_no_evse**: The booking had no EVSE candidates to reserve.\n- **evse_occupied_or_reserved**: The EVSE was occupied or already reserved.\n- **charge_point_rejected_or_unresponsive**: The charge point rejected the reservation or was unresponsive.\n- **could_not_be_reserved**: The booking could not be reserved without an established more specific cause, including overdue recovery.\n\nIntegrations must tolerate future unknown values as new failure reasons may be added.\n",
+                "description": "Recorded cause of a failed booking:\n- **request_not_processed**: The booking request could not be processed.\n- **booking_holds_no_evse**: The booking had no EVSE candidates to reserve.\n- **evse_occupied_or_reserved**: The EVSE was occupied or already reserved.\n- **charge_point_rejected_or_unresponsive**: The charge point rejected the reservation or was unresponsive.\n- **could_not_be_reserved**: The booking could not be reserved without an established more specific cause, including overdue recovery.\n- **user_no_longer_has_access**: At reservation time, the booking user no longer had access to any held EVSE. Inaccessible candidates are skipped; if none remain accessible, the accepted booking fails immediately. Revocation does not cancel an already reserved booking.\n\nIntegrations must tolerate future unknown values as new failure reasons may be added.\n",
                 "type": "string",
                 "enum": [
                   "request_not_processed",
                   "booking_holds_no_evse",
                   "evse_occupied_or_reserved",
                   "charge_point_rejected_or_unresponsive",
-                  "could_not_be_reserved"
+                  "could_not_be_reserved",
+                  "user_no_longer_has_access"
                 ],
                 "example": "evse_occupied_or_reserved"
               },
@@ -82368,6 +82374,10 @@
               ],
               "type": "object",
               "properties": {
+                "averagePrice": {
+                  "type": "number",
+                  "description": "Stored average charging price in the location operator's currency. Stored prices are returned unchanged, including historical values beyond the currency's current unit-price precision. Reads do not apply write validation. Zero indicates free charging. Omitted when no average price is set."
+                },
                 "id": {
                   "type": "integer",
                   "readOnly": true
@@ -83695,6 +83705,10 @@
             ],
             "type": "object",
             "properties": {
+              "averagePrice": {
+                "type": "number",
+                "description": "Stored average charging price in the location operator's currency. Stored prices are returned unchanged, including historical values beyond the currency's current unit-price precision. Reads do not apply write validation. Zero indicates free charging. Omitted when no average price is set."
+              },
               "id": {
                 "type": "integer",
                 "readOnly": true
@@ -84995,6 +85009,10 @@
             ],
             "type": "object",
             "properties": {
+              "averagePrice": {
+                "type": "number",
+                "description": "Stored average charging price in the location operator's currency. Stored prices are returned unchanged, including historical values beyond the currency's current unit-price precision. Reads do not apply write validation. Zero indicates free charging. Omitted when no average price is set."
+              },
               "id": {
                 "type": "integer",
                 "readOnly": true
@@ -86338,6 +86356,10 @@
             ],
             "type": "object",
             "properties": {
+              "averagePrice": {
+                "type": "number",
+                "description": "Stored average charging price in the location operator's currency. Stored prices are returned unchanged, including historical values beyond the currency's current unit-price precision. Reads do not apply write validation. Zero indicates free charging. Omitted when no average price is set."
+              },
               "id": {
                 "type": "integer",
                 "readOnly": true
@@ -88819,7 +88841,7 @@
                   ]
                 },
                 "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",
+                  "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_disabled**: Corporate billing is switched off for the partner or the driver's accepted invite\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**: Legacy corporate-account refusal value retained for historical records; newly detected disabled billing uses corporate_billing_disabled\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",
@@ -88833,6 +88855,7 @@
                     "previous_session_not_paid",
                     "unpaid_subscription_fees",
                     "payment_method_required",
+                    "corporate_billing_disabled",
                     "corporate_billing_policy_inactive",
                     "corporate_billing_limit_exceeded",
                     "corporate_account_limit_reached",
@@ -89067,7 +89090,7 @@
                 ]
               },
               "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",
+                "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_disabled**: Corporate billing is switched off for the partner or the driver's accepted invite\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**: Legacy corporate-account refusal value retained for historical records; newly detected disabled billing uses corporate_billing_disabled\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",
@@ -89081,6 +89104,7 @@
                   "previous_session_not_paid",
                   "unpaid_subscription_fees",
                   "payment_method_required",
+                  "corporate_billing_disabled",
                   "corporate_billing_policy_inactive",
                   "corporate_billing_limit_exceeded",
                   "corporate_account_limit_reached",
@@ -93087,6 +93111,13 @@
                 "revenueSharing": {
                   "type": "object",
                   "properties": {
+                    "partnerSharePercentagePrivateEvseAccessFees": {
+                      "type": "number",
+                      "format": "float",
+                      "minimum": 0,
+                      "maximum": 100,
+                      "description": "The partner's share of the revenue from private EVSE access fees from other partners given access to this partner's commercial private charge points. Omit the property to leave the share unconfigured."
+                    },
                     "partnerSharePercentageAcEvse": {
                       "type": "number",
                       "format": "float",
@@ -93150,6 +93181,12 @@
                 "monthlyPlatformFees": {
                   "type": "object",
                   "properties": {
+                    "perPrivateEvseOfOtherPartners": {
+                      "type": "number",
+                      "format": "float",
+                      "minimum": 0,
+                      "description": "Fee per EVSE, without tax, of commercial private charge points of other partners to which this partner is given access. Omit the property to leave the fee unconfigured."
+                    },
                     "perChargePoint": {
                       "type": "number",
                       "format": "float",
@@ -93520,6 +93557,13 @@
               "revenueSharing": {
                 "type": "object",
                 "properties": {
+                  "partnerSharePercentagePrivateEvseAccessFees": {
+                    "type": "number",
+                    "format": "float",
+                    "minimum": 0,
+                    "maximum": 100,
+                    "description": "The partner's share of the revenue from private EVSE access fees from other partners given access to this partner's commercial private charge points. Omit the property to leave the share unconfigured."
+                  },
                   "partnerSharePercentageAcEvse": {
                     "type": "number",
                     "format": "float",
@@ -93583,6 +93627,12 @@
               "monthlyPlatformFees": {
                 "type": "object",
                 "properties": {
+                  "perPrivateEvseOfOtherPartners": {
+                    "type": "number",
+                    "format": "float",
+                    "minimum": 0,
+                    "description": "Fee per EVSE, without tax, of commercial private charge points of other partners to which this partner is given access. Omit the property to leave the fee unconfigured."
+                  },
                   "perChargePoint": {
                     "type": "number",
                     "format": "float",
@@ -93860,334 +93910,13 @@
               "revenueSharing": {
                 "type": "object",
                 "properties": {
-                  "partnerSharePercentageAcEvse": {
-                    "type": "number",
-                    "format": "float",
-                    "minimum": 0,
-                    "maximum": 100,
-                    "description": "Applied to the session amount without tax, after any session fees and electricity cost are deducted."
-                  },
-                  "partnerSharePercentageDcEvse": {
+                  "partnerSharePercentagePrivateEvseAccessFees": {
                     "type": "number",
                     "format": "float",
                     "minimum": 0,
                     "maximum": 100,
-                    "description": "Applied to the session amount without tax, after any session fees and electricity cost are deducted."
-                  },
-                  "excludeConnectionFee": {
-                    "type": "boolean",
-                    "description": "If true and the tariff has a connection fee, the partner receives no share of it and the operator keeps it in full. The connection fee excluded is the amount without tax."
-                  },
-                  "deductElectricityCost": {
-                    "type": "boolean",
-                    "description": "The electricity cost without tax is deducted from the session amount, together with the session fees, before the partner's share is calculated."
-                  },
-                  "reimburseForElectricityCost": {
-                    "type": "boolean",
-                    "description": "If true, the partner also receives the electricity cost. The partner receives (Revenue − Deducted fees − Electricity cost) × Partner percentage + Electricity cost, where revenue and electricity cost are the amounts without tax and deducted fees are the fixed fee per session, the fee per kWh and the handling fee. It can be supplied only if `deductElectricityCost` is true."
-                  },
-                  "fixedFeePerSessionAc": {
-                    "type": "number",
-                    "format": "float",
-                    "nullable": true,
-                    "description": "Flat fee without tax for every billed session on an AC charge point. It is taken off the session amount before the partner's share is calculated, and the operator keeps it in full."
-                  },
-                  "fixedFeePerSessionDc": {
-                    "type": "number",
-                    "format": "float",
-                    "nullable": true,
-                    "description": "Flat fee without tax for every billed session on a DC charge point. It is taken off the session amount before the partner's share is calculated, and the operator keeps it in full."
-                  },
-                  "feePerKwhAc": {
-                    "type": "number",
-                    "format": "float",
-                    "nullable": true,
-                    "description": "Flat fee without tax for every billed kWh on an AC charge point. It is taken off the session amount before the partner's share is calculated, and the operator keeps it in full."
-                  },
-                  "feePerKwhDc": {
-                    "type": "number",
-                    "format": "float",
-                    "nullable": true,
-                    "description": "Flat fee without tax for every billed kWh on a DC charge point. It is taken off the session amount before the partner's share is calculated, and the operator keeps it in full."
+                    "description": "The partner's share of the revenue from private EVSE access fees from other partners given access to this partner's commercial private charge points. Omit the property to leave the share unconfigured."
                   },
-                  "handlingFee": {
-                    "type": "number",
-                    "format": "float",
-                    "minimum": 0,
-                    "maximum": 100,
-                    "nullable": true,
-                    "description": "A percentage of the total amount the user paid for the session, including tax. It is taken off the session amount before the partner's share is calculated."
-                  }
-                }
-              },
-              "monthlyPlatformFees": {
-                "type": "object",
-                "properties": {
-                  "perChargePoint": {
-                    "type": "number",
-                    "format": "float",
-                    "description": "The amount without tax."
-                  },
-                  "perAcEvse": {
-                    "type": "number",
-                    "format": "float",
-                    "description": "The amount without tax."
-                  },
-                  "perDcEvse": {
-                    "type": "number",
-                    "format": "float",
-                    "description": "The amount without tax."
-                  }
-                }
-              },
-              "reimbursementFees": {
-                "type": "object",
-                "description": "Home-charging reimbursement fees configured on the contract itself and charged to the partner for reimbursed charging sessions and reimbursement periods. Only available when the home-charging reimbursement feature is enabled for the operator. All other home-charging reimbursement settings are managed on the partner resource.\n",
-                "properties": {
-                  "perSession": {
-                    "type": "number",
-                    "format": "float",
-                    "minimum": 0,
-                    "description": "Flat fee charged for every reimbursed charging session, in the contract's currency."
-                  },
-                  "perPeriod": {
-                    "type": "number",
-                    "format": "float",
-                    "minimum": 0,
-                    "description": "Flat fee charged for every reimbursement period, in the contract's currency."
-                  }
-                }
-              },
-              "lastUpdatedAt": {
-                "type": "string",
-                "format": "date-time",
-                "description": "ISO 8601 formatted date",
-                "readOnly": true
-              },
-              "settlementOverrides": {
-                "type": "array",
-                "description": "⚠️ Experimental — not yet a stable contract. The embedded settlement override objects may change without a version bump, including breaking changes within `v1.0` itself. Consume them for evaluation only, or coordinate adoption with your account manager so changes can be sequenced with you.\n\nActive settlement overrides of the contract, newest first. Returned only by `GET /public-api/resources/partner-contracts/v1.0/{partnerContract}` and only when requested through `include[]=settlementOverrides`. The listing, create and update responses never carry this property, because they do not accept the `include` parameter — read the overrides of a contract through `GET /public-api/resources/partner-contracts/v1.0/{partnerContract}/settlement-overrides` instead.\n",
-                "items": {
-                  "description": "⚠️ Experimental endpoint — not yet a stable contract. This resource ships as experimental / beta. While experimental, its schema and behaviour may change without a version bump — including breaking changes within v1.0 itself. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed.\n\nSettlement override read schema. Each record scopes an AC / DC partner share percentage to one driver population on the partner contract; the contract's own settlement fields remain the default rule.\n",
-                  "type": "object",
-                  "required": [
-                    "id",
-                    "name",
-                    "priority",
-                    "restriction",
-                    "acPercent",
-                    "dcPercent"
-                  ],
-                  "properties": {
-                    "name": {
-                      "type": "string",
-                      "maxLength": 255,
-                      "description": "Name of the settlement override, unique among the active overrides of the partner contract.",
-                      "example": "Fleet drivers"
-                    },
-                    "priority": {
-                      "type": "integer",
-                      "minimum": 1,
-                      "maximum": 4294967295,
-                      "description": "Evaluation priority of the override, unique among the active overrides of the partner contract.\nThe lowest value that matches a session wins.\n",
-                      "example": 1
-                    },
-                    "id": {
-                      "type": "integer",
-                      "description": "Unique identifier for the settlement override",
-                      "example": 123
-                    },
-                    "restriction": {
-                      "type": "object",
-                      "description": "Which users of the partner contract the override applies to. `type` is the discriminator and\ndetermines what `targetIds` references.\n",
-                      "required": [
-                        "type"
-                      ],
-                      "properties": {
-                        "type": {
-                          "type": "string",
-                          "description": "Which users of the partner contract the settlement override applies to.\n\nAllowed values:\n- `users_of_the_partner` - Applies to sessions of users belonging to the contract's partner.\n- `user_groups` - Applies to sessions of users in the listed user groups. Requires `userGroupIds`.\n- `ad_hoc_users` - Applies to sessions of ad hoc (unregistered) users.\n- `users_of_specific_partners` - Applies to sessions of users belonging to the listed partners. Requires `partnerIds`.\n",
-                          "enum": [
-                            "users_of_the_partner",
-                            "user_groups",
-                            "ad_hoc_users",
-                            "users_of_specific_partners"
-                          ]
-                        },
-                        "targetIds": {
-                          "type": "array",
-                          "description": "Identifiers of the records the override applies to, as determined by `type`: user group IDs\nfor `user_groups` and partner IDs for `users_of_specific_partners`. Required for those two\ntypes and omitted for every other type.\n",
-                          "items": {
-                            "type": "integer"
-                          },
-                          "example": [
-                            12,
-                            34
-                          ]
-                        }
-                      }
-                    },
-                    "acPercent": {
-                      "type": "number",
-                      "format": "float",
-                      "nullable": true,
-                      "minimum": 0,
-                      "maximum": 100,
-                      "description": "Partner share percentage applied to AC sessions matched by this override.\nApplied to the session amount without tax, after any session fees and electricity\ncost are deducted.\n`null` means the value is inherited from the partner contract.\n",
-                      "example": 70.5
-                    },
-                    "dcPercent": {
-                      "type": "number",
-                      "format": "float",
-                      "nullable": true,
-                      "minimum": 0,
-                      "maximum": 100,
-                      "description": "Partner share percentage applied to DC sessions matched by this override.\nApplied to the session amount without tax, after any session fees and electricity\ncost are deducted.\n`null` means the value is inherited from the partner contract.\n",
-                      "example": 60
-                    }
-                  }
-                }
-              }
-            },
-            "required": [
-              "id",
-              "operatorId",
-              "title",
-              "partnerId",
-              "startDate"
-            ]
-          }
-        }
-      }
-    },
-    "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",
-        "properties": {
-          "message": {
-            "type": "string"
-          }
-        }
-      }
-    }
-  },
-  "partnerContractUpdate": {
-    "200": {
-      "schema": {
-        "type": "object",
-        "properties": {
-          "data": {
-            "type": "object",
-            "properties": {
-              "id": {
-                "type": "integer",
-                "readOnly": true
-              },
-              "operatorId": {
-                "type": "integer",
-                "description": "The ID of the operator this resource belongs to",
-                "example": 1
-              },
-              "title": {
-                "type": "string"
-              },
-              "partnerId": {
-                "type": "integer"
-              },
-              "contractType": {
-                "type": "string",
-                "enum": [
-                  "revenueSharing",
-                  "paymentFacilitation"
-                ],
-                "description": "Indicates the business relationship model for the contract. `revenueSharing` means the operator is the supplier and remits a share to the partner. `paymentFacilitation` means the partner is the supplier and the operator acts as payment facilitator."
-              },
-              "startDate": {
-                "type": "string",
-                "format": "date-time",
-                "description": "The contract is effective from the first of the selected month."
-              },
-              "endDate": {
-                "type": "string",
-                "format": "date-time",
-                "nullable": true,
-                "description": "The contract expires at the last day of the selected month. If nothing is selected, there is no expiration date."
-              },
-              "autoRenewal": {
-                "type": "boolean"
-              },
-              "externalId": {
-                "type": "string",
-                "description": "Used to store custom information, usually used for external references or metadata to the resource.",
-                "maxLength": 255
-              },
-              "accessAndPermissions": {
-                "type": "object",
-                "properties": {
-                  "sessionsRemoteControl": {
-                    "type": "boolean",
-                    "description": "Allows the partner to start/stop session, unlock connector, trigger message, set a charging profile and get the composite schedule."
-                  },
-                  "startReservation": {
-                    "type": "boolean",
-                    "description": "Allows the partner to make reservations."
-                  },
-                  "stopReservation": {
-                    "type": "boolean",
-                    "description": "Allows the partner to cancel reservations."
-                  },
-                  "resetChargePoint": {
-                    "type": "boolean",
-                    "description": "Allows the partner to reset charge points."
-                  },
-                  "firmwareUpdate": {
-                    "type": "boolean",
-                    "description": "Allows the partner to make firmware updates to the charge points."
-                  },
-                  "createFromTemplate": {
-                    "type": "boolean",
-                    "description": "Allows the partner to create charge points from templates."
-                  },
-                  "changeSystemStatus": {
-                    "type": "boolean",
-                    "description": "Allows the partner to change the system status of charge points."
-                  }
-                }
-              },
-              "revenueSharing": {
-                "type": "object",
-                "properties": {
                   "partnerSharePercentageAcEvse": {
                     "type": "number",
                     "format": "float",
@@ -94251,6 +93980,353 @@
               "monthlyPlatformFees": {
                 "type": "object",
                 "properties": {
+                  "perPrivateEvseOfOtherPartners": {
+                    "type": "number",
+                    "format": "float",
+                    "minimum": 0,
+                    "description": "Fee per EVSE, without tax, of commercial private charge points of other partners to which this partner is given access. Omit the property to leave the fee unconfigured."
+                  },
+                  "perChargePoint": {
+                    "type": "number",
+                    "format": "float",
+                    "description": "The amount without tax."
+                  },
+                  "perAcEvse": {
+                    "type": "number",
+                    "format": "float",
+                    "description": "The amount without tax."
+                  },
+                  "perDcEvse": {
+                    "type": "number",
+                    "format": "float",
+                    "description": "The amount without tax."
+                  }
+                }
+              },
+              "reimbursementFees": {
+                "type": "object",
+                "description": "Home-charging reimbursement fees configured on the contract itself and charged to the partner for reimbursed charging sessions and reimbursement periods. Only available when the home-charging reimbursement feature is enabled for the operator. All other home-charging reimbursement settings are managed on the partner resource.\n",
+                "properties": {
+                  "perSession": {
+                    "type": "number",
+                    "format": "float",
+                    "minimum": 0,
+                    "description": "Flat fee charged for every reimbursed charging session, in the contract's currency."
+                  },
+                  "perPeriod": {
+                    "type": "number",
+                    "format": "float",
+                    "minimum": 0,
+                    "description": "Flat fee charged for every reimbursement period, in the contract's currency."
+                  }
+                }
+              },
+              "lastUpdatedAt": {
+                "type": "string",
+                "format": "date-time",
+                "description": "ISO 8601 formatted date",
+                "readOnly": true
+              },
+              "settlementOverrides": {
+                "type": "array",
+                "description": "⚠️ Experimental — not yet a stable contract. The embedded settlement override objects may change without a version bump, including breaking changes within `v1.0` itself. Consume them for evaluation only, or coordinate adoption with your account manager so changes can be sequenced with you.\n\nActive settlement overrides of the contract, newest first. Returned only by `GET /public-api/resources/partner-contracts/v1.0/{partnerContract}` and only when requested through `include[]=settlementOverrides`. The listing, create and update responses never carry this property, because they do not accept the `include` parameter — read the overrides of a contract through `GET /public-api/resources/partner-contracts/v1.0/{partnerContract}/settlement-overrides` instead.\n",
+                "items": {
+                  "description": "⚠️ Experimental endpoint — not yet a stable contract. This resource ships as experimental / beta. While experimental, its schema and behaviour may change without a version bump — including breaking changes within v1.0 itself. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed.\n\nSettlement override read schema. Each record scopes an AC / DC partner share percentage to one driver population on the partner contract; the contract's own settlement fields remain the default rule.\n",
+                  "type": "object",
+                  "required": [
+                    "id",
+                    "name",
+                    "priority",
+                    "restriction",
+                    "acPercent",
+                    "dcPercent"
+                  ],
+                  "properties": {
+                    "name": {
+                      "type": "string",
+                      "maxLength": 255,
+                      "description": "Name of the settlement override, unique among the active overrides of the partner contract.",
+                      "example": "Fleet drivers"
+                    },
+                    "priority": {
+                      "type": "integer",
+                      "minimum": 1,
+                      "maximum": 4294967295,
+                      "description": "Evaluation priority of the override, unique among the active overrides of the partner contract.\nThe lowest value that matches a session wins.\n",
+                      "example": 1
+                    },
+                    "id": {
+                      "type": "integer",
+                      "description": "Unique identifier for the settlement override",
+                      "example": 123
+                    },
+                    "restriction": {
+                      "type": "object",
+                      "description": "Which users of the partner contract the override applies to. `type` is the discriminator and\ndetermines what `targetIds` references.\n",
+                      "required": [
+                        "type"
+                      ],
+                      "properties": {
+                        "type": {
+                          "type": "string",
+                          "description": "Which users of the partner contract the settlement override applies to.\n\nAllowed values:\n- `users_of_the_partner` - Applies to sessions of users belonging to the contract's partner.\n- `user_groups` - Applies to sessions of users in the listed user groups. Requires `userGroupIds`.\n- `ad_hoc_users` - Applies to sessions of ad hoc (unregistered) users.\n- `users_of_specific_partners` - Applies to sessions of users belonging to the listed partners. Requires `partnerIds`.\n",
+                          "enum": [
+                            "users_of_the_partner",
+                            "user_groups",
+                            "ad_hoc_users",
+                            "users_of_specific_partners"
+                          ]
+                        },
+                        "targetIds": {
+                          "type": "array",
+                          "description": "Identifiers of the records the override applies to, as determined by `type`: user group IDs\nfor `user_groups` and partner IDs for `users_of_specific_partners`. Required for those two\ntypes and omitted for every other type.\n",
+                          "items": {
+                            "type": "integer"
+                          },
+                          "example": [
+                            12,
+                            34
+                          ]
+                        }
+                      }
+                    },
+                    "acPercent": {
+                      "type": "number",
+                      "format": "float",
+                      "nullable": true,
+                      "minimum": 0,
+                      "maximum": 100,
+                      "description": "Partner share percentage applied to AC sessions matched by this override.\nApplied to the session amount without tax, after any session fees and electricity\ncost are deducted.\n`null` means the value is inherited from the partner contract.\n",
+                      "example": 70.5
+                    },
+                    "dcPercent": {
+                      "type": "number",
+                      "format": "float",
+                      "nullable": true,
+                      "minimum": 0,
+                      "maximum": 100,
+                      "description": "Partner share percentage applied to DC sessions matched by this override.\nApplied to the session amount without tax, after any session fees and electricity\ncost are deducted.\n`null` means the value is inherited from the partner contract.\n",
+                      "example": 60
+                    }
+                  }
+                }
+              }
+            },
+            "required": [
+              "id",
+              "operatorId",
+              "title",
+              "partnerId",
+              "startDate"
+            ]
+          }
+        }
+      }
+    },
+    "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",
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  },
+  "partnerContractUpdate": {
+    "200": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "integer",
+                "readOnly": true
+              },
+              "operatorId": {
+                "type": "integer",
+                "description": "The ID of the operator this resource belongs to",
+                "example": 1
+              },
+              "title": {
+                "type": "string"
+              },
+              "partnerId": {
+                "type": "integer"
+              },
+              "contractType": {
+                "type": "string",
+                "enum": [
+                  "revenueSharing",
+                  "paymentFacilitation"
+                ],
+                "description": "Indicates the business relationship model for the contract. `revenueSharing` means the operator is the supplier and remits a share to the partner. `paymentFacilitation` means the partner is the supplier and the operator acts as payment facilitator."
+              },
+              "startDate": {
+                "type": "string",
+                "format": "date-time",
+                "description": "The contract is effective from the first of the selected month."
+              },
+              "endDate": {
+                "type": "string",
+                "format": "date-time",
+                "nullable": true,
+                "description": "The contract expires at the last day of the selected month. If nothing is selected, there is no expiration date."
+              },
+              "autoRenewal": {
+                "type": "boolean"
+              },
+              "externalId": {
+                "type": "string",
+                "description": "Used to store custom information, usually used for external references or metadata to the resource.",
+                "maxLength": 255
+              },
+              "accessAndPermissions": {
+                "type": "object",
+                "properties": {
+                  "sessionsRemoteControl": {
+                    "type": "boolean",
+                    "description": "Allows the partner to start/stop session, unlock connector, trigger message, set a charging profile and get the composite schedule."
+                  },
+                  "startReservation": {
+                    "type": "boolean",
+                    "description": "Allows the partner to make reservations."
+                  },
+                  "stopReservation": {
+                    "type": "boolean",
+                    "description": "Allows the partner to cancel reservations."
+                  },
+                  "resetChargePoint": {
+                    "type": "boolean",
+                    "description": "Allows the partner to reset charge points."
+                  },
+                  "firmwareUpdate": {
+                    "type": "boolean",
+                    "description": "Allows the partner to make firmware updates to the charge points."
+                  },
+                  "createFromTemplate": {
+                    "type": "boolean",
+                    "description": "Allows the partner to create charge points from templates."
+                  },
+                  "changeSystemStatus": {
+                    "type": "boolean",
+                    "description": "Allows the partner to change the system status of charge points."
+                  }
+                }
+              },
+              "revenueSharing": {
+                "type": "object",
+                "properties": {
+                  "partnerSharePercentagePrivateEvseAccessFees": {
+                    "type": "number",
+                    "format": "float",
+                    "minimum": 0,
+                    "maximum": 100,
+                    "description": "The partner's share of the revenue from private EVSE access fees from other partners given access to this partner's commercial private charge points. Omit the property to leave the share unconfigured."
+                  },
+                  "partnerSharePercentageAcEvse": {
+                    "type": "number",
+                    "format": "float",
+                    "minimum": 0,
+                    "maximum": 100,
+                    "description": "Applied to the session amount without tax, after any session fees and electricity cost are deducted."
+                  },
+                  "partnerSharePercentageDcEvse": {
+                    "type": "number",
+                    "format": "float",
+                    "minimum": 0,
+                    "maximum": 100,
+                    "description": "Applied to the session amount without tax, after any session fees and electricity cost are deducted."
+                  },
+                  "excludeConnectionFee": {
+                    "type": "boolean",
+                    "description": "If true and the tariff has a connection fee, the partner receives no share of it and the operator keeps it in full. The connection fee excluded is the amount without tax."
+                  },
+                  "deductElectricityCost": {
+                    "type": "boolean",
+                    "description": "The electricity cost without tax is deducted from the session amount, together with the session fees, before the partner's share is calculated."
+                  },
+                  "reimburseForElectricityCost": {
+                    "type": "boolean",
+                    "description": "If true, the partner also receives the electricity cost. The partner receives (Revenue − Deducted fees − Electricity cost) × Partner percentage + Electricity cost, where revenue and electricity cost are the amounts without tax and deducted fees are the fixed fee per session, the fee per kWh and the handling fee. It can be supplied only if `deductElectricityCost` is true."
+                  },
+                  "fixedFeePerSessionAc": {
+                    "type": "number",
+                    "format": "float",
+                    "nullable": true,
+                    "description": "Flat fee without tax for every billed session on an AC charge point. It is taken off the session amount before the partner's share is calculated, and the operator keeps it in full."
+                  },
+                  "fixedFeePerSessionDc": {
+                    "type": "number",
+                    "format": "float",
+                    "nullable": true,
+                    "description": "Flat fee without tax for every billed session on a DC charge point. It is taken off the session amount before the partner's share is calculated, and the operator keeps it in full."
+                  },
+                  "feePerKwhAc": {
+                    "type": "number",
+                    "format": "float",
+                    "nullable": true,
+                    "description": "Flat fee without tax for every billed kWh on an AC charge point. It is taken off the session amount before the partner's share is calculated, and the operator keeps it in full."
+                  },
+                  "feePerKwhDc": {
+                    "type": "number",
+                    "format": "float",
+                    "nullable": true,
+                    "description": "Flat fee without tax for every billed kWh on a DC charge point. It is taken off the session amount before the partner's share is calculated, and the operator keeps it in full."
+                  },
+                  "handlingFee": {
+                    "type": "number",
+                    "format": "float",
+                    "minimum": 0,
+                    "maximum": 100,
+                    "nullable": true,
+                    "description": "A percentage of the total amount the user paid for the session, including tax. It is taken off the session amount before the partner's share is calculated."
+                  }
+                }
+              },
+              "monthlyPlatformFees": {
+                "type": "object",
+                "properties": {
+                  "perPrivateEvseOfOtherPartners": {
+                    "type": "number",
+                    "format": "float",
+                    "minimum": 0,
+                    "description": "Fee per EVSE, without tax, of commercial private charge points of other partners to which this partner is given access. Omit the property to leave the fee unconfigured."
+                  },
                   "perChargePoint": {
                     "type": "number",
                     "format": "float",
@@ -94561,6 +94637,13 @@
               "revenueSharing": {
                 "type": "object",
                 "properties": {
+                  "partnerSharePercentagePrivateEvseAccessFees": {
+                    "type": "number",
+                    "format": "float",
+                    "minimum": 0,
+                    "maximum": 100,
+                    "description": "The partner's share of the revenue from private EVSE access fees from other partners given access to this partner's commercial private charge points. Omit the property to leave the share unconfigured."
+                  },
                   "partnerSharePercentageAcEvse": {
                     "type": "number",
                     "format": "float",
@@ -94624,6 +94707,12 @@
               "monthlyPlatformFees": {
                 "type": "object",
                 "properties": {
+                  "perPrivateEvseOfOtherPartners": {
+                    "type": "number",
+                    "format": "float",
+                    "minimum": 0,
+                    "description": "Fee per EVSE, without tax, of commercial private charge points of other partners to which this partner is given access. Omit the property to leave the fee unconfigured."
+                  },
                   "perChargePoint": {
                     "type": "number",
                     "format": "float",
@@ -108889,6 +108978,2879 @@
       }
     }
   },
+  "partnerSettlementReportsListingV1_1": {
+    "200": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "integer",
+                  "description": "Unique settlement report identifier."
+                },
+                "partnerId": {
+                  "type": "integer",
+                  "description": "Unique identifier of the partner involved in the settlement."
+                },
+                "number": {
+                  "type": "string",
+                  "description": "Settlement report reference number."
+                },
+                "date": {
+                  "type": "string",
+                  "format": "date",
+                  "description": "Date the settlement report was generated."
+                },
+                "periodStart": {
+                  "type": "string",
+                  "format": "date",
+                  "description": "Start date of the period covered by the report."
+                },
+                "periodEnd": {
+                  "type": "string",
+                  "format": "date",
+                  "description": "End date of the period covered by the report."
+                },
+                "currencyCode": {
+                  "description": "Currency used in the settlement (e.g., USD, EUR).",
+                  "type": "string",
+                  "enum": [
+                    "AED",
+                    "AFN",
+                    "ALL",
+                    "AMD",
+                    "ANG",
+                    "AOA",
+                    "ARS",
+                    "AUD",
+                    "AWG",
+                    "AZN",
+                    "BAM",
+                    "BBD",
+                    "BDT",
+                    "BGN",
+                    "BHD",
+                    "BIF",
+                    "BMD",
+                    "BND",
+                    "BOB",
+                    "BOV",
+                    "BRL",
+                    "BSD",
+                    "BTN",
+                    "BWP",
+                    "BYN",
+                    "BZD",
+                    "CAD",
+                    "CDF",
+                    "CHE",
+                    "CHF",
+                    "CHW",
+                    "CLF",
+                    "CLP",
+                    "CNY",
+                    "COP",
+                    "COU",
+                    "CRC",
+                    "CUC",
+                    "CUP",
+                    "CVE",
+                    "CZK",
+                    "DJF",
+                    "DKK",
+                    "DOP",
+                    "DZD",
+                    "EGP",
+                    "ERN",
+                    "ETB",
+                    "EUR",
+                    "FJD",
+                    "FKP",
+                    "GBP",
+                    "GEL",
+                    "GHS",
+                    "GIP",
+                    "GMD",
+                    "GNF",
+                    "GTQ",
+                    "GYD",
+                    "HKD",
+                    "HNL",
+                    "HRK",
+                    "HTG",
+                    "HUF",
+                    "IDR",
+                    "ILS",
+                    "INR",
+                    "IQD",
+                    "IRR",
+                    "ISK",
+                    "JMD",
+                    "JOD",
+                    "JPY",
+                    "KES",
+                    "KGS",
+                    "KHR",
+                    "KMF",
+                    "KPW",
+                    "KRW",
+                    "KWD",
+                    "KYD",
+                    "KZT",
+                    "LAK",
+                    "LBP",
+                    "LKR",
+                    "LRD",
+                    "LSL",
+                    "LYD",
+                    "MAD",
+                    "MDL",
+                    "MGA",
+                    "MKD",
+                    "MMK",
+                    "MNT",
+                    "MOP",
+                    "MRU",
+                    "MUR",
+                    "MVR",
+                    "MWK",
+                    "MXN",
+                    "MXV",
+                    "MYR",
+                    "MZN",
+                    "NAD",
+                    "NGN",
+                    "NIO",
+                    "NOK",
+                    "NPR",
+                    "NZD",
+                    "OMR",
+                    "PAB",
+                    "PEN",
+                    "PGK",
+                    "PHP",
+                    "PKR",
+                    "PLN",
+                    "PYG",
+                    "QAR",
+                    "RON",
+                    "RSD",
+                    "RUB",
+                    "RWF",
+                    "SAR",
+                    "SBD",
+                    "SCR",
+                    "SDG",
+                    "SEK",
+                    "SGD",
+                    "SHP",
+                    "SLL",
+                    "SOS",
+                    "SRD",
+                    "SSP",
+                    "STN",
+                    "SVC",
+                    "SYP",
+                    "SZL",
+                    "THB",
+                    "TJS",
+                    "TMT",
+                    "TND",
+                    "TOP",
+                    "TRY",
+                    "TTD",
+                    "TWD",
+                    "TZS",
+                    "UAH",
+                    "UGX",
+                    "USD",
+                    "USN",
+                    "UYI",
+                    "UYU",
+                    "UYW",
+                    "UZS",
+                    "VES",
+                    "VND",
+                    "VUV",
+                    "WST",
+                    "XAF",
+                    "XAG",
+                    "XAU",
+                    "XBA",
+                    "XBB",
+                    "XBC",
+                    "XBD",
+                    "XCD",
+                    "XDR",
+                    "XOF",
+                    "XPD",
+                    "XPF",
+                    "XPT",
+                    "XSU",
+                    "XTS",
+                    "XUA",
+                    "XXX",
+                    "YER",
+                    "ZAR",
+                    "ZMW",
+                    "ZWL"
+                  ]
+                },
+                "totals": {
+                  "description": "Settlement totals for the period, each with the tax-exclusive amount and, where stored, the tax-inclusive amount.\n\nA tax-inclusive amount, when present, is the stored total of the tax-inclusive amounts of the underlying records, substituting the tax-exclusive amount for any record that carries no tax-inclusive one.\n",
+                  "type": "object",
+                  "properties": {
+                    "amount": {
+                      "description": "Total settlement amount.",
+                      "type": "object",
+                      "properties": {
+                        "withoutTax": {
+                          "type": "number",
+                          "description": "The tax-exclusive amount."
+                        },
+                        "withTax": {
+                          "type": "number",
+                          "description": "The tax-inclusive amount. Omitted when no tax-inclusive value is stored for this amount."
+                        }
+                      },
+                      "required": [
+                        "withoutTax"
+                      ]
+                    },
+                    "expenses": {
+                      "description": "Total expenses incurred during the settlement period.",
+                      "$ref": "#/paths/~1public-api~1resources~1partner-settlement-reports~1v1.1~1%7BpartnerSettlementReport%7D/get/responses/200/content/application~1json/schema/properties/data"
+                    },
+                    "revenue": {
+                      "description": "Total revenue generated during the settlement period.",
+                      "$ref": "#/paths/~1public-api~1resources~1partner-settlement-reports~1v1.1~1%7BpartnerSettlementReport%7D/get/responses/200/content/application~1json/schema/properties/data"
+                    },
+                    "awaitedRevenue": {
+                      "description": "Revenue expected but not yet collected.",
+                      "$ref": "#/paths/~1public-api~1resources~1partner-settlement-reports~1v1.1~1%7BpartnerSettlementReport%7D/get/responses/200/content/application~1json/schema/properties/data"
+                    },
+                    "collectedRevenue": {
+                      "description": "Revenue collected during the settlement period.",
+                      "$ref": "#/paths/~1public-api~1resources~1partner-settlement-reports~1v1.1~1%7BpartnerSettlementReport%7D/get/responses/200/content/application~1json/schema/properties/data"
+                    },
+                    "collectedRevenueFromPreviousPeriod": {
+                      "description": "Revenue collected during this period, but related to a previous periods.",
+                      "$ref": "#/paths/~1public-api~1resources~1partner-settlement-reports~1v1.1~1%7BpartnerSettlementReport%7D/get/responses/200/content/application~1json/schema/properties/data"
+                    }
+                  },
+                  "required": [
+                    "amount",
+                    "expenses",
+                    "revenue",
+                    "awaitedRevenue",
+                    "collectedRevenue",
+                    "collectedRevenueFromPreviousPeriod"
+                  ]
+                },
+                "totalEnergyCpoWh": {
+                  "type": "number",
+                  "description": "Total amount of energy (in Wh) delivered by the Charge Point Operator."
+                },
+                "totalEnergyEmspWh": {
+                  "type": "number",
+                  "description": "Total amount of energy (in Wh) consumed by the EMSP."
+                },
+                "supplier": {
+                  "description": "Company details for the entity supplying the service - the CPO.",
+                  "type": "object",
+                  "properties": {
+                    "type": {
+                      "type": "string",
+                      "enum": [
+                        "individual",
+                        "company"
+                      ]
+                    },
+                    "name": {
+                      "type": "string"
+                    },
+                    "contactPerson": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "country": {
+                      "type": "string",
+                      "nullable": true,
+                      "enum": [
+                        "AF",
+                        "AX",
+                        "AL",
+                        "DZ",
+                        "AS",
+                        "AD",
+                        "AO",
+                        "AI",
+                        "AQ",
+                        "AG",
+                        "AR",
+                        "AM",
+                        "AW",
+                        "AU",
+                        "AT",
+                        "AZ",
+                        "BS",
+                        "BH",
+                        "BD",
+                        "BB",
+                        "BY",
+                        "BE",
+                        "BZ",
+                        "BJ",
+                        "BM",
+                        "BT",
+                        "BO",
+                        "BQ",
+                        "BA",
+                        "BW",
+                        "BV",
+                        "BR",
+                        "IO",
+                        "BN",
+                        "BG",
+                        "BF",
+                        "BI",
+                        "KH",
+                        "CM",
+                        "CA",
+                        "CV",
+                        "KY",
+                        "CF",
+                        "TD",
+                        "CL",
+                        "CN",
+                        "CX",
+                        "CC",
+                        "CO",
+                        "KM",
+                        "CG",
+                        "CD",
+                        "CK",
+                        "CR",
+                        "CI",
+                        "HR",
+                        "CU",
+                        "CW",
+                        "CY",
+                        "CZ",
+                        "DK",
+                        "DJ",
+                        "DM",
+                        "DO",
+                        "EC",
+                        "EG",
+                        "SV",
+                        "GQ",
+                        "ER",
+                        "EE",
+                        "ET",
+                        "FK",
+                        "FO",
+                        "FJ",
+                        "FI",
+                        "FR",
+                        "GF",
+                        "PF",
+                        "TF",
+                        "GA",
+                        "GM",
+                        "GE",
+                        "DE",
+                        "GH",
+                        "GI",
+                        "GR",
+                        "GL",
+                        "GD",
+                        "GP",
+                        "GU",
+                        "GT",
+                        "GG",
+                        "GN",
+                        "GW",
+                        "GY",
+                        "HT",
+                        "HM",
+                        "VA",
+                        "HN",
+                        "HK",
+                        "HU",
+                        "IS",
+                        "IN",
+                        "ID",
+                        "IR",
+                        "IQ",
+                        "IE",
+                        "IM",
+                        "IL",
+                        "IT",
+                        "JM",
+                        "JP",
+                        "JE",
+                        "JO",
+                        "KZ",
+                        "KE",
+                        "KI",
+                        "KP",
+                        "KR",
+                        "XK",
+                        "KW",
+                        "KG",
+                        "LA",
+                        "LV",
+                        "LB",
+                        "LS",
+                        "LR",
+                        "LY",
+                        "LI",
+                        "LT",
+                        "LU",
+                        "MO",
+                        "MK",
+                        "MG",
+                        "MW",
+                        "MY",
+                        "MV",
+                        "ML",
+                        "MT",
+                        "MH",
+                        "MQ",
+                        "MR",
+                        "MU",
+                        "YT",
+                        "MX",
+                        "FM",
+                        "MD",
+                        "MC",
+                        "MN",
+                        "ME",
+                        "MS",
+                        "MA",
+                        "MZ",
+                        "MM",
+                        "NA",
+                        "NR",
+                        "NP",
+                        "NL",
+                        "NC",
+                        "NZ",
+                        "NI",
+                        "NE",
+                        "NG",
+                        "NU",
+                        "NF",
+                        "MP",
+                        "NO",
+                        "OM",
+                        "PK",
+                        "PW",
+                        "PS",
+                        "PA",
+                        "PG",
+                        "PY",
+                        "PE",
+                        "PH",
+                        "PN",
+                        "PL",
+                        "PT",
+                        "PR",
+                        "QA",
+                        "RE",
+                        "RO",
+                        "RU",
+                        "RW",
+                        "BL",
+                        "SH",
+                        "KN",
+                        "LC",
+                        "MF",
+                        "PM",
+                        "VC",
+                        "WS",
+                        "SM",
+                        "ST",
+                        "SA",
+                        "SN",
+                        "RS",
+                        "SC",
+                        "SL",
+                        "SG",
+                        "SX",
+                        "SK",
+                        "SI",
+                        "SB",
+                        "SO",
+                        "ZA",
+                        "GS",
+                        "SS",
+                        "ES",
+                        "LK",
+                        "SD",
+                        "SR",
+                        "SJ",
+                        "SZ",
+                        "SE",
+                        "CH",
+                        "SY",
+                        "TW",
+                        "TJ",
+                        "TZ",
+                        "TH",
+                        "TL",
+                        "TG",
+                        "TK",
+                        "TO",
+                        "TT",
+                        "TN",
+                        "TR",
+                        "TM",
+                        "TC",
+                        "TV",
+                        "UG",
+                        "UA",
+                        "AE",
+                        "GB",
+                        "US",
+                        "UM",
+                        "UY",
+                        "UZ",
+                        "VU",
+                        "VE",
+                        "VN",
+                        "VG",
+                        "VI",
+                        "WF",
+                        "EH",
+                        "YE",
+                        "ZM",
+                        "ZW"
+                      ]
+                    },
+                    "region": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "city": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "postCode": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "address": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "regNo": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "taxId": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "phone": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "email": {
+                      "type": "string",
+                      "nullable": true
+                    }
+                  },
+                  "required": [
+                    "type",
+                    "name",
+                    "contactPerson",
+                    "country",
+                    "region",
+                    "city",
+                    "postCode",
+                    "address",
+                    "regNo",
+                    "taxId",
+                    "phone",
+                    "email"
+                  ]
+                },
+                "customer": {
+                  "description": "Company details for the entity receiving the service - the Partner/EMSP.",
+                  "type": "object",
+                  "properties": {
+                    "type": {
+                      "type": "string",
+                      "enum": [
+                        "individual",
+                        "company"
+                      ]
+                    },
+                    "name": {
+                      "type": "string"
+                    },
+                    "contactPerson": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "country": {
+                      "type": "string",
+                      "nullable": true,
+                      "enum": [
+                        "AF",
+                        "AX",
+                        "AL",
+                        "DZ",
+                        "AS",
+                        "AD",
+                        "AO",
+                        "AI",
+                        "AQ",
+                        "AG",
+                        "AR",
+                        "AM",
+                        "AW",
+                        "AU",
+                        "AT",
+                        "AZ",
+                        "BS",
+                        "BH",
+                        "BD",
+                        "BB",
+                        "BY",
+                        "BE",
+                        "BZ",
+                        "BJ",
+                        "BM",
+                        "BT",
+                        "BO",
+                        "BQ",
+                        "BA",
+                        "BW",
+                        "BV",
+                        "BR",
+                        "IO",
+                        "BN",
+                        "BG",
+                        "BF",
+                        "BI",
+                        "KH",
+                        "CM",
+                        "CA",
+                        "CV",
+                        "KY",
+                        "CF",
+                        "TD",
+                        "CL",
+                        "CN",
+                        "CX",
+                        "CC",
+                        "CO",
+                        "KM",
+                        "CG",
+                        "CD",
+                        "CK",
+                        "CR",
+                        "CI",
+                        "HR",
+                        "CU",
+                        "CW",
+                        "CY",
+                        "CZ",
+                        "DK",
+                        "DJ",
+                        "DM",
+                        "DO",
+                        "EC",
+                        "EG",
+                        "SV",
+                        "GQ",
+                        "ER",
+                        "EE",
+                        "ET",
+                        "FK",
+                        "FO",
+                        "FJ",
+                        "FI",
+                        "FR",
+                        "GF",
+                        "PF",
+                        "TF",
+                        "GA",
+                        "GM",
+                        "GE",
+                        "DE",
+                        "GH",
+                        "GI",
+                        "GR",
+                        "GL",
+                        "GD",
+                        "GP",
+                        "GU",
+                        "GT",
+                        "GG",
+                        "GN",
+                        "GW",
+                        "GY",
+                        "HT",
+                        "HM",
+                        "VA",
+                        "HN",
+                        "HK",
+                        "HU",
+                        "IS",
+                        "IN",
+                        "ID",
+                        "IR",
+                        "IQ",
+                        "IE",
+                        "IM",
+                        "IL",
+                        "IT",
+                        "JM",
+                        "JP",
+                        "JE",
+                        "JO",
+                        "KZ",
+                        "KE",
+                        "KI",
+                        "KP",
+                        "KR",
+                        "XK",
+                        "KW",
+                        "KG",
+                        "LA",
+                        "LV",
+                        "LB",
+                        "LS",
+                        "LR",
+                        "LY",
+                        "LI",
+                        "LT",
+                        "LU",
+                        "MO",
+                        "MK",
+                        "MG",
+                        "MW",
+                        "MY",
+                        "MV",
+                        "ML",
+                        "MT",
+                        "MH",
+                        "MQ",
+                        "MR",
+                        "MU",
+                        "YT",
+                        "MX",
+                        "FM",
+                        "MD",
+                        "MC",
+                        "MN",
+                        "ME",
+                        "MS",
+                        "MA",
+                        "MZ",
+                        "MM",
+                        "NA",
+                        "NR",
+                        "NP",
+                        "NL",
+                        "NC",
+                        "NZ",
+                        "NI",
+                        "NE",
+                        "NG",
+                        "NU",
+                        "NF",
+                        "MP",
+                        "NO",
+                        "OM",
+                        "PK",
+                        "PW",
+                        "PS",
+                        "PA",
+                        "PG",
+                        "PY",
+                        "PE",
+                        "PH",
+                        "PN",
+                        "PL",
+                        "PT",
+                        "PR",
+                        "QA",
+                        "RE",
+                        "RO",
+                        "RU",
+                        "RW",
+                        "BL",
+                        "SH",
+                        "KN",
+                        "LC",
+                        "MF",
+                        "PM",
+                        "VC",
+                        "WS",
+                        "SM",
+                        "ST",
+                        "SA",
+                        "SN",
+                        "RS",
+                        "SC",
+                        "SL",
+                        "SG",
+                        "SX",
+                        "SK",
+                        "SI",
+                        "SB",
+                        "SO",
+                        "ZA",
+                        "GS",
+                        "SS",
+                        "ES",
+                        "LK",
+                        "SD",
+                        "SR",
+                        "SJ",
+                        "SZ",
+                        "SE",
+                        "CH",
+                        "SY",
+                        "TW",
+                        "TJ",
+                        "TZ",
+                        "TH",
+                        "TL",
+                        "TG",
+                        "TK",
+                        "TO",
+                        "TT",
+                        "TN",
+                        "TR",
+                        "TM",
+                        "TC",
+                        "TV",
+                        "UG",
+                        "UA",
+                        "AE",
+                        "GB",
+                        "US",
+                        "UM",
+                        "UY",
+                        "UZ",
+                        "VU",
+                        "VE",
+                        "VN",
+                        "VG",
+                        "VI",
+                        "WF",
+                        "EH",
+                        "YE",
+                        "ZM",
+                        "ZW"
+                      ]
+                    },
+                    "region": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "city": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "postCode": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "address": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "regNo": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "taxId": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "phone": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "email": {
+                      "type": "string",
+                      "nullable": true
+                    },
+                    "bankIban": {
+                      "type": "string",
+                      "nullable": true,
+                      "description": "IBAN of the bank account."
+                    },
+                    "bankCode": {
+                      "type": "string",
+                      "nullable": true,
+                      "description": "Bank code assigned by a central bank, a bank supervisory body or a Bankers Association in the country."
+                    },
+                    "bankAccountNumber": {
+                      "type": "string",
+                      "nullable": true,
+                      "description": "Bank account number."
+                    },
+                    "bankAccountType": {
+                      "type": "string",
+                      "nullable": true,
+                      "description": "Type of the bank account."
+                    },
+                    "bankBic": {
+                      "type": "string",
+                      "nullable": true,
+                      "description": "BIC/SWIFT code of the bank."
+                    }
+                  },
+                  "required": [
+                    "type",
+                    "name",
+                    "contactPerson",
+                    "country",
+                    "region",
+                    "city",
+                    "postCode",
+                    "address",
+                    "regNo",
+                    "taxId",
+                    "phone",
+                    "email",
+                    "bankIban",
+                    "bankName",
+                    "bankAddress",
+                    "bankCode",
+                    "bankAccountNumber",
+                    "bankAccountType",
+                    "bankAccountHolder",
+                    "bankBic"
+                  ]
+                },
+                "downloadUrl": {
+                  "type": "string",
+                  "format": "url",
+                  "description": "Link to download the full settlement report document."
+                },
+                "externalId": {
+                  "description": "An optional external identifier for integration purposes",
+                  "type": "string",
+                  "maxLength": 255
+                },
+                "deductedFees": {
+                  "description": "Aggregated deducted fees for the settlement period. Included only when at least one fee is non-zero, and each individual fee is included only when the settlement report holds a stored value for it.\n\nA tax-inclusive amount, when present, is the stored total of the tax-inclusive amounts of the underlying records, substituting the tax-exclusive amount for any record that carries no tax-inclusive one.\n",
+                  "type": "object",
+                  "properties": {
+                    "perSessionAc": {
+                      "description": "Total fixed fee for AC sessions in the settlement period.",
+                      "$ref": "#/paths/~1public-api~1resources~1partner-settlement-reports~1v1.1~1%7BpartnerSettlementReport%7D/get/responses/200/content/application~1json/schema/properties/data"
+                    },
+                    "perSessionDc": {
+                      "description": "Total fixed fee for DC sessions in the settlement period.",
+                      "$ref": "#/paths/~1public-api~1resources~1partner-settlement-reports~1v1.1~1%7BpartnerSettlementReport%7D/get/responses/200/content/application~1json/schema/properties/data"
+                    },
+                    "perKwhAc": {
+                      "description": "Total fee per AC kWh delivered in the settlement period.",
+                      "$ref": "#/paths/~1public-api~1resources~1partner-settlement-reports~1v1.1~1%7BpartnerSettlementReport%7D/get/responses/200/content/application~1json/schema/properties/data"
+                    },
+                    "perKwhDc": {
+                      "description": "Total fee per DC kWh delivered in the settlement period.",
+                      "$ref": "#/paths/~1public-api~1resources~1partner-settlement-reports~1v1.1~1%7BpartnerSettlementReport%7D/get/responses/200/content/application~1json/schema/properties/data"
+                    },
+                    "handling": {
+                      "description": "Total percentage-based handling fee for the settlement period.\n\n`withoutTax` is the tax-exclusive fee total, whereas the v1.0 `handlingFee` number was the tax-inclusive amount.\n",
+                      "$ref": "#/paths/~1public-api~1resources~1partner-settlement-reports~1v1.1~1%7BpartnerSettlementReport%7D/get/responses/200/content/application~1json/schema/properties/data"
+                    }
+                  }
+                },
+                "partnerInvoiceId": {
+                  "type": "integer",
+                  "description": "Identifier of the latest issued partner invoice for this settlement report.\nOmitted when no partner invoice has been issued.\nRetained after a credit note is issued — the credit note is a separate document and the reference points at the invoice the report produced.\n"
+                },
+                "customFields": {
+                  "description": "Live custom field values keyed by their administrator-defined identifiers. Values use the wire representation configured for each field: Boolean is a JSON boolean; Text and Long text are strings; Email is an email-formatted string; URL is an HTTP or HTTPS URL string; Number is a canonical base-10 decimal string from `-99999999999999.999999` through `99999999999999.999999` with up to six fractional digits and no insignificant trailing fractional zeroes; Date is an ISO 8601 `YYYY-MM-DD` string; Date-time is an ISO 8601 timestamp with a UTC offset; and JSON may be any JSON-serializable value. Applicable fields without a value are returned as `null`; fields that are not applicable to the settlement report's current partner owner or are not visible to the acting administrator are omitted. The `customFields` property itself is omitted when no fields apply.\n\nThese values reflect the current custom field configuration and are not captured in the historical settlement report document, its party and settings snapshots, or derived partner invoices. Existing settlement report access controls continue to determine whether the report can be read; custom field visibility does not grant access to a report.\n",
+                  "type": "object",
+                  "additionalProperties": true
+                }
+              },
+              "required": [
+                "id",
+                "partnerId",
+                "number",
+                "date",
+                "periodStart",
+                "periodEnd",
+                "currencyCode",
+                "totals",
+                "totalEnergyCpoWh",
+                "totalEnergyEmspWh",
+                "supplier",
+                "customer",
+                "downloadUrl"
+              ]
+            }
+          },
+          "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
+              }
+            }
+          }
+        },
+        "required": [
+          "data",
+          "links",
+          "meta"
+        ]
+      }
+    },
+    "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"
+          }
+        }
+      }
+    }
+  },
+  "partnerSettlementReportReadV1_1": {
+    "200": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "integer",
+                "description": "Unique settlement report identifier."
+              },
+              "partnerId": {
+                "type": "integer",
+                "description": "Unique identifier of the partner involved in the settlement."
+              },
+              "number": {
+                "type": "string",
+                "description": "Settlement report reference number."
+              },
+              "date": {
+                "type": "string",
+                "format": "date",
+                "description": "Date the settlement report was generated."
+              },
+              "periodStart": {
+                "type": "string",
+                "format": "date",
+                "description": "Start date of the period covered by the report."
+              },
+              "periodEnd": {
+                "type": "string",
+                "format": "date",
+                "description": "End date of the period covered by the report."
+              },
+              "currencyCode": {
+                "description": "Currency used in the settlement (e.g., USD, EUR).",
+                "type": "string",
+                "enum": [
+                  "AED",
+                  "AFN",
+                  "ALL",
+                  "AMD",
+                  "ANG",
+                  "AOA",
+                  "ARS",
+                  "AUD",
+                  "AWG",
+                  "AZN",
+                  "BAM",
+                  "BBD",
+                  "BDT",
+                  "BGN",
+                  "BHD",
+                  "BIF",
+                  "BMD",
+                  "BND",
+                  "BOB",
+                  "BOV",
+                  "BRL",
+                  "BSD",
+                  "BTN",
+                  "BWP",
+                  "BYN",
+                  "BZD",
+                  "CAD",
+                  "CDF",
+                  "CHE",
+                  "CHF",
+                  "CHW",
+                  "CLF",
+                  "CLP",
+                  "CNY",
+                  "COP",
+                  "COU",
+                  "CRC",
+                  "CUC",
+                  "CUP",
+                  "CVE",
+                  "CZK",
+                  "DJF",
+                  "DKK",
+                  "DOP",
+                  "DZD",
+                  "EGP",
+                  "ERN",
+                  "ETB",
+                  "EUR",
+                  "FJD",
+                  "FKP",
+                  "GBP",
+                  "GEL",
+                  "GHS",
+                  "GIP",
+                  "GMD",
+                  "GNF",
+                  "GTQ",
+                  "GYD",
+                  "HKD",
+                  "HNL",
+                  "HRK",
+                  "HTG",
+                  "HUF",
+                  "IDR",
+                  "ILS",
+                  "INR",
+                  "IQD",
+                  "IRR",
+                  "ISK",
+                  "JMD",
+                  "JOD",
+                  "JPY",
+                  "KES",
+                  "KGS",
+                  "KHR",
+                  "KMF",
+                  "KPW",
+                  "KRW",
+                  "KWD",
+                  "KYD",
+                  "KZT",
+                  "LAK",
+                  "LBP",
+                  "LKR",
+                  "LRD",
+                  "LSL",
+                  "LYD",
+                  "MAD",
+                  "MDL",
+                  "MGA",
+                  "MKD",
+                  "MMK",
+                  "MNT",
+                  "MOP",
+                  "MRU",
+                  "MUR",
+                  "MVR",
+                  "MWK",
+                  "MXN",
+                  "MXV",
+                  "MYR",
+                  "MZN",
+                  "NAD",
+                  "NGN",
+                  "NIO",
+                  "NOK",
+                  "NPR",
+                  "NZD",
+                  "OMR",
+                  "PAB",
+                  "PEN",
+                  "PGK",
+                  "PHP",
+                  "PKR",
+                  "PLN",
+                  "PYG",
+                  "QAR",
+                  "RON",
+                  "RSD",
+                  "RUB",
+                  "RWF",
+                  "SAR",
+                  "SBD",
+                  "SCR",
+                  "SDG",
+                  "SEK",
+                  "SGD",
+                  "SHP",
+                  "SLL",
+                  "SOS",
+                  "SRD",
+                  "SSP",
+                  "STN",
+                  "SVC",
+                  "SYP",
+                  "SZL",
+                  "THB",
+                  "TJS",
+                  "TMT",
+                  "TND",
+                  "TOP",
+                  "TRY",
+                  "TTD",
+                  "TWD",
+                  "TZS",
+                  "UAH",
+                  "UGX",
+                  "USD",
+                  "USN",
+                  "UYI",
+                  "UYU",
+                  "UYW",
+                  "UZS",
+                  "VES",
+                  "VND",
+                  "VUV",
+                  "WST",
+                  "XAF",
+                  "XAG",
+                  "XAU",
+                  "XBA",
+                  "XBB",
+                  "XBC",
+                  "XBD",
+                  "XCD",
+                  "XDR",
+                  "XOF",
+                  "XPD",
+                  "XPF",
+                  "XPT",
+                  "XSU",
+                  "XTS",
+                  "XUA",
+                  "XXX",
+                  "YER",
+                  "ZAR",
+                  "ZMW",
+                  "ZWL"
+                ]
+              },
+              "totals": {
+                "description": "Settlement totals for the period, each with the tax-exclusive amount and, where stored, the tax-inclusive amount.\n\nA tax-inclusive amount, when present, is the stored total of the tax-inclusive amounts of the underlying records, substituting the tax-exclusive amount for any record that carries no tax-inclusive one.\n",
+                "type": "object",
+                "properties": {
+                  "amount": {
+                    "description": "Total settlement amount.",
+                    "type": "object",
+                    "properties": {
+                      "withoutTax": {
+                        "type": "number",
+                        "description": "The tax-exclusive amount."
+                      },
+                      "withTax": {
+                        "type": "number",
+                        "description": "The tax-inclusive amount. Omitted when no tax-inclusive value is stored for this amount."
+                      }
+                    },
+                    "required": [
+                      "withoutTax"
+                    ]
+                  },
+                  "expenses": {
+                    "description": "Total expenses incurred during the settlement period.",
+                    "type": "object",
+                    "properties": {
+                      "withoutTax": {
+                        "type": "number",
+                        "description": "The tax-exclusive amount."
+                      },
+                      "withTax": {
+                        "type": "number",
+                        "description": "The tax-inclusive amount. Omitted when no tax-inclusive value is stored for this amount."
+                      }
+                    },
+                    "required": [
+                      "withoutTax"
+                    ]
+                  },
+                  "revenue": {
+                    "description": "Total revenue generated during the settlement period.",
+                    "type": "object",
+                    "properties": {
+                      "withoutTax": {
+                        "type": "number",
+                        "description": "The tax-exclusive amount."
+                      },
+                      "withTax": {
+                        "type": "number",
+                        "description": "The tax-inclusive amount. Omitted when no tax-inclusive value is stored for this amount."
+                      }
+                    },
+                    "required": [
+                      "withoutTax"
+                    ]
+                  },
+                  "awaitedRevenue": {
+                    "description": "Revenue expected but not yet collected.",
+                    "type": "object",
+                    "properties": {
+                      "withoutTax": {
+                        "type": "number",
+                        "description": "The tax-exclusive amount."
+                      },
+                      "withTax": {
+                        "type": "number",
+                        "description": "The tax-inclusive amount. Omitted when no tax-inclusive value is stored for this amount."
+                      }
+                    },
+                    "required": [
+                      "withoutTax"
+                    ]
+                  },
+                  "collectedRevenue": {
+                    "description": "Revenue collected during the settlement period.",
+                    "type": "object",
+                    "properties": {
+                      "withoutTax": {
+                        "type": "number",
+                        "description": "The tax-exclusive amount."
+                      },
+                      "withTax": {
+                        "type": "number",
+                        "description": "The tax-inclusive amount. Omitted when no tax-inclusive value is stored for this amount."
+                      }
+                    },
+                    "required": [
+                      "withoutTax"
+                    ]
+                  },
+                  "collectedRevenueFromPreviousPeriod": {
+                    "description": "Revenue collected during this period, but related to a previous periods.",
+                    "type": "object",
+                    "properties": {
+                      "withoutTax": {
+                        "type": "number",
+                        "description": "The tax-exclusive amount."
+                      },
+                      "withTax": {
+                        "type": "number",
+                        "description": "The tax-inclusive amount. Omitted when no tax-inclusive value is stored for this amount."
+                      }
+                    },
+                    "required": [
+                      "withoutTax"
+                    ]
+                  }
+                },
+                "required": [
+                  "amount",
+                  "expenses",
+                  "revenue",
+                  "awaitedRevenue",
+                  "collectedRevenue",
+                  "collectedRevenueFromPreviousPeriod"
+                ]
+              },
+              "totalEnergyCpoWh": {
+                "type": "number",
+                "description": "Total amount of energy (in Wh) delivered by the Charge Point Operator."
+              },
+              "totalEnergyEmspWh": {
+                "type": "number",
+                "description": "Total amount of energy (in Wh) consumed by the EMSP."
+              },
+              "supplier": {
+                "description": "Company details for the entity supplying the service - the CPO.",
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "individual",
+                      "company"
+                    ]
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "contactPerson": {
+                    "type": "string",
+                    "nullable": true
+                  },
+                  "country": {
+                    "type": "string",
+                    "nullable": true,
+                    "enum": [
+                      "AF",
+                      "AX",
+                      "AL",
+                      "DZ",
+                      "AS",
+                      "AD",
+                      "AO",
+                      "AI",
+                      "AQ",
+                      "AG",
+                      "AR",
+                      "AM",
+                      "AW",
+                      "AU",
+                      "AT",
+                      "AZ",
+                      "BS",
+                      "BH",
+                      "BD",
+                      "BB",
+                      "BY",
+                      "BE",
+                      "BZ",
+                      "BJ",
+                      "BM",
+                      "BT",
+                      "BO",
+                      "BQ",
+                      "BA",
+                      "BW",
+                      "BV",
+                      "BR",
+                      "IO",
+                      "BN",
+                      "BG",
+                      "BF",
+                      "BI",
+                      "KH",
+                      "CM",
+                      "CA",
+                      "CV",
+                      "KY",
+                      "CF",
+                      "TD",
+                      "CL",
+                      "CN",
+                      "CX",
+                      "CC",
+                      "CO",
+                      "KM",
+                      "CG",
+                      "CD",
+                      "CK",
+                      "CR",
+                      "CI",
+                      "HR",
+                      "CU",
+                      "CW",
+                      "CY",
+                      "CZ",
+                      "DK",
+                      "DJ",
+                      "DM",
+                      "DO",
+                      "EC",
+                      "EG",
+                      "SV",
+                      "GQ",
+                      "ER",
+                      "EE",
+                      "ET",
+                      "FK",
+                      "FO",
+                      "FJ",
+                      "FI",
+                      "FR",
+                      "GF",
+                      "PF",
+                      "TF",
+                      "GA",
+                      "GM",
+                      "GE",
+                      "DE",
+                      "GH",
+                      "GI",
+                      "GR",
+                      "GL",
+                      "GD",
+                      "GP",
+                      "GU",
+                      "GT",
+                      "GG",
+                      "GN",
+                      "GW",
+                      "GY",
+                      "HT",
+                      "HM",
+                      "VA",
+                      "HN",
+                      "HK",
+                      "HU",
+                      "IS",
+                      "IN",
+                      "ID",
+                      "IR",
+                      "IQ",
+                      "IE",
+                      "IM",
+                      "IL",
+                      "IT",
+                      "JM",
+                      "JP",
+                      "JE",
+                      "JO",
+                      "KZ",
+                      "KE",
+                      "KI",
+                      "KP",
+                      "KR",
+                      "XK",
+                      "KW",
+                      "KG",
+                      "LA",
+                      "LV",
+                      "LB",
+                      "LS",
+                      "LR",
+                      "LY",
+                      "LI",
+                      "LT",
+                      "LU",
+                      "MO",
+                      "MK",
+                      "MG",
+                      "MW",
+                      "MY",
+                      "MV",
+                      "ML",
+                      "MT",
+                      "MH",
+                      "MQ",
+                      "MR",
+                      "MU",
+                      "YT",
+                      "MX",
+                      "FM",
+                      "MD",
+                      "MC",
+                      "MN",
+                      "ME",
+                      "MS",
+                      "MA",
+                      "MZ",
+                      "MM",
+                      "NA",
+                      "NR",
+                      "NP",
+                      "NL",
+                      "NC",
+                      "NZ",
+                      "NI",
+                      "NE",
+                      "NG",
+                      "NU",
+                      "NF",
+                      "MP",
+                      "NO",
+                      "OM",
+                      "PK",
+                      "PW",
+                      "PS",
+                      "PA",
+                      "PG",
+                      "PY",
+                      "PE",
+                      "PH",
+                      "PN",
+                      "PL",
+                      "PT",
+                      "PR",
+                      "QA",
+                      "RE",
+                      "RO",
+                      "RU",
+                      "RW",
+                      "BL",
+                      "SH",
+                      "KN",
+                      "LC",
+                      "MF",
+                      "PM",
+                      "VC",
+                      "WS",
+                      "SM",
+                      "ST",
+                      "SA",
+                      "SN",
+                      "RS",
+                      "SC",
+                      "SL",
+                      "SG",
+                      "SX",
+                      "SK",
+                      "SI",
+                      "SB",
+                      "SO",
+                      "ZA",
+                      "GS",
+                      "SS",
+                      "ES",
+                      "LK",
+                      "SD",
+                      "SR",
+                      "SJ",
+                      "SZ",
+                      "SE",
+                      "CH",
+                      "SY",
+                      "TW",
+                      "TJ",
+                      "TZ",
+                      "TH",
+                      "TL",
+                      "TG",
+                      "TK",
+                      "TO",
+                      "TT",
+                      "TN",
+                      "TR",
+                      "TM",
+                      "TC",
+                      "TV",
+                      "UG",
+                      "UA",
+                      "AE",
+                      "GB",
+                      "US",
+                      "UM",
+                      "UY",
+                      "UZ",
+                      "VU",
+                      "VE",
+                      "VN",
+                      "VG",
+                      "VI",
+                      "WF",
+                      "EH",
+                      "YE",
+                      "ZM",
+                      "ZW"
+                    ]
+                  },
+                  "region": {
+                    "type": "string",
+                    "nullable": true
+                  },
+                  "city": {
+                    "type": "string",
+                    "nullable": true
+                  },
+                  "postCode": {
+                    "type": "string",
+                    "nullable": true
+                  },
+                  "address": {
+                    "type": "string",
+                    "nullable": true
+                  },
+                  "regNo": {
+                    "type": "string",
+                    "nullable": true
+                  },
+                  "taxId": {
+                    "type": "string",
+                    "nullable": true
+                  },
+                  "phone": {
+                    "type": "string",
+                    "nullable": true
+                  },
+                  "email": {
+                    "type": "string",
+                    "nullable": true
+                  }
+                },
+                "required": [
+                  "type",
+                  "name",
+                  "contactPerson",
+                  "country",
+                  "region",
+                  "city",
+                  "postCode",
+                  "address",
+                  "regNo",
+                  "taxId",
+                  "phone",
+                  "email"
+                ]
+              },
+              "customer": {
+                "description": "Company details for the entity receiving the service - the Partner/EMSP.",
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "individual",
+                      "company"
+                    ]
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "contactPerson": {
+                    "type": "string",
+                    "nullable": true
+                  },
+                  "country": {
+                    "type": "string",
+                    "nullable": true,
+                    "enum": [
+                      "AF",
+                      "AX",
+                      "AL",
+                      "DZ",
+                      "AS",
+                      "AD",
+                      "AO",
+                      "AI",
+                      "AQ",
+                      "AG",
+                      "AR",
+                      "AM",
+                      "AW",
+                      "AU",
+                      "AT",
+                      "AZ",
+                      "BS",
+                      "BH",
+                      "BD",
+                      "BB",
+                      "BY",
+                      "BE",
+                      "BZ",
+                      "BJ",
+                      "BM",
+                      "BT",
+                      "BO",
+                      "BQ",
+                      "BA",
+                      "BW",
+                      "BV",
+                      "BR",
+                      "IO",
+                      "BN",
+                      "BG",
+                      "BF",
+                      "BI",
+                      "KH",
+                      "CM",
+                      "CA",
+                      "CV",
+                      "KY",
+                      "CF",
+                      "TD",
+                      "CL",
+                      "CN",
+                      "CX",
+                      "CC",
+                      "CO",
+                      "KM",
+                      "CG",
+                      "CD",
+                      "CK",
+                      "CR",
+                      "CI",
+                      "HR",
+                      "CU",
+                      "CW",
+                      "CY",
+                      "CZ",
+                      "DK",
+                      "DJ",
+                      "DM",
+                      "DO",
+                      "EC",
+                      "EG",
+                      "SV",
+                      "GQ",
+                      "ER",
+                      "EE",
+                      "ET",
+                      "FK",
+                      "FO",
+                      "FJ",
+                      "FI",
+                      "FR",
+                      "GF",
+                      "PF",
+                      "TF",
+                      "GA",
+                      "GM",
+                      "GE",
+                      "DE",
+                      "GH",
+                      "GI",
+                      "GR",
+                      "GL",
+                      "GD",
+                      "GP",
+                      "GU",
+                      "GT",
+                      "GG",
+                      "GN",
+                      "GW",
+                      "GY",
+                      "HT",
+                      "HM",
+                      "VA",
+                      "HN",
+                      "HK",
+                      "HU",
+                      "IS",
+                      "IN",
+                      "ID",
+                      "IR",
+                      "IQ",
+                      "IE",
+                      "IM",
+                      "IL",
+                      "IT",
+                      "JM",
+                      "JP",
+                      "JE",
+                      "JO",
+                      "KZ",
+                      "KE",
+                      "KI",
+                      "KP",
+                      "KR",
+                      "XK",
+                      "KW",
+                      "KG",
+                      "LA",
+                      "LV",
+                      "LB",
+                      "LS",
+                      "LR",
+                      "LY",
+                      "LI",
+                      "LT",
+                      "LU",
+                      "MO",
+                      "MK",
+                      "MG",
+                      "MW",
+                      "MY",
+                      "MV",
+                      "ML",
+                      "MT",
+                      "MH",
+                      "MQ",
+                      "MR",
+                      "MU",
+                      "YT",
+                      "MX",
+                      "FM",
+                      "MD",
+                      "MC",
+                      "MN",
+                      "ME",
+                      "MS",
+                      "MA",
+                      "MZ",
+                      "MM",
+                      "NA",
+                      "NR",
+                      "NP",
+                      "NL",
+                      "NC",
+                      "NZ",
+                      "NI",
+                      "NE",
+                      "NG",
+                      "NU",
+                      "NF",
+                      "MP",
+                      "NO",
+                      "OM",
+                      "PK",
+                      "PW",
+                      "PS",
+                      "PA",
+                      "PG",
+                      "PY",
+                      "PE",
+                      "PH",
+                      "PN",
+                      "PL",
+                      "PT",
+                      "PR",
+                      "QA",
+                      "RE",
+                      "RO",
+                      "RU",
+                      "RW",
+                      "BL",
+                      "SH",
+                      "KN",
+                      "LC",
+                      "MF",
+                      "PM",
+                      "VC",
+                      "WS",
+                      "SM",
+                      "ST",
+                      "SA",
+                      "SN",
+                      "RS",
+                      "SC",
+                      "SL",
+                      "SG",
+                      "SX",
+                      "SK",
+                      "SI",
+                      "SB",
+                      "SO",
+                      "ZA",
+                      "GS",
+                      "SS",
+                      "ES",
+                      "LK",
+                      "SD",
+                      "SR",
+                      "SJ",
+                      "SZ",
+                      "SE",
+                      "CH",
+                      "SY",
+                      "TW",
+                      "TJ",
+                      "TZ",
+                      "TH",
+                      "TL",
+                      "TG",
+                      "TK",
+                      "TO",
+                      "TT",
+                      "TN",
+                      "TR",
+                      "TM",
+                      "TC",
+                      "TV",
+                      "UG",
+                      "UA",
+                      "AE",
+                      "GB",
+                      "US",
+                      "UM",
+                      "UY",
+                      "UZ",
+                      "VU",
+                      "VE",
+                      "VN",
+                      "VG",
+                      "VI",
+                      "WF",
+                      "EH",
+                      "YE",
+                      "ZM",
+                      "ZW"
+                    ]
+                  },
+                  "region": {
+                    "type": "string",
+                    "nullable": true
+                  },
+                  "city": {
+                    "type": "string",
+                    "nullable": true
+                  },
+                  "postCode": {
+                    "type": "string",
+                    "nullable": true
+                  },
+                  "address": {
+                    "type": "string",
+                    "nullable": true
+                  },
+                  "regNo": {
+                    "type": "string",
+                    "nullable": true
+                  },
+                  "taxId": {
+                    "type": "string",
+                    "nullable": true
+                  },
+                  "phone": {
+                    "type": "string",
+                    "nullable": true
+                  },
+                  "email": {
+                    "type": "string",
+                    "nullable": true
+                  },
+                  "bankIban": {
+                    "type": "string",
+                    "nullable": true,
+                    "description": "IBAN of the bank account."
+                  },
+                  "bankCode": {
+                    "type": "string",
+                    "nullable": true,
+                    "description": "Bank code assigned by a central bank, a bank supervisory body or a Bankers Association in the country."
+                  },
+                  "bankAccountNumber": {
+                    "type": "string",
+                    "nullable": true,
+                    "description": "Bank account number."
+                  },
+                  "bankAccountType": {
+                    "type": "string",
+                    "nullable": true,
+                    "description": "Type of the bank account."
+                  },
+                  "bankBic": {
+                    "type": "string",
+                    "nullable": true,
+                    "description": "BIC/SWIFT code of the bank."
+                  }
+                },
+                "required": [
+                  "type",
+                  "name",
+                  "contactPerson",
+                  "country",
+                  "region",
+                  "city",
+                  "postCode",
+                  "address",
+                  "regNo",
+                  "taxId",
+                  "phone",
+                  "email",
+                  "bankIban",
+                  "bankName",
+                  "bankAddress",
+                  "bankCode",
+                  "bankAccountNumber",
+                  "bankAccountType",
+                  "bankAccountHolder",
+                  "bankBic"
+                ]
+              },
+              "downloadUrl": {
+                "type": "string",
+                "format": "url",
+                "description": "Link to download the full settlement report document."
+              },
+              "externalId": {
+                "description": "An optional external identifier for integration purposes",
+                "type": "string",
+                "maxLength": 255
+              },
+              "deductedFees": {
+                "description": "Aggregated deducted fees for the settlement period. Included only when at least one fee is non-zero, and each individual fee is included only when the settlement report holds a stored value for it.\n\nA tax-inclusive amount, when present, is the stored total of the tax-inclusive amounts of the underlying records, substituting the tax-exclusive amount for any record that carries no tax-inclusive one.\n",
+                "type": "object",
+                "properties": {
+                  "perSessionAc": {
+                    "description": "Total fixed fee for AC sessions in the settlement period.",
+                    "type": "object",
+                    "properties": {
+                      "withoutTax": {
+                        "type": "number",
+                        "description": "The tax-exclusive amount."
+                      },
+                      "withTax": {
+                        "type": "number",
+                        "description": "The tax-inclusive amount. Omitted when no tax-inclusive value is stored for this amount."
+                      }
+                    },
+                    "required": [
+                      "withoutTax"
+                    ]
+                  },
+                  "perSessionDc": {
+                    "description": "Total fixed fee for DC sessions in the settlement period.",
+                    "type": "object",
+                    "properties": {
+                      "withoutTax": {
+                        "type": "number",
+                        "description": "The tax-exclusive amount."
+                      },
+                      "withTax": {
+                        "type": "number",
+                        "description": "The tax-inclusive amount. Omitted when no tax-inclusive value is stored for this amount."
+                      }
+                    },
+                    "required": [
+                      "withoutTax"
+                    ]
+                  },
+                  "perKwhAc": {
+                    "description": "Total fee per AC kWh delivered in the settlement period.",
+                    "type": "object",
+                    "properties": {
+                      "withoutTax": {
+                        "type": "number",
+                        "description": "The tax-exclusive amount."
+                      },
+                      "withTax": {
+                        "type": "number",
+                        "description": "The tax-inclusive amount. Omitted when no tax-inclusive value is stored for this amount."
+                      }
+                    },
+                    "required": [
+                      "withoutTax"
+                    ]
+                  },
+                  "perKwhDc": {
+                    "description": "Total fee per DC kWh delivered in the settlement period.",
+                    "type": "object",
+                    "properties": {
+                      "withoutTax": {
+                        "type": "number",
+                        "description": "The tax-exclusive amount."
+                      },
+                      "withTax": {
+                        "type": "number",
+                        "description": "The tax-inclusive amount. Omitted when no tax-inclusive value is stored for this amount."
+                      }
+                    },
+                    "required": [
+                      "withoutTax"
+                    ]
+                  },
+                  "handling": {
+                    "description": "Total percentage-based handling fee for the settlement period.\n\n`withoutTax` is the tax-exclusive fee total, whereas the v1.0 `handlingFee` number was the tax-inclusive amount.\n",
+                    "type": "object",
+                    "properties": {
+                      "withoutTax": {
+                        "type": "number",
+                        "description": "The tax-exclusive amount."
+                      },
+                      "withTax": {
+                        "type": "number",
+                        "description": "The tax-inclusive amount. Omitted when no tax-inclusive value is stored for this amount."
+                      }
+                    },
+                    "required": [
+                      "withoutTax"
+                    ]
+                  }
+                }
+              },
+              "partnerInvoiceId": {
+                "type": "integer",
+                "description": "Identifier of the latest issued partner invoice for this settlement report.\nOmitted when no partner invoice has been issued.\nRetained after a credit note is issued — the credit note is a separate document and the reference points at the invoice the report produced.\n"
+              },
+              "customFields": {
+                "description": "Live custom field values keyed by their administrator-defined identifiers. Values use the wire representation configured for each field: Boolean is a JSON boolean; Text and Long text are strings; Email is an email-formatted string; URL is an HTTP or HTTPS URL string; Number is a canonical base-10 decimal string from `-99999999999999.999999` through `99999999999999.999999` with up to six fractional digits and no insignificant trailing fractional zeroes; Date is an ISO 8601 `YYYY-MM-DD` string; Date-time is an ISO 8601 timestamp with a UTC offset; and JSON may be any JSON-serializable value. Applicable fields without a value are returned as `null`; fields that are not applicable to the settlement report's current partner owner or are not visible to the acting administrator are omitted. The `customFields` property itself is omitted when no fields apply.\n\nThese values reflect the current custom field configuration and are not captured in the historical settlement report document, its party and settings snapshots, or derived partner invoices. Existing settlement report access controls continue to determine whether the report can be read; custom field visibility does not grant access to a report.\n",
+                "type": "object",
+                "additionalProperties": true
+              }
+            },
+            "required": [
+              "id",
+              "partnerId",
+              "number",
+              "date",
+              "periodStart",
+              "periodEnd",
+              "currencyCode",
+              "totals",
+              "totalEnergyCpoWh",
+              "totalEnergyEmspWh",
+              "supplier",
+              "customer",
+              "downloadUrl"
+            ]
+          }
+        },
+        "required": [
+          "data"
+        ]
+      }
+    },
+    "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",
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  },
+  "partnerSettlementReportPartnerSettlementRecordsListingV1_1": {
+    "200": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "date": {
+                  "type": "string",
+                  "format": "date",
+                  "description": "Date the payment was made."
+                },
+                "paidAmount": {
+                  "type": "number",
+                  "description": "Amount recorded as paid, in the settlement report's currency. Negative values record a reversing entry."
+                },
+                "note": {
+                  "type": "string",
+                  "description": "Free-text note on the settlement record."
+                }
+              },
+              "required": [
+                "id",
+                "date",
+                "paidAmount",
+                "note"
+              ]
+            }
+          },
+          "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
+              }
+            }
+          }
+        },
+        "required": [
+          "data",
+          "links",
+          "meta"
+        ]
+      }
+    },
+    "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",
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  },
+  "partnerSettlementReportPartnerSettlementRecordCreateV1_1": {
+    "201": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "object",
+            "properties": {
+              "date": {
+                "type": "string",
+                "format": "date",
+                "description": "Date the payment was made."
+              },
+              "paidAmount": {
+                "type": "number",
+                "description": "Amount recorded as paid, in the settlement report's currency. Negative values record a reversing entry."
+              },
+              "note": {
+                "type": "string",
+                "description": "Free-text note on the settlement record."
+              }
+            },
+            "required": [
+              "id",
+              "date",
+              "paidAmount",
+              "note"
+            ]
+          }
+        },
+        "required": [
+          "data"
+        ]
+      }
+    },
+    "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"
+          }
+        }
+      }
+    },
+    "409": {
+      "schema": {
+        "type": "object",
+        "required": [
+          "message",
+          "errorCode"
+        ],
+        "properties": {
+          "message": {
+            "type": "string",
+            "description": "Human-readable explanation of why the settlement record write is blocked."
+          },
+          "errorCode": {
+            "type": "string",
+            "description": "Machine-readable code describing why the settlement record write is blocked.\n\nAllowed values:\n- `payment_tracking_managed_via_partner_invoice` - The settlement report has at least one partner invoice, so payments are tracked by registering them on those invoices. Settlement records for the report can no longer be created, updated or deleted directly.\n",
+            "enum": [
+              "payment_tracking_managed_via_partner_invoice"
+            ]
+          }
+        }
+      }
+    },
+    "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"
+          }
+        }
+      }
+    }
+  },
+  "partnerSettlementReportPartnerSettlementRecordReadV1_1": {
+    "200": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "object",
+            "properties": {
+              "date": {
+                "type": "string",
+                "format": "date",
+                "description": "Date the payment was made."
+              },
+              "paidAmount": {
+                "type": "number",
+                "description": "Amount recorded as paid, in the settlement report's currency. Negative values record a reversing entry."
+              },
+              "note": {
+                "type": "string",
+                "description": "Free-text note on the settlement record."
+              }
+            },
+            "required": [
+              "id",
+              "date",
+              "paidAmount",
+              "note"
+            ]
+          }
+        },
+        "required": [
+          "data"
+        ]
+      }
+    },
+    "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",
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  },
+  "partnerSettlementReportPartnerSettlementRecordUpdateV1_1": {
+    "200": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "object",
+            "properties": {
+              "date": {
+                "type": "string",
+                "format": "date",
+                "description": "Date the payment was made."
+              },
+              "paidAmount": {
+                "type": "number",
+                "description": "Amount recorded as paid, in the settlement report's currency. Negative values record a reversing entry."
+              },
+              "note": {
+                "type": "string",
+                "description": "Free-text note on the settlement record."
+              }
+            },
+            "required": [
+              "id",
+              "date",
+              "paidAmount",
+              "note"
+            ]
+          }
+        },
+        "required": [
+          "data"
+        ]
+      }
+    },
+    "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"
+          }
+        }
+      }
+    },
+    "409": {
+      "schema": {
+        "type": "object",
+        "required": [
+          "message",
+          "errorCode"
+        ],
+        "properties": {
+          "message": {
+            "type": "string",
+            "description": "Human-readable explanation of why the settlement record write is blocked."
+          },
+          "errorCode": {
+            "type": "string",
+            "description": "Machine-readable code describing why the settlement record write is blocked.\n\nAllowed values:\n- `payment_tracking_managed_via_partner_invoice` - The settlement report has at least one partner invoice, so payments are tracked by registering them on those invoices. Settlement records for the report can no longer be created, updated or deleted directly.\n",
+            "enum": [
+              "payment_tracking_managed_via_partner_invoice"
+            ]
+          }
+        }
+      }
+    },
+    "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"
+          }
+        }
+      }
+    }
+  },
+  "partnerSettlementReportPartnerSettlementRecordDeleteV1_1": {
+    "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"
+          }
+        }
+      }
+    },
+    "409": {
+      "schema": {
+        "type": "object",
+        "required": [
+          "message",
+          "errorCode"
+        ],
+        "properties": {
+          "message": {
+            "type": "string",
+            "description": "Human-readable explanation of why the settlement record write is blocked."
+          },
+          "errorCode": {
+            "type": "string",
+            "description": "Machine-readable code describing why the settlement record write is blocked.\n\nAllowed values:\n- `payment_tracking_managed_via_partner_invoice` - The settlement report has at least one partner invoice, so payments are tracked by registering them on those invoices. Settlement records for the report can no longer be created, updated or deleted directly.\n",
+            "enum": [
+              "payment_tracking_managed_via_partner_invoice"
+            ]
+          }
+        }
+      }
+    },
+    "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"
+          }
+        }
+      }
+    }
+  },
   "partnersListingDeprecated": {
     "200": {
       "schema": {
@@ -132970,7 +135932,7 @@
           "data": {
             "type": "array",
             "items": {
-              "description": "Reimbursement record read schema. A record is one immutable computed reimbursement entry for a single charging session, and has no general resource write surface. Reversing (credit) records are records too — they carry negated amounts and point at the record they reverse.\n",
+              "description": "⚠️ Experimental feature — not yet a stable contract. This schema ships as experimental / beta. While experimental, it may change without a version bump — including breaking changes — wherever it is returned, including the session `reimbursementRecords` include. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed.\n\nReimbursement record read schema. A record is one immutable computed reimbursement entry for a single charging session, and has no general resource write surface. Reversing (credit) records are records too — they carry negated amounts and point at the record they reverse.\n",
               "type": "object",
               "properties": {
                 "id": {
@@ -133441,7 +136403,7 @@
         "type": "object",
         "properties": {
           "data": {
-            "description": "Reimbursement record read schema. A record is one immutable computed reimbursement entry for a single charging session, and has no general resource write surface. Reversing (credit) records are records too — they carry negated amounts and point at the record they reverse.\n",
+            "description": "⚠️ Experimental feature — not yet a stable contract. This schema ships as experimental / beta. While experimental, it may change without a version bump — including breaking changes — wherever it is returned, including the session `reimbursementRecords` include. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed.\n\nReimbursement record read schema. A record is one immutable computed reimbursement entry for a single charging session, and has no general resource write surface. Reversing (credit) records are records too — they carry negated amounts and point at the record they reverse.\n",
             "type": "object",
             "properties": {
               "id": {
@@ -142767,6 +145729,360 @@
                     "description": "True when the vehicle association was cryptographically verified (e.g., ISO 15118 Plug & Charge)."
                   }
                 }
+              },
+              "reimbursementRecords": {
+                "type": "array",
+                "items": {
+                  "description": "⚠️ Experimental feature — not yet a stable contract. This schema ships as experimental / beta. While experimental, it may change without a version bump — including breaking changes — wherever it is returned, including the session `reimbursementRecords` include. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed.\n\nReimbursement record read schema. A record is one immutable computed reimbursement entry for a single charging session, and has no general resource write surface. Reversing (credit) records are records too — they carry negated amounts and point at the record they reverse.\n",
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "integer",
+                      "readOnly": true,
+                      "description": "Identifier of this reimbursement record."
+                    },
+                    "operatorId": {
+                      "type": "integer",
+                      "description": "Operator the record belongs to, as exposed by the operators resource."
+                    },
+                    "sessionId": {
+                      "type": "integer",
+                      "description": "Charging session the reimbursement was computed for, as exposed by the sessions resource. Reversing (credit) records repeat the reversed record's session."
+                    },
+                    "beneficiary": {
+                      "description": "Party the reimbursement is owed to.\n",
+                      "type": "object",
+                      "properties": {
+                        "userId": {
+                          "type": "integer",
+                          "description": "User the reimbursement is owed to, as exposed by the users resource."
+                        }
+                      }
+                    },
+                    "payer": {
+                      "description": "Party that owes the reimbursement. Company reimbursements carry `partnerId` (and `partnerContractId` when the payment is governed by a partner contract); public reimbursements carry `operatorId`.\n",
+                      "type": "object",
+                      "properties": {
+                        "partnerId": {
+                          "type": "integer",
+                          "description": "Partner paying the reimbursement. Present on company reimbursements."
+                        },
+                        "partnerContractId": {
+                          "type": "integer",
+                          "description": "Partner contract the reimbursement is settled under. Present when the paying partner has a contract."
+                        },
+                        "operatorId": {
+                          "type": "integer",
+                          "description": "Operator paying the reimbursement. Present on public reimbursements."
+                        }
+                      }
+                    },
+                    "reimbursementPolicyId": {
+                      "type": "integer",
+                      "description": "Reimbursement policy whose terms were applied when the amount was computed. Omitted when no policy governed the session."
+                    },
+                    "energy": {
+                      "type": "integer",
+                      "description": "Reimbursed energy in Wh."
+                    },
+                    "rate": {
+                      "type": "number",
+                      "format": "float",
+                      "description": "Monetary rate per kWh applied when computing the reimbursement amount, in the record currency. Its origin is given by `electricityRateSource`. Omitted, together with `electricityRateSource`, on records computed before the platform required a resolved rate; such records are no longer produced."
+                    },
+                    "electricityRateSource": {
+                      "description": "Origin of the per-kWh rate used to reimburse a home-charging session:\n- **policy**: The electricity rate linked to the policy provides the rate. `electricityRateId` is required and must belong to the same operator as the policy; `integrationId` must not be set on the policy.\n- **charge_point**: The electricity rate assigned to the personal charge point provides the rate, whichever surface assigned it. Neither `electricityRateId` nor `integrationId` is set on the policy.\n- **integration**: An integration resolves the electricity rate — for example by the charge point's region. `integrationId` is required and must reference a regional electricity rates integration of the same operator; `electricityRateId` must not be set on the policy. The integration's region-to-rate bindings are configured in the admin panel.\n",
+                      "type": "string",
+                      "enum": [
+                        "policy",
+                        "charge_point",
+                        "integration"
+                      ]
+                    },
+                    "taxBasis": {
+                      "description": "How tax was applied when the reimbursement amount was computed:\n- **exempt**: No tax was applied. The amount is identical with and without tax.\n- **percentage**: Tax was applied as a percentage of the net amount — see `taxPercentage`.\n- **flat_amount**: Tax was applied as a fixed amount per record, independent of the reimbursed energy.\n- **compound**: Tax was applied as a combination of a percentage and a fixed component.\n",
+                      "type": "string",
+                      "enum": [
+                        "exempt",
+                        "percentage",
+                        "flat_amount",
+                        "compound"
+                      ]
+                    },
+                    "taxPercentage": {
+                      "type": "number",
+                      "format": "float",
+                      "description": "Tax percentage applied to the reimbursement amount. Present when the applied `taxBasis` carries a percentage component; omitted when no tax percentage could be resolved."
+                    },
+                    "amount": {
+                      "description": "Reimbursement amount, split by tax inclusion. Reversing (credit) records carry negated amounts.",
+                      "type": "object",
+                      "properties": {
+                        "withTax": {
+                          "type": "number"
+                        },
+                        "withoutTax": {
+                          "type": "number"
+                        }
+                      },
+                      "required": [
+                        "withTax"
+                      ]
+                    },
+                    "currency": {
+                      "description": "ISO 4217 currency code for the record's monetary amounts.",
+                      "type": "string",
+                      "enum": [
+                        "AED",
+                        "AFN",
+                        "ALL",
+                        "AMD",
+                        "ANG",
+                        "AOA",
+                        "ARS",
+                        "AUD",
+                        "AWG",
+                        "AZN",
+                        "BAM",
+                        "BBD",
+                        "BDT",
+                        "BGN",
+                        "BHD",
+                        "BIF",
+                        "BMD",
+                        "BND",
+                        "BOB",
+                        "BOV",
+                        "BRL",
+                        "BSD",
+                        "BTN",
+                        "BWP",
+                        "BYN",
+                        "BZD",
+                        "CAD",
+                        "CDF",
+                        "CHE",
+                        "CHF",
+                        "CHW",
+                        "CLF",
+                        "CLP",
+                        "CNY",
+                        "COP",
+                        "COU",
+                        "CRC",
+                        "CUC",
+                        "CUP",
+                        "CVE",
+                        "CZK",
+                        "DJF",
+                        "DKK",
+                        "DOP",
+                        "DZD",
+                        "EGP",
+                        "ERN",
+                        "ETB",
+                        "EUR",
+                        "FJD",
+                        "FKP",
+                        "GBP",
+                        "GEL",
+                        "GHS",
+                        "GIP",
+                        "GMD",
+                        "GNF",
+                        "GTQ",
+                        "GYD",
+                        "HKD",
+                        "HNL",
+                        "HRK",
+                        "HTG",
+                        "HUF",
+                        "IDR",
+                        "ILS",
+                        "INR",
+                        "IQD",
+                        "IRR",
+                        "ISK",
+                        "JMD",
+                        "JOD",
+                        "JPY",
+                        "KES",
+                        "KGS",
+                        "KHR",
+                        "KMF",
+                        "KPW",
+                        "KRW",
+                        "KWD",
+                        "KYD",
+                        "KZT",
+                        "LAK",
+                        "LBP",
+                        "LKR",
+                        "LRD",
+                        "LSL",
+                        "LYD",
+                        "MAD",
+                        "MDL",
+                        "MGA",
+                        "MKD",
+                        "MMK",
+                        "MNT",
+                        "MOP",
+                        "MRU",
+                        "MUR",
+                        "MVR",
+                        "MWK",
+                        "MXN",
+                        "MXV",
+                        "MYR",
+                        "MZN",
+                        "NAD",
+                        "NGN",
+                        "NIO",
+                        "NOK",
+                        "NPR",
+                        "NZD",
+                        "OMR",
+                        "PAB",
+                        "PEN",
+                        "PGK",
+                        "PHP",
+                        "PKR",
+                        "PLN",
+                        "PYG",
+                        "QAR",
+                        "RON",
+                        "RSD",
+                        "RUB",
+                        "RWF",
+                        "SAR",
+                        "SBD",
+                        "SCR",
+                        "SDG",
+                        "SEK",
+                        "SGD",
+                        "SHP",
+                        "SLL",
+                        "SOS",
+                        "SRD",
+                        "SSP",
+                        "STN",
+                        "SVC",
+                        "SYP",
+                        "SZL",
+                        "THB",
+                        "TJS",
+                        "TMT",
+                        "TND",
+                        "TOP",
+                        "TRY",
+                        "TTD",
+                        "TWD",
+                        "TZS",
+                        "UAH",
+                        "UGX",
+                        "USD",
+                        "USN",
+                        "UYI",
+                        "UYU",
+                        "UYW",
+                        "UZS",
+                        "VES",
+                        "VND",
+                        "VUV",
+                        "WST",
+                        "XAF",
+                        "XAG",
+                        "XAU",
+                        "XBA",
+                        "XBB",
+                        "XBC",
+                        "XBD",
+                        "XCD",
+                        "XDR",
+                        "XOF",
+                        "XPD",
+                        "XPF",
+                        "XPT",
+                        "XSU",
+                        "XTS",
+                        "XUA",
+                        "XXX",
+                        "YER",
+                        "ZAR",
+                        "ZMW",
+                        "ZWL"
+                      ]
+                    },
+                    "periodStartsOn": {
+                      "description": "Uses the YYYY-MM-DD date format.",
+                      "type": "string",
+                      "format": "date"
+                    },
+                    "periodEndsOn": {
+                      "description": "Uses the YYYY-MM-DD date format.",
+                      "type": "string",
+                      "format": "date"
+                    },
+                    "credit": {
+                      "description": "Reversal this record carries out. Present only on reversing (credit) records.\n",
+                      "type": "object",
+                      "properties": {
+                        "reimbursementRecordId": {
+                          "type": "integer",
+                          "description": "Reimbursement record this record reverses, as exposed by this same resource."
+                        },
+                        "reason": {
+                          "type": "string",
+                          "description": "Reason the reversal was issued, as supplied when the credit was requested."
+                        }
+                      }
+                    },
+                    "creditedByReimbursementRecordId": {
+                      "type": "integer",
+                      "description": "Reversing (credit) record that reverses this record, as exposed by this same resource. Omitted when this record has not been reversed."
+                    },
+                    "authUserId": {
+                      "type": "integer",
+                      "description": "User whose credential authorized the charging session, as exposed by the users resource. `effectiveUserId` differs from it when the session's vehicle belongs to the charge point owner and the reimbursement was attributed to that owner instead."
+                    },
+                    "effectiveUserId": {
+                      "type": "integer",
+                      "description": "User the session was attributed to for reimbursement purposes, as exposed by the users resource. Equal to `beneficiary.userId` on company reimbursements; on public reimbursements the beneficiary is the charge point owner while the effective user is the driver."
+                    },
+                    "customFields": {
+                      "readOnly": true,
+                      "description": "Live custom field values keyed by their administrator-defined identifiers. Values use the wire representation configured for each field: Boolean is a JSON boolean; Text and Long text are strings; Email is an email-formatted string; URL is an HTTP or HTTPS URL string; Number is a canonical base-10 decimal string from `-99999999999999.999999` through `99999999999999.999999` with up to six fractional digits and no insignificant trailing fractional zeroes; Date is an ISO 8601 `YYYY-MM-DD` string; Date-time is an ISO 8601 timestamp with a UTC offset; and JSON may be any JSON-serializable value. Applicable fields without a value are returned as `null`; fields that are not applicable to the reimbursement record's current operator owner or are not visible to the acting administrator are omitted. The `customFields` property itself is omitted when no fields apply.\n\nThese values are live metadata and are not captured in the record's immutable financial, policy, tag, or calculation history. Existing reimbursement record access controls continue to determine whether the record can be read; custom field visibility does not grant access to a record.\n",
+                      "type": "object",
+                      "additionalProperties": true
+                    },
+                    "createdAt": {
+                      "type": "string",
+                      "format": "date-time",
+                      "description": "ISO 8601 formatted date",
+                      "readOnly": true
+                    },
+                    "updatedAt": {
+                      "type": "string",
+                      "format": "date-time",
+                      "description": "ISO 8601 formatted date",
+                      "readOnly": true
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "operatorId",
+                    "sessionId",
+                    "energy",
+                    "taxBasis",
+                    "amount",
+                    "periodStartsOn",
+                    "periodEndsOn",
+                    "createdAt",
+                    "updatedAt"
+                  ]
+                },
+                "description": "The reimbursement records of the session, ordered by record id ascending. Each entry uses the reimbursement records resource schema. Returned only when `include[]=reimbursementRecords` is set and the caller may view reimbursement records; otherwise omitted. An empty array when the session has no reimbursement records."
               }
             },
             "required": [