> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Every page is available as Markdown by appending `.md` to its URL; this page is [Markdown](https://www.boxhero.io/docs/zh-cn/other-features/analytics.md).

# 库存报告

> BoxHero 的库存报告功能可帮助您根据库存和销售数据生成自定义报告。您可以创建个性化的计算公式， 并跟踪对您最重要的关键指标。

![](https://assets.boxhero.io/docs/images/2bc5535f1c8c4c2935cce50d6e04fad600c0e0ffd515f1c97e9ebf840bc68928-1600x940.png)

---

## 库存报告概览

在侧边栏中，前往 `报告` > `库存`。

您可以调整公式设置来分析库存数据，按位置或日期范围筛选结果，并将报告导出到 Excel，用于记录和分析。

![](https://assets.boxhero.io/docs/images/8cde484015b0cc25c53525fece316e339b3ed508e864a7295fdbc47f6bc4ca26-2800x1531.jpg)

> **Caution**
>
> **库存报告使用的是每个商品的** **_当前_** **成本和价格**，而不是交易发生时的数值。如果您更改了商品的价格，过去的报告将按新价格重新计算。如需获得特定时间点的准确数据，请使用 `采购与销售` 或定期导出。

## 添加公式

要添加公式，请点击 `公式设置` > `添加公式`。您将看到两个选项：

- **快速添加** — 从现成的公式中选择常用指标，如利润、周转率等。无需任何设置。
- **自定义公式** — 使用 BoxHero 的变量和函数创建您自己的公式。适用于我们未提供的指标，或将您自己的商品属性与库存数据结合使用。

![](https://assets.boxhero.io/docs/images/14a58737c489ee3a57865bbf0cf59535d31b77a707c9754f25221bb75e6dc70f-2494x1169.jpg)

### A. 快速添加

添加现成的公式，立即开始生成报告。

![](https://assets.boxhero.io/docs/images/b446bea8b2f3b3f1e632ba9d2d3c33b5236ddfd538c33ed0be5adba444bec6c0-2360x1525.jpg)

#### 属性

您可以使用数值类型的商品[属性](https://www.boxhero.io/docs/zh-cn/concepts/attributes)来创建公式。

#### 销售与利润

- **成本**：在商品详情中设置的成本。

- **价格**：在商品详情中设置的销售价格。

- **总成本**：成本 x 总入库量

  - _所选期间内所有入库库存的总成本。_

- **销售额**：价格 x 总出库量

  - _所选期间内所有出库库存的总销售额。_

- **净利润**：价格 - 成本

  - _单件商品的利润。_

- **毛利润**：(价格 - 成本) x 总出库量

  - _所选期间内所有已售商品的总利润。_

- **利润率 %**：(价格 - 成本) ÷ 价格

  - _销售价格中利润所占的百分比。_

- **日均销售额**：(价格 x 总出库量) ÷ 期间天数

- **日均利润**：(价格 - 成本) x 总出库量 ÷ 期间天数

#### 库存与流动

- **当前库存**：您目前现有的数量。

- **平均库存**：所选期间内您现有的平均数量。

- **库存价值**：成本 x 当前库存

  - _您目前现有库存的总价值。_

- **周转率**：总出库量 ÷ 平均库存

  - _所选期间内您售完平均库存的次数。数值越高，表示库存流动越快。_

- **总入库量**：所选期间内入库的总数量。

- **日均入库量**：总入库量 ÷ 天数

- **总出库量**：所选期间内出库的总数量。

- **日均出库量**：总出库量 ÷ 天数

- **调整数量（净值）：** 所选期间内调整_增加_的数量减去调整_减少_的数量。

- **移动数量（净值）：** 所选期间内_移入_的数量减去_移出_的总数量。

- **库存可用天数**：当前库存 ÷ (总出库量 ÷ 天数)

  - _根据日均出库量，当前库存可以维持的天数。可用于把握补货时机。_

### B. 自定义公式

使用 BoxHero 的变量和函数创建您自己的公式。

![](https://assets.boxhero.io/docs/images/6fa0f35998bd32ecdb5f1e8ff08c68bf6e3ced71a4a51c1870a4e0d610eb7cf6-2800x1359.jpg)

#### 自动补全变量

输入 `$` 可调用库存变量，输入 `{{` 可调用已保存的属性/值。

![](https://assets.boxhero.io/docs/images/cad03ae9e65cf4c581510336a489822b0798bf7d7ebe615d100735867a7719fe-2522x1577.jpg)

| 变量名称 | 说明 |
| --- | --- |
| **当前库存** | 目前现有的数量。 |
| **期间天数** | 所选期间的天数。 |
| **平均库存** | 所选期间内的平均库存，按每天 23:59:59 时的数量计算。 |
| **期初库存** | 所选期间开始时的库存（开始日期_前一天_的 23:59:59）。 |
| **期末库存** | 所选期间结束时的库存（期间_最后一天_的 23:59:59）。 |
| **总入库量** | 所选期间内入库的总数量。 |
| **入库次数** | 所选期间内**入库交易**的次数。 |
| **总出库量** | 所选期间内出库的总数量。 |
| **出库次数** | 所选期间内**出库交易**的次数。 |
| **加权平均出库量（线性 2、3、4）** | 按权重计算的日均出库量，越近的日期权重越高。所选期间内的每一天都会获得一个线性递增的权重，最早的一天权重始终为 1。数字表示最近一天的权重（2、3 或 4），数字越大，平均值对近期变化的反应越灵敏。 - **线性 2**：最早一天的权重为 1，最近一天的权重为 2 - **线性 3**：最早一天的权重为 1，最近一天的权重为 3 - **线性 4**：最早一天的权重为 1，最近一天的权重为 4 |
| **调整数量（增加）** | 通过**调整**交易增加的数量。 |
| **调整数量（减少）** | 通过**调整**交易减少的数量。 |
| **调整数量（净值）** | 调整数量（增加）− 调整数量（减少）。 |
| **调整次数** | 所选期间内**调整**交易的次数。 |
| **移动数量（移入）** | 通过**移动**交易_移入_所选位置的数量。 |
| **移动数量（移出）** | 通过**移动**交易从所选位置_移出_的数量。 |
| **移动数量（净值）** | 移动数量（移入）− 移动数量（移出）。 |
| **移入次数** | 将库存_移入_所选位置的**移动**交易次数。 |
| **移出次数** | 将库存从所选位置_移出_的**移动**交易次数。 |

#### 可用函数

BoxHero 支持多种函数，用法与 Excel 中的对应函数类似。

![](https://assets.boxhero.io/docs/images/4cd15c65de2c4d78b66c8c5dcf72ab3dbb8c9e38d88eb58d04f76efc91d3eb16-2544x1578.jpg)

- **基本运算：** `+`, `-`, `*`, `/`

- **条件**：`if(condition, value if true, value if false)`

  - 判断条件，条件为真时返回一个值，为假时返回另一个值。

- **四舍五入：**

  - **round**：`round(要四舍五入的值, 四舍五入的位数)`
  - **roundUp**：`roundUp(要向上取整的值, 四舍五入的位数)`
  - **roundDown**：`roundDown(要向下取整的数字, 四舍五入的位数)`

- **类型转换：**

  - **toNumber**：`toNumber(string, fallback value)`

    - 将文本转换为数字，转换失败时返回备用值。

  - **toString**：`toString(要转换为文本的数字值)`

    - 将数字转换为文本。

![](https://assets.boxhero.io/docs/images/4982ce81313262b0a38af6f60e07e2f1f2cd6dd5a07ec2352073d6185ee9009a-2544x1572.jpg)

> **Tip**
>
> **需要其他功能？** `自定义报表` 可让您直接使用 SQL 查询库存数据。适用于无法用单个商品公式解决的问题。

---

## 常见问题

**需要更多信息？** 请浏览我们的常见问题：

- [库存报告](https://www.boxhero.io/docs/zh-cn/faq/reporting/inventory-reports)
