# platform_coupon_redemption_records 平台券核销记录

> 生成时间：2026-02-14

## 表信息

| 属性 | 值 |
|------|-----|
| Schema | ods |
| 表名 | platform_coupon_redemption_records |
| 主键 | id, content_hash |
| 数据来源 | export/test-json-doc/platform_coupon_redemption_records.json |
| 说明 | 平台券核销/使用记录 |

## 字段说明

| 序号 | 字段名 | 类型 | 可空 | 说明 |
|------|--------|------|------|------|
| 1 | id | BIGINT | NO | 本条平台验券记录在本系统内的主键 ID |
| 2 | verify_id | BIGINT | YES | 平台核销记录 ID（某些平台会为每一次核销生成一个唯一 ID） |
| 3 | certificate_id | TEXT | YES | 平台侧的凭证 ID（通常由第三方团购平台生成的券实例 ID） |
| 4 | coupon_code | TEXT | YES | 券码，顾客出示的团购券密码/编号 |
| 5 | coupon_name | TEXT | YES | 团购券产品名称（即第三方平台上向顾客展示的名称） |
| 6 | coupon_channel | INTEGER | YES | 券来源渠道（第三方平台渠道编号） |
| 7 | groupon_type | INTEGER | YES | 团购券类型 |
| 8 | group_package_id | BIGINT | YES | 标识类 ID 字段，用于关联/定位相关实体 |
| 9 | sale_price | NUMERIC(18,2) | YES | 顾客在第三方平台上实际支付的价格（团购售价） |
| 10 | coupon_money | NUMERIC(18,2) | YES | 券面值 / 套餐价值（系统层面的“可抵扣金额或对应套餐价值”） |
| 11 | coupon_free_time | NUMERIC(18,2) | YES | 券附带的“免费时长”字段（例如送多少分钟台费） |
| 12 | coupon_cover | TEXT | YES | 来自 JSON 导出的原始字段，用于保留业务取值 |
| 13 | coupon_remark | TEXT | YES | 来自 JSON 导出的原始字段，用于保留业务取值 |
| 14 | use_status | INTEGER | YES | 值 1：198 条 |
| 15 | consume_time | TIMESTAMP | YES | 券被核销/使用的业务时间 |
| 16 | create_time | TIMESTAMP | YES | 验券记录在本系统中创建的时间（记录入库时间） |
| 17 | deal_id | TEXT | YES | 另一个层次的团购产品 ID |
| 18 | channel_deal_id | TEXT | YES | 渠道侧 dealId / 产品 ID，一般是第三方平台给该团购商品定义的主键 |
| 19 | site_id | BIGINT | YES | 门店 ID |
| 20 | site_order_id | BIGINT | YES | 门店内部的订单 ID（平台券核销时对应的店内订单） |
| 21 | table_id | BIGINT | YES | 使用券的球台 ID |
| 22 | tenant_id | BIGINT | YES | 商户/租户 ID（品牌级别） |
| 23 | operator_id | BIGINT | YES | 操作员 ID（执行验券操作的收银员/员工） |
| 24 | operator_name | TEXT | YES | 操作员姓名，例如 "收银员:郑丽珊" |
| 25 | is_delete | INTEGER | YES | 把平台验券记录挂到本门店的一条订单上 |
| 26 | siteprofile | JSONB | YES | （待补充） |
| 27 | source_file | TEXT | YES | ETL 元数据：原始导出文件名，用于数据追溯 |
| 28 | source_endpoint | TEXT | YES | ETL 元数据：采集来源（接口/文件路径），用于数据追溯 |
| 29 | fetched_at | TIMESTAMPTZ | YES | ETL 元数据：采集/入库时间戳，用于口径对齐与增量处理 |
| 30 | payload | JSONB | NO | ETL 元数据：完整原始 JSON 记录快照，用于回溯与二次解析 |
| 31 | content_hash | TEXT | NO | ETL 元数据：对业务字段计算 SHA256，用于变更检测与去重 |

## 使用说明

```sql
-- 查询最新入库的记录
SELECT * FROM ods.platform_coupon_redemption_records
ORDER BY fetched_at DESC
LIMIT 10;
```

```sql
-- 按业务主键查询某条记录的所有版本
SELECT * FROM ods.platform_coupon_redemption_records
WHERE id = <value>
ORDER BY fetched_at DESC;
```

## ETL 元数据字段

| 字段名 | 类型 | 说明 |
|--------|------|------|
| content_hash | TEXT | 对业务字段计算 SHA256，用于变更检测与去重 |
| source_file | TEXT | 原始导出文件名，用于数据追溯 |
| source_endpoint | TEXT | 采集来源（接口/文件路径），用于数据追溯 |
| fetched_at | TIMESTAMPTZ | 采集/入库时间戳，用于口径对齐与增量处理 |
| payload | JSONB | 完整原始 JSON 记录快照，用于回溯与二次解析 |

## 可回溯性

| 项目 | 说明 |
|------|------|
| 可回溯 | ✅ 完全可回溯（保留 payload 原始 JSON） |
| 数据来源 | export/test-json-doc/platform_coupon_redemption_records.json |
