总览 / 业务域 / 商户·店铺·基础数据
商户·店铺·基础数据
商户与合同财务、店铺、行业/地区/销售等主数据
60接口数
44已确认在用
9子域
8免鉴权接口
3缺摘要
18涉及数据表
要看接口明细：商户·店铺·基础数据 接口清单 →（默认只显示契约，调用链与示例折叠；每页最多 46 个接口）
这个域里有哪些业务对象
| 子域 / 业务对象 | 接口 | 在用 | 代表接口 | 控制器 |
|---|---|---|---|---|
| 区域 | 2 | 2 | get-by-ip tree | AreaController |
| 合同 | 7 | 7 | addMerchantContract deleteMerchantContract getMerchantContract queryMerchantContractAllPage | MerchantContractController |
| 商户 | 8 | 7 | addMerchant deleteMerchant getMerchant importMerchant | MerchantController |
| 地区 | 7 | 1 | addRegion deleteRegion getRegion queryRegionList | RegionController |
| 店铺 | 9 | 8 | addShop deleteShop getMapAddrSuggestions getShop | ShopController |
| 店铺公告 | 7 | 5 | addShopNotice deleteShopNotice getShopNotice queryShopNoticeList | ShopNoticeController |
| 行业 | 7 | 7 | addIndustry deleteIndustry getIndustry queryIndustryCascade | IndustryController |
| 财务 | 7 | 7 | addMerchantFinance deleteMerchantFinance getMerchantFinance queryMerchantFinanceAllPage | MerchantFinanceController |
| 销售 | 6 | 0 | addSales deleteSales getSales querySalesList | SalesController |
本域常用状态与类型字典
值与含义直接来自后端枚举类，不是人工整理。
| 类型 | 含义（源码注释） | 用到接口 | 取值 |
|---|---|---|---|
MerchantType | 商户类型 | 23 | 1＝供应商 2＝分销商 3＝发卡商 4＝其他 5＝酒店 6＝第三方 |
ShopStatus | 商铺状态，1正常运营，2审核中，3暂停运营，4已关店 | 22 | 1＝正常运营 2＝审核中 3＝暂停运营 4＝已关店 |
EbankType | 网银类型，1商户结算 | 12 | 1＝商户结算 2＝销售结算 |
ContractType | 合同类型(merchant.ContractType)，1平台协议、2分销商协议、3旅游卡协议 | 10 | 1＝平台协议 2＝分销商协议 3＝旅游卡协议 |
MerchantStatus | 商户状态，1.正常2.停业 | 7 | 1＝正常 2＝停业 |
BusinessType | 企业类型，1.个体工商户，2.合伙企业，3.有限公司，4.个人独资企业，5.股份有限公司，6.集团公司，7.国有企业，8.外资企业，9.分公司 | 5 | 1＝内资企业 2＝国有企业 3＝集体企业 4＝ 股份合作 5＝联营企业 6＝有限责任公司 7＝股份有限公司 8＝其他企业 9＝港澳台商投资企业 10＝外商投资企业 |
ScaleType | 企业规模，1大型、2中型、3小型、4微型 | 5 | 1＝大型 2＝中型 3＝小型 4＝微型 |
FinanceType | 融资轮次，1初创、2PerA、3A轮、4A+轮、5B轮、6B+轮、7C轮、8C+轮、9D轮、10D+轮、11E轮、12E+轮、13PerIPO、14已上市 | 5 | 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＝已上市 |
读写最多的数据表
| 数据表 | 被多少接口读写 | 反查 |
|---|---|---|
shop | 8 | 全部引用 |
merchant | 8 | 全部引用 |
shop_notice | 7 | 全部引用 |
merchant_finance | 7 | 全部引用 |
merchant_contract | 7 | 全部引用 |
sales | 6 | 全部引用 |
industry | 6 | 全部引用 |
region | 5 | 全部引用 |
shop_relation | 2 | 全部引用 |
goods | 2 | 全部引用 |
system_user_dept | 1 | 全部引用 |
system_user_relation | 1 | 全部引用 |
看这里需要注意：8 个接口是
@Route(auth=false) 免鉴权（不校验登录态），改动前确认调用方与签名校验。