# 畅捷通好业财（Z+）对接说明 · 原型备注

第三方文档：[好业财 OpenAPI（zplus）](https://open.chanjet.com/docs/file/apiFile/zplus)

会议主题：系统对接与库存同步方案研讨  
发言：煤球的御用营养师、何雪斌、璐璐  

本期原型落地范围以会议结论为准；界面无法单独成页的约定写在对应页脚注或本文件。后续开发以确认后的原型图为准。

## 本期做

| 能力 | 约定 | 原型入口 |
|------|------|----------|
| 商品主数据 | 读物料池；**物料编码**唯一键；只记售卖主单位（盒等），不做辅计量换算 | [`admin/goods-sync.html`](../admin/goods-sync.html)、[`goods-edit.html`](../admin/goods-edit.html) |
| 现存量同步 | **源字段 = 基础档案/物料「现存量」**；仅同步该总数量；每日凌晨全量 + **手动全量**；变动源头为进货/退货单（单据不同步到本平台）；平台只读展示，发货时再按批次核销 | `goods-sync`、「同步现存量」；商品列表/编辑列「现存量」 |
| 发货核销 | 后台发货时读批次并扣减；**先核销后出库**；可多批次且数量之和=订购量；不足拦截；**暂不支持部分发货** | [`order-list`](../admin/order-list.html) / [`order-detail`](../admin/order-detail.html) 发货弹窗 |
| 条码溯源 | 发货条码从物料信息自动带出，不选手输 | 发货弹窗「条形码（自动）」；商品编辑条码只读 |
| 机构别名 | 审核通过时命名；用于后台/顾客；基础信息示意同步好业财 | [`org-list.html`](../admin/org-list.html) 审核弹窗 |

## 本期不做 / 待确认

| 事项 | 负责人 | 说明 |
|------|--------|------|
| 退货批次回退与线上退货渠道 | 何雪斌 | 批次不符易乱账；方案待确认，线上可能暂不开放 |
| 机构别名写入好业财基础信息接口是否存在 | 何雪斌 | 多半落在「往来单位」档案；待确认字段 |
| 会员、门店 ID、往来单位等档案同步 | — | 关联多，**下期** |
| 原型补充备注与确认 | 璐璐 | 无法上图的能力用文字备注（本文件 + 同步页） |
| 原型确认后后端开发 | 煤球的御用营养师 | 以确认后原型为准 |

## 相关好业财能力（文档目录）

对接实现时优先查阅 OpenAPI 中：

- **基础档案**：商品、计量单位、往来单位、仓库、会员…
- **库存管理**：销售出库单、采购入库单、其他出入库、盘点单…
- **采购管理**：进货单、采购订单…
- **销售管理**：销货单、销售订单…
- **消息订阅**：进货单 / 销货单 / 销售出库单等（可用于库存变动感知；本期仍以定时+手动全量为主）

## 同步 vs 用户端展示（物料 → 商品）

物料进平台商品是「关联映射 + 必要字段」，不是整包上架。

| 物料字段 | 进后台商品 | 采购端货架展示 |
|----------|------------|----------------|
| 物料编码 | 是（唯一键，只读） | 否 |
| 物料名称 / 规格型号 | 是（映射为品名、规格） | 是 |
| 条形码 | 是（只读，发货带出） | 否 |
| 主计量单位 | 是 | 是（如「盒」） |
| **现存量** | 是（只读同步） | **否** |
| 1–7 级批发价等 | 否（不映射） | 否 |
| 库存上下限 / 参考成本等 | 否 | 否 |
| 平台售价 1–4 | 后台维护 | 认证通过后按等级取档；未认证「认证可见」（见 MEMBER_PRICE.md） |

## 无法单独成页的约定（给开发）

1. 定时任务：每日凌晨全量同步物料 **现存量**；界面只展示「上次同步时间」与「手动全量同步现存量」。
2. 不同步进货单 / 退货单明细到本平台，仅同步现存量；发货时再读批次做核销。
3. 屏蔽辅计量单位换算，入库与出库统一主单位。
4. 部分发货本期不做；拆单与批次同步复杂度高，后续版本再评估。
5. 物料侧另有 1–7 级批发价等价格列；本平台结算价仍用后台 **售价 1–4（入驻等级）**，不直接映射批发价档。
6. 发货核销：本批数量大于所选批次「余量」时拦截，不启用确认发货（见订单发货弹窗演示）。