# store_goods_sales_records 门店商品销售记录

> 生成时间：2026-02-14

## 表信息

| 属性 | 值 |
|------|-----|
| Schema | ods |
| 表名 | store_goods_sales_records |
| 主键 | id, content_hash |
| 数据来源 | export/test-json-doc/store_goods_sales_records.json |
| 说明 | 门店商品销售流水 |

## 字段说明

| 序号 | 字段名 | 类型 | 可空 | 说明 |
|------|--------|------|------|------|
| 1 | id | BIGINT | NO | 本条「门店销售流水」记录的主键 ID |
| 2 | tenant_id | BIGINT | YES | 租户/品牌 ID |
| 3 | site_id | BIGINT | YES | 门店 ID（系统主键） |
| 4 | siteid | BIGINT | YES | 来自 JSON 导出的原始字段，用于保留业务取值 |
| 5 | sitename | TEXT | YES | 名称字段，用于展示与辅助识别 |
| 6 | site_goods_id | BIGINT | YES | 门店商品 ID |
| 7 | tenant_goods_id | BIGINT | YES | 租户（品牌）级商品 ID（全局商品 ID） |
| 8 | order_settle_id | BIGINT | YES | 订单结算 ID（结账单主键） |
| 9 | order_trade_no | TEXT | YES | 订单交易号（业务单号） |
| 10 | order_goods_id | BIGINT | YES | 订单商品明细 ID（订单内部的商品行主键） |
| 11 | ordergoodsid | BIGINT | YES | 来自 JSON 导出的原始字段，用于保留业务取值 |
| 12 | order_pay_id | BIGINT | YES | 关联支付记录的 ID |
| 13 | order_coupon_id | BIGINT | YES | 订单级优惠券 ID |
| 14 | ledger_name | TEXT | YES | 销售项目名称（商品名称），例如 “哇哈哈矿泉水”“地道肠”“东方树叶”等 |
| 15 | ledger_group_name | TEXT | YES | 销售项目所属的「门店内部分组名称」，类似前台菜单分组或大类标签 |
| 16 | ledger_amount | NUMERIC(18,2) | YES | 原始应收金额，公式上接近 ledger_unit_price × ledger_count |
| 17 | ledger_count | NUMERIC(18,4) | YES | 销售数量（以 unit 为单位，unit 字段在门店商品档案中） |
| 18 | ledger_unit_price | NUMERIC(18,4) | YES | 商品在该次销售中的「结算单价」（元/单位） |
| 19 | ledger_status | INTEGER | YES | 销售流水状态 |
| 20 | discount_money | NUMERIC(18,2) | YES | 本条销售明细的「价格优惠金额」，即原价部分被减免掉的金额 |
| 21 | discount_price | NUMERIC(18,2) | YES | 折后单价（元/单位） |
| 22 | coupon_deduct_money | NUMERIC(18,2) | YES | 被优惠券 / 团购券直接抵扣到这条商品明细上的金额 |
| 23 | member_discount_amount | NUMERIC(18,2) | YES | 由会员身份（会员折扣）针对这一行商品产生的优惠金额 |
| 24 | option_coupon_deduct_money | NUMERIC(18,2) | YES | 由优惠券抵扣“选项价格”的金额 |
| 25 | option_member_discount_money | NUMERIC(18,2) | YES | 由会员折扣作用在“选项价格”上的优惠金额 |
| 26 | point_discount_money | NUMERIC(18,2) | YES | 由积分抵扣的金额（顾客兑换积分抵现金额） |
| 27 | point_discount_money_cost | NUMERIC(18,2) | YES | 积分抵扣对应的“成本金额”（后台核算用），例如按积分成本来计提费用 |
| 28 | real_goods_money | NUMERIC(18,2) | YES | 商品实际入账金额（考虑折扣、可能还会考虑其它抵扣后的实际销售金额） |
| 29 | cost_money | NUMERIC(18,2) | YES | 本条销售对应的成本金额（以元计） |
| 30 | push_money | NUMERIC(18,2) | YES | 本条销售对应的提成金额（给营业员/促销员的提成） |
| 31 | sales_type | INTEGER | YES | 销售类型 |
| 32 | is_single_order | INTEGER | YES | 是否单独订单标识 |
| 33 | is_delete | INTEGER | YES | 逻辑删除标志 |
| 34 | goods_remark | TEXT | YES | 商品备注/口味说明/特殊说明 |
| 35 | option_price | NUMERIC(18,2) | YES | 商品选项（规格/加料）的附加价格 |
| 36 | option_value_name | TEXT | YES | 商品选项名称（如规格、口味：大杯/小杯，不加冰等） |
| 37 | member_coupon_id | BIGINT | YES | 会员券 ID（比如会员专享优惠券） |
| 38 | package_coupon_id | BIGINT | YES | 套餐券 ID |
| 39 | sales_man_org_id | BIGINT | YES | 营业员所属组织/部门 ID |
| 40 | salesman_name | TEXT | YES | 营业员姓名（如果有为具体销售员记业绩，则在此填姓名） |
| 41 | salesman_role_id | BIGINT | YES | 营业员的系统角色 ID（例如某个角色代码表示“销售员”） |
| 42 | salesman_user_id | BIGINT | YES | 营业员用户 ID（系统账号 ID） |
| 43 | operator_id | BIGINT | YES | 操作员 ID（录入这笔销售的员工） |
| 44 | operator_name | TEXT | YES | 操作员姓名，文字冗余 |
| 45 | opensalesman | TEXT | YES | （待补充） |
| 46 | returns_number | INTEGER | YES | 退货数量（如果这条明细做了退货，会记录退货数量） |
| 47 | site_table_id | BIGINT | YES | 球台 ID |
| 48 | tenant_goods_business_id | BIGINT | YES | 租户级商品「业务大类」ID（例如“零食类”“酒水类”等更高维度） |
| 49 | tenant_goods_category_id | BIGINT | YES | 租户级商品一级分类 ID |
| 50 | create_time | TIMESTAMP | YES | 销售记录创建时间，通常就是结账时间或录入时间 |
| 51 | payload | JSONB | NO | ETL 元数据：完整原始 JSON 记录快照，用于回溯与二次解析 |
| 52 | source_file | TEXT | YES | ETL 元数据：原始导出文件名，用于数据追溯 |
| 53 | source_endpoint | TEXT | YES | ETL 元数据：采集来源（接口/文件路径），用于数据追溯 |
| 54 | fetched_at | TIMESTAMPTZ | YES | ETL 元数据：采集/入库时间戳，用于口径对齐与增量处理 |
| 55 | content_hash | TEXT | NO | ETL 元数据：对业务字段计算 SHA256，用于变更检测与去重 |
| 56 | coupon_share_money | NUMERIC(18,2) | YES | 优惠券分摊金额 |

## 使用说明

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

```sql
-- 按业务主键查询某条记录的所有版本
SELECT * FROM ods.store_goods_sales_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/store_goods_sales_records.json |
