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

添加电子合同申请、下载、状态查询、人工复核等功能模块
包含请求/响应数据结构及API实现
新增相关常量定义和类型

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)
+}

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"`  // 接口版本号
+}

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"
+}