@ampeco/public-api-mcp 3.243.0 → 3.244.0

package/dist/generated/build-stats.json

@@ -1,13 +1,13 @@
 {
-  "totalEndpoints": 637,
-  "originalSize": 5718188,
-  "optimizedSize": 1600212,
-  "reductionPercent": 72.02,
-  "buildDuration": 1502,
+  "totalEndpoints": 640,
+  "originalSize": 5774967,
+  "optimizedSize": 1609217,
+  "reductionPercent": 72.13,
+  "buildDuration": 1369,
   "responseSchemas": {
-    "total": 637,
-    "withSchemas": 637,
-    "totalSchemaSize": 3249711,
-    "averageSchemaSize": 5102
+    "total": 640,
+    "withSchemas": 640,
+    "totalSchemaSize": 3295598,
+    "averageSchemaSize": 5149
   }
 }

package/dist/generated/endpoints.json

@@ -27133,6 +27133,21 @@
                   },
                   "description": "Filter invoices by payment status. Accepts multiple comma-separated values."
                 },
+                "fiscalizationStatus": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": [
+                      "pending",
+                      "certified",
+                      "failed",
+                      "canceled"
+                    ],
+                    "example": "certified",
+                    "description": "Certification status of the invoice with its fiscalization integration. - **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. - **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`. - **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. - **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."
+                  },
+                  "description": "Filter invoices by the certification status of their fiscal document. Accepts multiple comma-separated values. Invoices with no fiscal document are excluded whenever this filter is applied."
+                },
                 "partnerId": {
                   "type": "string",
                   "format": "integer",
@@ -27169,6 +27184,9 @@
         "403": {
           "description": "You do not have permission to perform the action"
         },
+        "422": {
+          "description": "The payload you provided is invalid"
+        },
         "429": {
           "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
         }
@@ -27209,6 +27227,116 @@
         }
       }
     },
+    {
+      "path": "/public-api/resources/invoices/v1.0/{invoice}/fiscalization-attempts",
+      "method": "GET",
+      "operationId": "invoiceFiscalizationAttemptsListing",
+      "summary": "Invoice fiscalization attempts / Listing",
+      "description": "Get the fiscalization attempts an invoice's integration publishes, newest first. Integrations that do not publish attempts return an empty list.",
+      "tags": [
+        "resource / invoices"
+      ],
+      "parameters": {
+        "path": {
+          "invoice": {
+            "description": "The invoice ID to fetch",
+            "type": "string",
+            "required": true
+          }
+        },
+        "query": {
+          "per_page": {
+            "description": "The number of items to return per page.",
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "default": 100
+          },
+          "cursor": {
+            "description": "The cursor to fetch the next page. **Do not construct this value manually.** Use one of the following methods: - Use the value from the previous response's `links.next` to fetch the next page - Pass an empty string (e.g., `?cursor` or `?cursor=`) to initiate cursor pagination on the first page",
+            "type": "string"
+          }
+        }
+      },
+      "responses": {
+        "200": {
+          "description": "Success"
+        },
+        "401": {
+          "description": "Access token is missing or invalid"
+        },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
+        "404": {
+          "description": "The record is not found"
+        },
+        "422": {
+          "description": "The payload you provided is invalid"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
+    {
+      "path": "/public-api/resources/invoices/v1.0/{invoice}/fiscalization-documents/download",
+      "method": "GET",
+      "operationId": "invoiceFiscalizationDocumentDownload",
+      "summary": "Invoice fiscalization document / Download",
+      "description": "Download one of the document formats the fiscal authority has made available for a fiscalized invoice. Do not construct this URL: follow a `fiscalization.documents[].downloadUrl` link from the invoice response, which already carries the `format`, `expires` and `signature` query parameters. A missing or tampered signature yields `403 Forbidden`. The link expires 24 hours after the invoice response that produced it, after which it yields `410 Gone`, so request the invoice again for a fresh link rather than storing one. The link is signed and carries its own authorisation — no bearer token is used. The document is fetched from the fiscal authority only when the link is followed, so a provider that cannot supply the format at that moment yields `424 Failed Dependency` rather than a server error.",
+      "tags": [
+        "resource / invoices"
+      ],
+      "parameters": {
+        "path": {
+          "invoice": {
+            "description": "The invoice ID to fetch",
+            "type": "string",
+            "required": true
+          }
+        },
+        "query": {
+          "format": {
+            "description": "The document format to download, matched verbatim against the formats the fiscal authority has made available for this fiscal document. Carried by the signed link; changing it invalidates the signature.",
+            "type": "string",
+            "required": true,
+            "example": "application/pdf"
+          },
+          "expires": {
+            "description": "Unix timestamp at which the signed link stops being accepted, 24 hours after the invoice response that produced it. Carried by the signed link; changing it invalidates the signature. Once this moment has passed the endpoint answers `410 Gone`.",
+            "type": "integer",
+            "required": true,
+            "example": 1789344000
+          },
+          "signature": {
+            "description": "Signature authorising this link. Carried by the signed link and the only credential the endpoint accepts — no bearer token is required or used.",
+            "type": "string",
+            "required": true
+          }
+        }
+      },
+      "responses": {
+        "200": {
+          "description": "Success. The document is streamed back as an attachment. The `Content-Type` is the media type the fiscal authority returned for the requested format and is provider-defined, so read it from the response rather than assuming one."
+        },
+        "403": {
+          "description": "The link carries no signature, or a signature that does not match the URL it is being followed on. The signature covers the full link, including its host, so a constructed or altered URL is rejected — follow the `fiscalization.documents[].downloadUrl` link from the invoice response exactly as it was issued."
+        },
+        "404": {
+          "description": "No invoice matches the link, the invoice carries no fiscal document, the invoice's fiscalization integration does not support downloading document formats, or the requested `format` is not one the fiscal authority has made available for it."
+        },
+        "410": {
+          "description": "The link has expired. Signed links stop being accepted 24 hours after the invoice response that produced them. Request the invoice again for a fresh link."
+        },
+        "424": {
+          "description": "The fiscal authority could not supply the requested format at this moment. The `message` property carries the reason the provider reported."
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
     {
       "path": "/public-api/resources/issues/v1.0",
       "method": "GET",
@@ -51899,6 +52027,66 @@
         }
       }
     },
+    {
+      "path": "/public-api/resources/sessions/v1.0/{session}",
+      "method": "PATCH",
+      "operationId": "sessionUpdate",
+      "summary": "Session / update custom fields",
+      "description": "⚠️ Experimental endpoint — not yet a stable contract. This resource ships as experimental / beta. While experimental, its schema and behaviour may change without a version bump — including breaking changes within v1.0 itself. Anyone consuming it does so for evaluation only, or by coordinating adoption with their account manager so changes can be sequenced with them. It graduates to a stable, version-locked contract (where the normal breaking-change rules apply) only when this experimental notice is removed. Update the applicable custom field values of a session without changing any other session properties.",
+      "tags": [
+        "resource / sessions"
+      ],
+      "parameters": {
+        "path": {
+          "session": {
+            "description": "The session ID to fetch",
+            "type": "string",
+            "required": true
+          }
+        }
+      },
+      "requestBody": {
+        "required": true,
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "customFields": {
+                  "type": "object",
+                  "additionalProperties": true,
+                  "description": "Custom field values keyed by their administrator-defined identifiers. Omitted identifiers remain unchanged, and a `null` value clears the corresponding custom field. The accepted type for each identifier is defined by the tenant's custom field configuration. Boolean values are JSON booleans; Text and Long text values are strings; Email values are email-formatted strings; URL values are HTTP or HTTPS URL strings; Number values use canonical base-10 decimal strings from `-99999999999999.999999` through `99999999999999.999999` with up to six fractional digits and no insignificant trailing fractional zeroes; Date values are ISO 8601 `YYYY-MM-DD` strings; Date-time values are ISO 8601 timestamps with a UTC offset; and JSON values may use any JSON-serializable value. Decimal strings are the precision-safe Number request representation. JSON numeric inputs remain accepted for compatibility, but their precision may depend on the client's number handling."
+                }
+              },
+              "required": [
+                "customFields"
+              ],
+              "additionalProperties": false
+            }
+          }
+        }
+      },
+      "responses": {
+        "200": {
+          "description": "Success"
+        },
+        "401": {
+          "description": "Access token is missing or invalid"
+        },
+        "403": {
+          "description": "You do not have permission to perform the action"
+        },
+        "404": {
+          "description": "The record is not found"
+        },
+        "422": {
+          "description": "The payload you provided is invalid"
+        },
+        "429": {
+          "description": "Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*"
+        }
+      }
+    },
     {
       "path": "/public-api/resources/sessions/v1.0/{session}/consumption-stats",
       "method": "GET",
@@ -71399,7 +71587,7 @@
   ],
   "info": {
     "title": "Public API",
-    "version": "3.243.0",
+    "version": "3.244.0",
     "description": "The Public API provides server-to-server integration capabilities for your EV charging platform.\n\n**Authentication.** Existing integrations continue to work unchanged — long-lived UUID admin tokens are sent in `Authorization: Bearer ...` with no exchange required. Two security schemes are documented for OpenAPI client tooling, both resulting in the same Bearer header at the wire level:\n   - `bearerAuth` — the token in the `Authorization: Bearer ...` header is either a long-lived UUID admin token (issued via the admin UI, used directly) or a short-lived access token previously obtained via OAuth.\n   - `oauth2ClientCredentials` - a `client_id` / `client_secret` pair should be exchanged for a short-lived access token at `/public-api/oauth/token` per RFC 6749 Section 4.4 (Client Credentials Grant), and the short-lived token should be used in the `Authorization: Bearer ...` header. The OAuth `client_secret` itself cannot be sent directly as a bearer token — it must be exchanged first.\n"
   },
   "servers": [
@@ -71413,18 +71601,18 @@
       }
     }
   ],
-  "buildTimestamp": "2026-09-02T10:29:32.374Z",
+  "buildTimestamp": "2026-09-03T08:59:08.369Z",
   "stats": {
-    "totalEndpoints": 637,
-    "originalSize": 5718188,
-    "optimizedSize": 1600212,
-    "reductionPercent": 72.02,
-    "buildDuration": 1502,
+    "totalEndpoints": 640,
+    "originalSize": 5774967,
+    "optimizedSize": 1609217,
+    "reductionPercent": 72.13,
+    "buildDuration": 1369,
     "responseSchemas": {
-      "total": 637,
-      "withSchemas": 637,
-      "totalSchemaSize": 3249711,
-      "averageSchemaSize": 5102
+      "total": 640,
+      "withSchemas": 640,
+      "totalSchemaSize": 3295598,
+      "averageSchemaSize": 5149
     }
   }
 }