数据库【db_amazon】文档

一、数据库概述

数据库名称：db_amazon
数据库用途：亚马逊店铺综合管理系统，涵盖商品管理、订单管理、财务结算、库存管理、物流发货、广告监控等核心业务功能。

主要功能模块：

店铺授权管理 - 亚马逊账号授权和站点管理
商品管理 - SKU、ASIN信息、价格监控
订单管理 - 订单处理、发票、客户反馈
库存管理 - FBA/FBM库存监控
财务结算 - 账单结算、费用报表
物流管理 - 发货计划、货件跟踪
运营分析 - 销量分析、利润计算

二、核心表结构说明

1. 授权相关表

`t_amazon_auth` - 亚马逊账号授权表

主键：id
用途：存储亚马逊卖家账号授权信息
关键字段：
  - sellerid: 卖家ID
  - shop_id: 所属店铺ID
  - region: 区域（北美、欧洲等）
  - MWSAuthToken: 卖家授权令牌
  - disable: 是否禁用
  - refresh_token: OAuth刷新令牌

`t_amazon_group` - 店铺分组表

主键：id
用途：店铺分组管理（多账号分组）
关键字段：
  - name: 分组名称
  - shopid: 所属公司ID
  - profitcfgid: 默认利润方案
  - isfinance: 是否为财务账号

`t_amazonseller_market` - 卖家站点关联表

主键：sellerid, marketplace_id
用途：卖家与站点的关联关系
关键字段：
  - sellerid: 卖家ID
  - marketplace_id: 站点ID
  - country: 国家编码
  - amazonauthid: 对应的授权ID

2. 商品管理相关表

`t_product_info` - 商品基本信息表

主键：id
用途：存储商品核心信息
关键字段：
  - asin: 亚马逊标准识别号
  - sku: 卖家SKU
  - marketplaceid: 站点ID
  - name: 产品标题
  - price: 价格
  - parentAsin: 父ASIN（用于变体）
  - isparent: 是否父商品
  - invalid: 是否无效
  - amazonAuthId: 授权ID

`t_product_in_opt` - 商品运营信息表

主键：pid (关联t_product_info.id)
用途：商品运营相关配置
关键字段：
  - msku: 本地ERP系统SKU
  - owner: 运营负责人
  - status: 产品状态（0备货 1维持 2提升...）
  - presales: 手动预估销量
  - profitid: 利润计算方案
  - disable: 是否禁用
  - remark: 备注信息

`t_amz_product_refresh` - 商品刷新记录表

主键：pid
用途：记录商品信息刷新时间
关键字段：
  - detail_refresh_time: 详情刷新时间
  - price_refresh_time: 价格刷新时间
  - catalog_refresh_time: 分类刷新时间
  - notfound: 是否未找到

`t_amz_product_active` - 商品活跃状态表

主键：amazonAuthId, marketplaceid, sku
用途：记录商品活跃状态
关键字段：
  - asin: ASIN
  - openDate: 创建日期
  - price: 当前价格

3. 订单管理相关表

`t_amz_order_main` - 订单主表

主键：amazon_order_id, amazonAuthId
用途：订单基本信息
关键字段：
  - purchase_date: 购买时间
  - order_status: 订单状态
  - fulfillment_channel: 配送渠道（FBA/FBM）
  - sales_channel: 销售渠道
  - order_total: 订单总额
  - hasItem: 是否有商品明细
  - marketplaceId: 站点ID

`t_amz_order_item` - 订单商品明细表

主键：amazon_order_id, orderItemId
用途：订单商品详情
关键字段：
  - sku: 商品SKU
  - title: 商品标题
  - QuantityOrdered: 订购数量
  - QuantityShipped: 发货数量
  - item_price: 商品价格
  - item_tax: 商品税费
  - amazonAuthId: 授权ID
  - marketplaceId: 站点ID

`t_orders_report` - 订单报表表

主键：amazonAuthId, purchase_date, id
用途：订单报表数据（用于分析）
关键字段：
  - order_status: 订单状态
  - fulfillment_channel: 配送渠道
  - sales_channel: 销售渠道
  - quantity: 数量
  - item_price: 价格
  - item_tax: 税费
  - marketplaceId: 站点ID

`t_orders_summary` - 订单汇总表

主键：purchase_date, id
用途：按SKU汇总订单数据
关键字段：
  - amazonAuthId: 授权ID
  - marketplaceid: 站点ID
  - asin: ASIN
  - sku: SKU
  - quantity: 总销量
  - ordersum: 订单数量
  - orderprice: 订单金额

4. 库存管理相关表

`t_inventory_report` - 库存报表

主键：id
用途：每日库存快照
关键字段：
  - sku: SKU
  - byday: 快照日期
  - marketplaceid: 站点ID
  - afn_fulfillable_quantity: FBA可售库存
  - afn_unsellable_quantity: FBA不可售库存
  - afn_reserved_quantity: FBA预留库存
  - mfn_fulfillable_quantity: FBM可售库存
  - amazonAuthId: 授权ID

`t_amz_inventory_health` - 库存健康报告

主键：authid, marketplaceid, sku
用途：亚马逊库存健康报告
关键字段：
  - sales_rank: 销售排名
  - inv_age_0to90days: 0-90天库龄
  - inv_age_91to180days: 91-180天库龄
  - weeks_of_cover_t30: 30天库存周转周数
  - total_quantity: 总库存数量
  - sellable_quantity: 可销售数量
  - unsellable_quantity: 不可售数量

`t_inventory_report_his` - 库存历史表

主键：byday, id
用途：历史库存数据存档
关键字段：同t_inventory_report

5. 财务结算相关表

`t_amz_settlement_report` - 结算报表

主键：amazonAuthId, posted_date, id
用途：详细结算明细
关键字段：
  - settlement_id: 结算ID
  - transaction_type: 交易类型
  - order_id: 订单ID
  - marketplace_name: 站点名称
  - amount_type: 费用类型
  - amount_description: 费用描述
  - amount: 金额
  - currency: 币种
  - sku: SKU

`t_amz_settlement_summary_sku` - SKU结算汇总

主键：amazonAuthId, posted_date, id
用途：按SKU汇总结算数据
关键字段：
  - sku: SKU
  - marketplace_name: 站点名称
  - posted_date: 记账日期
  - order_amount: 订单量
  - sales: 销量
  - principal: 销售额
  - commission: 销售佣金
  - fbafee: FBA费用
  - refund: 退款金额
  - tax: 税费

`t_amz_settlement_summary_sku_month` - SKU月度汇总

主键：posted_date, id
用途：SKU月度数据汇总
关键字段：
  - amazonAuthId: 授权ID
  - sku: 平台SKU
  - msku: 本地SKU
  - groupid: 分组ID
  - posted_date: 月份（日期格式）
  - principal: 销售额
  - profit: 利润
  - profit_local_shipmentfee: 本地运费
  - profit_vat: VAT增值税

`t_amz_fin_account` - 财务账户表

主键：groupid, amazonAuthid
用途：财务账户信息
关键字段：
  - amazonAuthid: 授权ID
  - groupid: 分组ID
  - currency: 币种
  - financial_event_group_start: 财务事件组开始时间
  - financial_event_group_end: 财务事件组结束时间
  - processing_status: 处理状态
  - original_total: 原始总金额

6. 物流管理相关表

`t_erp_ship_inboundplan` - 入库计划表

主键：id
用途：FBA入库计划管理
关键字段：
  - name: 计划名称
  - number: 计划编号
  - amazongroupid: 店铺分组ID
  - marketplaceid: 站点ID
  - warehouseid: 仓库ID
  - auditstatus: 审核状态
  - createtime: 创建时间
  - creator: 创建人

`t_erp_ship_inboundshipment` - 入库货件表

主键：ShipmentId
用途：FBA入库货件详情
关键字段：
  - ShipmentId: 货件ID
  - DestinationFulfillmentCenterId: 目的FC
  - inboundplanid: 计划ID
  - ShipmentStatus: 货件状态
  - status: 系统状态
  - TotalUnits: 总单位数
  - carrier: 承运人
  - boxnum: 箱数
  - shiped_date: 发货日期

`t_erp_ship_inbounditem` - 入库货件商品表

主键：id
用途：货件商品明细
关键字段：
  - ShipmentId: 货件ID
  - SellerSKU: 卖家SKU
  - QuantityShipped: 发货数量
  - QuantityReceived: 接收数量
  - materialid: 物料ID
  - msku: 本地SKU
  - unitcost: 单位成本
  - totalcost: 总成本

`t_erp_ship_v2_inboundplan` - V2版本入库计划

主键：id
用途：新版入库计划管理
关键字段：
  - inbound_pland_id: 亚马逊计划ID
  - name: 计划名称
  - number: 计划编号
  - groupid: 分组ID
  - amazonauthid: 授权ID
  - marketplaceid: 站点ID
  - auditstatus: 审核状态（1已提交 2待配货 3待装箱...）
  - shipping_date: 预计发货日期
  - transtype: 运输方式

7. 运营分析相关表

`t_orders_summary` - 订单汇总（日）

主键：purchase_date, id
用途：每日SKU销量汇总
关键字段：
  - amazonAuthId: 授权ID
  - marketplaceid: 站点ID
  - purchase_date: 日期
  - asin: ASIN
  - sku: SKU
  - quantity: 销量
  - ordersum: 订单数
  - orderprice: 订单金额

`t_orders_summary_month` - 订单汇总（月）

主键：purchase_date, id
用途：月度SKU销量汇总
关键字段：同t_orders_summary

`t_amz_product_sales_plan` - 商品销售计划

主键：id
用途：商品销售预测和补货计划
关键字段：
  - sku: 平台SKU
  - msku: 本地SKU
  - shopid: 店铺ID
  - marketplaceid: 站点ID
  - groupid: 分组ID
  - amazonauthid: 授权ID
  - shipday: 发货周期
  - avgsales: 日均销量
  - needship: 待发货数量
  - needpurchase: 待采购数量

`t_profitcfg` - 利润计算方案

主键：id
用途：利润计算配置方案
关键字段：
  - shop_id: 店铺ID
  - isSystem: 是否系统内置
  - name: 方案名称
  - sales_channel: 销售渠道
  - sellerPlan: 销售计划
  - shipmentStyle: 运费计算方式
  - isDefault: 是否默认方案

`t_profitcfgcountry` - 利润计算国家配置

主键：id
用途：各国利润计算参数
关键字段：
  - profitid: 方案ID
  - country: 国家
  - taxRate: 进口关税费率
  - lostRate: 汇率损耗比率
  - sellerRate: 市场营销占比
  - vat_rate: VAT增值税费率
  - corporate_InRate: 企业所得税率

8. 报表相关表

`t_report_requestrecord` - 报表请求记录

主键：id
用途：存储亚马逊报表请求记录
关键字段：
  - sellerid: 卖家ID
  - marketPlaceId: 站点ID
  - reportType: 报表类型
  - reportId: 报表ID
  - reportRequestId: 报表请求ID
  - startDate: 开始时间
  - endDate: 结束时间
  - report_processing_status: 处理状态
  - isrun: 是否正在运行

`t_fba_storage_fee_report` - FBA仓储费报表

主键：amazonauthid, country, month, asin, fulfillment_center, fnsku
用途：FBA月度仓储费明细
关键字段：
  - asin: ASIN
  - fnsku: FNSKU
  - fulfillment_center: 履约中心
  - country: 国家
  - month: 月份
  - average_quantity_on_hand: 日均库存
  - monthly_storage_fee: 月度仓储费
  - currency: 币种

`t_fba_longterm_storage_fee_report` - 长期仓储费报表

主键：snapshot_date, sku, surcharge_age_tier, country, amazonauthid
用途：长期仓储费明细
关键字段：
  - snapshot_date: 快照日期
  - sku: SKU
  - condition: 商品状况
  - qty_charged_12month: 超过12个月收费数量
  - qty_charged_6month: 超过6个月收费数量
  - amount_charged: 收费金额
  - currency: 币种

9. 其他重要表

`t_erp_shipcycle` - 发货周期配置

主键：id
用途：SKU发货周期配置
关键字段：
  - sku: SKU
  - marketplaceid: 站点ID
  - groupid: 分组ID
  - transtype: 运输类型
  - stockingCycle: 安全库存周期
  - min_cycle: 最小发货周期
  - first_leg_charges: 头程运输成本

`t_erp_estimated_sales` - 预估销量表

主键：id
用途：手动维护日均销量
关键字段：
  - sku: SKU
  - marketplaceid: 站点ID
  - groupid: 分组ID
  - presales: 手动输入日均销量
  - startTime: 开始生效时间
  - endTime: 结束生效时间
  - isInvalid: 是否有效

`t_erp_market_priority` - 站点优先级

主键：marketplaceid, groupid
用途：发货计划中站点优先级配置
关键字段：
  - marketplaceid: 站点ID
  - groupid: 分组ID
  - priority: 优先级（数字越小优先级越高）

`t_exchangerate` - 汇率表

主键：id
用途：汇率信息
关键字段：
  - name: 币种名称
  - price: 汇率
  - symbol: 符号
  - utctime: 更新时间

`t_exchangerate_customer` - 客户自定义汇率

主键：id
用途：客户自定义汇率
关键字段：
  - shopid: 店铺ID
  - name: 币种
  - price: 自定义汇率

`t_holiday` - 节假日表

主键：id
用途：节假日数据
关键字段：
  - shopid: 店铺ID
  - day: 日期
  - name: 节日名称
  - type: 节假日类型（0工作日 1周末 2节日 3调休）
  - week: 星期几

三、数据关系说明

1. 核心业务关系链

店铺授权 (t_amazon_auth)
    ↓
店铺分组 (t_amazon_group)
    ↓
商品信息 (t_product_info)
    ├── 运营信息 (t_product_in_opt)
    ├── 刷新记录 (t_amz_product_refresh)
    ├── 销售计划 (t_amz_product_sales_plan)
    └── 订单汇总 (t_orders_summary)
        ↓
    订单明细 (t_amz_order_item)
        ↓
    结算明细 (t_amz_settlement_report)
        ↓
    SKU汇总 (t_amz_settlement_summary_sku)

2. 物流发货关系链

入库计划 (t_erp_ship_inboundplan / t_erp_ship_v2_inboundplan)
    ↓
入库货件 (t_erp_ship_inboundshipment / t_erp_ship_v2_inboundshipment)
    ↓
货件商品 (t_erp_ship_inbounditem)

3. 财务结算关系链

结算报表 (t_amz_settlement_report)
    ↓
SKU日汇总 (t_amz_settlement_summary_sku)
    ↓
SKU月汇总 (t_amz_settlement_summary_sku_month)

四、索引设计说明

1. 主要索引策略

商品相关索引：

t_product_info: (marketplaceid, amazonAuthId, isparent, invalid, disable) - 商品查询主索引
t_product_info: (asin) - ASIN查询索引
t_product_info: (parentAsin, marketplaceid, amazonAuthId) - 变体查询索引

订单相关索引：

t_amz_order_main: (amazonAuthId, purchase_date, hasItem) - 订单时间范围查询
t_amz_order_item: (amazonAuthId, marketplaceId, purchase_date) - 订单明细时间查询
t_orders_report: (amazonAuthId, purchase_date) - 报表时间查询

库存相关索引：

t_inventory_report: (marketplaceid, amazonAuthId, sku) - 库存SKU查询
t_inventory_report_his: (amazonAuthId, marketplaceid, sku, byday) - 历史库存查询

结算相关索引：

t_amz_settlement_report: (amazonAuthId, posted_date) - 按时间结算查询
t_amz_settlement_summary_sku: (amazonAuthId, posted_date) - SKU汇总时间查询

2. 复合索引设计原则

查询频率：高频查询字段放在前面
字段选择性：高选择性字段（如ID）放在前面
查询模式：按照业务实际查询模式设计
排序需求：需要排序的字段考虑在索引中

五、数据维护说明

1. 数据清理策略

库存历史数据：保留30天
仓储费报表：保留30天
结算报表：保留365天
其他报表：保留3天

2. 数据同步机制

商品刷新：通过事件自动刷新
库存同步：每日自动同步
订单同步：定时抓取
结算同步：定期获取结算报告

3. 性能优化建议

分区策略：对于大表（如订单表）考虑按时间分区
归档策略：定期归档历史数据到历史表
索引维护：定期检查索引使用情况并优化
查询优化：避免全表扫描，使用覆盖索引

六、业务规则说明

1. 商品状态规则

0: 备货
1: 维持
2: 提升
3: 促销
4: 停售
5: 清仓
6: 删除

2. 货件状态规则

-1: 已驳回
0: 取消货件
1: 待审核
2: 配货（已确认货件）
3: 装箱
4: 物流信息确认
5: 已发货
6: 已完成发货

3. 入库计划审核状态

1: 已提交（待审核）
2: 待配货
3: 待装箱
4: 待发货
7: 已发货
11: 已驳回
12: 已取消

七、安全注意事项

1. 敏感数据

授权令牌：t_amazon_auth.MWSAuthToken
刷新令牌：t_amazon_auth.refresh_token
API密钥：t_amazon_auth.access_key_id, t_amazon_auth.secret_key

2. 数据权限

按shopid进行数据隔离
按amazonAuthId进行账号隔离
敏感操作需要记录操作日志

3. 备份策略

每日完整备份
事务日志定期备份
重要表单独备份

八、常见问题排查

1. 数据不同步问题

检查t_amz_product_refresh刷新时间
检查t_report_requestrecord报表状态
检查事件autoRefreshInsert执行情况

2. 性能问题

检查大表的索引使用情况
检查查询是否使用正确索引
检查是否有全表扫描操作

3. 数据一致性问题

检查主从复制状态
检查事务完整性
检查外键约束

文档版本：1.0
更新日期：2024年
适用范围：数据库设计、开发、运维人员

数据库【db_amazon】文档

一、数据库概述

主要功能模块：

二、核心表结构说明

1. 授权相关表

t_amazon_auth - 亚马逊账号授权表

t_amazon_group - 店铺分组表

t_amazonseller_market - 卖家站点关联表

2. 商品管理相关表

t_product_info - 商品基本信息表

t_product_in_opt - 商品运营信息表

t_amz_product_refresh - 商品刷新记录表

t_amz_product_active - 商品活跃状态表

3. 订单管理相关表

t_amz_order_main - 订单主表

t_amz_order_item - 订单商品明细表

t_orders_report - 订单报表表

t_orders_summary - 订单汇总表

4. 库存管理相关表

t_inventory_report - 库存报表

t_amz_inventory_health - 库存健康报告

t_inventory_report_his - 库存历史表

5. 财务结算相关表

t_amz_settlement_report - 结算报表

t_amz_settlement_summary_sku - SKU结算汇总

t_amz_settlement_summary_sku_month - SKU月度汇总

t_amz_fin_account - 财务账户表

6. 物流管理相关表

t_erp_ship_inboundplan - 入库计划表

t_erp_ship_inboundshipment - 入库货件表

t_erp_ship_inbounditem - 入库货件商品表

t_erp_ship_v2_inboundplan - V2版本入库计划

7. 运营分析相关表

t_orders_summary - 订单汇总（日）

t_orders_summary_month - 订单汇总（月）

t_amz_product_sales_plan - 商品销售计划

t_profitcfg - 利润计算方案

t_profitcfgcountry - 利润计算国家配置

8. 报表相关表

t_report_requestrecord - 报表请求记录

t_fba_storage_fee_report - FBA仓储费报表

t_fba_longterm_storage_fee_report - 长期仓储费报表

9. 其他重要表

t_erp_shipcycle - 发货周期配置

t_erp_estimated_sales - 预估销量表

t_erp_market_priority - 站点优先级

t_exchangerate - 汇率表

t_exchangerate_customer - 客户自定义汇率

t_holiday - 节假日表

三、数据关系说明

1. 核心业务关系链

2. 物流发货关系链

3. 财务结算关系链

四、索引设计说明

1. 主要索引策略

2. 复合索引设计原则

五、数据维护说明

1. 数据清理策略

2. 数据同步机制

3. 性能优化建议

六、业务规则说明

1. 商品状态规则

2. 货件状态规则

3. 入库计划审核状态

七、安全注意事项

1. 敏感数据

2. 数据权限

3. 备份策略

八、常见问题排查

1. 数据不同步问题

2. 性能问题

3. 数据一致性问题

`t_amazon_auth` - 亚马逊账号授权表

`t_amazon_group` - 店铺分组表

`t_amazonseller_market` - 卖家站点关联表

`t_product_info` - 商品基本信息表

`t_product_in_opt` - 商品运营信息表

`t_amz_product_refresh` - 商品刷新记录表

`t_amz_product_active` - 商品活跃状态表

`t_amz_order_main` - 订单主表

`t_amz_order_item` - 订单商品明细表

`t_orders_report` - 订单报表表

`t_orders_summary` - 订单汇总表

`t_inventory_report` - 库存报表

`t_amz_inventory_health` - 库存健康报告

`t_inventory_report_his` - 库存历史表

`t_amz_settlement_report` - 结算报表

`t_amz_settlement_summary_sku` - SKU结算汇总

`t_amz_settlement_summary_sku_month` - SKU月度汇总

`t_amz_fin_account` - 财务账户表

`t_erp_ship_inboundplan` - 入库计划表

`t_erp_ship_inboundshipment` - 入库货件表

`t_erp_ship_inbounditem` - 入库货件商品表

`t_erp_ship_v2_inboundplan` - V2版本入库计划

`t_orders_summary` - 订单汇总（日）

`t_orders_summary_month` - 订单汇总（月）

`t_amz_product_sales_plan` - 商品销售计划

`t_profitcfg` - 利润计算方案

`t_profitcfgcountry` - 利润计算国家配置

`t_report_requestrecord` - 报表请求记录

`t_fba_storage_fee_report` - FBA仓储费报表

`t_fba_longterm_storage_fee_report` - 长期仓储费报表

`t_erp_shipcycle` - 发货周期配置

`t_erp_estimated_sales` - 预估销量表

`t_erp_market_priority` - 站点优先级

`t_exchangerate` - 汇率表

`t_exchangerate_customer` - 客户自定义汇率

`t_holiday` - 节假日表