stock-goodwill-impairment git:20260916.8724d04A

Immutable. This exact content is served forever at /api/v1/blob/115c88932919d3ff.

---
name: stock-goodwill-impairment
description: Get goodwill impairment detail (商誉减值明细) for all stocks in a specific year. Use when user asks about 商誉减值, 商誉减值损失, 商誉减值占净利润比例, goodwill impairment.
---

# 查询个股商誉减值明细

## 接口说明

| 项目 | 说明 |
|------|------|
| 接口名称 | 查询个股商誉减值明细 |
| 外部接口 | GET /api/v1/market/data/goodwill/stock-impairment |
| 请求方式 | GET |
| 适用场景 | 查询存在商誉减值的个股数据，包含减值金额、减值占净利润比例等字段 |

## 请求参数

说明：date 为必填项。

| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|--------|------|----------|------|----------|------|
| date | string | 是 | 报告期日期 | 20251231 | 格式 YYYYMMDD，按年份范围过滤，如 20251231 查询 2025 全年 |

## 执行方式

```bash
python scripts/handler.py --date 20251231
```

## 响应结构

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "pageNum": 1,
    "pageSize": 50,
    "total": 2676,
    "pages": 54,
    "records": [
      {
        "seq": 0,
        "security_code": "300860",
        "security_name": "锋尚文化",
        "goodwill_scale": "28235811.5900",
        "goodwill_change": null,
        "goodwill_to_net_assets_ratio": "0.00898123",
        "net_profit_scale": "-16592410.5300",
        "goodwill_impairment_to_net_profit": null,
        "notice_date": "2026-05-13 00:00:00",
        "trade_board": "cyb"
      }
    ]
  }
}
```

### 字段说明（GoodwillStockImpairmentItem）

| 字段名 | 类型 | 是否可为空 | 说明 |
|--------|------|------------|------|
| seq | int | 否 | 序号 |
| security_code | string | 否 | 证券代码 |
| security_name | string | 是 | 证券简称 |
| goodwill_scale | string | 是 | 商誉规模（元） |
| goodwill_change | string | 是 | 商誉变动额（元） |
| goodwill_to_net_assets_ratio | string | 是 | 商誉占净资产比例 |
| net_profit_scale | string | 是 | 净利润规模（元） |
| goodwill_impairment_to_net_profit | string | 是 | 商誉减值占净利润比例，公式 = goodwill_change / net_profit |
| notice_date | string | 是 | 公告日期，格式 YYYY-MM-DD HH:MM:SS |
| trade_board | string | 是 | 交易板块（sh/sz/cyb/star/bj/hk） |

## 注意事项

- 与 stock-detail 共用数据表，多返回 goodwill_change 和 goodwill_impairment_to_net_profit 字段
- goodwill_impairment_to_net_profit = goodwill_change / net_profit_scale，当分母为 0 或任一项为 null 时返回 null
- 金额字段均为 Decimal 类型，以字符串形式返回以保持精度
- trade_board 取值：sh（上交所主板）、sz（深交所主板）、cyb（创业板）、star（科创板）、bj（北交所）、hk（港股）

## 调用示例

```bash
python <RUN_PY> stock-goodwill-impairment --date 20260828
```