diff --git a/content/docs/API/HRO接口文档.md b/content/docs/API/HRO接口文档.md index b99d858..ea004a6 100644 --- a/content/docs/API/HRO接口文档.md +++ b/content/docs/API/HRO接口文档.md @@ -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 为字节数组 20201229000000000000000000000001 /data/send/20201229000000000000000000000001 v1 - OHJEMIA1EINGUGAH0AITHOHNUEYAHWOO + OHJEMIA1EINGUGAH0AITHOHNUEYAHWOO 1000001 c5950a259435d3e51262539a10a22910 @@ -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) diff --git a/content/docs/开发/HRO融合方案.md b/content/docs/开发/HRO融合方案.md index 845e113..9327e0c 100644 --- a/content/docs/开发/HRO融合方案.md +++ b/content/docs/开发/HRO融合方案.md @@ -9,7 +9,7 @@ weight: 6 ### 流程图 -![](https://fairy8-1258530674.picsh.myqcloud.com/img/20210114112430.png) +![](https://fairy8-1258530674.picsh.myqcloud.com/img/20210115094451.png) ## 接口说明 @@ -23,12 +23,12 @@ weight: 6 method : GET content-Type : application/x-www-form-urlencoded token：Token - permissions：权限ID + func_id：功能ID eg. ```http - GET /auth?token=ZW9xpZTdvamE4SWVTNmkK&permissions=10001 HTTP/1.1 + GET /auth?token=ZW9xpZTdvamE4SWVTNmkK&func_id=10001 HTTP/1.1 Content-Type : application/x-www-form-urlencoded Host: localhost: 8888 Connection: keep-alive @@ -43,6 +43,9 @@ weight: 6 ```http HTTP/1.1 200 OK Date: Wed, 13 Jan 2021 15:27:25 GMT + + Content-Length: 20 + 100001,100002,100005 ``` eg. 失败：