金蝶云电子签署整体流程说明

栏目：云星瀚知识作者：金蝶来源：金蝶云社区发布：2024-09-22浏览：1

金蝶云电子签署整体流程说明

变更记录

产品版本

更新内容

更新日期

V5.0.1

初始版本

2022年6月18日

V6.0.1

原“电子签署”更新为“金蝶云电子签署”配置

；

取消电子签署类型配置；

系统参数配置路径变更。

2023年10月26日

1 简介

1.1 功能介绍

金蝶云电子签署的使用涉及到多系统的交互，且对操作步骤有着较高的要求，本操作指引就电子签署的总体流程进行说明。

1.2 应用场景

已采购星瀚人力云“劳动合同&协议电子签署”，需启用电子签署服务。

2 主要操作

2.1 主要操作

步骤一、网络环境依赖检查

使用金蝶云电子签署之前，请确认客户网络环境与金蝶公有云网络环境能够相互访问。若客户对调用外部服务接口有限制，需将下文“基础配置”中的网段设置到防火墙白名单中；若客户对调用外部服务接口需要精确的服务接口地址，除了配置防火墙白名单，还需将下文“进阶配置”中的url在nginx层做额外的路径匹配。

特别说明：测试环境与生产环境的网段与url不同，请注意区分。

（一）测试环境

基础配置

用户平台网段	kdcontract.url=https://testpay.kingdee.com/kdcontract/
许可计费系统网段	kd.hr.hrcs.econtract.chargeDomain=http://ssmc.kingdee.com

进阶配置

功能	接口地址
上传合同模板	https://testpay.kingdee.com/kdcontract/api/contract/uploadTemplate
法大大的v3实名认证	https://testpay.kingdee.com/kdcontract/api/contract/mobileAuthUrl
查询法大大的企业或个人实名认证结果	https://testpay.kingdee.com/kdcontract/api/contract/authResult
创建合同（pdf/word文件）	https://testpay.kingdee.com/kdcontract/api/contract/upload
上传合同	https://testpay.kingdee.com/kdcontract/api/contract/toHandSign
自动签署	https://testpay.kingdee.com/kdcontract/api/contract/sign
客户单签（快速）	https://testpay.kingdee.com/kdcontract/api/contract/signPDF
获取第三方签署链接	https://testpay.kingdee.com/kdcontract/api/contract/getHandSignURL
查询合同签署状态	https://testpay.kingdee.com/kdcontract/api/contract/getSignStatus
合同预览和下载	https://testpay.kingdee.com/kdcontract/api/contract/refresh
合同撤销	https://testpay.kingdee.com/kdcontract/api/contract/cancel
许可计费系统新用户注册	http://ssmc.kingdee.com/tenant/cloud_auth/sign_enterprise.do
许可计费系统老用户注册	http://ssmc.kingdee.com/tenant/cloud_auth/bind_woshou_account.do
许可计费系统获取验证码	http://ssmc.kingdee.com/tenant/cloud_auth/bind_woshou_account.do
许可计费系统获取token令牌	http://ssmc.kingdee.com/tenant/cloud_auth/get_access_token.do
许可计费系统站点（流量）扣减	http://ssmc.kingdee.com/ctrl/record/reduceSite
许可计费系统站点（流量）补回	http://ssmc.kingdee.com/ctrl/record/reducecount/resume
许可计费系统站点（流量）查看	http://ssmc.kingdee.com/ctrl/site/card/{tenantId}

（二）生产环境

基础配置

用户平台网段	kdcontract.url=https://pay.kingdee.com/kdcontract/ （为保证金蝶网络能访问到客户网络，需要向用户平台提供公网出口ip）
许可计费系统网段	kd.hr.hrcs.econtract.chargeDomain=http://shrcloud.kingdee.com

进阶配置

许可计费系统老用户中蹙额	http://shrcloud.kingdee.com/tenant/cloud_auth/bind_woshou_account.do
许可计费系统获取验证码	http://shrcloud.kingdee.com/tenant/cloud_auth/bind_woshou_account.do
许可计费系统获取token令牌	http://shrcloud.kingdee.com/tenant/cloud_auth/get_access_token.do
许可计费系统站点（流量）扣减	http://shrcloud.kingdee.com/ctrl/record/reduceSite
许可计费系统站点（流量）补回	http://shrcloud.kingdee.com/ctrl/record/reducecount/resume
许可计费系统站点（流量）查看	http://shrcloud.kingdee.com/ctrl/site/card/{tenantId}

步骤二、配置电子合同在线许可控制信息

详见《【操作指引】如何配置电子合同在线许可控制信息》

特殊说明：测试环境配置完成后需联系研发团队（星瀚HR业务平台服务部）手动获取电子签许可。

步骤三、注册合同主体

详见《【操作指引》如何注册合同主体》

步骤四、维护HR电子签署配置

详见《【操作指引】维护HR电子签署配置》

注意事项：

测试环境还需要以下额外配置：

（1）MC参数clientId和clientSecret，如测试环境未更改以下MC参数，将有扣减生产环境许可的风险。修改参数需要重启苍穹服务才能生效，参数如下：

clientId=201230

clientSecret=87d7c0ca9ee7ea84b15e68f1fad10c47

（2）配置电子签章测试环境地址

系统路径：【基础服务云】→【公共设置】→【系统参数】→【第三方参数】

请将以下信息维护到【电子签章服务参数】中：

商户申请URI：/emerchant/merchant/addDev

电子签章URL：https://testpay.kingdee.com/kdcontractDev/

（3）登录云平台测试环境，注册企业账号，登录地址：https://p.cloudsz.kingdee.com/ （如无法访问此地址，可联系总部研发团队（星瀚HR业务平台服务部）进行协助）

（4）申请开通网络权限，包括云平台测试环境访问客户环境、在线计费系统测试环境访问客户环境，地址如下：

源地址/端口号	目标地址/端口号	备注说明
172.25.1.0/24 /ALL	客户环境地址/端口号	云平台电子签测试环境访问客户环境
172.18.8.31 /ALL	客户环境地址/端口号	许可计费系统测试环境访问客户环境