@ampeco/public-api-mcp 3.228.8 → 3.229.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,22 @@
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
+ "nullable": true,
5346
+ "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."
5347
+ },
5348
+ "recipientCertifiedEmail": {
5349
+ "type": "string",
5350
+ "format": "email",
5351
+ "example": "buyer@pec.example.com",
5352
+ "nullable": true,
5353
+ "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."
5338
5354
  }
5339
5355
  },
5340
5356
  "required": [
@@ -9480,7 +9496,7 @@
9480
9496
  },
9481
9497
  "plugAndCharge": {
9482
9498
  "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"
9499
+ "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
9500
  },
9485
9501
  "locationId": {
9486
9502
  "type": "integer",
@@ -9759,7 +9775,7 @@
9759
9775
  },
9760
9776
  "plugAndCharge": {
9761
9777
  "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"
9778
+ "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
9779
  },
9764
9780
  "locationId": {
9765
9781
  "type": "integer",
@@ -10408,7 +10424,7 @@
10408
10424
  "autoStartWithoutAuthorization": {
10409
10425
  "type": "boolean",
10410
10426
  "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."
10427
+ "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
10428
  },
10413
10429
  "disableAutoStartEmulation": {
10414
10430
  "type": "boolean",
@@ -10872,7 +10888,7 @@
10872
10888
  "autoStartWithoutAuthorization": {
10873
10889
  "type": "boolean",
10874
10890
  "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."
10891
+ "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
10892
  },
10877
10893
  "disableAutoStartEmulation": {
10878
10894
  "type": "boolean",
@@ -11063,7 +11079,7 @@
11063
11079
  "properties": {
11064
11080
  "enabled": {
11065
11081
  "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."
11082
+ "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
11083
  },
11068
11084
  "roamingPublishEnabled": {
11069
11085
  "type": "boolean",
@@ -25034,7 +25050,7 @@
25034
25050
  "idLabel": {
25035
25051
  "type": "string",
25036
25052
  "nullable": true,
25037
- "description": "Visual or other label that could be associated with the ID Tag"
25053
+ "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
25054
  },
25039
25055
  "expireAt": {
25040
25056
  "type": "string",
@@ -25209,7 +25225,7 @@
25209
25225
  "idLabel": {
25210
25226
  "type": "string",
25211
25227
  "nullable": true,
25212
- "description": "Visual or other label that could be associated with the ID Tag"
25228
+ "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
25229
  },
25214
25230
  "userLabel": {
25215
25231
  "type": "string",
@@ -60793,11 +60809,6 @@
60793
60809
  ],
60794
60810
  "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
60811
  },
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
60812
  "cardNetwork": {
60802
60813
  "type": "array",
60803
60814
  "items": {
@@ -60839,9 +60850,10 @@
60839
60850
  },
60840
60851
  "cardLast4": {
60841
60852
  "type": "string",
60853
+ "minLength": 4,
60842
60854
  "maxLength": 4,
60843
60855
  "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."
60856
+ "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
60857
  },
60846
60858
  "fingerprint": {
60847
60859
  "type": "string",
@@ -60927,12 +60939,17 @@
60927
60939
  "finalizedBefore": {
60928
60940
  "type": "string",
60929
60941
  "format": "date-time",
60930
- "description": "ISO 8601 formatted date. Lists only the transactions finalized before this datetime"
60942
+ "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
60943
  },
60932
60944
  "finalizedAfter": {
60933
60945
  "type": "string",
60934
60946
  "format": "date-time",
60935
- "description": "ISO 8601 formatted date. Lists only the transactions finalized after this datetime"
60947
+ "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."
60948
+ },
60949
+ "totalAmount": {
60950
+ "type": "number",
60951
+ "minimum": 0,
60952
+ "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
60953
  },
60937
60954
  "voucherId": {
60938
60955
  "type": "string",
@@ -61471,6 +61488,22 @@
61471
61488
  },
61472
61489
  "address": {
61473
61490
  "type": "string"
61491
+ },
61492
+ "recipientCode": {
61493
+ "type": "string",
61494
+ "minLength": 7,
61495
+ "maxLength": 7,
61496
+ "pattern": "^[A-Za-z0-9]{7}$",
61497
+ "example": "ABC1234",
61498
+ "nullable": true,
61499
+ "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."
61500
+ },
61501
+ "recipientCertifiedEmail": {
61502
+ "type": "string",
61503
+ "format": "email",
61504
+ "example": "buyer@pec.example.com",
61505
+ "nullable": true,
61506
+ "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."
61474
61507
  }
61475
61508
  },
61476
61509
  "required": [
@@ -63567,7 +63600,7 @@
63567
63600
  "content": {
63568
63601
  "application/json": {
63569
63602
  "schema": {
63570
- "oneOf": [
63603
+ "anyOf": [
63571
63604
  {
63572
63605
  "type": "object",
63573
63606
  "properties": {
@@ -64998,6 +65031,519 @@
64998
65031
  "phone"
64999
65032
  ],
65000
65033
  "description": "Invoice processor - Ecpay"
65034
+ },
65035
+ {
65036
+ "type": "object",
65037
+ "properties": {
65038
+ "recipientCode": {
65039
+ "type": "string",
65040
+ "minLength": 7,
65041
+ "maxLength": 7,
65042
+ "pattern": "^[A-Za-z0-9]{7}$",
65043
+ "example": "ABC1234",
65044
+ "nullable": true,
65045
+ "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."
65046
+ },
65047
+ "recipientCertifiedEmail": {
65048
+ "type": "string",
65049
+ "format": "email",
65050
+ "example": "buyer@pec.example.com",
65051
+ "nullable": true,
65052
+ "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."
65053
+ },
65054
+ "requireInvoice": {
65055
+ "type": "boolean",
65056
+ "default": false,
65057
+ "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."
65058
+ },
65059
+ "invoiceType": {
65060
+ "type": "string",
65061
+ "enum": [
65062
+ "individual",
65063
+ "company"
65064
+ ],
65065
+ "nullable": true
65066
+ },
65067
+ "individualName": {
65068
+ "type": "string",
65069
+ "nullable": true
65070
+ },
65071
+ "individualPersonalId": {
65072
+ "type": "string",
65073
+ "nullable": true
65074
+ },
65075
+ "individualTaxId": {
65076
+ "type": "string",
65077
+ "nullable": true
65078
+ },
65079
+ "companyName": {
65080
+ "type": "string",
65081
+ "nullable": true
65082
+ },
65083
+ "companyRegNo": {
65084
+ "type": "string",
65085
+ "nullable": true
65086
+ },
65087
+ "companyTaxId": {
65088
+ "type": "string",
65089
+ "nullable": true
65090
+ },
65091
+ "companyTaxAdministrationOfficeName": {
65092
+ "type": "string",
65093
+ "nullable": true
65094
+ },
65095
+ "country": {
65096
+ "type": "string",
65097
+ "enum": [
65098
+ "AF",
65099
+ "AX",
65100
+ "AL",
65101
+ "DZ",
65102
+ "AS",
65103
+ "AD",
65104
+ "AO",
65105
+ "AI",
65106
+ "AQ",
65107
+ "AG",
65108
+ "AR",
65109
+ "AM",
65110
+ "AW",
65111
+ "AU",
65112
+ "AT",
65113
+ "AZ",
65114
+ "BS",
65115
+ "BH",
65116
+ "BD",
65117
+ "BB",
65118
+ "BY",
65119
+ "BE",
65120
+ "BZ",
65121
+ "BJ",
65122
+ "BM",
65123
+ "BT",
65124
+ "BO",
65125
+ "BQ",
65126
+ "BA",
65127
+ "BW",
65128
+ "BV",
65129
+ "BR",
65130
+ "IO",
65131
+ "BN",
65132
+ "BG",
65133
+ "BF",
65134
+ "BI",
65135
+ "KH",
65136
+ "CM",
65137
+ "CA",
65138
+ "CV",
65139
+ "KY",
65140
+ "CF",
65141
+ "TD",
65142
+ "CL",
65143
+ "CN",
65144
+ "CX",
65145
+ "CC",
65146
+ "CO",
65147
+ "KM",
65148
+ "CG",
65149
+ "CD",
65150
+ "CK",
65151
+ "CR",
65152
+ "CI",
65153
+ "HR",
65154
+ "CU",
65155
+ "CW",
65156
+ "CY",
65157
+ "CZ",
65158
+ "DK",
65159
+ "DJ",
65160
+ "DM",
65161
+ "DO",
65162
+ "EC",
65163
+ "EG",
65164
+ "SV",
65165
+ "GQ",
65166
+ "ER",
65167
+ "EE",
65168
+ "ET",
65169
+ "FK",
65170
+ "FO",
65171
+ "FJ",
65172
+ "FI",
65173
+ "FR",
65174
+ "GF",
65175
+ "PF",
65176
+ "TF",
65177
+ "GA",
65178
+ "GM",
65179
+ "GE",
65180
+ "DE",
65181
+ "GH",
65182
+ "GI",
65183
+ "GR",
65184
+ "GL",
65185
+ "GD",
65186
+ "GP",
65187
+ "GU",
65188
+ "GT",
65189
+ "GG",
65190
+ "GN",
65191
+ "GW",
65192
+ "GY",
65193
+ "HT",
65194
+ "HM",
65195
+ "VA",
65196
+ "HN",
65197
+ "HK",
65198
+ "HU",
65199
+ "IS",
65200
+ "IN",
65201
+ "ID",
65202
+ "IR",
65203
+ "IQ",
65204
+ "IE",
65205
+ "IM",
65206
+ "IL",
65207
+ "IT",
65208
+ "JM",
65209
+ "JP",
65210
+ "JE",
65211
+ "JO",
65212
+ "KZ",
65213
+ "KE",
65214
+ "KI",
65215
+ "KP",
65216
+ "KR",
65217
+ "XK",
65218
+ "KW",
65219
+ "KG",
65220
+ "LA",
65221
+ "LV",
65222
+ "LB",
65223
+ "LS",
65224
+ "LR",
65225
+ "LY",
65226
+ "LI",
65227
+ "LT",
65228
+ "LU",
65229
+ "MO",
65230
+ "MK",
65231
+ "MG",
65232
+ "MW",
65233
+ "MY",
65234
+ "MV",
65235
+ "ML",
65236
+ "MT",
65237
+ "MH",
65238
+ "MQ",
65239
+ "MR",
65240
+ "MU",
65241
+ "YT",
65242
+ "MX",
65243
+ "FM",
65244
+ "MD",
65245
+ "MC",
65246
+ "MN",
65247
+ "ME",
65248
+ "MS",
65249
+ "MA",
65250
+ "MZ",
65251
+ "MM",
65252
+ "NA",
65253
+ "NR",
65254
+ "NP",
65255
+ "NL",
65256
+ "NC",
65257
+ "NZ",
65258
+ "NI",
65259
+ "NE",
65260
+ "NG",
65261
+ "NU",
65262
+ "NF",
65263
+ "MP",
65264
+ "NO",
65265
+ "OM",
65266
+ "PK",
65267
+ "PW",
65268
+ "PS",
65269
+ "PA",
65270
+ "PG",
65271
+ "PY",
65272
+ "PE",
65273
+ "PH",
65274
+ "PN",
65275
+ "PL",
65276
+ "PT",
65277
+ "PR",
65278
+ "QA",
65279
+ "RE",
65280
+ "RO",
65281
+ "RU",
65282
+ "RW",
65283
+ "BL",
65284
+ "SH",
65285
+ "KN",
65286
+ "LC",
65287
+ "MF",
65288
+ "PM",
65289
+ "VC",
65290
+ "WS",
65291
+ "SM",
65292
+ "ST",
65293
+ "SA",
65294
+ "SN",
65295
+ "RS",
65296
+ "SC",
65297
+ "SL",
65298
+ "SG",
65299
+ "SX",
65300
+ "SK",
65301
+ "SI",
65302
+ "SB",
65303
+ "SO",
65304
+ "ZA",
65305
+ "GS",
65306
+ "SS",
65307
+ "ES",
65308
+ "LK",
65309
+ "SD",
65310
+ "SR",
65311
+ "SJ",
65312
+ "SZ",
65313
+ "SE",
65314
+ "CH",
65315
+ "SY",
65316
+ "TW",
65317
+ "TJ",
65318
+ "TZ",
65319
+ "TH",
65320
+ "TL",
65321
+ "TG",
65322
+ "TK",
65323
+ "TO",
65324
+ "TT",
65325
+ "TN",
65326
+ "TR",
65327
+ "TM",
65328
+ "TC",
65329
+ "TV",
65330
+ "UG",
65331
+ "UA",
65332
+ "AE",
65333
+ "GB",
65334
+ "US",
65335
+ "UM",
65336
+ "UY",
65337
+ "UZ",
65338
+ "VU",
65339
+ "VE",
65340
+ "VN",
65341
+ "VG",
65342
+ "VI",
65343
+ "WF",
65344
+ "EH",
65345
+ "YE",
65346
+ "ZM",
65347
+ "ZW"
65348
+ ],
65349
+ "nullable": true
65350
+ },
65351
+ "region": {
65352
+ "type": "string",
65353
+ "nullable": true,
65354
+ "description": "When country is not in US, AU, CA, UM or RO, you can provide the region"
65355
+ },
65356
+ "state": {
65357
+ "anyOf": [
65358
+ {
65359
+ "type": "string",
65360
+ "enum": [
65361
+ "AL",
65362
+ "AK",
65363
+ "AS",
65364
+ "AZ",
65365
+ "AR",
65366
+ "CA",
65367
+ "CO",
65368
+ "CT",
65369
+ "DE",
65370
+ "DC",
65371
+ "FM",
65372
+ "FL",
65373
+ "GA",
65374
+ "GU",
65375
+ "HI",
65376
+ "ID",
65377
+ "IL",
65378
+ "IN",
65379
+ "IA",
65380
+ "KS",
65381
+ "KY",
65382
+ "LA",
65383
+ "ME",
65384
+ "MH",
65385
+ "MD",
65386
+ "MA",
65387
+ "MI",
65388
+ "MN",
65389
+ "MS",
65390
+ "MO",
65391
+ "MT",
65392
+ "NE",
65393
+ "NV",
65394
+ "NH",
65395
+ "NJ",
65396
+ "NM",
65397
+ "NY",
65398
+ "NC",
65399
+ "ND",
65400
+ "MP",
65401
+ "OH",
65402
+ "OK",
65403
+ "OR",
65404
+ "PW",
65405
+ "PA",
65406
+ "PR",
65407
+ "RI",
65408
+ "SC",
65409
+ "SD",
65410
+ "TN",
65411
+ "TX",
65412
+ "UT",
65413
+ "VT",
65414
+ "VI",
65415
+ "VA",
65416
+ "WA",
65417
+ "WV",
65418
+ "WI",
65419
+ "WY"
65420
+ ],
65421
+ "description": "When the country is US."
65422
+ },
65423
+ {
65424
+ "type": "string",
65425
+ "enum": [
65426
+ "NSW",
65427
+ "VIC",
65428
+ "QLD",
65429
+ "WA",
65430
+ "SA",
65431
+ "TAS",
65432
+ "ACT",
65433
+ "NT",
65434
+ "JBT",
65435
+ "CX",
65436
+ "NF",
65437
+ "CC",
65438
+ "AQ",
65439
+ "CSI",
65440
+ "ACI",
65441
+ "HM"
65442
+ ],
65443
+ "description": "When the country is AU."
65444
+ },
65445
+ {
65446
+ "type": "string",
65447
+ "enum": [
65448
+ "AB",
65449
+ "BC",
65450
+ "MB",
65451
+ "NB",
65452
+ "NL",
65453
+ "NT",
65454
+ "NS",
65455
+ "NU",
65456
+ "ON",
65457
+ "PE",
65458
+ "QC",
65459
+ "SK",
65460
+ "YT"
65461
+ ],
65462
+ "description": "When the country is CA."
65463
+ },
65464
+ {
65465
+ "type": "string",
65466
+ "enum": [
65467
+ "81",
65468
+ "84",
65469
+ "85",
65470
+ "67",
65471
+ "89",
65472
+ "71",
65473
+ "76",
65474
+ "95",
65475
+ "79"
65476
+ ],
65477
+ "description": "When the country is UM."
65478
+ },
65479
+ {
65480
+ "type": "string",
65481
+ "enum": [
65482
+ "AB",
65483
+ "AR",
65484
+ "AG",
65485
+ "BC",
65486
+ "BH",
65487
+ "BN",
65488
+ "BT",
65489
+ "BV",
65490
+ "BR",
65491
+ "B",
65492
+ "BZ",
65493
+ "CL",
65494
+ "CS",
65495
+ "CT",
65496
+ "CV",
65497
+ "DB",
65498
+ "DJ",
65499
+ "GL",
65500
+ "GR",
65501
+ "GJ",
65502
+ "HR",
65503
+ "HD",
65504
+ "IL",
65505
+ "IS",
65506
+ "IF",
65507
+ "MM",
65508
+ "MH",
65509
+ "MS",
65510
+ "NT",
65511
+ "OT",
65512
+ "PH",
65513
+ "SM",
65514
+ "SJ",
65515
+ "SB",
65516
+ "SV",
65517
+ "TR",
65518
+ "TM",
65519
+ "TL",
65520
+ "VS",
65521
+ "VL",
65522
+ "VN"
65523
+ ],
65524
+ "description": "When the country is RO."
65525
+ }
65526
+ ],
65527
+ "description": "When the selected country is one of US, AU, CA, UM or RO"
65528
+ },
65529
+ "city": {
65530
+ "type": "string",
65531
+ "nullable": true
65532
+ },
65533
+ "postCode": {
65534
+ "type": "string",
65535
+ "nullable": true
65536
+ },
65537
+ "address": {
65538
+ "type": "string",
65539
+ "nullable": true
65540
+ }
65541
+ },
65542
+ "required": [
65543
+ "requireInvoice",
65544
+ "invoiceType"
65545
+ ],
65546
+ "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
65547
  }
65002
65548
  ]
65003
65549
  }
@@ -69414,7 +69960,7 @@
69414
69960
  ],
69415
69961
  "info": {
69416
69962
  "title": "Public API",
69417
- "version": "3.228.8",
69963
+ "version": "3.229.0",
69418
69964
  "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
69965
  },
69420
69966
  "servers": [
@@ -69428,18 +69974,18 @@
69428
69974
  }
69429
69975
  }
69430
69976
  ],
69431
- "buildTimestamp": "2026-08-11T06:43:49.905Z",
69977
+ "buildTimestamp": "2026-08-11T07:47:35.216Z",
69432
69978
  "stats": {
69433
69979
  "totalEndpoints": 623,
69434
- "originalSize": 5371059,
69435
- "optimizedSize": 1528498,
69436
- "reductionPercent": 71.54,
69437
- "buildDuration": 1452,
69980
+ "originalSize": 5460784,
69981
+ "optimizedSize": 1537769,
69982
+ "reductionPercent": 71.84,
69983
+ "buildDuration": 1362,
69438
69984
  "responseSchemas": {
69439
69985
  "total": 623,
69440
69986
  "withSchemas": 623,
69441
- "totalSchemaSize": 3069417,
69442
- "averageSchemaSize": 4927
69987
+ "totalSchemaSize": 3135528,
69988
+ "averageSchemaSize": 5033
69443
69989
  }
69444
69990
  }
69445
69991
  }