zzh
c02cb21049
Support 1 pickup to N logistics orders with create/pay/schedule APIs, parcel inboundMethod auto-attach, plus allocation-trace and inbound-billing updates already in tree. Co-authored-by: Cursor <cursoragent@cursor.com>
79 lines
4.5 KiB
SQL
79 lines
4.5 KiB
SQL
-- 揽收单（独立履约/结算）+ 与物流单 1:N 关联；物流单冗余到仓方式与揽收 FK。
|
||
-- 文档：前端 docs/揽收单与物流单串联方案.md
|
||
-- 执行前请备份。
|
||
|
||
CREATE TABLE IF NOT EXISTS `t_pickup_order` (
|
||
`Id` INT NOT NULL AUTO_INCREMENT COMMENT '主键',
|
||
`PickupNo` VARCHAR(32) NOT NULL COMMENT '揽收单号',
|
||
`CustomerId` INT NOT NULL COMMENT '客户Id',
|
||
`SenderAddressId` INT NOT NULL COMMENT '发件地址簿Id',
|
||
`SenderName` VARCHAR(50) NOT NULL DEFAULT '' COMMENT '取件联系人快照',
|
||
`SenderPhone` VARCHAR(32) NULL COMMENT '取件电话快照',
|
||
`SenderCompany` VARCHAR(255) NULL COMMENT '公司快照',
|
||
`SenderCountryCode` VARCHAR(8) NULL COMMENT '国家码快照',
|
||
`SenderProvince` VARCHAR(50) NULL COMMENT '省快照',
|
||
`SenderCity` VARCHAR(50) NULL COMMENT '市快照',
|
||
`SenderZipCode` VARCHAR(50) NULL COMMENT '邮编快照',
|
||
`SenderStreetAddress1` VARCHAR(500) NOT NULL DEFAULT '' COMMENT '地址1快照',
|
||
`SenderStreetAddress2` VARCHAR(500) NULL COMMENT '地址2快照',
|
||
`WarehouseId` INT NOT NULL COMMENT '送到仓库Id',
|
||
`CarrierCode` VARCHAR(64) NULL COMMENT '承运商编码（draft可空）',
|
||
`CarrierService` VARCHAR(64) NULL COMMENT '承运服务（draft可空）',
|
||
`CarrierWaybillNo` VARCHAR(64) NULL COMMENT '承运商回执单号',
|
||
`ExpectPickupTime` DATETIME NOT NULL COMMENT '期望揽收时间',
|
||
`PickupWindowStart` DATETIME NULL COMMENT '时间窗起',
|
||
`PickupWindowEnd` DATETIME NULL COMMENT '时间窗止',
|
||
`ActualPickupTime` DATETIME NULL COMMENT '实际取件时间',
|
||
`Status` VARCHAR(32) NOT NULL DEFAULT 'draft' COMMENT 'draft/scheduled/dispatched/picked/inbound/cancelled/failed',
|
||
`ParcelCount` INT NOT NULL DEFAULT 0 COMMENT '关联票数',
|
||
`TotalActualWeight` DECIMAL(18,3) NULL COMMENT '汇总实重',
|
||
`ChargeableWeight` DECIMAL(18,3) NULL COMMENT '计费重',
|
||
`Currency` VARCHAR(8) NOT NULL DEFAULT 'CNY' COMMENT '币种',
|
||
`FreightAmount` DECIMAL(18,2) NULL COMMENT '对客揽收运费',
|
||
`OtherFeeAmount` DECIMAL(18,2) NULL COMMENT '对客其他费',
|
||
`ReceivableAmount` DECIMAL(18,2) NULL COMMENT '对客应收合计',
|
||
`PayStatus` VARCHAR(16) NOT NULL DEFAULT 'unpaid' COMMENT 'unpaid/paid',
|
||
`PayTime` DATETIME NULL COMMENT '支付时间',
|
||
`PayMode` VARCHAR(16) NOT NULL DEFAULT 'prepaid' COMMENT 'prepaid/collect',
|
||
`CarrierPayableAmount` DECIMAL(18,2) NULL COMMENT '应付承运商',
|
||
`SettlementStatus` VARCHAR(16) NOT NULL DEFAULT 'none' COMMENT 'none/pending/settled',
|
||
`SettlementBatchNo` VARCHAR(64) NULL COMMENT '结算批次号',
|
||
`SettledAt` DATETIME NULL COMMENT '结算时间',
|
||
`Remark` VARCHAR(512) NULL COMMENT '备注',
|
||
`IsDeleted` TINYINT NOT NULL DEFAULT 0 COMMENT '软删除',
|
||
`CreateUserId` INT NOT NULL DEFAULT 0 COMMENT '创建人',
|
||
`CreateTime` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
|
||
`UpdateUserId` INT NULL COMMENT '更新人',
|
||
`UpdateTime` DATETIME NULL COMMENT '更新时间',
|
||
PRIMARY KEY (`Id`),
|
||
UNIQUE KEY `uk_pickup_no` (`PickupNo`),
|
||
KEY `idx_pickup_customer_status` (`CustomerId`, `Status`, `CreateTime`),
|
||
KEY `idx_pickup_warehouse_time` (`WarehouseId`, `ExpectPickupTime`),
|
||
KEY `idx_pickup_pay` (`PayStatus`),
|
||
KEY `idx_pickup_settle` (`SettlementStatus`)
|
||
) COMMENT='揽收单（上门取件履约+对客收款+承运结算）';
|
||
|
||
CREATE TABLE IF NOT EXISTS `t_pickup_order_line` (
|
||
`Id` INT NOT NULL AUTO_INCREMENT COMMENT '主键',
|
||
`PickupOrderId` INT NOT NULL COMMENT '揽收单Id',
|
||
`OrderId` INT NOT NULL COMMENT '物流订单Id',
|
||
`SortNo` INT NOT NULL DEFAULT 0 COMMENT '展示序',
|
||
`IsDeleted` TINYINT NOT NULL DEFAULT 0 COMMENT '软删除',
|
||
`CreateUserId` INT NOT NULL DEFAULT 0 COMMENT '创建人',
|
||
`CreateTime` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
|
||
`UpdateUserId` INT NULL COMMENT '更新人',
|
||
`UpdateTime` DATETIME NULL COMMENT '更新时间',
|
||
PRIMARY KEY (`Id`),
|
||
UNIQUE KEY `uk_pickup_line_order` (`OrderId`),
|
||
UNIQUE KEY `uk_pickup_line_pair` (`PickupOrderId`, `OrderId`),
|
||
KEY `idx_pickup_line_header` (`PickupOrderId`, `IsDeleted`)
|
||
) COMMENT='揽收单关联物流订单（1揽收:N物流）';
|
||
|
||
ALTER TABLE `t_order`
|
||
ADD COLUMN `InboundMethod` VARCHAR(16) NULL COMMENT '到仓方式 selfShip/doorPickup' AFTER `CustomerSenderAddressId`,
|
||
ADD COLUMN `PickupOrderId` INT NULL COMMENT '关联揽收单Id（冗余）' AFTER `InboundMethod`;
|
||
|
||
ALTER TABLE `t_order`
|
||
ADD KEY `idx_order_pickup` (`PickupOrderId`),
|
||
ADD KEY `idx_order_inbound_method` (`InboundMethod`);
|