From e732e7fa9db72fabcfa8e5429cbf394aad559c38 Mon Sep 17 00:00:00 2001 From: yin <3313488199@qq.com> Date: Wed, 6 May 2026 17:44:37 +0800 Subject: [PATCH] =?UTF-8?q?5=E6=9C=886=E6=97=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- env.d.ts | 5 + src/api/order.wave/orderwave.ts | 34 + src/components/QR/qrcode.vue | 72 ++ src/lang/en-US.ts | 2 +- src/lang/index.ts | 13 + src/lang/zh-CN.ts | 3 +- src/permission.ts | 20 +- src/router/map.ts | 1 + src/utils/wave-order-nav.ts | 19 + .../config/order-common-config.ts | 11 + .../order/orderManagement/exceptionOrder.vue | 88 +- src/views/order/orderManagement/index.vue | 46 +- .../order/orderManagement/pendingOrder.vue | 71 +- .../orderManagement/utils/toolbar-actions.ts | 78 +- .../order/waveOrder/WaveBatchListPanel.vue | 33 +- .../component/WaveFetchTaskProgressDialog.vue | 136 +++ src/views/order/waveOrder/index.vue | 51 +- src/views/store/index.vue | 185 ++- src/views/store/store-config.ts | 9 + .../system/setting/basicManagement/index.vue | 560 +++++++++ workflows/api-doc-agent/config/响应.md | 139 ++- workflows/api-doc-agent/config/接口.md | 16 +- workflows/api-doc-system/apidata/config.json | 13 +- workflows/api-doc-system/apidata/data.json | 170 ++- workflows/api-doc-system/core/apidata.mjs | 47 +- .../interface-details/interface-details.json | 1027 ++++++++++++++++- .../data/module-list/module-list.json | 89 +- .../data/module/config/_module.lifecycle.json | 2 +- .../data/module/config/module.json | 4 +- .../module/dashboard/_module.lifecycle.json | 2 +- .../data/module/dashboard/module.json | 4 +- .../data/module/index/_module.lifecycle.json | 2 +- .../data/module/index/module.json | 4 +- .../order.archiveorder/_module.lifecycle.json | 2 +- .../module/order.archiveorder/module.json | 4 +- .../_module.lifecycle.json | 2 +- .../order.deliveryexpectionorder/module.json | 4 +- .../_module.lifecycle.json | 2 +- .../module/order.deliveryorder/module.json | 4 +- .../order.entrustorder/_module.lifecycle.json | 2 +- .../module/order.entrustorder/module.json | 4 +- .../_module.lifecycle.json | 2 +- .../module/order.expectionorder/module.json | 4 +- .../module/order.index/_module.lifecycle.json | 2 +- .../data/module/order.index/module.json | 4 +- .../_module.lifecycle.json | 2 +- .../module/order.outboundorder/module.json | 4 +- .../order.pendingorder/_module.lifecycle.json | 2 +- .../module/order.pendingorder/module.json | 4 +- .../module/order.print/_module.lifecycle.json | 2 +- .../data/module/order.print/module.json | 4 +- .../order.revieworder/_module.lifecycle.json | 2 +- .../data/module/order.revieworder/module.json | 4 +- .../module/order.wave/_module.lifecycle.json | 2 +- .../data/module/order.wave/module.json | 910 ++++++++++++++- .../data/module/pick/_module.lifecycle.json | 2 +- .../data/module/pick/module.json | 4 +- .../data/module/print/_module.lifecycle.json | 2 +- .../data/module/print/module.json | 4 +- .../printer.station/_module.lifecycle.json | 2 +- .../data/module/printer.station/module.json | 4 +- .../setting.account/_module.lifecycle.json | 2 +- .../data/module/setting.account/module.json | 4 +- .../setting.express/_module.lifecycle.json | 2 +- .../data/module/setting.express/module.json | 4 +- .../_module.lifecycle.json | 2 +- .../setting.expressinterface/module.json | 4 +- .../setting.permission/_module.lifecycle.json | 2 +- .../module/setting.permission/module.json | 4 +- .../setting.platform/_module.lifecycle.json | 2 +- .../data/module/setting.platform/module.json | 4 +- .../_module.lifecycle.json | 2 +- .../module/setting.printtemplate/module.json | 4 +- .../setting.role/_module.lifecycle.json | 2 +- .../data/module/setting.role/module.json | 4 +- .../setting.warehouse/_module.lifecycle.json | 2 +- .../data/module/setting.warehouse/module.json | 4 +- .../data/module/stock/_module.lifecycle.json | 2 +- .../data/module/stock/module.json | 4 +- .../storage.entry/_module.lifecycle.json | 2 +- .../data/module/storage.entry/module.json | 4 +- .../storage.inventory/_module.lifecycle.json | 2 +- .../data/module/storage.inventory/module.json | 4 +- .../storage.stockout/_module.lifecycle.json | 2 +- .../data/module/storage.stockout/module.json | 4 +- .../storage_receiving/_module.lifecycle.json | 2 +- .../data/module/storage_receiving/module.json | 36 +- .../data/module/store/_module.lifecycle.json | 2 +- .../data/module/store/module.json | 24 +- .../_module.lifecycle.json | 2 +- .../module/storewarehouse.store/module.json | 6 +- .../data/module/user/_module.lifecycle.json | 2 +- .../data/module/user/module.json | 4 +- .../module/warehouse/_module.lifecycle.json | 2 +- .../data/module/warehouse/module.json | 4 +- .../api-doc-system/data/pending-updates.json | 45 +- 96 files changed, 3792 insertions(+), 355 deletions(-) create mode 100644 src/components/QR/qrcode.vue create mode 100644 src/utils/wave-order-nav.ts create mode 100644 src/views/order/waveOrder/component/WaveFetchTaskProgressDialog.vue create mode 100644 src/views/system/setting/basicManagement/index.vue diff --git a/env.d.ts b/env.d.ts index 49ba0fb3..d41af3a9 100644 --- a/env.d.ts +++ b/env.d.ts @@ -8,3 +8,8 @@ declare module '@/utils/auth' { declare module 'vue-virtual-scroller' { export const RecycleScroller: any } + +declare module 'qrcode.vue' { + const QrcodeVue: any + export default QrcodeVue +} diff --git a/src/api/order.wave/orderwave.ts b/src/api/order.wave/orderwave.ts index 4d66664c..b7c72347 100644 --- a/src/api/order.wave/orderwave.ts +++ b/src/api/order.wave/orderwave.ts @@ -238,6 +238,39 @@ export function orderWaveSingleOrderFetchList(data: WaveGroupOrderFetchListParam } as any) } +export type WaveSingleFetchByIdsParams = { + ids?: Array | string | number + order_ids?: Array | string | number + orderIds?: Array | string | number +} + +export type WaveSingleFetchByIdsResponse = { + ids: Array + wave_id: number + wave_no: string + fetched_order_ids: Array + fetched_order_count: number + excluded_existing_wave_order_ids?: Array + skipped_order_ids?: Array + not_found_order_ids?: Array +} + +export function orderWaveSingleFetchByIds( + data: WaveSingleFetchByIdsParams +): Promise { + return request({ + url: '/system', + method: 'post', + params: { + method: 'order.wave.singleFetchByIds', + v, + timestamp: new Date().getTime() + }, + data, + isSystemApi: true + } as any) +} + export function orderWaveFetch(data: WaveFetchParams): Promise { return request({ url: '/system', @@ -424,6 +457,7 @@ export const orderWave = { batchList: orderWaveBatchList, groupOrderFetchList: orderWaveGroupOrderFetchList, singleOrderFetchList: orderWaveSingleOrderFetchList, + singleFetchByIds: orderWaveSingleFetchByIds, fetch: orderWaveFetch, fetchTaskProgress: orderWaveFetchTaskProgress, batchAllocateExpress: orderWaveBatchAllocateExpress, diff --git a/src/components/QR/qrcode.vue b/src/components/QR/qrcode.vue new file mode 100644 index 00000000..20101af5 --- /dev/null +++ b/src/components/QR/qrcode.vue @@ -0,0 +1,72 @@ + + + + + diff --git a/src/lang/en-US.ts b/src/lang/en-US.ts index 1654c8f6..26ab132f 100644 --- a/src/lang/en-US.ts +++ b/src/lang/en-US.ts @@ -40,7 +40,7 @@ export default { "Receivable": "Receivable", "Encoding": "Encoding", "Open": "Open Platform", - "basicManagement": "Basic Management", + "basicManagement": "Warehouse Settings", "Order": "Order", "Stock": "Stock", "Material": "Material", diff --git a/src/lang/index.ts b/src/lang/index.ts index bdb15ea4..8b0d4a6a 100644 --- a/src/lang/index.ts +++ b/src/lang/index.ts @@ -15,6 +15,12 @@ const CONFIG = { CACHE_KEY: 'i18n_collected_keys' // 本地缓存键名 } +/** 合并服务端语言包后仍强制使用前端的菜单译名(避免后台词条未同步时被覆盖) */ +const FORCE_MENU_LABELS: Record> = { + 'zh-CN': { basicManagement: '仓库设置' }, + en: { basicManagement: 'Warehouse Settings' } +} + // ==================== 状态管理 ==================== const state = { serverMessages: {} as Record, // 服务器加载的翻译 @@ -259,6 +265,13 @@ export async function loadServerMessages(language: string | null = null) { // @ts-ignore i18n.global.setLocaleMessage(targetLanguage, mergedMessages) + + const forced = FORCE_MENU_LABELS[targetLanguage] + if (forced && mergedMessages.menu && typeof mergedMessages.menu === 'object') { + Object.assign(mergedMessages.menu, forced) + // @ts-ignore + i18n.global.setLocaleMessage(targetLanguage, mergedMessages) + } // console.log('整合后的语言包:', mergedMessages) console.log(`✅ 服务器翻译加载并深度合并成功 (${targetLanguage})`); diff --git a/src/lang/zh-CN.ts b/src/lang/zh-CN.ts index 19dfc25b..830885fb 100644 --- a/src/lang/zh-CN.ts +++ b/src/lang/zh-CN.ts @@ -40,7 +40,8 @@ export default { "Receivable": "应收", "Encoding": "编码", "Open": "开放平台", - "basicManagement": "基础设置", + "basicManagement": "仓库设置", + "基础设置": "仓库设置", "Order": "订单", "Stock": "商品", "Material": "耗材", diff --git a/src/permission.ts b/src/permission.ts index ed9db592..4409e641 100644 --- a/src/permission.ts +++ b/src/permission.ts @@ -6,15 +6,33 @@ import NProgress from 'nprogress' import 'nprogress/nprogress.css' import { getToken } from '@/utils/auth' import getPageTitle from '@/utils/get-page-title' +import i18n from '@/lang' NProgress.configure({ showSpinner: false }) +/** 与侧边栏 / 标签一致:优先按路由 name、再按 meta.title 匹配 menu.* 文案 */ +function resolveRouteDocumentTitle(route: typeof router.currentRoute.value) { + const tryMenuKey = (raw: unknown) => { + if (raw === undefined || raw === null || raw === '') return '' + const key = String(raw).replace(/_Child$/, '') + const path = `menu.${key}` + return i18n.global.te(path) ? String(i18n.global.t(path)) : '' + } + + const metaTitle = route.meta?.title as string | undefined + const fromName = tryMenuKey(route.name) + if (fromName) return fromName + const fromMetaAsKey = tryMenuKey(metaTitle) + if (fromMetaAsKey) return fromMetaAsKey + return metaTitle || (route.name != null ? String(route.name) : '') +} + const whiteList = ['/login','/redirect','/admin/land'] // no redirect whitelist router.beforeEach(async (to, from) => { NProgress.start() // console.log("路由表",router.getRoutes()); - document.title = getPageTitle(to.meta.title as string) + document.title = getPageTitle(resolveRouteDocumentTitle(to)) const hasToken = getToken() diff --git a/src/router/map.ts b/src/router/map.ts index 6c1b3ee0..a235cf85 100644 --- a/src/router/map.ts +++ b/src/router/map.ts @@ -25,6 +25,7 @@ export const componentMap: Record = { /** 与后端菜单 component 字段兼容 */ 'order/waveOrder': () => import('@/views/order/waveOrder/index.vue'), 'role/index': () => import('@/views/system/setting/role/index.vue'), + 'basicManagement':() => import('@/views/system/setting/basicManagement/index.vue'), 'system/setting/role/index': () => import('@/views/system/setting/role/index.vue'), // 'role/index': () => import('@/views/system/setting/role/index.vue'), // 'system/setting/role/index': () => import('@/views/system/setting/role/index.vue'), diff --git a/src/utils/wave-order-nav.ts b/src/utils/wave-order-nav.ts new file mode 100644 index 00000000..e6d66420 --- /dev/null +++ b/src/utils/wave-order-nav.ts @@ -0,0 +1,19 @@ +import type { Router } from 'vue-router' + +/** 与 src/router/map.ts 中 order/waveOrder 等 key 对应的常见菜单 path */ +const WAVE_ORDER_PATH_CANDIDATES = ['/order/waveOrder', '/order/wave', '/wave/index'] + +/** + * 跳转订单波次管理页的「散单波次」标签(waveOrder/index.vue 使用 query.tab=sandanWave)。 + */ +export async function navigateToSandanWaveTab(router: Router) { + const query = { tab: 'sandanWave' } + for (const path of WAVE_ORDER_PATH_CANDIDATES) { + const resolved = router.resolve({ path, query }) + if (resolved.matched.length) { + await router.push({ path, query }) + return + } + } + await router.push({ path: WAVE_ORDER_PATH_CANDIDATES[0], query }) +} diff --git a/src/views/order/orderManagement/config/order-common-config.ts b/src/views/order/orderManagement/config/order-common-config.ts index b3f8ccf2..76d105dc 100644 --- a/src/views/order/orderManagement/config/order-common-config.ts +++ b/src/views/order/orderManagement/config/order-common-config.ts @@ -215,6 +215,16 @@ export const ORDER_TOOLBAR_BUTTONS: Record = { markPendingOutbound: { key: 'markPendingOutbound', label: '标记待出库', size: 'small', type: 'warning', loadingKey: 'actionLoading', disabledKey: 'hasNoSelection', action: 'handleMarkPendingOutbound' }, allocateStorage: { key: 'allocateStorage', label: '分配储位', size: 'small', type: 'primary', plain: true, loadingKey: 'storageAllocateLoading', disabledKey: 'hasNoSelection', action: 'openStorageAllocateDialog' }, cancelAllocateStorage: { key: 'cancelAllocateStorage', label: '取消分配储位', size: 'small', type: 'danger', plain: true, loadingKey: 'storageAllocateLoading', disabledKey: 'hasNoSelection', action: 'openStorageCancelDialog' }, + waveSingleFetchByIds: { + key: 'waveSingleFetchByIds', + label: '抓取散单', + size: 'small', + type: 'primary', + plain: true, + loadingKey: 'waveSingleFetchLoading', + disabledKey: 'hasNoSelection', + action: 'handleWaveSingleFetchByIds' + }, allocateExpress: { key: 'allocateExpress', label: '分配快递号', size: 'small', type: 'success', loadingKey: 'allocateLoading', disabledKey: 'hasNoSelection', action: 'openAllocateExpressDialog' }, updateExpress: { key: 'updateExpress', label: '修改快递', size: 'small', type: 'warning', plain: true, loadingKey: 'updateOrderMetaLoading', disabledKey: 'hasNoSelection', action: 'openUpdateOrderExpressDialog' }, updatePlatform: { key: 'updatePlatform', label: '修改平台', size: 'small', type: 'info', plain: true, loadingKey: 'updateOrderMetaLoading', disabledKey: 'hasNoSelection', action: 'openUpdateOrderPlatformDialog' }, @@ -909,6 +919,7 @@ export const pendingToolbarButtonKeys = [ ...simpleListToolbarButtonKeys, 'reverseReview', 'markPendingOutbound', + 'waveSingleFetchByIds', 'allocateStorage', 'cancelAllocateStorage', 'allocateExpress', diff --git a/src/views/order/orderManagement/exceptionOrder.vue b/src/views/order/orderManagement/exceptionOrder.vue index 720911e7..3c17ab50 100644 --- a/src/views/order/orderManagement/exceptionOrder.vue +++ b/src/views/order/orderManagement/exceptionOrder.vue @@ -147,6 +147,40 @@ + + + + @@ -340,6 +375,7 @@ import { exportUpperTableRows } from './utils/export' import { useVerticalSplitPane } from '@/composables/useVerticalSplitPane' import { createPendingToolbarController } from './utils/toolbar-actions' import { safeInvoke } from '@/utils/safe-invoke' +import QrcodeDialog from '@/components/QR/qrcode.vue' const scanBox = ref(null) const upperTable = ref(null) @@ -375,6 +411,8 @@ const detailVisible = ref(true) const quickSearch = ref('') const toolbarButtons = exceptionToolbarButtons +const qrDialogVisible = ref(false) +const currentWaybillCode = ref('') const scrollContainerRef = ref(null) const isDragging = ref(false) @@ -820,7 +858,8 @@ const { cloneOrderDialogVisible, cloneOrderLoading, cloneSourceOrderId, - cloneSourceOrderCode + cloneSourceOrderCode, + waveSingleFetchLoading }, submitStorageAllocate, submitUpdateOrderMeta, @@ -862,7 +901,8 @@ const buttonLoadingMap = computed>(() => ({ allocateLoading: allocateLoading.value, updateOrderMetaLoading: updateOrderMetaLoading.value, cloneOrderLoading: cloneOrderLoading.value, - resolveExceptionLoading: resolveExceptionLoading.value + resolveExceptionLoading: resolveExceptionLoading.value, + waveSingleFetchLoading: waveSingleFetchLoading.value })) function resolveButtonLoading(loadingKey?: string) { @@ -885,6 +925,39 @@ function handleToolbarButtonClick(action: ToolbarButtonConfig['action']) { if (!handler) return safeInvoke(() => handler()) } + +function parseWaybillCodes(raw: unknown): string[] { + if (Array.isArray(raw)) { + return raw.map((item) => String(item ?? '').trim()).filter(Boolean) + } + const text = String(raw ?? '').trim() + if (!text) return [] + if (text.startsWith('[') && text.endsWith(']')) { + try { + const parsed = JSON.parse(text) + if (Array.isArray(parsed)) { + return parsed.map((item) => String(item ?? '').trim()).filter(Boolean) + } + } catch { + // ignore invalid json + } + } + if (text.includes(',')) { + return text.split(',').map((item) => item.trim()).filter(Boolean) + } + return [text] +} + +function extractWaybillCodes(row: any): string[] { + const raw = row?.express_numbers ?? row?.waybill_codes ?? row?.express_code + return parseWaybillCodes(raw) +} + +function openWaybillQr(code: string) { + if (!code) return + currentWaybillCode.value = code + qrDialogVisible.value = true +} diff --git a/src/views/order/orderManagement/utils/toolbar-actions.ts b/src/views/order/orderManagement/utils/toolbar-actions.ts index bfaba2b7..662da13d 100644 --- a/src/views/order/orderManagement/utils/toolbar-actions.ts +++ b/src/views/order/orderManagement/utils/toolbar-actions.ts @@ -1,10 +1,13 @@ import { ElMessage, ElMessageBox } from 'element-plus' import { computed, reactive, ref } from 'vue' +import { useRouter } from 'vue-router' import { PENDING_TOOLBAR_API_ACTIONS, REVIEW_TOOLBAR_API_ACTIONS, type ToolbarApiActionConfig } from '../config/order-common-config' +import { orderWaveSingleFetchByIds } from '@/api/order.wave/orderwave' +import { navigateToSandanWaveTab } from '@/utils/wave-order-nav' type ActionHandler = () => void | Promise type OrderId = number | string @@ -260,6 +263,8 @@ export function createPendingToolbarController(params: { expressCodeOptions: { value: Array<{ label: string; value: string }> } platformCodeOptions: { value: Array<{ label: string; value: string }> } }) { + const router = useRouter() + const allocateDialogVisible = ref(false) const allocateLoading = ref(false) const allocatePendingRows = ref([]) @@ -296,6 +301,73 @@ export function createPendingToolbarController(params: { const syncOrderIdsDialogVisible = ref(false) const syncOrderIdsLoading = ref(false) + const waveSingleFetchLoading = ref(false) + + async function handleWaveSingleFetchByIds() { + const ids = params.getSelectedIds() + if (!ids.length) { + ElMessage.warning('请先勾选需要抓取散单的订单') + return + } + if (waveSingleFetchLoading.value) return + try { + await ElMessageBox.confirm( + `确定将选中的 ${ids.length} 条订单按散单抓取至波次吗?`, + '抓取散单', + { type: 'warning' } + ) + } catch { + return + } + + waveSingleFetchLoading.value = true + try { + const res = (await orderWaveSingleFetchByIds({ ids })) as Record + const ok = res && (res.code === 1 || res.code === 200 || res.flag === 'success') + const payload = + res?.data && typeof res.data === 'object' && !Array.isArray(res.data) + ? res.data + : res + if (!ok) { + ElMessage.error(res?.message || payload?.message || '抓取散单失败') + return + } + + const waveNo = payload?.wave_no ?? '' + const fetched = Number(payload?.fetched_order_count ?? 0) + const parts = [ + res?.message || payload?.message || '抓取散单成功', + waveNo ? `波次:${waveNo}` : '', + Number.isFinite(fetched) && fetched >= 0 ? `已抓取 ${fetched} 单` : '' + ] + const excluded = payload?.excluded_existing_wave_order_ids + const skipped = payload?.skipped_order_ids + const notFound = payload?.not_found_order_ids + if (Array.isArray(excluded) && excluded.length) { + parts.push(`已在波次中跳过 ${excluded.length} 单`) + } + if (Array.isArray(skipped) && skipped.length) { + parts.push(`跳过 ${skipped.length} 单`) + } + if (Array.isArray(notFound) && notFound.length) { + parts.push(`未找到 ${notFound.length} 单`) + } + ElMessage.success(parts.filter(Boolean).join(';')) + + params.clearSelection() + await params.loadData() + try { + await navigateToSandanWaveTab(router) + } catch { + ElMessage.warning('抓取成功,但跳转散单波次页失败,请从菜单打开波次管理') + } + } catch { + ElMessage.error('抓取散单失败') + } finally { + waveSingleFetchLoading.value = false + } + } + const actionMap = createPendingToolbarActionMap({ baseActions: { loadData: params.loadData, @@ -310,7 +382,8 @@ export function createPendingToolbarController(params: { openManualCreateDialog: params.openManualCreateDialog, openImportOrderDialog: params.openImportOrderDialog, openCloneOrderDialog, - openSyncOrderIdsDialog + openSyncOrderIdsDialog, + handleWaveSingleFetchByIds }, getSelectedIds: params.getSelectedIds, pendingApi: params.pendingApi, @@ -672,7 +745,8 @@ export function createPendingToolbarController(params: { cloneSourceOrderId, cloneSourceOrderCode, syncOrderIdsDialogVisible, - syncOrderIdsLoading + syncOrderIdsLoading, + waveSingleFetchLoading }, submitStorageAllocate, submitUpdateOrderMeta, diff --git a/src/views/order/waveOrder/WaveBatchListPanel.vue b/src/views/order/waveOrder/WaveBatchListPanel.vue index d236163b..881e7075 100644 --- a/src/views/order/waveOrder/WaveBatchListPanel.vue +++ b/src/views/order/waveOrder/WaveBatchListPanel.vue @@ -39,23 +39,6 @@ -
-
- 抓取任务进度 - 任务ID:{{ fetchTaskProgress.taskId }} -
- -
- 状态:{{ getFetchTaskStatusText(fetchTaskProgress.status) }} - 已完成结构:{{ fetchTaskProgress.finishedStructureCount }} / {{ fetchTaskProgress.structureCount }} - 已抓取件数:{{ fetchTaskProgress.totalFetchedQuantity }} - 更新时间:{{ formatDateTime(fetchTaskProgress.updateTime) }} -
-
- {{ fetchTaskProgress.error || fetchTaskProgress.message }} -
-
-
快递号分配任务进度 @@ -618,6 +601,11 @@ + + { const batchPrintDisabled = computed(() => { return !printableSelectionRows.value.length || (waveMaxOrderLimit.value !== null && selectedWaveOrderTotal.value > waveMaxOrderLimit.value) }) -const fetchTaskPercent = computed(() => { - const value = Number(fetchTaskProgress.progressPercent || 0) - if (!Number.isFinite(value)) return 0 - return Math.min(100, Math.max(0, value)) -}) -const fetchTaskProgressBarStatus = computed(() => { - if (fetchTaskProgress.status === 'failed' || fetchTaskProgress.status === 'not_found') return 'exception' - if (fetchTaskProgress.status === 'success' || fetchTaskPercent.value >= 100) return 'success' - return undefined -}) const batchAllocateExpressTaskPercent = computed(() => { const value = Number(batchAllocateExpressTaskProgress.progressPercent || 0) if (!Number.isFinite(value)) return 0 diff --git a/src/views/order/waveOrder/component/WaveFetchTaskProgressDialog.vue b/src/views/order/waveOrder/component/WaveFetchTaskProgressDialog.vue new file mode 100644 index 00000000..c8bc4ffb --- /dev/null +++ b/src/views/order/waveOrder/component/WaveFetchTaskProgressDialog.vue @@ -0,0 +1,136 @@ + + + + + diff --git a/src/views/order/waveOrder/index.vue b/src/views/order/waveOrder/index.vue index 1e4e1991..01263e34 100644 --- a/src/views/order/waveOrder/index.vue +++ b/src/views/order/waveOrder/index.vue @@ -25,7 +25,7 @@ + + diff --git a/workflows/api-doc-agent/config/响应.md b/workflows/api-doc-agent/config/响应.md index b059d322..8b12341a 100644 --- a/workflows/api-doc-agent/config/响应.md +++ b/workflows/api-doc-agent/config/响应.md @@ -3,12 +3,145 @@ { "接口": "user.login", "data": { - "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MywidXNlcm5hbWUiOiJ5am0iLCJyZWFsX25hbWUiOiJ5aW4iLCJwbGF0Zm9ybV9jb2RlIjoid2ViIiwiY3VycmVudF9yb2xlX2lkIjozMSwiY3VycmVudF9zdG9yZV9pZCI6MTAwMDAwLCJpYXQiOjE3Nzc4ODU4MjEsImV4cCI6MTc3NzkwMDIyMX0.Q0F2Slir7PDYHsHlcMGWV_BkecHh1HPLBgAvx8KqaQg" + "flag": "success", + "code": 200, + "message": "登录成功", + "success": true, + "data": { + "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MywidXNlcm5hbWUiOiJ5am0iLCJyZWFsX25hbWUiOiJ5aW4iLCJwbGF0Zm9ybV9jb2RlIjoid2ViIiwiY3VycmVudF9yb2xlX2lkIjozMSwiY3VycmVudF9zdG9yZV9pZCI6MTAwMDAwLCJpYXQiOjE3NzgwNTgxMTQsImV4cCI6MTc3ODA3MjUxNH0.i_XWXCEuBLQ3o4-AFxznOoUob7PXTf3Vf2i-t6qZTTg" + }, + "timestamp": 1778058114 } }, { - "接口": "order.queryOrderLogList", - "data": null + "接口": "setting.warehouse.getSettings", + "data": { + "flag": "success", + "code": 1, + "message": "ok", + "warehouse_id": 100000, + "subject_config": { + "group_wave_prefix": "B", + "max_wave_quantity": 500, + "default_express_code": "STO", + "auto_grouping_enabled": false, + "default_platform_code": "TB", + "delete_order_wave_prefix": "A", + "max_notice_webhook_count": 5, + "min_group_order_fetch_quantity": 13 + }, + "timestamp": 1778058114 + } + }, + { + "接口": "setting.warehouse.getFieldMeta", + "data": { + "flag": "success", + "code": 1, + "message": "ok", + "list": [ + { + "key": "max_notice_webhook_count", + "name": "最大通知 Webhook 次数", + "type": "integer", + "default": 5, + "required": false, + "description": "单次事件最多触发的 Webhook 通知次数(0-5)", + "min": 0, + "max": 5 + }, + { + "key": "max_wave_quantity", + "name": "仓库波次最大数量限制", + "type": "integer", + "default": 500, + "required": false, + "description": "控制单个波次允许的最大订单数量,默认 500", + "min": 1 + }, + { + "key": "min_group_order_fetch_quantity", + "name": "最小团购订单抓取数量", + "type": "integer", + "default": 13, + "required": false, + "description": "控制团购波次最小抓取订单数量,默认 13", + "min": 1 + }, + { + "key": "default_express_code", + "name": "默认快递编码", + "type": "string", + "default": "STO", + "required": false, + "description": "仓库默认使用的快递编码", + "maxLength": 50 + }, + { + "key": "default_platform_code", + "name": "默认平台编码", + "type": "string", + "default": "TB", + "required": false, + "description": "仓库默认使用的平台编码", + "maxLength": 50 + }, + { + "key": "group_wave_prefix", + "name": "团购波次前缀", + "type": "string", + "default": "B", + "required": false, + "description": "团购波次编号前缀,最多 5 个字符,默认 B", + "maxLength": 5 + }, + { + "key": "delete_order_wave_prefix", + "name": "删单波次前缀", + "type": "string", + "default": "A", + "required": false, + "description": "删单波次编号前缀,最多 5 个字符,默认 A", + "maxLength": 5 + }, + { + "key": "webhook_enabled", + "name": "是否启用 Webhook", + "type": "flag", + "default": false, + "required": false, + "description": "控制仓库是否启用 Webhook 事件推送" + }, + { + "key": "callback_strategy", + "name": "回调策略", + "type": "enum", + "default": "async", + "required": false, + "description": "仓库 Webhook 事件的回调执行策略", + "options": [ + { + "value": "sync", + "label": "同步回调" + }, + { + "value": "async", + "label": "异步回调" + } + ] + } + ], + "timestamp": 1778058114 + } + }, + { + "接口": "setting.warehouse.saveSettings", + "data": { + "flag": "failure", + "code": 400, + "message": "subject_config 参数不能为空且必须是对象", + "timestamp": 1778058114 + } } ] ``` diff --git a/workflows/api-doc-agent/config/接口.md b/workflows/api-doc-agent/config/接口.md index b430d5fd..53885d6a 100644 --- a/workflows/api-doc-agent/config/接口.md +++ b/workflows/api-doc-agent/config/接口.md @@ -1,11 +1,11 @@ # 接口 -- 更新时间: 2026-05-05 17:30:32 +- 更新时间: 2026-05-06 15:05:40 - 扫描目录: `src\api` - 模块数: 34 - API 文件数: 34 -- 接口数: 260 -- 已启用: 230 +- 接口数: 268 +- 已启用: 238 - 占位接口: 2 ## 模块统计 @@ -25,7 +25,7 @@ | order.pendingorder | 1 | 16 | 16 | 0 | | order.print | 1 | 1 | 1 | 0 | | order.revieworder | 1 | 3 | 3 | 0 | -| order.wave | 1 | 9 | 9 | 0 | +| order.wave | 1 | 17 | 17 | 0 | | pick | 1 | 1 | 1 | 0 | | print | 1 | 13 | 12 | 1 | | printer.station | 1 | 11 | 1 | 0 | @@ -116,14 +116,22 @@ | order.revieworder | orderReviewOrderDetail | order.reviewOrder.detail | POST | 是 | 否 | order.revieworder/orderreviewOrder.ts | | | order.revieworder | orderReviewOrderList | order.reviewOrder.list | POST | 是 | 否 | order.revieworder/orderreviewOrder.ts | | | order.revieworder | orderReviewOrderReviewOrder | order.reviewOrder.reviewOrder | POST | 是 | 否 | order.revieworder/orderreviewOrder.ts | | +| order.wave | orderWaveBatchAllocateExpress | order.wave.batchAllocateExpress | POST | 是 | 否 | order.wave/orderwave.ts | | +| order.wave | orderWaveBatchAllocateExpressTaskProgress | order.wave.batchAllocateExpressTaskProgress | POST | 是 | 否 | order.wave/orderwave.ts | | +| order.wave | orderWaveBatchAllocateStorage | order.wave.batchAllocateStorage | POST | 是 | 否 | order.wave/orderwave.ts | | +| order.wave | orderWaveBatchAllocateStorageTaskProgress | order.wave.batchAllocateStorageTaskProgress | POST | 是 | 否 | order.wave/orderwave.ts | | | order.wave | orderWaveBatchAutoGrouping | order.wave.batchAutoGrouping | POST | 是 | 否 | order.wave/orderwave.ts | | | order.wave | orderWaveBatchCancel | order.wave.batchCancel | POST | 是 | 否 | order.wave/orderwave.ts | | +| order.wave | orderWaveBatchCancelTaskProgress | order.wave.batchCancelTaskProgress | POST | 是 | 否 | order.wave/orderwave.ts | | | order.wave | orderWaveBatchFinishAutoGrouping | order.wave.batchFinishAutoGrouping | POST | 是 | 否 | order.wave/orderwave.ts | | | order.wave | orderWaveBatchList | order.wave.batchList | POST | 是 | 否 | order.wave/orderwave.ts | | +| order.wave | orderWaveBatchRemoveExceptionOrders | order.wave.batchRemoveExceptionOrders | POST | 是 | 否 | order.wave/orderwave.ts | | +| order.wave | orderWaveBatchRemoveExceptionOrdersTaskProgress | order.wave.batchRemoveExceptionOrdersTaskProgress | POST | 是 | 否 | order.wave/orderwave.ts | | | order.wave | orderWaveBatchRemoveOrders | order.wave.batchRemoveOrders | POST | 是 | 否 | order.wave/orderwave.ts | | | order.wave | orderWaveFetch | order.wave.fetch | POST | 是 | 否 | order.wave/orderwave.ts | | | order.wave | orderWaveFetchTaskProgress | order.wave.fetchTaskProgress | POST | 是 | 否 | order.wave/orderwave.ts | | | order.wave | orderWaveGroupOrderFetchList | order.wave.groupOrderFetchList | POST | 是 | 否 | order.wave/orderwave.ts | | +| order.wave | orderWaveSingleFetchByIds | order.wave.singleFetchByIds | POST | 是 | 否 | order.wave/orderwave.ts | | | order.wave | orderWaveSingleOrderFetchList | order.wave.singleOrderFetchList | POST | 是 | 否 | order.wave/orderwave.ts | | | pick | pickQuery | pick.query | POST | 是 | 否 | pick/pick.ts | | | print | getExpressList | index.getExpressList | POST | 否 | 否 | print/print.ts | | diff --git a/workflows/api-doc-system/apidata/config.json b/workflows/api-doc-system/apidata/config.json index d75a8cce..89878452 100644 --- a/workflows/api-doc-system/apidata/config.json +++ b/workflows/api-doc-system/apidata/config.json @@ -8,16 +8,15 @@ } }, { - "method": "", - "body": { - } - }, - { - "method": "", + "method": "setting.warehouse.getSettings", "body": {} }, { - "method": "", + "method": "setting.warehouse.getFieldMeta", + "body": {} + }, + { + "method": "setting.warehouse.saveSettings", "body": {} } ], diff --git a/workflows/api-doc-system/apidata/data.json b/workflows/api-doc-system/apidata/data.json index 53d3803c..dd619030 100644 --- a/workflows/api-doc-system/apidata/data.json +++ b/workflows/api-doc-system/apidata/data.json @@ -1,9 +1,9 @@ { "数据一览": { - "当前请求数": 2, - "成功数": 2, - "全部请求数": 2, - "成功数与全部请求数": "2/2", + "当前请求数": 4, + "成功数": 3, + "全部请求数": 4, + "成功数与全部请求数": "3/4", "成功判定名单": [ "ok", "成功", @@ -12,7 +12,22 @@ "查询成功", "获取成功" ], - "失败接口": [], + "失败接口": [ + { + "接口": "setting.warehouse.saveSettings", + "message": "subject_config 参数不能为空且必须是对象", + "code": 400, + "模块目录": "setting.warehouse", + "api封装": [ + { + "文件": "src/api/setting.warehouse/settingwarehouse.ts", + "方法名": "settingWarehouse.saveSettings", + "说明": "聚合对象方法" + } + ], + "引用页面": [] + } + ], "空数据接口": [] }, "详情": [ @@ -21,14 +36,151 @@ "message": "登录成功", "code": 200, "data": { - "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MywidXNlcm5hbWUiOiJ5am0iLCJyZWFsX25hbWUiOiJ5aW4iLCJwbGF0Zm9ybV9jb2RlIjoid2ViIiwiY3VycmVudF9yb2xlX2lkIjozMSwiY3VycmVudF9zdG9yZV9pZCI6MTAwMDAwLCJpYXQiOjE3Nzc4ODU4MjEsImV4cCI6MTc3NzkwMDIyMX0.Q0F2Slir7PDYHsHlcMGWV_BkecHh1HPLBgAvx8KqaQg" + "flag": "success", + "code": 200, + "message": "登录成功", + "success": true, + "data": { + "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MywidXNlcm5hbWUiOiJ5am0iLCJyZWFsX25hbWUiOiJ5aW4iLCJwbGF0Zm9ybV9jb2RlIjoid2ViIiwiY3VycmVudF9yb2xlX2lkIjozMSwiY3VycmVudF9zdG9yZV9pZCI6MTAwMDAwLCJpYXQiOjE3NzgwNTgxMTQsImV4cCI6MTc3ODA3MjUxNH0.i_XWXCEuBLQ3o4-AFxznOoUob7PXTf3Vf2i-t6qZTTg" + }, + "timestamp": 1778058114 } }, { - "接口": "order.queryOrderLogList", + "接口": "setting.warehouse.getSettings", "message": "ok", - "code": 200, - "data": null + "code": 1, + "data": { + "flag": "success", + "code": 1, + "message": "ok", + "warehouse_id": 100000, + "subject_config": { + "group_wave_prefix": "B", + "max_wave_quantity": 500, + "default_express_code": "STO", + "auto_grouping_enabled": false, + "default_platform_code": "TB", + "delete_order_wave_prefix": "A", + "max_notice_webhook_count": 5, + "min_group_order_fetch_quantity": 13 + }, + "timestamp": 1778058114 + } + }, + { + "接口": "setting.warehouse.getFieldMeta", + "message": "ok", + "code": 1, + "data": { + "flag": "success", + "code": 1, + "message": "ok", + "list": [ + { + "key": "max_notice_webhook_count", + "name": "最大通知 Webhook 次数", + "type": "integer", + "default": 5, + "required": false, + "description": "单次事件最多触发的 Webhook 通知次数(0-5)", + "min": 0, + "max": 5 + }, + { + "key": "max_wave_quantity", + "name": "仓库波次最大数量限制", + "type": "integer", + "default": 500, + "required": false, + "description": "控制单个波次允许的最大订单数量,默认 500", + "min": 1 + }, + { + "key": "min_group_order_fetch_quantity", + "name": "最小团购订单抓取数量", + "type": "integer", + "default": 13, + "required": false, + "description": "控制团购波次最小抓取订单数量,默认 13", + "min": 1 + }, + { + "key": "default_express_code", + "name": "默认快递编码", + "type": "string", + "default": "STO", + "required": false, + "description": "仓库默认使用的快递编码", + "maxLength": 50 + }, + { + "key": "default_platform_code", + "name": "默认平台编码", + "type": "string", + "default": "TB", + "required": false, + "description": "仓库默认使用的平台编码", + "maxLength": 50 + }, + { + "key": "group_wave_prefix", + "name": "团购波次前缀", + "type": "string", + "default": "B", + "required": false, + "description": "团购波次编号前缀,最多 5 个字符,默认 B", + "maxLength": 5 + }, + { + "key": "delete_order_wave_prefix", + "name": "删单波次前缀", + "type": "string", + "default": "A", + "required": false, + "description": "删单波次编号前缀,最多 5 个字符,默认 A", + "maxLength": 5 + }, + { + "key": "webhook_enabled", + "name": "是否启用 Webhook", + "type": "flag", + "default": false, + "required": false, + "description": "控制仓库是否启用 Webhook 事件推送" + }, + { + "key": "callback_strategy", + "name": "回调策略", + "type": "enum", + "default": "async", + "required": false, + "description": "仓库 Webhook 事件的回调执行策略", + "options": [ + { + "value": "sync", + "label": "同步回调" + }, + { + "value": "async", + "label": "异步回调" + } + ] + } + ], + "timestamp": 1778058114 + } + }, + { + "接口": "setting.warehouse.saveSettings", + "message": "subject_config 参数不能为空且必须是对象", + "code": 400, + "data": { + "flag": "failure", + "code": 400, + "message": "subject_config 参数不能为空且必须是对象", + "timestamp": 1778058114 + } } ] } diff --git a/workflows/api-doc-system/core/apidata.mjs b/workflows/api-doc-system/core/apidata.mjs index 4ecb4e28..42ff198b 100644 --- a/workflows/api-doc-system/core/apidata.mjs +++ b/workflows/api-doc-system/core/apidata.mjs @@ -237,23 +237,35 @@ function isResponseMessageOk(message, successMessages) { } /** - * 成功响应中 data 含 list 且列表无元素([] 或 null)时视为「空数据」。 - * 无 list 字段的接口(如登录)不归入此类。 - * @param {unknown} data + * 成功响应中「列表业务数据」为空时视为「空数据」。 + * - 标准包裹:根对象含 `data` 且 `data` 为对象且含 `list` + * - 扁平结构:根对象直接含 `list` + * 无上述 list 字段的接口(如登录、单对象配置)不归入此类。 + * @param {unknown} storedResponse apidata 详情条目中保存的完整响应 JSON */ -function isDataWithEmptyList(data) { - if (!data || typeof data !== "object" || Array.isArray(data)) { +function isDataWithEmptyList(storedResponse) { + if (!storedResponse || typeof storedResponse !== "object" || Array.isArray(storedResponse)) { return false; } - const obj = /** @type {Record} */ (data); - if (!Object.prototype.hasOwnProperty.call(obj, "list")) { - return false; + const root = /** @type {Record} */ (storedResponse); + /** @param {Record} obj */ + const emptyListOn = (obj) => { + if (!Object.prototype.hasOwnProperty.call(obj, "list")) { + return false; + } + const list = obj.list; + if (list == null) { + return true; + } + return Array.isArray(list) && list.length === 0; + }; + const inner = root.data; + if (inner && typeof inner === "object" && !Array.isArray(inner)) { + if (emptyListOn(/** @type {Record} */ (inner))) { + return true; + } } - const list = obj.list; - if (list == null) { - return true; - } - return Array.isArray(list) && list.length === 0; + return emptyListOn(root); } /** @@ -340,7 +352,7 @@ function normalizeConfig(rawConfig) { function printHelp() { console.log(` -apidata — 按 config.json 请求远端并写入 apidata/data.json;默认同时写入 api-doc-agent/config/响应.md(仅含各接口 method 与 data)。 +apidata — 按 config.json 请求远端并写入 apidata/data.json;默认同时写入 api-doc-agent/config/响应.md(仅含各接口 method 与完整响应 JSON)。 快速检查(--quick)不写入 响应.md,且 data.json 仅含「数据一览」、不含「详情」。 成功判定: 响应 message 与「成功判定名单」某项在 trim 且英文忽略大小写后一致即成功(默认含 ok、成功、登录成功)。 @@ -351,7 +363,7 @@ apidata — 按 config.json 请求远端并写入 apidata/data.json;默认同 失败接口: 默认在每条失败记录上附加「模块目录」(来自 data/module-list/module-list.json)、 「api封装」(在 src/api 中匹配到的 export)及「引用页面」(扫描 src/views、src/components、src/layout 下 .vue/.ts/.tsx 的引用路径,相对仓库根)。 -空数据接口: message 判定成功且响应 data 中存在 list 字段且为 [] 或 null 的接口,写入「数据一览.空数据接口」,默认附加信息与失败接口相同。 +空数据接口: message 判定成功且完整响应体中 \`data.list\`(包裹结构)或根级 \`list\` 为 [] 或 null 的接口,写入「数据一览.空数据接口」,默认附加信息与失败接口相同。 快速检查(--quick)下:失败/空数据条目仅含 接口、message、文件(api 封装所在文件路径,去重)、引用页面;不含 模块目录、code、api 封装明细等。 @@ -640,7 +652,7 @@ async function buildAndWriteConfig(opts) { } /** - * 响应.md 仅含「接口 method + 响应 data」,不含数据一览、message 等。 + * 响应.md 仅含「接口 method + 完整响应体」,不含数据一览、message 等。 * @param {Array<{ 接口: string, message?: string, code?: unknown, data: unknown }>} rows */ function buildMethodDataOnlyForMarkdown(rows) { @@ -1095,7 +1107,8 @@ async function runCrawlFromConfigFile(opts = {}) { 接口: req.method, message: isObj ? String(/** @type {{ message?: unknown }} */ (res).message ?? "") : "", code: isObj && "code" in res ? /** @type {{ code?: unknown }} */ (res).code : null, - data: isObj ? /** @type {{ data?: unknown }} */ (res).data ?? null : null, + // 保存服务端返回的完整 JSON,避免仅取 `data` 导致扁平结构接口(如 setting.warehouse.getSettings)丢失主体字段 + data: isObj ? /** @type {Record} */ (res) : res, }); if (quickCheck || result.attempts > 1) { console.log( diff --git a/workflows/api-doc-system/data/interface-details/interface-details.json b/workflows/api-doc-system/data/interface-details/interface-details.json index 08654802..e34ba246 100644 --- a/workflows/api-doc-system/data/interface-details/interface-details.json +++ b/workflows/api-doc-system/data/interface-details/interface-details.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { @@ -12,50 +12,59 @@ "label": "全部" } }, - "totalInterfaceCount": 225, + "totalInterfaceCount": 235, "changes": { "summary": { "moduleAdded": 0, "moduleDeleted": 0, "moduleUpdated": 1, - "interfaceAdded": 1, + "interfaceAdded": 0, "interfaceDeleted": 0, - "interfaceParamsUpdated": 0, - "interfaceResponseUpdated": 0 + "interfaceParamsUpdated": 1, + "interfaceResponseUpdated": 1 }, "moduleUpdates": { "added": [], "deleted": [], "updated": [ { - "moduleName": "订单波次模块", - "moduleKey": "order.wave", - "folder": "order.wave", - "previousModuleName": "订单波次模块", - "previousModuleKey": "order.wave", + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "previousModuleName": "收货单模块", + "previousModuleKey": "storage_receiving", "interfaceChanges": { - "addedMethods": [ - "order.wave.singleOrderFetchList" - ], + "addedMethods": [], "deletedMethods": [], - "paramsUpdatedMethods": [], - "responseUpdatedMethods": [] + "paramsUpdatedMethods": [ + "storage.receiving.detailChange" + ], + "responseUpdatedMethods": [ + "storage.receiving.detailChange" + ] } } ] }, "interfaceUpdates": { - "added": [ + "added": [], + "deleted": [], + "paramsUpdated": [ { - "moduleName": "订单波次模块", - "moduleKey": "order.wave", - "folder": "order.wave", - "method": "order.wave.singleOrderFetchList" + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.detailChange" } ], - "deleted": [], - "paramsUpdated": [], - "responseUpdated": [] + "responseUpdated": [ + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.detailChange" + } + ] } }, "interfaces": [ @@ -3372,6 +3381,354 @@ } ] }, + { + "moduleName": "订单波次模块", + "moduleKey": "order.wave", + "moduleFolder": "order.wave", + "method": "order.wave.batchAllocateExpress", + "title": "提交批次分配快递号任务。该接口为异步任务提交接口,立即返回 task_id,后端异步按当前仓库 + wave_ids 拉取待处理订单并提交到快递号分配流水线。", + "description": "提交批次分配快递号任务。该接口为异步任务提交接口,立即返回 task_id,后端异步按当前仓库 + wave_ids 拉取待处理订单并提交到快递号分配流水线。", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "wave_ids / waveIds / ids", + "type": "array|string|number", + "required": true, + "description": "波次ID列表;支持数组、逗号分隔字符串或单个ID" + }, + { + "name": "task_id / taskId", + "type": "string", + "required": false, + "description": "可选外部任务ID,用于幂等提交" + } + ], + "response": [ + { + "name": "status", + "type": "string", + "required": true, + "description": "提交状态,固定 success" + }, + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID(用于查询任务进度)" + }, + { + "name": "warehouse_id", + "type": "number", + "required": true, + "description": "当前仓库ID" + }, + { + "name": "accepted_at", + "type": "string", + "required": true, + "description": "任务受理时间(ISO8601)" + }, + { + "name": "message", + "type": "string", + "required": false, + "description": "受理提示信息" + } + ] + }, + { + "moduleName": "订单波次模块", + "moduleKey": "order.wave", + "moduleFolder": "order.wave", + "method": "order.wave.batchAllocateExpressTaskProgress", + "title": "查询批次分配快递号任务进度:按 task_id 查询任务状态与统计信息;兼容 taskId 参数名。", + "description": "查询批次分配快递号任务进度:按 task_id 查询任务状态与统计信息;兼容 taskId 参数名。", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "task_id / taskId", + "type": "string", + "required": true, + "description": "任务 ID(后端生成或提交时传入)" + } + ], + "response": [ + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID" + }, + { + "name": "state", + "type": "string", + "required": true, + "description": "任务状态枚举:submitted(已受理)/ running(进行中)/ success(成功)/ failed(失败)/ not_found(未找到)" + }, + { + "name": "warehouse_id", + "type": "number", + "required": false, + "description": "任务关联仓库ID" + }, + { + "name": "total_wave_count", + "type": "number", + "required": false, + "description": "波次数量" + }, + { + "name": "total_order_count", + "type": "number", + "required": false, + "description": "参与分配的订单数量" + }, + { + "name": "processed_order_count", + "type": "number", + "required": false, + "description": "已处理订单数量" + }, + { + "name": "success_order_count", + "type": "number", + "required": false, + "description": "成功提交分配的订单数量" + }, + { + "name": "failed_order_count", + "type": "number", + "required": false, + "description": "提交分配失败的订单数量" + }, + { + "name": "progress_percent", + "type": "number", + "required": false, + "description": "进度百分比(0-100)" + }, + { + "name": "duration_ms", + "type": "number", + "required": false, + "description": "任务耗时(毫秒)" + }, + { + "name": "error_message", + "type": "string", + "required": false, + "description": "失败时的错误信息" + }, + { + "name": "error_code", + "type": "string", + "required": false, + "description": "失败时的错误码" + } + ] + }, + { + "moduleName": "订单波次模块", + "moduleKey": "order.wave", + "moduleFolder": "order.wave", + "method": "order.wave.batchAllocateStorage", + "title": "提交批次分配储位任务。该接口为异步任务提交接口,立即返回 task_id,后端异步按当前仓库 + wave_ids 拉取待处理订单并提交到储位分配流水线。", + "description": "提交批次分配储位任务。该接口为异步任务提交接口,立即返回 task_id,后端异步按当前仓库 + wave_ids 拉取待处理订单并提交到储位分配流水线。", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "wave_ids / waveIds / ids", + "type": "array|string|number", + "required": true, + "description": "波次ID列表;支持数组、逗号分隔字符串或单个ID" + }, + { + "name": "task_id / taskId", + "type": "string", + "required": false, + "description": "可选外部任务ID,用于幂等提交" + } + ], + "response": [ + { + "name": "status", + "type": "string", + "required": true, + "description": "提交状态,固定 success" + }, + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID(用于查询任务进度)" + }, + { + "name": "warehouse_id", + "type": "number", + "required": true, + "description": "当前仓库ID" + }, + { + "name": "accepted_at", + "type": "string", + "required": true, + "description": "任务受理时间(ISO8601)" + }, + { + "name": "message", + "type": "string", + "required": false, + "description": "受理提示信息" + } + ] + }, + { + "moduleName": "订单波次模块", + "moduleKey": "order.wave", + "moduleFolder": "order.wave", + "method": "order.wave.batchAllocateStorageTaskProgress", + "title": "查询批次分配储位任务进度:按 task_id 查询任务状态与统计信息;兼容 taskId 参数名。", + "description": "查询批次分配储位任务进度:按 task_id 查询任务状态与统计信息;兼容 taskId 参数名。", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "task_id / taskId", + "type": "string", + "required": true, + "description": "任务 ID(后端生成或提交时传入)" + } + ], + "response": [ + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID" + }, + { + "name": "state", + "type": "string", + "required": true, + "description": "任务状态枚举:submitted(已受理)/ running(进行中)/ success(成功)/ failed(失败)/ not_found(未找到)" + }, + { + "name": "warehouse_id", + "type": "number", + "required": false, + "description": "任务关联仓库ID" + }, + { + "name": "total_wave_count", + "type": "number", + "required": false, + "description": "波次数量" + }, + { + "name": "total_order_count", + "type": "number", + "required": false, + "description": "参与分配的订单数量" + }, + { + "name": "processed_order_count", + "type": "number", + "required": false, + "description": "已处理订单数量" + }, + { + "name": "success_order_count", + "type": "number", + "required": false, + "description": "成功提交分配的订单数量" + }, + { + "name": "failed_order_count", + "type": "number", + "required": false, + "description": "提交分配失败的订单数量" + }, + { + "name": "progress_percent", + "type": "number", + "required": false, + "description": "进度百分比(0-100)" + }, + { + "name": "duration_ms", + "type": "number", + "required": false, + "description": "任务耗时(毫秒)" + }, + { + "name": "error_message", + "type": "string", + "required": false, + "description": "失败时的错误信息" + }, + { + "name": "error_code", + "type": "string", + "required": false, + "description": "失败时的错误码" + } + ] + }, { "moduleName": "订单波次模块", "moduleKey": "order.wave", @@ -3446,8 +3803,8 @@ "moduleKey": "order.wave", "moduleFolder": "order.wave", "method": "order.wave.batchCancel", - "title": "批量解除波次。传入 ids,清理订单波次ID,并将命中的波次状态置为 -1(已取消)。仅作用于当前登录仓库。", - "description": "批量解除波次。传入 ids,清理订单波次ID,并将命中的波次状态置为 -1(已取消)。仅作用于当前登录仓库。", + "title": "提交批量解除波次异步任务。该接口为异步任务提交接口,立即返回 task_id,后端异步按当前仓库 + wave_ids 拉取待处理波次并执行解除操作;可通过 order.wave.batchCancelTaskProgress 查询进度与结果。", + "description": "提交批量解除波次异步任务。该接口为异步任务提交接口,立即返回 task_id,后端异步按当前仓库 + wave_ids 拉取待处理波次并执行解除操作;可通过 order.wave.batchCancelTaskProgress 查询进度与结果。", "endpoint": "/system", "authRequired": false, "loginRequired": true, @@ -3465,36 +3822,135 @@ ], "params": [ { - "name": "ids", + "name": "wave_ids / waveIds / ids", "type": "array|string|number", "required": true, "description": "波次ID列表;支持数组、逗号分隔字符串或单个ID" + }, + { + "name": "task_id / taskId", + "type": "string", + "required": false, + "description": "可选外部任务ID,用于幂等提交" } ], "response": [ { - "name": "ids", - "type": "array", - "required": false, - "description": "归一化后的请求ID列表" + "name": "status", + "type": "string", + "required": true, + "description": "提交状态,固定 success" }, { - "name": "affected_wave_ids", - "type": "array", - "required": false, - "description": "实际命中的波次ID列表" + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID(用于查询任务进度)" }, { - "name": "affected_order_count", + "name": "warehouse_id", + "type": "number", + "required": true, + "description": "当前仓库ID" + }, + { + "name": "accepted_at", + "type": "string", + "required": true, + "description": "任务受理时间(ISO8601)" + }, + { + "name": "message", + "type": "string", + "required": false, + "description": "受理提示信息" + } + ] + }, + { + "moduleName": "订单波次模块", + "moduleKey": "order.wave", + "moduleFolder": "order.wave", + "method": "order.wave.batchCancelTaskProgress", + "title": "查询批量解除波次任务进度:按 task_id 查询任务状态与统计信息;兼容 taskId 参数名。响应包含 state、progress_percent、processed_wave_count、total_wave_count;当 state 为 success/failed 时返回额外字段说明。", + "description": "查询批量解除波次任务进度:按 task_id 查询任务状态与统计信息;兼容 taskId 参数名。响应包含 state、progress_percent、processed_wave_count、total_wave_count;当 state 为 success/failed 时返回额外字段说明。", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "task_id / taskId", + "type": "string", + "required": true, + "description": "任务 ID(后端生成或提交时传入)" + } + ], + "response": [ + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID" + }, + { + "name": "state", + "type": "string", + "required": true, + "description": "任务状态枚举:submitted(已受理)/ running(进行中)/ success(成功)/ failed(失败)/ not_found(未找到)" + }, + { + "name": "progress_percent", "type": "number", "required": false, - "description": "被清理 wave_id 的订单数量" + "description": "进度百分比(0-100)" }, { - "name": "canceled_wave_count", + "name": "processed_wave_count", "type": "number", "required": false, - "description": "实际置为 -1 的波次数量" + "description": "已处理的波次数量" + }, + { + "name": "total_wave_count", + "type": "number", + "required": false, + "description": "总波次数量" + }, + { + "name": "duration_ms", + "type": "number", + "required": false, + "description": "任务耗时(毫秒)" + }, + { + "name": "error_message", + "type": "string", + "required": false, + "description": "失败时的错误信息(仅在 state=failed 时返回)" + }, + { + "name": "error_code", + "type": "string", + "required": false, + "description": "失败时的错误码(仅在 state=failed 时返回)" + }, + { + "name": "result", + "type": "object", + "required": false, + "description": "成功时返回的汇总结果(仅在 state=success 时返回),例如 { \"processed_wave_count\": number, \"canceled_wave_count\": number }" } ] }, @@ -3588,7 +4044,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(范围)" + "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(范围) - storage_assignment_status(等值,string,可选,取值:未分配、部分分配、已分配;默认不传不做限制)。过滤语义:已分配=聚合后全部 fin;部分分配=不含 error,且既不是全 none,也不是全 fin;未分配=全 none 或包含 error(异常并入未分配筛选集合)。说明:返回字段 storage_assignment_status 的展示值保持不变,包含 error 时仍可显示“分配异常”;此处 where 的过滤语义会把异常计入“未分配”,以避免把过滤语义与展示值混淆。" } ], "response": [ @@ -3606,6 +4062,180 @@ } ] }, + { + "moduleName": "订单波次模块", + "moduleKey": "order.wave", + "moduleFolder": "order.wave", + "method": "order.wave.batchRemoveExceptionOrders", + "title": "提交批次移除异常订单任务。该接口为异步任务提交接口,立即返回 task_id,后端异步按当前仓库 + wave_ids 拉取异常订单并移出波次。", + "description": "提交批次移除异常订单任务。该接口为异步任务提交接口,立即返回 task_id,后端异步按当前仓库 + wave_ids 拉取异常订单并移出波次。", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "wave_ids / waveIds / ids", + "type": "array|string|number", + "required": true, + "description": "波次ID列表;支持数组、逗号分隔字符串或单个ID" + }, + { + "name": "task_id / taskId", + "type": "string", + "required": false, + "description": "可选外部任务ID,用于幂等提交" + } + ], + "response": [ + { + "name": "status", + "type": "string", + "required": true, + "description": "提交状态,固定 success" + }, + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID(用于查询任务进度)" + }, + { + "name": "warehouse_id", + "type": "number", + "required": true, + "description": "当前仓库ID" + }, + { + "name": "accepted_at", + "type": "string", + "required": true, + "description": "任务受理时间(ISO8601)" + }, + { + "name": "message", + "type": "string", + "required": false, + "description": "受理提示信息" + } + ] + }, + { + "moduleName": "订单波次模块", + "moduleKey": "order.wave", + "moduleFolder": "order.wave", + "method": "order.wave.batchRemoveExceptionOrdersTaskProgress", + "title": "查询批次移除异常订单任务进度:按 task_id 查询任务状态与统计信息;兼容 taskId 参数名。", + "description": "查询批次移除异常订单任务进度:按 task_id 查询任务状态与统计信息;兼容 taskId 参数名。", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "task_id / taskId", + "type": "string", + "required": true, + "description": "任务 ID(后端生成或提交时传入)" + } + ], + "response": [ + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID" + }, + { + "name": "state", + "type": "string", + "required": true, + "description": "任务状态枚举:submitted(已受理)/ running(进行中)/ success(成功)/ failed(失败)/ not_found(未找到)" + }, + { + "name": "warehouse_id", + "type": "number", + "required": false, + "description": "任务关联仓库ID" + }, + { + "name": "total_wave_count", + "type": "number", + "required": false, + "description": "波次数量" + }, + { + "name": "total_order_count", + "type": "number", + "required": false, + "description": "参与处理的订单数量" + }, + { + "name": "processed_order_count", + "type": "number", + "required": false, + "description": "已处理订单数量" + }, + { + "name": "removed_order_count", + "type": "number", + "required": false, + "description": "已成功移出波次的订单数量" + }, + { + "name": "failed_order_count", + "type": "number", + "required": false, + "description": "处理失败的订单数量" + }, + { + "name": "progress_percent", + "type": "number", + "required": false, + "description": "进度百分比(0-100)" + }, + { + "name": "duration_ms", + "type": "number", + "required": false, + "description": "任务耗时(毫秒)" + }, + { + "name": "error_message", + "type": "string", + "required": false, + "description": "失败时的错误信息" + }, + { + "name": "error_code", + "type": "string", + "required": false, + "description": "失败时的错误码" + } + ] + }, { "moduleName": "订单波次模块", "moduleKey": "order.wave", @@ -3680,8 +4310,8 @@ "moduleKey": "order.wave", "moduleFolder": "order.wave", "method": "order.wave.fetch", - "title": "提交波次抓取任务:该接口为异步任务提交接口,立即返回任务已受理的信息,后端异步执行实际抓取,不在接口同步返回抓取结果。客户端可通过任务 ID 或调用 order.wave.fetchTaskProgress 查询任务状态与进度。", - "description": "提交波次抓取任务:该接口为异步任务提交接口,立即返回任务已受理的信息,后端异步执行实际抓取,不在接口同步返回抓取结果。客户端可通过任务 ID 或调用 order.wave.fetchTaskProgress 查询任务状态与进度。", + "title": "兼容别名(等同 groupFetch)", + "description": "兼容别名(等同 groupFetch)", "endpoint": "/system", "authRequired": false, "loginRequired": true, @@ -3736,6 +4366,12 @@ "required": true, "description": "手动抓取标记;值为 'wave_manual_fetch' 表示手动抓取" }, + { + "name": "fetch_mode", + "type": "string", + "required": false, + "description": "抓取模式,值为 'group'(团购)或 'single'(散单)" + }, { "name": "message", "type": "string", @@ -3829,6 +4465,30 @@ "required": false, "description": "错误信息,仅当 status=failed 时返回" }, + { + "name": "fetch_mode", + "type": "string", + "required": false, + "description": "抓取模式,值为 'group'(团购)或 'single'(散单);single 模式时可能返回下列额外字段" + }, + { + "name": "max_fetch_quantity", + "type": "number", + "required": false, + "description": "当 fetch_mode=single 时返回的最大抓取上限(订单数,正整数)" + }, + { + "name": "limit_reached", + "type": "boolean", + "required": false, + "description": "当 fetch_mode=single 时指示是否已达到 max_fetch_quantity 限制" + }, + { + "name": "stop_reason", + "type": "string", + "required": false, + "description": "任务停止原因(如达到上限、人工停止或其他失败原因)" + }, { "name": "update_time", "type": "string", @@ -3843,6 +4503,81 @@ } ] }, + { + "moduleName": "订单波次模块", + "moduleKey": "order.wave", + "moduleFolder": "order.wave", + "method": "order.wave.groupFetch", + "title": "抓取团购接口(异步任务提交)", + "description": "抓取团购接口(异步任务提交)", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "structure_list", + "type": "array", + "required": true, + "description": "结构请求数组;每项必须包含 item_detail_machine(由 buildMachineStructureToken 生成的结构标识),可选 quantity(未传入时使用仓库默认或全局默认)" + } + ], + "response": [ + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID(后端生成的唯一标识,用于查询任务状态或结果)" + }, + { + "name": "warehouse_id", + "type": "number", + "required": true, + "description": "生效的仓库 ID" + }, + { + "name": "structure_count", + "type": "number", + "required": true, + "description": "本次入参的结构数量(structure_list 长度)" + }, + { + "name": "default_quantity", + "type": "number", + "required": true, + "description": "仓库默认抓取数量或全局默认值" + }, + { + "name": "auto_fetch_disabled_marker", + "type": "string", + "required": true, + "description": "手动抓取标记;值为 'wave_manual_fetch' 表示手动抓取" + }, + { + "name": "fetch_mode", + "type": "string", + "required": false, + "description": "抓取模式,值为 'group'(团购)或 'single'(散单)" + }, + { + "name": "message", + "type": "string", + "required": false, + "description": "受理信息提示,通常为 '任务已提交,后端异步处理中' 或失败/错误说明" + } + ] + }, { "moduleName": "订单波次模块", "moduleKey": "order.wave", @@ -3924,6 +4659,168 @@ } ] }, + { + "moduleName": "订单波次模块", + "moduleKey": "order.wave", + "moduleFolder": "order.wave", + "method": "order.wave.singleFetch", + "title": "抓取散单接口(异步任务提交)", + "description": "抓取散单接口(异步任务提交)", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "structure_list", + "type": "array", + "required": true, + "description": "结构请求数组;每项必须包含 item_detail_machine(由 buildMachineStructureToken 生成的结构标识)并包含必填字段 max_fetch_quantity(最大抓取上限,订单数,正整数);可选 quantity(未传入时使用仓库默认或全局默认)" + } + ], + "response": [ + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID(后端生成的唯一标识,用于查询任务状态或结果)" + }, + { + "name": "warehouse_id", + "type": "number", + "required": true, + "description": "生效的仓库 ID" + }, + { + "name": "structure_count", + "type": "number", + "required": true, + "description": "本次入参的结构数量(structure_list 长度)" + }, + { + "name": "default_quantity", + "type": "number", + "required": true, + "description": "仓库默认抓取数量或全局默认值" + }, + { + "name": "auto_fetch_disabled_marker", + "type": "string", + "required": true, + "description": "手动抓取标记;值为 'wave_manual_fetch' 表示手动抓取" + }, + { + "name": "fetch_mode", + "type": "string", + "required": false, + "description": "抓取模式,值为 'group'(团购)或 'single'(散单)" + }, + { + "name": "max_fetch_quantity", + "type": "number", + "required": false, + "description": "提交时生效的最大抓取上限(订单数,正整数)" + }, + { + "name": "message", + "type": "string", + "required": false, + "description": "受理信息提示,通常为 '任务已提交,后端异步处理中' 或失败/错误说明" + } + ] + }, + { + "moduleName": "订单波次模块", + "moduleKey": "order.wave", + "moduleFolder": "order.wave", + "method": "order.wave.singleFetchByIds", + "title": "按订单 ID 列表抓取到一个散单波次。仅处理当前仓库的待处理订单(step in [1,2,3]),排除已在波次中的订单(wave_id>0),不区分快递;成功抓取后批量写入订单操作日志;当无可抓取订单时返回 wave_id=0。", + "description": "按订单 ID 列表抓取到一个散单波次。仅处理当前仓库的待处理订单(step in [1,2,3]),排除已在波次中的订单(wave_id>0),不区分快递;成功抓取后批量写入订单操作日志;当无可抓取订单时返回 wave_id=0。", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "ids / order_ids / orderIds", + "type": "array|string|number", + "required": true, + "description": "订单ID列表,支持数组、逗号分隔字符串或单个ID;优先使用 ids 字段" + } + ], + "response": [ + { + "name": "ids", + "type": "array", + "required": true, + "description": "请求归一化后的 ids 列表(去重且为正整数)" + }, + { + "name": "wave_id", + "type": "number", + "required": true, + "description": "创建的波次 ID;若无可抓取订单返回 0" + }, + { + "name": "wave_no", + "type": "string", + "required": true, + "description": "创建的波次号;无可抓取时为空字符串" + }, + { + "name": "fetched_order_ids", + "type": "array", + "required": true, + "description": "实际被抓取并分配到波次的订单ID列表" + }, + { + "name": "fetched_order_count", + "type": "number", + "required": true, + "description": "实际被抓取的订单数量" + }, + { + "name": "excluded_existing_wave_order_ids", + "type": "array", + "required": false, + "description": "原始入参中已在其它波次中的订单ID(被排除)" + }, + { + "name": "skipped_order_ids", + "type": "array", + "required": false, + "description": "未被抓取的订单ID(包括已存在波次、状态不符或出库中等)" + }, + { + "name": "not_found_order_ids", + "type": "array", + "required": false, + "description": "入参中未在数据库中找到的订单ID" + } + ] + }, { "moduleName": "订单波次模块", "moduleKey": "order.wave", @@ -8129,6 +9026,18 @@ "required": false, "description": "箱长" }, + { + "name": "box_remainder", + "type": "number", + "required": false, + "description": "箱内剩余数量/零散数量(不满箱时的件数)" + }, + { + "name": "box_weight", + "type": "number", + "required": false, + "description": "实测箱重(单位与系统重量一致,如 kg)" + }, { "name": "weight", "type": "number", @@ -8173,6 +9082,18 @@ "required": false, "description": "系统商品 ID" }, + { + "name": "data.box_remainder", + "type": "number", + "required": false, + "description": "箱内剩余数量/零散数量(不满箱时的件数)" + }, + { + "name": "data.box_weight", + "type": "number", + "required": false, + "description": "实测箱重(单位与系统重量一致,如 kg)" + }, { "name": "data.updated_at", "type": "string", @@ -8879,8 +9800,8 @@ "moduleKey": "store", "moduleFolder": "store", "method": "store.createStore", - "title": "store.createStore 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB、group_wave_prefix=B、min_group_order_fetch_quantity=13", - "description": "store.createStore 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB、group_wave_prefix=B、min_group_order_fetch_quantity=13", + "title": "store.createStore 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB、group_wave_prefix=B、min_group_order_fetch_quantity=13、auto_grouping_enabled=false(是否自动加团,默认 false(关闭))", + "description": "store.createStore 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB、group_wave_prefix=B、min_group_order_fetch_quantity=13、auto_grouping_enabled=false(是否自动加团,默认 false(关闭))", "endpoint": "/system", "authRequired": false, "loginRequired": true, @@ -8932,6 +9853,12 @@ "type": "number", "required": false, "description": "最小团购订单抓取数量,默认 13" + }, + { + "name": "subject_config.auto_grouping_enabled", + "type": "boolean", + "required": false, + "description": "是否自动加团,默认 false(关闭)" } ], "response": [] @@ -8941,8 +9868,8 @@ "moduleKey": "store", "moduleFolder": "store", "method": "store.createWarehouse", - "title": "store.createWarehouse 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB、group_wave_prefix=B、min_group_order_fetch_quantity=13", - "description": "store.createWarehouse 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB、group_wave_prefix=B、min_group_order_fetch_quantity=13", + "title": "store.createWarehouse 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB、group_wave_prefix=B、min_group_order_fetch_quantity=13、auto_grouping_enabled=false(是否自动加团,默认 false(关闭))", + "description": "store.createWarehouse 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB、group_wave_prefix=B、min_group_order_fetch_quantity=13、auto_grouping_enabled=false(是否自动加团,默认 false(关闭))", "endpoint": "/system", "authRequired": false, "loginRequired": true, @@ -8994,6 +9921,12 @@ "type": "number", "required": false, "description": "最小团购订单抓取数量,默认 13" + }, + { + "name": "subject_config.auto_grouping_enabled", + "type": "boolean", + "required": false, + "description": "是否自动加团,默认 false(关闭)" } ], "response": [] @@ -9676,7 +10609,7 @@ "name": "policy_config", "type": "object", "required": true, - "description": "策略配置对象;仅支持 receive_mode、auto_allocate_bin、allow_mix_batch、allow_temp_storage、storage_separation、print_recharge_price(面单充值元/单,支持 2 位小数)、max_daily_inbound、remark" + "description": "策略配置对象;仅支持 receive_mode、auto_allocate_bin、auto_allocate_express(是否自动分配快递)、auto_allocate_storage(是否自动分配储位)、allow_mix_batch、allow_temp_storage、storage_separation、print_recharge_price(面单充值元/单,支持 2 位小数)、max_daily_inbound、remark" } ], "response": [] diff --git a/workflows/api-doc-system/data/module-list/module-list.json b/workflows/api-doc-system/data/module-list/module-list.json index 6a90918d..a5278d68 100644 --- a/workflows/api-doc-system/data/module-list/module-list.json +++ b/workflows/api-doc-system/data/module-list/module-list.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { @@ -13,50 +13,59 @@ } }, "moduleCount": 34, - "totalInterfaceCount": 225, + "totalInterfaceCount": 235, "changes": { "summary": { "moduleAdded": 0, "moduleDeleted": 0, "moduleUpdated": 1, - "interfaceAdded": 1, + "interfaceAdded": 0, "interfaceDeleted": 0, - "interfaceParamsUpdated": 0, - "interfaceResponseUpdated": 0 + "interfaceParamsUpdated": 1, + "interfaceResponseUpdated": 1 }, "moduleUpdates": { "added": [], "deleted": [], "updated": [ { - "moduleName": "订单波次模块", - "moduleKey": "order.wave", - "folder": "order.wave", - "previousModuleName": "订单波次模块", - "previousModuleKey": "order.wave", + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "previousModuleName": "收货单模块", + "previousModuleKey": "storage_receiving", "interfaceChanges": { - "addedMethods": [ - "order.wave.singleOrderFetchList" - ], + "addedMethods": [], "deletedMethods": [], - "paramsUpdatedMethods": [], - "responseUpdatedMethods": [] + "paramsUpdatedMethods": [ + "storage.receiving.detailChange" + ], + "responseUpdatedMethods": [ + "storage.receiving.detailChange" + ] } } ] }, "interfaceUpdates": { - "added": [ + "added": [], + "deleted": [], + "paramsUpdated": [ { - "moduleName": "订单波次模块", - "moduleKey": "order.wave", - "folder": "order.wave", - "method": "order.wave.singleOrderFetchList" + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.detailChange" } ], - "deleted": [], - "paramsUpdated": [], - "responseUpdated": [] + "responseUpdated": [ + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.detailChange" + } + ] } }, "modules": [ @@ -303,11 +312,14 @@ "moduleName": "订单波次模块", "moduleKey": "order.wave", "folder": "order.wave", - "interfaceCount": 9, + "interfaceCount": 19, "interfaces": [ { "method": "order.wave.groupOrderFetchList" }, + { + "method": "order.wave.singleFetchByIds" + }, { "method": "order.wave.singleOrderFetchList" }, @@ -317,6 +329,33 @@ { "method": "order.wave.batchCancel" }, + { + "method": "order.wave.batchCancelTaskProgress" + }, + { + "method": "order.wave.batchAllocateExpress" + }, + { + "method": "order.wave.batchAllocateExpressTaskProgress" + }, + { + "method": "order.wave.batchRemoveExceptionOrders" + }, + { + "method": "order.wave.batchRemoveExceptionOrdersTaskProgress" + }, + { + "method": "order.wave.batchAllocateStorage" + }, + { + "method": "order.wave.batchAllocateStorageTaskProgress" + }, + { + "method": "order.wave.groupFetch" + }, + { + "method": "order.wave.singleFetch" + }, { "method": "order.wave.fetch" }, diff --git a/workflows/api-doc-system/data/module/config/_module.lifecycle.json b/workflows/api-doc-system/data/module/config/_module.lifecycle.json index a6a1ee07..d7b9e864 100644 --- a/workflows/api-doc-system/data/module/config/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/config/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/config/module.json b/workflows/api-doc-system/data/module/config/module.json index de6a6628..66447c86 100644 --- a/workflows/api-doc-system/data/module/config/module.json +++ b/workflows/api-doc-system/data/module/config/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/dashboard/_module.lifecycle.json b/workflows/api-doc-system/data/module/dashboard/_module.lifecycle.json index 03bdeddd..1cac2fbc 100644 --- a/workflows/api-doc-system/data/module/dashboard/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/dashboard/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/dashboard/module.json b/workflows/api-doc-system/data/module/dashboard/module.json index 12c20e33..63eed445 100644 --- a/workflows/api-doc-system/data/module/dashboard/module.json +++ b/workflows/api-doc-system/data/module/dashboard/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/index/_module.lifecycle.json b/workflows/api-doc-system/data/module/index/_module.lifecycle.json index 96cf4a4e..9629156f 100644 --- a/workflows/api-doc-system/data/module/index/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/index/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/index/module.json b/workflows/api-doc-system/data/module/index/module.json index ae048896..2d8b3f5f 100644 --- a/workflows/api-doc-system/data/module/index/module.json +++ b/workflows/api-doc-system/data/module/index/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/order.archiveorder/_module.lifecycle.json b/workflows/api-doc-system/data/module/order.archiveorder/_module.lifecycle.json index 3de077d1..661de68d 100644 --- a/workflows/api-doc-system/data/module/order.archiveorder/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/order.archiveorder/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": "2026-04-17 19:16:50" } diff --git a/workflows/api-doc-system/data/module/order.archiveorder/module.json b/workflows/api-doc-system/data/module/order.archiveorder/module.json index c366c21f..312eb172 100644 --- a/workflows/api-doc-system/data/module/order.archiveorder/module.json +++ b/workflows/api-doc-system/data/module/order.archiveorder/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/order.deliveryexpectionorder/_module.lifecycle.json b/workflows/api-doc-system/data/module/order.deliveryexpectionorder/_module.lifecycle.json index 93e58c42..101aa2ba 100644 --- a/workflows/api-doc-system/data/module/order.deliveryexpectionorder/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/order.deliveryexpectionorder/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": "2026-04-17 19:16:50" } diff --git a/workflows/api-doc-system/data/module/order.deliveryexpectionorder/module.json b/workflows/api-doc-system/data/module/order.deliveryexpectionorder/module.json index 9a8a53ec..b3b4eb61 100644 --- a/workflows/api-doc-system/data/module/order.deliveryexpectionorder/module.json +++ b/workflows/api-doc-system/data/module/order.deliveryexpectionorder/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/order.deliveryorder/_module.lifecycle.json b/workflows/api-doc-system/data/module/order.deliveryorder/_module.lifecycle.json index 505aec86..3f2bf98c 100644 --- a/workflows/api-doc-system/data/module/order.deliveryorder/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/order.deliveryorder/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": "2026-04-17 19:16:50" } diff --git a/workflows/api-doc-system/data/module/order.deliveryorder/module.json b/workflows/api-doc-system/data/module/order.deliveryorder/module.json index f9389985..3e09c3d5 100644 --- a/workflows/api-doc-system/data/module/order.deliveryorder/module.json +++ b/workflows/api-doc-system/data/module/order.deliveryorder/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/order.entrustorder/_module.lifecycle.json b/workflows/api-doc-system/data/module/order.entrustorder/_module.lifecycle.json index 77623dd5..e7ba7c50 100644 --- a/workflows/api-doc-system/data/module/order.entrustorder/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/order.entrustorder/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": "2026-04-17 19:16:50" } diff --git a/workflows/api-doc-system/data/module/order.entrustorder/module.json b/workflows/api-doc-system/data/module/order.entrustorder/module.json index f53f6208..ffe61cb0 100644 --- a/workflows/api-doc-system/data/module/order.entrustorder/module.json +++ b/workflows/api-doc-system/data/module/order.entrustorder/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/order.expectionorder/_module.lifecycle.json b/workflows/api-doc-system/data/module/order.expectionorder/_module.lifecycle.json index 8fe0577f..420b86d3 100644 --- a/workflows/api-doc-system/data/module/order.expectionorder/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/order.expectionorder/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": "2026-04-17 19:16:50" } diff --git a/workflows/api-doc-system/data/module/order.expectionorder/module.json b/workflows/api-doc-system/data/module/order.expectionorder/module.json index c5f0d043..6080f116 100644 --- a/workflows/api-doc-system/data/module/order.expectionorder/module.json +++ b/workflows/api-doc-system/data/module/order.expectionorder/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/order.index/_module.lifecycle.json b/workflows/api-doc-system/data/module/order.index/_module.lifecycle.json index 87354fd8..0c753395 100644 --- a/workflows/api-doc-system/data/module/order.index/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/order.index/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": "2026-04-17 19:16:50" } diff --git a/workflows/api-doc-system/data/module/order.index/module.json b/workflows/api-doc-system/data/module/order.index/module.json index 1f6e563b..f3da9c9b 100644 --- a/workflows/api-doc-system/data/module/order.index/module.json +++ b/workflows/api-doc-system/data/module/order.index/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/order.outboundorder/_module.lifecycle.json b/workflows/api-doc-system/data/module/order.outboundorder/_module.lifecycle.json index a168ae5d..e95a422b 100644 --- a/workflows/api-doc-system/data/module/order.outboundorder/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/order.outboundorder/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": "2026-04-17 19:16:50" } diff --git a/workflows/api-doc-system/data/module/order.outboundorder/module.json b/workflows/api-doc-system/data/module/order.outboundorder/module.json index 0190d7e2..b0b81baa 100644 --- a/workflows/api-doc-system/data/module/order.outboundorder/module.json +++ b/workflows/api-doc-system/data/module/order.outboundorder/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/order.pendingorder/_module.lifecycle.json b/workflows/api-doc-system/data/module/order.pendingorder/_module.lifecycle.json index c2dcace4..ae80884e 100644 --- a/workflows/api-doc-system/data/module/order.pendingorder/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/order.pendingorder/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": "2026-04-17 19:16:50" } diff --git a/workflows/api-doc-system/data/module/order.pendingorder/module.json b/workflows/api-doc-system/data/module/order.pendingorder/module.json index c5193a58..c6d21f60 100644 --- a/workflows/api-doc-system/data/module/order.pendingorder/module.json +++ b/workflows/api-doc-system/data/module/order.pendingorder/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/order.print/_module.lifecycle.json b/workflows/api-doc-system/data/module/order.print/_module.lifecycle.json index bd70fec6..b180d4bf 100644 --- a/workflows/api-doc-system/data/module/order.print/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/order.print/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-05-05 09:15:19", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/order.print/module.json b/workflows/api-doc-system/data/module/order.print/module.json index 4af8bd35..0f19d1c6 100644 --- a/workflows/api-doc-system/data/module/order.print/module.json +++ b/workflows/api-doc-system/data/module/order.print/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/order.revieworder/_module.lifecycle.json b/workflows/api-doc-system/data/module/order.revieworder/_module.lifecycle.json index c8eb4068..60dbb4ee 100644 --- a/workflows/api-doc-system/data/module/order.revieworder/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/order.revieworder/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": "2026-04-17 19:16:50" } diff --git a/workflows/api-doc-system/data/module/order.revieworder/module.json b/workflows/api-doc-system/data/module/order.revieworder/module.json index ef17255e..d512bffa 100644 --- a/workflows/api-doc-system/data/module/order.revieworder/module.json +++ b/workflows/api-doc-system/data/module/order.revieworder/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/order.wave/_module.lifecycle.json b/workflows/api-doc-system/data/module/order.wave/_module.lifecycle.json index 21d9a103..fec78658 100644 --- a/workflows/api-doc-system/data/module/order.wave/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/order.wave/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-05-04 09:11:04", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/order.wave/module.json b/workflows/api-doc-system/data/module/order.wave/module.json index 8f6d8a0e..03770235 100644 --- a/workflows/api-doc-system/data/module/order.wave/module.json +++ b/workflows/api-doc-system/data/module/order.wave/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { @@ -16,16 +16,14 @@ "name": "订单波次模块", "key": "order.wave", "folder": "order.wave", - "interfaceCount": 9 + "interfaceCount": 19 }, "changes": { "fromPreviousSnapshot": { "moduleAdded": false, "moduleRenamed": false, "interfaceChanges": { - "addedMethods": [ - "order.wave.singleOrderFetchList" - ], + "addedMethods": [], "deletedMethods": [], "paramsUpdatedMethods": [], "responseUpdatedMethods": [] @@ -111,6 +109,84 @@ } ] }, + { + "method": "order.wave.singleFetchByIds", + "title": "按订单 ID 列表抓取到一个散单波次。仅处理当前仓库的待处理订单(step in [1,2,3]),排除已在波次中的订单(wave_id>0),不区分快递;成功抓取后批量写入订单操作日志;当无可抓取订单时返回 wave_id=0。", + "description": "按订单 ID 列表抓取到一个散单波次。仅处理当前仓库的待处理订单(step in [1,2,3]),排除已在波次中的订单(wave_id>0),不区分快递;成功抓取后批量写入订单操作日志;当无可抓取订单时返回 wave_id=0。", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "ids / order_ids / orderIds", + "type": "array|string|number", + "required": true, + "description": "订单ID列表,支持数组、逗号分隔字符串或单个ID;优先使用 ids 字段" + } + ], + "response": [ + { + "name": "ids", + "type": "array", + "required": true, + "description": "请求归一化后的 ids 列表(去重且为正整数)" + }, + { + "name": "wave_id", + "type": "number", + "required": true, + "description": "创建的波次 ID;若无可抓取订单返回 0" + }, + { + "name": "wave_no", + "type": "string", + "required": true, + "description": "创建的波次号;无可抓取时为空字符串" + }, + { + "name": "fetched_order_ids", + "type": "array", + "required": true, + "description": "实际被抓取并分配到波次的订单ID列表" + }, + { + "name": "fetched_order_count", + "type": "number", + "required": true, + "description": "实际被抓取的订单数量" + }, + { + "name": "excluded_existing_wave_order_ids", + "type": "array", + "required": false, + "description": "原始入参中已在其它波次中的订单ID(被排除)" + }, + { + "name": "skipped_order_ids", + "type": "array", + "required": false, + "description": "未被抓取的订单ID(包括已存在波次、状态不符或出库中等)" + }, + { + "name": "not_found_order_ids", + "type": "array", + "required": false, + "description": "入参中未在数据库中找到的订单ID" + } + ] + }, { "method": "order.wave.singleOrderFetchList", "title": "按机器结构分组的散单候选列表。仅处理待处理订单(排除待审核),且排除已在波次中的订单。与 order.wave.groupOrderFetchList 不同:groupOrderFetchList 返回满足同组订单数量 >= same_order_quantity(或仓库配置 min_group_order_fetch_quantity)的团购命中分组;singleOrderFetchList 则排除这些团购命中分组,仅返回同组订单数量小于该阈值的散单候选分组(即 < same_order_quantity)。", @@ -219,7 +295,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(范围)" + "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(范围) - storage_assignment_status(等值,string,可选,取值:未分配、部分分配、已分配;默认不传不做限制)。过滤语义:已分配=聚合后全部 fin;部分分配=不含 error,且既不是全 none,也不是全 fin;未分配=全 none 或包含 error(异常并入未分配筛选集合)。说明:返回字段 storage_assignment_status 的展示值保持不变,包含 error 时仍可显示“分配异常”;此处 where 的过滤语义会把异常计入“未分配”,以避免把过滤语义与展示值混淆。" } ], "response": [ @@ -239,8 +315,8 @@ }, { "method": "order.wave.batchCancel", - "title": "批量解除波次。传入 ids,清理订单波次ID,并将命中的波次状态置为 -1(已取消)。仅作用于当前登录仓库。", - "description": "批量解除波次。传入 ids,清理订单波次ID,并将命中的波次状态置为 -1(已取消)。仅作用于当前登录仓库。", + "title": "提交批量解除波次异步任务。该接口为异步任务提交接口,立即返回 task_id,后端异步按当前仓库 + wave_ids 拉取待处理波次并执行解除操作;可通过 order.wave.batchCancelTaskProgress 查询进度与结果。", + "description": "提交批量解除波次异步任务。该接口为异步任务提交接口,立即返回 task_id,后端异步按当前仓库 + wave_ids 拉取待处理波次并执行解除操作;可通过 order.wave.batchCancelTaskProgress 查询进度与结果。", "endpoint": "/system", "authRequired": false, "loginRequired": true, @@ -258,43 +334,643 @@ ], "params": [ { - "name": "ids", + "name": "wave_ids / waveIds / ids", "type": "array|string|number", "required": true, "description": "波次ID列表;支持数组、逗号分隔字符串或单个ID" + }, + { + "name": "task_id / taskId", + "type": "string", + "required": false, + "description": "可选外部任务ID,用于幂等提交" } ], "response": [ { - "name": "ids", - "type": "array", - "required": false, - "description": "归一化后的请求ID列表" + "name": "status", + "type": "string", + "required": true, + "description": "提交状态,固定 success" }, { - "name": "affected_wave_ids", - "type": "array", - "required": false, - "description": "实际命中的波次ID列表" + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID(用于查询任务进度)" }, { - "name": "affected_order_count", + "name": "warehouse_id", "type": "number", - "required": false, - "description": "被清理 wave_id 的订单数量" + "required": true, + "description": "当前仓库ID" }, { - "name": "canceled_wave_count", - "type": "number", + "name": "accepted_at", + "type": "string", + "required": true, + "description": "任务受理时间(ISO8601)" + }, + { + "name": "message", + "type": "string", "required": false, - "description": "实际置为 -1 的波次数量" + "description": "受理提示信息" } ] }, { - "method": "order.wave.fetch", - "title": "提交波次抓取任务:该接口为异步任务提交接口,立即返回任务已受理的信息,后端异步执行实际抓取,不在接口同步返回抓取结果。客户端可通过任务 ID 或调用 order.wave.fetchTaskProgress 查询任务状态与进度。", - "description": "提交波次抓取任务:该接口为异步任务提交接口,立即返回任务已受理的信息,后端异步执行实际抓取,不在接口同步返回抓取结果。客户端可通过任务 ID 或调用 order.wave.fetchTaskProgress 查询任务状态与进度。", + "method": "order.wave.batchCancelTaskProgress", + "title": "查询批量解除波次任务进度:按 task_id 查询任务状态与统计信息;兼容 taskId 参数名。响应包含 state、progress_percent、processed_wave_count、total_wave_count;当 state 为 success/failed 时返回额外字段说明。", + "description": "查询批量解除波次任务进度:按 task_id 查询任务状态与统计信息;兼容 taskId 参数名。响应包含 state、progress_percent、processed_wave_count、total_wave_count;当 state 为 success/failed 时返回额外字段说明。", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "task_id / taskId", + "type": "string", + "required": true, + "description": "任务 ID(后端生成或提交时传入)" + } + ], + "response": [ + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID" + }, + { + "name": "state", + "type": "string", + "required": true, + "description": "任务状态枚举:submitted(已受理)/ running(进行中)/ success(成功)/ failed(失败)/ not_found(未找到)" + }, + { + "name": "progress_percent", + "type": "number", + "required": false, + "description": "进度百分比(0-100)" + }, + { + "name": "processed_wave_count", + "type": "number", + "required": false, + "description": "已处理的波次数量" + }, + { + "name": "total_wave_count", + "type": "number", + "required": false, + "description": "总波次数量" + }, + { + "name": "duration_ms", + "type": "number", + "required": false, + "description": "任务耗时(毫秒)" + }, + { + "name": "error_message", + "type": "string", + "required": false, + "description": "失败时的错误信息(仅在 state=failed 时返回)" + }, + { + "name": "error_code", + "type": "string", + "required": false, + "description": "失败时的错误码(仅在 state=failed 时返回)" + }, + { + "name": "result", + "type": "object", + "required": false, + "description": "成功时返回的汇总结果(仅在 state=success 时返回),例如 { \"processed_wave_count\": number, \"canceled_wave_count\": number }" + } + ] + }, + { + "method": "order.wave.batchAllocateExpress", + "title": "提交批次分配快递号任务。该接口为异步任务提交接口,立即返回 task_id,后端异步按当前仓库 + wave_ids 拉取待处理订单并提交到快递号分配流水线。", + "description": "提交批次分配快递号任务。该接口为异步任务提交接口,立即返回 task_id,后端异步按当前仓库 + wave_ids 拉取待处理订单并提交到快递号分配流水线。", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "wave_ids / waveIds / ids", + "type": "array|string|number", + "required": true, + "description": "波次ID列表;支持数组、逗号分隔字符串或单个ID" + }, + { + "name": "task_id / taskId", + "type": "string", + "required": false, + "description": "可选外部任务ID,用于幂等提交" + } + ], + "response": [ + { + "name": "status", + "type": "string", + "required": true, + "description": "提交状态,固定 success" + }, + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID(用于查询任务进度)" + }, + { + "name": "warehouse_id", + "type": "number", + "required": true, + "description": "当前仓库ID" + }, + { + "name": "accepted_at", + "type": "string", + "required": true, + "description": "任务受理时间(ISO8601)" + }, + { + "name": "message", + "type": "string", + "required": false, + "description": "受理提示信息" + } + ] + }, + { + "method": "order.wave.batchAllocateExpressTaskProgress", + "title": "查询批次分配快递号任务进度:按 task_id 查询任务状态与统计信息;兼容 taskId 参数名。", + "description": "查询批次分配快递号任务进度:按 task_id 查询任务状态与统计信息;兼容 taskId 参数名。", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "task_id / taskId", + "type": "string", + "required": true, + "description": "任务 ID(后端生成或提交时传入)" + } + ], + "response": [ + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID" + }, + { + "name": "state", + "type": "string", + "required": true, + "description": "任务状态枚举:submitted(已受理)/ running(进行中)/ success(成功)/ failed(失败)/ not_found(未找到)" + }, + { + "name": "warehouse_id", + "type": "number", + "required": false, + "description": "任务关联仓库ID" + }, + { + "name": "total_wave_count", + "type": "number", + "required": false, + "description": "波次数量" + }, + { + "name": "total_order_count", + "type": "number", + "required": false, + "description": "参与分配的订单数量" + }, + { + "name": "processed_order_count", + "type": "number", + "required": false, + "description": "已处理订单数量" + }, + { + "name": "success_order_count", + "type": "number", + "required": false, + "description": "成功提交分配的订单数量" + }, + { + "name": "failed_order_count", + "type": "number", + "required": false, + "description": "提交分配失败的订单数量" + }, + { + "name": "progress_percent", + "type": "number", + "required": false, + "description": "进度百分比(0-100)" + }, + { + "name": "duration_ms", + "type": "number", + "required": false, + "description": "任务耗时(毫秒)" + }, + { + "name": "error_message", + "type": "string", + "required": false, + "description": "失败时的错误信息" + }, + { + "name": "error_code", + "type": "string", + "required": false, + "description": "失败时的错误码" + } + ] + }, + { + "method": "order.wave.batchRemoveExceptionOrders", + "title": "提交批次移除异常订单任务。该接口为异步任务提交接口,立即返回 task_id,后端异步按当前仓库 + wave_ids 拉取异常订单并移出波次。", + "description": "提交批次移除异常订单任务。该接口为异步任务提交接口,立即返回 task_id,后端异步按当前仓库 + wave_ids 拉取异常订单并移出波次。", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "wave_ids / waveIds / ids", + "type": "array|string|number", + "required": true, + "description": "波次ID列表;支持数组、逗号分隔字符串或单个ID" + }, + { + "name": "task_id / taskId", + "type": "string", + "required": false, + "description": "可选外部任务ID,用于幂等提交" + } + ], + "response": [ + { + "name": "status", + "type": "string", + "required": true, + "description": "提交状态,固定 success" + }, + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID(用于查询任务进度)" + }, + { + "name": "warehouse_id", + "type": "number", + "required": true, + "description": "当前仓库ID" + }, + { + "name": "accepted_at", + "type": "string", + "required": true, + "description": "任务受理时间(ISO8601)" + }, + { + "name": "message", + "type": "string", + "required": false, + "description": "受理提示信息" + } + ] + }, + { + "method": "order.wave.batchRemoveExceptionOrdersTaskProgress", + "title": "查询批次移除异常订单任务进度:按 task_id 查询任务状态与统计信息;兼容 taskId 参数名。", + "description": "查询批次移除异常订单任务进度:按 task_id 查询任务状态与统计信息;兼容 taskId 参数名。", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "task_id / taskId", + "type": "string", + "required": true, + "description": "任务 ID(后端生成或提交时传入)" + } + ], + "response": [ + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID" + }, + { + "name": "state", + "type": "string", + "required": true, + "description": "任务状态枚举:submitted(已受理)/ running(进行中)/ success(成功)/ failed(失败)/ not_found(未找到)" + }, + { + "name": "warehouse_id", + "type": "number", + "required": false, + "description": "任务关联仓库ID" + }, + { + "name": "total_wave_count", + "type": "number", + "required": false, + "description": "波次数量" + }, + { + "name": "total_order_count", + "type": "number", + "required": false, + "description": "参与处理的订单数量" + }, + { + "name": "processed_order_count", + "type": "number", + "required": false, + "description": "已处理订单数量" + }, + { + "name": "removed_order_count", + "type": "number", + "required": false, + "description": "已成功移出波次的订单数量" + }, + { + "name": "failed_order_count", + "type": "number", + "required": false, + "description": "处理失败的订单数量" + }, + { + "name": "progress_percent", + "type": "number", + "required": false, + "description": "进度百分比(0-100)" + }, + { + "name": "duration_ms", + "type": "number", + "required": false, + "description": "任务耗时(毫秒)" + }, + { + "name": "error_message", + "type": "string", + "required": false, + "description": "失败时的错误信息" + }, + { + "name": "error_code", + "type": "string", + "required": false, + "description": "失败时的错误码" + } + ] + }, + { + "method": "order.wave.batchAllocateStorage", + "title": "提交批次分配储位任务。该接口为异步任务提交接口,立即返回 task_id,后端异步按当前仓库 + wave_ids 拉取待处理订单并提交到储位分配流水线。", + "description": "提交批次分配储位任务。该接口为异步任务提交接口,立即返回 task_id,后端异步按当前仓库 + wave_ids 拉取待处理订单并提交到储位分配流水线。", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "wave_ids / waveIds / ids", + "type": "array|string|number", + "required": true, + "description": "波次ID列表;支持数组、逗号分隔字符串或单个ID" + }, + { + "name": "task_id / taskId", + "type": "string", + "required": false, + "description": "可选外部任务ID,用于幂等提交" + } + ], + "response": [ + { + "name": "status", + "type": "string", + "required": true, + "description": "提交状态,固定 success" + }, + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID(用于查询任务进度)" + }, + { + "name": "warehouse_id", + "type": "number", + "required": true, + "description": "当前仓库ID" + }, + { + "name": "accepted_at", + "type": "string", + "required": true, + "description": "任务受理时间(ISO8601)" + }, + { + "name": "message", + "type": "string", + "required": false, + "description": "受理提示信息" + } + ] + }, + { + "method": "order.wave.batchAllocateStorageTaskProgress", + "title": "查询批次分配储位任务进度:按 task_id 查询任务状态与统计信息;兼容 taskId 参数名。", + "description": "查询批次分配储位任务进度:按 task_id 查询任务状态与统计信息;兼容 taskId 参数名。", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "task_id / taskId", + "type": "string", + "required": true, + "description": "任务 ID(后端生成或提交时传入)" + } + ], + "response": [ + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID" + }, + { + "name": "state", + "type": "string", + "required": true, + "description": "任务状态枚举:submitted(已受理)/ running(进行中)/ success(成功)/ failed(失败)/ not_found(未找到)" + }, + { + "name": "warehouse_id", + "type": "number", + "required": false, + "description": "任务关联仓库ID" + }, + { + "name": "total_wave_count", + "type": "number", + "required": false, + "description": "波次数量" + }, + { + "name": "total_order_count", + "type": "number", + "required": false, + "description": "参与分配的订单数量" + }, + { + "name": "processed_order_count", + "type": "number", + "required": false, + "description": "已处理订单数量" + }, + { + "name": "success_order_count", + "type": "number", + "required": false, + "description": "成功提交分配的订单数量" + }, + { + "name": "failed_order_count", + "type": "number", + "required": false, + "description": "提交分配失败的订单数量" + }, + { + "name": "progress_percent", + "type": "number", + "required": false, + "description": "进度百分比(0-100)" + }, + { + "name": "duration_ms", + "type": "number", + "required": false, + "description": "任务耗时(毫秒)" + }, + { + "name": "error_message", + "type": "string", + "required": false, + "description": "失败时的错误信息" + }, + { + "name": "error_code", + "type": "string", + "required": false, + "description": "失败时的错误码" + } + ] + }, + { + "method": "order.wave.groupFetch", + "title": "抓取团购接口(异步任务提交)", + "description": "抓取团购接口(异步任务提交)", "endpoint": "/system", "authRequired": false, "loginRequired": true, @@ -349,6 +1025,162 @@ "required": true, "description": "手动抓取标记;值为 'wave_manual_fetch' 表示手动抓取" }, + { + "name": "fetch_mode", + "type": "string", + "required": false, + "description": "抓取模式,值为 'group'(团购)或 'single'(散单)" + }, + { + "name": "message", + "type": "string", + "required": false, + "description": "受理信息提示,通常为 '任务已提交,后端异步处理中' 或失败/错误说明" + } + ] + }, + { + "method": "order.wave.singleFetch", + "title": "抓取散单接口(异步任务提交)", + "description": "抓取散单接口(异步任务提交)", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "structure_list", + "type": "array", + "required": true, + "description": "结构请求数组;每项必须包含 item_detail_machine(由 buildMachineStructureToken 生成的结构标识)并包含必填字段 max_fetch_quantity(最大抓取上限,订单数,正整数);可选 quantity(未传入时使用仓库默认或全局默认)" + } + ], + "response": [ + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID(后端生成的唯一标识,用于查询任务状态或结果)" + }, + { + "name": "warehouse_id", + "type": "number", + "required": true, + "description": "生效的仓库 ID" + }, + { + "name": "structure_count", + "type": "number", + "required": true, + "description": "本次入参的结构数量(structure_list 长度)" + }, + { + "name": "default_quantity", + "type": "number", + "required": true, + "description": "仓库默认抓取数量或全局默认值" + }, + { + "name": "auto_fetch_disabled_marker", + "type": "string", + "required": true, + "description": "手动抓取标记;值为 'wave_manual_fetch' 表示手动抓取" + }, + { + "name": "fetch_mode", + "type": "string", + "required": false, + "description": "抓取模式,值为 'group'(团购)或 'single'(散单)" + }, + { + "name": "max_fetch_quantity", + "type": "number", + "required": false, + "description": "提交时生效的最大抓取上限(订单数,正整数)" + }, + { + "name": "message", + "type": "string", + "required": false, + "description": "受理信息提示,通常为 '任务已提交,后端异步处理中' 或失败/错误说明" + } + ] + }, + { + "method": "order.wave.fetch", + "title": "兼容别名(等同 groupFetch)", + "description": "兼容别名(等同 groupFetch)", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "structure_list", + "type": "array", + "required": true, + "description": "结构请求数组;每项必须包含 item_detail_machine(由 buildMachineStructureToken 生成的结构标识),可选 quantity(未传入时使用仓库默认或全局默认)" + } + ], + "response": [ + { + "name": "task_id", + "type": "string", + "required": true, + "description": "任务 ID(后端生成的唯一标识,用于查询任务状态或结果)" + }, + { + "name": "warehouse_id", + "type": "number", + "required": true, + "description": "生效的仓库 ID" + }, + { + "name": "structure_count", + "type": "number", + "required": true, + "description": "本次入参的结构数量(structure_list 长度)" + }, + { + "name": "default_quantity", + "type": "number", + "required": true, + "description": "仓库默认抓取数量或全局默认值" + }, + { + "name": "auto_fetch_disabled_marker", + "type": "string", + "required": true, + "description": "手动抓取标记;值为 'wave_manual_fetch' 表示手动抓取" + }, + { + "name": "fetch_mode", + "type": "string", + "required": false, + "description": "抓取模式,值为 'group'(团购)或 'single'(散单)" + }, { "name": "message", "type": "string", @@ -439,6 +1271,30 @@ "required": false, "description": "错误信息,仅当 status=failed 时返回" }, + { + "name": "fetch_mode", + "type": "string", + "required": false, + "description": "抓取模式,值为 'group'(团购)或 'single'(散单);single 模式时可能返回下列额外字段" + }, + { + "name": "max_fetch_quantity", + "type": "number", + "required": false, + "description": "当 fetch_mode=single 时返回的最大抓取上限(订单数,正整数)" + }, + { + "name": "limit_reached", + "type": "boolean", + "required": false, + "description": "当 fetch_mode=single 时指示是否已达到 max_fetch_quantity 限制" + }, + { + "name": "stop_reason", + "type": "string", + "required": false, + "description": "任务停止原因(如达到上限、人工停止或其他失败原因)" + }, { "name": "update_time", "type": "string", diff --git a/workflows/api-doc-system/data/module/pick/_module.lifecycle.json b/workflows/api-doc-system/data/module/pick/_module.lifecycle.json index 088fbb2b..bfe5295a 100644 --- a/workflows/api-doc-system/data/module/pick/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/pick/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-05-04 17:23:48", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/pick/module.json b/workflows/api-doc-system/data/module/pick/module.json index 03a22fb2..d6725e00 100644 --- a/workflows/api-doc-system/data/module/pick/module.json +++ b/workflows/api-doc-system/data/module/pick/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/print/_module.lifecycle.json b/workflows/api-doc-system/data/module/print/_module.lifecycle.json index cfa484a8..4373308e 100644 --- a/workflows/api-doc-system/data/module/print/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/print/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/print/module.json b/workflows/api-doc-system/data/module/print/module.json index 9fe430d4..c53c078f 100644 --- a/workflows/api-doc-system/data/module/print/module.json +++ b/workflows/api-doc-system/data/module/print/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/printer.station/_module.lifecycle.json b/workflows/api-doc-system/data/module/printer.station/_module.lifecycle.json index 5de53173..12a92b61 100644 --- a/workflows/api-doc-system/data/module/printer.station/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/printer.station/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/printer.station/module.json b/workflows/api-doc-system/data/module/printer.station/module.json index b6227f91..c86ddc2f 100644 --- a/workflows/api-doc-system/data/module/printer.station/module.json +++ b/workflows/api-doc-system/data/module/printer.station/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/setting.account/_module.lifecycle.json b/workflows/api-doc-system/data/module/setting.account/_module.lifecycle.json index b5993dce..9e92def6 100644 --- a/workflows/api-doc-system/data/module/setting.account/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/setting.account/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/setting.account/module.json b/workflows/api-doc-system/data/module/setting.account/module.json index c8723114..93c623eb 100644 --- a/workflows/api-doc-system/data/module/setting.account/module.json +++ b/workflows/api-doc-system/data/module/setting.account/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/setting.express/_module.lifecycle.json b/workflows/api-doc-system/data/module/setting.express/_module.lifecycle.json index 3eaf41e3..b7a5c65b 100644 --- a/workflows/api-doc-system/data/module/setting.express/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/setting.express/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-17 19:37:49", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/setting.express/module.json b/workflows/api-doc-system/data/module/setting.express/module.json index 84d37332..ec5d38f5 100644 --- a/workflows/api-doc-system/data/module/setting.express/module.json +++ b/workflows/api-doc-system/data/module/setting.express/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/setting.expressinterface/_module.lifecycle.json b/workflows/api-doc-system/data/module/setting.expressinterface/_module.lifecycle.json index 0d37693a..03b265cf 100644 --- a/workflows/api-doc-system/data/module/setting.expressinterface/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/setting.expressinterface/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-17 20:21:27", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/setting.expressinterface/module.json b/workflows/api-doc-system/data/module/setting.expressinterface/module.json index 7f565420..200d312c 100644 --- a/workflows/api-doc-system/data/module/setting.expressinterface/module.json +++ b/workflows/api-doc-system/data/module/setting.expressinterface/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/setting.permission/_module.lifecycle.json b/workflows/api-doc-system/data/module/setting.permission/_module.lifecycle.json index 3655b7fa..78cb1f3d 100644 --- a/workflows/api-doc-system/data/module/setting.permission/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/setting.permission/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/setting.permission/module.json b/workflows/api-doc-system/data/module/setting.permission/module.json index ca8cb431..8ccf1f19 100644 --- a/workflows/api-doc-system/data/module/setting.permission/module.json +++ b/workflows/api-doc-system/data/module/setting.permission/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/setting.platform/_module.lifecycle.json b/workflows/api-doc-system/data/module/setting.platform/_module.lifecycle.json index 67a770f4..454860db 100644 --- a/workflows/api-doc-system/data/module/setting.platform/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/setting.platform/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-17 19:16:50", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/setting.platform/module.json b/workflows/api-doc-system/data/module/setting.platform/module.json index cd89677b..72ee004a 100644 --- a/workflows/api-doc-system/data/module/setting.platform/module.json +++ b/workflows/api-doc-system/data/module/setting.platform/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/setting.printtemplate/_module.lifecycle.json b/workflows/api-doc-system/data/module/setting.printtemplate/_module.lifecycle.json index e497b44c..5524ff5b 100644 --- a/workflows/api-doc-system/data/module/setting.printtemplate/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/setting.printtemplate/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/setting.printtemplate/module.json b/workflows/api-doc-system/data/module/setting.printtemplate/module.json index 247b6d2f..aa828774 100644 --- a/workflows/api-doc-system/data/module/setting.printtemplate/module.json +++ b/workflows/api-doc-system/data/module/setting.printtemplate/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/setting.role/_module.lifecycle.json b/workflows/api-doc-system/data/module/setting.role/_module.lifecycle.json index 7af728e5..1433e0fd 100644 --- a/workflows/api-doc-system/data/module/setting.role/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/setting.role/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/setting.role/module.json b/workflows/api-doc-system/data/module/setting.role/module.json index b5ee54c2..e148d79c 100644 --- a/workflows/api-doc-system/data/module/setting.role/module.json +++ b/workflows/api-doc-system/data/module/setting.role/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/setting.warehouse/_module.lifecycle.json b/workflows/api-doc-system/data/module/setting.warehouse/_module.lifecycle.json index e9dd94c5..8aa56e25 100644 --- a/workflows/api-doc-system/data/module/setting.warehouse/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/setting.warehouse/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-05-04 09:11:04", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/setting.warehouse/module.json b/workflows/api-doc-system/data/module/setting.warehouse/module.json index d67837a4..7eabe724 100644 --- a/workflows/api-doc-system/data/module/setting.warehouse/module.json +++ b/workflows/api-doc-system/data/module/setting.warehouse/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/stock/_module.lifecycle.json b/workflows/api-doc-system/data/module/stock/_module.lifecycle.json index b813fb8e..ba288e60 100644 --- a/workflows/api-doc-system/data/module/stock/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/stock/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/stock/module.json b/workflows/api-doc-system/data/module/stock/module.json index 46aefaab..2ebf555f 100644 --- a/workflows/api-doc-system/data/module/stock/module.json +++ b/workflows/api-doc-system/data/module/stock/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/storage.entry/_module.lifecycle.json b/workflows/api-doc-system/data/module/storage.entry/_module.lifecycle.json index a9b31834..484a1900 100644 --- a/workflows/api-doc-system/data/module/storage.entry/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/storage.entry/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/storage.entry/module.json b/workflows/api-doc-system/data/module/storage.entry/module.json index 9de3b4d3..3d83f2e8 100644 --- a/workflows/api-doc-system/data/module/storage.entry/module.json +++ b/workflows/api-doc-system/data/module/storage.entry/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/storage.inventory/_module.lifecycle.json b/workflows/api-doc-system/data/module/storage.inventory/_module.lifecycle.json index 4137b09d..880d4a21 100644 --- a/workflows/api-doc-system/data/module/storage.inventory/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/storage.inventory/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/storage.inventory/module.json b/workflows/api-doc-system/data/module/storage.inventory/module.json index 138a20e2..5b65ee0c 100644 --- a/workflows/api-doc-system/data/module/storage.inventory/module.json +++ b/workflows/api-doc-system/data/module/storage.inventory/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/storage.stockout/_module.lifecycle.json b/workflows/api-doc-system/data/module/storage.stockout/_module.lifecycle.json index 693d3764..26fd2177 100644 --- a/workflows/api-doc-system/data/module/storage.stockout/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/storage.stockout/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/storage.stockout/module.json b/workflows/api-doc-system/data/module/storage.stockout/module.json index c3067cf0..d1a68b33 100644 --- a/workflows/api-doc-system/data/module/storage.stockout/module.json +++ b/workflows/api-doc-system/data/module/storage.stockout/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/storage_receiving/_module.lifecycle.json b/workflows/api-doc-system/data/module/storage_receiving/_module.lifecycle.json index 657ed557..0afa8f7d 100644 --- a/workflows/api-doc-system/data/module/storage_receiving/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/storage_receiving/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": "2026-04-17 19:16:50" } diff --git a/workflows/api-doc-system/data/module/storage_receiving/module.json b/workflows/api-doc-system/data/module/storage_receiving/module.json index cfac1063..63acb0a5 100644 --- a/workflows/api-doc-system/data/module/storage_receiving/module.json +++ b/workflows/api-doc-system/data/module/storage_receiving/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { @@ -25,8 +25,12 @@ "interfaceChanges": { "addedMethods": [], "deletedMethods": [], - "paramsUpdatedMethods": [], - "responseUpdatedMethods": [] + "paramsUpdatedMethods": [ + "storage.receiving.detailChange" + ], + "responseUpdatedMethods": [ + "storage.receiving.detailChange" + ] } } }, @@ -883,6 +887,18 @@ "required": false, "description": "箱长" }, + { + "name": "box_remainder", + "type": "number", + "required": false, + "description": "箱内剩余数量/零散数量(不满箱时的件数)" + }, + { + "name": "box_weight", + "type": "number", + "required": false, + "description": "实测箱重(单位与系统重量一致,如 kg)" + }, { "name": "weight", "type": "number", @@ -927,6 +943,18 @@ "required": false, "description": "系统商品 ID" }, + { + "name": "data.box_remainder", + "type": "number", + "required": false, + "description": "箱内剩余数量/零散数量(不满箱时的件数)" + }, + { + "name": "data.box_weight", + "type": "number", + "required": false, + "description": "实测箱重(单位与系统重量一致,如 kg)" + }, { "name": "data.updated_at", "type": "string", diff --git a/workflows/api-doc-system/data/module/store/_module.lifecycle.json b/workflows/api-doc-system/data/module/store/_module.lifecycle.json index ad2dcbf2..25c3110b 100644 --- a/workflows/api-doc-system/data/module/store/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/store/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/store/module.json b/workflows/api-doc-system/data/module/store/module.json index ad4049cd..bcafb48b 100644 --- a/workflows/api-doc-system/data/module/store/module.json +++ b/workflows/api-doc-system/data/module/store/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { @@ -33,8 +33,8 @@ "interfaces": [ { "method": "store.createStore", - "title": "store.createStore 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB、group_wave_prefix=B、min_group_order_fetch_quantity=13", - "description": "store.createStore 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB、group_wave_prefix=B、min_group_order_fetch_quantity=13", + "title": "store.createStore 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB、group_wave_prefix=B、min_group_order_fetch_quantity=13、auto_grouping_enabled=false(是否自动加团,默认 false(关闭))", + "description": "store.createStore 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB、group_wave_prefix=B、min_group_order_fetch_quantity=13、auto_grouping_enabled=false(是否自动加团,默认 false(关闭))", "endpoint": "/system", "authRequired": false, "loginRequired": true, @@ -86,14 +86,20 @@ "type": "number", "required": false, "description": "最小团购订单抓取数量,默认 13" + }, + { + "name": "subject_config.auto_grouping_enabled", + "type": "boolean", + "required": false, + "description": "是否自动加团,默认 false(关闭)" } ], "response": [] }, { "method": "store.createWarehouse", - "title": "store.createWarehouse 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB、group_wave_prefix=B、min_group_order_fetch_quantity=13", - "description": "store.createWarehouse 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB、group_wave_prefix=B、min_group_order_fetch_quantity=13", + "title": "store.createWarehouse 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB、group_wave_prefix=B、min_group_order_fetch_quantity=13、auto_grouping_enabled=false(是否自动加团,默认 false(关闭))", + "description": "store.createWarehouse 接口,subject_config 未传时默认写入 max_notice_webhook_count=5、default_express_code=STO、default_platform_code=TB、group_wave_prefix=B、min_group_order_fetch_quantity=13、auto_grouping_enabled=false(是否自动加团,默认 false(关闭))", "endpoint": "/system", "authRequired": false, "loginRequired": true, @@ -145,6 +151,12 @@ "type": "number", "required": false, "description": "最小团购订单抓取数量,默认 13" + }, + { + "name": "subject_config.auto_grouping_enabled", + "type": "boolean", + "required": false, + "description": "是否自动加团,默认 false(关闭)" } ], "response": [] diff --git a/workflows/api-doc-system/data/module/storewarehouse.store/_module.lifecycle.json b/workflows/api-doc-system/data/module/storewarehouse.store/_module.lifecycle.json index 8866edd7..5da89339 100644 --- a/workflows/api-doc-system/data/module/storewarehouse.store/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/storewarehouse.store/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/storewarehouse.store/module.json b/workflows/api-doc-system/data/module/storewarehouse.store/module.json index 163ed8d4..dbd36605 100644 --- a/workflows/api-doc-system/data/module/storewarehouse.store/module.json +++ b/workflows/api-doc-system/data/module/storewarehouse.store/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { @@ -534,7 +534,7 @@ "name": "policy_config", "type": "object", "required": true, - "description": "策略配置对象;仅支持 receive_mode、auto_allocate_bin、allow_mix_batch、allow_temp_storage、storage_separation、print_recharge_price(面单充值元/单,支持 2 位小数)、max_daily_inbound、remark" + "description": "策略配置对象;仅支持 receive_mode、auto_allocate_bin、auto_allocate_express(是否自动分配快递)、auto_allocate_storage(是否自动分配储位)、allow_mix_batch、allow_temp_storage、storage_separation、print_recharge_price(面单充值元/单,支持 2 位小数)、max_daily_inbound、remark" } ], "response": [] diff --git a/workflows/api-doc-system/data/module/user/_module.lifecycle.json b/workflows/api-doc-system/data/module/user/_module.lifecycle.json index 8d82584e..f4edea5e 100644 --- a/workflows/api-doc-system/data/module/user/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/user/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/user/module.json b/workflows/api-doc-system/data/module/user/module.json index fc966ca7..e9398e6b 100644 --- a/workflows/api-doc-system/data/module/user/module.json +++ b/workflows/api-doc-system/data/module/user/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/warehouse/_module.lifecycle.json b/workflows/api-doc-system/data/module/warehouse/_module.lifecycle.json index 54e0560f..3c8a6096 100644 --- a/workflows/api-doc-system/data/module/warehouse/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/warehouse/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-04-16 11:15:05", - "updatedAt": "2026-05-05 17:25:14", + "updatedAt": "2026-05-06 17:09:32", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/warehouse/module.json b/workflows/api-doc-system/data/module/warehouse/module.json index b8f3f262..709ee8e6 100644 --- a/workflows/api-doc-system/data/module/warehouse/module.json +++ b/workflows/api-doc-system/data/module/warehouse/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-05 17:25:14", - "generatedAtLocal": "2026-05-05 17:25:14", + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/pending-updates.json b/workflows/api-doc-system/data/pending-updates.json index 0967ef42..c6be0adc 100644 --- a/workflows/api-doc-system/data/pending-updates.json +++ b/workflows/api-doc-system/data/pending-updates.json @@ -1 +1,44 @@ -{} +{ + "generatedAt": "2026-05-06 17:09:32", + "generatedAtLocal": "2026-05-06 17:09:32", + "source": "remote", + "filter": { + "platform": { + "value": "web", + "label": "网页端" + }, + "project": { + "value": "all", + "label": "全部" + } + }, + "summary": { + "moduleAdded": 0, + "moduleDeleted": 0, + "interfaceAdded": 0, + "interfaceDeleted": 0, + "interfaceParamsUpdated": 1, + "interfaceResponseUpdated": 1, + "totalChangedItems": 2 + }, + "interfaceUpdates": { + "added": [], + "deleted": [], + "paramsUpdated": [ + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.detailChange" + } + ], + "responseUpdated": [ + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.detailChange" + } + ] + } +}