@ampeco/public-api-mcp 3.228.8 → 3.230.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -3947,7 +3947,7 @@
3947
3947
  "method": "POST",
3948
3948
  "operationId": "partnerSettlementReportIssuePartnerInvoice",
3949
3949
  "summary": "Partner settlement report / Issue partner invoice",
3950
- "description": "This action validates the given settlement report and accepts it for partner invoice generation. The settlement report must have a B2B invoice processor configured on its operator and must not already have been invoiced. Both balance directions are eligible. When expenses are greater than or equal to revenue, the action produces a regular partner invoice on which the operator is the seller. When expenses are lower than revenue, the balance is in the partner's favor and the action produces a self-billing invoice on which the partner is the seller. Invoice generation runs asynchronously after the request is accepted. Poll the settlement report read endpoint and check `partnerInvoiceId` for completion.",
3950
+ "description": "This action validates the given settlement report and accepts it for partner invoice generation. The settlement report must have a B2B invoice processor configured on its operator and must not already have been invoiced. Both balance directions are eligible. When expenses are greater than or equal to revenue, the action produces a regular partner invoice on which the operator is the seller. When expenses are lower than revenue, the balance is in the partner's favor and the action produces a self-billing invoice on which the partner is the seller. Invoice generation runs asynchronously after the request is accepted; the `202` confirms acceptance of the request, not the outcome. Poll the settlement report read endpoint: - **Generated** — `partnerInvoiceId` is present and identifies the new partner invoice. - **Not generated** — generation failed after acceptance. No partner invoice record exists and `partnerInvoiceId` remains absent. Causes include a missing or invalid tax identification number on the partner, a report currency the operator's B2B invoice processor does not support, a tax rate not configured on that processor, and a report whose invoiceable total nets to zero. The failure is reported to the operator through the platform; poll with a bounded number of attempts rather than indefinitely. Where the operator's B2B invoice processor certifies documents with a fiscal authority, `partnerInvoiceId` appearing means the invoice **record** exists — not that a legally issued document exists. Certification runs as a second asynchronous stage; read `fiscalization.status` on the single-invoice endpoint to follow it to `certified` or `failed`.",
3951
3951
  "tags": [
3952
3952
  "action / partner settlement report"
3953
3953
  ],
@@ -5335,6 +5335,20 @@
5335
5335
  },
5336
5336
  "address": {
5337
5337
  "type": "string"
5338
+ },
5339
+ "recipientCode": {
5340
+ "type": "string",
5341
+ "minLength": 7,
5342
+ "maxLength": 7,
5343
+ "pattern": "^[A-Za-z0-9]{7}$",
5344
+ "example": "ABC1234",
5345
+ "description": "Italian SDI recipient code of the buyer. Only collected when the operator uses the Avalara e-invoicing integration with an Italian mandate. Exactly seven alphanumeric characters; lowercase input is accepted and stored uppercased. An Italian company must supply at least one of `recipientCode` and `recipientCertifiedEmail`. Omit the property when there is no value to supply."
5346
+ },
5347
+ "recipientCertifiedEmail": {
5348
+ "type": "string",
5349
+ "format": "email",
5350
+ "example": "buyer@pec.example.com",
5351
+ "description": "Certified electronic mail (PEC) address of the buyer. Only collected when the operator uses the Avalara e-invoicing integration with an Italian mandate. An Italian company must supply at least one of `recipientCode` and `recipientCertifiedEmail`. Omit the property when there is no value to supply."
5338
5352
  }
5339
5353
  },
5340
5354
  "required": [
@@ -9480,7 +9494,7 @@
9480
9494
  },
9481
9495
  "plugAndCharge": {
9482
9496
  "type": "boolean",
9483
- "description": "Enable this flag if you the CP is configured in plug and charge mode, it automatically starts a session when a car is plugged in, and the ID tag should not be authorized"
9497
+ "description": "Enable this flag if you the CP is configured in plug and charge mode, it automatically starts a session when a car is plugged in, and the ID tag should not be authorized. Cannot be enabled on personal charge points when the operator has \"Enforce authentication on home chargers\" enabled in its Home charging settings."
9484
9498
  },
9485
9499
  "locationId": {
9486
9500
  "type": "integer",
@@ -9759,7 +9773,7 @@
9759
9773
  },
9760
9774
  "plugAndCharge": {
9761
9775
  "type": "boolean",
9762
- "description": "Enable this flag if you the CP is configured in plug and charge mode, it automatically starts a session when a car is plugged in, and the ID tag should not be authorized"
9776
+ "description": "Enable this flag if you the CP is configured in plug and charge mode, it automatically starts a session when a car is plugged in, and the ID tag should not be authorized. Cannot be enabled on personal charge points when the operator has \"Enforce authentication on home chargers\" enabled in its Home charging settings."
9763
9777
  },
9764
9778
  "locationId": {
9765
9779
  "type": "integer",
@@ -10408,7 +10422,7 @@
10408
10422
  "autoStartWithoutAuthorization": {
10409
10423
  "type": "boolean",
10410
10424
  "default": false,
10411
- "description": "When enabled the system would allow charging sessions initiated </br> locally by the charge point assuming it is setup to work in auto-start / </br> plug-and-charge mode. It would also automatically start a </br> session with a remote start command if one is not already started by the charging stations a </br> few seconds after a Preparing status is detected indicating that a vehicle is connected."
10425
+ "description": "When enabled the system would allow charging sessions initiated </br> locally by the charge point assuming it is setup to work in auto-start / </br> plug-and-charge mode. It would also automatically start a </br> session with a remote start command if one is not already started by the charging stations a </br> few seconds after a Preparing status is detected indicating that a vehicle is connected. </br> Cannot be set to `true` on `personal` charge points when the operator has \"Enforce authentication on home chargers\" enabled in its Home charging settings; setting it to `false` is always allowed."
10412
10426
  },
10413
10427
  "disableAutoStartEmulation": {
10414
10428
  "type": "boolean",
@@ -10872,7 +10886,7 @@
10872
10886
  "autoStartWithoutAuthorization": {
10873
10887
  "type": "boolean",
10874
10888
  "default": false,
10875
- "description": "When enabled the system would allow charging sessions initiated </br> locally by the charge point assuming it is setup to work in auto-start / </br> plug-and-charge mode. It would also automatically start a </br> session with a remote start command if one is not already started by the charging stations a </br> few seconds after a Preparing status is detected indicating that a vehicle is connected."
10889
+ "description": "When enabled the system would allow charging sessions initiated </br> locally by the charge point assuming it is setup to work in auto-start / </br> plug-and-charge mode. It would also automatically start a </br> session with a remote start command if one is not already started by the charging stations a </br> few seconds after a Preparing status is detected indicating that a vehicle is connected. </br> Cannot be set to `true` on `personal` charge points when the operator has \"Enforce authentication on home chargers\" enabled in its Home charging settings; setting it to `false` is always allowed."
10876
10890
  },
10877
10891
  "disableAutoStartEmulation": {
10878
10892
  "type": "boolean",
@@ -11063,7 +11077,7 @@
11063
11077
  "properties": {
11064
11078
  "enabled": {
11065
11079
  "type": "boolean",
11066
- "description": "When `true`, same-operator users without a sharing invite for this charge point can authorise sessions, and the owner is reimbursed by the operator for public-access sessions. Accepted independently of `roamingPublishEnabled`. Preconditions: enabling requires all three of (1) a location with country and postal code, (2) the charge point's tariff group has a public tariff configured, and (3) `reimbursementPolicyId` references an active operator-owned reimbursement policy. A request that enables public sharing while any precondition is missing returns HTTP 422 with a `publicSharing.enabled` error naming each missing precondition."
11080
+ "description": "When `true`, same-operator users without a sharing invite for this charge point can authorise sessions, and the owner is reimbursed by the operator for public-access sessions. Accepted independently of `roamingPublishEnabled`. Preconditions: enabling requires all three of (1) a location with country and postal code, (2) the tariff group assigned to the charge point's EVSEs (`tariffGroupId`) contains at least one tariff, and (3) `reimbursementPolicyId` references an active operator-owned reimbursement policy. A request that enables public sharing while any precondition is missing returns HTTP 422 with a `publicSharing.enabled` error naming each missing precondition."
11067
11081
  },
11068
11082
  "roamingPublishEnabled": {
11069
11083
  "type": "boolean",
@@ -25034,7 +25048,7 @@
25034
25048
  "idLabel": {
25035
25049
  "type": "string",
25036
25050
  "nullable": true,
25037
- "description": "Visual or other label that could be associated with the ID Tag"
25051
+ "description": "Visual or other label that could be associated with the ID Tag. For ID tags that are shared with roaming partners, this value is sent as the OCPI visual_number. Values longer than 64 characters are not shared."
25038
25052
  },
25039
25053
  "expireAt": {
25040
25054
  "type": "string",
@@ -25209,7 +25223,7 @@
25209
25223
  "idLabel": {
25210
25224
  "type": "string",
25211
25225
  "nullable": true,
25212
- "description": "Visual or other label that could be associated with the ID Tag"
25226
+ "description": "Visual or other label that could be associated with the ID Tag. For ID tags that are shared with roaming partners, this value is sent as the OCPI visual_number. Values longer than 64 characters are not shared."
25213
25227
  },
25214
25228
  "userLabel": {
25215
25229
  "type": "string",
@@ -60793,11 +60807,6 @@
60793
60807
  ],
60794
60808
  "description": "Only list transactions by type of payment method. For card-network values, prefer the `filter[cardNetwork]` filter. Wallet-type filtering is available only through this filter."
60795
60809
  },
60796
- "totalAmount": {
60797
- "type": "number",
60798
- "minimum": 0,
60799
- "description": "Exact match on the transaction's total amount, in any currency; combined with other filters using AND. When no `cardLast4`, `finalizedAfter`, or `finalizedBefore` is supplied, results are scoped to transactions finalized within the last 30 days."
60800
- },
60801
60810
  "cardNetwork": {
60802
60811
  "type": "array",
60803
60812
  "items": {
@@ -60839,9 +60848,10 @@
60839
60848
  },
60840
60849
  "cardLast4": {
60841
60850
  "type": "string",
60851
+ "minLength": 4,
60842
60852
  "maxLength": 4,
60843
60853
  "pattern": "^\\d{4}$",
60844
- "description": "Only list transactions matching the exact four digits stored in the card payment snapshot. This filter is combined with other filters using AND logic and applies across the full transaction history without an automatic date limit."
60854
+ "description": "Only list transactions matching the exact four digits stored in the card payment snapshot. This filter is combined with other filters using AND logic and applies across the full transaction history without an automatic date limit. Supplying it also removes the implicit 30-day window that `totalAmount` applies on its own."
60845
60855
  },
60846
60856
  "fingerprint": {
60847
60857
  "type": "string",
@@ -60927,12 +60937,17 @@
60927
60937
  "finalizedBefore": {
60928
60938
  "type": "string",
60929
60939
  "format": "date-time",
60930
- "description": "ISO 8601 formatted date. Lists only the transactions finalized before this datetime"
60940
+ "description": "ISO 8601 formatted date. Lists only the transactions finalized before this datetime. Supplying it also removes the implicit 30-day window that `totalAmount` applies on its own."
60931
60941
  },
60932
60942
  "finalizedAfter": {
60933
60943
  "type": "string",
60934
60944
  "format": "date-time",
60935
- "description": "ISO 8601 formatted date. Lists only the transactions finalized after this datetime"
60945
+ "description": "ISO 8601 formatted date. Lists only the transactions finalized after this datetime. Supplying it also removes the implicit 30-day window that `totalAmount` applies on its own."
60946
+ },
60947
+ "totalAmount": {
60948
+ "type": "number",
60949
+ "minimum": 0,
60950
+ "description": "Exact match on the transaction's total amount, in any currency; combined with other filters using AND. When no `cardLast4`, `finalizedAfter`, or `finalizedBefore` is supplied, results are scoped to transactions finalized within the last 30 days."
60936
60951
  },
60937
60952
  "voucherId": {
60938
60953
  "type": "string",
@@ -61471,6 +61486,20 @@
61471
61486
  },
61472
61487
  "address": {
61473
61488
  "type": "string"
61489
+ },
61490
+ "recipientCode": {
61491
+ "type": "string",
61492
+ "minLength": 7,
61493
+ "maxLength": 7,
61494
+ "pattern": "^[A-Za-z0-9]{7}$",
61495
+ "example": "ABC1234",
61496
+ "description": "Italian SDI recipient code of the buyer. Only collected when the operator uses the Avalara e-invoicing integration with an Italian mandate. Exactly seven alphanumeric characters; lowercase input is accepted and stored uppercased. An Italian company must supply at least one of `recipientCode` and `recipientCertifiedEmail`. Omit the property when there is no value to supply."
61497
+ },
61498
+ "recipientCertifiedEmail": {
61499
+ "type": "string",
61500
+ "format": "email",
61501
+ "example": "buyer@pec.example.com",
61502
+ "description": "Certified electronic mail (PEC) address of the buyer. Only collected when the operator uses the Avalara e-invoicing integration with an Italian mandate. An Italian company must supply at least one of `recipientCode` and `recipientCertifiedEmail`. Omit the property when there is no value to supply."
61474
61503
  }
61475
61504
  },
61476
61505
  "required": [
@@ -63567,7 +63596,7 @@
63567
63596
  "content": {
63568
63597
  "application/json": {
63569
63598
  "schema": {
63570
- "oneOf": [
63599
+ "anyOf": [
63571
63600
  {
63572
63601
  "type": "object",
63573
63602
  "properties": {
@@ -64998,6 +65027,519 @@
64998
65027
  "phone"
64999
65028
  ],
65000
65029
  "description": "Invoice processor - Ecpay"
65030
+ },
65031
+ {
65032
+ "type": "object",
65033
+ "properties": {
65034
+ "recipientCode": {
65035
+ "type": "string",
65036
+ "minLength": 7,
65037
+ "maxLength": 7,
65038
+ "pattern": "^[A-Za-z0-9]{7}$",
65039
+ "example": "ABC1234",
65040
+ "nullable": true,
65041
+ "description": "Italian SDI recipient code of the buyer. Only collected when the operator uses the Avalara e-invoicing integration with an Italian mandate. Exactly seven alphanumeric characters; lowercase input is accepted and stored uppercased. An Italian company must supply at least one of `recipientCode` and `recipientCertifiedEmail`. Submit `null` to clear a stored value. Clearing is rejected with a validation error when the operator configures this field as required and the request stores invoice details as required — supply the other identifier instead."
65042
+ },
65043
+ "recipientCertifiedEmail": {
65044
+ "type": "string",
65045
+ "format": "email",
65046
+ "example": "buyer@pec.example.com",
65047
+ "nullable": true,
65048
+ "description": "Certified electronic mail (PEC) address of the buyer. Only collected when the operator uses the Avalara e-invoicing integration with an Italian mandate. An Italian company must supply at least one of `recipientCode` and `recipientCertifiedEmail`. Submit `null` to clear a stored value. Clearing is rejected with a validation error when the operator configures this field as required and the request stores invoice details as required — supply the other identifier instead."
65049
+ },
65050
+ "requireInvoice": {
65051
+ "type": "boolean",
65052
+ "default": false,
65053
+ "description": "Whether invoice is required for this user. Note: If the operator has 'Always collect Invoice Details' enabled in their invoice integration settings, this field will always be true regardless of the request payload value."
65054
+ },
65055
+ "invoiceType": {
65056
+ "type": "string",
65057
+ "enum": [
65058
+ "individual",
65059
+ "company"
65060
+ ],
65061
+ "nullable": true
65062
+ },
65063
+ "individualName": {
65064
+ "type": "string",
65065
+ "nullable": true
65066
+ },
65067
+ "individualPersonalId": {
65068
+ "type": "string",
65069
+ "nullable": true
65070
+ },
65071
+ "individualTaxId": {
65072
+ "type": "string",
65073
+ "nullable": true
65074
+ },
65075
+ "companyName": {
65076
+ "type": "string",
65077
+ "nullable": true
65078
+ },
65079
+ "companyRegNo": {
65080
+ "type": "string",
65081
+ "nullable": true
65082
+ },
65083
+ "companyTaxId": {
65084
+ "type": "string",
65085
+ "nullable": true
65086
+ },
65087
+ "companyTaxAdministrationOfficeName": {
65088
+ "type": "string",
65089
+ "nullable": true
65090
+ },
65091
+ "country": {
65092
+ "type": "string",
65093
+ "enum": [
65094
+ "AF",
65095
+ "AX",
65096
+ "AL",
65097
+ "DZ",
65098
+ "AS",
65099
+ "AD",
65100
+ "AO",
65101
+ "AI",
65102
+ "AQ",
65103
+ "AG",
65104
+ "AR",
65105
+ "AM",
65106
+ "AW",
65107
+ "AU",
65108
+ "AT",
65109
+ "AZ",
65110
+ "BS",
65111
+ "BH",
65112
+ "BD",
65113
+ "BB",
65114
+ "BY",
65115
+ "BE",
65116
+ "BZ",
65117
+ "BJ",
65118
+ "BM",
65119
+ "BT",
65120
+ "BO",
65121
+ "BQ",
65122
+ "BA",
65123
+ "BW",
65124
+ "BV",
65125
+ "BR",
65126
+ "IO",
65127
+ "BN",
65128
+ "BG",
65129
+ "BF",
65130
+ "BI",
65131
+ "KH",
65132
+ "CM",
65133
+ "CA",
65134
+ "CV",
65135
+ "KY",
65136
+ "CF",
65137
+ "TD",
65138
+ "CL",
65139
+ "CN",
65140
+ "CX",
65141
+ "CC",
65142
+ "CO",
65143
+ "KM",
65144
+ "CG",
65145
+ "CD",
65146
+ "CK",
65147
+ "CR",
65148
+ "CI",
65149
+ "HR",
65150
+ "CU",
65151
+ "CW",
65152
+ "CY",
65153
+ "CZ",
65154
+ "DK",
65155
+ "DJ",
65156
+ "DM",
65157
+ "DO",
65158
+ "EC",
65159
+ "EG",
65160
+ "SV",
65161
+ "GQ",
65162
+ "ER",
65163
+ "EE",
65164
+ "ET",
65165
+ "FK",
65166
+ "FO",
65167
+ "FJ",
65168
+ "FI",
65169
+ "FR",
65170
+ "GF",
65171
+ "PF",
65172
+ "TF",
65173
+ "GA",
65174
+ "GM",
65175
+ "GE",
65176
+ "DE",
65177
+ "GH",
65178
+ "GI",
65179
+ "GR",
65180
+ "GL",
65181
+ "GD",
65182
+ "GP",
65183
+ "GU",
65184
+ "GT",
65185
+ "GG",
65186
+ "GN",
65187
+ "GW",
65188
+ "GY",
65189
+ "HT",
65190
+ "HM",
65191
+ "VA",
65192
+ "HN",
65193
+ "HK",
65194
+ "HU",
65195
+ "IS",
65196
+ "IN",
65197
+ "ID",
65198
+ "IR",
65199
+ "IQ",
65200
+ "IE",
65201
+ "IM",
65202
+ "IL",
65203
+ "IT",
65204
+ "JM",
65205
+ "JP",
65206
+ "JE",
65207
+ "JO",
65208
+ "KZ",
65209
+ "KE",
65210
+ "KI",
65211
+ "KP",
65212
+ "KR",
65213
+ "XK",
65214
+ "KW",
65215
+ "KG",
65216
+ "LA",
65217
+ "LV",
65218
+ "LB",
65219
+ "LS",
65220
+ "LR",
65221
+ "LY",
65222
+ "LI",
65223
+ "LT",
65224
+ "LU",
65225
+ "MO",
65226
+ "MK",
65227
+ "MG",
65228
+ "MW",
65229
+ "MY",
65230
+ "MV",
65231
+ "ML",
65232
+ "MT",
65233
+ "MH",
65234
+ "MQ",
65235
+ "MR",
65236
+ "MU",
65237
+ "YT",
65238
+ "MX",
65239
+ "FM",
65240
+ "MD",
65241
+ "MC",
65242
+ "MN",
65243
+ "ME",
65244
+ "MS",
65245
+ "MA",
65246
+ "MZ",
65247
+ "MM",
65248
+ "NA",
65249
+ "NR",
65250
+ "NP",
65251
+ "NL",
65252
+ "NC",
65253
+ "NZ",
65254
+ "NI",
65255
+ "NE",
65256
+ "NG",
65257
+ "NU",
65258
+ "NF",
65259
+ "MP",
65260
+ "NO",
65261
+ "OM",
65262
+ "PK",
65263
+ "PW",
65264
+ "PS",
65265
+ "PA",
65266
+ "PG",
65267
+ "PY",
65268
+ "PE",
65269
+ "PH",
65270
+ "PN",
65271
+ "PL",
65272
+ "PT",
65273
+ "PR",
65274
+ "QA",
65275
+ "RE",
65276
+ "RO",
65277
+ "RU",
65278
+ "RW",
65279
+ "BL",
65280
+ "SH",
65281
+ "KN",
65282
+ "LC",
65283
+ "MF",
65284
+ "PM",
65285
+ "VC",
65286
+ "WS",
65287
+ "SM",
65288
+ "ST",
65289
+ "SA",
65290
+ "SN",
65291
+ "RS",
65292
+ "SC",
65293
+ "SL",
65294
+ "SG",
65295
+ "SX",
65296
+ "SK",
65297
+ "SI",
65298
+ "SB",
65299
+ "SO",
65300
+ "ZA",
65301
+ "GS",
65302
+ "SS",
65303
+ "ES",
65304
+ "LK",
65305
+ "SD",
65306
+ "SR",
65307
+ "SJ",
65308
+ "SZ",
65309
+ "SE",
65310
+ "CH",
65311
+ "SY",
65312
+ "TW",
65313
+ "TJ",
65314
+ "TZ",
65315
+ "TH",
65316
+ "TL",
65317
+ "TG",
65318
+ "TK",
65319
+ "TO",
65320
+ "TT",
65321
+ "TN",
65322
+ "TR",
65323
+ "TM",
65324
+ "TC",
65325
+ "TV",
65326
+ "UG",
65327
+ "UA",
65328
+ "AE",
65329
+ "GB",
65330
+ "US",
65331
+ "UM",
65332
+ "UY",
65333
+ "UZ",
65334
+ "VU",
65335
+ "VE",
65336
+ "VN",
65337
+ "VG",
65338
+ "VI",
65339
+ "WF",
65340
+ "EH",
65341
+ "YE",
65342
+ "ZM",
65343
+ "ZW"
65344
+ ],
65345
+ "nullable": true
65346
+ },
65347
+ "region": {
65348
+ "type": "string",
65349
+ "nullable": true,
65350
+ "description": "When country is not in US, AU, CA, UM or RO, you can provide the region"
65351
+ },
65352
+ "state": {
65353
+ "anyOf": [
65354
+ {
65355
+ "type": "string",
65356
+ "enum": [
65357
+ "AL",
65358
+ "AK",
65359
+ "AS",
65360
+ "AZ",
65361
+ "AR",
65362
+ "CA",
65363
+ "CO",
65364
+ "CT",
65365
+ "DE",
65366
+ "DC",
65367
+ "FM",
65368
+ "FL",
65369
+ "GA",
65370
+ "GU",
65371
+ "HI",
65372
+ "ID",
65373
+ "IL",
65374
+ "IN",
65375
+ "IA",
65376
+ "KS",
65377
+ "KY",
65378
+ "LA",
65379
+ "ME",
65380
+ "MH",
65381
+ "MD",
65382
+ "MA",
65383
+ "MI",
65384
+ "MN",
65385
+ "MS",
65386
+ "MO",
65387
+ "MT",
65388
+ "NE",
65389
+ "NV",
65390
+ "NH",
65391
+ "NJ",
65392
+ "NM",
65393
+ "NY",
65394
+ "NC",
65395
+ "ND",
65396
+ "MP",
65397
+ "OH",
65398
+ "OK",
65399
+ "OR",
65400
+ "PW",
65401
+ "PA",
65402
+ "PR",
65403
+ "RI",
65404
+ "SC",
65405
+ "SD",
65406
+ "TN",
65407
+ "TX",
65408
+ "UT",
65409
+ "VT",
65410
+ "VI",
65411
+ "VA",
65412
+ "WA",
65413
+ "WV",
65414
+ "WI",
65415
+ "WY"
65416
+ ],
65417
+ "description": "When the country is US."
65418
+ },
65419
+ {
65420
+ "type": "string",
65421
+ "enum": [
65422
+ "NSW",
65423
+ "VIC",
65424
+ "QLD",
65425
+ "WA",
65426
+ "SA",
65427
+ "TAS",
65428
+ "ACT",
65429
+ "NT",
65430
+ "JBT",
65431
+ "CX",
65432
+ "NF",
65433
+ "CC",
65434
+ "AQ",
65435
+ "CSI",
65436
+ "ACI",
65437
+ "HM"
65438
+ ],
65439
+ "description": "When the country is AU."
65440
+ },
65441
+ {
65442
+ "type": "string",
65443
+ "enum": [
65444
+ "AB",
65445
+ "BC",
65446
+ "MB",
65447
+ "NB",
65448
+ "NL",
65449
+ "NT",
65450
+ "NS",
65451
+ "NU",
65452
+ "ON",
65453
+ "PE",
65454
+ "QC",
65455
+ "SK",
65456
+ "YT"
65457
+ ],
65458
+ "description": "When the country is CA."
65459
+ },
65460
+ {
65461
+ "type": "string",
65462
+ "enum": [
65463
+ "81",
65464
+ "84",
65465
+ "85",
65466
+ "67",
65467
+ "89",
65468
+ "71",
65469
+ "76",
65470
+ "95",
65471
+ "79"
65472
+ ],
65473
+ "description": "When the country is UM."
65474
+ },
65475
+ {
65476
+ "type": "string",
65477
+ "enum": [
65478
+ "AB",
65479
+ "AR",
65480
+ "AG",
65481
+ "BC",
65482
+ "BH",
65483
+ "BN",
65484
+ "BT",
65485
+ "BV",
65486
+ "BR",
65487
+ "B",
65488
+ "BZ",
65489
+ "CL",
65490
+ "CS",
65491
+ "CT",
65492
+ "CV",
65493
+ "DB",
65494
+ "DJ",
65495
+ "GL",
65496
+ "GR",
65497
+ "GJ",
65498
+ "HR",
65499
+ "HD",
65500
+ "IL",
65501
+ "IS",
65502
+ "IF",
65503
+ "MM",
65504
+ "MH",
65505
+ "MS",
65506
+ "NT",
65507
+ "OT",
65508
+ "PH",
65509
+ "SM",
65510
+ "SJ",
65511
+ "SB",
65512
+ "SV",
65513
+ "TR",
65514
+ "TM",
65515
+ "TL",
65516
+ "VS",
65517
+ "VL",
65518
+ "VN"
65519
+ ],
65520
+ "description": "When the country is RO."
65521
+ }
65522
+ ],
65523
+ "description": "When the selected country is one of US, AU, CA, UM or RO"
65524
+ },
65525
+ "city": {
65526
+ "type": "string",
65527
+ "nullable": true
65528
+ },
65529
+ "postCode": {
65530
+ "type": "string",
65531
+ "nullable": true
65532
+ },
65533
+ "address": {
65534
+ "type": "string",
65535
+ "nullable": true
65536
+ }
65537
+ },
65538
+ "required": [
65539
+ "requireInvoice",
65540
+ "invoiceType"
65541
+ ],
65542
+ "description": "Avalara e-invoicing processor. Carries the same fields as the platform's native invoice integration, plus the two Italian SDI buyer identifiers. Those two are only collected when the operator's Avalara integration has an Italian mandate, and only stored for company customers. When both identifiers are collected and enabled, an Italian company (`invoiceType` is `company` and `country` is `IT`) must supply at least one of `recipientCode` and `recipientCertifiedEmail`. This either-or requirement is conditional on the invoice type and the country, so it cannot be expressed per field in this schema — a request that omits both is rejected with a validation error reported on both properties."
65001
65543
  }
65002
65544
  ]
65003
65545
  }
@@ -69414,7 +69956,7 @@
69414
69956
  ],
69415
69957
  "info": {
69416
69958
  "title": "Public API",
69417
- "version": "3.228.8",
69959
+ "version": "3.230.0",
69418
69960
  "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"
69419
69961
  },
69420
69962
  "servers": [
@@ -69428,18 +69970,18 @@
69428
69970
  }
69429
69971
  }
69430
69972
  ],
69431
- "buildTimestamp": "2026-08-11T06:43:49.905Z",
69973
+ "buildTimestamp": "2026-08-11T11:10:59.294Z",
69432
69974
  "stats": {
69433
69975
  "totalEndpoints": 623,
69434
- "originalSize": 5371059,
69435
- "optimizedSize": 1528498,
69436
- "reductionPercent": 71.54,
69437
- "buildDuration": 1452,
69976
+ "originalSize": 5461157,
69977
+ "optimizedSize": 1538131,
69978
+ "reductionPercent": 71.84,
69979
+ "buildDuration": 1408,
69438
69980
  "responseSchemas": {
69439
69981
  "total": 623,
69440
69982
  "withSchemas": 623,
69441
- "totalSchemaSize": 3069417,
69442
- "averageSchemaSize": 4927
69983
+ "totalSchemaSize": 3135528,
69984
+ "averageSchemaSize": 5033
69443
69985
  }
69444
69986
  }
69445
69987
  }