docs(self-operated): align turnover eligibility and explicit zero stock

2026-10-14 14:00:38 +08:00
parent 62de8d1407
commit 34c65c8c7c
2 changed files with 13 additions and 6 deletions
@@ -169,6 +169,8 @@ OMP 的 `customerCode` 是外部货主编码，必须保存，不创建虚构客
 | 可售数量 | 自营授权货主、指定仓库、正品 `productQuality=0` 的 `useStkQty`；不再次扣减冻结量，也不使用实物量自行推算 |
 | 单独留存 | `freezeQty`、`transitQty`，账号、货主、仓库、品质、同步批次、观测时间及质量标记 |

+正品可售的明确零值例外：在已发布的完整库存批次中，同一货主＋SKU只有次品行，且这些行均为VALID、实物／可用／冻结均明确为0时，正品可售聚合为0。存在正品行但其可用量缺失、缺行占位、异常品质、数量未知或非零时不适用；库存单位与时效校验仍生效。经营总览、库存明细及库存周转共用此规则，不改写来源快照。
+
 库存保存产品库存接口全部品质的记录，只将正品可用库存纳入可售量，不将次品或在途混入。代理仓响应中的 `stockCompare` 是对照信息，不与本条库存再次累加。库存读取来自从库，有秒级同步延迟；库存组成、零值和空值的实际语义仍需页面对账。数量使用十进制类型保留源精度，列表 `qty` 的类型与描述存在差异，不应直接整数截断。金额、收件人、电话和地址不属于本期统计所需字段。

 OMP 请求使用 `appKey`、秒级 `timestamp`、`sign` 及业务 `data`，签名按照 [OMP 官方加签说明](https://apidoc-omp.xlwms.com/docs/%E5%BC%80%E5%8F%91%E9%AA%8C%E7%AD%BE%E5%B7%A5%E5%85%B7.md)验证固定测试向量与参数序列化。密钥与签名不写日志、不提交源码；请求时钟同步、配额、并发和超时均由适配器管理。
@@ -743,6 +745,8 @@ SKU 每日出库销量

 实物量为同 SKU 全部已核验品质的 `physical_quantity` 之和；冻结量按各品质 `frozen_quantity` 独立汇总，是实物中的受限数量，不再加到实物总量；次品实物也是实物的一部分。可售量只取正品 `available_quantity`；在途单列，不视为当前占仓。未知品质可保留来源实物，但不推断它是正品或次品。任何数量缺失或异常均按其指标依赖传播，不能把一个数值有效误当该 SKU 所有指标均有效。实物件数仅表示数量，不表示立方米、托盘或库位占用。

+完整发布的库存快照中，若某 SKU 仅有品质为次品、质量状态有效且实物／可用／冻结均明确为零的记录，可售量确认为零；不得仅因没有正品行而使全仓可售总量未知。存在正品行但字段缺失或异常、未知品质、缺整个 SKU 的库存行、库存过期或单位不明时，继续按未知处理。该规则同时适用于库存明细、经营总览和库存周转，不把一般的来源缺行统一补零。
+
 关注条件使用下列明确语义；所需库存必须有效且不过期，销售资格沿用所选完整可信窗口及有效数量单位（经营总览及严格下钻的窗口以[经营总览图表设计](经营总览图表设计.md)为准）。标签可并存，不将冻结／次品与其他标签的命中数简单相加：

 | `attention` | 判定及输出 |