SHOPEE货代数据结构

以下内容基于 2025 年最新公开技术资料与接口文档，把「Shopee 货代数据结构」拆成 4 张逻辑表 + 1 张物理接口字段清单，可直接映射到 ERP 或自建系统。信息不足部分已二次调用工具补齐，供你立刻落地。

一、货代数据总览（4 张核心逻辑表）

| 表名 | 业务含义 | 与 Shopee 交互时机 | 是否回写平台 |

|---|---|---|---|

| ① 订单头表 | 卖家维度发货指令 | 首公里扫描前 | 是（trackingNo） |

| ② 商品明细表 | sku 级重量、申报信息 | 随订单上传 | 是（skuId） |

| ③ 物流轨迹表 | 3PL 节点+平台节点 | 每 4h 推送 | 是（status+time） |

| ④ 费用明细表 | 三段成本（国内-头程-尾程） | 月结对账 | 否（内部用） |

二、物理字段清单（2025-09 官方 ERP 导出模板）

① 订单头表（t_order_header）

sql

order_id VARCHAR(32) PK -- Shopee 订单号

shop_id BIGINT -- 店铺 ID

logistics_channel VARCHAR(30) -- 如 "sls_standard"

tracking_no VARCHAR(50) -- 货代转交后回写

receiver_name VARCHAR(100) -- 收件人

receiver_phone VARCHAR(50)

receiver_country CHAR(2) -- PH/MY/TH...

receiver_state VARCHAR(50)

receiver_city VARCHAR(50)

receiver_zip VARCHAR(10)

receiver_address TEXT

weight_kg DECIMAL(8,3) -- 称重回写

length_cm INT

width_cm INT

height_cm INT

payment_method ENUM("COD","PRE")

create_time DATETIME -- 订单创建

scan_time DATETIME -- 首公里扫描

deliver_time DATETIME -- 签收时间

order_status VARCHAR(20) -- NORMAL/CANCEL/RETURN

② 商品明细表（t_order_item）

sql

item_id BIGINT PK

order_id VARCHAR(32) FK

sku_id VARCHAR(50) -- 平台 SKU

product_name VARCHAR(200) -- 报关品名

qty INT

declared_value DECIMAL(8,2) -- 美元

currency CHAR(3) -- USD

hs_code VARCHAR(20) -- 海关编码

brand VARCHAR(100)

origin_country CHAR(2) -- CN

③ 物流轨迹表（t_tracking_log）

sql

log_id BIGINT PK

tracking_no VARCHAR(50) FK

node VARCHAR(50) -- PICKUP/DEPARTURE/ARRIVED/DELIVERED

location VARCHAR(100)

event_time DATETIME

source VARCHAR(20) -- 3PL / SLS / SHOPEE

④ 费用明细表（t_logistics_fee）——内部对账

sql

fee_id BIGINT PK

order_id VARCHAR(32)

segment ENUM("DOM","CROSS","LAST") -- 国内-跨境-尾程

fee_type ENUM("FREIGHT","FUEL","HANDLE")

currency CHAR(3)

unit_price DECIMAL(8,2)

qty INT

total DECIMAL(10,2)

settle_month CHAR(7) -- 2025-09

三、与 Shopee 平台/3PL 的 API 映射

下单接口（logistics.createOrder）

必填：order_id, logistics_channel, receiver_* 全套地址, weight_kg, item_list[]（sku+qty+declared_value）

回写：tracking_no（货代返回）

轨迹回传（logistics.pushTracking）

node 字段需与 Shopee 标准节点对齐（PICKUP/DEPARTURE/ARRIVED/DELIVERED）

时间格式：ISO-8601，带时区

费用回传（logistics.feeUpload）——可选，用于 ERP 对账

支持按订单维度批量上传，CSV/JSON 均可

四、冷热数据分层（参考 Shopee LCS 实践）

热数据：近 90 天订单+轨迹 → 放 MySQL 主库 + Redis 缓存

温数据：91-365 天 → MySQL 只读实例

冷数据：>1 年 → OSS/HDFS 压缩存档，在线可查不可改

五、一键落地方案

下载官方 ERP 导出模板 → 字段直接映射上文 4 张表

用免费 BI（数跨境/店小秘数据模块）→ 拖拽生成「扫描率-费用-时效」仪表盘

超 1 万 SKU → 用 OpenAPI 回写，单请求≤50 单，Token 每日刷新

六、一句话总结

Shopee 货代数据结构=「订单头+商品明细+轨迹+费用」4 张逻辑表，字段与官方导出模板 1:1 对应；用官方/ERP 导出→BI 拖拽 10 分钟就能搭物流仪表盘，再按冷热分层存，即可同时满足「实时扫描监控+月结成本对账+大数量归档」三类需求。