《广州建设领域管理应用信息平台》由会员分享，可在线阅读，更多相关《广州建设领域管理应用信息平台（20页珍藏版）》请在金锄头文库上搜索。
1、广州市建设领域管理应用信息平台银行对账单数据接口标准目录一、引言 11.1 编写目的 11.2 适用范围 11.3 简称 1二、开发规范 2.2.1 通信协议 22.2 通信安全 22.3 注意事项 2三、接口说明 4.3.1 进账上报 43.2 出账上报 53.3 出账结果上报 63.4 获取班组信息 63.5 获取工人实名信息 73.6 工资表上报 83.7 工资款拨出验证 93.8 工资款拨出上报 103.9 工资款拨付计划上报 错误！未定义书签。3.10 工资发放计划上报 错误！未定义书签。3.11 工资专用账户开户验证 113.12 工资专用账户开户上报 113.13 工资专用账户变
2、更销户验证 133.14 工资专用账户销户验证 133.15 工资专用账户销户上报 14四、附录 1.5.4.1 测试环境 154.2 结果码对照表 154.3 银行代码表 164.4 企业类型表 164.5 出账上报流程 16、引言1.1编写目的为实现广州市建设领域管理应用信息平台对工人工资支付分账专用账户的监督管理，及时对工人工资支付分账专用账户的异常情况进行预警，需要银行配合将工人工资支付分账专用账户的动账明细数据上报，特编写本接口文档以供银行相关技术人员对接。1.2适用范围本文档的适用对象为接入广州市建设领域管理应用信息平台的银行技术开发人员、日常维护人员。1.3简称广州市建设领域管理
3、应用信息平台：以下简称“信息平台”工人工资支付分账专用账户：以下简称“专用账户”二、开发规范2.1通信协议采用HTT（或HTTPS协议进行请求和响应的处理。接口请求采用 GET/POST方式。接口响应返回JSON格式的数据。由“信息平台”提供接口地址，银行调用。接口请求URL地址：详见接口说明。接口未注明处均使用 UTF-8编码。通信过程中涉及的中文或特殊符号的传输，需进行urlencode处理。HTTP（或HTTPS请求参数均为字符串。接口请求需进行签名，详见2.2通信安全一节。2.2通信安全为保证数据传输过程中的数据真实性，我们需要对数据进行数字签名，在接收签名数据之后进行签名校验。银行接
4、入时，“信息平台”会为银行分配唯一的接入编号和接入密钥。签名机制如下：对全部有长度限制的传输字段（不包括NL类型的字段）进行签名，将参数名（区分大小写）和参数值（需进行urlencode处理）用“=”连接，参数值为空的参数不参与签名，参数之间用“ & ”连接，格式是：param仁val1 ¶m2=val2。 参数组装顺序规则：参数名的字典顺序。密钥拼接方式为传输参数直接连接密钥，如只有param1和param2两参数，值分别为 val1 和 val2，密钥为 key,拼接结果为： param仁val1 ¶m2=val2 key。使用“信息平台”分配的密钥进行 MD5加密（密钥直
5、接跟在组装好的参数后即可），将值赋给sign参数。2.3注意事项接口中各项参数当标识是 M时参数必选，为O时可选。接口字段长度分为三种：无限制（ NL）,固定长度（FL）,可变长度（VL）。如果 为FL,则长度必须精确到 FL后跟随的数字，格式举例 FL14;如果为VL,则长度在 可变范围内即可，如果长度不够，不补空格或其它字符，格式举例VL30。接口中资金数额参数（如交易金额、余额等）均为非负整数，以分为单位。接口说明中，若参数字体为红色，请仔细阅读备注说明。请求返回结果码不为 0时，需要再次提交请求。如果结果码大于0,则需要根据提段时间再提交（如：5次提交不成功时推示信息修改错误后再次提交
6、；如果结果码小于 0，可以间隔 选择间隔5分钟、10分钟、30分钟、1小时提交一次，连续 迟到第二天再提交）。三、接口说明所有接口响应的返回信息均以JSON字符串形式返回，可以使用JSON工具包对其进行解析。返回信息具体字段参照接口说明中的响应参数，以下以举例：处理成功：resultCode :0,resultDesc :处理成功,data:transactionNo JZ20170601143015345001处理失败：resultCode :1,resultDesc :签名错误,data:transactionNo JZ20170601143015345001返回结果码对照见附录4.2结果
7、码对照表3.1进账上报接口说明接口描述发生导致“专用账户”余额增加的交易时上报数据请求地址/bank/incomeRecord/save测试请求地址请求参数参数限制长度注释备注bankIdMFL8接入编号“信息平台”为银行分配的接入编号transactionNoMVL32交易号请求的唯一交易号transactionTimeMFL17交易记账时间北京时间精确到毫秒(yyyyMMddHHmmssSSS)specialAccountMVL25“专用账户”号amountMVL16交易金额交易金额，非负整数并以分为单位balanceMVL16余额“专用账户”余额，非负整数并以分为单位srcAccount
8、OVL20资金来源账户号为空表示现金入账srcNameOVL200资金来源账户名remarksOVL500备注备注signMFL32签名响应参数参数限制说明resultCodeM返回结果码，数字类型。0表示成功；其它表示失败。resultDescO返回结果描述dataO交易号3.2出账上报接口说明接口描述发生导致“专用账户”余额减少的交易时上报数据请求地址/bank/paymentRecord/save测试请求地址请求参数参数限制长度注释备注bankIdMFL8接入编号“信息平台”为银行分配的接入编号transactionNoMVL32交易号请求的唯一交易号transactionTimeMFL
9、17交易记账时间北京时间精确到毫秒(yyyyMMddHHmmssSSS)specialAccountMVL25“专用账户”号amountMVL16交易金额交易金额，非负整数并以分为单位balanceMVL16余额“专用账户”余额，非负整数并以分为单位destAccountMVL20资金到达账户号destIdcardOVL18账户身份证号资金到达账户的拥有人的身份证号destNameMVL30账户名资金到达账户的拥有人的姓名stateMFL1到账结果状态0 :已出账；1 :已到账；-1 :已退款remarksOVL500备注备注signMFL32签名响应参数参数resultCode齣M说明返回结
10、果码，数字类型。0表示成功；其它表示失败。resultDescO返回结果描述dataO交易号3.3出账结果上报接口说明接口描述上报岀账的到账结果请求地址/bank/paymentRecord/result测试请求地址请求参数参数限制长度注释备注bankIdMFL8接入编号“信息平台”为银行分配的接入编号transactionNoMVL32交易号请求的唯一交易号specialAccountMVL25“专用账户”号stateMFL1到账结果状态0 :已出账；1 :已到账；-1 :已退款finishTimeMFL17到账结果反馈时间北京时间精确到毫秒(yyyyMMddHHmmssSSS)remark
11、sOVL500备注备注signMFL32签名响应参数参数限制说明resultCodeM返回结果码，数字类型。0表示成功；其它表示失败。resultDescO返回结果描述dataO交易号3.4获取班组信息接口说明接口描述批量获取与指定的“专用账户”绑定的班组信息。用于银行系统在提供给企业制作 工资表时选择班组。请求地址/bank/team/list测试请求地址请求参数参数限制长度注释备注bankidMFL8接入编号“信息平台”为银行分配的接入编号specialAccountMVL25“专用账户”号timestampMFL17时间戳北京 时 间 精确 到 毫秒(yyyyMMddHHmmssSSS)
12、signMFL32签名响应参数参数限制说明resultCodeM返回结果码，数字类型。0表示成功；其它表示失败。resultDesc0返回结果描述班组列表。格式为JSON对象：dataOcode:班组编码name:班组名称3.5获取工人实名信息接口说明接口描述批量获取与指定的“专用账户”绑定的工人实名信息。银行在提供给企业发放工资 时可以获取此列表用于工资发放依据，不在此列表中的账户不能发放工资，工资发 放数额不能超过未支付的工资数。请求地址/bank/teamBuilder/page测试请求地址请求参数参数限制长度注释备注bankIdMFL8接入编号“信息平台”为银行分配的接入编号speci
13、alAccountMVL25“专用账户”号teamCodeMVL32班组编码项目内部的班组唯一编码，检查班组是否存在的依据pageMVL5页码获取的页码，从0开始sizeMVL4每页的数据条数timestampMFL17时间戳北京时间精确到毫秒(yyyyMMddHHmmssSSS)signMFL32签名响应参数参数限制说明resultCodeM返回结果码，数字类型。0表示成功；其它表示失败。resultDescO返回结果描述dataO工人列表。格式为JSON对象：number : 页码,size :每页的数据条数：content : name :工人姓名,idcard : 工人身份证号,cardCode :工人银行卡号：bankCode :
