> 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><p></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(condition, true 时的值, false 时的值)`
  * 判断一个条件，若为真返回一个值，若为假返回另一个值。
* **四舍五入：**
  * **round**: `round(number, digit)`
  * **roundUp**: `roundUp(number, digit)`
  * **roundDown**: `roundDown(number, digit)`
* **类型转换：**
  * **toNumber**: `toNumber(string, fallback value)`
    * 将文本转换为数字，若转换失败则返回回退值。
  * **toString**: `toString(number)`
    * 将数字转换为文本。

<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/ku-cun-bao-biao.md)
{% endcontent-ref %}
