From e985b790d4c30df39f81686b569de37269d347db Mon Sep 17 00:00:00 2001 From: maguodong Date: Mon, 20 Oct 2025 10:28:54 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E7=94=B5=E5=AD=90=E5=90=88?= =?UTF-8?q?=E5=90=8C=E7=9B=B8=E5=85=B3=E6=8E=A5=E5=8F=A3=E5=8F=8A=E6=95=B0?= =?UTF-8?q?=E6=8D=AE=E7=BB=93=E6=9E=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 添加电子合同申请、下载、状态查询、人工复核等功能模块 包含请求/响应数据结构及API实现 新增相关常量定义和类型 --- consts/ec.go | 42 +++++++++++++++ lklsdk/merchant/in_net/ec/apply/api.go | 47 ++++++++++++++++ lklsdk/merchant/in_net/ec/apply/request.go | 54 +++++++++++++++++++ lklsdk/merchant/in_net/ec/apply/response.go | 20 +++++++ lklsdk/merchant/in_net/ec/applymanual/api.go | 41 ++++++++++++++ .../merchant/in_net/ec/applymanual/request.go | 27 ++++++++++ .../in_net/ec/applymanual/response.go | 19 +++++++ lklsdk/merchant/in_net/ec/download/api.go | 46 ++++++++++++++++ lklsdk/merchant/in_net/ec/download/request.go | 15 ++++++ .../merchant/in_net/ec/download/response.go | 22 ++++++++ lklsdk/merchant/in_net/ec/qmastatus/api.go | 39 ++++++++++++++ .../merchant/in_net/ec/qmastatus/request.go | 16 ++++++ .../merchant/in_net/ec/qmastatus/response.go | 25 +++++++++ lklsdk/merchant/in_net/ec/querystatus/api.go | 46 ++++++++++++++++ .../merchant/in_net/ec/querystatus/request.go | 19 +++++++ .../in_net/ec/querystatus/response.go | 22 ++++++++ 16 files changed, 500 insertions(+) create mode 100644 consts/ec.go create mode 100644 lklsdk/merchant/in_net/ec/apply/api.go create mode 100644 lklsdk/merchant/in_net/ec/apply/request.go create mode 100644 lklsdk/merchant/in_net/ec/apply/response.go create mode 100644 lklsdk/merchant/in_net/ec/applymanual/api.go create mode 100644 lklsdk/merchant/in_net/ec/applymanual/request.go create mode 100644 lklsdk/merchant/in_net/ec/applymanual/response.go create mode 100644 lklsdk/merchant/in_net/ec/download/api.go create mode 100644 lklsdk/merchant/in_net/ec/download/request.go create mode 100644 lklsdk/merchant/in_net/ec/download/response.go create mode 100644 lklsdk/merchant/in_net/ec/qmastatus/api.go create mode 100644 lklsdk/merchant/in_net/ec/qmastatus/request.go create mode 100644 lklsdk/merchant/in_net/ec/qmastatus/response.go create mode 100644 lklsdk/merchant/in_net/ec/querystatus/api.go create mode 100644 lklsdk/merchant/in_net/ec/querystatus/request.go create mode 100644 lklsdk/merchant/in_net/ec/querystatus/response.go diff --git a/consts/ec.go b/consts/ec.go new file mode 100644 index 0000000..3340e97 --- /dev/null +++ b/consts/ec.go @@ -0,0 +1,42 @@ +package consts + +type ECType string + +const ( + ECType001 ECType = "EC001" // EC001 : 特约商户支付服务合作协议V3.1(商户入网) + ECType002 ECType = "EC002" // EC002 : 特约商户支付服务合作协议V3.2（商户入网+分账） + ECType003 ECType = "EC003" // EC003 : 分账结算授权委托书 + ECType004 ECType = "EC004" // EC004 : 特约商户支付服务合作协议V3.3（商户入网） + ECType005 ECType = "EC005" // EC005 : 特约商户支付服务合作协议V3.3（商户入网+分账） + ECType007 ECType = "EC007" // EC007 : 特约商户支付服务合作协议V4.1 + 结算授权委托书 (商户入网 + 分账 ) + ECType008 ECType = "EC008" // EC008 : 特约商户支付服务合作协议V4.1 (商户入网) + ECType009 ECType = "EC009" // EC009 : 结算授权委托书 +) + +func (e ECType) Ptr() string { + return string(e) +} + +type CertType string + +const ( + CertType_RESIDENT_ID CertType = "RESIDENT_ID" // RESIDENT_ID（身份证) + CertType_PASSPORT CertType = "PASSPORT" // PASSPORT（护照） + CertType_HK_MACAO_PASS CertType = "HK_MACAO_PASS" // HK_MACAO_PASS（港澳居民往来内地通行证） + CertType_TAIWAN_PASS CertType = "TAIWAN_PASS" // TAIWAN_PASS（台湾居民来往大陆通行证） +) + +func (c CertType) Ptr() string { + return string(c) +} + +type AgentTag int + +const ( + AgentTag0 AgentTag = iota // 0：不启用 缺省 + AgentTag1 // 1: 启用 +) + +func (a AgentTag) Ptr() int { + return int(a) +} diff --git a/lklsdk/merchant/in_net/ec/apply/api.go b/lklsdk/merchant/in_net/ec/apply/api.go new file mode 100644 index 0000000..0727099 --- /dev/null +++ b/lklsdk/merchant/in_net/ec/apply/api.go @@ -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) +} diff --git a/lklsdk/merchant/in_net/ec/apply/request.go b/lklsdk/merchant/in_net/ec/apply/request.go new file mode 100644 index 0000000..fc8025e --- /dev/null +++ b/lklsdk/merchant/in_net/ec/apply/request.go @@ -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 +} diff --git a/lklsdk/merchant/in_net/ec/apply/response.go b/lklsdk/merchant/in_net/ec/apply/response.go new file mode 100644 index 0000000..5cbd2ed --- /dev/null +++ b/lklsdk/merchant/in_net/ec/apply/response.go @@ -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" +} diff --git a/lklsdk/merchant/in_net/ec/applymanual/api.go b/lklsdk/merchant/in_net/ec/applymanual/api.go new file mode 100644 index 0000000..7b3cd38 --- /dev/null +++ b/lklsdk/merchant/in_net/ec/applymanual/api.go @@ -0,0 +1,41 @@ +package applymanual + +import ( + "github.com/black1552/lkl_sdk/consts" + "github.com/black1552/lkl_sdk/lklsdk/common" + "github.com/gogf/gf/v2/os/gtime" +) + +// ApplyManual 电子合同人工复核申请服务 +type ApplyManual struct { + Client *common.Client[ECApplyManualResponse] +} + +// NewApplyManual 创建新的电子合同人工复核申请服务 +func NewApplyManual(client *common.Client[ECApplyManualResponse]) *ApplyManual { + return &ApplyManual{ + Client: client, + } +} + +// ECApplyManual 电子合同人工复核申请（生产环境） +func (a *ApplyManual) ECApplyManual(req *ECApplyManualRequestData) (*ECApplyManualResponse, error) { + // 创建请求对象 + request := ECApplyManualRequest{ + ReqTime: gtime.Now().Format("YmdHis"), + ReqData: req, + Version: "1.0", + } + return a.Client.DoRequest(consts.BASE_URL+consts.LKL_EC_APPLY_MANUAL, request) +} + +// ECApplyManualTest 电子合同人工复核申请（测试环境） +func (a *ApplyManual) ECApplyManualTest(req *ECApplyManualRequestData) (*ECApplyManualResponse, error) { + // 创建请求对象 + request := ECApplyManualRequest{ + ReqTime: gtime.Now().Format("YmdHis"), + ReqData: req, + Version: "1.0", + } + return a.Client.DoRequest(consts.BASE_TEST_URL+consts.LKL_EC_APPLY_MANUAL, request) +} diff --git a/lklsdk/merchant/in_net/ec/applymanual/request.go b/lklsdk/merchant/in_net/ec/applymanual/request.go new file mode 100644 index 0000000..04c91be --- /dev/null +++ b/lklsdk/merchant/in_net/ec/applymanual/request.go @@ -0,0 +1,27 @@ +package applymanual + +// ECApplyManualRequestData 电子合同人工复核申请请求数据结构体 +type ECApplyManualRequestData struct { + Version string `json:"version"` // 版本号，默认1.0 + OrderNo string `json:"order_no"` // 四方机构自定义订单编号，必填，建议平台编号+14位年月日时分秒+8位随机数 + OrgID int `json:"org_id"` // 机构号，必填，签约方所属拉卡拉机构 + EcApplyID string `json:"ec_apply_id"` // 电子合同申请受理号，必填，申请接口反馈编号 + ApplyDesc string `json:"apply_desc"` // 申请说明，必填，复议提交的原因说明 + FileData []*ECFileData `json:"file_data"` // 附件信息集合，必填，提供给审核人员核对信息 + RetURL string `json:"ret_url,omitempty"` // 回调地址，可选 +} + +// ECFileData 附件信息结构体 +type ECFileData struct { + AttachType string `json:"attach_type"` // 附件类型，必填，枚举值见文档 + AttachName string `json:"attach_name"` // 附件名称，必填，最大32字符 + AttachExtName string `json:"attach_ext_name"` // 附件格式，必填，jpg、pdf等 + AttachStorePath string `json:"attach_store_path"` // 附件坐标URL，必填，如G1/M00/00/61/CrFdEl3IyceAVVd8AAA0ADuZsA0911.jpg +} + +// ECApplyManualRequest 电子合同人工复核申请请求结构体 +type ECApplyManualRequest struct { + ReqTime string `json:"req_time"` // 请求时间 + ReqData *ECApplyManualRequestData `json:"req_data"` // 请求数据 + Version string `json:"version"` // 接口版本号 +} diff --git a/lklsdk/merchant/in_net/ec/applymanual/response.go b/lklsdk/merchant/in_net/ec/applymanual/response.go new file mode 100644 index 0000000..105f1e6 --- /dev/null +++ b/lklsdk/merchant/in_net/ec/applymanual/response.go @@ -0,0 +1,19 @@ +package applymanual + +// ECApplyManualResponseData 电子合同人工复核申请响应数据结构体 +type ECApplyManualResponseData struct { + // 响应数据为空对象，根据API文档，成功时返回空的resp_data +} + +// ECApplyManualResponse 电子合同人工复核申请响应结构体 +type ECApplyManualResponse struct { + Code string `json:"code"` // 返回码，成功为000000，其他为失败 + Msg string `json:"msg"` // 返回码描述 + RespData ECApplyManualResponseData `json:"resp_data"` // 响应数据 +} + +// SuccessOfFail 检查响应是否成功 +// 返回true表示成功，false表示失败 +func (r *ECApplyManualResponse) SuccessOfFail() bool { + return r.Code == "000000" +} \ No newline at end of file diff --git a/lklsdk/merchant/in_net/ec/download/api.go b/lklsdk/merchant/in_net/ec/download/api.go new file mode 100644 index 0000000..f5cb831 --- /dev/null +++ b/lklsdk/merchant/in_net/ec/download/api.go @@ -0,0 +1,46 @@ +package download + +import ( + "github.com/black1552/lkl_sdk/consts" + "github.com/black1552/lkl_sdk/lklsdk/common" + "github.com/gogf/gf/v2/os/gtime" +) + +type Download struct { + Client *common.Client[ECDownloadResponse] +} + +// NewDownload 创建电子合同下载服务实例 +func NewDownload(client *common.Client[ECDownloadResponse]) *Download { + return &Download{ + Client: client, + } +} + +// ECDownload 电子合同下载 +// 提供已完成的签约电子合同下载 +func (d *Download) ECDownload(req *ECDownloadRequestData) (*ECDownloadResponse, error) { + // 构建请求 + baseReq := ECDownloadRequest{ + ReqTime: gtime.Now().Format("YmdHis"), + ReqData: req, + Version: "1.0", + } + + // 使用生产环境URL + return d.Client.DoRequest(consts.BASE_URL+consts.LKL_EC_DOWNLOAD, baseReq) +} + +// ECDownloadTest 电子合同下载（测试环境） +// 提供已完成的签约电子合同下载 +func (d *Download) ECDownloadTest(req *ECDownloadRequestData) (*ECDownloadResponse, error) { + // 构建请求 + baseReq := ECDownloadRequest{ + ReqTime: gtime.Now().Format("YmdHis"), + ReqData: req, + Version: "1.0", + } + + // 使用测试环境URL + return d.Client.DoRequest(consts.BASE_TEST_URL+consts.LKL_EC_DOWNLOAD, baseReq) +} diff --git a/lklsdk/merchant/in_net/ec/download/request.go b/lklsdk/merchant/in_net/ec/download/request.go new file mode 100644 index 0000000..bfaf197 --- /dev/null +++ b/lklsdk/merchant/in_net/ec/download/request.go @@ -0,0 +1,15 @@ +package download + +// ECDownloadRequestData 电子合同下载请求数据 +type ECDownloadRequestData struct { + OrderNo string `json:"order_no" dc:"四方机构自定义订单编号"` // 四方机构自定义订单编号 + OrgCode int `json:"org_code" dc:"机构号"` // 机构号 + EcApplyID int64 `json:"ec_apply_id" dc:"电子合同申请受理号"` // 电子合同申请受理号 +} + +// ECDownloadRequest 电子合同下载请求结构 +type ECDownloadRequest struct { + ReqTime string `json:"req_time"` // 请求时间 + ReqData *ECDownloadRequestData `json:"req_data"` // 请求数据 + Version string `json:"version"` // 接口版本号 +} \ No newline at end of file diff --git a/lklsdk/merchant/in_net/ec/download/response.go b/lklsdk/merchant/in_net/ec/download/response.go new file mode 100644 index 0000000..18e8874 --- /dev/null +++ b/lklsdk/merchant/in_net/ec/download/response.go @@ -0,0 +1,22 @@ +package download + +// ECDownloadResponseData 电子合同下载响应数据 +type ECDownloadResponseData struct { + OrderNo string `json:"order_no"` // 请求上送的订单号 + EcApplyID int64 `json:"ec_apply_id"` // 电子签约申请受理编号 + EcStatus string `json:"ec_status"` // 电子合同状态: UNDONE 未完成, COMPLETED 已完成 + EcNo string `json:"ec_no"` // 电子合同号（合同状态为COMPLETED时返回） + EcFile string `json:"ec_file"` // 电子合同pdf文件(base64格式字符，合同状态为COMPLETED时返回) +} + +// ECDownloadResponse 电子合同下载响应结构 +type ECDownloadResponse struct { + Code string `json:"code"` // 返回码 + Msg string `json:"msg"` // 返回码描述 + RespData *ECDownloadResponseData `json:"resp_data"` // 结果信息集合 +} + +// SuccessOfFail 检查响应是否成功 +func (r *ECDownloadResponse) SuccessOfFail() bool { + return r.Code == "000000" +} \ No newline at end of file diff --git a/lklsdk/merchant/in_net/ec/qmastatus/api.go b/lklsdk/merchant/in_net/ec/qmastatus/api.go new file mode 100644 index 0000000..5a8b9ef --- /dev/null +++ b/lklsdk/merchant/in_net/ec/qmastatus/api.go @@ -0,0 +1,39 @@ +package qmastatus + +import ( + "github.com/black1552/lkl_sdk/consts" + "github.com/black1552/lkl_sdk/lklsdk/common" + "github.com/gogf/gf/v2/os/gtime" +) + +// QmaStatus 电子合同人工复核结果查询服务 +type QmaStatus struct { + Client *common.Client[ECQmaStatusResponse] +} + +// NewQmaStatus 创建新的电子合同人工复核结果查询服务 +func NewQmaStatus(client *common.Client[ECQmaStatusResponse]) *QmaStatus { + return &QmaStatus{Client: client} +} + +// ECQmaStatus 电子合同人工复核结果查询（生产环境） +func (q *QmaStatus) ECQmaStatus(req *ECQmaStatusRequestData) (*ECQmaStatusResponse, error) { + // 创建请求对象 + request := ECQmaStatusRequest{ + ReqTime: gtime.Now().Format("YmdHis"), + ReqData: req, + Version: "1.0", + } + return q.Client.DoRequest(consts.BASE_URL+consts.LKL_EC_QMA_STATUS, request) +} + +// ECQmaStatusTest 电子合同人工复核结果查询（测试环境） +func (q *QmaStatus) ECQmaStatusTest(req *ECQmaStatusRequestData) (*ECQmaStatusResponse, error) { + // 创建请求对象 + request := ECQmaStatusRequest{ + ReqTime: gtime.Now().Format("YmdHis"), + ReqData: req, + Version: "1.0", + } + return q.Client.DoRequest(consts.BASE_TEST_URL+consts.LKL_EC_QMA_STATUS, request) +} \ No newline at end of file diff --git a/lklsdk/merchant/in_net/ec/qmastatus/request.go b/lklsdk/merchant/in_net/ec/qmastatus/request.go new file mode 100644 index 0000000..1e91cc0 --- /dev/null +++ b/lklsdk/merchant/in_net/ec/qmastatus/request.go @@ -0,0 +1,16 @@ +package qmastatus + +// ECQmaStatusRequestData 电子合同人工复核结果查询请求数据结构体 +type ECQmaStatusRequestData struct { + Version string `json:"version"` // 版本号，默认1.0 + OrderNo string `json:"order_no"` // 四方机构自定义订单编号，必填，建议平台编号+14位年月日时分秒+8位随机数 + OrgID int `json:"org_id"` // 机构号，必填，签约方所属拉卡拉机构 + EcApplyID string `json:"ec_apply_id"` // 电子合同申请受理号，必填，申请接口反馈编号 +} + +// ECQmaStatusRequest 电子合同人工复核结果查询请求结构体 +type ECQmaStatusRequest struct { + ReqTime string `json:"req_time"` // 请求时间 + ReqData *ECQmaStatusRequestData `json:"req_data"` // 请求数据 + Version string `json:"version"` // 接口版本号 +} \ No newline at end of file diff --git a/lklsdk/merchant/in_net/ec/qmastatus/response.go b/lklsdk/merchant/in_net/ec/qmastatus/response.go new file mode 100644 index 0000000..7f1c1cf --- /dev/null +++ b/lklsdk/merchant/in_net/ec/qmastatus/response.go @@ -0,0 +1,25 @@ +package qmastatus + +// ECQmaStatusResponseData 电子合同人工复核结果查询响应数据结构体 +type ECQmaStatusResponseData struct { + Version string `json:"version"` // 版本号 + OrderNo string `json:"order_no"` // 四方机构自定义订单编号 + OrgID int `json:"org_id"` // 机构号 + EcApplyID string `json:"ec_apply_id"` // 电子合同申请受理号 + AuditStatus string `json:"audit_status"` // 人工审核状态：WAIT_AUDIT待审核、PASS审核通过、REFUSE审核拒绝、CLOSE审核关闭 + AuditDesc string `json:"audit_desc"` // 人工审核结果说明 + SignH5URL string `json:"sign_h5_url"` // 签约H5地址，审核通过时返回 + SignH5URLExpTm string `json:"sign_h5_url_exp_tm"` // 签约H5地址过期时间，审核通过时返回 +} + +// ECQmaStatusResponse 电子合同人工复核结果查询响应结构体 +type ECQmaStatusResponse struct { + Code string `json:"code"` // 返回码，成功000000，其它失败 + Msg string `json:"msg"` // 返回码描述 + RespData *ECQmaStatusResponseData `json:"resp_data"` // 响应数据 +} + +// SuccessOfFail 判断响应是否成功 +func (r *ECQmaStatusResponse) SuccessOfFail() bool { + return r != nil && r.Code == "000000" +} \ No newline at end of file diff --git a/lklsdk/merchant/in_net/ec/querystatus/api.go b/lklsdk/merchant/in_net/ec/querystatus/api.go new file mode 100644 index 0000000..93bbd0e --- /dev/null +++ b/lklsdk/merchant/in_net/ec/querystatus/api.go @@ -0,0 +1,46 @@ +package querystatus + +import ( + "github.com/black1552/lkl_sdk/consts" + "github.com/black1552/lkl_sdk/lklsdk/common" + "github.com/gogf/gf/v2/os/gtime" +) + +type QStatus struct { + Client *common.Client[ECQueryStatusResponse] +} + +// NewQStatus 创建电子合同查询状态服务实例 +func NewQStatus(client *common.Client[ECQueryStatusResponse]) *QStatus { + return &QStatus{ + Client: client, + } +} + +// QueryStatus 电子合同查询状态 +// 提供申请过与拉卡拉电子签约用户查询电子合同签署状态 +func (q *QStatus) QueryStatus(req *ECQueryStatusRequestData) (*ECQueryStatusResponse, error) { + // 构建请求 + baseReq := ECQueryStatusRequest{ + ReqTime: gtime.Now().Format("YmdHis"), + ReqData: req, + Version: "1.0", + } + + // 使用生产环境URL + return q.Client.DoRequest(consts.BASE_URL+consts.LKL_EC_QUERY_STATUS, baseReq) +} + +// QueryStatusTest 电子合同查询状态（测试环境） +// 提供申请过与拉卡拉电子签约用户查询电子合同签署状态 +func (q *QStatus) QueryStatusTest(req *ECQueryStatusRequestData) (*ECQueryStatusResponse, error) { + // 构建请求 + baseReq := ECQueryStatusRequest{ + ReqTime: gtime.Now().Format("YmdHis"), + ReqData: req, + Version: "1.0", + } + + // 使用测试环境URL + return q.Client.DoRequest(consts.BASE_TEST_URL+consts.LKL_EC_QUERY_STATUS, baseReq) +} diff --git a/lklsdk/merchant/in_net/ec/querystatus/request.go b/lklsdk/merchant/in_net/ec/querystatus/request.go new file mode 100644 index 0000000..022e355 --- /dev/null +++ b/lklsdk/merchant/in_net/ec/querystatus/request.go @@ -0,0 +1,19 @@ +package querystatus + +// ECQueryStatusRequestData 电子合同查询状态请求数据 +// 提供申请过与拉卡拉电子签约用户查询电子合同签署状态 +// 请求URL： +// 测试环境：https://test.wsmsd.cn/sit/api/v3/mms/open_api/ec/q_status +// 生产环境：https://s2.lakala.com/api/v3/mms/open_api/ec/q_status +type ECQueryStatusRequestData struct { + OrderNo string `json:"order_no" dc:"四方机构自定义订单编号 必选，建议：平台编号+14位年月日时（24小时制）分秒+8位的随机数（同一接入机构不重复）"` // 必选，建议：平台编号+14位年月日时（24小时制）分秒+8位的随机数（同一接入机构不重复） + OrgID int `json:"org_id" dc:"机构号 必选，签约方所属拉卡拉机构"` // 必选，签约方所属拉卡拉机构 + EcApplyID int64 `json:"ec_apply_id" dc:"电子合同申请受理号 必选，申请接口反馈编号"` // 必选，申请接口反馈编号 +} + +// ECQueryStatusRequest 电子合同查询状态请求 +type ECQueryStatusRequest struct { + ReqTime string `json:"req_time" dc:"请求时间"` // 必选，格式：yyyyMMddHHmmss + ReqData *ECQueryStatusRequestData `json:"req_data" dc:"请求数据"` // 请求数据 + Version string `json:"version" dc:"版本号"` // 必选，固定值：1.0 +} \ No newline at end of file diff --git a/lklsdk/merchant/in_net/ec/querystatus/response.go b/lklsdk/merchant/in_net/ec/querystatus/response.go new file mode 100644 index 0000000..83fa24b --- /dev/null +++ b/lklsdk/merchant/in_net/ec/querystatus/response.go @@ -0,0 +1,22 @@ +package querystatus + +// ECQueryStatusResponseData 电子合同查询状态响应数据 +type ECQueryStatusResponseData struct { + OrderNo string `json:"order_no" dc:"请求上送的订单号"` // 请求上送的订单号 + EcApplyID int64 `json:"ec_apply_id" dc:"电子签约申请受理编号"` // 电子签约申请受理编号 + EcStatus string `json:"ec_status" dc:"电子合同签署状态"` // 电子合同签署状态，UNDONE 未完成，COMPLETED 已完成 + EcNo string `json:"ec_no" dc:"电子合同号"` // 签署完成反馈 +} + +// ECQueryStatusResponse 电子合同查询状态响应 +type ECQueryStatusResponse struct { + Code string `json:"code" dc:"返回码"` // 成功 000000 其它失败 + Msg string `json:"msg" dc:"返回码描述"` // 返回码描述 + RespData *ECQueryStatusResponseData `json:"resp_data" dc:"结果信息集合"` // 结果信息集合 + RespTime string `json:"resp_time" dc:"响应时间"` // 格式：yyyyMMddHHmmss +} + +// SuccessOfFail 检查响应是否成功 +func (r *ECQueryStatusResponse) SuccessOfFail() bool { + return r.Code == "000000" +} \ No newline at end of file