39 v1 merchant manual

SmartFarm V1 商户供货与货款操作手册

状态：设计态操作手册，功能尚未开发和发布

本文档依据 V1 已确认规则、页面和接口契约编写。页面编号用于设计、开发与验收追踪；农业和云仓功能正式发布后，本文才可升级为现网使用说明。

商户在 SmartFarm V1 中是商品和供应链参与方。商户维护自己的商品、申请云仓供货、履行责任快照分配的邮寄/售后任务并取得供货货款；用户租地、认养、云仓持仓和用户收益不属于商户操作范围。

一、商户角色

角色	可以做	不能做
商户管理员	商品资料、供货申请、员工权限、履约、货款和异议	查看其他商户、修改平台活动规则或用户账本
商品运营	商品和农业资料、供货草稿	审核供货、入账或最终售后
仓储/履约	发运、邮寄、物流、退回验收和证据	云仓自提核销、结算规则和回购
财务/对账	货款、结单、正式入账和异议	修改供货数量、用户余额或原成功流水
客服	查询本商户任务、联系记录和异常上报	最终库存、金额和异常方案决定

所有列表、详情和导出只返回当前商户数据。员工即使知道其他商户业务 ID，也应得到“未找到”。

二、智慧经营工作台

页面：MER-HM-001。

工作台只聚合当前账号有权处理的：

• 商品农业资料待补充/待审核。
• 供货草稿、驳回、待发运、待补证据和退回待办。
• 责任快照归本商户的邮寄、质量和售后任务。
• 可入结单、结单待入账、对账差异和异议结果。

建议每日顺序：

1. 先处理即将超期的履约和售后。
2. 再处理供货审核意见、发运和退回。
3. 核对新增可结算货款和日结单。
4. 对有差异的未入账记录提交异议。
5. 记录未完成事项并交班。

工作台金额是汇总投影，最终以货款明细、结单和 CRMEB 资金流水为准。

三、商品农业资料

页面：MER-CM-001/002。

1. 维护内容

• 农产品来源和产地。
• 供应批次或生产说明。
• 报告、证书和品牌/供货材料。
• 已发布溯源档案引用。
• 云仓供货资格状态和历史告警。

2. 操作流程

1. 从商品列表选择本商户商品和具体 SKU。
2. 补充农业资料并引用已上传材料。
3. 保存草稿，检查缺失项和到期时间。
4. 提交审核。
5. 审核驳回时按结构化原因建立新版本，不覆盖历史审核记录。

商品资料审核通过不等于供货申请批准；也不会预留商品库存。

常见阻断：

• 商品/SKU 已下架或删除。
• 材料过期、未审核或不适用于当前 SKU。
• 产地/供应来源缺失。
• 当前员工没有商品或提交权限。

四、云仓供货申请

页面：MER-CW-001/002。

1. 一张申请只绑定一个来源 SKU

批量选择多个 SKU 时，系统应建立多张独立草稿。这样每张申请都有唯一的来源、供货价、数量、责任和库存流水。

2. 编辑字段

• 来源商品和 SKU。
• 拟供数量。
• 建议供货价。
• 预计发运时间和交付方式。
• 邮寄责任方建议。
• 质量责任方建议。
• 首次售后责任方建议。
• 商品、包装、质检和供货材料。
• 备注。

商户提交的是建议。平台审核确认后形成责任和供货价快照。

3. 库存影响

阶段	来源库存
保存草稿	不变
提交审核	不变
平台驳回	不变
平台批准	预留批准数量
发运	保持预留并记录在途
平台验收合格	转入云仓供货库存
短缺/拒收	按实际实物状态释放或退回

提交时看到库存充足不代表审核时一定可预留。平台审核会锁定并重新校验来源库存。

五、发运、收货与质检

页面：MER-CW-003/004。

1. 发运

前置条件：申请已批准，存在可发运批准量，当前商户有发运权限。

操作：

1. 选择本次发运数量。
2. 填写承运商、运单、发运时间和包装信息。
3. 上传交接证据。
4. 查看提交摘要后确认。

发运后不能覆盖原数量或运单事实。需要更正时新增更正记录或异常，不直接改历史。

2. 平台收货和质检结果

商户详情应分别展示：

• 应收、实收和短少。
• 待检数量。
• 验收合格数量。
• 拒收数量和原因。
• 云仓可用数量。
• 活动占用数量。
• 退回待办、已退回或平台承接数量。

数量总览必须能下钻到流水。若平台记录与实物不一致，商户提交证据和异议，不通过反复发运或改商品库存处理。

六、供货数量生命周期

拟供
→ 批准预留
→ 发运
→ 平台收货
→ 待检
→ 合格/拒收/短缺
→ 云仓可用
→ 活动占用
→ 有效首次购买
→ 活动未抢退回或平台承接

活动未抢完时：

• 平台可直接释放的数量回到来源库存。
• 商户实物仍在平台仓时先显示 退回待办。
• 完成实物退回或等价移交后才恢复商户来源可售库存。

不得只看到活动结束就手工增加商品库存。

七、责任快照下的履约与售后

页面：MER-CW-005。

只展示平台审核时确认由当前商户承担的任务：

• 云仓邮寄发货。
• 物流信息和更正。
• 包装/质量证据。
• 退回实物验收。
• 首次售后协同。
• 无法履约、短缺或质量异常上报。

商户不执行云仓自提核销。自提由平台或有核销权限的服务/仓储人员处理。

操作步骤

1. 打开任务并核对责任类型、商品、数量、用户脱敏信息、截止和 allowed_actions。
2. 发货前确认地址版本、库存、包裹和运费状态。
3. 提交承运商、运单和证据。
4. 售后/退回时查看平台确认的责任与数量。
5. 实物退回后记录实收、合格/损坏和证据。
6. 无法执行时提交异常，不虚构发货或验收。

常见阻断：

• 责任不归当前商户。
• 任务已被平台接管。
• 地址无查看权限。
• 数量、包裹或版本已变化。
• 退款/争议冻结。
• 物流信息已锁定。
• 临时附件已过期或未绑定。

八、云仓供货货款

页面：MER-FN-001。

1. 结算口径

云仓供货使用审核快照中的固定供货价：

基础货款 = 合格有效首次购买数量 × 固定供货价
应结货款 = 基础货款 - 责任快照确认的退款/售后调整

不使用用户抢购价、二次零售市场价或普通商品成交价扣佣模式计算云仓供货货款。

2. 数量取得资格的条件

每一部分数量需要同时满足：

1. 平台验收合格。
2. 用户首次购买已完成：
   • 邮寄：确认/自动收货。
   • 云仓自提：对应数量完成核销或异常闭合。
   • 代销：对应持仓进入正式批次。
3. 首次售后观察期结束。
4. 没有退款、争议或冻结。

二次代销何时售完不改变已满足条件的商户固定供货货款。

3. 页面字段

• 供货申请、活动和商品/SKU。
• 合格数量、有效首次购买数量和退款量。
• 固定供货价。
• 首次完成、观察期结束和资格时间。
• 待条件、可入单、已入单、冻结、已入账、调整。
• 关联日结单、正式入账时间和 CRMEB 财务流水。

九、日结单与正式入账

页面：MER-FN-002。

平台每日 02:00 按自然日归集合格货款生成不可变结单。

状态解释：

状态	含义
待条件	尚未满足验收、首次完成或观察期
可入单	可进入下一次日结
已入单	已属于某张结单，明细不再修改
入账中	正在映射 CRMEB 商户账户
已入账	已产生正式资金流水并进入可用余额
冻结/争议	暂不执行，等待复核
调整/冲正	通过新记录处理历史差异

“结单已生成”不等于“资金已到账”。只有正式入账成功、结单回写 posting_id 和 CRMEB 商户资金流水后，才计入可用余额。

十、对账与异议

1. 数量链

拟供
→ 批准预留
→ 发运
→ 收货
→ 质检
→ 活动占用
→ 有效首次购买
→ 退回/平台承接

2. 资金链

有效首次购买数量
× 固定供货价
→ 供货货款账本
→ 日结单
→ 正式入账
→ 商户可用余额和资金流水

3. 提交异议

前置条件：记录属于当前商户，且允许提交异议。

需要填写：

• 异议类型。
• 关联货款/结单。
• 商户认为正确的事实说明。
• 发运、交接、质检、退回或售后证据。
• 联系方式和备注。

未入账记录可以冻结等待复核。已入账差异通过独立调整或反向记录处理，原成功结单和资金流水不被覆盖。

十一、不可操作原因排查

按顺序检查：

1. 当前员工是否有页面和动作权限。
2. 商品、SKU 或材料是否有效。
3. 申请/任务是否属于当前商户。
4. 状态和版本是否已变化。
5. 供货量、发运量、验收量和剩余量是否闭合。
6. 责任快照是否把当前动作分配给商户。
7. 是否有退款、争议、冻结或平台接管。
8. 是否为异步结单/入账，需等待操作结果。

禁止：

• 直接修改商品库存“修复”云仓差异。
• 重复提交不同幂等请求尝试绕过状态。
• 把“已入单”解释为“已到账”。
• 在备注或截图中暴露用户完整地址、手机号或支付信息。

十二、客服协同前准备

• 供货申请号、发运/交接号和任务号。
• 商品和 SKU。
• 数量阶段及对应流水。
• 责任快照摘要。
• 结单号或货款编号。
• 异常/异议编号。
• 脱敏证据和发生时间。

客服可以协助解释和转交，不能直接修改货款、库存或平台审核结果。

十三、维护者追踪

流程	页面	API	测试
商品农业资料	MER-CM-001/002	farm/catalog/product_agriculture/*	CW-ACT-010~014、DB-REF-*
供货申请	MER-CW-001/002	商户 farm/cloud/supply/*	CW-SUP-001~015
供货详情	MER-CW-003/004	supply delivery/flow/detail	CW-SUP-*、CONC-002
履约售后	MER-CW-005	farm/cloud/fulfillment/*	CW-PICKUP-005、FUL-*、SEC-*
货款和结单	MER-FN-001/002	merchant ledger/statement API	MER-SET-001~014、CW-POST-*

页面字段和状态以 30 为准，写操作以 31 为准，错误码以 19 为准，测试以 22/43 为准。