This commit is contained in:
yin 2026-06-07 18:21:08 +08:00
parent b561cf3a77
commit 50bf6ad735
102 changed files with 2031 additions and 867 deletions

Binary file not shown.

View File

@ -58,6 +58,19 @@ export type PendingOrderUpdateOrderExpressParams = {
express_code: string;
};
export type PendingOrderUpdateAddressParams = {
ids: number[];
name?: string;
mobile?: string;
tel?: string;
zip_code?: string;
province?: string;
city?: string;
area?: string;
town?: string;
detail_address?: string;
};
export type PendingOrderCloneOrderParams = {
order_id: number;
};
@ -391,6 +404,22 @@ export function orderPendingOrderUpdateOrderExpress(
} as any);
}
export function orderPendingOrderUpdateAddress(
data: PendingOrderUpdateAddressParams,
): Promise<any> {
return request({
url: "/system",
method: "post",
params: {
method: "order.pendingOrder.updateAddress",
v,
timestamp: Date.now(),
},
data,
isSystemApi: true,
} as any);
}
export function orderPendingOrderCloneOrder(data: PendingOrderCloneOrderParams): Promise<any> {
return request({
url: "/system",
@ -419,20 +448,6 @@ export function orderPendingOrderCreateOrder(data: PendingOrderCreateOrderParams
} as any);
}
export function orderPendingOrderDownloadCreateTemplate(): Promise<any> {
return request({
url: "/system",
method: "post",
params: {
method: "order.pendingOrder.downloadCreateTemplate",
v,
timestamp: Date.now(),
},
data: {},
isSystemApi: true,
} as any);
}
export function orderPendingOrderImportOrdersFromExcel(
data: PendingOrderImportOrdersFromExcelParams,
): Promise<any> {
@ -478,9 +493,9 @@ export type OrderPendingOrderApi = {
syncOrderIds: typeof orderPendingOrderSyncOrderIds;
updateOrderPlatform: typeof orderPendingOrderUpdateOrderPlatform;
updateOrderExpress: typeof orderPendingOrderUpdateOrderExpress;
updateAddress: typeof orderPendingOrderUpdateAddress;
cloneOrder: typeof orderPendingOrderCloneOrder;
createOrder: typeof orderPendingOrderCreateOrder;
downloadCreateTemplate: typeof orderPendingOrderDownloadCreateTemplate;
importOrdersFromExcel: typeof orderPendingOrderImportOrdersFromExcel;
parseAddress: typeof orderPendingOrderParseAddress;
};
@ -498,9 +513,9 @@ export const orderPendingOrder: OrderPendingOrderApi = {
syncOrderIds: orderPendingOrderSyncOrderIds,
updateOrderPlatform: orderPendingOrderUpdateOrderPlatform,
updateOrderExpress: orderPendingOrderUpdateOrderExpress,
updateAddress: orderPendingOrderUpdateAddress,
cloneOrder: orderPendingOrderCloneOrder,
createOrder: orderPendingOrderCreateOrder,
downloadCreateTemplate: orderPendingOrderDownloadCreateTemplate,
importOrdersFromExcel: orderPendingOrderImportOrdersFromExcel,
parseAddress: orderPendingOrderParseAddress,
};

View File

@ -5,6 +5,7 @@ const v = '1.0'
import type { WaveBatchListParams, WaveBatchListResponse, WaveBatchListWhere, WaveListPagination } from '@/api/order/order'
export type { WaveBatchListParams, WaveBatchListResponse, WaveBatchListWhere, WaveListPagination }
export { unwrapWaveBatchListResponse } from '@/api/order/order'
export type WavePickTaskListParams = {
warehouse_id: number
@ -31,11 +32,96 @@ export type WavePickTaskListParams = {
strategy_id?: number
}
/** order.wave.wavePickTaskList 列表项(与 wms_wave_pick_task 主表字段对齐) */
export type WavePickTaskListItem = {
task_id?: number | string
task_no?: string
batch_no?: string
warehouse_id?: number | string
status?: number | string
review_status?: number | string
pick_mode?: number | string
source?: number | string
wave_count?: number | string
order_count?: number | string
box_count?: number | string
operator_id?: number | string
operator_name?: string
creator_id?: number | string
creator_name?: string
pick_user_id?: number | string
pick_user_name?: string
review_user_id?: number | string
review_user_name?: string
current_cart_id?: number | string
current_cart_code_snapshot?: string
device_id?: string
start_at?: string
start_time?: string
finish_at?: string
finish_time?: string
review_start_time?: string
review_finish_time?: string
created_at?: string
create_time?: string
update_time?: string
[key: string]: unknown
}
/** order.wave.wavePickTaskList 业务 data:list + 扁平分页字段 */
export type WavePickTaskListResponse = {
list: Array<Record<string, unknown>>
total?: number
page?: number
page_size?: number
list: WavePickTaskListItem[]
total: number
page: number
page_size: number
}
export type WavePickTaskListApiResponse = WavePickTaskListResponse & {
code?: number
message?: string
data?: Partial<WavePickTaskListResponse> & {
pagination?: {
total?: number
page?: number
pageSize?: number
page_size?: number
}
}
}
/** 解析 order.wave.wavePickTaskList 响应(优先 data.{ list, total, page, page_size }) */
export function unwrapWavePickTaskListResponse(
res: WavePickTaskListApiResponse | null | undefined,
fallbacks?: { page?: number; page_size?: number }
): WavePickTaskListResponse {
const payload =
res?.data !== undefined && res?.data !== null && typeof res.data === 'object' && !Array.isArray(res.data)
? res.data
: res
const pagination =
payload && typeof payload === 'object' && payload.pagination && typeof payload.pagination === 'object'
? payload.pagination
: undefined
const list = Array.isArray(payload?.list)
? payload.list
: Array.isArray(res?.list)
? res.list
: []
const total = Number(payload?.total ?? pagination?.total ?? res?.total ?? 0)
const page = Number(payload?.page ?? pagination?.page ?? res?.page ?? fallbacks?.page ?? 1)
const page_size = Number(
payload?.page_size ?? pagination?.page_size ?? pagination?.pageSize ?? res?.page_size ?? fallbacks?.page_size ?? 20
)
return {
list,
total: Number.isFinite(total) ? total : 0,
page: Number.isFinite(page) && page > 0 ? page : (fallbacks?.page ?? 1),
page_size: Number.isFinite(page_size) && page_size > 0 ? page_size : (fallbacks?.page_size ?? 20)
}
}
export type WavePickTaskCancelParams = {
@ -584,7 +670,7 @@ export type WaveBatchRemoveOrdersResponse = {
export function orderWaveWavePickTaskList(
data: WavePickTaskListParams
): Promise<WavePickTaskListResponse & { code?: number; message?: string; data?: Partial<WavePickTaskListResponse> }> {
): Promise<WavePickTaskListApiResponse> {
return request({
url: '/system',
method: 'post',

View File

@ -27,8 +27,6 @@ export type WaveBatchListWhere = {
storage_assignment_status?: string
/** 0 普通波次,1 管理后台策略任务,2 PDA 策略任务 */
source?: number
/** 英文枚举:unsynced | partially_synced | synced */
sync_assignment_status?: 'unsynced' | 'partially_synced' | 'synced'
/** 英文枚举:unreviewed | partially_reviewed | reviewed */
review_assignment_status?: 'unreviewed' | 'partially_reviewed' | 'reviewed'
}
@ -54,13 +52,17 @@ export type WaveListPagination = {
}
export type WaveBatchListItem = Record<string, unknown> & {
wave_id?: number | string
wave_no?: string
wave_type?: number
wave_status?: number
order_count?: number
processed_orders?: number
storage_assignment_status?: string
express_assignment_status?: string
print_assignment_status?: string
/** 0 普通波次,1 管理后台策略任务,2 PDA 策略任务 */
source?: number
sync_assignment_status?: string
review_assignment_status?: string
unreviewed_order_count?: number
}
@ -70,10 +72,66 @@ export type WaveBatchListResponse = {
pagination: WaveListPagination
}
export type WaveBatchListApiResponse = WaveBatchListResponse & {
code?: number
message?: string
data?: Partial<WaveBatchListResponse> & {
total?: number
page?: number
page_size?: number
}
}
/** 解析 order.wave.batchList 响应(优先 data.{ list, pagination }) */
export function unwrapWaveBatchListResponse(
res: WaveBatchListApiResponse | null | undefined,
fallbacks?: { page?: number; pageSize?: number }
): WaveBatchListResponse {
const payload =
res?.data !== undefined && res?.data !== null && typeof res.data === 'object' && !Array.isArray(res.data)
? res.data
: res
const list = Array.isArray(payload?.list)
? payload.list
: Array.isArray(res?.list)
? res.list
: []
const paginationObj =
payload?.pagination && typeof payload.pagination === 'object' ? payload.pagination : undefined
const payloadRecord = (payload && typeof payload === 'object' ? payload : {}) as Record<string, unknown>
const resRecord = (res && typeof res === 'object' ? res : {}) as Record<string, unknown>
const page = Number(paginationObj?.page ?? payloadRecord.page ?? resRecord.page ?? fallbacks?.page ?? 1)
const pageSize = Number(
paginationObj?.pageSize ??
(paginationObj as Record<string, unknown> | undefined)?.page_size ??
payloadRecord.page_size ??
resRecord.page_size ??
fallbacks?.pageSize ??
20
)
const total = Number(paginationObj?.total ?? payloadRecord.total ?? resRecord.total ?? 0)
return {
list: list as WaveBatchListItem[],
pagination: {
page: Number.isFinite(page) && page > 0 ? page : (fallbacks?.page ?? 1),
pageSize: Number.isFinite(pageSize) && pageSize > 0 ? pageSize : (fallbacks?.pageSize ?? 20),
total: Number.isFinite(total) ? total : 0,
totalPages: paginationObj?.totalPages,
hasPrevious: paginationObj?.hasPrevious,
hasNext: paginationObj?.hasNext
}
}
}
/** 文档模块 `order` 中的 `order.wave.batchList` */
export function orderModuleWaveBatchList(
data: WaveBatchListParams = {}
): Promise<WaveBatchListResponse & { code?: number; message?: string; data?: Partial<WaveBatchListResponse> }> {
): Promise<WaveBatchListApiResponse> {
return request({
url: '/system',
method: 'post',
@ -90,6 +148,38 @@ export function orderModuleWaveBatchList(
/** 与 orderModuleWaveBatchList 同义,便于业务侧按 method 语义引用 */
export const orderWaveBatchList = orderModuleWaveBatchList
export const orderModule = {
waveBatchList: orderModuleWaveBatchList
export type PendingOrderDownloadCreateTemplateData = {
base64: string
filename: string
mime: string
}
export type PendingOrderDownloadCreateTemplateResponse = {
code?: number
flag?: string
message?: string
base64?: string
filename?: string
mime?: string
data?: Partial<PendingOrderDownloadCreateTemplateData>
}
/** 文档模块 `order` 中的 `order.pendingOrder.downloadCreateTemplate` */
export function orderModulePendingOrderDownloadCreateTemplate(): Promise<PendingOrderDownloadCreateTemplateResponse> {
return request({
url: '/system',
method: 'post',
params: {
method: 'order.pendingOrder.downloadCreateTemplate',
v,
timestamp: new Date().getTime()
},
data: {},
isSystemApi: true
} as any)
}
export const orderModule = {
waveBatchList: orderModuleWaveBatchList,
pendingOrderDownloadCreateTemplate: orderModulePendingOrderDownloadCreateTemplate
}

View File

@ -125,8 +125,8 @@ async function loadData(page = 1) {
loading.value = true
pagination.page = page
try {
const keyword = String(keyword.value || '').trim()
const res: any = await indexApi.searchSpace({ keyword, page, pageSize: pagination.pageSize })
const searchKeyword = String(keyword.value || '').trim()
const res: any = await indexApi.searchSpace({ keyword: searchKeyword, page, pageSize: pagination.pageSize })
const data = res && (res.data || res.list || res)
const rawList = Array.isArray(data?.list) ? data.list : Array.isArray(data) ? data : []
list.value = rawList.map((item: any) => ({

View File

@ -403,7 +403,19 @@ const props = defineProps({
rowClassName: {
type: [String, Function],
default: '',
}
},
virtualThreshold: {
type: Number,
default: 80,
},
virtualMaxVisibleRows: {
type: Number,
default: 0,
},
virtualBufferRows: {
type: Number,
default: 12,
},
})
const emit = defineEmits([
@ -471,8 +483,6 @@ const bodyScrollEl = ref<HTMLElement | null>(null)
const columnConfigListRef = ref<HTMLElement | null>(null)
const virtualScrollTop = ref(0)
const virtualViewportHeight = ref(0)
const virtualBufferRows = 12
const virtualThreshold = 80
const dragAutoScrollStep = ref(0)
let dragAutoScrollRaf: number | null = null
@ -608,17 +618,23 @@ const virtualRowHeight = computed(() => {
})
const shouldUseVirtual = computed(() => {
return props.data.length >= virtualThreshold
return props.data.length >= props.virtualThreshold
})
const virtualVisibleCount = computed(() => {
if (!virtualViewportHeight.value) return props.pagination.pageSize || 20
return Math.ceil(virtualViewportHeight.value / virtualRowHeight.value) + virtualBufferRows * 2
const bufferRows = props.virtualBufferRows
const viewportCount = virtualViewportHeight.value
? Math.ceil(virtualViewportHeight.value / virtualRowHeight.value) + bufferRows * 2
: (props.pagination.pageSize || 20)
if (props.virtualMaxVisibleRows > 0) {
return Math.min(props.virtualMaxVisibleRows, viewportCount)
}
return viewportCount
})
const virtualStartIndex = computed(() => {
if (!shouldUseVirtual.value) return 0
return Math.max(0, Math.floor(virtualScrollTop.value / virtualRowHeight.value) - virtualBufferRows)
return Math.max(0, Math.floor(virtualScrollTop.value / virtualRowHeight.value) - props.virtualBufferRows)
})
const virtualEndIndex = computed(() => {

View File

@ -2,81 +2,26 @@
<div class="pending-order-detail" v-loading="loading">
<div v-if="!row?.id" class="empty-tip">请从上方列表中选择一项查看订单明细</div>
<template v-else-if="detail">
<div class="section">
<div class="section-title">基础信息</div>
<el-descriptions :column="4" border size="small">
<el-descriptions-item label="发货单号">{{ detail.delivery_order_code || '-' }}</el-descriptions-item>
<el-descriptions-item label="店铺名称">{{ detail.shop_nick || '-' }}</el-descriptions-item>
<!-- <el-descriptions-item label="来源平台">{{ detail.source_platform_name || '-' }}</el-descriptions-item> -->
<el-descriptions-item label="买家昵称">{{ detail.buyer_nick || '-' }}</el-descriptions-item>
<el-descriptions-item label="订单状态">
<el-tag :type="getTagType('status', detail.status)" size="small">
{{ translateOrderField('status', detail.status) }}
</el-tag>
<div v-for="section in pendingOrderDetailSections" :key="section.title" class="section">
<div class="section-title">{{ section.title }}</div>
<el-descriptions :column="section.column || 3" border size="small">
<el-descriptions-item
v-for="field in section.fields"
:key="field.prop"
:label="field.label"
:span="field.span || 1"
>
<template v-if="field.tag">
<el-tag :type="getTagType(field.prop, getFieldRawValue(field.prop))" size="small">
{{ displayFieldValue(field) }}
</el-tag>
</template>
<template v-else>
{{ displayFieldValue(field) }}
</template>
</el-descriptions-item>
<el-descriptions-item label="同步状态">
<el-tag :type="getTagType('sync_status', detail.sync_status)" size="small">
{{ translateOrderField('sync_status', detail.sync_status) }}
</el-tag>
</el-descriptions-item>
<el-descriptions-item label="复核">
<el-tag :type="getTagType('recheck_status', resolveOrderRecheckStatus(detail))" size="small">
{{ translateOrderField('recheck_status', resolveOrderRecheckStatus(detail)) }}
</el-tag>
</el-descriptions-item>
<el-descriptions-item label="分配状态">
<el-tag :type="getTagType('storage_status', detail.storage_status)" size="small">
{{ translateOrderField('storage_status', detail.storage_status) }}
</el-tag>
</el-descriptions-item>
<el-descriptions-item label="快递状态">
<el-tag :type="getTagType('post_status', detail.post_status)" size="small">
{{ translateOrderField('post_status', detail.post_status) }}
</el-tag>
</el-descriptions-item>
<el-descriptions-item label="拣货状态">
<el-tag :type="getTagType('pick_status', detail.pick_status)" size="small">
{{ translateOrderField('pick_status', detail.pick_status) }}
</el-tag>
</el-descriptions-item>
<el-descriptions-item label="打包状态">
<el-tag :type="getTagType('pack_status', detail.pack_status)" size="small">
{{ translateOrderField('pack_status', detail.pack_status) }}
</el-tag>
</el-descriptions-item>
<el-descriptions-item label="下单时间">{{ formatTime(detail.place_order_time) }}</el-descriptions-item>
<el-descriptions-item label="支付时间">{{ formatTime(detail.pay_time) }}</el-descriptions-item>
</el-descriptions>
</div>
<div class="section">
<div class="section-title">收货与物流</div>
<el-descriptions :column="3" border size="small">
<el-descriptions-item label="收货人">{{ detail.name || '-' }}</el-descriptions-item>
<el-descriptions-item label="手机号">{{ detail.mobile || '-' }}</el-descriptions-item>
<el-descriptions-item label="固定电话">{{ detail.tel || '-' }}</el-descriptions-item>
<el-descriptions-item label="物流公司">{{ detail.logistics_name || '-' }}</el-descriptions-item>
<el-descriptions-item label="快递单号">{{ detail.express_code || '-' }}</el-descriptions-item>
<el-descriptions-item label="邮编">{{ detail.zip_code || '-' }}</el-descriptions-item>
<el-descriptions-item label="省市区" :span="2">{{ formatRegion(detail) }}</el-descriptions-item>
<el-descriptions-item label="详细地址" :span="3">{{ detail.detail_address || '-' }}</el-descriptions-item>
</el-descriptions>
</div>
<div class="section">
<div class="section-title">金额汇总</div>
<el-descriptions :column="4" border size="small">
<el-descriptions-item label="订单总金额">{{ formatAmount(detail.total_amount) }}</el-descriptions-item>
<el-descriptions-item label="商品金额">{{ formatAmount(detail.item_amount) }}</el-descriptions-item>
<el-descriptions-item label="折扣金额">{{ formatAmount(detail.discount_amount) }}</el-descriptions-item>
<el-descriptions-item label="运费">{{ formatAmount(detail.freight) }}</el-descriptions-item>
<el-descriptions-item label="应收金额">{{ formatAmount(detail.ar_amount) }}</el-descriptions-item>
<el-descriptions-item label="实收金额">{{ formatAmount(detail.got_amount) }}</el-descriptions-item>
<el-descriptions-item label="商品种类">{{ detail.items_count ?? '-' }}</el-descriptions-item>
<el-descriptions-item label="商品总数">{{ detail.items_total ?? '-' }}</el-descriptions-item>
</el-descriptions>
</div>
</template>
<div v-else class="empty-tip">未查询到订单明细数据</div>
</div>
@ -86,8 +31,15 @@
import { ref, watch } from 'vue'
import { ElMessage } from 'element-plus'
import { orderPendingOrder } from '@/api/order.pendingorder/orderpendingOrder'
import { getTagType, translateOrderField } from '../config/order-common-config'
import { resolveOrderRecheckStatus } from '../utils/order-index-helpers'
import {
ORDER_DETAIL_TIME_FIELDS,
formatOrderTime,
getTagType,
pendingOrderDetailSections,
translateOrderField,
type OrderDetailFieldConfig
} from '../config/order-common-config'
import { parseOrderDetailPayload, resolveOrderRecheckStatus } from '../utils/order-index-helpers'
const props = defineProps<{
row: Record<string, any> | null
@ -98,21 +50,85 @@ const loading = ref(false)
const detail = ref<Record<string, any> | null>(null)
let latestRequestId = 0
function formatTime(value: unknown) {
if (!value) return '-'
const text = String(value)
return text.replace('T', ' ').replace('.000Z', '')
}
function formatAmount(value: unknown) {
if (value === null || value === undefined || value === '') return '-'
const n = Number(value)
return Number.isFinite(n) ? n.toFixed(2) : String(value)
}
function formatRegion(data: Record<string, any>) {
const parts = [data.province, data.city, data.area].filter(Boolean)
return parts.length ? parts.join(' / ') : '-'
function formatWaybillCodes(value: unknown) {
if (value === undefined || value === null || value === '') return '-'
const normalizeList = (list: unknown[]) =>
list
.map((item) => String(item ?? '').trim())
.filter((item) => item.length > 0)
.join(', ')
if (Array.isArray(value)) {
const text = normalizeList(value)
return text || '-'
}
const text = String(value).trim()
if (!text) return '-'
if (text.startsWith('[') && text.endsWith(']')) {
try {
const parsed = JSON.parse(text)
if (Array.isArray(parsed)) {
const normalized = normalizeList(parsed)
return normalized || '-'
}
} catch {
// 非法 JSON 时回退原文
}
}
return text
}
function getFieldRawValue(prop: string) {
if (!detail.value) return undefined
if (prop === 'recheck_status') {
return resolveOrderRecheckStatus(detail.value)
}
return detail.value[prop]
}
function displayFieldValue(field: OrderDetailFieldConfig) {
const raw = getFieldRawValue(field.prop)
if (raw === undefined || raw === null || raw === '') return '-'
if (field.waybill) {
return formatWaybillCodes(raw)
}
if (field.amount) {
return formatAmount(raw)
}
if (field.time || ORDER_DETAIL_TIME_FIELDS.has(field.prop)) {
return formatOrderTime(raw)
}
if (field.tag) {
return translateOrderField(field.prop, raw)
}
return raw
}
function normalizeDetailPayload(payload: Record<string, any>) {
const orderDetail = payload.order || payload.detail || payload
if (!orderDetail || typeof orderDetail !== 'object') return null
const waybillCodes = payload.waybill_codes ?? orderDetail.waybill_codes
return {
...orderDetail,
recheck_status: resolveOrderRecheckStatus(orderDetail),
waybill_codes: waybillCodes
}
}
async function loadDetail() {
@ -136,8 +152,8 @@ async function loadDetail() {
detail.value = null
return
}
const payload = res?.data || {}
detail.value = payload.order || payload.detail || payload || null
const payload = parseOrderDetailPayload(res)
detail.value = normalizeDetailPayload(payload)
} catch {
if (requestId !== latestRequestId) return
ElMessage.error('获取订单明细失败')

View File

@ -445,12 +445,132 @@ function waybillCodesFormatter(_row: any, _column: any, cellValue: unknown) {
export const ORDER_DETAIL_TIME_FIELDS = new Set([
'place_order_time',
'pay_time',
'delivery_time',
'create_at',
'created_at',
'updated_at',
'operate_time'
'operate_time',
'recheck_time'
])
export type OrderDetailFieldConfig = {
prop: string
label: string
span?: number
tag?: boolean
amount?: boolean
time?: boolean
waybill?: boolean
}
export type OrderDetailSectionConfig = {
title: string
column?: number
fields: OrderDetailFieldConfig[]
}
/** 待处理订单详情分区(对齐 order.pendingOrder.detail 响应字段) */
export const pendingOrderDetailSections: OrderDetailSectionConfig[] = [
{
title: '基础信息',
column: 4,
fields: [
{ prop: 'delivery_order_code', label: '发货单号' },
{ prop: 'pre_delivery_order_code', label: '前置单号' },
{ prop: 'order_type', label: '订单类型' },
{ prop: 'create_channel', label: '创建渠道' },
{ prop: 'order_flag', label: '订单标记', span: 4 },
{ prop: 'sys_platform_name', label: '来源平台' },
{ prop: 'sys_platform_code', label: '平台编码', tag: true },
{ prop: 'source_platform_name', label: '来源平台名' },
{ prop: 'source_order_codes', label: '来源单号' },
{ prop: 'shop_nick', label: '店铺名称' },
{ prop: 'buyer_nick', label: '买家昵称' },
{ prop: 'seller_nick', label: '卖家昵称' },
{ prop: 'store_id', label: '货主ID' },
{ prop: 'warehouse_id', label: '仓库ID' },
{ prop: 'is_urgency', label: '是否紧急', tag: true },
{ prop: 'invoice_flag', label: '发票标记', tag: true },
{ prop: 'pay_no', label: '支付单号' }
]
},
{
title: '流程与状态',
column: 4,
fields: [
{ prop: 'status', label: '订单状态', tag: true },
{ prop: 'step', label: '流程步骤' },
{ prop: 'sync_status', label: '同步状态', tag: true },
{ prop: 'inspection_status', label: '审核状态', tag: true },
{ prop: 'recheck_status', label: '复核状态', tag: true },
{ prop: 'outbound_status', label: '出库状态', tag: true },
{ prop: 'storage_status', label: '分配状态', tag: true },
{ prop: 'post_status', label: '快递状态', tag: true },
{ prop: 'pick_status', label: '拣货状态', tag: true },
{ prop: 'pack_status', label: '打包状态', tag: true },
{ prop: 'print_status', label: '打印状态', tag: true },
{ prop: 'sended_status', label: '发货状态', tag: true },
{ prop: 'claim_status', label: '认领状态', tag: true },
{ prop: 'lock_status', label: '锁定状态', tag: true },
{ prop: 'intercept_status', label: '拦截状态', tag: true },
{ prop: 'wave_no', label: '波次号' },
{ prop: 'wave_id', label: '波次ID' }
]
},
{
title: '收货与物流',
column: 3,
fields: [
{ prop: 'name', label: '收货人' },
{ prop: 'mobile', label: '手机号' },
{ prop: 'tel', label: '固定电话' },
{ prop: 'email', label: '邮箱' },
{ prop: 'province', label: '省份' },
{ prop: 'city', label: '城市' },
{ prop: 'area', label: '区/县' },
{ prop: 'town', label: '镇/街道' },
{ prop: 'zip_code', label: '邮编' },
{ prop: 'detail_address', label: '详细地址', span: 3 },
{ prop: 'logistics_name', label: '物流公司' },
{ prop: 'logistics_code', label: '快递编码' },
{ prop: 'express_code', label: '快递单号' },
{ prop: 'waybill_codes', label: '运单号', span: 3, waybill: true },
{ prop: 'delivery_type', label: '发货服务类型' },
{ prop: 'weight_type', label: '重量类型' }
]
},
{
title: '金额汇总',
column: 4,
fields: [
{ prop: 'total_amount', label: '订单总金额', amount: true },
{ prop: 'item_amount', label: '商品金额', amount: true },
{ prop: 'discount_amount', label: '折扣金额', amount: true },
{ prop: 'freight', label: '运费', amount: true },
{ prop: 'ar_amount', label: '应收金额', amount: true },
{ prop: 'got_amount', label: '实收金额', amount: true },
{ prop: 'service_fee', label: '服务费', amount: true },
{ prop: 'items_count', label: '商品种类' },
{ prop: 'items_total', label: '商品总数' },
{ prop: 'items_weight', label: '总重量' }
]
},
{
title: '时间信息',
column: 4,
fields: [
{ prop: 'place_order_time', label: '下单时间', time: true },
{ prop: 'pay_time', label: '支付时间', time: true },
{ prop: 'delivery_time', label: '配送时间', time: true },
{ prop: 'create_at', label: '创建时间', time: true },
{ prop: 'updated_at', label: '更新时间', time: true },
{ prop: 'recheck_time', label: '复核时间', time: true },
{ prop: 'operator_name', label: '操作人' },
{ prop: 'operate_time', label: '操作时间', time: true }
]
}
]
/**
* 仅列表基础能力:刷新 / 导出 / 字段设置 / 详情开关。

View File

@ -128,12 +128,6 @@
</el-tag>
</template>
<template #column-sync_assignment_status="{ row }">
<el-tag size="small" :type="getWaveAssignmentAggregateTagType(row.sync_assignment_status)">
{{ formatWaveSyncAssignmentStatusLabel(row.sync_assignment_status) }}
</el-tag>
</template>
<template #column-review_assignment_status="{ row }">
<el-tag size="small" :type="getWaveAssignmentAggregateTagType(row.review_assignment_status)">
{{ formatWaveReviewAssignmentStatusLabel(row.review_assignment_status) }}
@ -876,7 +870,6 @@ import {
unwrapWavePlatformPrintPayload,
formatWaveExpressAssignmentStatusLabel,
formatWavePrintAssignmentStatusLabel,
formatWaveSyncAssignmentStatusLabel,
formatWaveReviewAssignmentStatusLabel,
getWaveAssignmentAggregateTagType
} from './config/wave-config'
@ -920,8 +913,7 @@ import {
orderWaveFetchTaskProgress,
orderWaveGroupOrderFetchList
} from '@/api/order.wave/orderwave'
import { orderWaveBatchList } from '@/api/order/order'
import type { WaveBatchListResponse } from '@/api/order/order'
import { orderWaveBatchList, unwrapWaveBatchListResponse } from '@/api/order/order'
import type {
WaveBatchAutoGroupingResponse,
WaveBatchAllocateExpressTaskProgressResponse,
@ -1429,17 +1421,15 @@ async function loadData() {
},
...(onlyTodoWaves.value ? { only_todo: 1 } : {}),
where
}) as WaveBatchListResponse & { code?: number; message?: string; data?: Partial<WaveBatchListResponse> }
})
if (!res || !okCode(res.code)) {
throw new Error(res?.message || '获取波次列表失败')
}
const responseList = Array.isArray(res.list)
? res.list
: Array.isArray(res.data?.list)
? res.data.list
: []
const responsePagination = res.pagination || res.data?.pagination || {}
const { list: responseList, pagination: responsePagination } = unwrapWaveBatchListResponse(res, {
page: pagination.currentPage,
pageSize: pagination.pageSize
})
list.value = responseList
pagination.currentPage = responsePagination.page || pagination.currentPage

View File

@ -128,12 +128,6 @@
</el-tag>
</template>
<template #column-sync_assignment_status="{ row }">
<el-tag size="small" :type="getWaveAssignmentAggregateTagType(row.sync_assignment_status)">
{{ formatWaveSyncAssignmentStatusLabel(row.sync_assignment_status) }}
</el-tag>
</template>
<template #column-review_assignment_status="{ row }">
<el-tag size="small" :type="getWaveAssignmentAggregateTagType(row.review_assignment_status)">
{{ formatWaveReviewAssignmentStatusLabel(row.review_assignment_status) }}
@ -469,7 +463,6 @@ import {
unwrapWavePlatformPrintPayload,
formatWaveExpressAssignmentStatusLabel,
formatWavePrintAssignmentStatusLabel,
formatWaveSyncAssignmentStatusLabel,
formatWaveReviewAssignmentStatusLabel,
getWaveAssignmentAggregateTagType
} from './config/wave-config'
@ -504,8 +497,7 @@ import {
orderWaveSingleOrderFetchList,
orderWaveFetchTaskProgress
} from '@/api/order.wave/orderwave'
import { orderWaveBatchList } from '@/api/order/order'
import type { WaveBatchListResponse } from '@/api/order/order'
import { orderWaveBatchList, unwrapWaveBatchListResponse } from '@/api/order/order'
import type {
WaveBatchAutoGroupingResponse,
WaveBatchAllocateExpressTaskProgressResponse,
@ -860,17 +852,15 @@ async function loadData() {
},
...(onlyTodoWaves.value ? { only_todo: 1 } : {}),
where
}) as WaveBatchListResponse & { code?: number; message?: string; data?: Partial<WaveBatchListResponse> }
})
if (!res || !okCode(res.code)) {
throw new Error(res?.message || '获取波次列表失败')
}
const responseList = Array.isArray(res.list)
? res.list
: Array.isArray(res.data?.list)
? res.data.list
: []
const responsePagination = res.pagination || res.data?.pagination || {}
const { list: responseList, pagination: responsePagination } = unwrapWaveBatchListResponse(res, {
page: pagination.currentPage,
pageSize: pagination.pageSize
})
list.value = responseList
pagination.currentPage = responsePagination.page || pagination.currentPage

View File

@ -161,7 +161,7 @@
取消本人任务
</el-button> -->
<el-button
v-if="!isPickTaskCancelled(row)"
v-if="!isPickTaskCancelled(row) && !isPickTaskPickFinished(row)"
type="danger"
link
:loading="cancelingTaskId === getTaskId(row)"
@ -311,7 +311,9 @@ import { useUserStore } from '@/stores/modules/user'
import {
orderWaveWavePickTaskCancel,
orderWaveWavePickTaskCancelSelf,
orderWaveWavePickTaskList
orderWaveWavePickTaskList,
unwrapWavePickTaskListResponse,
type WavePickTaskListItem
} from '@/api/order.wave/orderwave'
import { pickWavePickTaskDetail } from '@/api/pick/pick'
import {
@ -611,7 +613,7 @@ function toNumber(value: unknown, fallback = 0): number {
return Number.isFinite(num) ? num : fallback
}
function normalizePickTaskRow(row: Record<string, any>) {
function normalizePickTaskRow(row: WavePickTaskListItem) {
return {
...row,
raw: row,
@ -624,13 +626,20 @@ function normalizePickTaskRow(row: Record<string, any>) {
wave_count: toNumber(row.wave_count),
order_count: toNumber(row.order_count),
box_count: toNumber(row.box_count),
/** 任务创建/操作人(与 pick_user_id 区分;接口 wavePickTaskCancelSelf 按创建人校验) */
operator_id: row.operator_id,
operator_name: row.operator_name || '',
/** 任务创建/操作人(与 pick_user_id 区分;wavePickTaskCancelSelf 按创建人校验) */
operator_id: row.operator_id ?? row.creator_id ?? row.created_by,
operator_name: row.operator_name || row.creator_name || '',
pick_user_id: row.pick_user_id,
pick_user_name: row.pick_user_name || '',
review_user_id: row.review_user_id,
review_user_name: row.review_user_name || '',
current_cart_id: row.current_cart_id,
current_cart_code_snapshot: row.current_cart_code_snapshot || '',
device_id: row.device_id || '',
start_at: row.start_at || row.start_time || '',
finish_at: row.finish_at || row.finish_time || '',
review_start_time: row.review_start_time || '',
review_finish_time: row.review_finish_time || '',
created_at: row.created_at || row.create_time || '',
update_time: row.update_time || ''
}
@ -690,6 +699,11 @@ function isPickTaskCancelled(row: Record<string, any>): boolean {
return Number(row.status) === 9
}
/** 后端 status=2 表示拣货完成(待复核),不再展示取消任务 */
function isPickTaskPickFinished(row: Record<string, any>): boolean {
return Number(row.status) === 2
}
function resetTaskDetailState() {
taskDetailPayload.value = null
taskDetailLoading.value = false
@ -846,21 +860,16 @@ async function loadData() {
throw new Error(res?.message || '获取拣货任务列表失败')
}
const responseList = Array.isArray(res.list)
? res.list
: Array.isArray(res.data?.list)
? res.data.list
: []
const { list: responseList, total, page, page_size: responsePageSize } = unwrapWavePickTaskListResponse(res, {
page: pagination.currentPage,
page_size: pagination.pageSize
})
const responseTotal = Number(res.total ?? res.data?.total ?? 0)
const responsePage = Number(res.page ?? res.data?.page ?? pagination.currentPage)
const responsePageSize = Number(res.page_size ?? res.data?.page_size ?? pagination.pageSize)
list.value = responseList.map((item) => normalizePickTaskRow(item as Record<string, any>))
list.value = responseList.map((item) => normalizePickTaskRow(item))
selectedTaskRows.value = []
pagination.total = Number.isFinite(responseTotal) ? responseTotal : 0
pagination.currentPage = Number.isFinite(responsePage) && responsePage > 0 ? responsePage : pagination.currentPage
pagination.pageSize = Number.isFinite(responsePageSize) && responsePageSize > 0 ? responsePageSize : pagination.pageSize
pagination.total = total
pagination.currentPage = page
pagination.pageSize = responsePageSize
emptyText.value = pickTaskWaveListDefaults.emptyText
} catch (error: any) {
console.error('load wave pick task list failed:', error)

View File

@ -24,7 +24,6 @@
<el-descriptions-item label="库位分配状态">{{ getStorageAssignmentStatusText(row) }}</el-descriptions-item>
<el-descriptions-item label="快递分配状态">{{ formatWaveExpressAssignmentStatusLabel(row.express_assignment_status) }}</el-descriptions-item>
<el-descriptions-item label="打印分配状态">{{ formatWavePrintAssignmentStatusLabel(row.print_assignment_status) }}</el-descriptions-item>
<el-descriptions-item label="同步状态">{{ formatWaveSyncAssignmentStatusLabel(row.sync_assignment_status) }}</el-descriptions-item>
<el-descriptions-item label="复核状态">{{ formatWaveReviewAssignmentStatusLabel(row.review_assignment_status) }}</el-descriptions-item>
<el-descriptions-item label="未复核订单数">{{ row.unreviewed_order_count ?? '—' }}</el-descriptions-item>
<el-descriptions-item label="库位分配异常" :span="3">{{ getStorageAssignmentError(row) }}</el-descriptions-item>
@ -54,7 +53,6 @@ import {
waveTypeTextMap,
formatWaveExpressAssignmentStatusLabel,
formatWavePrintAssignmentStatusLabel,
formatWaveSyncAssignmentStatusLabel,
formatWaveReviewAssignmentStatusLabel
} from '../config/wave-config'

View File

@ -72,11 +72,6 @@ export const waveAvailableFields = [
{ label: '部分打印', value: 'partially_printed' },
{ label: '已打印', value: 'printed' },
]},
{ label: '同步状态', value: 'sync_assignment_status', type: 'select', options: [
{ label: '未同步', value: 'unsynced' },
{ label: '部分同步', value: 'partially_synced' },
{ label: '已同步', value: 'synced' },
]},
{ label: '复核状态', value: 'review_assignment_status', type: 'select', options: [
{ label: '未复核', value: 'unreviewed' },
{ label: '部分复核', value: 'partially_reviewed' },
@ -206,7 +201,6 @@ export const waveBatchColumns = [
{ prop: 'storage_assignment_status', label: '库位分配', minWidth: 120 },
{ prop: 'express_assignment_status', label: '快递分配', minWidth: 120 },
{ prop: 'print_assignment_status', label: '打印状态', minWidth: 110 },
{ prop: 'sync_assignment_status', label: '同步状态', minWidth: 110 },
{ prop: 'review_assignment_status', label: '复核状态', minWidth: 110 },
{ prop: 'unreviewed_order_count', label: '未复核数', minWidth: 96, align: 'right' },
{ prop: 'logistics_name', label: '快递', minWidth: 120 },
@ -234,7 +228,6 @@ export const waveWhereAllowedFieldList = [
'storage_assignment_status',
'express_assignment_status',
'print_assignment_status',
'sync_assignment_status',
'review_assignment_status',
'total_orders_min',
'total_orders_max',
@ -264,15 +257,6 @@ const wavePrintAssignmentStatusLabelMap: Record<string, string> = {
已打印: '已打印'
}
const waveSyncAssignmentStatusLabelMap: Record<string, string> = {
unsynced: '未同步',
partially_synced: '部分同步',
synced: '已同步',
未同步: '未同步',
部分同步: '部分同步',
已同步: '已同步'
}
const waveReviewAssignmentStatusLabelMap: Record<string, string> = {
unreviewed: '未复核',
partially_reviewed: '部分复核',
@ -294,12 +278,6 @@ export function formatWavePrintAssignmentStatusLabel(value: string | number | nu
return wavePrintAssignmentStatusLabelMap[key] ?? wavePrintAssignmentStatusLabelMap[key.toLowerCase()] ?? key
}
export function formatWaveSyncAssignmentStatusLabel(value: string | number | null | undefined): string {
if (value === undefined || value === null || value === '') return '—'
const key = String(value).trim()
return waveSyncAssignmentStatusLabelMap[key] ?? waveSyncAssignmentStatusLabelMap[key.toLowerCase()] ?? key
}
export function formatWaveReviewAssignmentStatusLabel(value: string | number | null | undefined): string {
if (value === undefined || value === null || value === '') return '—'
const key = String(value).trim()
@ -727,6 +705,15 @@ export const pickTaskWaveToolbarButtons: PickTaskWaveToolbarButton[] = [
]
/** 拣货任务 status 枚举(与 wavePickTaskList / wavePickTaskCancel 文档一致) */
export const pickTaskStatusFilterOptions = [
{ label: '待开始', value: 0 },
{ label: '拣货中', value: 1 },
{ label: '拣货完成', value: 2 },
{ label: '已完成', value: 3 },
{ label: '已取消', value: 9 }
] as const
/** 左侧筛选字段(与 order.wave.wavePickTaskList 入参对应) */
export const pickTaskWaveAvailableFields = [
{ label: '任务编号', value: 'task_no', type: 'text' },
@ -735,13 +722,7 @@ export const pickTaskWaveAvailableFields = [
label: '任务状态',
value: 'status',
type: 'multiple',
options: [
{ label: '待开始', value: 0 },
{ label: '拣货中', value: 1 },
{ label: '待复核', value: 2 },
{ label: '已完成', value: 3 },
{ label: '已取消', value: 9 }
]
options: [...pickTaskStatusFilterOptions]
},
{
label: '复核状态',
@ -805,7 +786,7 @@ export function formatPickTaskStatus(value: unknown): string {
const num = Number(value)
if (num === 0) return '待开始'
if (num === 1) return '拣货中'
if (num === 2) return '待复核'
if (num === 2) return '拣货完成'
if (num === 3) return '已完成'
if (num === 9) return '已取消'
return value === null || value === undefined || value === '' ? '-' : String(value)
@ -843,7 +824,7 @@ export function getPickTaskStatusTagType(value: unknown): 'info' | 'warning' | '
const num = Number(value)
if (num === 0) return 'info'
if (num === 1) return 'warning'
if (num === 2) return 'danger'
if (num === 2) return 'success'
if (num === 3) return 'success'
if (num === 9) return 'info'
return 'info'

View File

@ -8,91 +8,159 @@
"message": "登录成功",
"success": true,
"data": {
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MywidXNlcm5hbWUiOiJ5am0iLCJyZWFsX25hbWUiOiJ5aW4iLCJwbGF0Zm9ybV9jb2RlIjoid2ViIiwiY3VycmVudF9yb2xlX2lkIjozMSwiY3VycmVudF9zdG9yZV9pZCI6MTAwMDAwLCJpYXQiOjE3ODA3MzE1ODQsImV4cCI6MTc4MDc0NTk4NH0.JRJhsyNjcXVEdNdggZ-cSuvvHjyuudQpDVGtkfMjJvU"
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MywidXNlcm5hbWUiOiJ5am0iLCJyZWFsX25hbWUiOiJ5aW4iLCJwbGF0Zm9ybV9jb2RlIjoid2ViIiwiY3VycmVudF9yb2xlX2lkIjozNCwiY3VycmVudF9zdG9yZV9pZCI6MTAwMDAyOCwiaWF0IjoxNzgwODE1MTIyLCJleHAiOjE3ODA4Mjk1MjJ9.tFoP8P0V3mNIbt1N4d4r42-PCmaSaHBkL0XvwwqkGRc"
},
"timestamp": 1780731584
"timestamp": 1780815122
}
},
{
"接口": "setting.expressInterface.listByWarehousePlatformCode",
"接口": "order.pendingOrder.detail",
"data": {
"flag": "success",
"code": 200,
"code": 1,
"message": "ok",
"data": [
{
"id": 11,
"name": "京东-顺丰",
"express_code": "SF",
"platform_code": "JD",
"sys_express_code": "SF",
"warehouse_id": 100000,
"shop_id": 17,
"platform_shop_id": 467,
"template_id": 10000112,
"paymode": null,
"brandno": "default",
"providertype": null,
"providerid": 467,
"sender_name": "夏天",
"sender_tel": "19124370861",
"weight": 1,
"token": "b43d2af4c55a47aab9808bbe45149ee3",
"viewer": null,
"client_id": null,
"is_share": 0,
"share_id": null,
"can_use_count": 0,
"province_name": "广东省",
"city_name": "广州市",
"district_name": null,
"site_code": null,
"product_type": "202",
"data": {
"detail": {
"id": 14,
"delivery_order_code": "SYS17806913188626929",
"pre_delivery_order_code": "",
"pre_delivery_order_id": "",
"order_type": "",
"warehouse_code": null,
"order_flag": "订单快递分配失败: 当前订单平台【淘宝】,快递【顺丰速运】,未配置有效的快递接口",
"extend_props": null,
"source_platform_code": "",
"source_platform_name": "",
"create_channel": "MANUAL",
"source_order_codes": "",
"sys_platform_code": "TB",
"sys_platform_name": "淘宝",
"create_at": "2026-06-05T20:28:38.000Z",
"delete_at": null,
"updated_at": "2026-06-05T20:33:37.000Z",
"place_order_time": null,
"pay_time": null,
"pay_no": "",
"service_code": null,
"operator_name": "刘付明仁",
"operate_time": null,
"delivery_time": null,
"shop_nick": null,
"seller_nick": null,
"buyer_nick": null,
"total_amount": "0.00",
"item_amount": "0.00",
"discount_amount": "0.00",
"freight": "0.00",
"ar_amount": "0.00",
"got_amount": "0.00",
"service_fee": null,
"logistics_code": "SF",
"logistics_name": "顺丰速运",
"sys_logistics_code": "SF",
"sys_logistics_name": "顺丰速运",
"basket_number": null,
"express_code": "",
"logistics_area_code": "",
"delivery_type": null,
"weight_type": 0,
"shop_name": "PENDING_801a6591885e2fe1c198026479b56833a925f6888305c1e5",
"address": "广东广州市白云区永平街道友谊路6号嘉禾八一科记园32",
"town_name": null,
"ispickup": 0,
"is_hide_goods": 0,
"shipperno": "0200514533",
"template_url": "https://template-content.jd.com/template-oss?tempCode=sfkd76x130",
"ext_data": null,
"express": {
"code": "SF",
"name": "顺丰速运",
"KS": "SF",
"polyapi_extra_info": {
"isvClientCode": "WYSJF_WDGJ"
"is_urgency": "N",
"invoice_flag": "N",
"status": "pedding",
"name": "三姐",
"zip_code": "",
"tel": "",
"mobile": "13664031333",
"email": "",
"country_code": "",
"province": "内蒙古自治区",
"city": "鄂尔多斯市",
"area": "杭锦旗",
"town": "",
"detail_address": "海昌小区",
"id_type": null,
"id_number": null,
"oaid": null,
"sync_status": "padding",
"store_id": 1000275,
"warehouse_id": 1000028,
"from_key": null,
"items": "",
"items_count": 0,
"items_total": 0,
"items_weight": "0.00",
"items_hash": "",
"items_crc": 0,
"wave_id": 0,
"wave_no": "",
"wave_strategy_version": 0,
"wave_scan_result": 0,
"post_status": "none",
"storage_status": "none",
"pick_status": "none",
"pack_status": "none",
"sended_status": "none",
"inspection_status": "error",
"recheck_status": "none",
"recheck_time": null,
"step": 3,
"print_status": "none",
"claim_status": "none",
"outbound_status": "none",
"lock_status": "none",
"print_lock_status": "none",
"intercept_status": "none"
},
"items": [
{
"id": 1,
"order_id": 14,
"actual_price": "0.00",
"retail_price": "0.00",
"ext_code": "",
"inventory_type": "",
"item_code": "",
"item_id": 156527,
"item_name": "卉语艾草植萃赋活精华乳50ml",
"order_line_no": "1",
"owner_code": "",
"plan_qty": 10,
"source_order_code": "",
"sub_source_order_code": "",
"extend_props": null,
"stock_id": 0,
"item_snapshot": {
"id": 156527,
"width": 0,
"height": 0,
"length": 0,
"volume": 0,
"barcode": "",
"stock_id": null,
"item_code": "",
"item_name": "卉语艾草植萃赋活精华乳50ml",
"item_type": "",
"brand_name": "",
"goods_code": "",
"net_weight": 0,
"stock_unit": "",
"category_id": null,
"gross_weight": 0,
"retail_price": 0,
"sku_property": "",
"category_name": "",
"inventory_type": ""
},
"PDD": "SF",
"DY": "shunfeng",
"CAINIAO": "SF",
"SPH": null,
"XHS": "shunfeng",
"DW": null,
"JD": "SF"
},
"shop": {
"id": 17,
"warehouse_id": 100000,
"platform_code": "JD",
"shop_name": "PENDING_801a6591885e2fe1c198026479b56833a925f6888305c1e5",
"custom_name": "jd测试店铺",
"status": 1,
"auth_expire_at": null,
"auth_random_code": null,
"owner_id": null,
"access_token": "b43d2af4c55a47aab9808bbe45149ee3",
"refresh_token": null,
"token_expires_at": null,
"refresh_token_expires_at": null,
"scope": null,
"created_at": {},
"updated_at": {}
"created_at": "2026-06-05T20:28:38.000Z",
"updated_at": "2026-06-05T20:28:38.000Z",
"createdAt": "2026-06-05T20:28:38.000Z",
"updatedAt": "2026-06-05T20:28:38.000Z",
"images": []
}
}
],
"timestamp": 1780731585
],
"expresses": []
},
"timestamp": 1780815122
}
}
]

View File

@ -1,11 +1,11 @@
# 接口
- 更新时间: 2026-06-05 17:49:24
- 更新时间: 2026-06-07 16:25:23
- 扫描目录: `src\api`
- 模块数: 41
- API 文件数: 41
- 接口数: 338
- 已启用: 304
- 接口数: 340
- 已启用: 305
- 占位接口: 2
## 模块统计
@ -15,7 +15,7 @@
| config | 1 | 1 | 0 | 0 |
| dashboard | 1 | 6 | 6 | 0 |
| index | 1 | 25 | 22 | 1 |
| order | 1 | 1 | 1 | 0 |
| order | 1 | 2 | 2 | 0 |
| order.archiveorder | 1 | 2 | 2 | 0 |
| order.deliveryexpectionorder | 1 | 2 | 2 | 0 |
| order.deliveryorder | 1 | 2 | 2 | 0 |
@ -23,7 +23,7 @@
| order.expectionorder | 1 | 3 | 3 | 0 |
| order.index | 1 | 10 | 9 | 0 |
| order.outboundorder | 1 | 3 | 3 | 0 |
| order.pendingorder | 1 | 17 | 17 | 0 |
| order.pendingorder | 1 | 18 | 17 | 0 |
| order.print | 1 | 3 | 3 | 0 |
| order.recheckorder | 1 | 3 | 2 | 0 |
| order.revieworder | 1 | 3 | 3 | 0 |
@ -90,6 +90,7 @@
| index | searchSpace | index.searchSpace | POST | 是 | 否 | index/index.ts | |
| index | tryAutoTranslateNewKeys | index.tryAutoTranslateNewKeys | POST | 是 | 否 | index/index.ts | |
| index | uploadSuccessNotify | index.uploadSuccessNotify | POST | 是 | 否 | index/index.ts | |
| order | orderModulePendingOrderDownloadCreateTemplate | order.pendingOrder.downloadCreateTemplate | POST | 是 | 否 | order/order.ts | |
| order | orderModuleWaveBatchList | order.wave.batchList | POST | 是 | 否 | order/order.ts | |
| order.archiveorder | orderArchiveOrderDetail | order.archiveOrder.detail | POST | 是 | 否 | order.archiveorder/orderarchiveorder.ts | |
| order.archiveorder | orderArchiveOrderList | order.archiveOrder.list | POST | 是 | 否 | order.archiveorder/orderarchiveorder.ts | |
@ -123,13 +124,14 @@
| order.pendingorder | orderPendingOrderCloneOrder | order.pendingOrder.cloneOrder | POST | 是 | 否 | order.pendingorder/orderpendingOrder.ts | |
| order.pendingorder | orderPendingOrderCreateOrder | order.pendingOrder.createOrder | POST | 是 | 否 | order.pendingorder/orderpendingOrder.ts | |
| order.pendingorder | orderPendingOrderDetail | order.pendingOrder.detail | POST | 是 | 否 | order.pendingorder/orderpendingOrder.ts | |
| order.pendingorder | orderPendingOrderDownloadCreateTemplate | order.pendingOrder.downloadCreateTemplate | POST | 是 | 否 | order.pendingorder/orderpendingOrder.ts | |
| order.pendingorder | orderPendingOrderDownloadCreateTemplate | order.pendingOrder.downloadCreateTemplate | POST | 否 | 否 | order.pendingorder/orderpendingOrder.ts | |
| order.pendingorder | orderPendingOrderImportOrdersFromExcel | order.pendingOrder.importOrdersFromExcel | POST | 是 | 否 | order.pendingorder/orderpendingOrder.ts | |
| order.pendingorder | orderPendingOrderList | order.pendingOrder.list | POST | 是 | 否 | order.pendingorder/orderpendingOrder.ts | |
| order.pendingorder | orderPendingOrderMarkPendingOutboundOrder | order.pendingOrder.markPendingOutboundOrder | POST | 是 | 否 | order.pendingorder/orderpendingOrder.ts | |
| order.pendingorder | orderPendingOrderParseAddress | order.pendingOrder.parseAddress | POST | 是 | 否 | order.pendingorder/orderpendingOrder.ts | |
| order.pendingorder | orderPendingOrderReverseReviewOrder | order.pendingOrder.reverseReviewOrder | POST | 是 | 否 | order.pendingorder/orderpendingOrder.ts | |
| order.pendingorder | orderPendingOrderSyncOrderIds | order.pendingOrder.syncOrderIds | POST | 是 | 否 | order.pendingorder/orderpendingOrder.ts | |
| order.pendingorder | orderPendingOrderUpdateAddress | order.pendingOrder.updateAddress | POST | 是 | 否 | order.pendingorder/orderpendingOrder.ts | |
| order.pendingorder | orderPendingOrderUpdateOrderExpress | order.pendingOrder.updateOrderExpress | POST | 是 | 否 | order.pendingorder/orderpendingOrder.ts | |
| order.pendingorder | orderPendingOrderUpdateOrderPlatform | order.pendingOrder.updateOrderPlatform | POST | 是 | 否 | order.pendingorder/orderpendingOrder.ts | |
| order.print | getWavePlatformPrintData | order.print.getWavePlatformPrintData | POST | 是 | 否 | order.print/orderprint.ts | |

View File

@ -8,9 +8,13 @@
}
},
{
"method": "setting.expressInterface.listByWarehousePlatformCode",
"method": "order.pendingOrder.detail",
"body": {
"platform_code": "JD"
"id": 14,
"ids": [
14
],
"tableType": "order"
}
},
{

View File

@ -26,93 +26,161 @@
"message": "登录成功",
"success": true,
"data": {
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MywidXNlcm5hbWUiOiJ5am0iLCJyZWFsX25hbWUiOiJ5aW4iLCJwbGF0Zm9ybV9jb2RlIjoid2ViIiwiY3VycmVudF9yb2xlX2lkIjozMSwiY3VycmVudF9zdG9yZV9pZCI6MTAwMDAwLCJpYXQiOjE3ODA3MzE1ODQsImV4cCI6MTc4MDc0NTk4NH0.JRJhsyNjcXVEdNdggZ-cSuvvHjyuudQpDVGtkfMjJvU"
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MywidXNlcm5hbWUiOiJ5am0iLCJyZWFsX25hbWUiOiJ5aW4iLCJwbGF0Zm9ybV9jb2RlIjoid2ViIiwiY3VycmVudF9yb2xlX2lkIjozNCwiY3VycmVudF9zdG9yZV9pZCI6MTAwMDAyOCwiaWF0IjoxNzgwODE1MTIyLCJleHAiOjE3ODA4Mjk1MjJ9.tFoP8P0V3mNIbt1N4d4r42-PCmaSaHBkL0XvwwqkGRc"
},
"timestamp": 1780731584
"timestamp": 1780815122
}
},
{
"接口": "setting.expressInterface.listByWarehousePlatformCode",
"接口": "order.pendingOrder.detail",
"message": "ok",
"code": 200,
"code": 1,
"data": {
"flag": "success",
"code": 200,
"code": 1,
"message": "ok",
"data": [
{
"id": 11,
"name": "京东-顺丰",
"express_code": "SF",
"platform_code": "JD",
"sys_express_code": "SF",
"warehouse_id": 100000,
"shop_id": 17,
"platform_shop_id": 467,
"template_id": 10000112,
"paymode": null,
"brandno": "default",
"providertype": null,
"providerid": 467,
"sender_name": "夏天",
"sender_tel": "19124370861",
"weight": 1,
"token": "b43d2af4c55a47aab9808bbe45149ee3",
"viewer": null,
"client_id": null,
"is_share": 0,
"share_id": null,
"can_use_count": 0,
"province_name": "广东省",
"city_name": "广州市",
"district_name": null,
"site_code": null,
"product_type": "202",
"data": {
"detail": {
"id": 14,
"delivery_order_code": "SYS17806913188626929",
"pre_delivery_order_code": "",
"pre_delivery_order_id": "",
"order_type": "",
"warehouse_code": null,
"order_flag": "订单快递分配失败: 当前订单平台【淘宝】,快递【顺丰速运】,未配置有效的快递接口",
"extend_props": null,
"source_platform_code": "",
"source_platform_name": "",
"create_channel": "MANUAL",
"source_order_codes": "",
"sys_platform_code": "TB",
"sys_platform_name": "淘宝",
"create_at": "2026-06-05T20:28:38.000Z",
"delete_at": null,
"updated_at": "2026-06-05T20:33:37.000Z",
"place_order_time": null,
"pay_time": null,
"pay_no": "",
"service_code": null,
"operator_name": "刘付明仁",
"operate_time": null,
"delivery_time": null,
"shop_nick": null,
"seller_nick": null,
"buyer_nick": null,
"total_amount": "0.00",
"item_amount": "0.00",
"discount_amount": "0.00",
"freight": "0.00",
"ar_amount": "0.00",
"got_amount": "0.00",
"service_fee": null,
"logistics_code": "SF",
"logistics_name": "顺丰速运",
"sys_logistics_code": "SF",
"sys_logistics_name": "顺丰速运",
"basket_number": null,
"express_code": "",
"logistics_area_code": "",
"delivery_type": null,
"weight_type": 0,
"shop_name": "PENDING_801a6591885e2fe1c198026479b56833a925f6888305c1e5",
"address": "广东广州市白云区永平街道友谊路6号嘉禾八一科记园32",
"town_name": null,
"ispickup": 0,
"is_hide_goods": 0,
"shipperno": "0200514533",
"template_url": "https://template-content.jd.com/template-oss?tempCode=sfkd76x130",
"ext_data": null,
"express": {
"code": "SF",
"name": "顺丰速运",
"KS": "SF",
"polyapi_extra_info": {
"isvClientCode": "WYSJF_WDGJ"
"is_urgency": "N",
"invoice_flag": "N",
"status": "pedding",
"name": "三姐",
"zip_code": "",
"tel": "",
"mobile": "13664031333",
"email": "",
"country_code": "",
"province": "内蒙古自治区",
"city": "鄂尔多斯市",
"area": "杭锦旗",
"town": "",
"detail_address": "海昌小区",
"id_type": null,
"id_number": null,
"oaid": null,
"sync_status": "padding",
"store_id": 1000275,
"warehouse_id": 1000028,
"from_key": null,
"items": "",
"items_count": 0,
"items_total": 0,
"items_weight": "0.00",
"items_hash": "",
"items_crc": 0,
"wave_id": 0,
"wave_no": "",
"wave_strategy_version": 0,
"wave_scan_result": 0,
"post_status": "none",
"storage_status": "none",
"pick_status": "none",
"pack_status": "none",
"sended_status": "none",
"inspection_status": "error",
"recheck_status": "none",
"recheck_time": null,
"step": 3,
"print_status": "none",
"claim_status": "none",
"outbound_status": "none",
"lock_status": "none",
"print_lock_status": "none",
"intercept_status": "none"
},
"items": [
{
"id": 1,
"order_id": 14,
"actual_price": "0.00",
"retail_price": "0.00",
"ext_code": "",
"inventory_type": "",
"item_code": "",
"item_id": 156527,
"item_name": "卉语艾草植萃赋活精华乳50ml",
"order_line_no": "1",
"owner_code": "",
"plan_qty": 10,
"source_order_code": "",
"sub_source_order_code": "",
"extend_props": null,
"stock_id": 0,
"item_snapshot": {
"id": 156527,
"width": 0,
"height": 0,
"length": 0,
"volume": 0,
"barcode": "",
"stock_id": null,
"item_code": "",
"item_name": "卉语艾草植萃赋活精华乳50ml",
"item_type": "",
"brand_name": "",
"goods_code": "",
"net_weight": 0,
"stock_unit": "",
"category_id": null,
"gross_weight": 0,
"retail_price": 0,
"sku_property": "",
"category_name": "",
"inventory_type": ""
},
"PDD": "SF",
"DY": "shunfeng",
"CAINIAO": "SF",
"SPH": null,
"XHS": "shunfeng",
"DW": null,
"JD": "SF"
},
"shop": {
"id": 17,
"warehouse_id": 100000,
"platform_code": "JD",
"shop_name": "PENDING_801a6591885e2fe1c198026479b56833a925f6888305c1e5",
"custom_name": "jd测试店铺",
"status": 1,
"auth_expire_at": null,
"auth_random_code": null,
"owner_id": null,
"access_token": "b43d2af4c55a47aab9808bbe45149ee3",
"refresh_token": null,
"token_expires_at": null,
"refresh_token_expires_at": null,
"scope": null,
"created_at": {},
"updated_at": {}
"created_at": "2026-06-05T20:28:38.000Z",
"updated_at": "2026-06-05T20:28:38.000Z",
"createdAt": "2026-06-05T20:28:38.000Z",
"updatedAt": "2026-06-05T20:28:38.000Z",
"images": []
}
}
],
"timestamp": 1780731585
],
"expresses": []
},
"timestamp": 1780815122
}
}
]

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {
@ -12,7 +12,7 @@
"label": "全部"
}
},
"totalInterfaceCount": 299,
"totalInterfaceCount": 300,
"changes": {
"summary": {
"moduleAdded": 0,
@ -3297,6 +3297,12 @@
"required": false,
"description": "来源订单号"
},
{
"name": "shop_nick",
"type": "string",
"required": false,
"description": "店铺名称(自定义),最大长度 200"
},
{
"name": "order_type",
"type": "string",
@ -3425,12 +3431,12 @@
]
},
{
"moduleName": "订单待处理模块",
"moduleKey": "order.pendingOrder",
"moduleFolder": "order.pendingorder",
"moduleName": "订单模块",
"moduleKey": "order",
"moduleFolder": "order",
"method": "order.pendingOrder.downloadCreateTemplate",
"title": "下载创建订单的 Excel 导入模板。返回 base64 编码的 xlsx 文件,前端解码后作为附件下载。表头中标注 * 的列为必填项,多行相同订单号的行组成一个完整订单。(已作废)",
"description": "下载创建订单的 Excel 导入模板。返回 base64 编码的 xlsx 文件,前端解码后作为附件下载。表头中标注 * 的列为必填项,多行相同订单号的行组成一个完整订单。(已作废)",
"title": "下载创建订单的 Excel 导入模板。返回 base64 编码的 xlsx 文件,前端解码后作为 .xlsx 附件下载。表头中标注 * 的列为必填项(橙色背景),可选列为灰色背景,包含示例数据行和填写说明工作表。多行相同订单号的行组成一个完整订单,每行代表一条商品明细。模板必填列:订单号(delivery_order_code)、收件人姓名(name)、手机号(mobile)、详细地址(detail_address)、商品编码(item_code)、计划数量(plan_qty);非必填列含:货主ID(store_id)、省份(province)、城市(city)、区/县(area)、店铺名称(shop_nick)等。",
"description": "下载创建订单的 Excel 导入模板。返回 base64 编码的 xlsx 文件,前端解码后作为 .xlsx 附件下载。表头中标注 * 的列为必填项(橙色背景),可选列为灰色背景,包含示例数据行和填写说明工作表。多行相同订单号的行组成一个完整订单,每行代表一条商品明细。模板必填列:订单号(delivery_order_code)、收件人姓名(name)、手机号(mobile)、详细地址(detail_address)、商品编码(item_code)、计划数量(plan_qty);非必填列含:货主ID(store_id)、省份(province)、城市(city)、区/县(area)、店铺名称(shop_nick)等。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
@ -3458,13 +3464,19 @@
"name": "filename",
"type": "string",
"required": true,
"description": "建议保存的文件名"
"description": "建议保存的文件名,固定为 创建订单导入模板.xlsx"
},
{
"name": "mime",
"type": "string",
"required": true,
"description": "文件 MIME 类型"
"description": "文件 MIME 类型,固定为 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
},
{
"name": "shop_nick",
"type": "string",
"required": false,
"description": "模板中新增的店铺名称列(非必填),用于标识订单所属店铺"
}
]
},
@ -3881,6 +3893,105 @@
}
]
},
{
"moduleName": "订单待处理模块",
"moduleKey": "order.pendingOrder",
"moduleFolder": "order.pendingorder",
"method": "order.pendingOrder.updateAddress",
"title": "批量修改待处理订单的收件地址信息。仅允许修改 post_status='none'(未分配快递)的订单;至少需要提供一个地址字段(name/mobile/tel/zip_code/province/city/area/town/detail_address),空值和纯空白会被忽略。更新成功后写入操作日志。",
"description": "批量修改待处理订单的收件地址信息。仅允许修改 post_status='none'(未分配快递)的订单;至少需要提供一个地址字段(name/mobile/tel/zip_code/province/city/area/town/detail_address),空值和纯空白会被忽略。更新成功后写入操作日志。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "ids",
"type": "number[]",
"required": true,
"description": "订单ID 正整数数组,不能为空"
},
{
"name": "name",
"type": "string",
"required": false,
"description": "收件人姓名"
},
{
"name": "mobile",
"type": "string",
"required": false,
"description": "收件人手机号"
},
{
"name": "tel",
"type": "string",
"required": false,
"description": "收件人电话"
},
{
"name": "zip_code",
"type": "string",
"required": false,
"description": "邮编"
},
{
"name": "province",
"type": "string",
"required": false,
"description": "省份"
},
{
"name": "city",
"type": "string",
"required": false,
"description": "城市"
},
{
"name": "area",
"type": "string",
"required": false,
"description": "区/县"
},
{
"name": "town",
"type": "string",
"required": false,
"description": "镇/街道"
},
{
"name": "detail_address",
"type": "string",
"required": false,
"description": "详细地址"
}
],
"response": [
{
"name": "updated_count",
"type": "number",
"required": true,
"description": "实际更新的订单行数"
},
{
"name": "ids",
"type": "number[]",
"required": true,
"description": "请求的订单ID数组(原样返回)"
}
]
},
{
"moduleName": "订单待处理模块",
"moduleKey": "order.pendingOrder",
@ -5409,7 +5520,7 @@
]
},
{
"moduleName": "order.wave",
"moduleName": "订单模块",
"moduleKey": "order",
"moduleFolder": "order",
"method": "order.wave.batchList",
@ -5447,7 +5558,7 @@
"name": "where",
"type": "object",
"required": false,
"description": "筛选白名单字段(object,可选)。仅支持下列字段过滤,且禁止传入 warehouse_id / warehouseId: - wave_id(等值) - wave_no(模糊) - wave_type(等值) - wave_status(等值,接口固定叠加状态 0/1) - creator(模糊) - logistics_name(模糊) - item_part_type(等值) - item_part(模糊) - item_snapshot_key(模糊) - item_detail_machine(模糊) - distinguish_express(等值) - total_orders_min / total_orders_max(范围) - processed_orders_min / processed_orders_max(范围) - express_assignment_status(等值,string,可选,英文枚举,取值:unassigned、partially_assigned、assigned;语义:按快递分配聚合判断,assigned 表示聚合后全部 fin,partially_assigned 表示部分已分配且不含 error,unassigned 表示全 none 或包含 error(异常并入未分配集合))。 - print_assignment_status(等值,string,可选,英文枚举,取值:unprinted、partially_printed、printed;语义:按打印分配聚合判断,printed 表示聚合后全部已打印)。 - storage_assignment_status(等值,string,可选,取值:未分配、部分分配、已分配;默认不传不做限制)。过滤语义:已分配=聚合后全部 fin;部分分配=不含 error,且既不是全 none,也不是全 fin;未分配=全 none 或包含 error(异常并入未分配筛选集合)。说明:返回字段 storage_assignment_status 的展示值保持不变,包含 error 时仍可显示“分配异常”;此处 where 的过滤语义会把异常计入“未分配”,以避免把过滤语义与展示值混淆。 - source(可选,number)来源过滤:0=普通波次(正常后台操作),1=管理后台策略任务,2=PDA策略任务;不传则不过滤。 说明:express_assignment_status 与 print_assignment_status 要求使用英文枚举值;storage_assignment_status 仍向后兼容中文展示值。若传入的枚举值不在允许集合内,接口会返回 400(参数校验失败),并在 message 中说明错误字段与允许取值。 - sync_assignment_status(等值,string,可选,英文枚举,取值:unsynced、partially_synced、synced;语义:按同步状态聚合判断,synced 表示全部 fin,partially_synced 表示部分已同步且不含 error,unsynced 表示全 padding 或包含 error(异常并入未同步集合))。 - review_assignment_status(等值,string,可选,英文枚举:unreviewed、partially_reviewed、reviewed;分别表示未复核、部分复核、已复核)。"
"description": "筛选白名单字段(object,可选)。仅支持下列字段过滤,且禁止传入 warehouse_id / warehouseId: - wave_id(等值) - wave_no(模糊) - wave_type(等值) - wave_status(等值,接口固定叠加状态 0/1) - creator(模糊) - logistics_name(模糊) - item_part_type(等值) - item_part(模糊) - item_snapshot_key(模糊) - item_detail_machine(模糊) - distinguish_express(等值) - total_orders_min / total_orders_max(范围) - processed_orders_min / processed_orders_max(范围) - express_assignment_status(等值,string,可选,英文枚举,取值:unassigned、partially_assigned、assigned;语义:按快递分配聚合判断,assigned 表示聚合后全部 fin,partially_assigned 表示部分已分配且不含 error,unassigned 表示全 none 或包含 error(异常并入未分配集合))。 - print_assignment_status(等值,string,可选,英文枚举,取值:unprinted、partially_printed、printed;语义:按打印分配聚合判断,printed 表示聚合后全部已打印)。 - storage_assignment_status(等值,string,可选,取值:未分配、部分分配、已分配;默认不传不做限制)。过滤语义:已分配=聚合后全部 fin;部分分配=不含 error,且既不是全 none,也不是全 fin;未分配=全 none 或包含 error(异常并入未分配筛选集合)。说明:返回字段 storage_assignment_status 的展示值保持不变,包含 error 时仍可显示“分配异常”;此处 where 的过滤语义会把异常计入“未分配”,以避免把过滤语义与展示值混淆。 - source(可选,number)来源过滤:0=普通波次(正常后台操作),1=管理后台策略任务,2=PDA策略任务;不传则不过滤。 说明:express_assignment_status 与 print_assignment_status 要求使用英文枚举值;storage_assignment_status 仍向后兼容中文展示值。若传入的枚举值不在允许集合内,接口会返回 400(参数校验失败),并在 message 中说明错误字段与允许取值。 - review_assignment_status(等值,string,可选,英文枚举:unreviewed、partially_reviewed、reviewed;分别表示未复核、部分复核、已复核)。"
}
],
"response": [
@ -5455,7 +5566,7 @@
"name": "list",
"type": "array",
"required": true,
"description": "波次列表,包含波次基础信息与状态汇总(order_count / storage_assignment_status / express_assignment_status / print_assignment_status / sync_assignment_status / review_assignment_status / unreviewed_order_count)。每条记录新增字段 source(number):来源标识,0=普通波次(正常后台操作),1=管理后台策略任务,2=PDA策略任务。"
"description": "波次列表,包含波次基础信息与状态汇总(order_count / storage_assignment_status / express_assignment_status / print_assignment_status / review_assignment_status / unreviewed_order_count)。每条记录新增字段 source(number):来源标识,0=普通波次(正常后台操作),1=管理后台策略任务,2=PDA策略任务。"
},
{
"name": "pagination",
@ -6310,8 +6421,8 @@
"moduleKey": "order.wave",
"moduleFolder": "order.wave",
"method": "order.wave.wavePickTaskCancel",
"title": "取消拣货任务(批量),同时释放关联波次(物理删除波次记录,订单回池)、解绑拣货车、写操作日志。入参仅支持 task_ids(数组,必填),不再支持单个 task_id。操作人与仓库从请求上下文获取(例如当前登录用户上下文 ctx.user),若上下文缺失接口将返回错误。",
"description": "取消拣货任务(批量),同时释放关联波次(物理删除波次记录,订单回池)、解绑拣货车、写操作日志。入参仅支持 task_ids(数组,必填),不再支持单个 task_id。操作人与仓库从请求上下文获取(例如当前登录用户上下文 ctx.user),若上下文缺失接口将返回错误。",
"title": "取消拣货任务(批量)。可取消的状态:0=待开始、1=拣货中、2=待复核(拣货完成)、3=已完成,状态9(已取消)或其他状态不允许取消。同时释放关联波次(物理删除波次记录,订单回池)、解绑拣货车、写操作日志。对于status=2或3的任务,取消时会自动回退订单拣货状态:wms_wave_pick_task_order.pick_status(1→0)、order_delivery.pick_status(fin→padding)。入参仅支持 task_ids(数组,必填),不再支持单个 task_id。操作人与仓库从请求上下文获取(例如当前登录用户上下文 ctx.user),若上下文缺失接口将返回错误。",
"description": "取消拣货任务(批量)。可取消的状态:0=待开始、1=拣货中、2=待复核(拣货完成)、3=已完成,状态9(已取消)或其他状态不允许取消。同时释放关联波次(物理删除波次记录,订单回池)、解绑拣货车、写操作日志。对于status=2或3的任务,取消时会自动回退订单拣货状态:wms_wave_pick_task_order.pick_status(1→0)、order_delivery.pick_status(fin→padding)。入参仅支持 task_ids(数组,必填),不再支持单个 task_id。操作人与仓库从请求上下文获取(例如当前登录用户上下文 ctx.user),若上下文缺失接口将返回错误。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
@ -6555,19 +6666,19 @@
{
"name": "total",
"type": "number",
"required": false,
"required": true,
"description": "总记录数"
},
{
"name": "page",
"type": "number",
"required": false,
"required": true,
"description": "当前页码"
},
{
"name": "page_size",
"type": "number",
"required": false,
"required": true,
"description": "每页大小"
}
]
@ -7509,8 +7620,8 @@
"moduleKey": "pick",
"moduleFolder": "pick",
"method": "pick.wavePickTaskComplete",
"title": "完全提交拣货任务。支持 mode=1 全部确认,mode=2 部分确认(需传 order_ids)。提交后根据是否全部完成自动推进任务状态。",
"description": "完全提交拣货任务。支持 mode=1 全部确认,mode=2 部分确认(需传 order_ids)。提交后根据是否全部完成自动推进任务状态。",
"title": "完全提交拣货任务。支持 mode=1 全部确认,mode=2 部分确认(需传 order_ids)。提交后根据是否全部完成自动推进任务状态。后台抓取创建的任务(source=2)必须先绑定拣货车才能提交,否则返回 400。",
"description": "完全提交拣货任务。支持 mode=1 全部确认,mode=2 部分确认(需传 order_ids)。提交后根据是否全部完成自动推进任务状态。后台抓取创建的任务(source=2)必须先绑定拣货车才能提交,否则返回 400。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {
@ -13,7 +13,7 @@
}
},
"moduleCount": 41,
"totalInterfaceCount": 299,
"totalInterfaceCount": 300,
"changes": {
"summary": {
"moduleAdded": 0,
@ -452,14 +452,14 @@
{
"method": "order.pendingOrder.createOrder"
},
{
"method": "order.pendingOrder.downloadCreateTemplate"
},
{
"method": "order.pendingOrder.importOrdersFromExcel"
},
{
"method": "order.pendingOrder.parseAddress"
},
{
"method": "order.pendingOrder.updateAddress"
}
]
},
@ -546,6 +546,20 @@
}
]
},
{
"moduleName": "订单模块",
"moduleKey": "order",
"folder": "order",
"interfaceCount": 2,
"interfaces": [
{
"method": "order.wave.batchList"
},
{
"method": "order.pendingOrder.downloadCreateTemplate"
}
]
},
{
"moduleName": "订单配送模块",
"moduleKey": "order.deliveryOrder",
@ -1228,17 +1242,6 @@
}
]
},
{
"moduleName": "order.wave",
"moduleKey": "order",
"folder": "order",
"interfaceCount": 1,
"interfaces": [
{
"method": "order.wave.batchList"
}
]
},
{
"moduleName": "package-supplier-module",
"moduleKey": "setting.packageSupplier",

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {
@ -933,6 +933,12 @@
"required": false,
"description": "来源订单号"
},
{
"name": "shop_nick",
"type": "string",
"required": false,
"description": "店铺名称(自定义),最大长度 200"
},
{
"name": "order_type",
"type": "string",
@ -991,47 +997,6 @@
}
]
},
{
"method": "order.pendingOrder.downloadCreateTemplate",
"title": "下载创建订单的 Excel 导入模板。返回 base64 编码的 xlsx 文件,前端解码后作为附件下载。表头中标注 * 的列为必填项,多行相同订单号的行组成一个完整订单。(已作废)",
"description": "下载创建订单的 Excel 导入模板。返回 base64 编码的 xlsx 文件,前端解码后作为附件下载。表头中标注 * 的列为必填项,多行相同订单号的行组成一个完整订单。(已作废)",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [],
"response": [
{
"name": "base64",
"type": "string",
"required": true,
"description": "base64 编码的 xlsx 文件内容"
},
{
"name": "filename",
"type": "string",
"required": true,
"description": "建议保存的文件名"
},
{
"name": "mime",
"type": "string",
"required": true,
"description": "文件 MIME 类型"
}
]
},
{
"method": "order.pendingOrder.importOrdersFromExcel",
"title": "通过 Excel 文件批量创建订单。接受 base64 编码的 xlsx 内容,按订单号分组,每组创建一个订单(step 由货主策略决定)。每行代表一条商品明细;同一订单号的多行组成一个完整订单,头信息取每组第一行。(已作废)",
@ -1174,6 +1139,102 @@
"description": "收件人手机号,如 13800138000"
}
]
},
{
"method": "order.pendingOrder.updateAddress",
"title": "批量修改待处理订单的收件地址信息。仅允许修改 post_status='none'(未分配快递)的订单;至少需要提供一个地址字段(name/mobile/tel/zip_code/province/city/area/town/detail_address),空值和纯空白会被忽略。更新成功后写入操作日志。",
"description": "批量修改待处理订单的收件地址信息。仅允许修改 post_status='none'(未分配快递)的订单;至少需要提供一个地址字段(name/mobile/tel/zip_code/province/city/area/town/detail_address),空值和纯空白会被忽略。更新成功后写入操作日志。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "ids",
"type": "number[]",
"required": true,
"description": "订单ID 正整数数组,不能为空"
},
{
"name": "name",
"type": "string",
"required": false,
"description": "收件人姓名"
},
{
"name": "mobile",
"type": "string",
"required": false,
"description": "收件人手机号"
},
{
"name": "tel",
"type": "string",
"required": false,
"description": "收件人电话"
},
{
"name": "zip_code",
"type": "string",
"required": false,
"description": "邮编"
},
{
"name": "province",
"type": "string",
"required": false,
"description": "省份"
},
{
"name": "city",
"type": "string",
"required": false,
"description": "城市"
},
{
"name": "area",
"type": "string",
"required": false,
"description": "区/县"
},
{
"name": "town",
"type": "string",
"required": false,
"description": "镇/街道"
},
{
"name": "detail_address",
"type": "string",
"required": false,
"description": "详细地址"
}
],
"response": [
{
"name": "updated_count",
"type": "number",
"required": true,
"description": "实际更新的订单行数"
},
{
"name": "ids",
"type": "number[]",
"required": true,
"description": "请求的订单ID数组(原样返回)"
}
]
}
]
}

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-05 09:15:19",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-20 08:59:09",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-04 09:11:04",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {
@ -1255,27 +1255,27 @@
{
"name": "total",
"type": "number",
"required": false,
"required": true,
"description": "总记录数"
},
{
"name": "page",
"type": "number",
"required": false,
"required": true,
"description": "当前页码"
},
{
"name": "page_size",
"type": "number",
"required": false,
"required": true,
"description": "每页大小"
}
]
},
{
"method": "order.wave.wavePickTaskCancel",
"title": "取消拣货任务(批量),同时释放关联波次(物理删除波次记录,订单回池)、解绑拣货车、写操作日志。入参仅支持 task_ids(数组,必填),不再支持单个 task_id。操作人与仓库从请求上下文获取(例如当前登录用户上下文 ctx.user),若上下文缺失接口将返回错误。",
"description": "取消拣货任务(批量),同时释放关联波次(物理删除波次记录,订单回池)、解绑拣货车、写操作日志。入参仅支持 task_ids(数组,必填),不再支持单个 task_id。操作人与仓库从请求上下文获取(例如当前登录用户上下文 ctx.user),若上下文缺失接口将返回错误。",
"title": "取消拣货任务(批量)。可取消的状态:0=待开始、1=拣货中、2=待复核(拣货完成)、3=已完成,状态9(已取消)或其他状态不允许取消。同时释放关联波次(物理删除波次记录,订单回池)、解绑拣货车、写操作日志。对于status=2或3的任务,取消时会自动回退订单拣货状态:wms_wave_pick_task_order.pick_status(1→0)、order_delivery.pick_status(fin→padding)。入参仅支持 task_ids(数组,必填),不再支持单个 task_id。操作人与仓库从请求上下文获取(例如当前登录用户上下文 ctx.user),若上下文缺失接口将返回错误。",
"description": "取消拣货任务(批量)。可取消的状态:0=待开始、1=拣货中、2=待复核(拣货完成)、3=已完成,状态9(已取消)或其他状态不允许取消。同时释放关联波次(物理删除波次记录,订单回池)、解绑拣货车、写操作日志。对于status=2或3的任务,取消时会自动回退订单拣货状态:wms_wave_pick_task_order.pick_status(1→0)、order_delivery.pick_status(fin→padding)。入参仅支持 task_ids(数组,必填),不再支持单个 task_id。操作人与仓库从请求上下文获取(例如当前登录用户上下文 ctx.user),若上下文缺失接口将返回错误。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,

View File

@ -1,12 +1,12 @@
{
"module": {
"name": "order.wave",
"name": "订单模块",
"key": "order",
"folder": "order"
},
"status": "active",
"createdAt": "2026-05-09 09:52:14",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {
@ -13,10 +13,10 @@
}
},
"module": {
"name": "order.wave",
"name": "订单模块",
"key": "order",
"folder": "order",
"interfaceCount": 1
"interfaceCount": 2
},
"changes": {
"fromPreviousSnapshot": {
@ -67,7 +67,7 @@
"name": "where",
"type": "object",
"required": false,
"description": "筛选白名单字段(object,可选)。仅支持下列字段过滤,且禁止传入 warehouse_id / warehouseId: - wave_id(等值) - wave_no(模糊) - wave_type(等值) - wave_status(等值,接口固定叠加状态 0/1) - creator(模糊) - logistics_name(模糊) - item_part_type(等值) - item_part(模糊) - item_snapshot_key(模糊) - item_detail_machine(模糊) - distinguish_express(等值) - total_orders_min / total_orders_max(范围) - processed_orders_min / processed_orders_max(范围) - express_assignment_status(等值,string,可选,英文枚举,取值:unassigned、partially_assigned、assigned;语义:按快递分配聚合判断,assigned 表示聚合后全部 fin,partially_assigned 表示部分已分配且不含 error,unassigned 表示全 none 或包含 error(异常并入未分配集合))。 - print_assignment_status(等值,string,可选,英文枚举,取值:unprinted、partially_printed、printed;语义:按打印分配聚合判断,printed 表示聚合后全部已打印)。 - storage_assignment_status(等值,string,可选,取值:未分配、部分分配、已分配;默认不传不做限制)。过滤语义:已分配=聚合后全部 fin;部分分配=不含 error,且既不是全 none,也不是全 fin;未分配=全 none 或包含 error(异常并入未分配筛选集合)。说明:返回字段 storage_assignment_status 的展示值保持不变,包含 error 时仍可显示“分配异常”;此处 where 的过滤语义会把异常计入“未分配”,以避免把过滤语义与展示值混淆。 - source(可选,number)来源过滤:0=普通波次(正常后台操作),1=管理后台策略任务,2=PDA策略任务;不传则不过滤。 说明:express_assignment_status 与 print_assignment_status 要求使用英文枚举值;storage_assignment_status 仍向后兼容中文展示值。若传入的枚举值不在允许集合内,接口会返回 400(参数校验失败),并在 message 中说明错误字段与允许取值。 - sync_assignment_status(等值,string,可选,英文枚举,取值:unsynced、partially_synced、synced;语义:按同步状态聚合判断,synced 表示全部 fin,partially_synced 表示部分已同步且不含 error,unsynced 表示全 padding 或包含 error(异常并入未同步集合))。 - review_assignment_status(等值,string,可选,英文枚举:unreviewed、partially_reviewed、reviewed;分别表示未复核、部分复核、已复核)。"
"description": "筛选白名单字段(object,可选)。仅支持下列字段过滤,且禁止传入 warehouse_id / warehouseId: - wave_id(等值) - wave_no(模糊) - wave_type(等值) - wave_status(等值,接口固定叠加状态 0/1) - creator(模糊) - logistics_name(模糊) - item_part_type(等值) - item_part(模糊) - item_snapshot_key(模糊) - item_detail_machine(模糊) - distinguish_express(等值) - total_orders_min / total_orders_max(范围) - processed_orders_min / processed_orders_max(范围) - express_assignment_status(等值,string,可选,英文枚举,取值:unassigned、partially_assigned、assigned;语义:按快递分配聚合判断,assigned 表示聚合后全部 fin,partially_assigned 表示部分已分配且不含 error,unassigned 表示全 none 或包含 error(异常并入未分配集合))。 - print_assignment_status(等值,string,可选,英文枚举,取值:unprinted、partially_printed、printed;语义:按打印分配聚合判断,printed 表示聚合后全部已打印)。 - storage_assignment_status(等值,string,可选,取值:未分配、部分分配、已分配;默认不传不做限制)。过滤语义:已分配=聚合后全部 fin;部分分配=不含 error,且既不是全 none,也不是全 fin;未分配=全 none 或包含 error(异常并入未分配筛选集合)。说明:返回字段 storage_assignment_status 的展示值保持不变,包含 error 时仍可显示“分配异常”;此处 where 的过滤语义会把异常计入“未分配”,以避免把过滤语义与展示值混淆。 - source(可选,number)来源过滤:0=普通波次(正常后台操作),1=管理后台策略任务,2=PDA策略任务;不传则不过滤。 说明:express_assignment_status 与 print_assignment_status 要求使用英文枚举值;storage_assignment_status 仍向后兼容中文展示值。若传入的枚举值不在允许集合内,接口会返回 400(参数校验失败),并在 message 中说明错误字段与允许取值。 - review_assignment_status(等值,string,可选,英文枚举:unreviewed、partially_reviewed、reviewed;分别表示未复核、部分复核、已复核)。"
}
],
"response": [
@ -75,7 +75,7 @@
"name": "list",
"type": "array",
"required": true,
"description": "波次列表,包含波次基础信息与状态汇总(order_count / storage_assignment_status / express_assignment_status / print_assignment_status / sync_assignment_status / review_assignment_status / unreviewed_order_count)。每条记录新增字段 source(number):来源标识,0=普通波次(正常后台操作),1=管理后台策略任务,2=PDA策略任务。"
"description": "波次列表,包含波次基础信息与状态汇总(order_count / storage_assignment_status / express_assignment_status / print_assignment_status / review_assignment_status / unreviewed_order_count)。每条记录新增字段 source(number):来源标识,0=普通波次(正常后台操作),1=管理后台策略任务,2=PDA策略任务。"
},
{
"name": "pagination",
@ -84,6 +84,53 @@
"description": "分页信息(page、pageSize、total、totalPages、hasPrevious、hasNext)"
}
]
},
{
"method": "order.pendingOrder.downloadCreateTemplate",
"title": "下载创建订单的 Excel 导入模板。返回 base64 编码的 xlsx 文件,前端解码后作为 .xlsx 附件下载。表头中标注 * 的列为必填项(橙色背景),可选列为灰色背景,包含示例数据行和填写说明工作表。多行相同订单号的行组成一个完整订单,每行代表一条商品明细。模板必填列:订单号(delivery_order_code)、收件人姓名(name)、手机号(mobile)、详细地址(detail_address)、商品编码(item_code)、计划数量(plan_qty);非必填列含:货主ID(store_id)、省份(province)、城市(city)、区/县(area)、店铺名称(shop_nick)等。",
"description": "下载创建订单的 Excel 导入模板。返回 base64 编码的 xlsx 文件,前端解码后作为 .xlsx 附件下载。表头中标注 * 的列为必填项(橙色背景),可选列为灰色背景,包含示例数据行和填写说明工作表。多行相同订单号的行组成一个完整订单,每行代表一条商品明细。模板必填列:订单号(delivery_order_code)、收件人姓名(name)、手机号(mobile)、详细地址(detail_address)、商品编码(item_code)、计划数量(plan_qty);非必填列含:货主ID(store_id)、省份(province)、城市(city)、区/县(area)、店铺名称(shop_nick)等。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [],
"response": [
{
"name": "base64",
"type": "string",
"required": true,
"description": "base64 编码的 xlsx 文件内容"
},
{
"name": "filename",
"type": "string",
"required": true,
"description": "建议保存的文件名,固定为 创建订单导入模板.xlsx"
},
{
"name": "mime",
"type": "string",
"required": true,
"description": "文件 MIME 类型,固定为 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
},
{
"name": "shop_nick",
"type": "string",
"required": false,
"description": "模板中新增的店铺名称列(非必填),用于标识订单所属店铺"
}
]
}
]
}

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-04 17:23:48",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {
@ -207,8 +207,8 @@
},
{
"method": "pick.wavePickTaskComplete",
"title": "完全提交拣货任务。支持 mode=1 全部确认,mode=2 部分确认(需传 order_ids)。提交后根据是否全部完成自动推进任务状态。",
"description": "完全提交拣货任务。支持 mode=1 全部确认,mode=2 部分确认(需传 order_ids)。提交后根据是否全部完成自动推进任务状态。",
"title": "完全提交拣货任务。支持 mode=1 全部确认,mode=2 部分确认(需传 order_ids)。提交后根据是否全部完成自动推进任务状态。后台抓取创建的任务(source=2)必须先绑定拣货车才能提交,否则返回 400。",
"description": "完全提交拣货任务。支持 mode=1 全部确认,mode=2 部分确认(需传 order_ids)。提交后根据是否全部完成自动推进任务状态。后台抓取创建的任务(source=2)必须先绑定拣货车才能提交,否则返回 400。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-06-03 16:55:40",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-17 19:37:49",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-17 20:21:27",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-29 09:07:53",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-29 09:07:53",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-17 19:16:50",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-04 09:11:04",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-25 17:05:16",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-05-15 17:32:36",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": "2026-04-17 19:16:50"
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

View File

@ -6,7 +6,7 @@
},
"status": "active",
"createdAt": "2026-04-16 11:15:05",
"updatedAt": "2026-06-06 17:48:06",
"updatedAt": "2026-06-07 17:58:31",
"deletedAt": null,
"restoredAt": null
}

View File

@ -1,6 +1,6 @@
{
"generatedAt": "2026-06-06 17:48:06",
"generatedAtLocal": "2026-06-06 17:48:06",
"generatedAt": "2026-06-07 17:58:31",
"generatedAtLocal": "2026-06-07 17:58:31",
"source": "remote",
"filter": {
"platform": {

Some files were not shown because too many files have changed in this diff Show More