stock-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 ```