- 订单筛选项新增 platforms:系统预设 ∪ 当前主体订单里实际出现过的编码(带数量, 未收录进预设的标记 preset=false),下拉按用量排序,店管家新增平台类型时不会「筛不到」 - 手工单默认 source_platform_code=TB(淘宝),新建/编辑弹窗新增「电商平台」下拉; 编辑改平台时按系统预设同步名称;外部打单平台拉取的订单该字段置灰不可改 - 数据库店铺拉单按店铺配置的平台落库(未配置时默认淘宝),待审核订单可见可筛 - 迁移 20261107010000:把「数据库店铺订单(extend_props.source=shop_database)」与 「手工单(extend_props.labels 含手工单)」里为空的电商平台回填为 TB/淘宝 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
421 lines
14 KiB
TypeScript
421 lines
14 KiB
TypeScript
import { get, post, put, del } from '@/utils/request'
|
||
|
||
/**
|
||
* 订单(状态分表)
|
||
*
|
||
* 订单按状态分表存储,状态同时代表「所在表」:
|
||
* pending 待审核 / queued 待推送 / exception 异常 / outsourcing 委外中 / delivery 配送
|
||
* / void 已作废 / canceled 已取消 / history 历史(归档表)。
|
||
* 流转:待审核 →(审核+锁库存)待推送 →(推送仓库成功)委外中 →(仓库回传确认)配送;推送失败 → 异常。
|
||
* 列表按状态分视图(左侧 tab),状态流转由后端业务事务推动,前端只提交动作。
|
||
*/
|
||
export type OrderStage =
|
||
| 'pending'
|
||
| 'queued'
|
||
| 'exception'
|
||
| 'outsourcing'
|
||
| 'delivery'
|
||
| 'void'
|
||
| 'canceled'
|
||
| 'history'
|
||
|
||
/** 页面左侧 tab(顺序即状态流转顺序) */
|
||
export const ORDER_STAGE_TABS: { key: OrderStage; label: string }[] = [
|
||
{ key: 'pending', label: '待审核' },
|
||
{ key: 'queued', label: '待推送' },
|
||
{ key: 'exception', label: '异常' },
|
||
{ key: 'outsourcing', label: '委外中' },
|
||
{ key: 'delivery', label: '配送' },
|
||
{ key: 'void', label: '已作废' },
|
||
{ key: 'canceled', label: '已取消' },
|
||
{ key: 'history', label: '历史' },
|
||
]
|
||
|
||
/** 状态展示口径(文案与颜色,与后端 app/lib/orderStatus.js 对齐) */
|
||
export const ORDER_STAGE_META: Record<
|
||
OrderStage,
|
||
{ label: string; tag: '' | 'info' | 'warning' | 'success' | 'danger' }
|
||
> = {
|
||
pending: { label: '待审核', tag: 'warning' },
|
||
queued: { label: '待推送', tag: '' },
|
||
exception: { label: '异常', tag: 'danger' },
|
||
outsourcing: { label: '委外中', tag: '' },
|
||
delivery: { label: '配送', tag: 'success' },
|
||
void: { label: '已作废', tag: 'info' },
|
||
canceled: { label: '已取消', tag: 'info' },
|
||
history: { label: '历史', tag: 'info' },
|
||
}
|
||
|
||
/** 商品明细行(product_info JSON 元素,列表摘要用) */
|
||
export interface OrderProductLine {
|
||
item_code: string | null
|
||
item_name: string | null
|
||
quantity: number | null
|
||
price: number | null
|
||
}
|
||
|
||
/** 商品明细(order_status_items:发货单明细与平台明细的超集) */
|
||
export interface OrderItemLine {
|
||
id?: number
|
||
order_id?: number
|
||
order_line_no?: string
|
||
item_id?: number | null
|
||
item_code?: string | null
|
||
item_name?: string | null
|
||
plan_qty: number
|
||
actual_price?: number | null
|
||
retail_price?: number | null
|
||
ext_code?: string | null
|
||
inventory_type?: string
|
||
source_order_code?: string | null
|
||
sub_source_order_code?: string | null
|
||
stock_id?: number | null
|
||
product_id?: number | null
|
||
sku_code?: string | null
|
||
spec?: string | null
|
||
image?: string | null
|
||
created_at?: string
|
||
updated_at?: string
|
||
}
|
||
|
||
export interface OrderStatusItem {
|
||
id: number
|
||
principal_id: number
|
||
order_no: string
|
||
parent_order_no: string | null
|
||
shop_id: number | null
|
||
shop_name?: string | null
|
||
warehouse_id?: number | null
|
||
warehouse_code?: string | null
|
||
warehouse_name?: string | null
|
||
product_info: OrderProductLine[] | null
|
||
product_summary?: string
|
||
product_kind?: number
|
||
receiver: string | null
|
||
address: string | null
|
||
status: OrderStage
|
||
status_label?: string
|
||
/** 是否外部打单平台拉取的订单(店铺由平台决定,不可修改) */
|
||
is_external?: boolean
|
||
/** 来源平台:系统预设编码(PDD / DYXD / SPH…,见 constants/platform.ts) */
|
||
source_platform_code?: string | null
|
||
/** 来源平台名称(如「拼多多」) */
|
||
source_platform_name?: string | null
|
||
/** 平台自己的订单编号(店管家「订单编号」,来源订单号用的是其「系统编号」) */
|
||
oaid_order_source_code?: string | null
|
||
remark: string | null
|
||
/** —— 老发货单口径字段(为容纳老表而扩展) —— */
|
||
order_type?: string | null
|
||
is_urgency?: string | null
|
||
invoice_flag?: string | null
|
||
shop_nick?: string | null
|
||
buyer_message?: string | null
|
||
seller_message?: string | null
|
||
total_amount?: number | string | null
|
||
item_amount?: number | string | null
|
||
discount_amount?: number | string | null
|
||
freight?: number | string | null
|
||
ar_amount?: number | string | null
|
||
got_amount?: number | string | null
|
||
logistics_code?: string | null
|
||
logistics_name?: string | null
|
||
express_code?: string | null
|
||
express_codes?: string[] | null
|
||
logistics_area_code?: string | null
|
||
operator_name?: string | null
|
||
tel?: string | null
|
||
mobile?: string | null
|
||
email?: string | null
|
||
country_code?: string | null
|
||
province?: string | null
|
||
city?: string | null
|
||
area?: string | null
|
||
town?: string | null
|
||
detail_address?: string | null
|
||
zip_code?: string | null
|
||
oaid?: string | null
|
||
stock_locked?: number | null
|
||
wms_status?: string | null
|
||
wms_order_no?: string | null
|
||
wms_synced_at?: string | null
|
||
pushed_at?: string | null
|
||
wms_push_result?: Record<string, unknown> | null
|
||
legacy_source?: string | null
|
||
legacy_order_id?: number | null
|
||
legacy_status?: number | null
|
||
item_total?: number | string | null
|
||
item_kind?: number | null
|
||
audit_by?: number | null
|
||
audit_time?: string | null
|
||
void_at?: string | null
|
||
void_by?: number | null
|
||
void_reason?: string | null
|
||
/** 同步外部打单平台发货:0待同步 1已同步 2待重试 3异常(重试超限) */
|
||
external_send_status?: number | null
|
||
external_send_status_label?: string | null
|
||
external_send_times?: number | null
|
||
external_send_error?: string | null
|
||
external_send_at?: string | null
|
||
external_sent_at?: string | null
|
||
/** 索引表记录的当前所在表 */
|
||
current_table?: OrderStage
|
||
created_at?: string
|
||
updated_at?: string
|
||
/** 仅历史视图 */
|
||
archived_at?: string | null
|
||
transferred_at?: string | null
|
||
}
|
||
|
||
export interface OrderStatusQuery {
|
||
status: OrderStage
|
||
page: number
|
||
pageSize: number
|
||
order_no?: string
|
||
parent_order_no?: string
|
||
shop_id?: number | ''
|
||
receiver?: string
|
||
address?: string
|
||
remark?: string
|
||
created_from?: string
|
||
created_to?: string
|
||
archived_from?: string
|
||
archived_to?: string
|
||
}
|
||
|
||
export interface OrderStatusFilters {
|
||
statuses: { value: OrderStage; label: string }[]
|
||
status_labels: Record<OrderStage, string>
|
||
active_statuses: OrderStage[]
|
||
/** 超期自动归档阈值(月) */
|
||
archive_months: number
|
||
/** 订单索引表名 */
|
||
index_table?: string
|
||
/** 电商平台选项:系统预设 ∪ 订单里实际出现过的编码(preset=false 表示未收录进预设) */
|
||
platforms?: {
|
||
code: string
|
||
name: string
|
||
count: number
|
||
preset: boolean
|
||
}[]
|
||
shops: { id: number; code?: string; name: string; type?: number; subsidiary_id?: number | null }[]
|
||
warehouses: { id: number; code: string; name: string; subsidiary_id?: number | null }[]
|
||
}
|
||
|
||
/** 新建/编辑订单(发货单口径) */
|
||
export interface OrderStatusPayload {
|
||
/** 来源订单号(上游/平台订单号;与 order_no 至少传一个) */
|
||
parent_order_no?: string
|
||
/** 电商平台编码(系统预设,如 TB / PDD;手工单默认 TB) */
|
||
source_platform_code?: string
|
||
order_no?: string
|
||
shop_id?: number | null
|
||
warehouse_id?: number | null
|
||
order_type?: string
|
||
receiver?: string
|
||
tel?: string
|
||
mobile?: string
|
||
email?: string
|
||
country_code?: string
|
||
province?: string
|
||
city?: string
|
||
area?: string
|
||
town?: string
|
||
detail_address?: string
|
||
zip_code?: string
|
||
address?: string
|
||
oaid?: string
|
||
is_urgency?: string
|
||
invoice_flag?: string
|
||
total_amount?: number | null
|
||
item_amount?: number | null
|
||
discount_amount?: number | null
|
||
freight?: number | null
|
||
ar_amount?: number | null
|
||
got_amount?: number | null
|
||
logistics_code?: string
|
||
logistics_name?: string
|
||
seller_message?: string
|
||
buyer_message?: string
|
||
remark?: string
|
||
product_info?: OrderProductLine[]
|
||
/** 商品明细(发货单口径;与 product_info 二选一) */
|
||
items?: OrderItemLine[]
|
||
}
|
||
|
||
/** 流转结果(审核 / 推送 / 转回待审核 / 取消 / 作废 / 按 id 归档) */
|
||
export interface OrderStatusTransitionResult {
|
||
count: number
|
||
status: OrderStage
|
||
status_label: string
|
||
order_nos: string[]
|
||
/** 单条审核:本次锁定库存的明细行数 */
|
||
stock_locked?: number
|
||
/** 批量审核:失败明细 */
|
||
failed?: number
|
||
failures?: { id: number; message: string }[]
|
||
}
|
||
|
||
/** 单据级流转结果(驳回 / 恢复:可能换号) */
|
||
export interface OrderStatusSingleFlowResult {
|
||
count: number
|
||
status: OrderStage
|
||
status_label: string
|
||
items: { id: number; order_no: string; bill_no_changed: boolean }[]
|
||
}
|
||
|
||
/** 推送仓库结果 */
|
||
export interface OrderPushWmsResult {
|
||
id: number
|
||
attempts: number
|
||
wms_response?: Record<string, unknown>
|
||
}
|
||
|
||
export interface OrderPushWmsBatchResult {
|
||
requested: number
|
||
processed: number
|
||
pendingRest: number
|
||
pushed: number
|
||
failed: number
|
||
retry: number
|
||
skipped: number
|
||
details: { id: number; ok: boolean; message: string }[]
|
||
}
|
||
|
||
/** 归档结果(不传 ids 时按创建时间超期批量归档) */
|
||
export interface OrderStatusArchiveResult {
|
||
count: number
|
||
status?: OrderStage
|
||
status_label?: string
|
||
order_nos?: string[]
|
||
months?: number
|
||
threshold?: string
|
||
by_status?: Record<string, number>
|
||
}
|
||
|
||
/** 订单列表(按 status 定位状态表;principal_id 由请求拦截器注入) */
|
||
export function getOrderStatusList(params: OrderStatusQuery) {
|
||
return get<{ list: OrderStatusItem[]; total: number; page: number; pageSize: number }>(
|
||
'/order-status/list',
|
||
params as unknown as object,
|
||
)
|
||
}
|
||
|
||
/** 筛选项数据源:状态枚举 + 当前主体下的店铺/仓库 + 归档阈值 */
|
||
export function getOrderStatusFilters() {
|
||
return get<OrderStatusFilters>('/order-status/filters')
|
||
}
|
||
|
||
/** 订单详情(单据头 + 商品明细) */
|
||
export function getOrderStatusDetail(id: number) {
|
||
return get<{ order: OrderStatusItem; items: OrderItemLine[] }>(`/order-status/${id}`)
|
||
}
|
||
|
||
/** 新建订单 / 发货单(写入索引表 + 待审核表;带 items 时同时写入明细) */
|
||
export function createOrderStatus(data: OrderStatusPayload) {
|
||
return post<{
|
||
id: number
|
||
order_no: string
|
||
status: OrderStage
|
||
status_label: string
|
||
item_count: number
|
||
}>('/order-status', data)
|
||
}
|
||
|
||
/** 编辑订单(仅待审核 / 异常;未传字段保持原值) */
|
||
export function updateOrderStatus(id: number, data: OrderStatusPayload) {
|
||
return put<{ id: number; order_no: string }>(`/order-status/${id}`, data)
|
||
}
|
||
|
||
/** 删除订单(仅待审核 / 异常 / 已取消) */
|
||
export function removeOrderStatus(id: number) {
|
||
return del<{ count: number; order_nos: string[] }>(`/order-status/${id}`)
|
||
}
|
||
|
||
/** 商品明细(按订单ID) */
|
||
export function getOrderItems(orderId: number) {
|
||
return get<{ list: OrderItemLine[]; total: number }>('/order-status/items', { order_id: orderId })
|
||
}
|
||
|
||
/** 保存商品明细(整体替换,仅待审核 / 异常) */
|
||
export function saveOrderItems(orderId: number, items: OrderItemLine[]) {
|
||
return post<{ list: OrderItemLine[]; total: number }>('/order-status/items', {
|
||
order_id: orderId,
|
||
items,
|
||
})
|
||
}
|
||
|
||
/** 收件人文本智能识别 */
|
||
export function parseReceiverText(text: string) {
|
||
return post<Record<string, string>>('/order-status/parse-receiver', { text })
|
||
}
|
||
|
||
/** 批量审核:待审核 / 异常 → 委外中 */
|
||
export function auditOrders(ids: number[]) {
|
||
return post<OrderStatusTransitionResult>('/order-status/audit', { ids })
|
||
}
|
||
|
||
/** 批量推送外部:outcome=success 成功回传(→ 配送)/ failed 推送失败(→ 异常,remark 记录原因) */
|
||
export function pushOrders(ids: number[], outcome: 'success' | 'failed', remark?: string) {
|
||
return post<OrderStatusTransitionResult>('/order-status/push', { ids, outcome, remark })
|
||
}
|
||
|
||
/** 异常批量转回待审核 */
|
||
export function returnOrdersToPending(ids: number[]) {
|
||
return post<OrderStatusTransitionResult>('/order-status/return-to-pending', { ids })
|
||
}
|
||
|
||
/** 归档:传 ids 归档指定订单;不传则归档创建时间超过 months(默认 3)个月的订单 */
|
||
export function archiveOrders(data: { ids?: number[]; months?: number }) {
|
||
return post<OrderStatusArchiveResult>('/order-status/archive', data)
|
||
}
|
||
|
||
/** 驳回(委外中 → 待审核;换号 + 释放锁定库存) */
|
||
export function rejectOrders(ids: number[]) {
|
||
return post<OrderStatusSingleFlowResult>('/order-status/reject', { ids })
|
||
}
|
||
|
||
/** 取消(待审核 / 异常 / 委外中 → 已取消;已推送的会先取消外部单据) */
|
||
export function cancelOrders(ids: number[], remark?: string) {
|
||
return post<OrderStatusTransitionResult>('/order-status/cancel', { ids, remark })
|
||
}
|
||
|
||
/** 作废(待审核 / 异常 / 委外中 → 已作废;记录作废原因并释放锁定库存) */
|
||
export function voidOrders(ids: number[], voidReason?: string, remark?: string) {
|
||
return post<OrderStatusTransitionResult>('/order-status/void', {
|
||
ids,
|
||
void_reason: voidReason,
|
||
remark,
|
||
})
|
||
}
|
||
|
||
/** 恢复(已取消 / 已作废 → 待审核;曾推送过的自动换号) */
|
||
export function restoreOrders(ids: number[]) {
|
||
return post<OrderStatusSingleFlowResult>('/order-status/restore', { ids })
|
||
}
|
||
|
||
/** 推送仓库(WMS deliveryorder.create):单条立即推送 */
|
||
export function pushOrderToWms(id: number) {
|
||
return post<OrderPushWmsResult>(`/order-status/${id}/push-wms`, {})
|
||
}
|
||
|
||
/** 推送仓库:批量(顺序限流,超出部分交给定时任务) */
|
||
export function pushOrdersToWms(ids: number[]) {
|
||
return post<OrderPushWmsBatchResult>('/order-status/push-wms', { ids })
|
||
}
|
||
|
||
/** 批量切换发货仓库(同步刷新 warehouse_code 快照) */
|
||
export function changeOrdersWarehouse(ids: number[], warehouseId: number) {
|
||
return post<{ updated: number; target: { id: number; code: string; name: string } }>(
|
||
'/order-status/change-warehouse',
|
||
{ ids, warehouse_id: warehouseId },
|
||
)
|
||
}
|
||
|
||
/** 批量修改待审核订单的快递公司 */
|
||
export function changeOrdersLogistics(ids: number[], logisticsCode: string) {
|
||
return post<{ updated: number; target: { code: string; name: string } }>(
|
||
'/order-status/change-logistics',
|
||
{ ids, logistics_code: logisticsCode },
|
||
)
|
||
}
|