注意事项: 以结束充电时间作为时间范围依据,接口返回所有订单组成的csv文件的下载地址,一天进行一次对账。优行科技在每天凌晨4点开始请求桩企校对昨天的订单
具体作用: 用来进行电量对账
接口名称: syncOrders
请求参数
参数名称 | 类型 | 备注 |
---|---|---|
data | String | 加密后的数据 |
timeStamp | number | 秒级时间戳 |
seq | String | 请求序列:接口每秒的请求递增计数,格式为yyyMMddhhmmss+四位递增计数 |
token | String | 凭证:32位字符串,认证接口(queryToken)不需要此参数 |
sign | String | data+timeStamp组成的参数签名 |
data:
参数名称 | 类型 | 是否必填 | 备注 |
---|---|---|---|
date | String | Y | 对账日期:yyyy-MM-dd |
示例
{
"data": {
"date": "2017-06-22"
},
"timeStamp": 1505374350,
"seq": "201709141214150001",
"token": "94b879e509a8e20821c7587aad53c19f",
"sign": "8D5AD1A57D30956CC946CFFDFCFD4AE3"
}
响应参数
子类 | 返回参数名 | 类型 | 备注 |
---|---|---|---|
code | int | 整数类型,成功: 100 失败: 400,更多状态描述请看第6章:状态描述 | |
data | url | String | csv文件下载地址(必须为http或https协议不支持FTP)鉴于安全原因,建议链接有效期小于10分钟文件命名规范:appId+横杆+日期(yyyyMMdd).csv |
示例
{
"data": {
"url":"http://test.com/310000001-20170622.csv"
},
"code": 100
}
CSV文件格式
注意事项
CSV文件格式,可以在本地用excel软件打开一下,如果是非纯CSV格式的文件,excel虽然能正常打开但是会有提示弹框,本接口只接受纯CSV文件
CSV中的chargeDetails列,因为数据中含有逗号,而CSV文件是以逗号作为列分割符,因此需要对该列进行转义,对该列数据多加一层双引号;数据中有双引号的需要再加上一层双引号。
如:[{"detailStartTime":"2017-03-06 08:05:16","detailEndTime":"2017-03-06 09:00:00"}] 的数据,
用程序生成时应该写成
"[{""detailStartTime"":""2017-03-06 08:05:16"", ""detailEndTime"":""2017-03-06 09:00:00""}]"
orderId | outOrderId | beginTime | endTime | power | fee | chargeDetails |
---|---|---|---|---|---|---|
148878924804013004013 | 201703061634082811 | 2017-03-06 08:05:16 | 2017-03-06 10:15:00 | 20.00 | 30.30 | [{"detailStartTime":"2017-03-06 08:05:16","detailEndTime":"2017-03-06 09:00:00","detailPower":8.50,"feeElectric":0.60,"feeService":0.80,"outFeeElectric":0.60,"outFeeService":1.00},{"detailStartTime":"2017-03-06 09:00:00","detailEndTime":"2017-03-06 10:15:00","detailPower":11.50,"feeElectric":0.80,"feeService":0.80,"outFeeElectric":0.80,"outFeeService":1.00}] |