中国邮政储蓄银行银企直联系统企业接口协议V09.docx

中国邮政储蓄银行银企直联系统企业接口协议V09.docx

《中国邮政储蓄银行银企直联系统企业接口协议V09.docx》由会员分享，可在线阅读，更多相关《中国邮政储蓄银行银企直联系统企业接口协议V09.docx（84页珍藏版）》请在冰豆网上搜索。

中国邮政储蓄银行银企直联系统企业接口协议V09

中国邮政储蓄银行银企直联系统

统一接口协议

（企业接入部分）

2011年10月

文件状态：

[]草稿

[√]正式发布

文件标识：

POST-CPEF-QYJK

当前版本：

1.2

完成日期：

2011/10/08

修改历史

版本

作者

修改说明

日期

评审号

变更号

1.1

银企直联项目组

新建

2011/10/08

本文档中的所有内容为中国邮政储蓄银行公司业务系统的机密和专属所有。

未经中国邮政储蓄银行及北京新宇合创金融软件股份有限公司的明确书面许可，任何组织或个人不得以任何目的、任何形式及任何手段复制或传播本文档部分或全部内容。

目录

1邮政储蓄银行银企直联系统企业接口协议1-4

1.1概述1-4

1.2适用范围1-7

1.3公共说明1-7

1.3.1交易返回码说明1-7

1.3.2转账结果返回码说明1-7

1.3.3交易类型说明1-8

1.4安全策略1-9

1.4.1数据传输安全1-9

1.5传输协议1-9

1.5.1协议描述1-9

1.5.2通讯流程示意图1-10

1.5.3传输包格式定义1-10

1.6交易接口1-11

1.6.1账户当前余额查询（2000）1-11

1.6.2账户历史余额查询（2100）1-12

1.6.3账户时点余额查询（2001）1-13

1.6.4账户可用余额查询（）1-14

1.6.5账户当日账务交易明细查询（2010）1-15

1.6.6账户历史账务交易明细查询（2060）1-16

1.6.7指定日期交易明细查询（含虚拟账簿）（1108）1-18

1.6.8账户状态（性质）查询（2104）1-19

1.6.9生成支付指令（1080）1-20

1.6.10转账支付（2020）1-22

1.6.11手工单笔归集（2106）1-23

1.6.12交易结果查询（2040）1-24

1.6.13单账户（或虚拟账簿）支付限额管理（2101）1-25

1.6.14虚拟账簿余额调整（2105）1-27

1.6.15企业部门编码与银行虚拟账簿对照关系（1107）1-28

1.6.16账户交易明细统计（2109）1-29

1.6.17账户变动通知（2110）1-30

1.6.18对账单（1111）1-31

1.6.19明细对账单（2111）1-33

1.6.20内部透支额度维护（李双辰）1-35

1.6.21内部透支额度维护（）1-36

1.6.22预算定支额度管理（李伟华）1-37

1.6.23批量付款文件接收（mxf）1-39

1.6.24批量付款文件发送（mxf）1-39

1.6.25账户透支额度使用明细查询（mxf）1-40

1.6.26账户透支额度调整查询（mxf）1-42

1.6.27虚拟账簿计息清单查询（mxf）1-43

1.6.28应付费用明细查询（mxf）1-44

1.6.29已付费用明细查询（mxf）1-45

1.6.30历史缴费查询（mxf）1-46

1.6.31资金转账结果通知（mxf）1-48

1.6.32账户变动通知（mxf）1-49

邮政储蓄银行银企直联系统企业接口协议

概述

为实现中国邮政储蓄银行银企直联系统与企业管理系统（ERP）的无缝对接，方便企业相关技术人员进行接口的开发，特编写本接口说明。

对于邮储银行的银企直联接口规范，将根据企业客户需求的增加，不断完善和升级版本，并实时对外发布，所以交易接口存在因企业需求不同，随时改动的可能性。

具体交易接口如下：

◆账户当前余额查询：

该交易用于接收和处理企业发起在邮政储蓄银行开立的公司账户当前余额查询请求信息。

返回信息包括：

企业账户当前时点余额【账户送23位账号时，则结果返回该虚拟账簿信息】，若公司账户签约了现金管理服务，同时会返回该账户当前累计净上存余额（=该账户上存余额-上级账户下拨金额）、累计净下拨余额=（该账户下拨余额-下级账户上存金额）。

◆账户历史余额查询：

该交易用于接收和处理企业发起在邮政储蓄银行开立的公司账户“历史某日”余额查询请求信息【账户送23位账号时，则结果返回该虚拟账簿信息】。

返回信息包括：

账户历史某日余额，若公司账户签约了现金管理服务，同时会返回账户历史某日累计净上存余额（=该账户上存余额-上级账户下拨金额）、累计净下拨余额=（该账户下拨余额-下级账户上存金额）。

◆账户时点余额查询：

该交易用于接收和处理企业发起在邮政储蓄银行开立的公司账户“某时点”余额查询请求信息。

若查询时间不送，则查询当日余额，返回信息包括：

账户余额。

◆账户当日账务交易明细查询：

该交易用于接收和处理企业发起在邮政储蓄银行开立公司账户当日账务性交易明细查询请求信息。

返回信息包括：

转账交易对方户名、对方账号、发生额、本账户转账后余额、转出转入标志、银行流水号、转账日期、转账时间、用途、摘要、凭证号码、凭证类型等。

◆账户历史账务交易明细查询：

该交易用于接收和处理企业发起在邮政储蓄银行开立公司账户历史账务性交易明细查询请求信息。

返回信息包括：

转账交易对方户名、对方账号、发生额、本账户转账后余额、转出转入标志、银行流水号、转账日期、转账时间、用途、摘要、凭证号码、凭证类型等。

◆指定日期交易明细查询（含虚拟账簿）：

该交易用于接收和处理企业发起在邮政储蓄银行开立公司账户历史账务性交易明细查询请求信息。

返回信息包括：

本账户账号（若开通虚拟账簿，则账号包括虚拟账簿）、本账户名称（若开通虚拟账簿，则回显虚拟账簿名称）、转账交易对方户名、对方账号、对方行号、对方行名、发生额、本账户转账后余额、转出转入标志、银行流水号、企业流水号、转账日期、转账时间、用途、摘要、凭证号码、凭证类型、交易渠道等。

当实账户开通了虚拟账簿时，如果账户送18位实账户，则结果返回所有交易明细；如果账户送23位账号时，则结果返回该虚拟账簿交易明细。

◆账户状态（性质）查询：

该交易用于接收和处理企业发起在邮政储蓄银行开立公司账户状态查询请求信息。

返回信息包括：

账户名称、账户账号、账户状态、账户性质。

◆生成支付指令：

该交易用于接收和处理已签约企业发起账户资金转账请求，支付指令由企业ERP生成，通过银企直联平台转到对公网银系统，网银系统复核后通过网银转账转出资金。

◆转账支付：

该交易用于接收和处理已签约企业发起账户资金转账请求，包括行内（对公、对私户）、跨行之间转账；支持单笔行内收款、单笔行内公司账户向公司账户付款、单笔行内公司账户向个人账户付款、单笔跨行付款。

◆手工单笔归集：

该交易用于接收和处理已签约现金管理服务的账户，企业通过银企直连发起手工资金归集功能。

◆交易结果查询：

该交易用于接收和处理企业发起资金转账交易结果请求。

返回相应的交易结果代码和银行流水号。

◆单账户支付限额管理：

该交易用于接收和处理已签约企业发起账户支付限额管理，可对账户按笔、按日、按月、按不定期设定账户支付限额（可增、删、查、改）；支持虚拟账簿支付限额设置与查询。

◆虚拟账簿余额调整：

该交易用于接收和处理已签约企业发起，同时签约了现金管理虚拟账簿的实账户中两个虚拟账簿之间的资金转账请求。

◆企业部门编码与银行虚拟账簿对照关系：

该交易用于接收和处理已签约企业在银行开立的五位虚拟编簿与企业ERP系统中企业部门编码制定某种规则实现一一对应。

◆账户交易明细汇总统计：

该交易用于接收和处理企业发起在邮政储蓄银行开立的公司账户“某段时间（或某日）”交易明细情况的统计汇总信息，当银行接收到的账户（若账户开通虚拟账簿，则账号可包括虚拟账簿）为虚拟账簿时，返回的信息为该虚拟账簿交易明细汇兑信息。

查询返回信息包括：

存在交易明细天数、交易日期、当日交易笔数、当日借方笔数、当日贷方笔数、当日借方发生额、当日贷方发生额、当日扎差、当日余额。

◆账户变动通知（银行方主动发起）：

该交易用于企业账户发生收、支等结算业务、账户余额发生变化后，金融服务平台通过轮询方式，将交易明细通知企业管理系统。

返回信息包括：

交易笔数、交易账号、交易账号名称、对方账号、对方户名、对方开户行行号、对方开户行全称、转账日期、转账时间、银行流水号、企业流水号、发生金额、转账后余额、转出转入标志、银行凭证名称、凭证号码、交易渠道、结算币别、冻结金额、协议透支额度、可用透支额度、可用余额、柜员号、网点号、摘要代码、摘要名称、备注。

◆对账单（银行方主动发起）：

该交易用于银行主动将上一交易日企业账户发生收、支等结算业务的交易明细，以电子对账单的形式通知企业管理系统。

返回信息包括：

交易账号、对账单号、交易笔数、对方账号、对方户名、对方开户行行号、对方开户行全称、转账日期、转账时间、银行流水号、企业流水号、发生金额、转账后余额、转出转入标志、银行凭证名称、凭证号码、交易渠道、结算币别、冻结金额、协议透支额度、可用透支额度、可用余额、柜员号、网点号、摘要代码、摘要名称、备注。

适用范围

企业资金管理系统与邮政储蓄银行银企直联系统的接口开发人员。

公共说明

交易返回码说明

编号

返回码

意义

1

00

交易成功

2

01

交易失败

转账结果返回码说明

编号

转账结果

意义

1

0

交易成功

2

1

交易失败

3

2

不确定

交易类型说明

编号

交易类型

交易名称

特别说明

1

2000

账户当前余额查询

可查询虚拟账簿信息。

2

2100

账户历史余额查询

系统支持半年内账户历史余额查询。

3

2001

账户时点余额查询

该交易用于查询公司账户“某时点”余额。

若查询时间不送，则查询当日余额。

3

2010

账户当日账务交易明细查询

日期可以不输入，若输入则必输为当日日期。

4

2060

账户历史账务交易明细查询

系统支持半年内历史明细查询；

企业查询的历史交易明细起止间隔时间不超过一个月；

5

1108

指定日期交易明细查询（含虚拟账簿）

6

2104

账户账态（性质）查询

返回报文说明:

账户状态：

0-正常户、1-已销户、2-已结息状态、3-已挂失状态、4-已睡眠状态、5-冻结、6-止付；

账户类型：

0-基本存款账户、1-一般存款账户、2-临时存款账户、3-专用同业存款账户、4-专用保证金账户、5-专用财政性存款账户、6-其他专用户、a-定期存款没有账户类型（用“a”标识）；

7

1080

生成支付指令

支付指令由企业ERP生成，通过银企直联平台转到对公网银系统，网银系统复核后通过网银转账转出资金。

目前只有四川烟草监管接入用到。

对于重发类交易；通过备用字段2标识出来，如果该值为“1”，当重发处理。

8

2020

转账支付

支持单笔行内收款、单笔行内公司账户向公司账户付款、单笔行内公司账户向个人账户付款、单笔跨行付款。

若跨行转账则转入行行号与转入开户行名称至少输入其中之一。

9

2106

手工单笔归集

10

1040

交易结果查询

11

2101

单账户支付限额管理

请求报文说明:

功能选项:

共10位。

第1位必输项表示对账户支付限额的0-增加，1-删除，2-修改3-查询处理。

第2-9位用0或1表示，0-代表不控制，1-代表控制，第2位代表单笔支付限，第3位日支付交易限额，第4位月支付交易限额，第5位-不定期支付限额，“月支付交易限额”与“不定期支付限额”只能选择一项，6-10位备用字段。

支持虚拟账簿支付限额设置与查询。

12

1105

虚拟账簿余额调整

13

1107

企业部门编码与银行虚拟账簿对照关系

14

2109

账户交易明细统计

请求报文说明:

1、若查询某天时，查询起始日期和终止日期送同一有效日期；若查询当日的交易统计情况，起始日期和终止日期必须都为当日；

2、对于查询时间段将通过参数针对不同商家控制，原则上不超过一个月（30天）。

15

1110

账户变动通知（银行主动发起）

16

1111

对账单（银行主动发起）

每一账号每天生成唯一一个对账单（对账单号唯一）。

安全策略

数据传输安全

◆数据传输完整性

在企业银行前置机和银行代理前置机之间对传输报文中的关键字段实施MAC校验保护，以确保数据在传输过程中的完整性。

◆数据传输机密性

为了防止机密信息在通讯过程中被非法窃取，可以根据需要对系统之间通讯数据中的一些关键信息使用PIN密钥进行加密传输，从而保证敏感信息的安全性。

传输协议

协议描述

银企直联双方主要采用TCP/IP的同步短链接方式包交换形式完成各项业务，批量转账和对账明细以文件交换。

以下简述包交换交易方式。

企业银行前置设立接口服务程序。

企业方程序通过指定端口与服务程序进行连接。

原则上接口方只接收代收方的交易请求，而不主动向代收方发送信息。

通讯方式支持多包传送，每个数据包分为两部分：

包头（固定10字节）＋包体。

其中包头暂时使用前6个字节：

前5个字节存放包体长度（长度值不包括包头10个字节），右对齐，左补前导零；第六个字节内容：

0无后续包1有后续包。

即采用每次交易前进行链接，交易完成后断开链接，一次连接只处理一项交易，所有数据包组成一个完整的xml结构，具体交易格式如下：

每笔交易采用一申请一应答方式进行,即采用每次交易前进行链接，交易完成后断开链接，一次连接只处理一项交易，所有数据包组成一个完整的xml结构。

每笔交易设置交易时限（交限时限定为180秒，应参数化控制），如企业在交易时限内未收到企业银行前置接口服务应答包，则交易失败，企业方应停止接收。

交易所涉及费用金额均采用以人民币分为单位的整型数据。

通讯流程示意图

传输包格式定义

包头信息（10字节）+包体（不定长）

数据包按照一个完整的xml结构。

其中：

包头暂时使用前6个字节；前5个字节存放包体长度（长度值不包括包头10个字节），右对齐，左补前导零；第六个字节内容：

0无后续包1有后续包。

请求报文中，若标明是必输项，则该域必输，若未标明必输项，可不赋值。

针对账务类交易返回报文中的的“OpRetCode”字段说明：

00：

成功01：

失败，若返回“01”代表该笔转账类交易失败；“Result”收到结果字段说明：

0：

失败1：

成功2：

不确定；是指金融服务平台接收到请求报文成功或失败，不代表该转账成功；若金融服务平台成功接收到支付指令后，企业要确认该笔转账是否成功，可以通过“交易结果查询（1040）”交易确认。

交易接口

注明：

交易类型为4位定长，其他字段注明的长度为最大长度。

账户当前余额查询（2000）

请求报文（ReqQueryBalance2.xml）

xmlversion="1.0"encoding="GBK"?

>

--交易类型4位（必输项）-->

--交易日期,格式yyyymmdd8位（必输项）-->

--被查账号32位（必输项）-->

--货币类型,RMB为人民币3位（必输项）-->

--备用字段140位-->

--备用字段240位-->

--备用字段340位-->

--备用字段440位-->

响应报文（RepQueryBalance2.xml）

xmlversion="1.0"encoding="GBK"?

>

--交易类型4位-->

--返回码2位00：

成功01：

失败-->

--返回码对应文字信息80位-->

--当前余额到分位，不含小数点13位-->

--可用余额到分位，不含小数点13位-->

--备用字段140位（若公司账户签约了现金管理服务，标识当前累计净上存余额）-->

--备用字段240位（若公司账户签约了现金管理服务，标识当前累计净下拨余额）-->

--备用字段340位-->

--备用字段440位-->

账户历史余额查询（2100）

请求报文（ReqQueryHisBalance2.xml）

xmlversion="1.0"encoding="GBK"?

>

--交易类型4位（必输项）-->

--交易日期,格式yyyymmdd8位（必输项）-->

--被查账号32位（必输项）-->

—查询日期,格式yyyymmdd8位（必输项）-->

--货币类型,RMB为人民币3位（必输项）-->

--备用字段140位（）-->

--备用字段240位-->

--备用字段340位-->

--备用字段440位-->

响应报文（RepQueryHisBalance2.xml）

xmlversion="1.0"encoding="GBK"?

>

--交易类型4位-->

--返回码2位00：

成功01：

失败-->

--返回码对应文字信息80位-->

--当前余额不含小数点,单位为分13位-->

--不含小数点,单位为分13位若公司账户签约了现金管理服务，标识历史某日累计净上存余额-->

--不含小数点,单位为分13位若公司账户签约了现金管理服务，标识历史某日累计净下拨余额-->

--备用字段140位-->

--备用字段240位-->

--备用字段340位-->

--备用字段440位-->

账户时点余额查询（2001）

请求报文（ReqQueryHMSBalance2.xml）

xmlversion="1.0"encoding="GBK"?

>

--交易类型4位（必输项）-->

--交易日期,格式yyyymmdd8位（必输项）-->

--被查账号32位（必输项）-->

—查询日期,格式yyyymmdd8位（必输项）-->

--查询时间格式hhmmss6位（可输项）-->

--货币类型,RMB为人民币3位（必输项）-->

--备用字段140位（）-->

--备用字段240位-->

--备用字段340位-->

--备用字段440位-->

响应报文（RepQueryHMSBalance2.xml）

xmlversion="1.0"encoding="GBK"?

>

--交易类型4位-->

--返回码2位00：

成功01：

失败-->

--返回码对应文字信息80位-->

--被查账号32位（必输项）-->

—查询日期,格式yyyymmdd8位（必输项）-->

--查询时间格式hhmmss6位（可输项）-->

—账户余额不含小数点,单位为分13位-->

--备用字段140位-->

--备用字段240位-->

--备用字段340位-->

--备用字段440位-->

<