账单

账单相关接口

获取电站的基本电价信息

接口描述

根据电站id和类型获取电站的基本电价信息

请求方法

/sol-billing/plant/power-price/setting/detail

请求方式

GET

请求参数

名称	位置	类型	必选	说明
plantId	query	string	否	电站 ID
type	query	string	否	电站类型（0：光伏电站，1：储能电站）
x-access-token	header	string	否	none

返回示例

{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": {
    "id": 1,
    "version": null,
    "isDelete": null,
    "createBy": null,
    "createTime": "2025-02-13 17:35:59",
    "updateBy": null,
    "updateTime": "2025-02-13 18:10:46",
    "plantId": 1,
    "regionId": 2,
    "electricityCategory": 1,
    "electricitySystem": 1,
    "voltageLevel": "1~10(20)千伏",
    "electricitySale": 10,
    "regionName": "浙江/嘉兴"
  },
  "timestamp": 1740642091164
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» success	boolean	true	none		none
» message	string	true	none		none
» code	integer	true	none		none
» result	object	true	none		none
»» id	integer	true	none		none
»» version	null	true	none		none
»» isDelete	null	true	none		none
»» createBy	null	true	none		none
»» createTime	string	true	none		none
»» updateBy	null	true	none		none
»» updateTime	string	true	none		none
»» plantId	integer	true	none	电站 ID	none
»» regionId	integer	true	none	电价区域 ID	none
»» electricityCategory	integer	true	none	用电分类	none
»» electricitySystem	integer	true	none	大工业用电	none
»» voltageLevel	string	true	none	电压等级	none
»» electricitySale	integer	true	none	折扣电价	none
»» regionName	string	true	none	电价区域名称	none
» timestamp	integer	true	none		none

查询电价信息

接口描述

根据电站id和周期id获取某个月份的电价信息

请求方法

/sol-billing/plant-billing-template/detail

请求方式

GET

请求参数

名称	位置	类型	必选	说明
plantId	query	string	否	电站名称
powerPriceCycleId	query	string	否	周期 id
x-access-token	header	string	否	none

返回示例

{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": {
    "id": 3,
    "version": null,
    "isDelete": null,
    "createBy": null,
    "createTime": "2025-03-04 15:24:26",
    "updateBy": null,
    "updateTime": "2025-03-04 15:33:15",
    "plantId": 43226,
    "year": 2025,
    "month": 3,
    "powerPriceCycleId": 87,
    "cycleStartTime": "2025-03-01",
    "cycleEndTime": "2025-04-01",
    "powerPriceCycle": 0,
    "templateMethod": 1,
    "desulfurizedCoalPrice": null,
    "contractPrice": null,
    "sharpPrice": 1,
    "peaksPrice": 1,
    "flatPrice": 1,
    "valleysPrice": 1,
    "deepValleysPrice": 1,
    "sharpSale": 90,
    "peaksSale": 90,
    "flatSale": 90,
    "valleysSale": 90,
    "deepValleysSale": 90
  },
  "timestamp": 1741075984953
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» success	boolean	true	none		none
» message	string	true	none		none
» code	integer	true	none		none
» result	object	true	none		none
»» id	integer	true	none	账单 id	none
»» version	null	true	none		none
»» isDelete	null	true	none		none
»» createBy	null	true	none		none
»» createTime	string	true	none	创建时间	none
»» updateBy	null	true	none		none
»» updateTime	string	true	none	更新时间	none
»» plantId	integer	true	none	电站 id	none
»» year	integer	true	none	年	none
»» month	integer	true	none	月	none
»» powerPriceCycleId	integer	true	none	周期 id	none
»» cycleStartTime	string	true	none	时间段开始时间	none
»» cycleEndTime	string	true	none	时间段结束时间	none
»» powerPriceCycle	integer	true	none	电价周期类型（0：按月，1：自定义时段）	none
»» templateMethod	integer	true	none	电站当前电价类型（1：分时电价，2：固定电价，3：上网电价）	none
»» desulfurizedCoalPrice	null	true	none	上网电价（元）	none
»» contractPrice	null	true	none	固定电价（元）	none
»» sharpPrice	integer	true	none	尖自用电价（元）	none
»» peaksPrice	integer	true	none	峰自用电价（元）	none
»» flatPrice	integer	true	none	平自用电价（元）	none
»» valleysPrice	integer	true	none	谷自用电价（元）	none
»» deepValleysPrice	integer	true	none	深谷自用电价（元）	none
»» sharpSale	integer	true	none	尖自用电价折扣（%）	none
»» peaksSale	integer	true	none	峰自用电价折扣（%）	none
»» flatSale	integer	true	none	平自用电价折扣（%）	none
»» valleysSale	integer	true	none	谷自用电价折扣（%）	none
»» deepValleysSale	integer	true	none	深谷自用电价折扣（%）	none
» timestamp	integer	true	none		none

获取账单数据

接口描述

根据电站id和周期id获取某个月份的账单数据

请求方法

GET /sol-billing/plant-billing/detail

请求方式

GET

请求参数

名称	位置	类型	必选	说明
plantId	query	string	否	电站名称
powerPriceCycleId	query	string	否	周期 id
x-access-token	header	string	否	none

返回示例

{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": {
    "id": 2,
    "version": null,
    "isDelete": null,
    "createBy": null,
    "createTime": "2025-03-04 15:33:15",
    "updateBy": null,
    "updateTime": "2025-03-04 15:33:15",
    "plantName": "泰马鞋业",
    "plantId": 43226,
    "powerPriceCycleId": 87,
    "powerPriceCycle": 0,
    "year": 2025,
    "month": 3,
    "cycleStartTime": "2025-03-01",
    "cycleEndTime": "2025-04-01",
    "energySharp": 0,
    "energyPeaks": 0,
    "energyFlat": 0,
    "energyValleys": 0,
    "energyDeepValleys": 0,
    "energyMonth": 0,
    "energyUsedSharp": 0,
    "energyUsedPeaks": 0,
    "energyUsedFlat": 0,
    "energyUsedValleys": 0,
    "energyUsedDeepValleys": 0,
    "energyUsedMonth": 0,
    "tariffUsedSharp": 0,
    "tariffUsedPeaks": 0,
    "tariffUsedFlat": 0,
    "tariffUsedValleys": 0,
    "tariffUsedDeepValleys": 0,
    "tariffUsedMonth": 0,
    "energyOnlineSharp": 0,
    "energyOnlinePeaks": 0,
    "energyOnlineFlat": 0,
    "energyOnlineValleys": 0,
    "energyOnlineDeepValleys": 0,
    "energyOnlineMonth": 0,
    "tariffOnlineSharp": 0,
    "tariffOnlinePeaks": 0,
    "tariffOnlineFlat": 0,
    "tariffOnlineValleys": 0,
    "tariffOnlineDeepValleys": 0,
    "tariffOnlineMonth": 0,
    "energyPvUsedSharp": 0,
    "energyPvUsedPeaks": 0,
    "energyPvUsedFlat": 0,
    "energyPvUsedValleys": 0,
    "energyPvUsedDeepValleys": 0,
    "energyPvUsedMonth": 0
  },
  "timestamp": 1741075902672
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» success	boolean	true	none		none
» message	string	true	none		none
» code	integer	true	none		none
» result	object	true	none		none
»» id	integer	true	none		none
»» version	null	true	none		none
»» isDelete	null	true	none		none
»» createBy	null	true	none		none
»» createTime	string	true	none	创建时间	none
»» updateBy	null	true	none		none
»» updateTime	string	true	none	修改时间	none
»» plantName	string	true	none	电站名称	none
»» plantId	integer	true	none	电站 id	none
»» powerPriceCycleId	integer	true	none	周期 id	none
»» powerPriceCycle	integer	true	none	电价周期类型（0：按月，1：自定义时段）	none
»» year	integer	true	none	年	none
»» month	integer	true	none	月	none
»» cycleStartTime	string	true	none	时间段开始时间	none
»» cycleEndTime	string	true	none	时间段结束时间	none
»» energySharp	integer	true	none	尖发电量	none
»» energyPeaks	integer	true	none	峰发电量	none
»» energyFlat	integer	true	none	平发电量	none
»» energyValleys	integer	true	none	谷发电量	none
»» energyDeepValleys	integer	true	none	深谷发电量	none
»» energyMonth	integer	true	none	合计发电量	none
»» energyUsedSharp	integer	true	none	尖自用电量	none
»» energyUsedPeaks	integer	true	none	峰自用电量	none
»» energyUsedFlat	integer	true	none	平自用电量	none
»» energyUsedValleys	integer	true	none	谷自用电量	none
»» energyUsedDeepValleys	integer	true	none	深谷自用电量	none
»» energyUsedMonth	integer	true	none	合计自用电量	none
»» tariffUsedSharp	integer	true	none	尖自用电费	none
»» tariffUsedPeaks	integer	true	none	峰自用电费	none
»» tariffUsedFlat	integer	true	none	平自用电费	none
»» tariffUsedValleys	integer	true	none	谷自用电费	none
»» tariffUsedDeepValleys	integer	true	none	深谷自用电费	none
»» tariffUsedMonth	integer	true	none	合计自用电费	none
»» energyOnlineSharp	integer	true	none	尖上网电量	none
»» energyOnlinePeaks	integer	true	none	峰上网电量	none
»» energyOnlineFlat	integer	true	none	平上网电量	none
»» energyOnlineValleys	integer	true	none	谷上网电量	none
»» energyOnlineDeepValleys	integer	true	none	深谷上网电量	none
»» energyOnlineMonth	integer	true	none	合计上网电量	none
»» tariffOnlineSharp	integer	true	none	尖上网电费	none
»» tariffOnlinePeaks	integer	true	none	峰上网电费	none
»» tariffOnlineFlat	integer	true	none	平上网电费	none
»» tariffOnlineValleys	integer	true	none	谷上网电费	none
»» tariffOnlineDeepValleys	integer	true	none	深谷上网电费	none
»» tariffOnlineMonth	integer	true	none	合计上网电费	none
»» energyPvUsedSharp	integer	true	none		none
»» energyPvUsedPeaks	integer	true	none		none
»» energyPvUsedFlat	integer	true	none		none
»» energyPvUsedValleys	integer	true	none		none
»» energyPvUsedDeepValleys	integer	true	none		none
»» energyPvUsedMonth	integer	true	none		none
» timestamp	integer	true	none		none

获取账单周期列表

接口描述

根据电站id和年份获取电站当年的账单周期列表。

请求方法

/sol-billing/plant/power-price/cycle

请求方式

GET

请求参数

名称	位置	类型	必选	说明
plantId	query	string	否	电站 id
year	query	string	否	年
x-access-token	header	string	否	none

返回示例

{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": [
    {
      "id": 85,
      "version": null,
      "isDelete": null,
      "createBy": null,
      "createTime": "2025-03-04 15:21:05",
      "updateBy": null,
      "updateTime": "2025-03-04 15:21:05",
      "plantId": 43226,
      "year": 2025,
      "month": 1,
      "cycleStartTime": "2025-01-01",
      "cycleEndTime": "2025-02-01",
      "tariffCycle": 0
    },
    {
      "id": 86,
      "version": null,
      "isDelete": null,
      "createBy": null,
      "createTime": "2025-03-04 15:21:06",
      "updateBy": null,
      "updateTime": "2025-03-04 15:21:06",
      "plantId": 43226,
      "year": 2025,
      "month": 2,
      "cycleStartTime": "2025-02-01",
      "cycleEndTime": "2025-03-01",
      "tariffCycle": 0
    },
    {
      "id": 87,
      "version": null,
      "isDelete": null,
      "createBy": null,
      "createTime": "2025-03-04 15:21:06",
      "updateBy": null,
      "updateTime": "2025-03-04 15:21:06",
      "plantId": 43226,
      "year": 2025,
      "month": 3,
      "cycleStartTime": "2025-03-01",
      "cycleEndTime": "2025-04-01",
      "tariffCycle": 0
    }
  ],
  "timestamp": 1741075685702
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	none	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» success	boolean	true	none		none
» message	string	true	none		none
» code	integer	true	none		none
» result	[object]	true	none		none
»» id	integer	true	none	周期 id	none
»» version	null	true	none		none
»» isDelete	null	true	none		none
»» createBy	null	true	none		none
»» createTime	string	true	none	生成时间	none
»» updateBy	null	true	none		none
»» updateTime	string	true	none	修改时间	none
»» plantId	integer	true	none	电站 id	none
»» year	integer	true	none	年	none
»» month	integer	true	none	月	none
»» cycleStartTime	string	true	none	时段开始时间	none
»» cycleEndTime	string	true	none	时段结束时间	none
»» tariffCycle	integer	true	none	周期类型（0：按月，1：自定义时段）	none
» timestamp	integer	true	none		none