oms/frontend/src/api/orderStatus.ts
liufumingren ba0d03414a feat(order): 电商平台筛选可遍历实际平台,数据库店铺与手工单默认淘宝
- 订单筛选项新增 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>
2026-11-07 01:18:21 +08:00

421 lines
14 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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 },
)
}