@ampeco/public-api-mcp 3.243.0 → 3.244.0

package/dist/generated/response-schemas.json

@@ -5035,6 +5035,52 @@
                   "country"
                 ]
               },
+              "fiscalization": {
+                "type": "object",
+                "properties": {
+                  "status": {
+                    "description": "Certification status of the invoice with its fiscalization integration.\n- **pending**: The fiscal document exists and has been accepted for certification, but the fiscal authority has not yet confirmed it. The document is not yet legally issued.\n- **certified**: The fiscal authority confirmed the document, which is legally issued. `referenceNumber` carries the reference the integration recorded for it. In rare cases a certified document has no recorded reference and `referenceNumber` is absent; this does not resolve on its own and requires operator intervention. A document whose revocation has been requested but not yet confirmed, or whose revocation was rejected, is still `certified` — it remains legally issued until the authority confirms the revocation, at which point it becomes `canceled`.\n- **failed**: Certification did not succeed. Retries are attempted a bounded number of times; a status that remains `failed` requires operator intervention. The fiscal document remains, but no legally issued document exists for it.\n- **canceled**: The document was certified and has since been revoked with the fiscal authority. This is distinct from `failed` — the document was legally issued at some point, and `referenceNumber` keeps the reference the integration had recorded for it.\n",
+                    "type": "string",
+                    "enum": [
+                      "pending",
+                      "certified",
+                      "failed",
+                      "canceled"
+                    ],
+                    "example": "certified"
+                  },
+                  "referenceNumber": {
+                    "type": "string",
+                    "description": "Reference recorded for this document by the fiscalization integration, for correlating it with that integration's own records. For most integrations this is the number assigned by the tax authority; some record a provider-side identifier instead. Treat it as an opaque, integration-defined reference rather than assuming it is the legally issued document number. Once recorded it does not change, including after the document is canceled. Distinct from `externalId`, which is the reference an external accounting or ERP system wrote into the platform. Absent when the integration has recorded no reference."
+                  },
+                  "documents": {
+                    "type": "array",
+                    "description": "Document formats the fiscal authority has made available for this invoice. Omitted while no format has been made available yet.",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "format": {
+                          "type": "string",
+                          "description": "Identifier of the document format, exactly as reported by the fiscal authority. The value is provider-defined and its syntax is not guaranteed — it may be a media type such as `application/pdf`, or a mandate-specific format name. The set is not fixed, so treat an unrecognised value as a format this integration has newly made available rather than as an error; match it verbatim rather than parsing it.",
+                          "example": "application/pdf"
+                        },
+                        "downloadUrl": {
+                          "type": "string",
+                          "description": "Signed link that downloads this format. The link expires 24 hours after the response was produced, so it must be followed rather than stored; request the invoice again for a fresh link. The document is fetched from the fiscal authority only when the link is followed, so the download responds with `424 Failed Dependency` when the provider cannot supply the format at that moment."
+                        }
+                      },
+                      "required": [
+                        "format",
+                        "downloadUrl"
+                      ]
+                    }
+                  }
+                },
+                "required": [
+                  "status"
+                ],
+                "description": "Certification of this invoice with the fiscal authority. Present when the invoice has a fiscal document; omitted entirely for invoices with no fiscal document at all. Presence does not depend on `type` — a fiscalized credit note carries this object exactly as an invoice does."
+              },
               "lastUpdatedAt": {
                 "type": "string",
                 "format": "date-time",
@@ -62928,6 +62974,52 @@
                     "country"
                   ]
                 },
+                "fiscalization": {
+                  "type": "object",
+                  "properties": {
+                    "status": {
+                      "description": "Certification status of the invoice with its fiscalization integration.\n- **pending**: The fiscal document exists and has been accepted for certification, but the fiscal authority has not yet confirmed it. The document is not yet legally issued.\n- **certified**: The fiscal authority confirmed the document, which is legally issued. `referenceNumber` carries the reference the integration recorded for it. In rare cases a certified document has no recorded reference and `referenceNumber` is absent; this does not resolve on its own and requires operator intervention. A document whose revocation has been requested but not yet confirmed, or whose revocation was rejected, is still `certified` — it remains legally issued until the authority confirms the revocation, at which point it becomes `canceled`.\n- **failed**: Certification did not succeed. Retries are attempted a bounded number of times; a status that remains `failed` requires operator intervention. The fiscal document remains, but no legally issued document exists for it.\n- **canceled**: The document was certified and has since been revoked with the fiscal authority. This is distinct from `failed` — the document was legally issued at some point, and `referenceNumber` keeps the reference the integration had recorded for it.\n",
+                      "type": "string",
+                      "enum": [
+                        "pending",
+                        "certified",
+                        "failed",
+                        "canceled"
+                      ],
+                      "example": "certified"
+                    },
+                    "referenceNumber": {
+                      "type": "string",
+                      "description": "Reference recorded for this document by the fiscalization integration, for correlating it with that integration's own records. For most integrations this is the number assigned by the tax authority; some record a provider-side identifier instead. Treat it as an opaque, integration-defined reference rather than assuming it is the legally issued document number. Once recorded it does not change, including after the document is canceled. Distinct from `externalId`, which is the reference an external accounting or ERP system wrote into the platform. Absent when the integration has recorded no reference."
+                    },
+                    "documents": {
+                      "type": "array",
+                      "description": "Document formats the fiscal authority has made available for this invoice. Omitted while no format has been made available yet.",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "format": {
+                            "type": "string",
+                            "description": "Identifier of the document format, exactly as reported by the fiscal authority. The value is provider-defined and its syntax is not guaranteed — it may be a media type such as `application/pdf`, or a mandate-specific format name. The set is not fixed, so treat an unrecognised value as a format this integration has newly made available rather than as an error; match it verbatim rather than parsing it.",
+                            "example": "application/pdf"
+                          },
+                          "downloadUrl": {
+                            "type": "string",
+                            "description": "Signed link that downloads this format. The link expires 24 hours after the response was produced, so it must be followed rather than stored; request the invoice again for a fresh link. The document is fetched from the fiscal authority only when the link is followed, so the download responds with `424 Failed Dependency` when the provider cannot supply the format at that moment."
+                          }
+                        },
+                        "required": [
+                          "format",
+                          "downloadUrl"
+                        ]
+                      }
+                    }
+                  },
+                  "required": [
+                    "status"
+                  ],
+                  "description": "Certification of this invoice with the fiscal authority. Present when the invoice has a fiscal document; omitted entirely for invoices with no fiscal document at all. Presence does not depend on `type` — a fiscalized credit note carries this object exactly as an invoice does."
+                },
                 "lastUpdatedAt": {
                   "type": "string",
                   "format": "date-time",
@@ -63089,6 +63181,28 @@
         }
       }
     },
+    "422": {
+      "schema": {
+        "type": "object",
+        "required": [
+          "message"
+        ],
+        "properties": {
+          "message": {
+            "type": "string"
+          },
+          "errors": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
     "429": {
       "schema": {
         "type": "object",
@@ -63693,6 +63807,52 @@
                   "country"
                 ]
               },
+              "fiscalization": {
+                "type": "object",
+                "properties": {
+                  "status": {
+                    "description": "Certification status of the invoice with its fiscalization integration.\n- **pending**: The fiscal document exists and has been accepted for certification, but the fiscal authority has not yet confirmed it. The document is not yet legally issued.\n- **certified**: The fiscal authority confirmed the document, which is legally issued. `referenceNumber` carries the reference the integration recorded for it. In rare cases a certified document has no recorded reference and `referenceNumber` is absent; this does not resolve on its own and requires operator intervention. A document whose revocation has been requested but not yet confirmed, or whose revocation was rejected, is still `certified` — it remains legally issued until the authority confirms the revocation, at which point it becomes `canceled`.\n- **failed**: Certification did not succeed. Retries are attempted a bounded number of times; a status that remains `failed` requires operator intervention. The fiscal document remains, but no legally issued document exists for it.\n- **canceled**: The document was certified and has since been revoked with the fiscal authority. This is distinct from `failed` — the document was legally issued at some point, and `referenceNumber` keeps the reference the integration had recorded for it.\n",
+                    "type": "string",
+                    "enum": [
+                      "pending",
+                      "certified",
+                      "failed",
+                      "canceled"
+                    ],
+                    "example": "certified"
+                  },
+                  "referenceNumber": {
+                    "type": "string",
+                    "description": "Reference recorded for this document by the fiscalization integration, for correlating it with that integration's own records. For most integrations this is the number assigned by the tax authority; some record a provider-side identifier instead. Treat it as an opaque, integration-defined reference rather than assuming it is the legally issued document number. Once recorded it does not change, including after the document is canceled. Distinct from `externalId`, which is the reference an external accounting or ERP system wrote into the platform. Absent when the integration has recorded no reference."
+                  },
+                  "documents": {
+                    "type": "array",
+                    "description": "Document formats the fiscal authority has made available for this invoice. Omitted while no format has been made available yet.",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "format": {
+                          "type": "string",
+                          "description": "Identifier of the document format, exactly as reported by the fiscal authority. The value is provider-defined and its syntax is not guaranteed — it may be a media type such as `application/pdf`, or a mandate-specific format name. The set is not fixed, so treat an unrecognised value as a format this integration has newly made available rather than as an error; match it verbatim rather than parsing it.",
+                          "example": "application/pdf"
+                        },
+                        "downloadUrl": {
+                          "type": "string",
+                          "description": "Signed link that downloads this format. The link expires 24 hours after the response was produced, so it must be followed rather than stored; request the invoice again for a fresh link. The document is fetched from the fiscal authority only when the link is followed, so the download responds with `424 Failed Dependency` when the provider cannot supply the format at that moment."
+                        }
+                      },
+                      "required": [
+                        "format",
+                        "downloadUrl"
+                      ]
+                    }
+                  }
+                },
+                "required": [
+                  "status"
+                ],
+                "description": "Certification of this invoice with the fiscal authority. Present when the invoice has a fiscal document; omitted entirely for invoices with no fiscal document at all. Presence does not depend on `type` — a fiscalized credit note carries this object exactly as an invoice does."
+              },
               "lastUpdatedAt": {
                 "type": "string",
                 "format": "date-time",
@@ -63760,7 +63920,7 @@
       }
     }
   },
-  "issuesListing": {
+  "invoiceFiscalizationAttemptsListing": {
     "200": {
       "schema": {
         "type": "object",
@@ -63769,159 +63929,404 @@
             "type": "array",
             "items": {
               "type": "object",
-              "description": "Issue resource with full details",
+              "description": "A single fiscalization attempt recorded for this invoice.",
               "properties": {
                 "id": {
                   "type": "integer",
-                  "description": "System-generated unique identifier",
-                  "readOnly": true
-                },
-                "operatorId": {
-                  "type": "integer",
-                  "nullable": true,
-                  "description": "The ID of the operator this resource belongs to",
-                  "example": 1
-                },
-                "title": {
-                  "type": "string",
-                  "description": "Issue title",
-                  "maxLength": 255
+                  "description": "Identifier of this attempt. Stable for the lifetime of the record, so it is what to deduplicate and reconcile on when ingesting attempts, and what to quote when referring to one specific attempt.",
+                  "example": 4211
                 },
-                "description": {
+                "attemptedAt": {
                   "type": "string",
-                  "description": "Detailed issue description (HTML content)"
-                },
-                "resolutionDetails": {
-                  "type": "string",
-                  "description": "Details about how the issue was resolved or why it was closed. Only present when status is resolved, wont_fix, or non_issue."
-                },
-                "status": {
-                  "type": "string",
-                  "enum": [
-                    "auto_recovery_in_progress",
-                    "information_collection_in_progress",
-                    "new",
-                    "investigating",
-                    "resolution_in_progress",
-                    "resolved",
-                    "wont_fix",
-                    "non_issue"
-                  ],
-                  "description": "Issue status:\n- **auto_recovery_in_progress**: Issue is in automatic recovery process (preparation state)\n- **information_collection_in_progress**: System is collecting diagnostic information (preparation state)\n- **new**: Issue has been reported and not yet investigated (open state)\n- **investigating**: Issue is currently being investigated (open state)\n- **resolution_in_progress**: Resolution actions are being applied (open state)\n- **resolved**: Issue has been resolved successfully (closed state)\n- **wont_fix**: Issue will not be fixed (closed state)\n- **non_issue**: Reported issue determined to not be an actual issue (closed state)\n",
-                  "example": "investigating"
-                },
-                "workflowState": {
-                  "readOnly": true,
-                  "description": "Issue workflow state (derived from status):\n- **preparation**: System is performing automatic actions before manual intervention (auto-resolution statuses)\n- **open**: Issue requires attention or is being worked on (new, investigating, resolutionInProgress)\n- **closed**: Issue is no longer active (resolved, wontFix, nonIssue)\n",
-                  "type": "string",
-                  "enum": [
-                    "preparation",
-                    "open",
-                    "closed"
-                  ],
-                  "example": "open"
-                },
-                "category": {
-                  "type": "string",
-                  "enum": [
-                    "network",
-                    "payments_billing",
-                    "product_offerings",
-                    "ev_driver_ux",
-                    "security",
-                    "reporting",
-                    "roaming",
-                    "other"
-                  ],
-                  "description": "Issue category:\n- **network**: Network connectivity or communication issues\n- **payments_billing**: Payment processing or billing-related issues\n- **product_offerings**: Issues with product features or tariff offerings\n- **ev_driver_ux**: EV driver user experience issues\n- **security**: Security-related concerns or incidents\n- **reporting**: Reporting or analytics issues\n- **roaming**: Roaming-related issues\n- **other**: Issues not covered by other categories\n",
-                  "example": "network"
-                },
-                "severity": {
-                  "type": "string",
-                  "enum": [
-                    "severe",
-                    "significant",
-                    "moderate",
-                    "low"
-                  ],
-                  "description": "Issue severity level:\n- **severe**: Critical impact requiring immediate attention\n- **significant**: Major impact affecting important functionality\n- **moderate**: Moderate impact with workaround available\n- **low**: Minor impact with minimal effect on operations\n",
-                  "example": "significant"
-                },
-                "priority": {
-                  "type": "string",
-                  "enum": [
-                    "highest",
-                    "high",
-                    "medium",
-                    "low"
-                  ],
-                  "description": "Issue priority level:\n- **highest**: Must be addressed immediately\n- **high**: Should be addressed as soon as possible\n- **medium**: Should be addressed in normal workflow\n- **low**: Can be addressed when convenient\n",
-                  "example": "high"
-                },
-                "externalId": {
-                  "type": "string",
-                  "description": "External system identifier (UUID format recommended)",
-                  "maxLength": 255
-                },
-                "assigneeAdminId": {
-                  "type": "integer",
-                  "description": "ID of the admin user assigned to this issue"
+                  "format": "date-time",
+                  "description": "The moment the attempt was made."
                 },
-                "partnerId": {
-                  "type": "integer",
-                  "description": "ID of the partner that owns this issue. Present only for partner-scoped issues.",
-                  "readOnly": true
+                "isSuccessful": {
+                  "type": "boolean",
+                  "description": "Whether the attempt succeeded."
                 },
-                "keyResource": {
-                  "type": "object",
-                  "description": "Reference to a related resource (charge point, location, or EVSE)",
-                  "properties": {
-                    "resourceType": {
-                      "type": "string",
-                      "enum": [
-                        "charge-point",
-                        "location",
-                        "evse",
-                        "session",
-                        "integration",
-                        "roaming-cdr",
-                        "roaming-connection"
-                      ],
-                      "description": "Type of resource associated with an issue.\n- **charge-point**: Charge point equipment\n- **location**: Charging location\n- **evse**: Electric Vehicle Supply Equipment (individual charging outlet)\n- **session**: Charging session\n- **integration**: Integration setting (e.g., third-party service configuration)\n- **roaming-cdr**: Roaming charge detail record\n- **roaming-connection**: Roaming connection\n\nNote: Additional types (user) may appear in responses for issues created by automated systems.\n",
-                      "example": "charge-point"
+                "responseFields": {
+                  "type": "array",
+                  "description": "Values the integration publishes for this attempt. Which values appear, their names and their order are integration-defined and not fixed; treat the list as a set to match on rather than a fixed positional structure. Empty when the attempt has none.",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "key": {
+                        "type": "string",
+                        "description": "Name of the returned value, as reported by the integration. The set of names is provider-defined and not fixed.",
+                        "example": "KSeF number"
+                      },
+                      "value": {
+                        "type": "string",
+                        "description": "The returned value."
+                      }
                     },
-                    "id": {
-                      "type": "integer",
-                      "description": "ID of the referenced resource"
-                    }
-                  },
-                  "required": [
-                    "resourceType",
-                    "id"
-                  ]
-                },
-                "createdAt": {
-                  "type": "string",
-                  "format": "date-time",
-                  "readOnly": true
+                    "required": [
+                      "key",
+                      "value"
+                    ]
+                  }
                 },
-                "updatedAt": {
+                "errorMessage": {
                   "type": "string",
-                  "format": "date-time",
-                  "readOnly": true
+                  "description": "Why the attempt did not succeed. Present only for a failed attempt that carries a message."
                 }
               },
               "required": [
                 "id",
-                "operatorId",
-                "title",
-                "status",
-                "workflowState",
-                "category",
-                "severity",
-                "priority",
-                "createdAt",
-                "updatedAt"
+                "attemptedAt",
+                "isSuccessful",
+                "responseFields"
+              ]
+            }
+          },
+          "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"
+          }
+        }
+      }
+    }
+  },
+  "invoiceFiscalizationDocumentDownload": {
+    "403": {
+      "schema": {
+        "type": "object",
+        "required": [
+          "message"
+        ],
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "404": {
+      "schema": {
+        "type": "object",
+        "required": [
+          "message"
+        ],
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "410": {
+      "schema": {
+        "type": "object",
+        "required": [
+          "message"
+        ],
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "424": {
+      "schema": {
+        "type": "object",
+        "required": [
+          "message"
+        ],
+        "properties": {
+          "message": {
+            "type": "string",
+            "example": "The fiscal authority could not provide the requested fiscal document format: document not ready"
+          }
+        }
+      }
+    },
+    "429": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  },
+  "issuesListing": {
+    "200": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "description": "Issue resource with full details",
+              "properties": {
+                "id": {
+                  "type": "integer",
+                  "description": "System-generated unique identifier",
+                  "readOnly": true
+                },
+                "operatorId": {
+                  "type": "integer",
+                  "nullable": true,
+                  "description": "The ID of the operator this resource belongs to",
+                  "example": 1
+                },
+                "title": {
+                  "type": "string",
+                  "description": "Issue title",
+                  "maxLength": 255
+                },
+                "description": {
+                  "type": "string",
+                  "description": "Detailed issue description (HTML content)"
+                },
+                "resolutionDetails": {
+                  "type": "string",
+                  "description": "Details about how the issue was resolved or why it was closed. Only present when status is resolved, wont_fix, or non_issue."
+                },
+                "status": {
+                  "type": "string",
+                  "enum": [
+                    "auto_recovery_in_progress",
+                    "information_collection_in_progress",
+                    "new",
+                    "investigating",
+                    "resolution_in_progress",
+                    "resolved",
+                    "wont_fix",
+                    "non_issue"
+                  ],
+                  "description": "Issue status:\n- **auto_recovery_in_progress**: Issue is in automatic recovery process (preparation state)\n- **information_collection_in_progress**: System is collecting diagnostic information (preparation state)\n- **new**: Issue has been reported and not yet investigated (open state)\n- **investigating**: Issue is currently being investigated (open state)\n- **resolution_in_progress**: Resolution actions are being applied (open state)\n- **resolved**: Issue has been resolved successfully (closed state)\n- **wont_fix**: Issue will not be fixed (closed state)\n- **non_issue**: Reported issue determined to not be an actual issue (closed state)\n",
+                  "example": "investigating"
+                },
+                "workflowState": {
+                  "readOnly": true,
+                  "description": "Issue workflow state (derived from status):\n- **preparation**: System is performing automatic actions before manual intervention (auto-resolution statuses)\n- **open**: Issue requires attention or is being worked on (new, investigating, resolutionInProgress)\n- **closed**: Issue is no longer active (resolved, wontFix, nonIssue)\n",
+                  "type": "string",
+                  "enum": [
+                    "preparation",
+                    "open",
+                    "closed"
+                  ],
+                  "example": "open"
+                },
+                "category": {
+                  "type": "string",
+                  "enum": [
+                    "network",
+                    "payments_billing",
+                    "product_offerings",
+                    "ev_driver_ux",
+                    "security",
+                    "reporting",
+                    "roaming",
+                    "other"
+                  ],
+                  "description": "Issue category:\n- **network**: Network connectivity or communication issues\n- **payments_billing**: Payment processing or billing-related issues\n- **product_offerings**: Issues with product features or tariff offerings\n- **ev_driver_ux**: EV driver user experience issues\n- **security**: Security-related concerns or incidents\n- **reporting**: Reporting or analytics issues\n- **roaming**: Roaming-related issues\n- **other**: Issues not covered by other categories\n",
+                  "example": "network"
+                },
+                "severity": {
+                  "type": "string",
+                  "enum": [
+                    "severe",
+                    "significant",
+                    "moderate",
+                    "low"
+                  ],
+                  "description": "Issue severity level:\n- **severe**: Critical impact requiring immediate attention\n- **significant**: Major impact affecting important functionality\n- **moderate**: Moderate impact with workaround available\n- **low**: Minor impact with minimal effect on operations\n",
+                  "example": "significant"
+                },
+                "priority": {
+                  "type": "string",
+                  "enum": [
+                    "highest",
+                    "high",
+                    "medium",
+                    "low"
+                  ],
+                  "description": "Issue priority level:\n- **highest**: Must be addressed immediately\n- **high**: Should be addressed as soon as possible\n- **medium**: Should be addressed in normal workflow\n- **low**: Can be addressed when convenient\n",
+                  "example": "high"
+                },
+                "externalId": {
+                  "type": "string",
+                  "description": "External system identifier (UUID format recommended)",
+                  "maxLength": 255
+                },
+                "assigneeAdminId": {
+                  "type": "integer",
+                  "description": "ID of the admin user assigned to this issue"
+                },
+                "partnerId": {
+                  "type": "integer",
+                  "description": "ID of the partner that owns this issue. Present only for partner-scoped issues.",
+                  "readOnly": true
+                },
+                "keyResource": {
+                  "type": "object",
+                  "description": "Reference to a related resource (charge point, location, or EVSE)",
+                  "properties": {
+                    "resourceType": {
+                      "type": "string",
+                      "enum": [
+                        "charge-point",
+                        "location",
+                        "evse",
+                        "session",
+                        "integration",
+                        "roaming-cdr",
+                        "roaming-connection"
+                      ],
+                      "description": "Type of resource associated with an issue.\n- **charge-point**: Charge point equipment\n- **location**: Charging location\n- **evse**: Electric Vehicle Supply Equipment (individual charging outlet)\n- **session**: Charging session\n- **integration**: Integration setting (e.g., third-party service configuration)\n- **roaming-cdr**: Roaming charge detail record\n- **roaming-connection**: Roaming connection\n\nNote: Additional types (user) may appear in responses for issues created by automated systems.\n",
+                      "example": "charge-point"
+                    },
+                    "id": {
+                      "type": "integer",
+                      "description": "ID of the referenced resource"
+                    }
+                  },
+                  "required": [
+                    "resourceType",
+                    "id"
+                  ]
+                },
+                "createdAt": {
+                  "type": "string",
+                  "format": "date-time",
+                  "readOnly": true
+                },
+                "updatedAt": {
+                  "type": "string",
+                  "format": "date-time",
+                  "readOnly": true
+                }
+              },
+              "required": [
+                "id",
+                "operatorId",
+                "title",
+                "status",
+                "workflowState",
+                "category",
+                "severity",
+                "priority",
+                "createdAt",
+                "updatedAt"
               ]
             }
           },
@@ -124075,8 +124480,8 @@
                   "description": "Whether incremental pre-authorizations are active for this session.\n`true` when all preconditions are met: feature flag enabled, incremental pre-authorizations enabled in settings, billing strategy supports pre-authorization, and the session has an active pre-authorization with a PSP that supports incremental authorization.\n`false` in all other cases, including sessions without pre-authorization and completed sessions.\n"
                 },
                 "customFields": {
+                  "description": "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 session are omitted. The `customFields` property itself is omitted when no fields apply.\n",
                   "type": "object",
-                  "description": "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 JSON number; 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 session are omitted. The `customFields` property itself is omitted when no fields apply.\n",
                   "additionalProperties": true
                 }
               },
@@ -125342,8 +125747,8 @@
                 "description": "Whether incremental pre-authorizations are active for this session.\n`true` when all preconditions are met: feature flag enabled, incremental pre-authorizations enabled in settings, billing strategy supports pre-authorization, and the session has an active pre-authorization with a PSP that supports incremental authorization.\n`false` in all other cases, including sessions without pre-authorization and completed sessions.\n"
               },
               "customFields": {
+                "description": "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 session are omitted. The `customFields` property itself is omitted when no fields apply.\n",
                 "type": "object",
-                "description": "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 JSON number; 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 session are omitted. The `customFields` property itself is omitted when no fields apply.\n",
                 "additionalProperties": true
               },
               "durationBreakdown": {
@@ -125642,6 +126047,1168 @@
       }
     }
   },
+  "sessionUpdate": {
+    "200": {
+      "schema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "object",
+            "description": "Charging session",
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "operatorId": {
+                "type": "integer",
+                "description": "The ID of the operator this resource belongs to",
+                "example": 1
+              },
+              "chargePointId": {
+                "type": "integer"
+              },
+              "evseId": {
+                "type": "integer"
+              },
+              "connectorId": {
+                "type": "integer",
+                "nullable": true
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "unknown",
+                  "pending",
+                  "active",
+                  "finished",
+                  "failed",
+                  "expired"
+                ],
+                "description": "Charging session status:\n- **unknown**: Session status could not be determined\n- **pending**: Session is pending and has not started yet\n- **active**: Session is currently in progress\n- **finished**: Session has completed successfully\n- **failed**: Session has failed\n- **expired**: Session has expired\n",
+                "example": "finished"
+              },
+              "reason": {
+                "type": "string",
+                "enum": [
+                  "working_hours_exceeded",
+                  "timeout",
+                  "authorization_amount_reached",
+                  "new_start_transaction_received",
+                  "force_stop",
+                  "standard_stop",
+                  "energy_exceeded",
+                  "schedule_completed",
+                  "pre_authorization_failed",
+                  "system_force_stop",
+                  "time_limit",
+                  "balance_exceeded",
+                  "deauthorized",
+                  "emergencystop",
+                  "energylimitreached",
+                  "evdisconnected",
+                  "groundfault",
+                  "immediatereset",
+                  "hardreset",
+                  "local",
+                  "localoutofcredit",
+                  "masterpass",
+                  "other",
+                  "plug_and_charge",
+                  "overcurrentfault",
+                  "powerloss",
+                  "powerquality",
+                  "reboot",
+                  "remote",
+                  "soclimitreached",
+                  "stoppedbyev",
+                  "timeoutlimitreached",
+                  "softreset",
+                  "unlockcommand",
+                  "no_ev_parked",
+                  "no_ev_connected",
+                  "charge_point_timeout",
+                  "charging_on_evse_not_allowed",
+                  "remote_start_failed",
+                  "no_user_for_agile_streets",
+                  "rejected",
+                  "canceled_reservation",
+                  "evse_occupied",
+                  "evse_inoperative",
+                  "failed",
+                  "not_supported",
+                  "unknown_reservation",
+                  "ev_not_connected_to_evse",
+                  "authorization_failed",
+                  "unknown_session"
+                ],
+                "description": "The reason why the session expired or has been stopped."
+              },
+              "userId": {
+                "type": "integer",
+                "nullable": true,
+                "description": "The id of the user that started the session"
+              },
+              "vehicleId": {
+                "type": "integer",
+                "description": "ID of the vehicle associated with the session."
+              },
+              "bookingId": {
+                "type": "integer",
+                "description": "The ID of the linked booking (if any)"
+              },
+              "startedAt": {
+                "type": "string",
+                "format": "date-time"
+              },
+              "startedOffline": {
+                "type": "boolean",
+                "description": "Indicates whether the session was started while the charge point was offline."
+              },
+              "stoppedAt": {
+                "type": "string",
+                "format": "date-time",
+                "nullable": true
+              },
+              "energy": {
+                "deprecated": true,
+                "type": "number",
+                "description": "Delivered energy in Wh"
+              },
+              "powerKw": {
+                "deprecated": true,
+                "type": "number",
+                "description": "This field representing the current charging speed in kilowatts is deprecated. Use the `power.latest` property instead for charging power information."
+              },
+              "socPercent": {
+                "type": "number",
+                "description": "State of charge (in %). Optional."
+              },
+              "amount": {
+                "type": "number",
+                "format": "decimal",
+                "nullable": true,
+                "deprecated": true
+              },
+              "totalAmount": {
+                "type": "object",
+                "nullable": true,
+                "properties": {
+                  "withTax": {
+                    "type": "number"
+                  },
+                  "withoutTax": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "withTax"
+                ]
+              },
+              "corporateBilling": {
+                "type": "object",
+                "description": "Corporate billing breakdown for the session. This object and the related corporate-billing fields are part of the experimental corporate-billing feature surface. While that feature is experimental, these fields may change in place without a version bump. Consumers should treat these fields as evaluation-only unless coordinated with their account manager.\n",
+                "properties": {
+                  "policySnapshotId": {
+                    "type": "integer",
+                    "description": "Corporate billing policy snapshot used for the session."
+                  },
+                  "chargerType": {
+                    "type": "string",
+                    "enum": [
+                      "ac",
+                      "dc"
+                    ],
+                    "description": "Type of current available on the EVSE:\n- **ac**: Alternating Current (AC) charging\n- **dc**: Direct Current (DC) fast charging\n"
+                  },
+                  "chargerTypeCoverageType": {
+                    "type": "string",
+                    "enum": [
+                      "full_coverage",
+                      "limited_coverage",
+                      "not_covered"
+                    ],
+                    "description": "Charger type coverage type:\n- **full_coverage**: The policy covers eligible costs for this charger type without tariff thresholds\n- **limited_coverage**: The policy covers eligible costs for this charger type only within configured limits\n- **not_covered**: The policy does not cover sessions on this charger type\n"
+                  },
+                  "corporateAmount": {
+                    "description": "Tax-aware amount billed to the corporate coverage order, with gross and net totals from the order.",
+                    "type": "object",
+                    "properties": {
+                      "withTax": {
+                        "type": "number"
+                      },
+                      "withoutTax": {
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "withTax"
+                    ]
+                  },
+                  "driverAmount": {
+                    "description": "Tax-aware amount billed to the EV driver's excess order, with gross and net totals from the order.",
+                    "type": "object",
+                    "properties": {
+                      "withTax": {
+                        "type": "number"
+                      },
+                      "withoutTax": {
+                        "type": "number"
+                      }
+                    },
+                    "required": [
+                      "withTax"
+                    ]
+                  },
+                  "blendedCostPerKwh": {
+                    "type": "number",
+                    "format": "decimal",
+                    "description": "Session's computed blended cost per kWh."
+                  },
+                  "isOverallCostCapApplied": {
+                    "type": "boolean",
+                    "description": "Whether the policy's overall cost-per-kWh cap reduced coverage."
+                  },
+                  "restrictionCause": {
+                    "description": "Corporate billing restriction dimension that withheld coverage for the session:\n- **partner**: A partner restriction prevented corporate billing from covering the session\n- **country**: A country restriction prevented corporate billing from covering the session\n- **location**: A location restriction prevented corporate billing from covering the session\n- **location_tag**: A location tag restriction prevented corporate billing from covering the session\n- **roaming**: A roaming restriction prevented corporate billing from covering the session\n",
+                    "type": "string",
+                    "enum": [
+                      "partner",
+                      "country",
+                      "location",
+                      "location_tag",
+                      "roaming"
+                    ]
+                  },
+                  "breakdown": {
+                    "type": "array",
+                    "description": "Per-component tax-aware amounts for public corporate billing component types only: energy, idle_time, connection, and charging_time. The corporateAmount and driverAmount fields are gross and net totals sourced from matching corporate coverage and EV driver excess order items. Other persisted fee types, such as min_price, are not included, so this breakdown can be partial and may not sum to the order-level corporateAmount and driverAmount totals.\n",
+                    "items": {
+                      "type": "object",
+                      "description": "Per-component tax-aware corporate billing amounts for one supported public corporate billing component type.",
+                      "properties": {
+                        "componentType": {
+                          "type": "string",
+                          "enum": [
+                            "energy",
+                            "idle_time",
+                            "connection",
+                            "charging_time"
+                          ],
+                          "description": "Corporate billing tariff component type:\n- **energy**: Energy charges based on consumed kWh\n- **idle_time**: Idle-time charges after charging has stopped or exceeded the configured idle threshold\n- **connection**: Connection charges for starting or maintaining the session connection\n- **charging_time**: Charging-time charges based on the active charging duration\n"
+                        },
+                        "corporateAmount": {
+                          "description": "Tax-aware component amount billed to the corporate coverage order, with gross and net totals from matching order items.",
+                          "type": "object",
+                          "properties": {
+                            "withTax": {
+                              "type": "number"
+                            },
+                            "withoutTax": {
+                              "type": "number"
+                            }
+                          },
+                          "required": [
+                            "withTax"
+                          ]
+                        },
+                        "driverAmount": {
+                          "description": "Tax-aware component amount billed to the EV driver's excess order, with gross and net totals from matching order items.",
+                          "type": "object",
+                          "properties": {
+                            "withTax": {
+                              "type": "number"
+                            },
+                            "withoutTax": {
+                              "type": "number"
+                            }
+                          },
+                          "required": [
+                            "withTax"
+                          ]
+                        }
+                      },
+                      "required": [
+                        "componentType",
+                        "corporateAmount",
+                        "driverAmount"
+                      ]
+                    }
+                  }
+                },
+                "required": [
+                  "policySnapshotId"
+                ]
+              },
+              "discounts": {
+                "type": "array",
+                "description": "Per-type discount breakdown for the session, aggregated across all price-breakdown rows. Omitted when no discount data is available.",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "type": {
+                      "type": "string",
+                      "enum": [
+                        "subsidy",
+                        "corporate"
+                      ],
+                      "description": "Type of an individual discount entry.\n- **subsidy**: energy-fee subsidy when the unit price exceeds a configured threshold.\n- **corporate**: percentage discount tied to a corporate billing arrangement.\n",
+                      "example": "subsidy"
+                    },
+                    "amount": {
+                      "type": "object",
+                      "properties": {
+                        "withTax": {
+                          "type": "number"
+                        },
+                        "withoutTax": {
+                          "type": "number"
+                        }
+                      },
+                      "required": [
+                        "withTax"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "type",
+                    "amount"
+                  ]
+                }
+              },
+              "tax": {
+                "type": "object",
+                "nullable": true,
+                "deprecated": true,
+                "properties": {
+                  "taxId": {
+                    "type": "integer"
+                  },
+                  "taxPercentage": {
+                    "type": "number",
+                    "format": "decimal"
+                  }
+                }
+              },
+              "currency": {
+                "type": "string",
+                "minLength": 3,
+                "maxLength": 3,
+                "description": "The ISO 4217 3-letter code of the currency"
+              },
+              "paymentType": {
+                "type": "string",
+                "enum": [
+                  "tokenized",
+                  "subscription",
+                  "balance",
+                  "corporate",
+                  "terminal",
+                  "bank_transfer"
+                ]
+              },
+              "paymentMethodId": {
+                "type": "string",
+                "description": "The ID of the payment method. Mind that this is actually a string. It can be, for example `corporate:1234` - for corporate billing, or `balance`, or `subscription` - when the session is to be paid with the user's post-paid subscription.",
+                "nullable": true
+              },
+              "terminalId": {
+                "type": "integer",
+                "description": "The ID of the payment terminal when such is used.",
+                "nullable": true
+              },
+              "nonBillableEnergy": {
+                "type": "number",
+                "description": "The energy that is included as an allowance for pre-paid and post subscriptions."
+              },
+              "paymentStatus": {
+                "type": "string",
+                "nullable": true,
+                "enum": [
+                  "pending",
+                  "paid",
+                  "partially",
+                  "failed",
+                  null
+                ]
+              },
+              "authorizationId": {
+                "nullable": true,
+                "type": "integer"
+              },
+              "idTag": {
+                "type": "string",
+                "description": "The idTag defines the authentication source for the session (RFID identifier or remote start identifier)\nA remote start identifier has the format `*XXXXXXX` where the `XXXXXXX` is the session id padded with `0`s on the left\n"
+              },
+              "idTagLabel": {
+                "type": "string",
+                "description": "Additional information about the idTag that differs depending on the type of the idTag or could be something else, related to the car or the user."
+              },
+              "idTagType": {
+                "type": "string",
+                "nullable": true,
+                "enum": [
+                  "rfid",
+                  "emaid",
+                  "mac_address"
+                ],
+                "description": "The type of identifier used for authentication. Returns 'rfid' for standard RFID card identifiers, 'emaid' for E-Mobility Account Identifiers used by ISO15118 Plug&Charge, or 'mac_address' for MAC addresses used by Autocharge."
+              },
+              "extendingSessionId": {
+                "deprecated": true,
+                "type": "integer",
+                "nullable": true,
+                "description": "When a session is finished (because connectivity was lost for a long time) and more data is received, the\nadditional data is stored in an extending session. If this property is set, then this is an extending session.\n"
+              },
+              "originalSessionId": {
+                "type": "integer",
+                "description": "ID of the session that the current session is extending."
+              },
+              "extendedBySessionId": {
+                "type": "integer",
+                "description": "ID of the session that extends this session."
+              },
+              "reimbursementEligibility": {
+                "type": "boolean"
+              },
+              "externalSessionId": {
+                "deprecated": true,
+                "nullable": true,
+                "type": "string",
+                "description": "Deprecated: Use `idTag` field instead. This field will be removed in a future version.\nPreviously used for admin-started sessions, this value is now available in the `idTag` field.\n"
+              },
+              "authorization": {
+                "type": "object",
+                "description": "Session authorization.\n\nEmbedded as the `authorization` property in Session responses when the `withAuthorization` parameter\nis enabled, and always embedded in session webhook notifications for sessions that have an\nauthorization.\n",
+                "properties": {
+                  "id": {
+                    "type": "integer"
+                  },
+                  "operatorId": {
+                    "type": "integer",
+                    "nullable": true,
+                    "description": "The ID of the operator this resource belongs to",
+                    "example": 1
+                  },
+                  "method": {
+                    "description": "The method used to authorize the charging session.\n- `user_device` - Authorization via mobile app or web portal\n- `rfid_tag` - Authorization via physical RFID card\n- `mac_address` - Authorization via vehicle MAC address (AutoCharge)\n- `admin` - Manual authorization by admin user\n- `plug_and_charge` - Authorization via Plug & Charge\n- `plug_and_charge_iso15118` - Authorization via ISO 15118 Plug & Charge\n- `payment_terminal` - Authorization via payment terminal\n- `mobile_app` - Authorization received from a roaming platform via OCPI\n",
+                    "type": "string",
+                    "enum": [
+                      "user_device",
+                      "rfid_tag",
+                      "mac_address",
+                      "admin",
+                      "plug_and_charge",
+                      "plug_and_charge_iso15118",
+                      "payment_terminal",
+                      "mobile_app"
+                    ]
+                  },
+                  "source": {
+                    "description": "The origin of the authorization request.\n- `local` - Authorization initiated directly on this platform\n- `roaming` - Authorization received from a roaming platform (OCPI/Hubject). OCPI authorizations report the method as `mobile_app`.\n- `third_party` - Authorization initiated by a third-party authority\n",
+                    "type": "string",
+                    "enum": [
+                      "local",
+                      "roaming",
+                      "third_party"
+                    ]
+                  },
+                  "createdAt": {
+                    "type": "string",
+                    "format": "date-time"
+                  },
+                  "createdAtLocal": {
+                    "type": "string",
+                    "format": "date-time",
+                    "description": "The creation time in the local time zone of the charge point, falling back to the operator's default time zone."
+                  },
+                  "status": {
+                    "description": "The status of the authorization request.\n- `accepted` - Authorization was approved and the user can start charging\n- `rejected` - Authorization was denied and the user cannot charge\n- `pending` - Authorization is awaiting approval or validation\n",
+                    "type": "string",
+                    "enum": [
+                      "accepted",
+                      "rejected",
+                      "pending"
+                    ]
+                  },
+                  "rejectionReason": {
+                    "type": "string",
+                    "nullable": true,
+                    "description": "The reason for rejecting the authorization. `null` unless status is `rejected`."
+                  },
+                  "userId": {
+                    "type": "integer",
+                    "nullable": true,
+                    "description": "The user that is authorized. `null` when the authorization is not linked to a local user."
+                  },
+                  "rfidTagUid": {
+                    "type": "string",
+                    "nullable": true,
+                    "description": "The UID of the identification tag that created the authorization. Only populated when source is\n`local` or `third_party`; `null` for roaming authorizations, whose token details are in the `roaming`\nobject.\n"
+                  },
+                  "roaming": {
+                    "description": "In case source is `roaming`, this object describes the EMSP that gave the authorization",
+                    "type": "object",
+                    "properties": {
+                      "platformId": {
+                        "description": "The roaming platform ID that gave the authorization",
+                        "type": "integer"
+                      },
+                      "platformRoleId": {
+                        "description": "The role that gave the authorization (the EMSP)",
+                        "type": "integer"
+                      },
+                      "platformRole": {
+                        "description": "The role identifier",
+                        "type": "string"
+                      },
+                      "reference": {
+                        "description": "OCPI's authorization_reference, or Hubject's SessionID",
+                        "type": "string"
+                      },
+                      "client": {
+                        "description": "OCPI's contractId, or Hubject's EVCO ID",
+                        "type": "string"
+                      },
+                      "uid": {
+                        "description": "OCPI's token UID, as recorded at the moment the authorization was created. Absent for Hubject\nauthorizations and for authorizations created before the identifiers were recorded.\n",
+                        "type": "string"
+                      },
+                      "visualNumber": {
+                        "description": "OCPI's token visual_number, as recorded at the moment the authorization was created. Absent for\nHubject authorizations, for authorizations created before the identifiers were recorded, and when\nthe roaming platform did not provide a visual number.\n",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "platformId",
+                      "platformRoleId",
+                      "platformRole",
+                      "reference",
+                      "client"
+                    ]
+                  },
+                  "lastUpdatedAt": {
+                    "type": "string",
+                    "format": "date-time",
+                    "description": "ISO 8601 formatted date",
+                    "readOnly": true
+                  }
+                },
+                "required": [
+                  "id",
+                  "method",
+                  "source",
+                  "createdAt",
+                  "status",
+                  "rejectionReason",
+                  "userId",
+                  "rfidTagUid",
+                  "lastUpdatedAt"
+                ]
+              },
+              "chargingPeriods": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "description": "Describes a period in the session that is billed separately, for example charging@night (for time of day tariffs) or idle (for tariffs that charge separately idle time)",
+                  "properties": {
+                    "id": {
+                      "type": "integer"
+                    },
+                    "energy": {
+                      "type": "integer",
+                      "description": "Delivered energy in Wh"
+                    },
+                    "energyPrecise": {
+                      "type": "number",
+                      "nullable": true,
+                      "description": "Delivered energy in Wh with decimal precision"
+                    },
+                    "startedAt": {
+                      "type": "string",
+                      "format": "date-time"
+                    },
+                    "stoppedAt": {
+                      "type": "string",
+                      "format": "date-time",
+                      "nullable": true
+                    },
+                    "state": {
+                      "deprecated": true,
+                      "type": "string",
+                      "example": [
+                        "charging",
+                        "charging@night",
+                        "charging@day",
+                        "idle",
+                        "idle@day",
+                        "idle@night",
+                        "charging@boosted",
+                        "charging@optimised"
+                      ],
+                      "description": "The state of the period. A non exhaustive list of possible values:\n  * `charging` - the vehicle was charging\n  * `charging@night` - a ToD tariff was selected and the vehicle was charging during the nighttime period of the tariff\n  * `charging@day` - a ToD tariff was selected and the vehicle was charging during the daytime period of the tariff\n  * `idle` - a tariff with separate pricing for idle time was selected and the charging was idle in that period\n  * `idle@night` - a ToD tariff was selected and the vehicle was idling during the nighttime period of the tariff\n  * `idle@day` - a ToD tariff was selected and the vehicle was idling during the daytime period of the tariff\n  * `charging@boosted` - Optimised dynamic pricing was applied and charging was performed with full available power\n  * `charging@optimised` - Optimised dynamic pricing was applied and charging was performed with lower price and limited power during peak hours\n"
+                    },
+                    "chargingState": {
+                      "type": "string",
+                      "enum": [
+                        "charging",
+                        "idle"
+                      ],
+                      "description": "The charging state of the period."
+                    },
+                    "graceTimeEndAt": {
+                      "type": "string",
+                      "format": "date-time",
+                      "description": "When the idle fee grace period expires for this charging period. Present only on idle charging periods that have a grace period configured."
+                    },
+                    "pricingDetails": {
+                      "description": "Optional pricing details specific to this charging period, dependent on the tariff.",
+                      "type": "object",
+                      "properties": {
+                        "chargingType": {
+                          "type": "string",
+                          "enum": [
+                            "boosted",
+                            "optimised"
+                          ],
+                          "nullable": true,
+                          "description": "Power delivery strategy used during this period.\n  * `boosted` - maximum available power delivery\n  * `optimised` - reduced power during peak hours for cost efficiency\n"
+                        },
+                        "dayPeriod": {
+                          "type": "string",
+                          "nullable": true,
+                          "enum": [
+                            "day",
+                            "night"
+                          ],
+                          "description": "The period of the day.\n  * `day` - daytime period of the tariff\n  * `night` - nighttime period of the tariff\n"
+                        },
+                        "pricingMethod": {
+                          "type": "string",
+                          "nullable": true,
+                          "enum": [
+                            "duration",
+                            "energy",
+                            "durationAndEnergy",
+                            "free"
+                          ],
+                          "description": "The method used for calculating price in standard tariffs.\n  * `duration` - pricing based on duration\n  * `energy` - pricing based on energy consumption\n  * `durationAndEnergy` - pricing based on both duration and energy\n  * `free` - free period with no charge\n"
+                        },
+                        "price": {
+                          "type": "number",
+                          "format": "decimal",
+                          "description": "Base price rate for Energy Time of Usage tariffs"
+                        },
+                        "markup": {
+                          "type": "number",
+                          "format": "decimal",
+                          "description": "Additional percentage or fixed amount added to the base price"
+                        },
+                        "initialEnergyPrice": {
+                          "type": "number",
+                          "format": "decimal",
+                          "description": "Starting price rate for energy-based charging"
+                        },
+                        "initialDurationPrice": {
+                          "type": "number",
+                          "format": "decimal",
+                          "description": "Starting price rate for time-based charging"
+                        },
+                        "startHour": {
+                          "type": "string",
+                          "description": "The start hour for the charging period"
+                        },
+                        "endHour": {
+                          "type": "string",
+                          "description": "The end hour for the charging period"
+                        },
+                        "day": {
+                          "type": "string",
+                          "description": "The day being used"
+                        }
+                      }
+                    },
+                    "amount": {
+                      "type": "number",
+                      "format": "decimal",
+                      "nullable": true,
+                      "deprecated": true
+                    },
+                    "totalAmount": {
+                      "type": "object",
+                      "properties": {
+                        "withTax": {
+                          "type": "number"
+                        },
+                        "withoutTax": {
+                          "type": "number"
+                        }
+                      },
+                      "required": [
+                        "withTax"
+                      ]
+                    },
+                    "priceBreakdown": {
+                      "type": "array",
+                      "items": {
+                        "description": "Charging period price breakdown",
+                        "$ref": "#/components/schemas/Session"
+                      },
+                      "description": "A breakdown of the different tariff elements that create the total amount of the charging period. Only sent when `withChargingPeriodsPriceBreakdown` is set to `true`. The priceBreakdown will be displayed only when the Billing status of the session is marked as completed."
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "energy",
+                    "startedAt",
+                    "state"
+                  ]
+                }
+              },
+              "priceBreakdown": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "type": {
+                      "type": "string",
+                      "enum": [
+                        "flat",
+                        "connection",
+                        "energy",
+                        "charging_time",
+                        "idle_time",
+                        "power_levels_time",
+                        "min_price",
+                        "service_fee",
+                        "energy_flat_fee",
+                        "duration_flat_fee",
+                        "idle_flat_fee"
+                      ],
+                      "description": "* `flat` - no matter the duration or energy consumed each session would cost one and the same amount,\n* `connection` - a fixed fee that is applied at the start of the charging session,\n* `energy` - the cost for the consumed energy,\n* `charging_time` - the cost for the duration of the session when there is ongoing charging,\n* `idle_time` - the cost for the time when there is no active charging but there is an ongoing session,\n* `power_levels_time` - the cost for peak and average power levels,\n* `min_price` - the minimum price a session should cost, anything below that price is rounded up to the minimum price,\n* `service_fee` - the cost for the mark up,\n* `energy_flat_fee` - a fixed fee applied per energy component,\n* `duration_flat_fee` - a fixed fee applied per duration component,\n* `idle_flat_fee` - a fixed fee applied per idle component.\n"
+                    },
+                    "currency": {
+                      "type": "string",
+                      "example": "EUR",
+                      "minLength": 3,
+                      "maxLength": 3,
+                      "description": "3-letter currency code (ISO 4217)"
+                    },
+                    "unit": {
+                      "type": "string",
+                      "enum": [
+                        "kwh",
+                        "minute",
+                        "session"
+                      ],
+                      "description": "The measure that is used for the type element."
+                    },
+                    "pricePerUnit": {
+                      "description": "The price of a single unit of the tariff element.",
+                      "type": "object",
+                      "properties": {
+                        "withTax": {
+                          "type": "number"
+                        },
+                        "withoutTax": {
+                          "type": "number"
+                        }
+                      },
+                      "required": [
+                        "withTax"
+                      ]
+                    },
+                    "quantity": {
+                      "type": "number",
+                      "format": "decimal",
+                      "description": "The number of units."
+                    },
+                    "price": {
+                      "description": "The `pricePerUnit` multiplied by the `quantity`.",
+                      "type": "object",
+                      "properties": {
+                        "withTax": {
+                          "type": "number"
+                        },
+                        "withoutTax": {
+                          "type": "number"
+                        }
+                      },
+                      "required": [
+                        "withTax"
+                      ]
+                    },
+                    "taxPercentage": {
+                      "type": "number",
+                      "nullable": true,
+                      "format": "decimal",
+                      "description": "The tax rate percentage applied to this tariff element."
+                    },
+                    "totalPrice": {
+                      "type": "number",
+                      "format": "decimal",
+                      "description": "The `unitPrice` multiplied by the `quantity`.",
+                      "deprecated": true
+                    },
+                    "unitPrice": {
+                      "type": "number",
+                      "format": "decimal",
+                      "description": "The price of a single unit of the tariff element.",
+                      "deprecated": true
+                    },
+                    "discounts": {
+                      "type": "array",
+                      "description": "Per-type discount breakdown for this row. Omitted when no discount data is available.\n",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "type": {
+                            "type": "string",
+                            "enum": [
+                              "subsidy",
+                              "corporate"
+                            ],
+                            "description": "Type of an individual discount entry.\n- **subsidy**: energy-fee subsidy when the unit price exceeds a configured threshold.\n- **corporate**: percentage discount tied to a corporate billing arrangement.\n",
+                            "example": "subsidy"
+                          },
+                          "amount": {
+                            "type": "object",
+                            "properties": {
+                              "withTax": {
+                                "type": "number"
+                              },
+                              "withoutTax": {
+                                "type": "number"
+                              }
+                            },
+                            "required": [
+                              "withTax"
+                            ]
+                          }
+                        },
+                        "required": [
+                          "type",
+                          "amount"
+                        ]
+                      }
+                    }
+                  },
+                  "required": [
+                    "type",
+                    "currency",
+                    "price",
+                    "quantity",
+                    "pricePerUnit",
+                    "unit",
+                    "totalPrice",
+                    "unitPrice"
+                  ]
+                },
+                "description": "A breakdown of the different tariff elements that create the total amount of the charging session. Only sent when `session_with_price_breakdown` is set to `true`. The priceBreakdown will be displayed only when the Billing status of the session is marked as completed."
+              },
+              "tariffSnapshotId": {
+                "type": "integer",
+                "nullable": true,
+                "description": "At the start of the charging session the tariff will be snapshotted and that snapshot will not be changed ever. That snapshot is used to determine the price of the charging session. This is the ID of that snapshot.\n"
+              },
+              "electricityCost": {
+                "type": "number",
+                "format": "decimal",
+                "nullable": true
+              },
+              "evsePhysicalReference": {
+                "type": "string",
+                "description": "This could be either the identifier that is presented to the user, so they can identify the EVSE at the location. Or for roaming EVSEs - it is the roaming evse_id.\n",
+                "nullable": true
+              },
+              "paymentStatusUpdatedAt": {
+                "type": "string",
+                "nullable": true,
+                "format": "date-time",
+                "description": "ISO 8601 formatted date",
+                "readOnly": true
+              },
+              "chargePointOperatorRoamingId": {
+                "type": "string",
+                "description": "The roaming operator identifier (e.g., \"DE*ENA\", \"LT*IGN\") of the operator who owns the charge point where the session occurred. Only returned for roaming sessions."
+              },
+              "roaming": {
+                "type": "object",
+                "properties": {
+                  "cdrIds": {
+                    "type": "array",
+                    "description": "The CDRs that are generated for roaming sessions.",
+                    "items": {
+                      "type": "integer"
+                    }
+                  },
+                  "sessionId": {
+                    "type": "string",
+                    "description": "The unique id that identifies the charging session in the CPO platform."
+                  },
+                  "roamingOperatorCpoId": {
+                    "type": "integer",
+                    "description": "The id of the roaming operator that owns the charge point at which the session occurred."
+                  },
+                  "cpoLastUpdatedAt": {
+                    "type": "string",
+                    "format": "date-time",
+                    "description": "Applicable only for OCPI sessions and populated with the most recent shared `last_updated` value from the CPO roaming operator. ISO 8601 formatted date",
+                    "readOnly": true
+                  }
+                }
+              },
+              "lastUpdatedAt": {
+                "type": "string",
+                "format": "date-time",
+                "description": "ISO 8601 formatted date",
+                "readOnly": true
+              },
+              "randomisedDelay": {
+                "type": "integer",
+                "description": "Number of seconds by which current offering is being delayed at the start of the session. The field is omitted when randomised delay is not enabled in the Personal Charging settings or when there is no randomised delay."
+              },
+              "receiptId": {
+                "deprecated": true,
+                "type": "integer",
+                "nullable": true
+              },
+              "externalAppData": {
+                "description": "Used to hold any external application data related to the session.",
+                "type": "object",
+                "nullable": true,
+                "additionalProperties": true
+              },
+              "clockAlignedEnergyConsumption": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "description": "Session Clock aligned consumption period",
+                  "properties": {
+                    "start": {
+                      "type": "string",
+                      "format": "date-time",
+                      "description": "The beginning of the clock-aligned consumption period."
+                    },
+                    "end": {
+                      "type": "string",
+                      "format": "date-time",
+                      "description": "The end of the clock-aligned consumption period."
+                    },
+                    "energyConsumed": {
+                      "deprecated": true,
+                      "type": "integer",
+                      "description": "The amount of total consumed energy(Wh) during the clock-aligned consumption period."
+                    },
+                    "energyConsumption": {
+                      "type": "object",
+                      "properties": {
+                        "total": {
+                          "type": "number",
+                          "description": "The amount of total consumed energy (Wh) during the clock-aligned consumption period."
+                        },
+                        "local": {
+                          "type": "number",
+                          "description": "The amount of consumed renewable energy (Wh) generated by individual source for the specified clock-aligned consumption period."
+                        },
+                        "grid": {
+                          "type": "number",
+                          "description": "The amount of consumed energy (Wh) delivered from the grid for the specified clock-aligned consumption period."
+                        }
+                      },
+                      "required": [
+                        "total",
+                        "grid"
+                      ]
+                    },
+                    "totalCost": {
+                      "type": "object",
+                      "description": "The total cost of energy consumption during the clock-aligned period.",
+                      "properties": {
+                        "withTax": {
+                          "type": "number",
+                          "description": "Total cost including tax."
+                        },
+                        "withoutTax": {
+                          "type": "number",
+                          "description": "Total cost excluding tax."
+                        }
+                      },
+                      "required": [
+                        "withTax"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "start",
+                    "end",
+                    "energyConsumed",
+                    "energyConsumption"
+                  ]
+                },
+                "description": "Energy consumption during time intervals (15, 30 or 60 minutes) in the charging session. The start of the first interval is the start of the session then the intervals are defined by the exact minute of the hour. Clock-aligned consumption periods are included in the response only when the query param 'withClockAlignedEnergyConsumption' is set to 'true'."
+              },
+              "energyConsumption": {
+                "type": "object",
+                "properties": {
+                  "total": {
+                    "type": "number",
+                    "description": "Delivered energy (Wh)"
+                  },
+                  "local": {
+                    "type": "number",
+                    "description": "The amount of consumed renewable energy (Wh) generated by individual source for all clock-aligned consumption periods in the charging session."
+                  },
+                  "grid": {
+                    "type": "number",
+                    "description": "The amount of consumed energy (Wh) delivered from the grid for all clock-aligned consumption periods in the charging session."
+                  }
+                },
+                "required": [
+                  "total",
+                  "grid"
+                ]
+              },
+              "estimatedSavings": {
+                "type": "number",
+                "description": "The sum of savings that could be achieved if the consumed energy was not locally generated but delivered from the grid for all clock-aligned consumption periods in the charging session."
+              },
+              "billingStatus": {
+                "type": "string",
+                "description": "The status of the billing process for the session.",
+                "nullable": true,
+                "enum": [
+                  "pending",
+                  "suspended",
+                  "completed",
+                  null
+                ]
+              },
+              "billingCompletedAt": {
+                "type": "string",
+                "format": "date-time",
+                "description": "The timestamp when session billing was completed. Only present when billing has completed, omitted otherwise."
+              },
+              "power": {
+                "type": "object",
+                "properties": {
+                  "latest": {
+                    "type": "number",
+                    "nullable": true,
+                    "description": "The current charging power (in watts)"
+                  },
+                  "peak": {
+                    "type": "number",
+                    "nullable": true,
+                    "description": "The maximum charging power (in watts) reached during the session"
+                  },
+                  "average": {
+                    "type": "number",
+                    "nullable": true,
+                    "description": "The average charging power (in watts) maintained during the session"
+                  },
+                  "offered": {
+                    "type": "number",
+                    "nullable": true,
+                    "description": "The power offered by the EVSE to the vehicle (in watts)"
+                  }
+                }
+              },
+              "preAuthorizedAmount": {
+                "type": "number",
+                "description": "The total amount currently held (authorized) on the user's payment method for this session, in the session's currency.\nOmitted when no active pre-authorization exists for this session (billing strategy does not use pre-authorization, authorization not yet placed, or already captured/voided at session end).\nPresent and greater than 0 when an authorization is held. For incremental sessions this is the sum of the initial authorization and all successful increments; for non-incremental sessions this is the initial authorized amount.\n"
+              },
+              "incrementalPreAuthorizationEnabled": {
+                "type": "boolean",
+                "description": "Whether incremental pre-authorizations are active for this session.\n`true` when all preconditions are met: feature flag enabled, incremental pre-authorizations enabled in settings, billing strategy supports pre-authorization, and the session has an active pre-authorization with a PSP that supports incremental authorization.\n`false` in all other cases, including sessions without pre-authorization and completed sessions.\n"
+              },
+              "customFields": {
+                "description": "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 session are omitted. The `customFields` property itself is omitted when no fields apply.\n",
+                "type": "object",
+                "additionalProperties": true
+              }
+            },
+            "required": [
+              "id",
+              "operatorId",
+              "status",
+              "userId",
+              "authorizationId",
+              "energy",
+              "energyConsumption",
+              "chargePointId",
+              "evseId",
+              "startedAt",
+              "billingStatus",
+              "incrementalPreAuthorizationEnabled"
+            ]
+          }
+        }
+      }
+    },
+    "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"
+          }
+        }
+      }
+    }
+  },
   "sessionsConsumptionStatsRead": {
     "200": {
       "schema": {