From 4d2d1491b2fc634bd8a2a2f9db0657ee8cdee1eb Mon Sep 17 00:00:00 2001 From: T0324L3 Date: Tue, 25 Nov 2025 12:42:33 +0530 Subject: [PATCH 01/12] Enhance API schema with charging details Added new properties for charging end time and stop charge status with detailed descriptions and enums. --- assets/openapi/api-b2b.yaml | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/assets/openapi/api-b2b.yaml b/assets/openapi/api-b2b.yaml index cf58b75b..aa14916c 100644 --- a/assets/openapi/api-b2b.yaml +++ b/assets/openapi/api-b2b.yaml @@ -1982,6 +1982,27 @@ components: nextDelayedTime: description: Duration (as defined in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)) until the next battery charging. type: string + chargingEndTime: + description: Timestamp (as defined in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)) of when the charging should end + type: string + stopChargeStatus: + type: string + description: | + Status of delayed stop charge. + one of following enums status will be set: + | Enum | Description | + |----------|:-------------:| + | Deactivated | Function is deactivated | + | Activated | The function is activated, and the conditions to execute it are met. | + | Successful | The most recent stop charge was successful. | + | StopChargeFailed | Failed to stop charging. | + | ChargeEndTimeScheduleFailed| The programming of the end of charge failed; the charging should not stop at the requested time. | + enum: + - Deactivated + - Activated + - Successful + - StopChargeFailed + - ChargeEndTimeScheduleFailed schedule: properties: programs: From 840b1d9307b0dbfdae381d134b4f7560319bc6d9 Mon Sep 17 00:00:00 2001 From: T0324L3 Date: Tue, 25 Nov 2025 12:44:53 +0530 Subject: [PATCH 02/12] Enhance charge scheduling description in API spec Updated the charge scheduling description to clarify the allowed modes and combinations for scheduling battery charging. --- assets/openapi/api-b2b.yaml | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/assets/openapi/api-b2b.yaml b/assets/openapi/api-b2b.yaml index aa14916c..e87d03ff 100644 --- a/assets/openapi/api-b2b.yaml +++ b/assets/openapi/api-b2b.yaml @@ -3527,7 +3527,25 @@ components: type: string schedule: type: object - description: Charge scheduling. Only one of the two modes, programs or nexDelayedTime, should be provided. + description: | + Charge scheduling: only one of the three modes, ```programs```, ```nextDelayedTime/immediate```, or ```chargingEndTime/chargingEndTimeEnabled```, should be provided. + * ```chargingEndTimeEnabled ```and ```chargingEndTime``` Can be used together to set the end time. + * ```nextDelayedTime``` and ```immediate``` cannot be used together and are mutually exclusive. Mixing them will result in an error (HTTP 400). + Here are the possible combinations of start and end times with their respective settings: immediate start and end time enable toggle. + * ```nextDelayedTime``` and ```immediate``` + | nextDelayedTime | immediate | allowed | + | :------------------: | :-------------------: | :-------------------: | + | set |not set|yes | + | set |set to true/false|no | + | not set |set to true/false |yes | + + * ```chargingEndTime``` and ```chargingEndTimeEnabled``` + | chargingEndTime | chargingEndTimeEnabled | allowed | + | :------------------: | :-------------------: | :-------------------: | + | set |not set|yes | + | set |set to true / false|yes | + | not set |set to true/false |Yes, if the chargingEndTime has been set before; otherwise, it will raise an error (HTTP 400)| + * General rule: An empty schedule object will result in an error (HTTP 400). properties: nextDelayedTime: type: string From d45200e52183ae3a02c265e970afa022bc073e4e Mon Sep 17 00:00:00 2001 From: T0324L3 Date: Tue, 25 Nov 2025 12:47:08 +0530 Subject: [PATCH 03/12] Enhance API schema with charging end time details Added properties for charging end time and its enable flag. --- assets/openapi/api-b2b.yaml | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/assets/openapi/api-b2b.yaml b/assets/openapi/api-b2b.yaml index e87d03ff..0117be71 100644 --- a/assets/openapi/api-b2b.yaml +++ b/assets/openapi/api-b2b.yaml @@ -3550,6 +3550,12 @@ components: nextDelayedTime: type: string description: Timestamp (as defined in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)) of the next battery charging time. + chargingEndTime: + type: string + description: Timestamp (as defined in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)) of when the charging should end + chargingEndTimeEnabled: + type: boolean + description: Enable or disable the programmed charge end time. programs: description: Scheduled charging programs list. type: array From b997f9d933a7163274ede558e257bb98ae91bc55 Mon Sep 17 00:00:00 2001 From: T0324L3 Date: Tue, 25 Nov 2025 12:50:02 +0530 Subject: [PATCH 04/12] Enhance API schema with charging end time and status Added chargingEndTime and stopChargeStatus fields with descriptions and enums. --- assets/openapi/api-b2c.yaml | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/assets/openapi/api-b2c.yaml b/assets/openapi/api-b2c.yaml index 0165d4c0..862530d4 100644 --- a/assets/openapi/api-b2c.yaml +++ b/assets/openapi/api-b2c.yaml @@ -2309,6 +2309,28 @@ components: nextDelayedTime: description: Duration (as defined in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)) until the next battery charging. type: string + chargingEndTime: + type: string + description: Timestamp (as defined in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)) of when the charging should end + stopChargeStatus: + type: string + description: | + Status of delayed stop charge. + one of following enums status will be set: + | Enum | Description | + |----------|:-------------:| + | Deactivated | Function is deactivated | + | Activated | The function is activated, and the conditions to execute it are met. | + | Successful | The most recent stop charge was successful. | + | StopChargeFailed | Failed to stop charging. | + | ChargeEndTimeScheduleFailed| The programming of the end of charge failed; the charging should not stop at the requested time. | + + enum: + - Deactivated + - Activated + - Successful + - StopChargeFailed + - ChargeEndTimeScheduleFailed schedule: properties: programs: From e1cf484d31aaf28fde781a7b8449a90ffbb2fc7d Mon Sep 17 00:00:00 2001 From: T0324L3 Date: Tue, 25 Nov 2025 12:53:17 +0530 Subject: [PATCH 05/12] Enhance schedule description for charging modes Updated the schedule description to clarify the usage of different charging modes and their combinations, including error handling. --- assets/openapi/api-b2c.yaml | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/assets/openapi/api-b2c.yaml b/assets/openapi/api-b2c.yaml index 862530d4..99ffb5e5 100644 --- a/assets/openapi/api-b2c.yaml +++ b/assets/openapi/api-b2c.yaml @@ -4287,7 +4287,25 @@ components: type: string schedule: type: object - description: Charge scheduling. Only one of the two modes, programs or nexDelayedTime, should be provided. + description: | + Charge scheduling: only one of the three modes, ```programs```, ```nextDelayedTime/immediate```, or ```chargingEndTime/chargingEndTimeEnabled```, should be provided. + * ```chargingEndTimeEnabled ```and ```chargingEndTime``` Can be used together to set the end time. + * ```nextDelayedTime``` and ```immediate``` cannot be used together and are mutually exclusive. Mixing them will result in an error (HTTP 400). + Here are the possible combinations of start and end times with their respective settings: immediate start and end time enable toggle. + * ```nextDelayedTime``` and ```immediate``` + | nextDelayedTime | immediate | allowed | + | :------------------: | :-------------------: | :-------------------: | + | set |not set|yes | + | set |set to true/false|no | + | not set |set to true/false |yes | + + * ```chargingEndTime``` and ```chargingEndTimeEnabled``` + | chargingEndTime | chargingEndTimeEnabled | allowed | + | :------------------: | :-------------------: | :-------------------: | + | set |not set|yes | + | set |set to true / false|yes | + | not set |set to true/false |Yes, if the chargingEndTime has been set before; otherwise, it will raise an error (HTTP 400)| + * General rule: An empty schedule object will result in an error (HTTP 400). properties: nextDelayedTime: type: string From ef65ff5c166f747ed14fbde242ae93072be3ce87 Mon Sep 17 00:00:00 2001 From: T0324L3 Date: Tue, 25 Nov 2025 12:59:23 +0530 Subject: [PATCH 06/12] Update api-b2c.yaml --- assets/openapi/api-b2c.yaml | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/assets/openapi/api-b2c.yaml b/assets/openapi/api-b2c.yaml index 99ffb5e5..09376f68 100644 --- a/assets/openapi/api-b2c.yaml +++ b/assets/openapi/api-b2c.yaml @@ -4310,6 +4310,12 @@ components: nextDelayedTime: type: string description: Timestamp (as defined in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)) of the next battery charging time. + chargingEndTime: + type: string + description: Timestamp (as defined in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)) of when the charging should end + chargingEndTimeEnabled: + type: boolean + description: Enable or disable the programmed charge end time. programs: description: Scheduled charging programs list. type: array From 8f0d89f287ee5f438627384d83e35565490acf56 Mon Sep 17 00:00:00 2001 From: T0324L3 Date: Tue, 25 Nov 2025 13:11:07 +0530 Subject: [PATCH 07/12] Add version 3.19.3 with Remote API updates Added version 3.19.3 with new features in Remote API. --- _data/webapi-b2b-changelog.yml | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/_data/webapi-b2b-changelog.yml b/_data/webapi-b2b-changelog.yml index b3c67c09..f28191f2 100644 --- a/_data/webapi-b2b-changelog.yml +++ b/_data/webapi-b2b-changelog.yml @@ -1,3 +1,9 @@ +- version: "3.19.3" + availability: in_use + release_date: 20 July 2025 + description: |- + **Remote API** + - Added Stop charge status and Charge end time - version: "3.19.2" availability: in_use release_date: 30 Jul 2024 @@ -566,4 +572,5 @@ description: |- #### `1st release (B2B)` * As delivered to Huawei regarding interfacing API - * As delivered to MPH/API team regarding public B2B API \ No newline at end of file + + * As delivered to MPH/API team regarding public B2B API From 11579ad19b33530099059870e593a3035a42731f Mon Sep 17 00:00:00 2001 From: T0324L3 Date: Tue, 25 Nov 2025 13:37:03 +0530 Subject: [PATCH 08/12] Update changelog with new API versions --- _data/webapi-b2c-changelog.yml | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/_data/webapi-b2c-changelog.yml b/_data/webapi-b2c-changelog.yml index 5376e798..27f0e197 100644 --- a/_data/webapi-b2c-changelog.yml +++ b/_data/webapi-b2c-changelog.yml @@ -1,3 +1,9 @@ +- version: "4.17.3" + availability: in_use + release_date: 10 Jul 2025 + description: |- + **Remote API** + - Added Stop charge status and Charge end time - version: "4.17.2" availability: in_use release_date: 30 Jul 2024 @@ -106,4 +112,5 @@ availability: not_in_use release_date: 11 Apr 2019 description: |- - **First Release** \ No newline at end of file + + **First Release** From d949f584f74785defa08f9b9c971a9a2b3b78cb3 Mon Sep 17 00:00:00 2001 From: T0324L3 Date: Tue, 25 Nov 2025 13:49:48 +0530 Subject: [PATCH 09/12] Update charging schema with immediate property Added 'immediate' property to charging schema and marked as deprecated. --- assets/openapi/api-b2b.yaml | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/assets/openapi/api-b2b.yaml b/assets/openapi/api-b2b.yaml index 0117be71..09cd0723 100644 --- a/assets/openapi/api-b2b.yaml +++ b/assets/openapi/api-b2b.yaml @@ -3550,6 +3550,10 @@ components: nextDelayedTime: type: string description: Timestamp (as defined in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)) of the next battery charging time. + immediate: + type: boolean + description : Determines if the charging will start immediately(```True```) or not. + example : true chargingEndTime: type: string description: Timestamp (as defined in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)) of when the charging should end @@ -3584,7 +3588,10 @@ components: example : PT14H30M immediate: type: boolean - description : Determines if the charging will start immediately(```True```) or not. + deprecated: true + description : | + Determines if the charging will start immediately(```True```) or not. + * depricated: please use schedule.immediate action instead. example : true preferences: description: Set the charging preferences. From 5e553093650c2c8b67e5a8682bd64e71c90f000a Mon Sep 17 00:00:00 2001 From: T0324L3 Date: Tue, 25 Nov 2025 13:55:50 +0530 Subject: [PATCH 10/12] Update charging schema with immediate property Added 'immediate' property to charging schema and deprecated the existing one. --- assets/openapi/api-b2c.yaml | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/assets/openapi/api-b2c.yaml b/assets/openapi/api-b2c.yaml index 09376f68..484c3641 100644 --- a/assets/openapi/api-b2c.yaml +++ b/assets/openapi/api-b2c.yaml @@ -4310,6 +4310,10 @@ components: nextDelayedTime: type: string description: Timestamp (as defined in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)) of the next battery charging time. + immediate: + type: boolean + description : Determines if the charging will start immediately(```True```) or not. + example : true chargingEndTime: type: string description: Timestamp (as defined in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)) of when the charging should end @@ -4338,7 +4342,10 @@ components: example : PT14H30M immediate: type: boolean - description : Determines if the charging will start immediately(```true```) or not. + deprecated: true + description : | + Determines if the charging will start immediately(```True```) or not. + * depricated: please use schedule.immediate action instead. preferences: description: Set the charging preferences. type: object From 488846d90882855a414369c402d697e35b17c877 Mon Sep 17 00:00:00 2001 From: T0324L3 Date: Tue, 25 Nov 2025 14:19:31 +0530 Subject: [PATCH 11/12] Update immediate property in api-b2c.yaml Removed deprecated flag from immediate property and updated description. --- assets/openapi/api-b2c.yaml | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/assets/openapi/api-b2c.yaml b/assets/openapi/api-b2c.yaml index 484c3641..9dbeae6c 100644 --- a/assets/openapi/api-b2c.yaml +++ b/assets/openapi/api-b2c.yaml @@ -4342,10 +4342,7 @@ components: example : PT14H30M immediate: type: boolean - deprecated: true - description : | - Determines if the charging will start immediately(```True```) or not. - * depricated: please use schedule.immediate action instead. + description : Determines if the charging will start immediately(```true```) or not. preferences: description: Set the charging preferences. type: object From 2d9b591de195325275fdf7a813e2ad5cc79b18a0 Mon Sep 17 00:00:00 2001 From: T0324L3 Date: Tue, 25 Nov 2025 14:21:05 +0530 Subject: [PATCH 12/12] Update immediate property in api-b2b.yaml Removed deprecated flag from immediate property and updated description. --- assets/openapi/api-b2b.yaml | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/assets/openapi/api-b2b.yaml b/assets/openapi/api-b2b.yaml index 09cd0723..056b1c6d 100644 --- a/assets/openapi/api-b2b.yaml +++ b/assets/openapi/api-b2b.yaml @@ -3588,10 +3588,7 @@ components: example : PT14H30M immediate: type: boolean - deprecated: true - description : | - Determines if the charging will start immediately(```True```) or not. - * depricated: please use schedule.immediate action instead. + description : Determines if the charging will start immediately(```true```) or not. example : true preferences: description: Set the charging preferences.