black1552/lkl_sdk
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 1 Wiki Activity

新增电子合同相关接口及数据结构

Browse Source 
添加电子合同申请、下载、状态查询、人工复核等功能模块
包含请求/响应数据结构及API实现
新增相关常量定义和类型
This commit is contained in:
maguodong
2025-10-20 10:28:54 +08:00
parent 7777630306
commit e985b790d4
16 changed files with 500 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
lklsdk/merchant/in_net/ec/apply/api.go
+47
View File
@@ -0,0 +1,47 @@
package apply
import (
"github.com/black1552/lkl_sdk/consts"
"github.com/black1552/lkl_sdk/lklsdk/common"
"github.com/gogf/gf/v2/os/gtime"
)
type Apply struct {
Client *common.Client[ECApplyResponse]
}
func NewEcApply(client *common.Client[ECApplyResponse]) *Apply {
return &Apply{
Client: client,
}
}
// ECApply 电子合同申请
// 提供与拉卡拉进行电子签约的第四方进行电子合同申请
// 电子合同签约成功后不需要将其下载出来作为附件上传，只需将电子合同编号（ecNo）
// 在“新增商户入网”接口中在（contractNo）字段中传入即可
func (a *Apply) ECApply(req *ECApplyRequestData) (*ECApplyResponse, error) {
// 构建请求
baseReq := ECApplyRequest{
ReqTime: gtime.Now().Format("YmdHis"),
ReqData: req,
Version: "1.0",
}
return a.Client.DoRequest(consts.BASE_URL+consts.LKL_EC_APPLY, baseReq)
}
// ECApplyTest 电子合同申请（测试环境）
// 提供与拉卡拉进行电子签约的第四方进行电子合同申请
// 电子合同签约成功后不需要将其下载出来作为附件上传，只需将电子合同编号（ecNo）
// 在“新增商户入网”接口中在（contractNo）字段中传入即可
func (a *Apply) ECApplyTest(req *ECApplyRequestData) (*ECApplyResponse, error) {
// 构建请求
baseReq := ECApplyRequest{
ReqTime: gtime.Now().Format("YmdHis"),
ReqData: req,
Version: "1.0",
}
return a.Client.DoRequest(consts.BASE_TEST_URL+consts.LKL_EC_APPLY, baseReq)
}
lklsdk/merchant/in_net/ec/apply/request.go
+54
View File
@@ -0,0 +1,54 @@
package apply
import (
"github.com/black1552/lkl_sdk/consts"
)
// ECApplyRequestData 电子合同申请请求数据
// 提供与拉卡拉进行电子签约的第四方进行电子合同申请
// 电子合同签约成功后不需要将其下载出来作为附件上传，只需将电子合同编号（ecNo）
// 在“新增商户入网”接口中在（contractNo）字段中传入即可
// 合同类别适用业务场景说明：
// EC001: 特约商户支付服务合作协议V3.1(商户入网) - 历史存量，推荐使用EC008
// EC002: 特约商户支付服务合作协议V3.2+分账结算授权委托书 - 历史存量，推荐使用EC007
// EC003: 分账结算授权委托书 - 历史存量，推荐使用EC009
// EC004: 特约商户支付服务合作协议V3.3(商户入网) - 历史存量，推荐使用EC008
// EC005: 特约商户支付服务合作协议V3.3+分账结算授权委托书 - 历史存量，推荐使用EC007
// EC007: 特约商户支付服务合作协议V4.1+分账结算授权委托书(商户入网+分账业务) - 当前最新版本
// EC008: 特约商户支付服务合作协议V4.1(商户入网) - 当前最新版本
// EC009: 清分结算授权委托书(分账业务) - 当前最新版本
type ECApplyRequestData struct {
OrderNo string `json:"order_no" dc:"四方机构自定义订单编号 必选，建议：平台编号+14位年月日时分秒+8位的随机数"` // 必选，建议：平台编号+14位年月日时分秒+8位的随机数
OrgID int `json:"org_id" dc:"机构号 必选，签约方所属拉卡拉机构"` // 必选，签约方所属拉卡拉机构
EcTypeCode consts.ECType `json:"ec_type_code" dc:"合同类别 必选，合同类别编码"` // 必选，合同类别编码
CertType consts.CertType `json:"cert_type" dc:"法人/经营者证件类型 必选，RESIDENT_ID（身份证）；PASSPORT（护照）；HK_MACAO_PASS（港澳居民往来内地通行证）；TAIWAN_PASS（台湾居民来往大陆通行证）"` // 必选，RESIDENT_ID（身份证）；PASSPORT（护照）；HK_MACAO_PASS（港澳居民往来内地通行证）；TAIWAN_PASS（台湾居民来往大陆通行证）
CertName string `json:"cert_name" dc:"法人/经营者姓名 必选"` // 必选
CertNo string `json:"cert_no" dc:"法人/经营者证件号码 必选"` // 必选
Mobile string `json:"mobile" dc:"签约手机号 必选，小微个人商户必须填写经营者本人手机号；个体工商户或企业商户必须填写法人手机号或者经办人手机号"` // 必选，小微个人商户必须填写经营者本人手机号；个体工商户或企业商户必须填写法人手机号或者经办人手机号
BusinessLicenseNo string `json:"business_license_no" dc:"营业执照号 可选，个体工商户或企业商户必传"` // 可选，个体工商户或企业商户必传
BusinessLicenseName string `json:"business_license_name" dc:"营业执照名称 可选，个体工商户或企业商户必传"` // 可选，个体工商户或企业商户必传
OpenningBankCode string `json:"openning_bank_code" dc:"企业/经营者结算开户行号 必选"` // 必选
OpenningBankName string `json:"openning_bank_name" dc:"企业/经营者结算开户行名称 必选"` // 必选
AcctTypeCode consts.AcctTypeCode `json:"acct_type_code" dc:"企业/经营者结算卡性质 必选，57 对公、 58 对私"` // 必选，57 对公、 58 对私
AcctNo string `json:"acct_no" dc:"企业/经营者结算卡号 必选"` // 必选
AcctName string `json:"acct_name" dc:"企业/经营者结算卡名称 必选"` // 必选
EcContentParameters string `json:"ec_content_parameters" dc:"电子合同内容参数集合 必选，JSON字符串"` // 必选，JSON字符串
AgentTag consts.AgentTag `json:"agent_tag" dc:"是否经办签约 可选，0 不启用 1启用，缺省 0"` // 可选，0 不启用 1启用，缺省 0
AgentName string `json:"agent_name" dc:"经办人名称 可选，agentTag为1时必传"` // 可选，agentTag为1时必传
AgentCertType consts.CertType `json:"agent_cert_type" dc:"经办人证件类型 可选，agentTag为1时必传"` // 可选，agentTag为1时必传
AgentCertNo string `json:"agent_cert_no" dc:"经办人证件号 可选，agentTag为1时必传"` // 可选，agentTag为1时必传
AgentFileName string `json:"agent_file_name" dc:"经办签约授权委托书文件名 可选，agentTag为1时必传"` // 可选，agentTag为1时必传
AgentFilePath string `json:"agent_file_path" dc:"经办授权委托书文件路径 可选，agentTag为1时必传"` // 可选，agentTag为1时必传
Remark string `json:"remark" dc:"备注说明 可选"` // 可选
RetUrl string `json:"ret_url" dc:"电子合同签约结果回调通知 可选，成功签约才通知"` // 可选，成功签约才通知
}
// ECApplyRequest 电子合同申请请求
// 请求URL：
// 测试环境：https://test.wsmsd.cn/sit/api/v3/mms/open_api/ec/apply
// 生产环境：https://s2.lakala.com/api/v3/mms/open_api/ec/apply
type ECApplyRequest struct {
ReqTime string `json:"req_time" dc:"请求时间"` // 必选，格式：yyyyMMddHHmmss
ReqData *ECApplyRequestData `json:"req_data" dc:"请求数据"` // 请求数据
Version string `json:"version" dc:"版本号"` // 必选，固定值：1.0
}
lklsdk/merchant/in_net/ec/apply/response.go
+20
View File
@@ -0,0 +1,20 @@
package apply
// ECApplyResponseData 电子合同申请响应数据
type ECApplyResponseData struct {
OrderNo string `json:"order_no" dc:"请求上送的订单号"` // 请求上送的订单号
EcApplyID int64 `json:"ec_apply_id" dc:"电子签约申请受理编号"` // 电子签约申请受理编号
ResultUrl string `json:"result_url" dc:"电子签约申请结果H5链接地址"` // 申请成功时：待签约合同H5链接；申请失败时：错误信息结果H5链接
}
// ECApplyResponse 电子合同申请响应
type ECApplyResponse struct {
Code string `json:"code" dc:"返回码"` // 成功 000000 其它失败
Msg string `json:"msg" dc:"返回码描述"` // 返回码描述
RespData *ECApplyResponseData `json:"resp_data" dc:"结果信息集合"` // 结果信息集合
RespTime string `json:"resp_time" dc:"响应时间"` // 格式：yyyyMMddHHmmss
}
func (r *ECApplyResponse) SuccessOfFail() bool {
return r.Code == "000000"
}