/merchantContract/addMerchantContract
在用管理后台
#
合同协议-新增 · MerchantContractController
基本信息
| 控制器 | com.jxxx.dscp.api.controller.merchant.MerchantContractController#addMerchantContract |
|---|---|
| 所属模块 | 商户 merchant |
| 暴露渠道 | 管理后台 （@Route 注解；决定 URL 前缀与可访问端） |
| 请求方法 | POST |
调用链路 & 涉及数据表
涉及数据表
merchant_contractController
MerchantContractController#addMerchantContract转换BeanUtils.map →
MerchantContract ⇒ 表 merchant_contractService
MerchantContractService#add （MerchantContractServiceImpl）Mapper
MerchantContractMapper#insert ⇒ 表 merchant_contract其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1
ShopCache.get
链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。
环境 URL
| 环境 | 完整 URL（主机 + 渠道前缀 + 路径） | 备注 |
|---|---|---|
| dev | https://dscp-dev.hn12301.net/manage-api/merchantContract/addMerchantContract | |
| uat | https://dscp-uat.hn12301.net/manage-api/merchantContract/addMerchantContract | |
| pro | https://dscp-uat.hn12301.net/manage-api/merchantContract/addMerchantContract | （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意） |
请求参数 · Header / Query / Path
无（该接口无 Query/Path/Header 显式参数；入参见 Body）
请求参数 · Body
MerchantContractAddRequest| 字段 | 类型 | 必填 | 取值/校验 | 表 / 列 | 说明 |
|---|---|---|---|---|---|
| merchantId | Long | merchant_contract.merchant_id | 所属商户id | ||
| shopId | Long | merchant_contract.shop_id | 所属商铺id | ||
| contractType | ContractType | 1平台协议、分销商协议、旅游卡协议2分销商协议3旅游卡协议 | merchant_contract.contract_type | 合同类型(merchant.ContractType)，1平台协议、2分销商协议、3旅游卡协议 | |
| merchantA | String | merchant_contract.merchant_a | 甲方商户 | ||
| shopA | String | merchant_contract.shop_a | 甲方商铺 | ||
| merchantB | String | merchant_contract.merchant_b | 乙方商户 | ||
| shopB | String | merchant_contract.shop_b | 乙方商铺 | ||
| signTime | Date | merchant_contract.sign_time | 签约时间 | ||
| beginDate | Date | merchant_contract.begin_date | 合同开始日期 | ||
| endDate | Date | merchant_contract.end_date | 合同结束日期 |
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
| errcode | int | 业务码，0=成功 |
| errmsg | string | 提示信息 |
| data | T | 下方“data 结构” |
data 结构
MerchantContractResponse （object）| 字段 | 类型 | 必填 | 取值/校验 | 表 / 列 | 说明 |
|---|---|---|---|---|---|
| id | Long | merchant_contract.id | 主键，合同ID | ||
| merchantId | Long | merchant_contract.merchant_id | 所属商户ID，关联merchant表id | ||
| shopId | Long | merchant_contract.shop_id | 所属商铺ID，关联shop表id | ||
| contractType | ContractType | 1平台协议、分销商协议、旅游卡协议2分销商协议3旅游卡协议 | merchant_contract.contract_type | 合同类型(merchant.ContractType)，1平台协议、2分销商协议、3旅游卡协议 | |
| merchantA | String | merchant_contract.merchant_a | 甲方商户 | ||
| merchantAName | String | — | 甲方商户名称 | ||
| shopA | String | merchant_contract.shop_a | 甲方商铺 | ||
| shopAName | String | — | 甲方商铺名称 | ||
| merchantB | String | merchant_contract.merchant_b | 乙方商户 | ||
| merchantBName | String | — | 乙方商户名称 | ||
| shopB | String | merchant_contract.shop_b | 乙方商铺 | ||
| shopBName | String | — | 乙方商铺名称 | ||
| signTime | Date | merchant_contract.sign_time | 签约时间 | ||
| beginDate | Date | merchant_contract.begin_date | 合同开始日期 | ||
| endDate | Date | merchant_contract.end_date | 合同结束日期 | ||
| party | Integer | — | 判断当前登录用户属于甲方还是乙方 |
示例
请求示例 （自动生成，仅结构参考）
POST /merchantContract/addMerchantContract{
"body": {
"merchantId": 1,
"shopId": 1,
"contractType": "1",
"merchantA": "",
"shopA": "",
"merchantB": "",
"shopB": "",
"signTime": "2026-01-01 12:00:00",
"beginDate": "2026-01-01 12:00:00",
"endDate": "2026-01-01 12:00:00"
}
}响应示例
{
"errcode": 0,
"errmsg": "",
"data": {
"id": 1,
"merchantId": 1,
"shopId": 1,
"contractType": "1",
"merchantA": "",
"merchantAName": "",
"shopA": "",
"shopAName": "",
"merchantB": "",
"merchantBName": "",
"shopB": "",
"shopBName": "",
"signTime": "2026-01-01 12:00:00",
"beginDate": "2026-01-01 12:00:00",
"endDate": "2026-01-01 12:00:00",
"party": 0
}
}处理逻辑
操作日志merchant / 新增合同协议
逻辑摘要新增（merchantService.add）；入参与返回值经 BeanUtils 做对象/分页映射