POST/merchant/addMerchant管理后台

Merchant-新增

商户·店铺·基础数据 / 商户· MerchantController#addMerchant

基本信息

接口状态前端在用置信度高
接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/merchant/addMerchant
请求方式POST
Content-Typeapplication/json
暴露渠道管理后台　前缀 /manage-api
名称来源源码注释
调用方已确认在用 · 管理后台（1 个前端）
需求上下文feat:新增商户&地区管理
维护人 / 最后改动AsiQue　2023-11-29　最近提交：feat:新增商户&地区管理
读写数据表merchant、system_role　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.merchant.MerchantController#addMerchant
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/merchant/MerchantController.java:125
判定依据1 个调用点：dscp-html-manage/src/api/merchant/index.ts

请求参数

Header 请求参数

参数名	参数值	是否必填	参数类型	描述说明
无（渠道统一鉴权头见《认证方式》）

Query 请求参数

参数名	参数值	是否必填	参数类型	描述说明
无

路径参数及说明

参数名	参数值	是否必填	参数类型	描述说明
无

Body 请求参数

Body 类型 MerchantAddRequest

参数名	参数值	是否必填	参数类型	描述说明
merchantType	…	是	MerchantType	商户类型 → merchant.merchant_type 1＝供应商 2＝分销商 3＝发卡商 4＝其他 5＝酒店 6＝第三方
fullName	…	是	String	商户名称 → merchant.full_name
shortName	…	否	String	商户简称 → merchant.short_name
uscc	…	否	String	社会信用统一代码 → merchant.uscc
logo	…	否	String	商户LOGO图片url地址 → merchant.logo
provinceId	…	否	String	省id → merchant.province_id
cityId	…	否	String	市id → merchant.city_id
districtId	…	否	String	区县id → merchant.district_id
license	…	否	String	营业执照图片url地址 → merchant.license
introduction	…	否	String	商户简介 → merchant.introduction
linkman	…	否	String	商户联系人 → merchant.linkman
linkphone	…	否	String	商户联系人手机 → merchant.linkphone
manager	…	否	String	商户客户经理 → merchant.manager
corporate	…	否	String	法人代表人 → merchant.corporate
treasurer	…	否	String	财务负责人 → merchant.treasurer
treasurerPhone	…	否	String	财务负责人电话 → merchant.treasurer_phone
setupDay	…	否	Date	成立日期 → merchant.setup_day
businessType	…	否	BusinessType	企业类型，1.个体工商户，2.合伙企业，3.有限公司，4.个人独资企业，5.股份有限公司，6.集团公司，7.国有企业，8.外资企业，9.分公司 → merchant.business_type 1＝内资企业 2＝国有企业 3＝集体企业 4＝股份合作 5＝联营企业 6＝有限责任公司 7＝股份有限公司 8＝其他企业 9＝港澳台商投资企业 10＝外商投资企业
industryId	…	否	Long	所属行业 → merchant.industry_id
businessScale	…	否	ScaleType	企业规模，1大型、2中型、3小型、4微型 → merchant.business_scale 1＝大型 2＝中型 3＝小型 4＝微型
investMoney	…	否	Integer	注册资本(万元) → merchant.invest_money
financeType	…	否	FinanceType	融资轮次，1初创、2PerA、3A轮、4A+轮、5B轮、6B+轮、7C轮、8C+轮、9D轮、10D+轮、11E轮、12E+轮、13PerIPO、14已上市 → merchant.finance_type 1＝初创 2＝PerA 3＝A轮 4＝A+轮 5＝B轮 6＝B+轮 7＝C轮 8＝C+轮 9＝D轮 10＝D+轮 11＝E轮 12＝E+轮 13＝PerIPO 14＝已上市
businessScopes	…	否	String	营业范围 → merchant.business_scopes
remark	…	否	String	备注 → system_role.remark
postalAddress	…	否	String	通讯地址 → merchant.postal_address
registeredAddress	…	否	String	注册地址 → merchant.registered_address
businessAddress	…	否	String	营业地址 → merchant.business_address
merchantStatus	…	否	MerchantStatus	商户状态，1.正常2.停业 → merchant.merchant_status 1＝正常 2＝停业

认证方式

需登录态：Authorization: Bearer <token>（多租户另带 tenant-id）；30002 会话失效需重登。详见全局公共参数。

响应参数

参数名	参数值	是否必填	参数类型	描述说明
void —— 不返回业务数据（外层包装见全局公共参数）

响应示例

成功响应示例 code=0

{"errcode":0,"errmsg":""}

示例来自源码/导出内容，仅结构参考，非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要

涉及数据表：merchant、system_role　反查全部引用接口 →

MerchantController#addMerchant
MerchantService#createInitDept（MerchantServiceImpl）
MerchantService#createInitUser（MerchantServiceImpl）
RoleService#mustGet（RoleServiceImpl）
RoleMapper#mustGet
BeanUtils.map → Merchant ⇒ 表 merchant

其它依赖：ChaosTransactionTemplate.execute、PasswordEncoder.encode

逻辑摘要：调用 execute（newTransactionTemplate.execute）；新增（merchantService.add）；创建（merchantService.createInitDept）；入参与返回值经 BeanUtils 做对象/分页映射

操作日志：merchant / 新增商户

源码内联注释（旧站解析结果）

新增商户
创建商户顶级部门
创建商户默认用户
回滚事务
处理异常

旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

调用点证据

dscp-html-manage/src/api/merchant/index.ts:12　管理后台 · request