Files
wms-saas/docs/database/06-outbound/wms_order.sql
T
2026-09-30 11:11:54 +08:00

39 lines
3.1 KiB
SQL

-- 表:wms_order
-- 用途:统一订单。与具体电商平台解耦的履约订单。
-- 约定:InnoDB / utf8mb4 / 无外键,表间按业务编码关联。详见 docs/database/00-conventions.md
-- 说明:核心订单只保存统一字段。平台特有属性留在连接器,不在本表加 Amazon、TikTok 等专用列。订单状态表示履约进度,仓库作业状态以 wms_outbound.status 为准。
CREATE TABLE `wms_order` (
`id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '内部主键',
`tenant_code` VARCHAR(32) NOT NULL COMMENT '租户编码',
`order_no` VARCHAR(64) NOT NULL COMMENT '订单号,租户内唯一',
`customer_code` VARCHAR(32) NOT NULL COMMENT '货主编码',
`warehouse_code` VARCHAR(32) NOT NULL DEFAULT '' COMMENT '指定仓库;拆到多个仓库时为空,以出库单为准',
`order_channel` VARCHAR(32) NOT NULL COMMENT '来源渠道:manual、api、erp、amazon、shopify、tiktok_shop、temu、shopee、mirakl',
`order_source` VARCHAR(32) NOT NULL COMMENT '进入方式:manual 手工,open_api 开放接口,connector 平台连接器',
`external_order_no` VARCHAR(64) NULL COMMENT '外部订单号;手工单必须为 NULL',
`shop_code` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '店铺编码,非平台单为空',
`status` VARCHAR(32) NOT NULL DEFAULT 'draft' COMMENT 'draft 草稿,confirmed 已确认,processing 作业中,partially_shipped 部分发货,shipped 已发货,completed 已完成,cancelled 已取消',
`currency` CHAR(3) NOT NULL DEFAULT 'CNY' COMMENT '申报金额币种',
`required_ship_at` DATETIME(3) NULL COMMENT '要求发货时间',
`ship_name` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '收件人',
`ship_phone` VARCHAR(32) NOT NULL DEFAULT '' COMMENT '收件电话',
`ship_country_code` CHAR(2) NOT NULL DEFAULT '' COMMENT '收件国家',
`ship_province` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '收件省或州',
`ship_city` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '收件城市',
`ship_district` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '收件区县',
`ship_address` VARCHAR(255) NOT NULL DEFAULT '' COMMENT '收件详细地址',
`ship_postcode` VARCHAR(32) NOT NULL DEFAULT '' COMMENT '收件邮编',
`remark` VARCHAR(500) NOT NULL DEFAULT '' COMMENT '备注',
`created_by` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人 user_code,系统任务为空',
`updated_by` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '更新人 user_code',
`created_at` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间',
`updated_at` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3) COMMENT '更新时间',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_tenant_order_no` (`tenant_code`, `order_no`),
UNIQUE KEY `uk_tenant_channel_external` (`tenant_code`, `order_channel`, `external_order_no`),
KEY `idx_tenant_status_created` (`tenant_code`, `status`, `created_at`),
KEY `idx_tenant_customer` (`tenant_code`, `customer_code`),
KEY `idx_tenant_shop` (`tenant_code`, `shop_code`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='统一订单';