---
title: 成本口径
description: 理解日期、产品范围、四项成本以及缺失值。
sidebar:
  order: 4
---

## 日期范围

`month_from` 和 `month_to` 都是包含边界的 ISO 日期，且 `month_to` 不能早于 `month_from`。

## 产品范围

| 值 | 含义 |
| --- | --- |
| `normal` | 仅正常产品，默认值。 |
| `sample` | 仅样品。 |
| `all` | 正常产品与样品合并。 |

## 成本字段

| 字段 | 产品利润页面口径 |
| --- | --- |
| `purchase_cost_usd` | 页面 Landing 拆分可用时的采购成本。 |
| `inbound_freight_usd` | 同一 Landing 拆分中的头程成本。 |
| `shipping_to_customer_usd` | 存在已核算行时的尾程成本合计。 |
| `warehouse_fees_usd` | 存在已核算行时的仓库费用合计。 |

四个金额都是所选范围内的 USD 合计。

## `null` 与 `0`

- `null` 表示按产品利润页面当前覆盖规则无法核算该项成本。
- `0` 表示已经核算，结果确实为零。

不要把 `null` 转成零，它们代表不同的业务状态。

未映射的来源行仍会保留，其产品 ID 和 SKU 可以为 `null`；调用方不应静默丢弃这些行。