渠道商品域(渠道中心 + 商品中心,新建)

领域服务(实现)
渠道商品域渠道中心(商家 / 门店 / SA,新建)、商品中心(手机 SKU,新建)

现状

无。fds 案件模型有 pos_sa_info 维度(SA 信息快照),非渠道管理能力。手机分期 SA 地推必需,属全新建。

MVP 目标

支撑 PocketBuy SA 办单(选品 + 客户进件)+ 放款到门店收款账户。数据模型按销售反馈一次性预留全字段;MVP 期间人工收集导入;自助入驻/线上注册后置。

业务口径

  • 渠道商品域是手机分期新增域,承载商家、门店、SA、SA-门店关联和手机 SKU;现金贷不依赖本域。
  • MVP 不做商家/门店/SA 自助入驻,先按销售反馈人工收集并导入,全字段预留以减少后续返工。
  • 门店是放款到商户的收款方来源,需提供按 store_id 查询账户号、开户行、户名的能力;BVN 仅做核验,不作为放款路由字段。
  • 商品 SKU 只承载品牌、型号、参考价和状态;实际成交价由 SA 办单时输入,首付、期数、价格上限由风控政策接口动态返回。
  • IMEI 设备反查同时服务两个场景:录单时扫码反查品牌/型号并回填草稿;交机时反查交付设备品牌/型号,并与进件商品快照一致性校验。不直接定位 SKU,也不承载风控政策。

详细方案

方案说明
[[10-IMEI设备反查IMEI设备反查]]

业务实体与关系

商家 merchant 1───N 门店 store (POS 点) M───N SA
                       │
                       └── 一家门店一组收款账户(→ 支付域放款到商户)
  • 商家:连锁品牌(SLOT / 3CHUB 等)或同一店主名下多店的归口名。
  • 门店 = POS 点:实际成交位置;门店类型决定风控权重与合作模式。
  • SA:销售人员;一 SA 可服务多门店,一门店可有多 SA(多对多)。SA 有上级主管层级。

数据模型(全字段预留)

字段来源:销售团队反馈(domain/sa&merchant/sa & merchant inforamtion.xlsx)。MVP 全字段预留——早期人工收集 + 人工导入,后续做自助入驻/线上注册时复用。是否必填随业务策略调整,本文不锁。照片字段定义保留,存储技术由研发自定

商家 merchant

字段说明
merchant_id主键
merchant_name商家名称:连锁名(SLOT / 3CHUB)或店主姓名(个人多店)
merchant_type连锁 / 个人多店 / 独立店主(可由门店类型派生)

门店 store(POS 点)

分组字段说明
基础store_id主键
merchant_id外键
store_name门店名称
store_type类型枚举:大型连锁 / 品牌授权店 / 独立零售点(夫妻店)/ 微型零售点(小摊贩、移动摊贩)
business_district所属商圈 / 市场
business_license营业执照(号 + 扫描件;有则风控加权)
照片exterior_photo门店外部全景
interior_photo[]门店内部(可多张)
manager_owner_photo推广经理与店主合照
店主owner_name店主姓名
owner_phone店主手机号
owner_nin店主 NIN
收款payee_bank_account收款方银行账户(NUBAN)
payee_bank_code收款方开户行代码(放款 transfer 路由必需
payee_account_name收款方姓名
payee_bvn收款方 BVN(核验用,非放款路由)
经营open_date开业日期
monthly_sales_avg月均销量
store_area店面面积
位置address门店地址
gps_locationGPS(lat / lng)
state所在州
city所在城市
合作cooperation_mode代销 / 经销 / 佣金
deposit_amount保证金(如有)
contract_sign_date签约日期
contract_valid_until合同有效期
资质review_status状态机:待审 / 通过 / 拒绝 / 暂停
review_date审核日期

放款到商户的收款方来源于门店收款字段:放款指令需 账户号(NUBAN) + 开户行 bank_code + 户名(与 fcs 放款 PaymentBankInfo 对齐;BVN 仅核验、非路由)。由 bns 编排按 store_id 查门店收款账户,随放款指令传 fcs/支付域。需提供「按 store_id 查门店收款账户」能力。

SA(销售人员)

分组字段说明
基本sa_id主键(=SA 编号)
sa_name姓名
gender性别
date_of_birth出生日期
primary_phone主用手机号
alternate_phone备用手机号
email电子邮箱
bvnBVN
ninNIN
id_card_front_photo身份证正面
id_card_back_photo身份证反面
selfie_photo本人现场照片
任职employment_start_date入职日期
region所属区域
city所属城市
job_role销售推广 / 信息录入 / 客户服务
employment_type全职 / 兼职 / 临时
supervisor_sa_id上级主管(SA 自引用)
资格培训education_level最高学历
school_name毕业院校
work_experience_years相关工作经验(年)
training_date分期业务培训日期
training_result通过 / 未通过
联系residential_address当前居住地址
emergency_contact_1_name / relationship / phone紧急联系人 1
emergency_contact_2_name / phone紧急联系人 2
账户salary_bank工资收款银行
salary_account_nuban工资银行账号
salary_payment_date工资发放日
审核background_check背调结果(通过 / 未通过)
store_manager_signed_by门店经理签字(姓名)
store_manager_id门店经理编号
review_date审核日期
remarks备注
review_status状态机:待审 / 通过 / 拒绝 / 暂停

SA-门店关联 sa_store(多对多)

字段说明
sa_idFK
store_idFK
assigned_at派驻起始
is_active在职 / 离职 / 调动

商品 SKU(手机型号目录,表名 sku

字段说明
sku_id主键
brand品牌(如 Tecno / Infinix / Samsung)
model型号
reference_price参考价——可被 SA 在办单时改写为实际成交价
spec规格描述(可选;含存储 / 颜色等子项)
status在售 / 下架

实际成交价由 SA 在办单时输入(小店进货价不固定);商品中心只提供参考价。
IMEI 不属于 SKU——是逐笔成交交机时回填到分期订单的实物串号;借据通过订单关联获取,不在建借据时落 fcs_loan

改造点清单

改造点类型复杂度说明
商家 / 门店(POS点) / SA / SA-门店关联 建模新建全字段预留
商品 SKU 建模(品牌+型号+参考价)新建
IMEI 设备反查(扫码带出机型,渠道中心直挂第三方)新建SA 办单扫 IMEI 自动带出品牌/型号,加速录单;交机时反查品牌/型号并与进件商品一致性校验;详见 [[10-IMEI设备反查
MVP 人工导入:商家 / 门店 / SA / SKU 数据新建Excel/SQL 导入工具或运营脚本
资质审核状态机:SA + 门店(待审/通过/拒绝/暂停)新建含培训考核 / 背调 / 经理签字 / 合同有效期
办单资质校验接口新建校验 SA 通过 ∧ 培训通过 ∧ 门店通过 ∧ 合同有效期内
PocketBuy SA 查询接口:商家 / 门店 / SA / 商品新建含按地区、品牌、型号筛选
商户收款账户查询接口(给支付域)新建入参 store_id → 出账户号、银行代码、户名、账户核验状态、账户快照;BVN 仅核验不做路由
选品试算新建SKU 参考价 → SA 改实际价 → pfs 产品配置 → 分期方案(首付 / 月供 / 期次)
自助入驻 / 线上注册(商家 / 门店 / SA)排除MVP 后;MVP 走人工导入
SA 基础业绩查询 / 薪资 / 运营管理台排除MVP 后

IMEI 设备反查口径

详细接口契约见 IMEI设备反查

MVP 口径
触发方PocketBuy SA 试算/录单页;交机确认流程
入参15 位 IMEI,本地先做长度和 Luhn 校验
出参IMEI、TAC、brand、model、lookup_source、lookup_id
上游第三方 IMEI 反查 API,MVP 单源接入
留痕imei_lookup_record,为后续自建 TAC-SKU 库沉淀数据
交机校验交机 IMEI 反查出的品牌、型号必须与进件商品快照一致,不一致阻断交机
降级录单时未命中或上游超时可切换手动选 catalog / 手填;交机时反查失败不自动放行,需重试或人工核查
二期自建 TAC-SKU 库、厂商数据合作、多源路由

依赖

  • PocketBuy SA(查询商家/门店/SA/商品、办单资质校验、选品试算)。
  • 业务编排域(SA 代客办单进件携带 sa_id + store_id + merchant_id + sku_id + 实际价;交机时携带 IMEI 反查品牌/型号和一致性校验结果)。
  • 支付域(放款到商户的收款账户 = 门店收款三件套)。
  • 信贷账务域 pfs(产品配置参与试算)。

门店收款账户查询接口

内容
调用方向bns -> 渠道商品域
触发时点商户放款前
入参store_idmerchant_idinstallment_order_id
出参门店收款账户快照

出参字段:

字段必填说明
store_id门店 ID
merchant_id商户 ID
payee_bank_accountNUBAN 账户号
payee_bank_code银行代码
payee_account_name户名
payee_bvn核验用
account_verify_statusVERIFIED / FAILED / NOT_VERIFIED
store_review_status门店资质状态
contract_valid_until门店合作合同有效期
account_snapshot_version快照版本
snapshot_at快照时间

阻断规则:

场景处理
缺账户号阻断放款
缺银行代码阻断放款
缺户名阻断放款
账户核验失败阻断放款
门店未通过审核阻断放款
合同过期阻断放款

验收

  • SA / 门店 / 商家 / SKU 数据可人工导入并查询。
  • 办单资质校验:SA / 门店 资质不全 / 合同过期 → 拒绝办单。
  • PocketBuy SA 可选品出分期方案;可扫 IMEI 反查带出机型加速录单;进件携带渠道商品信息。
  • 交机时可通过 IMEI 反查品牌/型号,并与进件商品快照一致;不一致时不能完成交机。
  • 支付域可按 store_id 取到商户收款账户,完成放款到商户。