策略-需量管理与防逆流

上报防逆流过需策略

• Topic： ${自定义前缀v1}/${DEVICE}/streaming_overdemand/list/post

• 权限：订阅

• Payload主结构

  参数	类型	是否必填	描述	范围	样例
  mid	UUID		消息ID	-	3e681859-6917-4b9a-9afd-3f162cd185bd
  type	str		消息类型	streaming_overdemand_list	streaming_overdemand_list
  data	data		消息内容	-	见Payload - data
  device_uid	str		（二级）设备UID	-	iYRkfVpi77
  timestamp	int		消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

• Payload - data: StreamingOverDemand

  参数	类型	是否必填	描述	范围	样例
  id	int		过需逆流策略ID		1
  device_type	int		设备类型	2-储能设备 3-光伏 4-充电桩	2
  devices	any		设备列表	-	[]emsDevice/[]photovoltaic/[]pail
  elemeter	eleMeter		电表	-	eleMeter
  ele_meter_id	int		电表id		1
  streaming_status	int		防逆流状态	1-启用 2-禁用	1
  streaming_condition	int		防逆流执行条件（单位：kW）	-	5000
  individual_phase_streaming_status	int		单相防逆流状态	1-启用 2-禁用	2
  individual_phase_streaming_condition	int		单相防逆流执行条件（单位：kW）	-	100
  over_demand_condition	[]int		每月防过需执行条件（1-12月）（单位：kW）	-	[5000,6000,5000,5000,6000,5000,5000,6000,5000,5000,6000,5000]
  over_demand_status	int		防过需状态	1-启用 2-禁用	1
  dynamic_demand	int		动态需量（单位：kW）		6000
  dynamic_demand_percentage	float		动态需量追峰比例		90.1
  current_over_demand_condition	int		当前月份的过需条件（单位：kW）		2000
  updated_by	str		更新人		user: 1-admin
  created_at	str		创建时间		2024-06-06T08:59:20.21309056Z
  updated_at	str		更新时间		2024-06-06T08:59:20.21309056Z

• Payload - emsDevice

  参数	类型	是否必填	描述	范围	样例
  uid	str		设备UID	-	DGHDJSJKD-1
  name	str		设备名称	-	ems设备
  site_name	str		站点名称	-	ems站点
  location	str		详细地理位置	-	wudun
  longitude	float		经度	-	-
  latitude	float		纬度		-
  level	int		EMS等级	[1, 2]	1
  type	str		设备类型	-	ems
  running_status	int		运行状态 1-运行 2-离线 3-故障	[1,2,3]	1
  host	str		地址	-	192.168.0.1
  port	str		端口	[0,65525]	2171
  license	str		激活码	-	2YIZedmOtl4pcqo1EA4zhM5gofDI

• Payload - eleMeter

  参数	类型	是否必填	描述		样例
  uid	str		电表UID	-	QmqEhterhgrzS66grew-1
  station_name	str		站点名称	-	站点1
  port	int		端口	[0,65535]	1
  name	str		设备名称	-	东区变压器
  elec_device_type	eleDeviceType		电表类型对象	-	-
  rate	int		倍率	(0, ∞)	100
  running_status	int		运行状态 1-在线 2-离线	[1,2]	1

• Payload示例

{
  "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
  "mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "type": "streaming_overdemand_list",
  "data": [{
                "id": 4,
                "device_type": 2,
                "ele_meter_id": 10,
                "ele_meter": {
                    "id": 10,
                    "proto_type": 1,
                    "proto_id": 1,
                    "slave_id": 1,
                    "host": "192.168.77.94",
                    "port": 1,
                    "com_addr": "",
                    "com_no": 0,
                    "baud_rate": 0,
                    "data_bits": 0,
                    "stop_bits": 0,
                    "parity": "",
                    "uid": "",
                    "station_name": "测试站点",
                    "name": "test",
                    "ele_device_type_id": 1,
                    "ele_device_type": {
                        "id": 1,
                        "name": "Acrel-ADW300"
                    },
                    "running_status": 2,
                    "direction": 1,
                    "pt": 1,
                    "ct": 1,
                    "purpose": 1,
                    "meter_ids": null,
                    "associate_meters": null
                },
                "devices": [
                    {
                        "uid": "",
                        "name": "设备208",
                        "site_name": "测试站点",
                        "location": "",
                        "longitude": 0,
                        "latitude": 0,
                        "statistics_port": 1504,
                        "cooling_method": 1,
                        "level": 1,
                        "charges": null,
                        "pcs_reboot": 0,
                        "bms_reboot": 0,
                        "license": "00000011",
                        "type": "Linux",
                        "running_status": 1,
                        "id": 3,
                        "proto_type": 1,
                        "proto_id": 0,
                        "slave_id": 1,
                        "host": "192.168.77.208",
                        "port": 1502,
                        "com_addr": "",
                        "com_no": 0,
                        "baud_rate": 0,
                        "data_bits": 0,
                        "stop_bits": 0,
                        "parity": "",
                        "created_at": "2024-04-24T02:11:01.16135116Z",
                        "updated_at": "2024-06-07T07:32:32.1991944Z"
                    },
                    {
                        "uid": "",
                        "name": "设备210",
                        "site_name": "测试站点",
                        "location": "",
                        "longitude": 0,
                        "latitude": 0,
                        "statistics_port": 1504,
                        "cooling_method": 1,
                        "level": 1,
                        "charges": null,
                        "pcs_reboot": 1,
                        "bms_reboot": 0,
                        "license": "",
                        "type": "",
                        "running_status": 1,
                        "id": 4,
                        "proto_type": 1,
                        "proto_id": 0,
                        "slave_id": 1,
                        "host": "192.168.77.210",
                        "port": 1502,
                        "com_addr": "",
                        "com_no": 0,
                        "baud_rate": 0,
                        "data_bits": 0,
                        "stop_bits": 0,
                        "parity": "",
                        "created_at": "2024-05-08T02:03:48.4397178Z",
                        "updated_at": "2024-06-07T07:32:32.2174462Z"
                    }
                ],
                "over_demand_status": 1,
                "over_demand_condition": [
                    2000,
                    2000,
                    2000,
                    2000,
                    2000,
                    2000,
                    2000,
                    2000,
                    2000,
                    2000,
                    2000,
                    2000
                ],
                "current_over_demand_condition": 2000,
                "dynamic_demand_status": 1,
                "dynamic_demand": 0,
                "dynamic_demand_percentage": 60,
                "streaming_status": 1,
                "streaming_condition": 2000,
                "individual_phase_streaming_status": 2,
                "individual_phase_streaming_condition": 100,
                "created_at": "2024-06-06T08:59:20.21309056Z",
                "updated_at": "2024-06-06T08:59:20.21309056Z",
                "updated_by": "user: 1-admin"
            }],
  "device_uid": "${DEVICE_UID}",
  "timestamp": 1695265371000
}

平台请求同步防逆流过需策略

• Topic： ${自定义前缀v1}/${DEVICE}/streaming_overdemand/sync/command

• 权限：发布

• Payload主结构

  参数	类型	是否必填	描述	范围	样例
  mid	UUID		消息ID	-	4c5b3c27-cea8-4ea1-a936-41fd3596e0e9
  reply	UUID		所回复消息的mid	-	3e681859-6917-4b9a-9afd-3f162cd185bd
  type	str		消息类型	streaming_overdemand_sync	streaming_overdemand_sync
  code	int		响应代码	-	见响应代码
  msg	str		失败原因	-	参数错误
  device_uid	str		（二级）设备UID	-	iYRkfVpi77
  timestamp	int		消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

• 响应代码

  错误码	描述	说明
  200	下发成功
  400	参数有误

• Payload示例

{
    "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
    "mid": "4c5b3c27-cea8-4ea1-a936-41fd3596e0e9",
    "type": "streaming_overdemand_sync",
    "code": 200,
    "msg": "",
    "device_uid": "iYRkfVpi77",
    "timestamp": 1695265671000
}

同步防逆流过需电策略响应

• Topic： ${自定义前缀v1}/${DEVICE}/streaming_overdemand/sync/result

• 权限：订阅

• Payload主结构

  参数	类型	是否必填	描述	范围	样例
  mid	UUID		消息ID	-	3e681859-6917-4b9a-9afd-3f162cd185bd
  type	str		消息类型	streaming_overdemand_sync	streaming_overdemand_sync
  data	[]StreamingOverDemand		消息内容	-	见Payload - StreamingOverDemand
  device_uid	str		（二级）设备UID	-	iYRkfVpi77
  timestamp	int		消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

• Payload示例

{
  "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
  "mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "reply": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "type": "streaming_overdemand_sync",
  "data": [{
                "id": 4,
                "ele_meter_id": 10,
                "ele_meter": {
                    "id": 10,
                    "proto_type": 1,
                    "proto_id": 1,
                    "slave_id": 1,
                    "host": "192.168.77.94",
                    "port": 1,
                    "com_addr": "",
                    "com_no": 0,
                    "baud_rate": 0,
                    "data_bits": 0,
                    "stop_bits": 0,
                    "parity": "",
                    "uid": "",
                    "station_name": "测试站点",
                    "name": "test",
                    "ele_device_type_id": 1,
                    "ele_device_type": {
                        "id": 1,
                        "name": "Acrel-ADW300"
                    },
                    "running_status": 2,
                    "direction": 1,
                    "pt": 1,
                    "ct": 1,
                    "purpose": 1,
                    "meter_ids": null,
                    "associate_meters": null
                },
                "devices": [
                    {
                        "uid": "",
                        "name": "设备208",
                        "site_name": "测试站点",
                        "location": "",
                        "longitude": 0,
                        "latitude": 0,
                        "statistics_port": 1504,
                        "cooling_method": 1,
                        "level": 1,
                        "charges": null,
                        "pcs_reboot": 0,
                        "bms_reboot": 0,
                        "license": "00000011",
                        "type": "Linux",
                        "running_status": 1,
                        "id": 3,
                        "proto_type": 1,
                        "proto_id": 0,
                        "slave_id": 1,
                        "host": "192.168.77.208",
                        "port": 1502,
                        "com_addr": "",
                        "com_no": 0,
                        "baud_rate": 0,
                        "data_bits": 0,
                        "stop_bits": 0,
                        "parity": "",
                        "created_at": "2024-04-24T02:11:01.16135116Z",
                        "updated_at": "2024-06-07T07:32:32.1991944Z"
                    },
                    {
                        "uid": "",
                        "name": "设备210",
                        "site_name": "测试站点",
                        "location": "",
                        "longitude": 0,
                        "latitude": 0,
                        "statistics_port": 1504,
                        "cooling_method": 1,
                        "level": 1,
                        "charges": null,
                        "pcs_reboot": 1,
                        "bms_reboot": 0,
                        "license": "",
                        "type": "",
                        "running_status": 1,
                        "id": 4,
                        "proto_type": 1,
                        "proto_id": 0,
                        "slave_id": 1,
                        "host": "192.168.77.210",
                        "port": 1502,
                        "com_addr": "",
                        "com_no": 0,
                        "baud_rate": 0,
                        "data_bits": 0,
                        "stop_bits": 0,
                        "parity": "",
                        "created_at": "2024-05-08T02:03:48.4397178Z",
                        "updated_at": "2024-06-07T07:32:32.2174462Z"
                    }
                ],
                "over_demand_status": 1,
                "over_demand_condition": [
                    2000,
                    2000,
                    2000,
                    2000,
                    2000,
                    2000,
                    2000,
                    2000,
                    2000,
                    2000,
                    2000,
                    2000
                ],
                "current_over_demand_condition": 2000,
                "dynamic_demand_status": 1,
                "dynamic_demand": 0,
                "dynamic_demand_percentage": 60,
                "streaming_status": 1,
                "streaming_condition": 2000,
                "created_at": "2024-06-06T08:59:20.21309056Z",
                "updated_at": "2024-06-06T08:59:20.21309056Z",
                "updated_by": "user: 1-admin"
            }],
  "device_uid": "${DEVICE_UID}",
  "timestamp": 1695265371000
}

下发创建防逆流过需电策略指令

• Topic： ${自定义前缀v1}/${DEVICE}/streaming_overdemand/create/command

• 权限：发布

• Payload主结构

  参数	类型	是否必填	描述	范围	样例
  mid	UUID		消息ID	-	3e681859-6917-4b9a-9afd-3f162cd185bd
  type	str		消息类型	streaming_overdemand_create	streaming_overdemand_create
  data	StreamingOverDemand		消息内容	-	见Payload - StreamingOverDemand
  device_uid	str		（二级）设备UID	-	iYRkfVpi77
  timestamp	int		消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

• Payload示例

{
  "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
  "mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "reply": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "type": "streaming_overdemand_create",
  "data": {
        "over_demand_status": 1,
        "streaming_status": 1,
        "dynamic_demand_status": 1,
        "over_demand_condition": [
          2000,
          2000,
          2000,
          2000,
          2000,
          2000,
          2000,
          2000,
          2000,
          2000,
          2000,
          2000
        ],
        "ele_meter_id": 9,
        "dynamic_demand_percentage": 80,
        "streaming_condition": 1000,
        "individual_phase_streaming_status": 2,
        "individual_phase_streaming_condition": 100,
  },
  "device_uid": "${DEVICE_UID}",
  "timestamp": 1695265371000
}

创建防过需防逆流策略响应

• Topic： ${自定义前缀v1}/${DEVICE}/streaming_overdemand/create/result

• 权限：订阅

• Payload主结构

  参数	类型	是否必填	描述	范围	样例
  mid	UUID		消息ID	-	4c5b3c27-cea8-4ea1-a936-41fd3596e0e9
  reply	UUID		所回复消息的mid	-	3e681859-6917-4b9a-9afd-3f162cd185bd
  type	str		消息类型	streaming_overdemand_create	streaming_overdemand_create
  code	int		响应代码	-	见响应代码
  data	data		Data		见Data
  msg	str		失败原因	-	参数错误
  device_uid	str		（二级）设备UID	-	iYRkfVpi77
  timestamp	int		消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

• Data

  参数	类型	说明
  id	int	防过需逆流策略id

• 响应代码

  错误码	描述	说明
  200	下发成功
  400	参数有误

• Payload示例

{
    "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
    "mid": "4c5b3c27-cea8-4ea1-a936-41fd3596e0e9",
    "type": "streaming_overdemand_create",
    "reply": "3e681859-6917-4b9a-9afd-3f162cd185bd",
    "code": 200,
    "data": {
        "id": 1
    },
    "msg": "",
    "device_uid": "iYRkfVpi77",
    "timestamp": 1695265671000
}

下发更新防逆流过需电策略指令

• Topic： ${自定义前缀v1}/${DEVICE}/streaming_overdemand/update/command

• 权限：发布

• Payload主结构

  参数	类型	是否必填	描述	范围	样例
  mid	UUID		消息ID	-	3e681859-6917-4b9a-9afd-3f162cd185bd
  type	str		消息类型	streaming_overdemand_update	streaming_overdemand_update
  data	StreamingOverDemand		消息内容	-	见Payload - StreamingOverDemand
  device_uid	str		（二级）设备UID	-	iYRkfVpi77
  timestamp	int		消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

• Payload示例

{
  "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
  "mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "reply": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "type": "streaming_overdemand_update",
  "data": {
        "id": 1,
        "over_demand_status": 1,
        "streaming_status": 1,
        "dynamic_demand_status": 1,
        "over_demand_condition": [
          2000,
          2000,
          2000,
          2000,
          2000,
          2000,
          2000,
          2000,
          2000,
          2000,
          2000,
          2000
        ],
        "ele_meter_id": 9,
        "dynamic_demand_percentage": 80,
        "streaming_condition": 1000,
        "individual_phase_streaming_status": 2,
        "individual_phase_streaming_condition": 100,
  },
  "device_uid": "${DEVICE_UID}",
  "timestamp": 1695265371000
}

更新防过需防逆流策略响应

• Topic： ${自定义前缀v1}/${DEVICE}/streaming_overdemand/update/result

• 权限：订阅

• Payload主结构

  参数	类型	是否必填	描述	范围	样例
  mid	UUID		消息ID	-	4c5b3c27-cea8-4ea1-a936-41fd3596e0e9
  reply	UUID		所回复消息的mid	-	3e681859-6917-4b9a-9afd-3f162cd185bd
  type	str		消息类型	streaming_overdemand_update	streaming_overdemand_update
  code	int		响应代码	-	见响应代码
  msg	str		失败原因	-	参数错误
  device_uid	str		（二级）设备UID	-	iYRkfVpi77
  timestamp	int		消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

• 响应代码

  错误码	描述	说明
  200	下发成功
  400	参数有误

• Payload示例

{
    "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
    "mid": "4c5b3c27-cea8-4ea1-a936-41fd3596e0e9",
    "type": "streaming_overdemand_update",
    "reply": "3e681859-6917-4b9a-9afd-3f162cd185bd",
    "code": 200,
    "msg": "",
    "device_uid": "iYRkfVpi77",
    "timestamp": 1695265671000
}

下发删除防逆流过需电策略指令

• Topic： ${自定义前缀v1}/${DEVICE}/streaming_overdemand/delete/command

• 权限：发布

• Payload主结构

  参数	类型	是否必填	描述	范围	样例
  mid	UUID		消息ID	-	3e681859-6917-4b9a-9afd-3f162cd185bd
  type	str		消息类型	streaming_overdemand_delete	streaming_overdemand_delete
  data	data		消息内容	-	见Payload - data
  device_uid	str		（二级）设备UID	-	iYRkfVpi77
  timestamp	int		消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

• Payload - Data

  参数	类型	是否必填	描述	样例
  id	int	是	防过需防逆流策略ID	1

• Payload示例

{
  "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
  "mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "reply": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "type": "streaming_overdemand_delete",
  "data": {
    "id": 1,                   
  },
  "device_uid": "${DEVICE_UID}",
  "timestamp": 1695265371000
}

删除防过需防逆流策略响应

• Topic： ${自定义前缀v1}/${DEVICE}/streaming_overdemand/delete/result

• 权限：订阅

• Payload主结构

  参数	类型	是否必填	描述	范围	样例
  mid	UUID		消息ID	-	4c5b3c27-cea8-4ea1-a936-41fd3596e0e9
  reply	UUID		所回复消息的mid	-	3e681859-6917-4b9a-9afd-3f162cd185bd
  type	str		消息类型	streaming_overdemand_delete	streaming_overdemand_delete
  code	int		响应代码	-	见响应代码
  msg	str		失败原因	-	参数错误
  device_uid	str		（二级）设备UID	-	iYRkfVpi77
  timestamp	int		消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

• 响应代码

  错误码	描述	说明
  200	下发成功
  400	参数有误

• Payload示例

{
    "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
    "mid": "4c5b3c27-cea8-4ea1-a936-41fd3596e0e9",
    "type": "streaming_overdemand_delete",
    "reply": "3e681859-6917-4b9a-9afd-3f162cd185bd",
    "code": 200,
    "msg": "",
    "device_uid": "iYRkfVpi77",
    "timestamp": 1695265671000
}

批量下发创建防逆流过需电策略指令

• Topic： ${自定义前缀v1}/${DEVICE}/streaming_overdemand/update_all/command

• 权限：发布

• Payload主结构

  参数	类型	是否必填	描述	范围	样例
  mid	UUID		消息ID	-	3e681859-6917-4b9a-9afd-3f162cd185bd
  type	str		消息类型	streaming_overdemand_update_all	streaming_overdemand_update_all
  data	[]StreamingOverDemand		消息内容	-	见Payload - StreamingOverDemand
  device_uid	str		（二级）设备UID	-	iYRkfVpi77
  timestamp	int		消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

• Payload示例

{
  "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
  "mid": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "reply": "ee2e8f09-b280-4e4d-bcb9-1529b703cfed",
  "type": "streaming_overdemand_update_all",
  "data": [
     {
        "device_type": 2,
        "over_demand_status": 1,
        "streaming_status": 1,
        "dynamic_demand_status": 1,
        "over_demand_condition": [
          2000,
          2000,
          2000,
          2000,
          2000,
          2000,
          2000,
          2000,
          2000,
          2000,
          2000,
          2000
        ],
        "ele_meter_id": 9,
        "dynamic_demand_percentage": 80,
        "streaming_condition": 1000,
        "individual_phase_streaming_status": 2,
        "individual_phase_streaming_condition": 100,
    }
  ],
  "device_uid": "${DEVICE_UID}",
  "timestamp": 1695265371000
}

批量创建防过需防逆流策略响应

• Topic： ${自定义前缀v1}/${DEVICE}/streaming_overdemand/update_all/result

• 权限：订阅

• Payload主结构

  参数	类型	是否必填	描述	范围	样例
  mid	UUID		消息ID	-	4c5b3c27-cea8-4ea1-a936-41fd3596e0e9
  reply	UUID		所回复消息的mid	-	3e681859-6917-4b9a-9afd-3f162cd185bd
  type	str		消息类型	streaming_overdemand_update_all	streaming_overdemand_update_all
  code	int		响应代码	-	见响应代码
  msg	str		失败原因	-	参数错误
  device_uid	str		（二级）设备UID	-	iYRkfVpi77
  timestamp	int		消息时间戳（单位：毫秒）	(0, ∞)	1696837112000

• 响应代码

  错误码	描述	说明
  200	下发成功
  400	参数有误

• Payload示例

{
    "trace_id": "577f5df0-65d6-432d-8aac-0116e9530152",
    "mid": "4c5b3c27-cea8-4ea1-a936-41fd3596e0e9",
    "type": "streaming_overdemand_update_all",
    "reply": "3e681859-6917-4b9a-9afd-3f162cd185bd",
    "code": 200,
    "msg": "",
    "device_uid": "iYRkfVpi77",
    "timestamp": 1695265671000
}