对账接口

注意事项: 以结束充电时间作为时间范围依据,接口返回所有订单组成的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文件格式

  • orderId:桩企订单编号
  • outOrderId:优行科技订单编号
  • beginTime:24小时制!开始充电时间yyyy-MM-dd HH:mm:ss
  • endTime:24小时制!结束充电时间yyyy-MM-dd HH:mm:ss
  • power:充电总电量,精确到4位小数
  • fee:单个订单总金额(单位:元,精确两位),包含充电金额和服务费,按协商价格计算
  • chargeDetails.detailStartTime:24小时制!区间充电的开始时间yyyy-MM-dd HH:mm:ss
  • chargeDetails.detailEndTime:24小时制!区间充电的结束充电时间yyyy-MM-dd HH:mm:ss
  • chargeDetails.detailPower:区间充电电量,需要精确到4位小数
  • chargeDetails.feeElectric:与优行科技协商的电量费用(单价:元),精确到4位小数
  • chargeDetails.feeService:与优行科技协商的服务费用(单价:元),精确到4位小数
  • chargeDetails.outFeeElectric:桩企对外展示的电费费用(单价:元),精确到4位小数
  • chargeDetails.outFeeService:桩企对外展示的服务费费用(单价:元),精确到4位小数

注意事项

  • 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}]