KPI 实时值说明

KPI 卡片上的数字是怎么实时算出来的：实时值引擎、15 分钟缓存、25 个有真实值的 KPI（及口径），以及 25 个显示"暂不提供"的原因。

KPI 卡片上的数字由 KPI 实时值引擎实时算出——是您真实的业务数据，不是演示数据。每个值都带口径说明（note）：数了什么、哪个时间段、来自哪个模块。凡是算不出来的，宁可显示"暂不提供"，也绝不编一个数字糊弄。

实时值是怎么算出来的#

引擎把每个 KPI 编码映射到真实的业务表（库位、订单、出库、发票……），只算您本租户的数据，结果缓存 15 分钟。窗口型 KPI 默认看最近 30 天；点值型 KPI（如库容利用率、应收逾期）是"此刻快照"。同比有就给：窗口型 KPI 会附带上一个等长周期的值（prev_value），没有就省略。

25 个有实时值的 KPI（口径一览）#

• 库容利用率：有库存的库位 ÷ 启用的库位。
• 入库上架时长：收货单完成 − 到货，小时（proxy：用收货单时间戳）。
• 订单履约率：已履约 ÷（总订单 − 取消）。
• 订单周期：下单 → delivered 事件，小时。
• 短发率：有短缺行的发货单 ÷ 发货单。
• 取消率：取消 ÷ 总订单。
• 客单价：订单金额合计 ÷ 订单数。
• 准时交付率：准时的 POD ÷ 有承诺日期的交付。
• 单票成本：运输成本合计 ÷ 运单数。
• 大门周转时长：出门 − 进门，分钟。
• 场内停留：出门 − 进门，小时。
• 退货率：退货单 ÷ 发货单。
• 头号退货原因占比：第一大原因 ÷ 有原因的退货。
• 翻新再售率：restock 处置的行 ÷ 退货行。
• 退货处理周期：RMA 创建 → 处置，天（proxy：用创建时间）。
• 站点密度：停靠点 ÷ 线路数。
• 采购周期：下单 → 收货，天。
• 供应商准时足量率：准时且足量的 PO ÷ 已收货 PO。
• 应收周转天数：应收余额 ÷ 日均开票 × 天数。
• 应付周转天数：应付余额 ÷ 日均账单 × 天数。
• 应收逾期占比：逾期应收 ÷ 应收总额。
• 平均商机金额：商机金额合计 ÷ 商机数。
• 油耗：里程（里程表差）÷ 加油量。
• 流程成功率：成功运行 ÷ 总运行。
• SLA 达标率：SLA 内解决 ÷ 已解决工单。

25 个暂无实时值的 KPI（缺数据源）#

这些不是引擎 bug——是底层数据从来没记录过，或者字段全空。数据补齐后自动转正，不用改代码。

• 库存周转率：无成本数据（无成本字段、无 COGS 分录）。
• 拣选准确率：拣选差错从未记录。
• 准时发货率：没有任何承诺时间。
• 收货效率：无有效收货工时。
• 订单准确率：无发货差错记录。
• 完美订单率：破损/单证维度无数据。
• 准时足量率：足量无数据（无交付件数）。
• 一次妥投率：无妥投记录。
• 每英里成本：无里程数据。
• 空驶率：无空驶里程数据。
• 月台利用率：无月台占用时间记录。
• 柜租/滞港费：无费用数据。
• 港口周转时长：提柜/还柜时间全空。
• 单站成本：线路无成本字段。
• 签收准时率：无承诺/窗口时间。
• 采购价差：无标准价。
• 供应商记分卡：质量维度无数据。
• 现金周期：需 COGS/库存天数，无成本数据。
• 分客户毛利：无直接成本数据。
• 线索转化率：无转化记录。
• 赢单率：无已关闭商机。
• 销售周期：无赢单。
• 人均产出：无有效工时。
• 加班占比：无加班工时字段。
• 车辆利用率：调度记录为空。

同比怎么看#

窗口型 KPI 会返回 prev_value——上一个等长周期的同一指标（比如再往前 30 天）。点值型 KPI（库容利用率、DSO、DPO、逾期占比）没有"上一周期"，直接省略。样本小会看得见：sample_size 告诉您这个数字基于多少条记录。