# 数据库【db_amazon】文档 ## 一、数据库概述 **数据库名称**：`db_amazon` **数据库用途**：亚马逊店铺综合管理系统，涵盖商品管理、订单管理、财务结算、库存管理、物流发货、广告监控等核心业务功能。 ### 主要功能模块： 1. **店铺授权管理** - 亚马逊账号授权和站点管理 2. **商品管理** - SKU、ASIN信息、价格监控 3. **订单管理** - 订单处理、发票、客户反馈 4. **库存管理** - FBA/FBM库存监控 5. **财务结算** - 账单结算、费用报表 6. **物流管理** - 发货计划、货件跟踪 7. **运营分析** - 销量分析、利润计算 ## 二、核心表结构说明 ### 1. 授权相关表 #### `t_amazon_auth` - 亚马逊账号授权表
sql
``` 主键：id 用途：存储亚马逊卖家账号授权信息 关键字段： - sellerid: 卖家ID - shop_id: 所属店铺ID - region: 区域（北美、欧洲等） - MWSAuthToken: 卖家授权令牌 - disable: 是否禁用 - refresh_token: OAuth刷新令牌 ``` #### `t_amazon_group` - 店铺分组表
sql
``` 主键：id 用途：店铺分组管理（多账号分组） 关键字段： - name: 分组名称 - shopid: 所属公司ID - profitcfgid: 默认利润方案 - isfinance: 是否为财务账号 ``` #### `t_amazonseller_market` - 卖家站点关联表
sql
``` 主键：sellerid, marketplace_id 用途：卖家与站点的关联关系 关键字段： - sellerid: 卖家ID - marketplace_id: 站点ID - country: 国家编码 - amazonauthid: 对应的授权ID ``` ### 2. 商品管理相关表 #### `t_product_info` - 商品基本信息表
sql
``` 主键：id 用途：存储商品核心信息 关键字段： - asin: 亚马逊标准识别号 - sku: 卖家SKU - marketplaceid: 站点ID - name: 产品标题 - price: 价格 - parentAsin: 父ASIN（用于变体） - isparent: 是否父商品 - invalid: 是否无效 - amazonAuthId: 授权ID ``` #### `t_product_in_opt` - 商品运营信息表
sql
``` 主键：pid (关联t_product_info.id) 用途：商品运营相关配置 关键字段： - msku: 本地ERP系统SKU - owner: 运营负责人 - status: 产品状态（0备货 1维持 2提升...） - presales: 手动预估销量 - profitid: 利润计算方案 - disable: 是否禁用 - remark: 备注信息 ``` #### `t_amz_product_refresh` - 商品刷新记录表
sql
``` 主键：pid 用途：记录商品信息刷新时间 关键字段： - detail_refresh_time: 详情刷新时间 - price_refresh_time: 价格刷新时间 - catalog_refresh_time: 分类刷新时间 - notfound: 是否未找到 ``` #### `t_amz_product_active` - 商品活跃状态表
sql
``` 主键：amazonAuthId, marketplaceid, sku 用途：记录商品活跃状态 关键字段： - asin: ASIN - openDate: 创建日期 - price: 当前价格 ``` ### 3. 订单管理相关表 #### `t_amz_order_main` - 订单主表
sql
``` 主键：amazon_order_id, amazonAuthId 用途：订单基本信息 关键字段： - purchase_date: 购买时间 - order_status: 订单状态 - fulfillment_channel: 配送渠道（FBA/FBM） - sales_channel: 销售渠道 - order_total: 订单总额 - hasItem: 是否有商品明细 - marketplaceId: 站点ID ``` #### `t_amz_order_item` - 订单商品明细表
sql
``` 主键：amazon_order_id, orderItemId 用途：订单商品详情 关键字段： - sku: 商品SKU - title: 商品标题 - QuantityOrdered: 订购数量 - QuantityShipped: 发货数量 - item_price: 商品价格 - item_tax: 商品税费 - amazonAuthId: 授权ID - marketplaceId: 站点ID ``` #### `t_orders_report` - 订单报表表
sql
``` 主键：amazonAuthId, purchase_date, id 用途：订单报表数据（用于分析） 关键字段： - order_status: 订单状态 - fulfillment_channel: 配送渠道 - sales_channel: 销售渠道 - quantity: 数量 - item_price: 价格 - item_tax: 税费 - marketplaceId: 站点ID ``` #### `t_orders_summary` - 订单汇总表
sql
``` 主键：purchase_date, id 用途：按SKU汇总订单数据 关键字段： - amazonAuthId: 授权ID - marketplaceid: 站点ID - asin: ASIN - sku: SKU - quantity: 总销量 - ordersum: 订单数量 - orderprice: 订单金额 ``` ### 4. 库存管理相关表 #### `t_inventory_report` - 库存报表
sql
``` 主键：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` - 库存健康报告
sql
``` 主键：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` - 库存历史表
sql
``` 主键：byday, id 用途：历史库存数据存档 关键字段：同t_inventory_report ``` ### 5. 财务结算相关表 #### `t_amz_settlement_report` - 结算报表
sql
``` 主键：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结算汇总
sql
``` 主键：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月度汇总
sql
``` 主键：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` - 财务账户表
sql
``` 主键：groupid, amazonAuthid 用途：财务账户信息 关键字段： - amazonAuthid: 授权ID - groupid: 分组ID - currency: 币种 - financial_event_group_start: 财务事件组开始时间 - financial_event_group_end: 财务事件组结束时间 - processing_status: 处理状态 - original_total: 原始总金额 ``` ### 6. 物流管理相关表 #### `t_erp_ship_inboundplan` - 入库计划表
sql
``` 主键：id 用途：FBA入库计划管理 关键字段： - name: 计划名称 - number: 计划编号 - amazongroupid: 店铺分组ID - marketplaceid: 站点ID - warehouseid: 仓库ID - auditstatus: 审核状态 - createtime: 创建时间 - creator: 创建人 ``` #### `t_erp_ship_inboundshipment` - 入库货件表
sql
``` 主键：ShipmentId 用途：FBA入库货件详情 关键字段： - ShipmentId: 货件ID - DestinationFulfillmentCenterId: 目的FC - inboundplanid: 计划ID - ShipmentStatus: 货件状态 - status: 系统状态 - TotalUnits: 总单位数 - carrier: 承运人 - boxnum: 箱数 - shiped_date: 发货日期 ``` #### `t_erp_ship_inbounditem` - 入库货件商品表
sql
``` 主键：id 用途：货件商品明细 关键字段： - ShipmentId: 货件ID - SellerSKU: 卖家SKU - QuantityShipped: 发货数量 - QuantityReceived: 接收数量 - materialid: 物料ID - msku: 本地SKU - unitcost: 单位成本 - totalcost: 总成本 ``` #### `t_erp_ship_v2_inboundplan` - V2版本入库计划
sql
``` 主键：id 用途：新版入库计划管理 关键字段： - inbound_pland_id: 亚马逊计划ID - name: 计划名称 - number: 计划编号 - groupid: 分组ID - amazonauthid: 授权ID - marketplaceid: 站点ID - auditstatus: 审核状态（1已提交 2待配货 3待装箱...） - shipping_date: 预计发货日期 - transtype: 运输方式 ``` ### 7. 运营分析相关表 #### `t_orders_summary` - 订单汇总（日）
sql
``` 主键：purchase_date, id 用途：每日SKU销量汇总 关键字段： - amazonAuthId: 授权ID - marketplaceid: 站点ID - purchase_date: 日期 - asin: ASIN - sku: SKU - quantity: 销量 - ordersum: 订单数 - orderprice: 订单金额 ``` #### `t_orders_summary_month` - 订单汇总（月）
sql
``` 主键：purchase_date, id 用途：月度SKU销量汇总 关键字段：同t_orders_summary ``` #### `t_amz_product_sales_plan` - 商品销售计划
sql
``` 主键：id 用途：商品销售预测和补货计划 关键字段： - sku: 平台SKU - msku: 本地SKU - shopid: 店铺ID - marketplaceid: 站点ID - groupid: 分组ID - amazonauthid: 授权ID - shipday: 发货周期 - avgsales: 日均销量 - needship: 待发货数量 - needpurchase: 待采购数量 ``` #### `t_profitcfg` - 利润计算方案
sql
``` 主键：id 用途：利润计算配置方案 关键字段： - shop_id: 店铺ID - isSystem: 是否系统内置 - name: 方案名称 - sales_channel: 销售渠道 - sellerPlan: 销售计划 - shipmentStyle: 运费计算方式 - isDefault: 是否默认方案 ``` #### `t_profitcfgcountry` - 利润计算国家配置
sql
``` 主键：id 用途：各国利润计算参数 关键字段： - profitid: 方案ID - country: 国家 - taxRate: 进口关税费率 - lostRate: 汇率损耗比率 - sellerRate: 市场营销占比 - vat_rate: VAT增值税费率 - corporate_InRate: 企业所得税率 ``` ### 8. 报表相关表 #### `t_report_requestrecord` - 报表请求记录
sql
``` 主键：id 用途：存储亚马逊报表请求记录 关键字段： - sellerid: 卖家ID - marketPlaceId: 站点ID - reportType: 报表类型 - reportId: 报表ID - reportRequestId: 报表请求ID - startDate: 开始时间 - endDate: 结束时间 - report_processing_status: 处理状态 - isrun: 是否正在运行 ``` #### `t_fba_storage_fee_report` - FBA仓储费报表
sql
``` 主键：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` - 长期仓储费报表
sql
``` 主键：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` - 发货周期配置
sql
``` 主键：id 用途：SKU发货周期配置 关键字段： - sku: SKU - marketplaceid: 站点ID - groupid: 分组ID - transtype: 运输类型 - stockingCycle: 安全库存周期 - min_cycle: 最小发货周期 - first_leg_charges: 头程运输成本 ``` #### `t_erp_estimated_sales` - 预估销量表
sql
``` 主键：id 用途：手动维护日均销量 关键字段： - sku: SKU - marketplaceid: 站点ID - groupid: 分组ID - presales: 手动输入日均销量 - startTime: 开始生效时间 - endTime: 结束生效时间 - isInvalid: 是否有效 ``` #### `t_erp_market_priority` - 站点优先级
sql
``` 主键：marketplaceid, groupid 用途：发货计划中站点优先级配置 关键字段： - marketplaceid: 站点ID - groupid: 分组ID - priority: 优先级（数字越小优先级越高） ``` #### `t_exchangerate` - 汇率表
sql
``` 主键：id 用途：汇率信息 关键字段： - name: 币种名称 - price: 汇率 - symbol: 符号 - utctime: 更新时间 ``` #### `t_exchangerate_customer` - 客户自定义汇率
sql
``` 主键：id 用途：客户自定义汇率 关键字段： - shopid: 店铺ID - name: 币种 - price: 自定义汇率 ``` #### `t_holiday` - 节假日表
sql
``` 主键：id 用途：节假日数据 关键字段： - shopid: 店铺ID - day: 日期 - name: 节日名称 - type: 节假日类型（0工作日 1周末 2节日 3调休） - week: 星期几 ``` ## 三、数据关系说明 ### 1. 核心业务关系链
text
``` 店铺授权 (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. 物流发货关系链
text
``` 入库计划 (t_erp_ship_inboundplan / t_erp_ship_v2_inboundplan) ↓ 入库货件 (t_erp_ship_inboundshipment / t_erp_ship_v2_inboundshipment) ↓ 货件商品 (t_erp_ship_inbounditem) ``` ### 3. 财务结算关系链
text
``` 结算报表 (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. 复合索引设计原则 1. **查询频率**：高频查询字段放在前面 2. **字段选择性**：高选择性字段（如ID）放在前面 3. **查询模式**：按照业务实际查询模式设计 4. **排序需求**：需要排序的字段考虑在索引中 ## 五、数据维护说明 ### 1. 数据清理策略 - 库存历史数据：保留30天 - 仓储费报表：保留30天 - 结算报表：保留365天 - 其他报表：保留3天 ### 2. 数据同步机制 - 商品刷新：通过事件自动刷新 - 库存同步：每日自动同步 - 订单同步：定时抓取 - 结算同步：定期获取结算报告 ### 3. 性能优化建议 1. **分区策略**：对于大表（如订单表）考虑按时间分区 2. **归档策略**：定期归档历史数据到历史表 3. **索引维护**：定期检查索引使用情况并优化 4. **查询优化**：避免全表扫描，使用覆盖索引 ## 六、业务规则说明 ### 1. 商品状态规则
text
``` 0: 备货 1: 维持 2: 提升 3: 促销 4: 停售 5: 清仓 6: 删除 ``` ### 2. 货件状态规则
text
``` -1: 已驳回 0: 取消货件 1: 待审核 2: 配货（已确认货件） 3: 装箱 4: 物流信息确认 5: 已发货 6: 已完成发货 ``` ### 3. 入库计划审核状态
text
``` 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. 数据不同步问题 1. 检查`t_amz_product_refresh`刷新时间 2. 检查`t_report_requestrecord`报表状态 3. 检查事件`autoRefreshInsert`执行情况 ### 2. 性能问题 1. 检查大表的索引使用情况 2. 检查查询是否使用正确索引 3. 检查是否有全表扫描操作 ### 3. 数据一致性问题 1. 检查主从复制状态 2. 检查事务完整性 3. 检查外键约束 --- **文档版本**：1.0 **更新日期**：2024年 **适用范围**：数据库设计、开发、运维人员