3.281.0 release notes
about 13 hours ago by ReadMe API
- ⚠️ Breaking changes
- Changed
ratevalidation onPOST /public-api/resources/currency-rates/v1.0andPATCH /public-api/resources/currency-rates/v1.0/{currencyRate}to reject values greater than999999999.999999. Rates must still be greater than zero. - Removed
PLUG_AND_CHARGEfrom thecapabilitiesresponse array onGETandPOST /public-api/resources/charge-points/v1.0andGETandPATCH /public-api/resources/charge-points/v1.0/{chargePoint}.
- Changed
- ✨ New features
- Added
GET /public-api/resources/sessions/v1.0/{session}/editsto retrieve a session's edit history, newest first, with cursor pagination. Entries include the edit type and, when available, the administrator ID, reason, previous and new tariff details, original amount, and timestamp. - Added
filter[editTypes],filter[editCreatedByAdminIds],filter[editCreatedAfter], andfilter[editCreatedBefore]toGET /public-api/resources/sessions/v1.0to find sessions by their edit history. - Added the experimental endpoint
POST /public-api/actions/reimbursement-record/v1.0/{reimbursementRecord}/correct-amount, accepting requiredamountWithTaxandreasonfields. It fully reverses the original record and returns a corrective record in the current reimbursement period; the corrected amount must be positive and differ from the current amount after currency rounding. - Added
supersedesReimbursementRecordIdto reimbursement record responses to identify the record replaced by a correction. It is available onGET /public-api/resources/reimbursement-records/v1.0,GET /public-api/resources/reimbursement-records/v1.0/{reimbursementRecord},POST /public-api/actions/reimbursement-record/v1.0/{reimbursementRecord}/issue-credit,POST /public-api/actions/reimbursement-record/v1.0/{reimbursementRecord}/set-custom-fields, and reimbursement records embedded inGET /public-api/resources/sessions/v1.0/{session}. - Added
POST /public-api/actions/reimbursement-report/v1.0/{reimbursementReport}/set-paid-status, accepting requiredpaidStatuswithnot_paidorpaid. AddedpaidStatusto responses fromGET /public-api/resources/reimbursement-reports/v1.0,GET /public-api/resources/reimbursement-reports/v1.0/{reimbursementReport}, andPOST /public-api/actions/reimbursement-report/v1.0/{reimbursementReport}/set-custom-fields, plusfilter[paidStatus]on the listing endpoint. - Added optional
purchaseOrderNumberto requests onPOST /public-api/resources/partners/v2.0andPATCH /public-api/resources/partners/v2.0/{partner}. The field is also returned by those endpoints,GET /public-api/resources/partners/v2.0,GET /public-api/resources/partners/v2.0/{partner}, andPOST /public-api/actions/partner/v1.0/{partner}/disable,POST /public-api/actions/partner/v1.0/{partner}/enable,POST /public-api/actions/partner/v1.0/{partner}/start-offboarding, andPOST /public-api/actions/partner/v1.0/{partner}/set-custom-fields. - Added optional
purchaseOrderNumberto the request body onPOST /public-api/actions/partner-settlement-report/v1.0/{partnerSettlementReport}/issue-partner-invoiceto override the purchase order number for that invoice without changing the partner or settlement report. Omitting it uses the report's value, falling back to the partner's; sendingnullor an empty string suppresses it, and self-billing invoices never carry one. - Added
purchaseOrderNumberto responses fromGET /public-api/resources/partner-settlement-reports/v1.1,GET /public-api/resources/partner-settlement-reports/v1.1/{partnerSettlementReport},GET /public-api/resources/partner-invoices/v1.0,GET /public-api/resources/partner-invoices/v1.0/{partnerInvoice}, andPOST /public-api/actions/partner-invoice/v1.0/{partnerInvoice}/issue-credit-note,POST /public-api/actions/partner-invoice/v1.0/{partnerInvoice}/register-payment,POST /public-api/actions/partner-invoice/v1.0/{partnerInvoice}/set-custom-fields, andPOST /public-api/actions/partner-invoice/v1.0/{partnerInvoice}/update-external-id. - Added optional
publicSharing.fiscalModetoPATCH /public-api/resources/charge-points/v2.0/{chargePoint}for personal charge points, withHCC_Vfor normal tax treatment andHCC_Efor a 0% energy fee tax rate and a home charging compensation marker in OCPI charging detail records. The field is returned when public sharing or roaming publication is enabled byGETandPOST /public-api/resources/charge-points/v2.0,GETandPATCH /public-api/resources/charge-points/v2.0/{chargePoint}, andPOST /public-api/actions/charge-point/v1.0/{chargePoint}/set-custom-fields; setting it when both access options are disabled returns409 Conflict. - Added the boolean
isMasterPassresponse field onGETandPOST /public-api/resources/id-tags/v2.0,GETandPATCH /public-api/resources/id-tags/v2.0/{idTag}, andPOST /public-api/actions/id-tag/v1.0/{idTag}/set-custom-fields. Addedfilter[isMasterPass]withtrueorfalseon the listing endpoint. - Added optional
evseIdsfor Payter terminals onPOST /public-api/resources/payment-terminals/v1.1andPATCH /public-api/resources/payment-terminals/v1.1/{paymentTerminal}; the IDs must belong to the linked charge point. The field is also returned by those endpoints,GET /public-api/resources/payment-terminals/v1.1,GET /public-api/resources/payment-terminals/v1.1/{paymentTerminal}, andPOST /public-api/actions/payment-terminal/v1.0/{paymentTerminal}/set-custom-fields. - Added optional
skipPreAuthorizationandskipUnpaidSessionCheckto requests onPOST /public-api/resources/users/v1.1andPATCH /public-api/resources/users/v1.1/{user}for per-user control of these checks.
- Added
- 🔧 Improvements
- Made
churnReasonoptional onPOST /public-api/actions/churn-record/v1.0/record-exitandPOST /public-api/actions/partner/v1.0/{partner}/start-offboarding. Partner disable requests onPOST /public-api/actions/partner/v1.0/{partner}/disablealso no longer require a churn reason when omitted; the existing nested reason fields remain supported. - Made
transactionTimeoutoptional when creating a Payter terminal in plug-in-first mode onPOST /public-api/resources/payment-terminals/v1.1. Omitting it, or supplying zero or a negative value, uses a 60-second timeout. - Expanded
failureReasonresponses onGET /public-api/resources/ocpi-commands/v1.0andGET /public-api/resources/ocpi-commands/v1.0/{ocpiCommand}, andfilter[failureReason]on the listing endpoint, withcharging_profile_not_set,charging_profile_not_found_on_charge_point,charging_profile_no_confirmation,charging_profile_rejected_by_charge_point,charging_profile_dlm_outcome_uncorrelated,charging_profile_session_ended,charging_profile_charge_point_offline,charging_profile_schedule_unreadable, andcharging_profile_callback_not_delivered. - Expanded card network support with
dinacardinpaymentMethod.cardNetworkandpaymentMethod.typerequests andcardDetails.cardNetworkandcardDetails.typeresponses onPOST /public-api/resources/transactions/v1.0andPATCH /public-api/resources/transactions/v1.0/{transaction}. The new value can also appear in responses fromGET /public-api/resources/transactions/v1.0,GET /public-api/resources/transactions/v1.0/{transaction}, andPOST /public-api/actions/transaction/v1.0/{transaction}/set-custom-fields, and is accepted by the listing endpoint'sfilter[cardNetwork]andfilter[paymentMethod]. - Expanded user payment method responses with
dinacardforcardNetworkandissueronGETandPOST /public-api/resources/users/v1.0/{user}/payment-methodsandGETandPATCH /public-api/resources/users/v1.0/{user}/payment-methods/{paymentMethodId}. Addeddinacardtofilter[selectedPaymentMethod]onGET /public-api/resources/sessions/v1.0. - Expanded Valina terminal
screensaverPaymentMethodswithdinacardin requests and responses onPOST /public-api/resources/payment-terminals/v1.1andPATCH /public-api/resources/payment-terminals/v1.1/{paymentTerminal}. The new value can also appear in responses fromGET /public-api/resources/payment-terminals/v1.1,GET /public-api/resources/payment-terminals/v1.1/{paymentTerminal}, andPOST /public-api/actions/payment-terminal/v1.0/{paymentTerminal}/set-custom-fields. - Expanded access for otherwise authorized API consumers to read dedicated master passes through
GET /public-api/resources/id-tags/v2.0/{idTag}andGET /public-api/resources/rfid-tags/v1.0/{rfidTag}, and to manage their notes throughGETandPOST /public-api/resources/id-tags/v2.0/{idTag}/notesandGET,PATCH, andDELETE /public-api/resources/id-tags/v2.0/{idTag}/notes/{note}. - Changed
currencyresponses onGET /public-api/resources/partner-expenses/v1.0to fall back to the expense's currency when the associated session has no currency.
- Made
