> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.boxhero.io/docs/documentation/zh/qi-ta-gong-neng/analytics.md).

# 库存报告

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

<figure><img src="https://688782006-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-ddbbbff7339c6b8d9b396c551f5d467a89563617%2F%E1%84%8C%E1%85%A2%E1%84%80%E1%85%A9%20%E1%84%87%E1%85%AE%E1%86%AB%E1%84%89%E1%85%A5%E1%86%A8%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

***

## 库存报表概览

在侧边栏中，前往 <mark style="color:$primary;">`报表`</mark> > <mark style="color:$primary;">`库存`</mark>.

你可以调整公式设置来分析你的库存数据，按地点或日期范围筛选结果，并将报表导出到 Excel 以便记录和分析。

<figure><img src="https://688782006-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2F8VpQzrhWgL3KDApwmKaQ%2Freport-inventory.jpg?alt=media&amp;token=d1620085-55c3-426c-a0ec-fc1afc86ea90" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**库存报表使用每个商品的&#x20;*****当前*****&#x20;成本和价格**，而不是交易发生时的数值。如果你更改了商品价格，过去的报表将使用新价格重新计算。若要获得某一时间点的准确数据，请使用 <mark style="color:蓝色;">`采购与销售`</mark> 或定期导出。
{% endhint %}

## 添加公式

要添加公式，请点击 <mark style="color:$primary;">`公式设置`</mark> > <mark style="color:$primary;">`添加公式`</mark>。你有两个选项：

* **快速添加** — 从适用于利润、周转等常见指标的现成公式中选择。无需设置。
* **自定义公式** — 使用 BoxHero 的变量和函数自行构建。可用于我们未提供的指标，或将你自己的商品属性与库存数据组合起来。

<figure><img src="https://688782006-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FbDVRAVhl4IUFajnV5MIz%2Freport-add%20formula%20options.jpg?alt=media&amp;token=2704f812-5468-4bf1-918b-6e4122029ef0" alt=""><figcaption></figcaption></figure>

### A. 快速添加

添加一个现成公式，立即开始报表分析。

<figure><img src="https://688782006-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FYgkfDP44NTxrimkrfD93%2Fframeit_2026-07-15T00-00-56.jpg?alt=media&amp;token=c558728b-b62c-48b1-97c6-bbd650f80b38" alt=""><figcaption></figcaption></figure>

#### 商品属性

你可以使用 [属性](/docs/documentation/zh/gai-nian/attributes.md) 与数值一起创建公式。

#### 销售与利润

* **总成本**：成本 × 总入库数量
* **总收入**：价格 × 总出库数量
* **净利润**：价格 - 成本
* **毛利润**：（价格 - 成本）× 总出库数量
  * *所选期间内售出全部商品的总利润。*
* **利润率（%）**：（价格 - 成本）÷ 价格
  * *价格中有多少比例是利润。*
* **平均每日收入**：（价格 × 总出库数量）÷ 天数
* **平均每日毛利润**：（价格 - 成本）× 总出库数量 ÷ 天数

#### **库存与流动**

* **库存价值**：成本 × 当前数量
* **库存周转率**：总出库数量 ÷ 平均数量
  * *你的平均库存被售完了多少次。数值越高，表示库存流转越快。*
* **平均每日入库**：总入库数量 ÷ 天数
* **平均每日出库**：总出库数量 ÷ 天数
* **剩余库存天数**：当前数量 ÷（总出库数量 ÷ 天数）
  * *按当前速度，多久会耗尽。可用于安排补货时机。*

### B. 自定义公式

使用 BoxHero 的变量和函数自行构建公式。

<figure><img src="https://688782006-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FFjSgJHwjFvzeVynbOmNZ%2Freport-formula%20settings.jpg?alt=media&amp;token=24dbf068-a033-405b-8402-83cbcc7c3bec" alt=""><figcaption></figcaption></figure>

#### 变量自动补全

输入 `$` 可访问库存变量，并 `{{` 以检索已保存的属性/数值。

<figure><img src="https://688782006-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FqfJzuQNgnXEQugUDYGCV%2Fcustom%20formula-autocomplete.jpg?alt=media&amp;token=60681cd2-66af-4faf-8e3f-e00b7b3d7a51" alt=""><figcaption></figcaption></figure>

<table data-search="false"><thead><tr><th width="209">变量名称</th><th>说明</th></tr></thead><tbody><tr><td><strong>当前数量</strong></td><td>商品的当前库存水平。</td></tr><tr><td><strong>天数</strong></td><td>所选期间的天数。</td></tr><tr><td><strong>平均数量</strong></td><td>所选期间的平均库存，按每天 23:59:59 的库存数量计算。</td></tr><tr><td><strong>期初数量</strong></td><td>所选期间开始时的库存（开始日期前一天 <em>的</em> 23:59:59）。</td></tr><tr><td><strong>期末数量</strong></td><td>所选期间结束时的库存（期间 <em>最后一天</em> 的 23:59:59）。</td></tr><tr><td><strong>总入库数量</strong></td><td>总入库量。</td></tr><tr><td><strong>入库次数</strong></td><td>在 <strong>入库</strong> <strong>进行</strong> 所选期间内的交易次数。</td></tr><tr><td><strong>总出库数量</strong></td><td>总出库量。</td></tr><tr><td><strong>出库次数</strong></td><td>在 <strong>入库</strong> <strong>出</strong> 所选期间内的交易次数。</td></tr><tr><td><strong>加权平均出库量（线性 2、3、4）</strong></td><td><p>按最近日期权重更高计算的平均每日出库量。所选期间中的每一天都会获得一个线性递增的权重，最早的一天权重始终为 1。该数值设置最近一天的权重——2、3 或 4——数字越大，平均值对近期活动越敏感。</p><ul><li><strong>线性 2</strong>：最早的一天权重为 1，最近的一天权重为 2</li><li><strong>线性 3</strong>：最早的一天权重为 1，最近的一天权重为 3</li><li><strong>线性 4</strong>：最早的一天权重为 1，最近的一天权重为 4</li></ul></td></tr><tr><td><strong>调整数量（增加）</strong></td><td>由 <strong>调整库存</strong> 交易增加的数量。</td></tr><tr><td><strong>调整数量（减少）</strong></td><td>由 <strong>调整库存</strong> 交易增加的数量。</td></tr><tr><td><strong>调整数量（净值）</strong></td><td>调整数量（增加） − 调整数量（减少）。</td></tr><tr><td><strong>调整次数</strong></td><td>在特定期间内， <strong>调整</strong> 交易发生的次数。</td></tr><tr><td><strong>移动数量（入）</strong></td><td>移动的数量 <em>到</em> 所选地点，由 <strong>调拨库存</strong> 交易增加的数量。</td></tr><tr><td><strong>移动数量（出）</strong></td><td>移动的数量 <em>从</em> 所选地点，由 <strong>调拨库存</strong> 交易增加的数量。</td></tr><tr><td><strong>移动数量（净值）</strong></td><td>移动数量（入） − 移动数量（出）。</td></tr><tr><td><strong>移动次数（入）</strong></td><td>在 <strong>调拨库存</strong> 使所选地点库存增加的交易。</td></tr><tr><td><strong>移动次数（出）</strong></td><td>在 <strong>调拨库存</strong> 使所选地点库存减少的交易。</td></tr></tbody></table>

#### 可用函数

BoxHero 支持多种函数，类似于它们在 Excel 中的对应功能。

<figure><img src="https://688782006-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FpfVugON6ys4TRDkaWvMV%2Fcustom%20formula-functions.jpg?alt=media&amp;token=b96457f9-561a-4e3b-a7e8-3ad5f7c498b2" alt=""><figcaption></figcaption></figure>

* **基本运算：** `+`, `-`, `*`, `/`
* **条件**: `if(条件, 条件为真时的值, 条件为假时的值)`
  * 判断一个条件，并在条件为真时返回一个值，为假时返回另一个值。
* **四舍五入：**
  * **round**: `round(数字, 位数)`
  * **roundUp**: `roundUp(数字, 位数)`
  * **roundDown**: `roundDown(数字, 位数)`
* **类型转换：**
  * **toNumber**: `toNumber(字符串, 回退值)`
    * 将文本转换为数字，若转换失败则返回回退值。
  * **toString**: `toString(数字)`
    * 将数字转换为文本。

<figure><img src="https://688782006-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FVyBJAJ0MT0De3Y0tqCIA%2Fcustom%20formula-examples.jpg?alt=media&amp;token=69c49349-7827-4f20-85e0-228819f82b03" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**还需要别的吗？** <mark style="color:$primary;">`自定义分析`</mark> 可让你通过 SQL 直接查询库存数据。可用于不适合按商品公式的问题。
{% endhint %}

***

## 常见问题

**想了解更多信息？** 浏览我们的常见问题：

{% content-ref url="/spaces/1XHeAQmLMHSILvJsICC2/pages/09711a2dd20371af45d2338abeec7519509cff49" %}
[库存报表](/docs/faq/zh/bao-biao/inventory-reports.md)
{% endcontent-ref %}