中国联通营业厅无纸化安全能力服务平台对接说明

1、中国联通无纸化营业受理安全能力服务平台对接说明中国联通无纸化营业受理安全能力服务平台对接说明目录1安全能力服务平台功能说明32对接说明42.1印章管理42.2接口地址43流程描述43.1印章管理43.2PDF电子签章54接口描述54.1PDF文档签名接口54.1.1接口功能54.1.2接口参数64.1.3接口示例84.2PDF文档签名验证接口94.2.1接口功能94.2.2接口参数104.2.3接口示例11附录：错误码定义121 安全能力服务平台功能说明中国联通无纸化营业受理安全能力服务平台功能结构如下图所示：功能列表详细描述PDF文档签章针对PDF格式文档进行电子签章，在PDF文件上显示签章

2、图片和签章信息。PDF签章取证验证PDF文档签章的有效性、完整性，获取证据信息。印模制作按照要求制作印模，包括印章形状、印章文字（内容及字体）等。印章审批审批已经制作好的印模，形成印章。印章发布发布经过审批的印章，并为该印章向CA申请印章证书。印章证书管理和CA对接，实现印章证书生命周期管理，包括申请、下载、更新、冻结、解冻、吊销等。业务统计统计签章使用情况，采用多种方式对签章使用情况进行分析。日志管理自行记录日志，保存到数据库中。密钥托管安全存储用于签章的数字证书，加密保存在数据库中。PDF文档解析实现PDF文档解析功能证据保全存储签章操作中的签名信息、签名证书、签名时间等信息，并将这些信息

3、安全保全在数据库中。在出现纠纷时，保全的数据作为可调取的数字签名证据，还原数字签名，验证电子单据内容的有效性和合法性。2 对接说明2.1 印章管理印章管理页面采用用户名、口令登录，测试使用的用户名和口令如下：1. 用户名：admin2. 口令：111111112.2 接口地址接口地址如下： 62:7080/wppoa/3 流程描述3.1 印章管理印章管理流程包含印章申请、印章审批、印章管理三大环节。流程如下：3.2 PDF电子签章4 接口描述4.1 PDF文档签名接口4.1.1 接口功能使用分公司印章证书对PDF文档添加数字签名，并显示印章图片。支持对PDF

4、文档同时加盖多个印章接口消息序列号trans_id：省代码+1000000000000000（每次自增1，保证不重复）4.1.2 接口参数1. 请求的URL：http:/server-url /wppoa/servlet/ElecFileSignServlet2. 请求方式为post。3. 请求的参数列表：参数名称中文描述字段长度备注Incommand接口命令字，这里为acceptSignReq32必选trans_id接口消息序列号32Long，必选hall_id分公司标示32String，必选（唯一标示），由安全能力服务平台分配hall_name分公司名称64String，必选（唯一标示）s

5、tamp_type印章类型：1公章；2稽核章；3作废章；其它待定；4Int，必选stamp_width印章宽度必选，印章宽度，以像素点为单位。stamp_height印章高度必选，印章高度，以像素点为单位tag_type印章定位类型, 结合tag_value确定盖章位置：0：基于坐标定位，1：基于文字定位（印章盖在文字中心）2：基于文字定位（印章盖在文字右侧）3：基于书签定位目前仅支持0（基于坐标定位）tag_value印章定位对象数据，针对不同tag_type，具有不同含义：tag_type=0：指定页面坐标，格式为"页码:x坐标:y坐标"，xy坐标均以像素点为单位。ta

6、g_type=1或2：指定文字tag_type=3：书签名1:30:40例如：1:30:40表示在第一页左下角为原点的二维坐标（30,40）位置accept_id受理单流水号64String唯一标识该受理工单的ID，必选doc_type受理单文件类型：1：PDF格式其它：预留1Int，必选doc_content受理单文件数据内容Clob必选，内容经Base64编码4. 响应的参数列表：参数名称中文描述字段长度备注Outcommand接口命令字，这里为acceptSignResp必选trans_id接口消息序列号，与请求的trans_id对应32Long，必选ret_code签名结果。0：成功；

7、1：失败；2999：参见7.80必选err_desc错误描述ret_code为非0时必选accept_id受理工单流水号108261549606唯一标识该受理工单的ID，必选doc_signed_cont签名后受理单的文件数据内容必选，内容经Base64编码4.1.3 接口示例1. 消息请求（受理单管理à安全能力服务平台系统）<?xml version=”1.0” encoding=”UTF-8”?><req command=“acceptSignReq“> <trans_id>2014060512000001</trans_id>&l

8、t;hall_id>1</hall_id><hall_name>广东省广州市分公司</ hall_name> <stamps>/支持对PDF加盖多个印章，需要对每个印章定义<stamp>/每个stamp节点对应一个印章<stamp_type>1</stamp_type><stamp_width></stamp_width><stamp_height></stamp_height><tag_type></tag_type><tag

9、_value></tag_value></stamp>。</stamps><accept_id>1234567890345678</accept_id><doc_type>1</doc_type><doc_content>MRQWERTY=</doc_content></req> 2. 消息响应（安全能力服务平台系统à受理单管理） 1) 成功<?xml version=”1.0” encoding=”UTF-8”?><resp command

10、=“acceptSignResp“> <trans_id>2014060512000001</trans_id><ret_code > 0</ret_code><err_desc> </err_desc > <accept_id>1234567890345678</accept_id><doc_signed_cont>MRQWERTYUID=</doc_signed_cont> </resp>2) 失败<?xml version=”1.0” encod

11、ing=”UTF-8”?><resp command=“acceptSignResp“> <command>doc_sign</command><trans_id>2014060512000001</trans_id><ret_code >110</ret_code> <err_desc> 分公司印章证书不存在</err_desc > <accept_id>1234567890345678</accept_id></resp>4.2 PDF文档签

12、名验证接口4.2.1 接口功能在受理单PDF文件签名验证流程中实现数字签名验证功能接口消息序列号trans_id：省代码+1000000000000000（每次自增1，保证不重复）4.2.2 接口参数1. 请求的URL：http:/server-url /wppoa/servlet/ElecFileSignVerifyServlet2. 请求方式为post。3. 请求的参数列表：参数名称中文描述字段长度备注Incommand接口命令字，这里为acceptVerityReq32必选trans_id接口消息序列号32Long，必选hall_id分公司标识32String，必选（唯一标识）hall_

13、name营业厅名称64String，必选（唯一标识）stamp_type印章类型：1公章；2稽核章；3作废章；其它待定；4Int，必选accept_id受理单流水号64String，唯一标识该受理工单的ID，可选doc_type受理单文件类型：1：PDF格式其它：预留1Int，必选doc_signed_cont签名后受理单的文件数据内容Clob必选，内容经Base64编码4. 响应的参数列表：参数名称中文描述字段长度备注Outcommand接口命令字，这里为acceptVerityResp必选trans_id接口消息序列号，与请求的trans_id对应必选ret_code验签结果。0：成功；1

14、：失败；2999：参见7.80必选err_desc错误描述ret_code为非0时必选4.2.3 接口示例1. 消息请求（受理单管理à安全能力服务平台系统）<?xml version=”1.0” encoding=”UTF-8”?><req command=“acceptVerityReq“> <trans_id>2014060512000001</trans_id><hall_id>1</hall_id><hall_name>广东省广州市分公司</hall_name><stampt

15、ypes>/支持多印章验证<stamp_type>1</stamp_type>。</stamptypes><doc_type>1</doc_type><doc_signed_cont>MRQWERTYUID=</doc_signed_cont> <accept_id>1234567890345678</accept_id></req> 2. 消息响应（安全能力服务平台系统à受理单管理） 1) 成功<?xml version=”1.0” encoding=

16、”UTF-8”?><resp command=“acceptVerityResp“> <trans_id>2014060512000001</trans_id><ret_code >0</retCode> <err_desc> </err_desc > </resp>2) 失败<?xml version=”1.0” encoding=”UTF-8”?><resp command=“acceptVerityResp“> <trans_id>2014060512000001</trans_id><ret_code >201</retCode> <err_desc>签名对象已被篡改</err_desc > </resp>附录：错误码定义0：成功1：失败（未知原因）101：消息格式不对102：版本不支持（预留）103：接口命令字不支持104：接口消息序列号错误1