MTP20_IF/services/asign/apiModels.go

package asign

type APIRspData interface {
	interface{} | APIBankCard4Rsp | APIAddPersonalUserRsp | APICaptchaVerifyRsp | APIGetUserRsp
}

type APIRsp[T APIRspData] struct {
	Code int    `json:"code"` // 响应码，100000表示成功，其他表示异常
	Msg  string `json:"msg"`  // 响应信息
	Data T      // 响应数据
}

// APIPersonBankCard4Req 个人银行卡四要素认证入参
type APIPersonBankCard4Req struct {
	RealName string `json:"realName" binding:"required"` // 真实姓名
	IdCardNo string `json:"idCardNo" binding:"required"` // 身份证号
	BankCard string `json:"bankCard" binding:"required"` // 银行卡号（仅限印有“银联”字样的银行卡）
	Mobile   string `json:"mobile" binding:"required"`   // 手机号码（限中国大陆11位手机号）
}

// APICompanyBankCard4Req 企业法人银行卡四要素认证入参
type APICompanyBankCard4Req struct {
	CompanyName string `json:"companyName" binding:"required"` // 企业名称
	CreditCode  string `json:"creditCode" binding:"required"`  // 社会统一信用代码
	RealName    string `json:"realName" binding:"required"`    // 法人姓名
	IdCardNo    string `json:"idCardNo" binding:"required"`    // 法人身份证号
	BankCard    string `json:"bankCard" binding:"required"`    // 法人银行卡号（仅限印有“银联”字样的银行卡）
	Mobile      string `json:"mobile" binding:"required"`      // 法人手机号（限中国大陆11位手机号）
}

// APIBankCard4Rsp 银行卡四要素认证出参
type APIBankCard4Rsp struct {
	Result   int    `json:"result"`   // 认证结果 0.暂无结果/认证中 1.成功 2.失败
	SerialNo string `json:"serialNo"` // 认证流水号
	Type     string `json:"type"`     // 认证类型
}

type APICaptchaResendReq struct {
	SerialNo string `json:"serialNo" binding:"required"` // 认证流水号
}

// CaptchaVerifyReq 认证验证码校验入参
type APICaptchaVerifyReq struct {
	SerialNo string `json:"serialNo" binding:"required"` // 认证流水号
	Captcha  string `json:"captcha" binding:"required"`  // 短信验证码
}

// CaptchaVerifyRsp 认证验证码校验出参
type APICaptchaVerifyRsp struct {
	Result   int    `json:"result"`   // 认证结果 0.暂无结果/认证中 1.成功 2.失败
	SerialNo string `json:"serialNo"` // 认证流水号
	Type     string `json:"type"`     // 认证类型
}

// APIGetUserReq 查询用户信息入参
type APIGetUserReq struct {
	Account    *string `json:"account"`    // 用户唯一识别码
	CreditCode *string `json:"creditCode"` // 社会统一信用代码
	IdCard     *string `json:"idCard"`     // 	证件号码
}

// APIGetUserRsp 查询用户信息出参
type APIGetUserRsp struct {
	Account      string `json:"account"`      //	用户账号，用户唯一识别码
	Name         string `json:"name"`         //	个人用户姓名/企业法人姓名
	CompanyName  string `json:"companyName"`  //	企业名称
	IdCard       string `json:"idCard"`       //	个人用户证件号/企业法人身份证号
	Mobile       string `json:"mobile"`       //	用户手机号（签约短信通知手机号）
	Email        string `json:"email"`        //	用户邮箱号
	UserType     int    `json:"userType"`     //	用户类型: 1:企业 2:个人
	CreditCode   string `json:"creditCode"`   //	社会统一信用代码
	BankCard     string `json:"bankCard"`     //	用户银行卡号
	PortVersion  int    `json:"portVersion"`  //	用户添加时调用的接口版本: 0:历史接口 1:V2版本接口
	IdentifyType int    `json:"identifyType"` //	认证类型
	AuthType     int    `json:"authType"`     //	认证方式: 当portVersion=0 历史接口时 0:非强制认证 1:爱签平台强制认证 当portVersion=1 (V2)版本接口时 0:平台方自行认证 1:爱签平台认证
	CreateTime   string `json:"createTime"`   //	创建时间
	IdentifyTime string `json:"identifyTime"` //	认证时间
}

// AddPersonalUserReq 添加个人用户（V2）入参
type APIAddPersonalUserReq struct {
	Account         string `json:"account" binding:"required"` // 用户唯一识别码（请转入UserID）
	SerialNo        string `json:"serialNo"`                   // 实名认证流水号
	Name            string `json:"name"`                       // 用户姓名
	IdCard          string `json:"idCard"`                     // 个人身份证、台胞证、港澳通行证等证件号
	IdCardType      int    `json:"idCardType"`                 // 证件类型 1:居民身份证 2:台湾居民来往内地通行证 3:港澳居民往来内地通行证 10:武装警察身份证 11:军人身份证 15:警察（警官）证 21:外国人永久居留证 23:护照
	Mobile          string `json:"mobile"`                     // 手机号码
	SignPwd         string `json:"signPwd"`                    // 签约密码（MTP2登录密码加密方式），如果为空将随机生成签约密码（当签约方式为“签约密码签约”时会使用到，可通过重置接口修改）
	IsSignPwdNotice int    `json:"isSignPwdNotice"`            // 是否将签约密码以短信形式通知用户 0:不通知（默认） 1:通知
	IsNotice        int    `json:"isNotice"`                   // 用户发起合同或需要签署时是否进行短信通知 0:否（默认） 1:是
}

// AddPersonalUserRsp 添加个人用户（V2）出参
type APIAddPersonalUserRsp struct {
	SealNo string `json:"sealNo"  binding:"required"` // 生成默认印章编号
}

type APITemplate struct {
	TemplateNo string `json:"templateNo"` // 合同模板编号
}

type APICreateContractReq struct {
	ContractNo   string `json:"contractNo" binding:"required"`   // 合同ID，合同唯一编号
	ContractName string `json:"contractName" binding:"required"` // 合同名称
	ValidityTime int    `json:"validityTime"`                    // 合同签署剩余天数（系统当前时间+该天数=在此日期之前可以签署合同日期），【注】与合同有效截止日期必传其一，【例】可传剩余天数:15
	ValidityDate string `json:"validityDate"`                    // 合同有效截止日期（在此日期之前可以签署合同，格式要求:yyyyMMddHHmmss），【注】与合同有效天数必传其一，【例】传值“20231207190000” 为:2023年12月07日19时00分00秒
	SignOrder    int    `json:"signOrder" binding:"required"`    // 签约方式 1:无序签约（默认） 2:顺序签约
}