电控、圈存文档修改
diff --git "a/source/_posts/\344\270\200\345\215\241\351\200\232v5\345\234\210\345\255\230\345\257\271\346\216\245\345\211\215\347\275\256\346\216\245\345\217\243\346\226\207\346\241\243.md" "b/source/_posts/\344\270\200\345\215\241\351\200\232v5\345\234\210\345\255\230\345\257\271\346\216\245\345\211\215\347\275\256\346\216\245\345\217\243\346\226\207\346\241\243.md"
index 206d906..c084577 100644
--- "a/source/_posts/\344\270\200\345\215\241\351\200\232v5\345\234\210\345\255\230\345\257\271\346\216\245\345\211\215\347\275\256\346\216\245\345\217\243\346\226\207\346\241\243.md"
+++ "b/source/_posts/\344\270\200\345\215\241\351\200\232v5\345\234\210\345\255\230\345\257\271\346\216\245\345\211\215\347\275\256\346\216\245\345\217\243\346\226\207\346\241\243.md"
@@ -34,14 +34,17 @@
* **请求参数**
- `bankcardno` - 银行账号（银行卡号）
+- `bankcode` - 银行代码 如：ICBC、ABC、BOC
- `custname` - 用户姓名，必须是该用户在银行的开户名（可选）
-- `stuempno` - 系统唯一号，如学工号、客户号（可选）
+- `custid` - 系统唯一号，客户号（可选）
+- `stuempno` - 系统唯一号，如学工号（可选）
+- `idtype` - 证件类型（可选）
- `idno` - 身份证号（可选）
- `termid` - 发起终端号（可选）
- `tradetime` - 发起方时间，格式 yyyyMMddHHmmss
- `seqno` - 发起方流水号（可选）
- `timeout` - (可选）前置机与银行通讯的超时时间，单位秒，范围 1 ~ 90 , 默认值为10
-- `sign` - 签名。除sign的非空字段按上述顺序拼接进行签名加密，如（bankcardno+stuempno+termid+tradetime+timeout）。
+- `sign` - 签名。除sign的非空字段按上述顺序拼接进行签名加密，如（bankcardno + bankcode + custid +stuempno+idtype+idno+termid+tradetime+timeout）。
* **返回**
- `retcode` - "0" 标识操作成功，其余为异常情况
@@ -57,7 +60,7 @@
### 1. 查询银行卡余额
-* **URL: .../bankservice/{bank}/bankquery**
+* **URL: .../bankservice/{bank}/bankbalquery**
* **请求方式**
`POST`
@@ -67,13 +70,15 @@
* **请求参数**
- `bankcardno` - 银行账号（银行卡号）
- `custname` - 用户姓名，必须是该用户在银行的开户名（可选）
-- `stuempno` - 系统唯一号，如学工号、客户号（可选）
+- `custid` - 系统唯一号，客户号 （可选）
+- `stuempno` - 系统唯一号，如学工号（可选）
+- `idtype` - 证件类型（可选）
- `idno` - 身份证号（可选）
- `termid` - 发起终端号（可选）
- `tradetime` - 发起方时间，格式 yyyyMMddHHmmss
- `seqno` - 发起方流水号（可选）
- `timeout` - (可选）前置机与银行通讯的超时时间，单位秒，范围 1 ~ 90 , 默认值为10
-- `sign` - 签名。除sign的非空字段按上述顺序拼接进行签名加密，如（bankcardno+stuempno+termid+tradetime+timeout）。
+- `sign` - 签名。除sign的非空字段按上述顺序拼接进行签名加密，如（bankcardno+ custid +stuempno+idtype+idno+termid+tradetime+timeout）。
* **返回**
- `retcode` - "0" 标识操作成功，其余为异常情况
@@ -98,15 +103,19 @@
* **请求**
- `bankcardno` - 银行卡号
+- `bankcardpwd` - 银行卡密码（可选）
+- `extdata` - 银行卡扩展信息
- `refno` - 系统交易参考号
-- `stuempno` - 系统唯一号，如学工号、客户号
+- `stuempno` - 系统唯一号，如学工号（可选）
+- `custid` - 系统唯一号，如客户号 （可选）
- `custname` - 客户姓名(可选）
-- `idno` - 客户姓名(可选）
+- `idtype` - 证件类型(可选）
+- `idno` - 身份证号(可选）
- `amount` - 圈存金额，单位分（整数）
- `termid` - 终端编号（可选）
- `tradetime` - 请求时间， 格式yyyyMMddHHmmss
- `timeout` - (可选）前置机与银行通讯的超时时间，单位秒，范围 1 ~ 90 , 默认值为10
-- `sign` 签名。除sign的非空字段按上述顺序拼接进行签名加密，如（bankcardno+refno+stuempno+idno+amount+termid+ tradetime+timeout）。
+- `sign` 签名。除sign的非空字段按上述顺序拼接进行签名加密，如（bankcardno+refno+custid+stuempno+idtype+idno+amount+termid+ tradetime+timeout）。
* **返回**
- `retcode` - "0" 标识操作成功，其余为异常情况
@@ -131,15 +140,18 @@
* **请求**
- `bankcardno` - 银行卡号
+- `extdata` - 银行卡扩展信息
- `refno` - 系统交易参考号
- `stuempno` - (可选）学工号
+- `custid` - （可选）客户号
- `custname` - (可选）客户姓名
+- `idtype` - (可选）证件类型
- `idno` - (可选）身份证号码
-- `amount` - 圈存金额，单位分（整数）
- `termid` - （可选）终端编号
- `tradetime` - 请求时间， 格式yyyyMMddHHmmss
- `timeout` - (可选）前置机与银行通讯的超时时间，单位秒，范围 1 ~ 90 , 默认值为10
-- `sign` - 签名。除sign的非空字段按上述顺序拼接进行签名加密。
+- `sign` - 签名。除sign的非空字段按上述顺序拼接进行签名加密。如（bankcardno+refno+custid+stuempno+idtype+idno+termid+ tradetime+timeout）。
+
* **返回**
- `retcode` - "0" 标识查询到指定的圈存流水,并交易成功；"01" 标识无指定流水，其它表示错误
@@ -164,16 +176,19 @@
* **请求**
- `bankcardno` - 银行卡号
+- `extdata` - 银行卡扩展信息
- `refno` - 系统交易参考号
- `reverserefno` - 前一笔要冲正的圈存交易的参考号
- `stuempno` - (可选）学工号
+- `custid` - （可选）客户号
- `custname` - (可选）客户姓名
+- `idtype` - (可选）证件类型
- `idno` - (可选）身份证号
- `amount` - 金额，单位分（整数）
- `termid` - （可选）终端编号
- `tradetime` - 请求时间， 格式yyyyMMddHHmmss
- `timeout` - (可选）前置机与银行通讯的超时时间，单位秒，范围 1 ~ 90 , 默认值为10
-- `sign` 签名。除sign的非空字段按上述顺序拼接进行签名加密
+- `sign` 签名。除sign的非空字段按上述顺序拼接进行签名加密。（bankcardno+refno+ reverserefno +custid+stuempno+idtype+idno+ amount +termid+ tradetime+timeout）。
* **返回**
- `retcode` - "0" 标识冲正成功，其它表示错误
@@ -198,12 +213,13 @@
* **请求**
- `transdate` - 查询日期，yyyyMMdd
-- `bankid` - 银行标识
+- `bankcode` - 银行标识
- `billtype` - 查询类型,有的银行圈存转账和退款可能是分开的。"ALL"-查询圈存和冲正（退款）所有交易成功的流水;"SUCCESS"-查询圈存交易成功的流水;"REFUND"-查询冲正（退款）所有交易成功的流水。
- `offset` - 偏移量，int型，初始为0
- `tradetime` - 请求时间， 格式yyyyMMddHHmmss
- `timeout` - (可选）前置机与银行通讯的超时时间，单位秒，范围 1 ~ 90 , 默认值为10
-- `sign` 签名。除sign的非空字段按上述顺序拼接进行签名加密
+- `checkagain` - 重新对账标志，1-是重新对账；0-不是
+- `sign` 签名。除sign的非空字段按上述顺序拼接进行签名加密（transdate + bankcode + billtype + offset + tradetime + timeout + checkagain）。
* **返回**
- `retcode` - "0" 标识冲正成功，其它表示错误
@@ -218,6 +234,7 @@
- `refno` - 系统交易参考号，
- `bankseqno` - 银行端流水号
- `amount` - 交易金额，单位元
+ - `billtype` - 圈存或冲正的标志。（'SUCCESS'-圈存成功流水；‘BEREFD’-被冲正的圈存流水; -'REFUND'-冲正流水）
```json
@@ -225,7 +242,7 @@
"retcode":"0",
"retmsg":"msg", // 返回信息
"hasnext":true，
- "offset":99,
+ "offset":100,
"data":[
{
"transdate":"20160901",
@@ -234,9 +251,9 @@
"bankcardno":"6022111001004394733",
"refno":"20160901142328000023",
"bankseqno":"1020160901142328130713",
- "amount":50.0
+ "amount":50.0,
+ "billtype":"SUCCESS"
},...]
}
```
-
diff --git "a/source/_posts/\344\270\200\345\215\241\351\200\232v5\347\224\265\346\216\247\345\257\271\346\216\245\345\211\215\347\275\256\346\216\245\345\217\243\346\226\207\346\241\243.md" "b/source/_posts/\344\270\200\345\215\241\351\200\232v5\347\224\265\346\216\247\345\257\271\346\216\245\345\211\215\347\275\256\346\216\245\345\217\243\346\226\207\346\241\243.md"
index 51c490b..a983873 100644
--- "a/source/_posts/\344\270\200\345\215\241\351\200\232v5\347\224\265\346\216\247\345\257\271\346\216\245\345\211\215\347\275\256\346\216\245\345\217\243\346\226\207\346\241\243.md"
+++ "b/source/_posts/\344\270\200\345\215\241\351\200\232v5\347\224\265\346\216\247\345\257\271\346\216\245\345\211\215\347\275\256\346\216\245\345\217\243\346\226\207\346\241\243.md"
@@ -7,7 +7,8 @@
|日期 |版本 |作者 |说明 |
|------------:|---------:|-----------:|------------------|
-|2017-2-13 |V1.0 | 夏凯祥 | 初稿 |
+|2017-02-13 |V1.0 | 夏凯祥 | 初稿 |
+|2017-07-05 |V1.1 | 夏凯祥 | 多套电控、转账接口修改、增加对账单|
## 背景
@@ -19,7 +20,7 @@
1. 传输编码统一为utf-8
2. **retcode** 等于"0"（字符串）表示成功，其他表示失败，失败具体信息查看 **msg**
3. 宿舍房间在一卡通中规定了五级，校区（area）/区域（district）/楼栋（build）/楼层（floor）/房间（room）。级别不符合的请修改适应此规则。
-4. {elecsystem} 电控系统代码，区分多套电控
+4. {elecsystem} 电控系统代码，区分多套电控。如新开普电控，标识为newcapec,则前置对应校区查询url为：.../elec/newcapec/getareas;区域为：.../elec/newcapec/getdistricts 等等。
## 接口定义
@@ -242,11 +243,16 @@
- `area` - 查询校区返回的areaId
- `bui` - 查询楼栋返回的buiId
- `room` - 查询房间返回的roomId
-- `cust` - 系统唯一号，学工号或客户号
+- `cust` - 客户唯一号 （兼容以前版本）,空时填0
+- `custid` - 系统唯一号，客户号（与stuempno，可选）,空时填0
+- `stuempno` - 系统唯一号，学工号（与custid，可选）,空时填0
+- `custname` - 姓名（可选）,空时填0
+- `cardno` - 卡号 （可选）,空时填0
- `amount` - 转账金额，单位分
+- `accdate` -记账日期。对账时用accdate获取电控对账单
- `transtime` - 交易时间
-- `transno` - 系统的交易参考号
-- `sign` - 按上面参数顺序拼接最后加上秘钥进行MD5加密。（area + bui + room + cust + amount + transtime + transno + elec_key）
+- `refno` - 系统的交易参考号 (原 transno)
+- `sign` - 按上面参数顺序拼接最后加上秘钥进行MD5加密。（area + bui + room + cust + amount + transtime + refno + elec_key）
* **返回**
- `retcode` - "0" 标识操作成功，其余为异常情况
@@ -259,3 +265,63 @@
"msg":"成功", // 异常原因
}
```
+
+### 8、获取电费转账流水（对账单）
+* **URL**: .../epayapi/services/elecfee/thirdparty/queryelecdtl
+
+* **请求方式**
+ `POST`
+
+*API提供按记账日期（转账时的accdate字段）查询当天所有交易成功的电控转账流水。供第三方查询对账用*
+
+* **请求**
+- `accdate` - 记账日期
+- `elecsystem` - 电控系统的标识
+- `offset` - 偏移量，int型，初始为0
+- `timestamp` - 请求时间， 格式yyyyMMddHHmmss
+- `sign` - 按上面参数顺序拼接最后加上秘钥进行MD5加密(accdate + [elecsystem] + offset + timestamp + elec_key)
+
+* **返回**
+- `retcode` - "0" 标识操作成功，其余为异常情况
+- `retmsg` - "OK" 返回信息
+- `hasnext` - true或false。是否继续查询的标志。true继续查询，false结束查询
+- `offset` - 继续查询时的偏移量，int型。
+- `data` - 流水数据集合。
+ - `transdate` - 交易日期 yyyyMMdd
+ - `transtime` - 交易时间 HHmmss
+ - `refno` - 系统交易参考号，
+ - `accdate` - 记账日期，
+ - `amount` - 交易金额，单位元
+ - `stuempno` - 学工号
+ - `custid` - 客户号
+ - `custname` - 姓名
+ - `cardno` - 卡号。APP、网页等支付时cardno=0
+ - `revflag` - 冲正标志。1-被冲正；0-未被冲正
+ - `area` - 校区 areaId
+ - `bui` - 楼栋 buiId
+ - `room` - 房间 roomId
+
+```json
+{
+ "retcode":"0",
+ "retmsg":"msg", // 返回信息
+ "hasnext":true，
+ "offset":100,
+ "data":[
+ {
+ "transdate":"20160901",
+ "transtime":"142328",
+ "refno":"20160901142328000023",
+ "accdate":"20160901",
+ "amount":20.0,
+ "stuempno":"20170001",
+ "custid":1000234,
+ "custname":"测试人员",
+ "cardno":0,
+ "revflag":0,
+ "area":"1",
+ "bui":"102",
+ "room":"1101"
+ },...]
+}
+```