jsowell-charger-web/doc/运营小程序接口文档.md

查询站点的数据统计

接口地址：http://localhost:8080/business/pile/station/getStationStatisticsInfos

请求方式：POST

入参

字段名	类型	是否必传	备注
merchantId	String	N	运营商id
stationIds	List	N	站点id列表
startTime	String	N	开始时间
endTime	String	N	结束时间

反参

字段名	类型	是否必传	备注
stationStatisticsInfos	List	Y	站点统计信息集合

StationStatisticsInfo

字段名	类型	是否必传	备注
stationId	String	Y	站点id
stationName	String	Y	站点名称
chargeDegree	BigDecimal	Y	充电度数（度）
chargeAmount	BigDecimal	Y	充电总金额（元）
orderQuantity	Integer	Y	订单数量（单）
connectorAvailability	String	Y	==充电枪可使用率（%）==
chargingConnectorNum	Integer	Y	充电中（枪口数量）
freeConnectorNum	Integer	Y	空闲（枪口数量）
occupiedConnectorNum	Integer	Y	占用（枪口数量）
hangingConnectorNum	Integer	Y	挂起（枪口数量）
offlineConnectorNum	Integer	Y	离线（枪口数量）
faultConnectorNum	Integer	Y	故障（枪口数量）

站点经营分析统计图

接口地址：http://localhost:8080/business/pile/station/getStationBusinessAnalyzeInfo
接口地址(12个月数据)：http://localhost:8080/business/pile/station/getStationMonthlyBusinessAnalyzeInfo  

请求方式：POST

入参

字段名	类型	是否必传	备注
dateTime	String	N	不传时默认查周期列表数据，传入时为用户选中某一天的日期
type	String	N	日期类型（1-近7天；2-近30天）
stationIds	List	Y	站点id列表

反参

字段名	类型	是否必传	备注
electricityGrowthRate	String	Y	充电量增长率
orderAmountGrowthRate	String	Y	订单金额增长率
serviceAmountGrowthRate	String	Y	服务费增长率
businessOrderDetailInfoVOList	List	N	运营端小程序订单详情List
settleOrderReportList	List	N	结算订单报表List

businessOrderDetailInfoVO

字段名	类型	是否必传	备注
tradeDate	String	Y	交易日期(yyyy-MM-dd)
sharpUsedElectricity	BigDecimal	Y	尖时段用电量
sharpAmount	BigDecimal	Y	尖时段总金额
sharpElectricityPrice	BigDecimal	Y	尖时段电费
peakUsedElectricity	BigDecimal	Y	峰时段用电量
peakAmount	BigDecimal	Y	峰时段总金额
peakElectricityPrice	BigDecimal	Y	峰时段电费
flatUsedElectricity	BigDecimal	Y	平时段用电量
flatAmount	BigDecimal	Y	平时段总金额
flatElectricityPrice	BigDecimal	Y	平时段电费
valleyUsedElectricity	BigDecimal	Y	谷时段用电量
valleyAmount	BigDecimal	Y	谷时段总金额
valleyElectricityPrice	BigDecimal	Y	谷时段电费
totalServiceAmount	BigDecimal	Y	总服务费
settleAmount	BigDecimal	Y	结算金额
totalUsedElectricity	BigDecimal	Y	总充电量

SettleOrderReport

字段名	类型	是否必传	备注
useElectricity	BigDecimal	Y	用电度数
totalAmount	BigDecimal	Y	收入金额
electricityAmount	BigDecimal	Y	电费金额
serviceAmount	BigDecimal	Y	服务费金额

站点充点分布统计图

接口地址：

请求方式：

入参

字段名	类型	是否必传	备注

反参

字段名	类型	是否必传	备注
		Y	时间（小时）
		Y	每个时段的充电量（度）
		Y	时段充电量同比增长率（%）

站点订单趋势统计图

接口地址：http://localhost:8080/business/pile/station/getStationOrderQuantityInfo

请求方式：POST

入参

字段名	类型	是否必传	备注
stationIds	List	Y	站点id数组
type	String	Y	日期类型（1-近7天；2-近30天；3-近一年）
dateTime	String	N	用户选中某天的日期

反参

字段名	类型	是否必传	备注
stationOrderQuantityInfoList	List	Y	站点订单数量趋势信息
orderNumRateGrowthRate	String	Y	每天订单数量同比增长率（%）

StationOrderQuantityInfo

字段名	类型	是否必传	备注
tradeDate	String	Y	交易日期
orderNumber	int	Y	订单数量

站点利用率趋势统计图

接口地址：http://localhost:8080/business/pile/station/getStationConnectorUsedInfo

请求方式：POST

入参

字段名	类型	是否必传	备注
stationIds	List	Y	站点id数组
type	String	Y	日期类型（1-近7天；2-近30天；3-近一年）
dateTime	String	N	用户选中某天的日期

反参

字段名	类型	是否必传	备注
connectorUsedRiseRate	String	Y	枪口利用率增长值
List	BusinessOrderDetailInfoVO	Y	运营端订单详情

BusinessOrderDetailInfoVO

字段名	类型	是否必传	备注
tradeDate	String	Y	交易日期
chargeNum	int	Y	充电次数（枪口使用次数）

站点充电实况列表

接口地址：http://localhost:8080/business/pile/connector/getBusinessConnectorInfoList

请求方式：POST

入参

字段名	类型	是否必传	备注
stationId	String	Y	站点id
connectorStatus	String	N	枪口状态（0：离网 ；1：空闲；2：占用（未充电）；3：占用（充电中）；4：占用（预约锁定）即挂起 ；255：故障
pageNum	Integer	N	页码
pageSize	Integer	N	每页条数

反参

字段名	类型	是否必传	备注
		Y	站点名称
connectorNum	Integer	Y	全部枪口数量
chargingConnectorNum	Integer	Y	充电中枪口数量
freeConnectorNum	Integer	Y	空闲枪口数量
hangingConnectorNum	Integer	Y	挂起枪口数量
occupiedConnectorNum	Integer	Y	占用枪口数量
offlineConnectorNum	Integer	Y	离线枪口数量
faultConnectorNum	Integer	Y	故障枪口数量
pileConnectorInfoVOList	List	Y	枪口信息数组

PileConnectorInfoVO

字段名	类型	是否必传	备注
pileConnectorCode	String	Y	充电枪编号
SOC	String	Y	充电中soc（%）
timeRemaining	String	Y	充电中充满剩余时长（分钟）
chargingTime	String	Y	已充时长
faultReason	String	Y	故障原因

站点充电实况搜索

接口地址：

请求方式：

入参

字段名	类型	是否必传	备注
		Y	充电枪编号

反参

字段名	类型	是否必传	备注
		Y	充电枪编号
		Y	当前状态
		Y	当前状态时长

充电枪情况

请求地址：

请求方式：

入参

字段名	类型	是否必传	备注

反参

字段名	类型	是否必传	备注
		Y	已充时长（充电中）
		Y	最新订单启动时间
		Y	充电度数（充电中：以充电度数 / 最新订单充电度数）
		Y	起止SOC

充电枪情况中订单详情

请求地址：

请求方式：

入参

字段名	类型	是否必传	备注

反参

字段名	类型	是否必传	备注
		Y	创建订单时间
		Y	开始充电时间
		Y	充电完成时间
		Y	充电完成原因
		Y	生成账单时间
		Y	支付完成时间
		Y	结算完成时间
		Y	订单号
		Y	场站名称
		Y	订单来源
		Y	外部订单号
		Y	启动方式
		Y	充电桩号
		Y	充电枪口号
		Y	结束SOC（%）
		Y	时长（分钟）
		Y	充电量（度）
		Y	停止原因

1、在 ==站点管理== ——> ==运营管理== 中勾选浙江省平台，点击保存按钮

2、在 ==三方平台管理== ——> ==对接第三方平台关系== 页面中找到浙江省平台，点击 ==同步数据==，找到对应站点，点击 ==打开推送菜单== 页面， 点击右侧 ==推送充电站信息变化== 右侧的 ==推送== 按钮