成本口径
理解日期、产品范围、四项成本以及缺失值。
销售月份范围
API 的四项成本都按销售月归集，不按到货月、账单月或单日查询。
month_from 和 month_to 都请使用月初 YYYY-MM-01。首尾月份均包含，month_to 不能早于 month_from，单次请求包含首尾在内最多覆盖 24 个月。
例如，查询 2026 年 7 月请使用 month_from=2026-07-01&month_to=2026-07-01。不建议使用月中日期作为输入。
产品范围
| 值 | 含义 |
|---|---|
normal |
仅正常产品，默认值。 |
sample |
仅样品。 |
all |
正常产品与样品合并。 |
成本字段
| 字段 | 产品利润页面口径 |
|---|---|
purchase_cost_usd |
页面 Landing 拆分可用时的采购成本。 |
inbound_freight_usd |
同一 Landing 拆分中的头程成本。 |
shipping_to_customer_usd |
存在已核算行时的尾程成本合计。 |
warehouse_fees_usd |
存在已核算行时的仓库费用合计。 |
四个金额都是所选范围内的 USD 合计。
数据时效
数据在最近一次成功的夜间 T+1 批次完成后可用，完成时间可能变化，不承诺固定时刻。回补或更正可能更新历史销售月份。
null 与 0
null表示按产品利润页面当前覆盖规则无法核算该项成本。0表示已经核算，结果确实为零。
不要把 null 转成零，它们代表不同的业务状态。
未映射的来源行仍会保留，其产品 ID 和 SKU 可以为 null；调用方不应静默丢弃这些行。