Alawn/cap-wiki
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

ci

Browse Source
This commit is contained in:
Alawn
2021-01-15 09:45:44 +08:00
parent 04829e6a1e
commit 2f5bba95dd
2 changed files with 69 additions and 197 deletions
Download Patch File Download Diff File Expand all files Collapse all files
content/docs/API/HRO接口文档.md
+63 -194
View File
@@ -12,7 +12,8 @@ weight: 1
版本号 | 更新日期 | 更新人 | 更新内容
--- | --- | --- | ---
v0.5 | 2021-01-13 | 赵磊 | diskResult/diskNotify增加diskMessage
v0.6 | 2021-01-14 | 赵磊 | 明确交易状态；增加批次失败信息；调整附言位置；
v0.5 | 2021-01-13 | 赵磊 | diskResult/diskNotify增加diskMessage；增加账户类型
v0.4 | 2021-01-12 | 赵磊 | refundQuery增加页码、总页数、当前页码
v0.3 | 2021-01-11 | 赵磊 | titleSync去除费项代码，增加账户类型
v0.2 | 2021-01-11 | 赵磊 | 支付地增加代付默认配置
@@ -66,7 +67,7 @@ bodyStream 为字节数组
<diskNo>20201229000000000000000000000001</diskNo> <!--磁盘编号-->
<filePath>/data/send/20201229000000000000000000000001</filePath> <!--文件名-->
<fileVersion>v1</fileVersion> <!--文件版本-->
<customerId>OHJEMIA1EINGUGAH0AITHOHNUEYAHWOO</customerId> <!--客户编号-->
<customerId>OHJEMIA1EINGUGAH0AITHOHNUEYAHWOO</customerId> <!--客户ID-->
<titleId>1000001</titleId> <!--支付地抬头ID-->
<md5>c5950a259435d3e51262539a10a22910</md5> <!--磁盘MD5值-->
</body>
@@ -100,6 +101,7 @@ bodyStream 为字节数组
8 | cardInfoQuery | 卡信息查询 | HRO -> 沐融代付 | Y
### 公共请求/响应头
- 请求
字段名称 | 类型 | 必输 | 描述 | 备注
@@ -146,13 +148,12 @@ bodyStream 为字节数组
--- | --- | :----: | ---- | ---
applyDate | VARCHAR(8) | M | 送盘日期 | eg. 20201229
diskNo | VARCHAR(48) | M | 磁盘名称 | eg. 20201229000000000000000000000001
makeFile | VARCHAR(1) | O | 是否生成回盘文件 | eg. Y:是 N:否 默认N
- 返回
字段名称 | 类型 | 必输 | 描述 | 备注
--- | --- | :----: | ---- | ---
diskSts | VARCHAR(1) | M | 批次状态 | 0：接收中 9:接收失败 1：已接收完成 2: 批次处理中 3: 批次处理完成 4: 批次处理失败
diskSts | VARCHAR(1) | M | 批次状态 | 1：已接收完成 2: 批次处理中 3: 批次处理完成 4: 批次处理失败
diskMessage | VARCHAR(100) | M | 批次结果信息 |
lastDate | VARCHAR(8) | M | 最后更新日期 |
lastTime | VARCHAR(6) | M | 最后更新时间 |
@@ -175,7 +176,7 @@ bodyStream 为字节数组
字段名称 | 类型 | 必输 | 描述 | 备注
--- | --- | :----: | ---- | ---
diskNo | VARCHAR(48) | M | 磁盘名称 |
diskSts | VARCHAR(1) | M | 批次状态 | 0：接收中 9:接收失败 1：已接收完成 2: 批次处理中 3: 批次处理完成 4: 批次处理失败
diskSts | VARCHAR(1) | M | 批次状态 | 1：已接收完成 2: 批次处理中 3: 批次处理完成 4: 批次处理失败
diskMessage | VARCHAR(100) | M | 批次结果信息 |
lastDate | VARCHAR(8) | M | 最后更新日期 |
lastTime | VARCHAR(6) | M | 最后更新时间 |
@@ -221,7 +222,7 @@ bodyStream 为字节数组
acctNo | VARCHAR(48) | M | 账号 | 卡号、存折号
acctName | VARCHAR(150) | M | 姓名 |
transDate | VARCHAR(14) | M | 交易日期 |
transSts | VARCHAR(1) | M | 交易状态 | U：未处理 P：处理中 S：成功 F：失败 T：超时 X：未知错误
transSts | VARCHAR(1) | M | 交易状态 | 视银行返回结果定
amount | VARCHAR(18) | M | 金额 | 分为单位
refundCode | VARCHAR(5) | M | 退票代码 |
refundPs | VARCHAR(100) | M | 退票附言 |
@@ -235,9 +236,9 @@ bodyStream 为字节数组
字段名称 | 类型 | 必输 | 描述 | 备注
--- | --- | :----: | ---- | ---
customerId | VARCHAR(48) | M | 客户编号 |
customerId | VARCHAR(48) | M | 客户ID |
customerName | VARCHAR(100) | M | 客户名称 |
customerCode | VARCHAR(48) | M | 客户代码 |
customerCode | VARCHAR(48) | M | 客户编号 |
rank | VARCHAR(100) | M | 等级 | 数字1~3，数字越大代表等级越高
enabled | VARCHAR(1) | M | 是否启用 | Y：启用 N：停用
@@ -272,12 +273,12 @@ bodyStream 为字节数组
- 请求
字段名称 | 类型 | 必输 | 描述 | 备注
--- | --- | :----: | ---- | ---
applyDate | VARCHAR(8) | Y | 申请日期 |
refId | VARCHAR(48) | Y | 参考号 | HRO明细流水号
transSts | VARCHAR(1) | Y | 交易状态 | S：成功 F：失败 R：已退票
respMessage | VARCHAR(100) | Y | 响应信息 |
字段名称 | 类型 | 必输 | 描述 | 备注
--- | --- | :----: | ---- | ---
applyDate | VARCHAR(8) | Y | 申请日期 |
refId | VARCHAR(48) | Y | 参考号 | HRO明细流水号
transSts | VARCHAR(1) | Y | 交易状态 | S：成功 F：失败 R：已退票
remark | VARCHAR(100) | Y | 备注 | 此处可填修改状态的具体原因
- 返回
@@ -297,9 +298,9 @@ bodyStream 为字节数组
字段名称 | 类型 | 必输 | 描述 | 备注
--- | --- | :----: | ---- | ---
bankType | VARCHAR(4) | Y | 银行类型 |
cardType | VARCHAR(2) | Y | 卡类型 |
cardName | VARCHAR(100) | Y | 卡名称 |
bankType | VARCHAR(4) | Y | 银行类型 | 详见 [银行通道](#银行通道)
cardType | VARCHAR(2) | Y | 卡类型 |
cardName | VARCHAR(100) | Y | 卡名称 |
## 文件格式
@@ -307,27 +308,26 @@ bodyStream 为字节数组
- 首行
字段名称 | 类型 | 必输 | 描述 | 备注
--- | --- | :----: | ---- | ---
totalCount | VARCHAR(8) | Y | 总笔数 |
totalAmount | VARCHAR(18) | Y | 总金额 | 分为单位
titleId | VARCHAR(48) | Y | 支付地抬头ID |
customerId | VARCHAR(48) | Y | 客户编号 |
costItem | VARCHAR(5) | Y | 费项代码 | 01201:代发工资 04900:其他费用
字段名称 | 类型 | 必输 | 描述 | 备注
--- | --- | :----: | ---- | ---
totalCount | VARCHAR(8) | Y | 总笔数 |
totalAmount | VARCHAR(18) | Y | 总金额 | 分为单位
titleId | VARCHAR(48) | Y | 支付地抬头ID |
customerId | VARCHAR(48) | Y | 客户ID |
postscript | VARCHAR(100) | Y | 银行附言 |
- 循环体
字段名称 | 类型 | 必输 | 描述 | 备注
--- | --- | :----: | ---- | ---
acctNo | VARCHAR(48) | Y | 账号 | 卡号、存折号
acctName | VARCHAR(150) | Y | 姓名 |
refId | VARCHAR(48) | Y | 参考号 | HRO明细流水号
amount | VARCHAR(18) | Y | 金额 | 分为单位
bankName | VARCHAR(100) | Y | 银行类型 | 存折与大小额时必输
bankCity | VARCHAR(100) | Y | 开户行所在城市 | 存折与大小额时必输
bankName | VARCHAR(100) | Y | 开户银行网点 | 存折与大小额时必输
postscript | VARCHAR(100) | Y | 银行附言 |
remark | VARCHAR(100) | Y | 备注 |
字段名称 | 类型 | 必输 | 描述 | 备注
--- | --- | :----: | ---- | ---
acctNo | VARCHAR(48) | Y | 账号 | 卡号、存折号
acctName | VARCHAR(150) | Y | 姓名 |
refId | VARCHAR(48) | Y | 参考号 | HRO明细流水号
amount | VARCHAR(18) | Y | 金额 | 分为单位
bankType | VARCHAR(4) | Y | 银行类型 | 详见 [银行通道](#银行通道)
bankCity | VARCHAR(100) | Y | 开户行所在城市 | 存折与大小额时必输
bankName | VARCHAR(100) | Y | 开户银行网点 | 存折与大小额时必输
remark | VARCHAR(100) | Y | 备注 |
### 回盘
@@ -342,12 +342,14 @@ bodyStream 为字节数组
failCount | VARCHAR(8) | Y | 失败笔数 |
failAmount | VARCHAR(18) | Y | 失败金额 | 分为单位
titleId | VARCHAR(48) | Y | 支付地抬头ID |
customerId | VARCHAR(48) | Y | 客户编号 |
customerId | VARCHAR(48) | Y | 客户ID |
- 循环体
字段名称 | 类型 | 必输 | 描述 | 备注
--- | --- | :----: | ---- | ---
applyDate | VARCHAR(8) | Y | 申请日期 |
lastTime | VARCHAR(14) | M | 最后更新时间 | eg. 20210111
acctType | VARCHAR(2) | Y | 账号类型 | 01：借记卡 02：贷记卡 03：准贷记卡 00：其他
acctNo | VARCHAR(48) | Y | 账号 | 卡号、存折号
acctName | VARCHAR(150) | Y | 姓名 |
@@ -355,96 +357,38 @@ bodyStream 为字节数组
refId | VARCHAR(48) | Y | 参考号 | HRO明细流水号
bankRefId | VARCHAR(48) | Y | 银行流水号 |
amount | VARCHAR(18) | Y | 金额 | 分为单位
bankType | VARCHAR(10) | N | 银行类型 |
bankName | VARCHAR(50) | N | 银行名称 |
postscript | VARCHAR(100) | N | 银行附言 |
payerAcctNo | VARCHAR(48) | Y | 出款账号 |
payerAcctName | VARCHAR(100) | Y | 出款户名 |
orgNo | VARCHAR(100) | N | 合作机构编号 |
orgNo | VARCHAR(100) | N | 合作机构编号 | 详见 [银行通道](#银行通道)
remark | VARCHAR(100) | Y | 备注 |
transSts | VARCHAR(1) | Y | 明细状态 | U：未处理 S：成功 P：处理中 F：失败 T：超时 X：未知错误
respMessage | VARCHAR(100) | Y | 返回信息 |
transSts | VARCHAR(1) | Y | 明细状态 | S：成功 F：失败
transMessage | VARCHAR(100) | Y | 业务信息 | 当transSts = F时该字段返回错误信息
### 对账
- 循环体
字段名称 | 类型 | 必输 | 描述 | 备注
--- | --- | :----: | ---- | ---
applyDate | VARCHAR(8) | Y | 申请日期 |
transId | VARCHAR(48) | Y | 业务平台流水号 | 沐融交易流水号
refId | VARCHAR(48) | Y | 参考号 | HRO明细流水号
bankRefId | VARCHAR(48) | Y | 银行流水号 |
payerAcctNo | VARCHAR(48) | Y | 出款账号 |
payerAcctName | VARCHAR(100) | Y | 出款户名 |
acctNo | VARCHAR(48) | Y | 账号 | 卡号、存折号
acctName | VARCHAR(150) | Y | 姓名 |
amount | VARCHAR(18) | Y | 金额 | 分为单位
orgNo | VARCHAR(100) | N | 合作机构编号 | 详见 [银行通道](#银行通道)
transSts | VARCHAR(1) | Y | 明细状态 | S：成功 P：处理中
transMessage | VARCHAR(100) | Y | 业务信息 |
## 附录
### 费项代码
代码(costItem) | 说明
----- | ----
00000 | 通用费项
00100 | 电费
00201 | 用水费
00202 | 排水费
00204 | 污水处理费
00205 | 暖气费
00206 | 冷气费
00207 | 垃圾处理费
00208 | 环卫费
00302 | 燃气费
00400 | 电话费
00500 | 通讯费
00501 | 数据通讯费
00503 | 代维费
00504 | 网络使用费
00505 | 信息服务费
00600 | 保险费
00607 | 保险赔付金
00608 | 托底安置补贴
00609 | 住房公积金
00700 | 房屋管理费
00701 | 房屋租赁费
00702 | 租赁服务费
00703 | 物业管理费
00704 | 清洁费
00705 | 保安服务费
00706 | 电梯维护保养费
00707 | 绿化费
00708 | 停车费
00709 | 物业专项维修金
00710 | 公路规费
00711 | 港口建设费
00712 | 高速公路费
00713 | 交通罚没款
00800 | 代理服务费
00801 | 押运服务费
00802 | 票据传递费
00803 | 代理记账服务费
00900 | 学教费
00901 | 报考费
00902 | 学杂费
00903 | 保教费
00904 | 劳务费
00905 | 培训补贴
01000 | 有线电视费
01002 | 移动电视费
01003 | 传输服务费
01100 | 企业管理费用
01101 | 工商行政管理费
01102 | 商检费
01103 | 返代扣缴税手续费
03000 | 国库汇款
03001 | 国库退库
03002 | 财政拨款
04901 | 土地使用费
04902 | 加油卡费
04903 | 消费贷款
04904 | 代付货款
04905 | 血款
04906 | 付手续费
04907 | 广告费
04908 | 邮费
04910 | 速递费
01200 | 薪金报酬
01201 | 工资
01202 | 奖金
01203 | 养老金
07001 | 福利彩票
07100 | 证券基金
07101 | 基金申认购
07102 | 基金赎回/分红/撤单/退款
07104 | 基金垫支
09001 | 费用（报销）
04900 | 其他费用
### 响应码
应答码(respCode) | 描述(respMessage)
@@ -673,81 +617,6 @@ GYCB | 0443 | 贵阳银行
CSCB | 0461 | 长沙银行
BRCB | 1418 | 北京农村商业银行
### 联行号
银行代码 | 联行号（总行） | 银行名称
--- | --- | ---
ICBC | 102100099996 | 中国工商银行
ABC | 103100000026 | 中国农业银行
BOC | 104100000004 | 中国银行
CCB | 105100000017 | 中国建设银行
BCOM | 301290000007 | 交通银行
CITI | 302100011000 | 中信银行
CEB | 303100000006 | 中国光大银行
HXB | 304100040000 | 华夏银行
CMBC | 305100000013 | 中国民生银行
CGB | 306581000003 | 广发银行
PAB | 307584007998 | 平安银行（原深圳发展银行）
CMB | 308584000013 | 招商银行
CIB | 309391000011 | 兴业银行
SPDB | 310290000013 | 浦发银行
EBCL | 315456000105 | 恒丰银行
CZB | 316331000018 | 浙商银行
CBHB | 318110000014 | 渤海银行
HSCB | 319361000013 | 徽商银行
PSBC | 403100000004 | 中国邮政储蓄银行
BOS | 313290000017 | 上海银行
BOB | 313100000013 | 北京银行
NBCB | 313332082914 | 宁波银行
JSCB | 313301099999 | 江苏银行
TCCB | 313110000017 | 天津银行
HBCB | 313121006888 | 河北银行
XTCCB | 313131000016 | 邢台银行
ZJKCB | 313138000019 | 张家口市商业银行
CDCB | 313141052422 | 承德银行
CZCB | 313143005157 | 沧州银行
IMCB | 313191000011 | 内蒙古银行
BSB | 313192000013 | 包商银行
ESB | 313205057830 | 鄂尔多斯银行
DLCB | 313222080002 | 大连银行
YKCB | 313228000276 | 营口银行
JLCB | 313241066661 | 吉林银行
HRBCB | 313261000018 | 哈尔滨银行
BON | 313301008887 | 南京银行
WZCB | 313333007331 | 温州银行
SXCB | 313337009004 | 绍兴银行
TZCB | 313345001665 | 台州银行
XMCB | 313393080005 | 厦门银行
GZCB | 313428076517 | 赣州银行
SRCB | 313433076801 | 上饶银行
QDCB | 313452060150 | 青岛银行
QSSCCB | 313453001017 | 齐商银行
WFCB | 313458000013 | 潍坊银行
LSHCB | 313473070018 | 临商银行
ZZCB | 313491000232 | 郑州银行
LYCB | 313493080539 | 洛阳银行
CSCB | 313551088886 | 长沙银行
BBWCB | 313611001018 | 广西北部湾银行
LZCB | 313614000012 | 柳州银行
CQCB | 313653000013 | 重庆银行
PZHCCB | 313656000019 | 攀枝花市商业银行
FDCB | 313731010015 | 富滇银行
LZB | 313821001016 | 兰州银行
KLCB | 313882000012 | 昆仑银行
HLCB | 313227600018 | 葫芦岛银行
LSB | 313463400019 | 莱商银行
LJCB | 313261099913 | 龙江银行
SZCB | 313305066661 | 苏州银行
SHDRB | 402451000010 | 山东省农村信用社联合社
WHCB | 313465000010 | 威海市商业银行
QHCB | 313851000018 | 青海银行营业部
HXCB | 313391080007 | 福建海峡银行
CCAB | 313791030003 | 长安银行股份有限公司
### 分行号
分行名 | 代码(brNo)