> **前置条件** — 执行前请先确认已完成认证（参见 [`../../shb-shared/SKILL.md`](../../shb-shared/SKILL.md)）。输出措辞禁令、id 复用规则、传参优先级见本 skill 的 [`SKILL.md`](../SKILL.md)。

# shb-cli warehouse material detail（物料详情查询）

查看单个云仓物料的详情。列表搜索见 [`shb-warehouse-material-search.md`](shb-warehouse-material-search.md)。

## 用法

```bash
shb-cli warehouse material detail --id <物料id>

# 格式化输出，可用 --fields 指定字段
shb-cli warehouse material detail --id <物料id> --format-data --fields sn,name,property,unit,salePrice
```

- `--id` 必填，是物料的 `id`（**整数**）——来源约束见 SKILL.md「复用已知 ID」节；手头没有可信的 `id` 时，先按 [`shb-warehouse-material-search.md`](shb-warehouse-material-search.md) 用编号/名称搜到该物料再取 `id`。
- 支持 `--format-data --fields <字段列表>`，不传 `--fields` 时默认输出全部已知字段。字段中文名、价格/启用状态的格式化行为、响应信封说明与列表一致，见 [`shb-warehouse-material-search.md`](shb-warehouse-material-search.md) 的「--format-data 输出结构速查」。

## 典型组合场景

### 查某个物料的详情

```bash
# 1. 搜到物料，拿到 id
shb-cli warehouse material search --keyword "螺丝" --format-data --fields sn,id,name

# 2. 查该物料详情
shb-cli warehouse material detail --id <id>
```