From 207a21e272783841ec0f40019f28f603ad567458 Mon Sep 17 00:00:00 2001 From: yin <3313488199@qq.com> Date: Mon, 18 May 2026 18:13:38 +0800 Subject: [PATCH] =?UTF-8?q?5=E6=9C=8818?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/api/setting.warehouse/settingwarehouse.ts | 41 +- src/api/storage.report/report.ts | 1 + .../waveOrder/GroupWaveBatchListPanel.vue | 8 +- .../waveOrder/SandanWaveBatchListPanel.vue | 8 +- src/views/stock/stock/component/add.vue | 5 +- src/views/stock/stock/index.vue | 118 +- src/views/storage/entry/index.vue | 33 +- src/views/storage/report/index.vue | 28 +- src/views/storage/report/report-config.ts | 58 +- .../system/setting/basicManagement/index.vue | 46 +- .../interface-details/interface-details.json | 1057 +++++++++++++++-- .../data/module-list/module-list.json | 342 +++++- .../data/module/config/_module.lifecycle.json | 2 +- .../data/module/config/module.json | 60 +- .../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 | 4 +- .../data/module/order/_module.lifecycle.json | 2 +- .../data/module/order/module.json | 4 +- .../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 | 153 ++- .../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 | 41 +- .../data/module/stock/_module.lifecycle.json | 2 +- .../data/module/stock/module.json | 320 ++++- .../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.report/_module.lifecycle.json | 2 +- .../data/module/storage.report/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 | 172 ++- .../data/module/store/_module.lifecycle.json | 2 +- .../data/module/store/module.json | 29 +- .../_module.lifecycle.json | 2 +- .../module/storewarehouse.store/module.json | 63 +- .../data/module/user/_module.lifecycle.json | 2 +- .../data/module/user/module.json | 4 +- .../module/warehouse/_module.lifecycle.json | 2 +- .../data/module/warehouse/module.json | 10 +- .../api-doc-system/data/pending-updates.json | 185 ++- 85 files changed, 2522 insertions(+), 440 deletions(-) diff --git a/src/api/setting.warehouse/settingwarehouse.ts b/src/api/setting.warehouse/settingwarehouse.ts index 3973dbf8..c69d372e 100644 --- a/src/api/setting.warehouse/settingwarehouse.ts +++ b/src/api/setting.warehouse/settingwarehouse.ts @@ -2,13 +2,46 @@ import request from '@/utils/request' const v = '1.0' +/** 与 module setting.warehouse 文档 subject_config 对齐 */ +export type SettingWarehouseSubjectConfig = { + enable_external_express_code?: boolean + max_wave_quantity?: number + min_group_order_fetch_quantity?: number + max_notice_webhook_count?: number + default_express_code?: string + default_platform_code?: string + group_wave_prefix?: string + [key: string]: unknown +} + +export type SettingWarehouseSettingsPayload = { + warehouse_id: number + subject_config: SettingWarehouseSubjectConfig +} + export type SettingWarehouseSaveSettingsParams = { - subject_config: Record + subject_config: SettingWarehouseSubjectConfig cache_warehouse_id?: number cacheWarehouseId?: number } -export function settingWarehouseGetSettings(data: Record = {}): Promise { +export type SettingWarehouseSaveSettingsPayload = SettingWarehouseSettingsPayload & { + cache_cleared_warehouse_id: number | null +} + +export function unwrapSettingWarehousePayload( + res: Record | null | undefined +): Record { + const payload = res?.data + if (payload && typeof payload === 'object' && !Array.isArray(payload)) { + return payload as Record + } + return (res ?? {}) as Record +} + +export function settingWarehouseGetSettings( + data: Record = {} +): Promise<{ code?: number; message?: string; data?: SettingWarehouseSettingsPayload } & Record> { return request({ url: '/system', method: 'post', @@ -36,7 +69,9 @@ export function settingWarehouseGetFieldMeta(): Promise { } as any) } -export function settingWarehouseSaveSettings(data: SettingWarehouseSaveSettingsParams): Promise { +export function settingWarehouseSaveSettings( + data: SettingWarehouseSaveSettingsParams +): Promise<{ code?: number; message?: string; data?: SettingWarehouseSaveSettingsPayload } & Record> { return request({ url: '/system', method: 'post', diff --git a/src/api/storage.report/report.ts b/src/api/storage.report/report.ts index 447b7c0f..949b556e 100644 --- a/src/api/storage.report/report.ts +++ b/src/api/storage.report/report.ts @@ -26,6 +26,7 @@ export interface StorageReportSearchBody { start_time?: string | Date end_time?: string | Date store_ids?: number[] + by_space?: boolean } sort?: { sortField?: 'begin_total' | 'inbound_total' | 'outbound_total' | 'end_total' diff --git a/src/views/order/waveOrder/GroupWaveBatchListPanel.vue b/src/views/order/waveOrder/GroupWaveBatchListPanel.vue index 1ccff3ff..22015023 100644 --- a/src/views/order/waveOrder/GroupWaveBatchListPanel.vue +++ b/src/views/order/waveOrder/GroupWaveBatchListPanel.vue @@ -904,7 +904,10 @@ import WaveBatchDetailPanel from './component/WaveBatchDetailPanel.vue' import WaveFetchTaskProgressDialog from './component/WaveFetchTaskProgressDialog.vue' import WaveStrategyQuickScanProgressDialog from './component/WaveStrategyQuickScanProgressDialog.vue' import * as indexApi from '@/api/index/index' -import { settingWarehouseGetSettings as getWarehouseSettings } from '@/api/setting.warehouse/settingwarehouse' +import { + settingWarehouseGetSettings as getWarehouseSettings, + unwrapSettingWarehousePayload +} from '@/api/setting.warehouse/settingwarehouse' import { orderWaveBatchAllocateExpress, orderWaveBatchAllocateExpressTaskProgress, @@ -1447,7 +1450,8 @@ async function loadWarehouseSettings() { if (!res || !okCode(res.code)) { throw new Error(res?.message || '获取仓库配置失败') } - const maxWaveQuantity = Number(res?.subject_config?.max_wave_quantity) + const payload = unwrapSettingWarehousePayload(res as Record) + const maxWaveQuantity = Number(payload?.subject_config?.max_wave_quantity) waveMaxOrderLimit.value = Number.isFinite(maxWaveQuantity) && maxWaveQuantity > 0 ? maxWaveQuantity : null } catch (error) { console.error('load warehouse settings failed:', error) diff --git a/src/views/order/waveOrder/SandanWaveBatchListPanel.vue b/src/views/order/waveOrder/SandanWaveBatchListPanel.vue index 4b8ac33c..3a5c3fb2 100644 --- a/src/views/order/waveOrder/SandanWaveBatchListPanel.vue +++ b/src/views/order/waveOrder/SandanWaveBatchListPanel.vue @@ -485,7 +485,10 @@ import PendingOrderListPanel from './component/PendingOrderListPanel.vue' import WaveBatchDetailPanel from './component/WaveBatchDetailPanel.vue' import WaveFetchTaskProgressDialog from './component/WaveFetchTaskProgressDialog.vue' import * as indexApi from '@/api/index/index' -import { settingWarehouseGetSettings as getWarehouseSettings } from '@/api/setting.warehouse/settingwarehouse' +import { + settingWarehouseGetSettings as getWarehouseSettings, + unwrapSettingWarehousePayload +} from '@/api/setting.warehouse/settingwarehouse' import { orderWaveBatchAllocateExpress, orderWaveBatchAllocateExpressTaskProgress, @@ -862,7 +865,8 @@ async function loadWarehouseSettings() { if (!res || !okCode(res.code)) { throw new Error(res?.message || '获取仓库配置失败') } - const maxWaveQuantity = Number(res?.subject_config?.max_wave_quantity) + const payload = unwrapSettingWarehousePayload(res as Record) + const maxWaveQuantity = Number(payload?.subject_config?.max_wave_quantity) waveMaxOrderLimit.value = Number.isFinite(maxWaveQuantity) && maxWaveQuantity > 0 ? maxWaveQuantity : null } catch (error) { console.error('load warehouse settings failed:', error) diff --git a/src/views/stock/stock/component/add.vue b/src/views/stock/stock/component/add.vue index d3f1d078..bc5de488 100644 --- a/src/views/stock/stock/component/add.vue +++ b/src/views/stock/stock/component/add.vue @@ -450,7 +450,10 @@ const validateItemCode = async (rule: any, value: any, callback: any) => { const formRules = { ...stockFormRules, - item_code: [{ validator: validateItemCode, trigger: 'blur' }], + item_code: [ + { required: true, message: '商品编码不能为空', trigger: 'blur' }, + { validator: validateItemCode, trigger: 'blur' } + ], quantity_per_box: [ { validator: (rule: any, value: any, callback: any) => { diff --git a/src/views/stock/stock/index.vue b/src/views/stock/stock/index.vue index a86b71a2..9d5e0555 100644 --- a/src/views/stock/stock/index.vue +++ b/src/views/stock/stock/index.vue @@ -231,12 +231,23 @@ /> - - + + - - - + + + @@ -387,8 +398,41 @@ const showBatchDialog = ref(false) const batchDialogOptions = ref([]) const batchDialogValue = ref(null) const batchDialogCommand = ref('') +const BATCH_SELECT_COMMANDS = new Set(['stock_unit', 'prohibited_id']) const importFileInputRef = ref(null) +type ProhibitedOption = { value: number; label: string } + +function normalizeProhibitedOptions(data: unknown): ProhibitedOption[] { + if (!Array.isArray(data)) return [] + return data + .map((item: any) => { + if (item && typeof item === 'object') { + if (item.value != null && item.label != null) { + const value = Number(item.value) + if (!Number.isFinite(value)) return null + return { value: Math.trunc(value), label: String(item.label) } + } + if (item.id != null && item.name != null) { + const value = Number(item.id) + if (!Number.isFinite(value)) return null + return { value: Math.trunc(value), label: String(item.name) } + } + } + return null + }) + .filter((x): x is ProhibitedOption => x != null) +} + +function applyProhibitedOptions(options: ProhibitedOption[]) { + if (availableFields[3]) { + ;(availableFields[3] as any).options = options + } + if (batchConfig.prohibited_id) { + batchConfig.prohibited_id.options = options + } +} + // State const drawer = ref(false) const showRecycle = ref(false) @@ -505,6 +549,21 @@ const availableFields = reactive(JSON.parse(JSON.stringify(stockAvailableFields) const hasSelection = computed(() => selectionIds.value.length > 0) +const batchDialogTitle = computed(() => { + const config = (batchConfig as any)[batchDialogCommand.value] + return config?.title ? `批量修改${config.title}` : '批量修改' +}) + +const batchDialogFieldLabel = computed(() => { + const config = (batchConfig as any)[batchDialogCommand.value] + return config?.title || '' +}) + +const batchDialogPlaceholder = computed(() => { + const config = (batchConfig as any)[batchDialogCommand.value] + return config?.placeholder || '请选择' +}) + // Methods const handleConditionChange = (conditions: any) => { currentConditions.value = conditions @@ -599,9 +658,7 @@ const handleSaved = () => { } const handleUpdateProhibitedTypes = (types: any[]) => { - if (availableFields[3]) { - (availableFields[3] as any).options = types - } + applyProhibitedOptions(normalizeProhibitedOptions(types)) } const handleRecycleBin = () => { @@ -648,10 +705,20 @@ const handleBatchChange = async (command: string) => { try { let value: any if (config.type === 'select') { - // 如果是库存单位,使用下拉对话框替代输入框 - if (command === 'stock_unit') { - batchDialogOptions.value = config.options || [] - batchDialogValue.value = batchDialogOptions.value.length ? batchDialogOptions.value[0].value : '' + if (BATCH_SELECT_COMMANDS.has(command)) { + const options = config.options || [] + if (!options.length) { + ElMessage.warning(`暂无可选的${config.title}`) + return + } + batchDialogOptions.value = options + const first = options[0]?.value + if (command === 'prohibited_id') { + const pid = Number(first) + batchDialogValue.value = Number.isFinite(pid) ? Math.trunc(pid) : null + } else { + batchDialogValue.value = first ?? '' + } batchDialogCommand.value = command showBatchDialog.value = true return @@ -705,8 +772,27 @@ const submitBatchChange = async (command: string, value: any) => { } const confirmBatchDialog = async () => { + const command = batchDialogCommand.value + let value: string | number | null = batchDialogValue.value + + if (command === 'prohibited_id') { + if (value === null || value === undefined || value === '') { + ElMessage.warning('请选择违禁品类型') + return + } + const pid = Number(value) + if (!Number.isInteger(pid)) { + ElMessage.warning('请选择有效的违禁品类型') + return + } + value = pid + } else if (value === null || value === undefined || value === '') { + ElMessage.warning('请选择选项') + return + } + try { - await submitBatchChange(batchDialogCommand.value, batchDialogValue.value) + await submitBatchChange(command, value) } catch (e) { console.error(e) } finally { @@ -870,10 +956,8 @@ onMounted(async () => { (availableFields[0] as any).options = (res as any).stores } const proRes = await stockApi.getProhibitedType() - if (proRes.data) { - if (proRes && proRes.data) { - (availableFields[3] as any).options = proRes.data - } + if (proRes?.data) { + applyProhibitedOptions(normalizeProhibitedOptions(proRes.data)) } const fastRes = await indexApi.fastWhereTree('stock') if (fastRes && fastRes.data && fastRes.data.presetTree) { diff --git a/src/views/storage/entry/index.vue b/src/views/storage/entry/index.vue index 609d318f..aabe0b8c 100644 --- a/src/views/storage/entry/index.vue +++ b/src/views/storage/entry/index.vue @@ -543,6 +543,13 @@ function onSelectionChange(rows: any[]) { hasSelection.value = selectionRows.value.length > 0 } +/** 完成入库/作废等操作的目标行:优先勾选,其次当前高亮行 */ +function getActionTargetRows(): any[] { + if (selectionRows.value.length) return selectionRows.value + if (selectedEntryId.value && selectedRow.value) return [selectedRow.value] + return [] +} + async function handleRowClick(row: any) { selectedEntryId.value = row?.id || null } @@ -579,24 +586,34 @@ function handleCreateEntry() { } async function handleCompleteEntry() { - if (!selectedEntryId.value) { + const targets = getActionTargetRows() + if (!targets.length) { ElMessage.warning('请先选择一个入库单') return } + const confirmLabel = targets.length === 1 + ? (targets[0].entry_order_code || targets[0].id) + : `${targets.length} 个入库单` try { - await ElMessageBox.confirm(`确定要完成入库单 ${selectedEntryId.value} 吗?`, '确认', { + await ElMessageBox.confirm(`确定要完成入库单 ${confirmLabel} 吗?`, '确认', { confirmButtonText: '确定', cancelButtonText: '取消', type: 'success' }) - + loading.value = true - const res = await entryApi.completeEntry({ id: selectedEntryId.value }) - if (res && res.code === 200) { - ElMessage.success('入库单操作完成') + let successCount = 0 + for (const row of targets) { + const res = await entryApi.completeEntry({ id: row.id }) + if (res && res.code === 200) { + successCount++ + } else { + ElMessage.error(res?.message || `入库单 ${row.entry_order_code || row.id} 操作失败`) + } + } + if (successCount > 0) { + ElMessage.success(successCount === targets.length ? '入库单操作完成' : `已完成 ${successCount}/${targets.length} 个入库单`) loadData() - } else { - ElMessage.error(res?.message || '操作失败') } } catch (e) { if (e !== 'cancel') { diff --git a/src/views/storage/report/index.vue b/src/views/storage/report/index.vue index b0552aa8..d7697bf4 100644 --- a/src/views/storage/report/index.vue +++ b/src/views/storage/report/index.vue @@ -116,8 +116,6 @@ import { import * as indexApi from '@/api/index/index' import { buildReportTableColumns, - buildDefaultReportScanCondition, - buildDefaultReportWhere, formatReportCell, formatReportDateTime, formatReportNumber, @@ -154,12 +152,12 @@ const pagination = reactive({ total: 0 }) const currentSort = reactive<{ prop: string; order: '' | 'ascending' | 'descending' }>({ - prop: 'outbound_total', - order: 'descending' + prop: '', + order: '' }) const selectedRid = ref(null) -const currentConditionRaw = ref(buildDefaultReportScanCondition()) +const currentConditionRaw = ref({}) const exportDialogVisible = ref(false) const exportTaskProgress = reactive({ taskId: '', @@ -255,9 +253,15 @@ function buildSortPayload(): StorageReportSearchBody['sort'] | undefined { function buildReportQueryPayload(): StorageReportSearchBody { const where = normalizeScanConditionToReportWhere(currentConditionRaw.value) - const effectiveWhere = Object.keys(where).length > 0 ? where : buildDefaultReportWhere() const sort = buildSortPayload() - return sort ? { where: effectiveWhere, sort } : { where: effectiveWhere } + const body: StorageReportSearchBody = {} + if (Object.keys(where).length > 0) { + body.where = where + } + if (sort) { + body.sort = sort + } + return body } function normalizeDownloadUrl(fileUrl: string) { @@ -410,13 +414,13 @@ function handleConditionChange(condition: any) { } function handleConditionClear() { - currentConditionRaw.value = buildDefaultReportScanCondition() + currentConditionRaw.value = {} pagination.currentPage = 1 loadData() } function handleConditionReset() { - currentConditionRaw.value = buildDefaultReportScanCondition() + currentConditionRaw.value = {} pagination.currentPage = 1 if (scanBox.value?.reset) { scanBox.value.reset() @@ -431,9 +435,11 @@ async function loadData() { loading.value = true const started = Date.now() selectedRid.value = null - const body: StorageReportSearchBody = buildReportQueryPayload() + const body = buildReportQueryPayload() try { - const res: any = await searchInventoryReport(body as any) + const res: any = await searchInventoryReport( + Object.keys(body).length > 0 ? body : undefined + ) if (res && (res.flag === 'success' || res.code === 200)) { const raw = extractReportList(res) fullList.value = withRowIds(raw) diff --git a/src/views/storage/report/report-config.ts b/src/views/storage/report/report-config.ts index 4a82f5f4..9dcdd70d 100644 --- a/src/views/storage/report/report-config.ts +++ b/src/views/storage/report/report-config.ts @@ -168,45 +168,29 @@ function normalizeReportEndDateParam(value: unknown): string | undefined { return d.isValid() ? d.endOf('day').format('YYYY-MM-DD HH:mm:ss') : String(value) } -function getDefaultReportPeriodRange(): [string, string] { - const today = dayjs().startOf('day') - const start = today.subtract(29, 'day') - return [start.format('YYYY-MM-DD'), today.format('YYYY-MM-DD')] -} - -export function buildDefaultReportScanCondition() { - return { - report_period: { - value: getDefaultReportPeriodRange(), - operator: 'between', - type: 'daterange' - } - } -} - -export function buildDefaultReportWhere() { - const [start, end] = getDefaultReportPeriodRange() - return { - start_time: normalizeReportStartDateParam(start), - end_time: normalizeReportEndDateParam(end) - } -} - /** ScanBox 侧栏可用字段(与 storage.report.search 的 where 对应) */ export const reportScanBoxAvailableFields = [ - // { - // value: 'report_period', - // label: '统计时间', - // type: 'daterange', - // defaultValue: getDefaultReportPeriodRange() - // }, + { + value: 'report_period', + label: '统计时间', + type: 'daterange', + startPlaceholder: '开始日期', + endPlaceholder: '结束日期' + }, { value: 'store_id', label: '货主', type: 'select', multiple: true, filterable: true, + placeholder: '请选择货主', options: [] as { label: string; value: number }[] + }, + { + value: 'by_space', + label: '按库位统计', + type: 'boolean', + placeholder: '开启后按商品+库位+货主返回;关闭则按商品+货主聚合' } ] @@ -255,5 +239,19 @@ export function normalizeScanConditionToReportWhere(condition: any): Record code === 1 || code === 200 || code === 0 @@ -285,7 +289,14 @@ const FALLBACK_FIELDS: NormalizedField[] = [ }, { key: 'default_express_code', label: '默认快递编码', type: 'string' }, { key: 'default_platform_code', label: '默认平台编码', type: 'string' }, - { key: 'group_wave_prefix', label: '团购波次号前缀', type: 'string' } + { key: 'group_wave_prefix', label: '团购波次号前缀', type: 'string' }, + { + key: 'enable_external_express_code', + label: '启用外部快递编码', + type: 'boolean', + description: + '开启后允许按外部系统传入的快递编码进行处理(如无匹配仍以业务校验为准);默认关闭。' + } ] function pickStr(obj: Record, keys: string[]): string | undefined { @@ -531,15 +542,7 @@ function onArrayObjectItemInput( subjectConfig[field.key] = list } -function unwrapApiPayload(res: Record | null | undefined): Record { - const payload = res?.data - if (payload && typeof payload === 'object' && !Array.isArray(payload)) { - return payload as Record - } - return (res ?? {}) as Record -} - -function applySettingsPayload(settingsRes: Record) { +function applySettingsPayload(settingsRes: SettingWarehouseSettingsPayload | Record) { const wid = settingsRes.warehouse_id warehouseId.value = typeof wid === 'number' ? wid : wid != null ? Number(wid) : null if (!Number.isFinite(warehouseId.value as number)) warehouseId.value = null @@ -594,10 +597,12 @@ async function loadAll() { throw new Error(settingsRes?.message || '获取仓库设置失败(getSettings)') } - const settingsPayload = unwrapApiPayload(settingsRes as Record) + const settingsPayload = unwrapSettingWarehousePayload( + settingsRes as Record + ) as SettingWarehouseSettingsPayload applySettingsPayload(settingsPayload) - const metaPayload = unwrapApiPayload(metaRes as Record) + const metaPayload = unwrapSettingWarehousePayload(metaRes as Record) const metaList = metaRes && okCode(metaRes.code) ? metaPayload.list : null const parsed = normalizeFieldMetaList(metaList) normalizedFields.value = parsed @@ -658,11 +663,11 @@ async function handleSave() { saving.value = true try { - const body: Parameters[0] = { + const body: SettingWarehouseSaveSettingsParams = { subject_config: payloadConfig } if (cacheWarehouseId.value != null && Number.isFinite(cacheWarehouseId.value)) { - body.cacheWarehouseId = cacheWarehouseId.value + body.cache_warehouse_id = cacheWarehouseId.value } const res = await settingWarehouseSaveSettings(body) @@ -672,13 +677,12 @@ async function handleSave() { ElMessage.success(res.message || '保存成功') - const latest = await settingWarehouseGetSettings() - if (!latest || !okCode(latest.code)) { - throw new Error(latest?.message || '保存成功,但刷新最新设置失败(getSettings)') - } - applySettingsPayload(unwrapApiPayload(latest as Record)) + const savePayload = unwrapSettingWarehousePayload( + res as Record + ) as SettingWarehouseSaveSettingsPayload + applySettingsPayload(savePayload) - const cleared = res.cache_cleared_warehouse_id + const cleared = savePayload.cache_cleared_warehouse_id if (cleared != null) { ElMessage.info(`已清理仓库缓存:${cleared}`) } 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 42ba8da4..35d6ae67 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "source": "remote", "filter": { "platform": { @@ -12,27 +12,327 @@ "label": "全部" } }, - "totalInterfaceCount": 251, + "totalInterfaceCount": 253, "changes": { "summary": { "moduleAdded": 0, "moduleDeleted": 0, - "moduleUpdated": 0, - "interfaceAdded": 0, - "interfaceDeleted": 0, - "interfaceParamsUpdated": 0, - "interfaceResponseUpdated": 0 + "moduleUpdated": 8, + "interfaceAdded": 3, + "interfaceDeleted": 1, + "interfaceParamsUpdated": 11, + "interfaceResponseUpdated": 10 }, "moduleUpdates": { "added": [], "deleted": [], - "updated": [] + "updated": [ + { + "moduleName": "配置模块", + "moduleKey": "config", + "folder": "config", + "previousModuleName": "配置模块", + "previousModuleKey": "config", + "interfaceChanges": { + "addedMethods": [], + "deletedMethods": [], + "paramsUpdatedMethods": [ + "config.list" + ], + "responseUpdatedMethods": [ + "config.list" + ] + } + }, + { + "moduleName": "仓库设置模块", + "moduleKey": "setting.warehouse", + "folder": "setting.warehouse", + "previousModuleName": "仓库设置模块", + "previousModuleKey": "setting.warehouse", + "interfaceChanges": { + "addedMethods": [], + "deletedMethods": [], + "paramsUpdatedMethods": [ + "setting.warehouse.saveSettings" + ], + "responseUpdatedMethods": [ + "setting.warehouse.getSettings", + "setting.warehouse.saveSettings" + ] + } + }, + { + "moduleName": "快递接口管理模块", + "moduleKey": "setting.expressInterface", + "folder": "setting.expressinterface", + "previousModuleName": "快递接口管理模块", + "previousModuleKey": "setting.expressInterface", + "interfaceChanges": { + "addedMethods": [], + "deletedMethods": [], + "paramsUpdatedMethods": [ + "setting.expressInterface.create", + "setting.expressInterface.update" + ], + "responseUpdatedMethods": [ + "setting.expressInterface.update" + ] + } + }, + { + "moduleName": "商品模块", + "moduleKey": "stock", + "folder": "stock", + "previousModuleName": "商品模块", + "previousModuleKey": "stock", + "interfaceChanges": { + "addedMethods": [ + "stock.warehouse.export", + "stock.warehouse.exportTaskProgress", + "stock.warehouse.import" + ], + "deletedMethods": [], + "paramsUpdatedMethods": [ + "stock.warehouse.handleBatchChange" + ], + "responseUpdatedMethods": [ + "stock.warehouse.handleBatchChange" + ] + } + }, + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "previousModuleName": "收货单模块", + "previousModuleKey": "storage_receiving", + "interfaceChanges": { + "addedMethods": [], + "deletedMethods": [ + "storage.receiving.addItem" + ], + "paramsUpdatedMethods": [ + "storage.receiving.addDetail", + "storage.receiving.deleteDetail" + ], + "responseUpdatedMethods": [ + "storage.receiving.addDetail", + "storage.receiving.deleteDetail", + "storage.receiving.getReceivingDetail" + ] + } + }, + { + "moduleName": "主体模块", + "moduleKey": "store", + "folder": "store", + "previousModuleName": "主体模块", + "previousModuleKey": "store", + "interfaceChanges": { + "addedMethods": [], + "deletedMethods": [], + "paramsUpdatedMethods": [ + "store.createStore", + "store.createWarehouse" + ], + "responseUpdatedMethods": [] + } + }, + { + "moduleName": "货主-仓库签约模块", + "moduleKey": "storeWarehouse.store", + "folder": "storewarehouse.store", + "previousModuleName": "货主-仓库签约模块", + "previousModuleKey": "storeWarehouse.store", + "interfaceChanges": { + "addedMethods": [], + "deletedMethods": [], + "paramsUpdatedMethods": [ + "storeWarehouse.store.savePolicyConfig" + ], + "responseUpdatedMethods": [ + "storeWarehouse.store.getPolicyConfig", + "storeWarehouse.store.savePolicyConfig" + ] + } + }, + { + "moduleName": "仓库模块", + "moduleKey": "warehouse", + "folder": "warehouse", + "previousModuleName": "仓库模块", + "previousModuleKey": "warehouse", + "interfaceChanges": { + "addedMethods": [], + "deletedMethods": [], + "paramsUpdatedMethods": [ + "warehouse.getSpaceInfo" + ], + "responseUpdatedMethods": [] + } + } + ] }, "interfaceUpdates": { - "added": [], - "deleted": [], - "paramsUpdated": [], - "responseUpdated": [] + "added": [ + { + "moduleName": "商品模块", + "moduleKey": "stock", + "folder": "stock", + "method": "stock.warehouse.export" + }, + { + "moduleName": "商品模块", + "moduleKey": "stock", + "folder": "stock", + "method": "stock.warehouse.exportTaskProgress" + }, + { + "moduleName": "商品模块", + "moduleKey": "stock", + "folder": "stock", + "method": "stock.warehouse.import" + } + ], + "deleted": [ + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.addItem" + } + ], + "paramsUpdated": [ + { + "moduleName": "配置模块", + "moduleKey": "config", + "folder": "config", + "method": "config.list" + }, + { + "moduleName": "仓库设置模块", + "moduleKey": "setting.warehouse", + "folder": "setting.warehouse", + "method": "setting.warehouse.saveSettings" + }, + { + "moduleName": "快递接口管理模块", + "moduleKey": "setting.expressInterface", + "folder": "setting.expressinterface", + "method": "setting.expressInterface.create" + }, + { + "moduleName": "快递接口管理模块", + "moduleKey": "setting.expressInterface", + "folder": "setting.expressinterface", + "method": "setting.expressInterface.update" + }, + { + "moduleName": "商品模块", + "moduleKey": "stock", + "folder": "stock", + "method": "stock.warehouse.handleBatchChange" + }, + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.addDetail" + }, + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.deleteDetail" + }, + { + "moduleName": "主体模块", + "moduleKey": "store", + "folder": "store", + "method": "store.createStore" + }, + { + "moduleName": "主体模块", + "moduleKey": "store", + "folder": "store", + "method": "store.createWarehouse" + }, + { + "moduleName": "货主-仓库签约模块", + "moduleKey": "storeWarehouse.store", + "folder": "storewarehouse.store", + "method": "storeWarehouse.store.savePolicyConfig" + }, + { + "moduleName": "仓库模块", + "moduleKey": "warehouse", + "folder": "warehouse", + "method": "warehouse.getSpaceInfo" + } + ], + "responseUpdated": [ + { + "moduleName": "配置模块", + "moduleKey": "config", + "folder": "config", + "method": "config.list" + }, + { + "moduleName": "仓库设置模块", + "moduleKey": "setting.warehouse", + "folder": "setting.warehouse", + "method": "setting.warehouse.getSettings" + }, + { + "moduleName": "仓库设置模块", + "moduleKey": "setting.warehouse", + "folder": "setting.warehouse", + "method": "setting.warehouse.saveSettings" + }, + { + "moduleName": "快递接口管理模块", + "moduleKey": "setting.expressInterface", + "folder": "setting.expressinterface", + "method": "setting.expressInterface.update" + }, + { + "moduleName": "商品模块", + "moduleKey": "stock", + "folder": "stock", + "method": "stock.warehouse.handleBatchChange" + }, + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.addDetail" + }, + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.deleteDetail" + }, + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.getReceivingDetail" + }, + { + "moduleName": "货主-仓库签约模块", + "moduleKey": "storeWarehouse.store", + "folder": "storewarehouse.store", + "method": "storeWarehouse.store.getPolicyConfig" + }, + { + "moduleName": "货主-仓库签约模块", + "moduleKey": "storeWarehouse.store", + "folder": "storewarehouse.store", + "method": "storeWarehouse.store.savePolicyConfig" + } + ] } }, "interfaces": [ @@ -58,8 +358,52 @@ "description": "Bearer token" } ], - "params": [], - "response": [] + "params": [ + { + "name": "ids", + "type": "array", + "required": true, + "description": "要批量修改的仓库商品记录 ID 数组(stock_warehouse.id)" + }, + { + "name": "method", + "type": "string", + "required": true, + "description": "要修改的字段名,可选值:brand_name、prohibited_id、gross_weight、packing_requirements、managementFlags、stock_unit" + }, + { + "name": "value", + "type": "string|number|object", + "required": true, + "description": "修改值,类型依 method 而定:brand_name/packing_requirements/stock_unit 为 string(<=255 字符);prohibited_id 为 number(整数);gross_weight 为 number(正数,可含小数);managementFlags 为 object,必须包含 is_sn_mgmt/is_shelf_life_mgmt/is_batch_mgmt,值为 'Y' 或 'N'" + }, + { + "name": "values", + "type": "any", + "required": false, + "description": "兼容字段:当前实现以 `value` 为准,不使用 `values`。若客户端历史使用 `values`,请切换为 `value`。" + } + ], + "response": [ + { + "name": "code", + "type": "number", + "required": false, + "description": "业务状态码,200 表示成功;405 表示参数/权限校验不通过;500 表示服务器错误" + }, + { + "name": "message", + "type": "string", + "required": false, + "description": "业务提示信息" + }, + { + "name": "data", + "type": "object", + "required": false, + "description": "成功时返回的结果对象" + } + ] }, { "moduleName": "看板模块", @@ -7491,8 +7835,8 @@ "moduleKey": "setting.expressInterface", "moduleFolder": "setting.expressinterface", "method": "setting.expressInterface.create", - "title": "在当前仓库范围内创建快递接口,仅写入已实现字段(见 params),仓库由系统自动填充,禁止传入 warehouse_id/warehouseId。", - "description": "在当前仓库范围内创建快递接口,仅写入已实现字段(见 params),仓库由系统自动填充,禁止传入 warehouse_id/warehouseId。", + "title": "在当前仓库范围内创建快递接口。支持 snake_case 与 camelCase 别名入参;sys_express_code 可选显式传入,不传时服务端按 express_code + platform_code 自动解析系统快递编码;同仓快递编码或平台重复不再直接返回 409。", + "description": "在当前仓库范围内创建快递接口。支持 snake_case 与 camelCase 别名入参;sys_express_code 可选显式传入,不传时服务端按 express_code + platform_code 自动解析系统快递编码;同仓快递编码或平台重复不再直接返回 409。", "endpoint": "/system", "authRequired": false, "loginRequired": true, @@ -7519,25 +7863,31 @@ "name": "express_code", "type": "string", "required": true, - "description": "快递编码(不区分大小写,服务端会转为大写)" + "description": "外部快递 code(支持 expressCode),不区分大小写,服务端会转为大写" }, { "name": "platform_code", "type": "string", "required": true, - "description": "平台代码(不区分大小写,服务端会转为大写)" + "description": "平台代码(支持 platformCode),不区分大小写,服务端会转为大写" + }, + { + "name": "sys_express_code", + "type": "string", + "required": false, + "description": "系统快递编码(支持 sysExpressCode)可选显式传入;未传时服务端按 express_code + platform_code 自动解析" }, { "name": "sender_name", "type": "string", "required": false, - "description": "发件人姓名(可选,最长 50 字符)" + "description": "发件人姓名(支持 senderName,可选,最长 50 字符)" }, { "name": "sender_tel", "type": "string", "required": false, - "description": "发件人电话(可选,最长 11 字符)" + "description": "发件人电话(支持 senderTel,可选,最长 11 字符)" }, { "name": "weight", @@ -7545,6 +7895,12 @@ "required": false, "description": "默认重量(可选,整数)" }, + { + "name": "weight_type", + "type": "number", + "required": false, + "description": "重量类型(支持 weightType,可选,整数)" + }, { "name": "token", "type": "string", @@ -7561,61 +7917,85 @@ "name": "client_id", "type": "string", "required": false, - "description": "客户端 ID(可选,最长 50 字符)" + "description": "客户端 ID(支持 clientId,可选,最长 50 字符)" }, { "name": "is_share", "type": "number", "required": false, - "description": "是否共享(0/1,可选,默认 0)" + "description": "是否共享(支持 isShare;0/1,可选,默认 0)" }, { "name": "share_id", "type": "number", "required": false, - "description": "共享记录 ID(可选,整数)" + "description": "共享记录 ID(支持 shareId,可选,整数)" + }, + { + "name": "ispickup", + "type": "number", + "required": false, + "description": "是否上门取件(支持 isPickup;0/1,可选,默认 0)" + }, + { + "name": "shipperno", + "type": "string", + "required": false, + "description": "电子面单客户号(支持 shipperNo,可选,最长 255 字符)" }, { "name": "can_use_count", "type": "number", "required": false, - "description": "可用次数/配额(可选,整数,最小 0)" + "description": "可用次数/配额(支持 canUseCount,可选,整数,最小 0)" }, { "name": "province_name", "type": "string", "required": false, - "description": "省(可选,最长 255 字符)" + "description": "省(支持 provinceName,可选,最长 255 字符)" }, { "name": "city_name", "type": "string", "required": false, - "description": "市(可选,最长 255 字符)" + "description": "市(支持 cityName,可选,最长 255 字符)" }, { "name": "district_name", "type": "string", "required": false, - "description": "区/县(可选,最长 255 字符)" + "description": "区/县(支持 districtName,可选,最长 255 字符)" + }, + { + "name": "address", + "type": "string", + "required": false, + "description": "详细地址(可选,最长 255 字符)" + }, + { + "name": "town_name", + "type": "string", + "required": false, + "description": "乡镇/街道(支持 townName,可选,最长 255 字符)" }, { "name": "site_code", "type": "string", "required": false, - "description": "站点编码(可选,最长 255 字符)" + "description": "站点编码(支持 siteCode,可选,最长 255 字符)" }, { "name": "product_type", "type": "string", "required": false, - "description": "快递产品类型(可选,最长 50 字符)" + "description": "快递产品类型(支持 productType,可选,最长 50 字符)" }, { "name": "shop_name", "type": "string", "required": false, - "description": "店铺名称/分组标识(可选,最长 255 字符)" + "description": "店铺名称/分组标识(支持 shopName,可选,最长 255 字符)" } ], "response": [ @@ -7791,8 +8171,8 @@ "moduleKey": "setting.expressInterface", "moduleFolder": "setting.expressinterface", "method": "setting.expressInterface.update", - "title": "更新快递接口,支持局部字段更新;支持 id 别名 interface_id / interfaceId;禁止通过接口修改 warehouse_id。", - "description": "更新快递接口,支持局部字段更新;支持 id 别名 interface_id / interfaceId;禁止通过接口修改 warehouse_id。", + "title": "更新快递接口,支持局部字段更新与 snake_case/camelCase 别名;支持 id 别名 interface_id / interfaceId;当 express_code/platform_code/sys_express_code 变更时会重算系统快递编码;同仓快递编码或平台重复不再直接返回 409。", + "description": "更新快递接口,支持局部字段更新与 snake_case/camelCase 别名;支持 id 别名 interface_id / interfaceId;当 express_code/platform_code/sys_express_code 变更时会重算系统快递编码;同仓快递编码或平台重复不再直接返回 409。", "endpoint": "/system", "authRequired": false, "loginRequired": true, @@ -7813,7 +8193,7 @@ "name": "id", "type": "number", "required": true, - "description": "快递接口ID;兼容 interface_id / interfaceId" + "description": "快递接口 ID;兼容 interface_id / interfaceId" }, { "name": "name", @@ -7825,31 +8205,31 @@ "name": "express_code", "type": "string", "required": false, - "description": "快递编码(更新时会被转为大写)" + "description": "外部快递 code(支持 expressCode),更新时会转为大写" }, { "name": "platform_code", "type": "string", "required": false, - "description": "平台代码(更新时会被转为大写)" + "description": "平台代码(支持 platformCode),更新时会转为大写" }, { - "name": "express_platform_id", - "type": "number", + "name": "sys_express_code", + "type": "string", "required": false, - "description": "平台接口 ID" + "description": "系统快递编码(支持 sysExpressCode)可选显式传入;不传时服务端按 express_code + platform_code 自动解析" }, { "name": "sender_name", "type": "string", "required": false, - "description": "发件人姓名" + "description": "发件人姓名(支持 senderName)" }, { "name": "sender_tel", "type": "string", "required": false, - "description": "发件人电话" + "description": "发件人电话(支持 senderTel)" }, { "name": "weight", @@ -7857,6 +8237,12 @@ "required": false, "description": "默认重量" }, + { + "name": "weight_type", + "type": "number", + "required": false, + "description": "重量类型(支持 weightType)" + }, { "name": "token", "type": "string", @@ -7873,68 +8259,92 @@ "name": "client_id", "type": "string", "required": false, - "description": "客户端 ID" + "description": "客户端 ID(支持 clientId)" }, { "name": "is_share", "type": "number", "required": false, - "description": "是否共享(0/1)" + "description": "是否共享(支持 isShare;0/1)" }, { "name": "share_id", "type": "number", "required": false, - "description": "共享记录 ID" + "description": "共享记录 ID(支持 shareId)" + }, + { + "name": "ispickup", + "type": "number", + "required": false, + "description": "是否上门取件(支持 isPickup;0/1)" + }, + { + "name": "shipperno", + "type": "string", + "required": false, + "description": "电子面单客户号(支持 shipperNo)" }, { "name": "can_use_count", "type": "number", "required": false, - "description": "可用次数/配额" + "description": "可用次数/配额(支持 canUseCount)" }, { "name": "province_name", "type": "string", "required": false, - "description": "省" + "description": "省(支持 provinceName)" }, { "name": "city_name", "type": "string", "required": false, - "description": "市" + "description": "市(支持 cityName)" }, { "name": "district_name", "type": "string", "required": false, - "description": "区/县" + "description": "区/县(支持 districtName)" + }, + { + "name": "address", + "type": "string", + "required": false, + "description": "详细地址" + }, + { + "name": "town_name", + "type": "string", + "required": false, + "description": "乡镇/街道(支持 townName)" }, { "name": "site_code", "type": "string", "required": false, - "description": "站点编码" + "description": "站点编码(支持 siteCode)" }, { "name": "product_type", "type": "string", "required": false, - "description": "快递产品类型" + "description": "快递产品类型(支持 productType)" }, { "name": "shop_name", "type": "string", "required": false, - "description": "店铺名称/分组标识" + "description": "店铺名称/分组标识(支持 shopName)" } ], "response": [ { "name": "id", "type": "number", - "required": false, + "required": true, "description": "首条更新记录 ID" }, { @@ -8642,14 +9052,20 @@ { "name": "warehouse_id", "type": "number", - "required": false, + "required": true, "description": "仓库 ID" }, { "name": "subject_config", "type": "object", - "required": false, + "required": true, "description": "仓库的 subject_config 配置对象" + }, + { + "name": "subject_config.enable_external_express_code", + "type": "boolean", + "required": true, + "description": "是否启用外部快递编码;默认 false(关闭)。开启后允许按外部系统传入的快递编码进行处理(如无匹配仍以业务校验为准)" } ] }, @@ -8693,26 +9109,38 @@ "type": "number", "required": false, "description": "需清理缓存的仓库 ID(驼峰命名兼容)" + }, + { + "name": "subject_config.enable_external_express_code", + "type": "boolean", + "required": false, + "description": "是否启用外部快递编码;默认 false(关闭)。开启后允许按外部系统传入的快递编码进行处理(如无匹配仍以业务校验为准)" } ], "response": [ { "name": "warehouse_id", "type": "number", - "required": false, + "required": true, "description": "生效的仓库 ID" }, { "name": "subject_config", "type": "object", - "required": false, + "required": true, "description": "保存后的 subject_config" }, { "name": "cache_cleared_warehouse_id", "type": "number", - "required": false, + "required": true, "description": "被清理缓存的仓库 ID(若未清理则为 null)" + }, + { + "name": "subject_config.enable_external_express_code", + "type": "boolean", + "required": true, + "description": "保存后的 subject_config.enable_external_express_code 值" } ] }, @@ -8961,6 +9389,192 @@ "params": [], "response": [] }, + { + "moduleName": "商品模块", + "moduleKey": "stock", + "moduleFolder": "stock", + "method": "stock.warehouse.export", + "title": "提交导出任务,返回 task_id/status/progress/message/result/error/update_time", + "description": "提交导出任务,返回 task_id/status/progress/message/result/error/update_time", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "where", + "type": "object", + "required": false, + "description": "查询条件对象,与 stock.warehouse.list 的 where 语义一致;推荐使用 { operator, value, type } 标准结构,历史简写会在 main 中自动标准化。" + }, + { + "name": "sort", + "type": "object", + "required": false, + "description": "排序参数对象,支持 sortField/sortOrder 与 sort_field/sort_order 下划线别名兼容。" + }, + { + "name": "sort.sortField", + "type": "string", + "required": false, + "description": "排序字段(兼容 sort.sortField)。" + }, + { + "name": "sort.sort_field", + "type": "string", + "required": false, + "description": "排序字段下划线别名(兼容 sort.sort_field)。" + }, + { + "name": "sort.sortOrder", + "type": "string", + "required": false, + "description": "排序方向(ASC/DESC,大小写不敏感)。" + }, + { + "name": "sort.sort_order", + "type": "string", + "required": false, + "description": "排序方向下划线别名(兼容 sort.sort_order)。" + } + ], + "response": [ + { + "name": "task_id", + "type": "string", + "required": false, + "description": "任务 ID(后端生成的唯一标识)" + }, + { + "name": "status", + "type": "string", + "required": false, + "description": "任务状态,枚举:submitted/running/success/failed/not_found" + }, + { + "name": "progress", + "type": "number", + "required": false, + "description": "进度百分比(0-100)" + }, + { + "name": "message", + "type": "string", + "required": false, + "description": "额外提示信息或受理消息" + }, + { + "name": "result", + "type": "object", + "required": false, + "description": "任务成功时返回的结果对象(可选)" + }, + { + "name": "error", + "type": "string", + "required": false, + "description": "失败时的错误信息(可选)" + }, + { + "name": "update_time", + "type": "string", + "required": false, + "description": "最近一次状态更新时间,ISO8601 字符串(可选)" + } + ] + }, + { + "moduleName": "商品模块", + "moduleKey": "stock", + "moduleFolder": "stock", + "method": "stock.warehouse.exportTaskProgress", + "title": "按 task_id 查询导出任务进度,未找到时 status=not_found", + "description": "按 task_id 查询导出任务进度,未找到时 status=not_found", + "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,兼容 taskId" + } + ], + "response": [ + { + "name": "task_id", + "type": "string", + "required": false, + "description": "任务 ID" + }, + { + "name": "status", + "type": "string", + "required": false, + "description": "任务状态:submitted/running/success/failed/not_found" + }, + { + "name": "progress", + "type": "number", + "required": false, + "description": "进度百分比(0-100)" + }, + { + "name": "message", + "type": "string", + "required": false, + "description": "额外提示信息" + }, + { + "name": "result", + "type": "object", + "required": false, + "description": "任务成功时返回的结果对象(可选)" + }, + { + "name": "error", + "type": "string", + "required": false, + "description": "失败时的错误信息(可选)" + }, + { + "name": "download_url", + "type": "string", + "required": false, + "description": "任务完成后可直接下载的文件地址(若有)" + }, + { + "name": "update_time", + "type": "string", + "required": false, + "description": "最近一次状态更新时间,ISO8601 字符串(可选)" + } + ] + }, { "moduleName": "商品模块", "moduleKey": "stock", @@ -9196,8 +9810,52 @@ "description": "Bearer token" } ], - "params": [], - "response": [] + "params": [ + { + "name": "ids", + "type": "array", + "required": true, + "description": "要批量修改的仓库商品记录 ID 数组(stock_warehouse.id)" + }, + { + "name": "method", + "type": "string", + "required": true, + "description": "要修改的字段名,可选值:brand_name、prohibited_id、gross_weight、packing_requirements、managementFlags、stock_unit" + }, + { + "name": "value", + "type": "string|number|object", + "required": true, + "description": "修改值,类型依 method 而定:brand_name/packing_requirements/stock_unit 为 string(<=255 字符);prohibited_id 为 number(整数);gross_weight 为 number(正数,可含小数);managementFlags 为 object,必须包含 is_sn_mgmt/is_shelf_life_mgmt/is_batch_mgmt,值为 'Y' 或 'N'" + }, + { + "name": "values", + "type": "any", + "required": false, + "description": "兼容字段:当前实现以 `value` 为准,不使用 `values`。若客户端历史使用 `values`,请切换为 `value`。" + } + ], + "response": [ + { + "name": "code", + "type": "number", + "required": false, + "description": "业务状态码,200 表示成功;405 表示参数/权限校验不通过;500 表示服务器错误" + }, + { + "name": "message", + "type": "string", + "required": false, + "description": "业务提示信息" + }, + { + "name": "data", + "type": "object", + "required": false, + "description": "成功时返回的结果对象" + } + ] }, { "moduleName": "商品模块", @@ -9224,6 +9882,81 @@ "params": [], "response": [] }, + { + "moduleName": "商品模块", + "moduleKey": "stock", + "moduleFolder": "stock", + "method": "stock.warehouse.import", + "title": "批量导入或更新仓库商品。请求体优先直接传入商品数据数组 JSON(主方式为数组);也兼容以 rows/items/list/data 包装。每项仅需包含商品相关字段;当 SKU 为空时创建新商品,SKU 非空时为更新操作;更新会写操作日志以便审计。未传 store_id 时默认使用当前上下文仓库/主体(ctx.user.store_id)。", + "description": "批量导入或更新仓库商品。请求体优先直接传入商品数据数组 JSON(主方式为数组);也兼容以 rows/items/list/data 包装。每项仅需包含商品相关字段;当 SKU 为空时创建新商品,SKU 非空时为更新操作;更新会写操作日志以便审计。未传 store_id 时默认使用当前上下文仓库/主体(ctx.user.store_id)。", + "endpoint": "/system", + "authRequired": true, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "items / rows / list / data", + "type": "array", + "required": true, + "description": "商品数组(主方式为直接传数组 []),也兼容对象包装:{ rows: [...] } / { items: [...] } / { list: [...] } / { data: [...] }。每项可使用下列字段别名:" + } + ], + "response": [ + { + "name": "total_count", + "type": "number", + "required": false, + "description": "解析到的总条目数" + }, + { + "name": "created_count", + "type": "number", + "required": false, + "description": "成功创建的新商品数" + }, + { + "name": "updated_count", + "type": "number", + "required": false, + "description": "成功更新的商品数" + }, + { + "name": "fail_count", + "type": "number", + "required": false, + "description": "导入失败数" + }, + { + "name": "created_ids", + "type": "array", + "required": false, + "description": "创建成功的商品 ID 列表" + }, + { + "name": "updated_ids", + "type": "array", + "required": false, + "description": "更新成功的商品 ID 列表" + }, + { + "name": "fail_items", + "type": "array", + "required": false, + "description": "失败项明细数组,每项包含原始输入与错误信息" + } + ] + }, { "moduleName": "商品模块", "moduleKey": "stock", @@ -9870,8 +10603,8 @@ "moduleKey": "storage_receiving", "moduleFolder": "storage_receiving", "method": "storage.receiving.addDetail", - "title": "storage.receiving.addDetail 接口", - "description": "storage.receiving.addDetail 接口", + "title": "支持新增可选入参 item;item 有值时按传入字段创建明细(服务端会覆盖 receiving_id 与 creator_id);item 无值时沿原链路创建空白明细。返回的 selectId 与 data.details 语义不变(仍返回新创建明细的 selectId 与更新后的明细列表)。", + "description": "支持新增可选入参 item;item 有值时按传入字段创建明细(服务端会覆盖 receiving_id 与 creator_id);item 无值时沿原链路创建空白明细。返回的 selectId 与 data.details 语义不变(仍返回新创建明细的 selectId 与更新后的明细列表)。", "endpoint": "/system", "authRequired": false, "loginRequired": true, @@ -9887,46 +10620,46 @@ "description": "Bearer token" } ], - "params": [], - "response": [] - }, - { - "moduleName": "收货单模块", - "moduleKey": "storage_receiving", - "moduleFolder": "storage_receiving", - "method": "storage.receiving.addItem", - "title": "storage.receiving.addItem 接口", - "description": "storage.receiving.addItem 接口", - "endpoint": "/system", - "authRequired": true, - "loginRequired": true, - "status": { - "isUsed": false, - "isPlaceholder": false - }, - "headers": [ - { - "name": "Authorization", - "type": "string", - "required": true, - "description": "Bearer token" - } - ], "params": [ { - "name": "id", + "name": "receiving_id", "type": "number", - "required": false, - "description": "id 参数" + "required": true, + "description": "收货单ID" }, { "name": "item", "type": "object", "required": false, - "description": "item 参数" + "description": "可选:按传入字段创建明细;不传则创建空白明细。item.children 需覆盖以下字段(有则写、无则补齐):actual_quantity, box_quantity, boxes_per_pallet, space_id, system_product_id, box_width, box_height, box_length, box_remainder, box_weight, weight, barcode, product_name, pallet_quantity, receiving_time, production_date, expiry_date, remark, batch_number, product_snapshot。若传入 item,服务端仍会覆盖 receiving_id 与 creator_id。" } ], - "response": [] + "response": [ + { + "name": "code", + "type": "number", + "required": true, + "description": "业务状态码,200 表示添加成功" + }, + { + "name": "message", + "type": "string", + "required": true, + "description": "结果描述,成功时为 '添加成功'" + }, + { + "name": "data.details", + "type": "array", + "required": true, + "description": "收货单明细数组(每项为明细对象)" + }, + { + "name": "data.selectId", + "type": "number", + "required": true, + "description": "新创建的明细ID,用于前端选中" + } + ] }, { "moduleName": "收货单模块", @@ -10235,8 +10968,8 @@ "moduleKey": "storage_receiving", "moduleFolder": "storage_receiving", "method": "storage.receiving.deleteDetail", - "title": "storage.receiving.deleteDetail 接口", - "description": "storage.receiving.deleteDetail 接口", + "title": "删除收货单明细并回算统计。仅允许明细创建者在收货中状态删除未入库的明细;服务端从登录用户上下文获取 creator_id(ctx.user.employees_id)与 warehouse_id(ctx.user.store_id)。若关联收货单状态为 completed(已完成)或 cancelled(已取消),接口会返回删除失败(400),不允许删除明细。", + "description": "删除收货单明细并回算统计。仅允许明细创建者在收货中状态删除未入库的明细;服务端从登录用户上下文获取 creator_id(ctx.user.employees_id)与 warehouse_id(ctx.user.store_id)。若关联收货单状态为 completed(已完成)或 cancelled(已取消),接口会返回删除失败(400),不允许删除明细。", "endpoint": "/system", "authRequired": false, "loginRequired": true, @@ -10252,8 +10985,46 @@ "description": "Bearer token" } ], - "params": [], - "response": [] + "params": [ + { + "name": "detail_id", + "type": "number", + "required": true, + "description": "收货单明细 ID(必填)" + } + ], + "response": [ + { + "name": "code", + "type": "number", + "required": false, + "description": "业务状态码,200 表示成功,400/404/500 表示失败" + }, + { + "name": "message", + "type": "string", + "required": false, + "description": "简短的错误或成功信息" + }, + { + "name": "data", + "type": "object", + "required": false, + "description": "成功时返回的结果对象" + }, + { + "name": "data.details", + "type": "array", + "required": false, + "description": "删除后收货单剩余的明细数组。每项字段与 storage.receiving.getReceivingDetail 返回的明细项一致;product_snapshot 为解析后的对象或 null" + }, + { + "name": "data.selectId", + "type": "number|null", + "required": false, + "description": "删除后建议前端选中的明细 ID;无剩余明细时为 null" + } + ] }, { "moduleName": "收货单模块", @@ -10574,6 +11345,30 @@ "required": false, "description": "收货单明细列表,单条记录包含明细字段(见下文)" }, + { + "name": "receiving.details.*.space_id", + "type": "string", + "required": false, + "description": "库位展示名称(string|null)。优先取 custom_space_name,其次取 space_name。兼容说明:该字段历史上为数值库位ID,现已调整为展示名称;原始ID请使用 receiving.details.*.space_id_raw。" + }, + { + "name": "receiving.details.*.space_id_raw", + "type": "number", + "required": false, + "description": "原始库位ID(number|null),用于兼容依赖旧语义(space_id=数字ID)的调用方。" + }, + { + "name": "receiving.details.*.space_name", + "type": "string", + "required": false, + "description": "库位名称/编码(string|null),作为展示名称的回退来源。" + }, + { + "name": "receiving.details.*.custom_space_name", + "type": "string", + "required": false, + "description": "库位自定义名称(string|null,可空)。" + }, { "name": "receiving.details.*.box_remainder", "type": "number", @@ -11531,8 +12326,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、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(关闭))", + "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(关闭))、enable_external_express_code=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(关闭))、enable_external_express_code=false(是否启用外部快递编码,默认 false(关闭))", "endpoint": "/system", "authRequired": false, "loginRequired": true, @@ -11590,6 +12385,12 @@ "type": "boolean", "required": false, "description": "是否自动加团,默认 false(关闭)" + }, + { + "name": "subject_config.enable_external_express_code", + "type": "boolean", + "required": false, + "description": "是否启用外部快递编码;默认 false(关闭)。开启后允许按外部系统传入的快递编码进行处理(如无匹配仍以业务校验为准)" } ], "response": [] @@ -11599,8 +12400,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、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(关闭))", + "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(关闭))、enable_external_express_code=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(关闭))、enable_external_express_code=false(是否启用外部快递编码,默认 false(关闭))", "endpoint": "/system", "authRequired": false, "loginRequired": true, @@ -11658,6 +12459,12 @@ "type": "boolean", "required": false, "description": "是否自动加团,默认 false(关闭)" + }, + { + "name": "subject_config.enable_external_express_code", + "type": "boolean", + "required": false, + "description": "是否启用外部快递编码;默认 false(关闭)。开启后允许按外部系统传入的快递编码进行处理(如无匹配仍以业务校验为准)" } ], "response": [] @@ -11886,7 +12693,26 @@ "description": "签约关系ID,兼容 contract_id" } ], - "response": [] + "response": [ + { + "name": "data.contract_id", + "type": "number", + "required": true, + "description": "签约关系ID" + }, + { + "name": "data.policy_config", + "type": "object", + "required": true, + "description": "策略配置对象(包含默认值补齐后的字段)" + }, + { + "name": "data.policy_config.enable_external_express_code", + "type": "number", + "required": true, + "description": "是否启用外部快递编码(flag:0=关闭,1=开启;默认 0)" + } + ] }, { "moduleName": "货主-仓库签约模块", @@ -12340,10 +13166,35 @@ "name": "policy_config", "type": "object", "required": true, - "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、waybill_custom_display_type(面单自定义显示类型:1=隐藏,2=商品名称和数量,3=拣货库位和条码和数量,4=拣货库位和条码后5位和数量,5=拣货库位商品名称条码和数量)" + "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、waybill_custom_display_type(面单自定义显示类型:1=隐藏,2=商品名称和数量,3=拣货库位和条码和数量,4=拣货库位和条码后5位和数量,5=拣货库位商品名称条码和数量)、enable_external_express_code(是否启用外部快递编码,flag:0=关闭,1=开启;默认 0)" + }, + { + "name": "policy_config.enable_external_express_code", + "type": "number", + "required": false, + "description": "是否启用外部快递编码(flag:0=关闭,1=开启;默认 0)" } ], - "response": [] + "response": [ + { + "name": "data.contract_id", + "type": "number", + "required": true, + "description": "签约关系ID" + }, + { + "name": "data.policy_config", + "type": "object", + "required": true, + "description": "保存后并补齐默认值的策略配置对象" + }, + { + "name": "data.policy_config.enable_external_express_code", + "type": "number", + "required": true, + "description": "是否启用外部快递编码(flag:0=关闭,1=开启;默认 0)" + } + ] }, { "moduleName": "货主-仓库签约模块", @@ -13139,7 +13990,7 @@ { "name": "id", "type": "number", - "required": false, + "required": true, "description": "id 参数" } ], 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 73bf95c5..b8dd5623 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "source": "remote", "filter": { "platform": { @@ -13,27 +13,327 @@ } }, "moduleCount": 36, - "totalInterfaceCount": 251, + "totalInterfaceCount": 253, "changes": { "summary": { "moduleAdded": 0, "moduleDeleted": 0, - "moduleUpdated": 0, - "interfaceAdded": 0, - "interfaceDeleted": 0, - "interfaceParamsUpdated": 0, - "interfaceResponseUpdated": 0 + "moduleUpdated": 8, + "interfaceAdded": 3, + "interfaceDeleted": 1, + "interfaceParamsUpdated": 11, + "interfaceResponseUpdated": 10 }, "moduleUpdates": { "added": [], "deleted": [], - "updated": [] + "updated": [ + { + "moduleName": "配置模块", + "moduleKey": "config", + "folder": "config", + "previousModuleName": "配置模块", + "previousModuleKey": "config", + "interfaceChanges": { + "addedMethods": [], + "deletedMethods": [], + "paramsUpdatedMethods": [ + "config.list" + ], + "responseUpdatedMethods": [ + "config.list" + ] + } + }, + { + "moduleName": "仓库设置模块", + "moduleKey": "setting.warehouse", + "folder": "setting.warehouse", + "previousModuleName": "仓库设置模块", + "previousModuleKey": "setting.warehouse", + "interfaceChanges": { + "addedMethods": [], + "deletedMethods": [], + "paramsUpdatedMethods": [ + "setting.warehouse.saveSettings" + ], + "responseUpdatedMethods": [ + "setting.warehouse.getSettings", + "setting.warehouse.saveSettings" + ] + } + }, + { + "moduleName": "快递接口管理模块", + "moduleKey": "setting.expressInterface", + "folder": "setting.expressinterface", + "previousModuleName": "快递接口管理模块", + "previousModuleKey": "setting.expressInterface", + "interfaceChanges": { + "addedMethods": [], + "deletedMethods": [], + "paramsUpdatedMethods": [ + "setting.expressInterface.create", + "setting.expressInterface.update" + ], + "responseUpdatedMethods": [ + "setting.expressInterface.update" + ] + } + }, + { + "moduleName": "商品模块", + "moduleKey": "stock", + "folder": "stock", + "previousModuleName": "商品模块", + "previousModuleKey": "stock", + "interfaceChanges": { + "addedMethods": [ + "stock.warehouse.export", + "stock.warehouse.exportTaskProgress", + "stock.warehouse.import" + ], + "deletedMethods": [], + "paramsUpdatedMethods": [ + "stock.warehouse.handleBatchChange" + ], + "responseUpdatedMethods": [ + "stock.warehouse.handleBatchChange" + ] + } + }, + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "previousModuleName": "收货单模块", + "previousModuleKey": "storage_receiving", + "interfaceChanges": { + "addedMethods": [], + "deletedMethods": [ + "storage.receiving.addItem" + ], + "paramsUpdatedMethods": [ + "storage.receiving.addDetail", + "storage.receiving.deleteDetail" + ], + "responseUpdatedMethods": [ + "storage.receiving.addDetail", + "storage.receiving.deleteDetail", + "storage.receiving.getReceivingDetail" + ] + } + }, + { + "moduleName": "主体模块", + "moduleKey": "store", + "folder": "store", + "previousModuleName": "主体模块", + "previousModuleKey": "store", + "interfaceChanges": { + "addedMethods": [], + "deletedMethods": [], + "paramsUpdatedMethods": [ + "store.createStore", + "store.createWarehouse" + ], + "responseUpdatedMethods": [] + } + }, + { + "moduleName": "货主-仓库签约模块", + "moduleKey": "storeWarehouse.store", + "folder": "storewarehouse.store", + "previousModuleName": "货主-仓库签约模块", + "previousModuleKey": "storeWarehouse.store", + "interfaceChanges": { + "addedMethods": [], + "deletedMethods": [], + "paramsUpdatedMethods": [ + "storeWarehouse.store.savePolicyConfig" + ], + "responseUpdatedMethods": [ + "storeWarehouse.store.getPolicyConfig", + "storeWarehouse.store.savePolicyConfig" + ] + } + }, + { + "moduleName": "仓库模块", + "moduleKey": "warehouse", + "folder": "warehouse", + "previousModuleName": "仓库模块", + "previousModuleKey": "warehouse", + "interfaceChanges": { + "addedMethods": [], + "deletedMethods": [], + "paramsUpdatedMethods": [ + "warehouse.getSpaceInfo" + ], + "responseUpdatedMethods": [] + } + } + ] }, "interfaceUpdates": { - "added": [], - "deleted": [], - "paramsUpdated": [], - "responseUpdated": [] + "added": [ + { + "moduleName": "商品模块", + "moduleKey": "stock", + "folder": "stock", + "method": "stock.warehouse.export" + }, + { + "moduleName": "商品模块", + "moduleKey": "stock", + "folder": "stock", + "method": "stock.warehouse.exportTaskProgress" + }, + { + "moduleName": "商品模块", + "moduleKey": "stock", + "folder": "stock", + "method": "stock.warehouse.import" + } + ], + "deleted": [ + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.addItem" + } + ], + "paramsUpdated": [ + { + "moduleName": "配置模块", + "moduleKey": "config", + "folder": "config", + "method": "config.list" + }, + { + "moduleName": "仓库设置模块", + "moduleKey": "setting.warehouse", + "folder": "setting.warehouse", + "method": "setting.warehouse.saveSettings" + }, + { + "moduleName": "快递接口管理模块", + "moduleKey": "setting.expressInterface", + "folder": "setting.expressinterface", + "method": "setting.expressInterface.create" + }, + { + "moduleName": "快递接口管理模块", + "moduleKey": "setting.expressInterface", + "folder": "setting.expressinterface", + "method": "setting.expressInterface.update" + }, + { + "moduleName": "商品模块", + "moduleKey": "stock", + "folder": "stock", + "method": "stock.warehouse.handleBatchChange" + }, + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.addDetail" + }, + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.deleteDetail" + }, + { + "moduleName": "主体模块", + "moduleKey": "store", + "folder": "store", + "method": "store.createStore" + }, + { + "moduleName": "主体模块", + "moduleKey": "store", + "folder": "store", + "method": "store.createWarehouse" + }, + { + "moduleName": "货主-仓库签约模块", + "moduleKey": "storeWarehouse.store", + "folder": "storewarehouse.store", + "method": "storeWarehouse.store.savePolicyConfig" + }, + { + "moduleName": "仓库模块", + "moduleKey": "warehouse", + "folder": "warehouse", + "method": "warehouse.getSpaceInfo" + } + ], + "responseUpdated": [ + { + "moduleName": "配置模块", + "moduleKey": "config", + "folder": "config", + "method": "config.list" + }, + { + "moduleName": "仓库设置模块", + "moduleKey": "setting.warehouse", + "folder": "setting.warehouse", + "method": "setting.warehouse.getSettings" + }, + { + "moduleName": "仓库设置模块", + "moduleKey": "setting.warehouse", + "folder": "setting.warehouse", + "method": "setting.warehouse.saveSettings" + }, + { + "moduleName": "快递接口管理模块", + "moduleKey": "setting.expressInterface", + "folder": "setting.expressinterface", + "method": "setting.expressInterface.update" + }, + { + "moduleName": "商品模块", + "moduleKey": "stock", + "folder": "stock", + "method": "stock.warehouse.handleBatchChange" + }, + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.addDetail" + }, + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.deleteDetail" + }, + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.getReceivingDetail" + }, + { + "moduleName": "货主-仓库签约模块", + "moduleKey": "storeWarehouse.store", + "folder": "storewarehouse.store", + "method": "storeWarehouse.store.getPolicyConfig" + }, + { + "moduleName": "货主-仓库签约模块", + "moduleKey": "storeWarehouse.store", + "folder": "storewarehouse.store", + "method": "storeWarehouse.store.savePolicyConfig" + } + ] } }, "modules": [ @@ -848,11 +1148,17 @@ "moduleName": "商品模块", "moduleKey": "stock", "folder": "stock", - "interfaceCount": 22, + "interfaceCount": 25, "interfaces": [ { "method": "stock.warehouse.list" }, + { + "method": "stock.warehouse.export" + }, + { + "method": "stock.warehouse.exportTaskProgress" + }, { "method": "stock.warehouse.getProhibitedType" }, @@ -868,6 +1174,9 @@ { "method": "stock.warehouse.createWarehouseStock" }, + { + "method": "stock.warehouse.import" + }, { "method": "stock.warehouse.getBarcodes" }, @@ -922,7 +1231,7 @@ "moduleName": "收货单模块", "moduleKey": "storage_receiving", "folder": "storage_receiving", - "interfaceCount": 18, + "interfaceCount": 17, "interfaces": [ { "method": "storage.receiving.getReceivingList" @@ -951,9 +1260,6 @@ { "method": "storage.receiving.queryReceivingLogs" }, - { - "method": "storage.receiving.addItem" - }, { "method": "storage.receiving.removeItem" }, 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 f3a573e1..75dbdc2c 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 0bfbd098..85d5ce15 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "source": "remote", "filter": { "platform": { @@ -25,8 +25,12 @@ "interfaceChanges": { "addedMethods": [], "deletedMethods": [], - "paramsUpdatedMethods": [], - "responseUpdatedMethods": [] + "paramsUpdatedMethods": [ + "config.list" + ], + "responseUpdatedMethods": [ + "config.list" + ] } } }, @@ -50,8 +54,52 @@ "description": "Bearer token" } ], - "params": [], - "response": [] + "params": [ + { + "name": "ids", + "type": "array", + "required": true, + "description": "要批量修改的仓库商品记录 ID 数组(stock_warehouse.id)" + }, + { + "name": "method", + "type": "string", + "required": true, + "description": "要修改的字段名,可选值:brand_name、prohibited_id、gross_weight、packing_requirements、managementFlags、stock_unit" + }, + { + "name": "value", + "type": "string|number|object", + "required": true, + "description": "修改值,类型依 method 而定:brand_name/packing_requirements/stock_unit 为 string(<=255 字符);prohibited_id 为 number(整数);gross_weight 为 number(正数,可含小数);managementFlags 为 object,必须包含 is_sn_mgmt/is_shelf_life_mgmt/is_batch_mgmt,值为 'Y' 或 'N'" + }, + { + "name": "values", + "type": "any", + "required": false, + "description": "兼容字段:当前实现以 `value` 为准,不使用 `values`。若客户端历史使用 `values`,请切换为 `value`。" + } + ], + "response": [ + { + "name": "code", + "type": "number", + "required": false, + "description": "业务状态码,200 表示成功;405 表示参数/权限校验不通过;500 表示服务器错误" + }, + { + "name": "message", + "type": "string", + "required": false, + "description": "业务提示信息" + }, + { + "name": "data", + "type": "object", + "required": false, + "description": "成功时返回的结果对象" + } + ] } ] } 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 92ce7869..9105dc7c 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 07639888..cd8006b4 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 80c54f03..482b812b 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 95569d9c..843fa745 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 349f347f..0e8c74ac 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 12f89ceb..0515dbb0 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 d82ed7fe..5e83fa87 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 0f2cbec0..ab5d429e 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 2879e4a6..20831a45 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 46b97d56..98f06eef 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 465b00a9..3d9a0454 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 b0801848..223d9351 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 29bb1577..b72ab7b1 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 71fc2655..166fa067 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 a3bdd3ce..e844ed4a 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 7925c8e8..ff2520f7 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 bb90ca4e..966040aa 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 db90203f..20b63da7 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 4efc22ba..db6938f2 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 c4df795a..74c4e3ab 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 f9653c15..7f835b79 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 925b9570..fe268b38 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 c864ac68..c20ceb84 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 54742e5a..a9d7deef 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 27bcb0db..df196fe2 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 ddd64170..b2e8f265 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/order/_module.lifecycle.json b/workflows/api-doc-system/data/module/order/_module.lifecycle.json index 5211a810..4d035322 100644 --- a/workflows/api-doc-system/data/module/order/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/order/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-05-09 09:52:14", - "updatedAt": "2026-05-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/order/module.json b/workflows/api-doc-system/data/module/order/module.json index 69350085..96e93dcc 100644 --- a/workflows/api-doc-system/data/module/order/module.json +++ b/workflows/api-doc-system/data/module/order/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "source": "remote", "filter": { "platform": { 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 a3737681..fb3d6fe1 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 86cf3f08..fa5e7087 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 afa7eed7..4a49e9cf 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 7f87525c..b862f4fd 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 1a3a4848..45c11a37 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 96478237..e78ccf83 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 88c34403..11bd1700 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 67619037..c1d33da2 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 bb2856f7..e99c4cc2 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 1410be57..0c6af237 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 fb276cbb..92e1dae2 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 8a551376..abb252f8 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "source": "remote", "filter": { "platform": { @@ -25,8 +25,13 @@ "interfaceChanges": { "addedMethods": [], "deletedMethods": [], - "paramsUpdatedMethods": [], - "responseUpdatedMethods": [] + "paramsUpdatedMethods": [ + "setting.expressInterface.create", + "setting.expressInterface.update" + ], + "responseUpdatedMethods": [ + "setting.expressInterface.update" + ] } } }, @@ -135,8 +140,8 @@ }, { "method": "setting.expressInterface.create", - "title": "在当前仓库范围内创建快递接口,仅写入已实现字段(见 params),仓库由系统自动填充,禁止传入 warehouse_id/warehouseId。", - "description": "在当前仓库范围内创建快递接口,仅写入已实现字段(见 params),仓库由系统自动填充,禁止传入 warehouse_id/warehouseId。", + "title": "在当前仓库范围内创建快递接口。支持 snake_case 与 camelCase 别名入参;sys_express_code 可选显式传入,不传时服务端按 express_code + platform_code 自动解析系统快递编码;同仓快递编码或平台重复不再直接返回 409。", + "description": "在当前仓库范围内创建快递接口。支持 snake_case 与 camelCase 别名入参;sys_express_code 可选显式传入,不传时服务端按 express_code + platform_code 自动解析系统快递编码;同仓快递编码或平台重复不再直接返回 409。", "endpoint": "/system", "authRequired": false, "loginRequired": true, @@ -163,25 +168,31 @@ "name": "express_code", "type": "string", "required": true, - "description": "快递编码(不区分大小写,服务端会转为大写)" + "description": "外部快递 code(支持 expressCode),不区分大小写,服务端会转为大写" }, { "name": "platform_code", "type": "string", "required": true, - "description": "平台代码(不区分大小写,服务端会转为大写)" + "description": "平台代码(支持 platformCode),不区分大小写,服务端会转为大写" + }, + { + "name": "sys_express_code", + "type": "string", + "required": false, + "description": "系统快递编码(支持 sysExpressCode)可选显式传入;未传时服务端按 express_code + platform_code 自动解析" }, { "name": "sender_name", "type": "string", "required": false, - "description": "发件人姓名(可选,最长 50 字符)" + "description": "发件人姓名(支持 senderName,可选,最长 50 字符)" }, { "name": "sender_tel", "type": "string", "required": false, - "description": "发件人电话(可选,最长 11 字符)" + "description": "发件人电话(支持 senderTel,可选,最长 11 字符)" }, { "name": "weight", @@ -189,6 +200,12 @@ "required": false, "description": "默认重量(可选,整数)" }, + { + "name": "weight_type", + "type": "number", + "required": false, + "description": "重量类型(支持 weightType,可选,整数)" + }, { "name": "token", "type": "string", @@ -205,61 +222,85 @@ "name": "client_id", "type": "string", "required": false, - "description": "客户端 ID(可选,最长 50 字符)" + "description": "客户端 ID(支持 clientId,可选,最长 50 字符)" }, { "name": "is_share", "type": "number", "required": false, - "description": "是否共享(0/1,可选,默认 0)" + "description": "是否共享(支持 isShare;0/1,可选,默认 0)" }, { "name": "share_id", "type": "number", "required": false, - "description": "共享记录 ID(可选,整数)" + "description": "共享记录 ID(支持 shareId,可选,整数)" + }, + { + "name": "ispickup", + "type": "number", + "required": false, + "description": "是否上门取件(支持 isPickup;0/1,可选,默认 0)" + }, + { + "name": "shipperno", + "type": "string", + "required": false, + "description": "电子面单客户号(支持 shipperNo,可选,最长 255 字符)" }, { "name": "can_use_count", "type": "number", "required": false, - "description": "可用次数/配额(可选,整数,最小 0)" + "description": "可用次数/配额(支持 canUseCount,可选,整数,最小 0)" }, { "name": "province_name", "type": "string", "required": false, - "description": "省(可选,最长 255 字符)" + "description": "省(支持 provinceName,可选,最长 255 字符)" }, { "name": "city_name", "type": "string", "required": false, - "description": "市(可选,最长 255 字符)" + "description": "市(支持 cityName,可选,最长 255 字符)" }, { "name": "district_name", "type": "string", "required": false, - "description": "区/县(可选,最长 255 字符)" + "description": "区/县(支持 districtName,可选,最长 255 字符)" + }, + { + "name": "address", + "type": "string", + "required": false, + "description": "详细地址(可选,最长 255 字符)" + }, + { + "name": "town_name", + "type": "string", + "required": false, + "description": "乡镇/街道(支持 townName,可选,最长 255 字符)" }, { "name": "site_code", "type": "string", "required": false, - "description": "站点编码(可选,最长 255 字符)" + "description": "站点编码(支持 siteCode,可选,最长 255 字符)" }, { "name": "product_type", "type": "string", "required": false, - "description": "快递产品类型(可选,最长 50 字符)" + "description": "快递产品类型(支持 productType,可选,最长 50 字符)" }, { "name": "shop_name", "type": "string", "required": false, - "description": "店铺名称/分组标识(可选,最长 255 字符)" + "description": "店铺名称/分组标识(支持 shopName,可选,最长 255 字符)" } ], "response": [ @@ -273,8 +314,8 @@ }, { "method": "setting.expressInterface.update", - "title": "更新快递接口,支持局部字段更新;支持 id 别名 interface_id / interfaceId;禁止通过接口修改 warehouse_id。", - "description": "更新快递接口,支持局部字段更新;支持 id 别名 interface_id / interfaceId;禁止通过接口修改 warehouse_id。", + "title": "更新快递接口,支持局部字段更新与 snake_case/camelCase 别名;支持 id 别名 interface_id / interfaceId;当 express_code/platform_code/sys_express_code 变更时会重算系统快递编码;同仓快递编码或平台重复不再直接返回 409。", + "description": "更新快递接口,支持局部字段更新与 snake_case/camelCase 别名;支持 id 别名 interface_id / interfaceId;当 express_code/platform_code/sys_express_code 变更时会重算系统快递编码;同仓快递编码或平台重复不再直接返回 409。", "endpoint": "/system", "authRequired": false, "loginRequired": true, @@ -295,7 +336,7 @@ "name": "id", "type": "number", "required": true, - "description": "快递接口ID;兼容 interface_id / interfaceId" + "description": "快递接口 ID;兼容 interface_id / interfaceId" }, { "name": "name", @@ -307,31 +348,31 @@ "name": "express_code", "type": "string", "required": false, - "description": "快递编码(更新时会被转为大写)" + "description": "外部快递 code(支持 expressCode),更新时会转为大写" }, { "name": "platform_code", "type": "string", "required": false, - "description": "平台代码(更新时会被转为大写)" + "description": "平台代码(支持 platformCode),更新时会转为大写" }, { - "name": "express_platform_id", - "type": "number", + "name": "sys_express_code", + "type": "string", "required": false, - "description": "平台接口 ID" + "description": "系统快递编码(支持 sysExpressCode)可选显式传入;不传时服务端按 express_code + platform_code 自动解析" }, { "name": "sender_name", "type": "string", "required": false, - "description": "发件人姓名" + "description": "发件人姓名(支持 senderName)" }, { "name": "sender_tel", "type": "string", "required": false, - "description": "发件人电话" + "description": "发件人电话(支持 senderTel)" }, { "name": "weight", @@ -339,6 +380,12 @@ "required": false, "description": "默认重量" }, + { + "name": "weight_type", + "type": "number", + "required": false, + "description": "重量类型(支持 weightType)" + }, { "name": "token", "type": "string", @@ -355,68 +402,92 @@ "name": "client_id", "type": "string", "required": false, - "description": "客户端 ID" + "description": "客户端 ID(支持 clientId)" }, { "name": "is_share", "type": "number", "required": false, - "description": "是否共享(0/1)" + "description": "是否共享(支持 isShare;0/1)" }, { "name": "share_id", "type": "number", "required": false, - "description": "共享记录 ID" + "description": "共享记录 ID(支持 shareId)" + }, + { + "name": "ispickup", + "type": "number", + "required": false, + "description": "是否上门取件(支持 isPickup;0/1)" + }, + { + "name": "shipperno", + "type": "string", + "required": false, + "description": "电子面单客户号(支持 shipperNo)" }, { "name": "can_use_count", "type": "number", "required": false, - "description": "可用次数/配额" + "description": "可用次数/配额(支持 canUseCount)" }, { "name": "province_name", "type": "string", "required": false, - "description": "省" + "description": "省(支持 provinceName)" }, { "name": "city_name", "type": "string", "required": false, - "description": "市" + "description": "市(支持 cityName)" }, { "name": "district_name", "type": "string", "required": false, - "description": "区/县" + "description": "区/县(支持 districtName)" + }, + { + "name": "address", + "type": "string", + "required": false, + "description": "详细地址" + }, + { + "name": "town_name", + "type": "string", + "required": false, + "description": "乡镇/街道(支持 townName)" }, { "name": "site_code", "type": "string", "required": false, - "description": "站点编码" + "description": "站点编码(支持 siteCode)" }, { "name": "product_type", "type": "string", "required": false, - "description": "快递产品类型" + "description": "快递产品类型(支持 productType)" }, { "name": "shop_name", "type": "string", "required": false, - "description": "店铺名称/分组标识" + "description": "店铺名称/分组标识(支持 shopName)" } ], "response": [ { "name": "id", "type": "number", - "required": false, + "required": true, "description": "首条更新记录 ID" }, { 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 0f254200..20cf9fda 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 365c5eed..9baeab06 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 c2969b8f..2f6f71d9 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 3a203b57..2083e288 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 6d77b37d..50d0d65b 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 d54399a0..ce6645d3 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 c394852f..7040e603 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 8527b086..ab0cb914 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 24080635..82b40718 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 97e1e2b4..a07d0af0 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "source": "remote", "filter": { "platform": { @@ -25,8 +25,13 @@ "interfaceChanges": { "addedMethods": [], "deletedMethods": [], - "paramsUpdatedMethods": [], - "responseUpdatedMethods": [] + "paramsUpdatedMethods": [ + "setting.warehouse.saveSettings" + ], + "responseUpdatedMethods": [ + "setting.warehouse.getSettings", + "setting.warehouse.saveSettings" + ] } } }, @@ -55,14 +60,20 @@ { "name": "warehouse_id", "type": "number", - "required": false, + "required": true, "description": "仓库 ID" }, { "name": "subject_config", "type": "object", - "required": false, + "required": true, "description": "仓库的 subject_config 配置对象" + }, + { + "name": "subject_config.enable_external_express_code", + "type": "boolean", + "required": true, + "description": "是否启用外部快递编码;默认 false(关闭)。开启后允许按外部系统传入的快递编码进行处理(如无匹配仍以业务校验为准)" } ] }, @@ -132,26 +143,38 @@ "type": "number", "required": false, "description": "需清理缓存的仓库 ID(驼峰命名兼容)" + }, + { + "name": "subject_config.enable_external_express_code", + "type": "boolean", + "required": false, + "description": "是否启用外部快递编码;默认 false(关闭)。开启后允许按外部系统传入的快递编码进行处理(如无匹配仍以业务校验为准)" } ], "response": [ { "name": "warehouse_id", "type": "number", - "required": false, + "required": true, "description": "生效的仓库 ID" }, { "name": "subject_config", "type": "object", - "required": false, + "required": true, "description": "保存后的 subject_config" }, { "name": "cache_cleared_warehouse_id", "type": "number", - "required": false, + "required": true, "description": "被清理缓存的仓库 ID(若未清理则为 null)" + }, + { + "name": "subject_config.enable_external_express_code", + "type": "boolean", + "required": true, + "description": "保存后的 subject_config.enable_external_express_code 值" } ] } 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 a09ccfc2..24f436d3 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 a71644b2..41e22ab1 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "source": "remote", "filter": { "platform": { @@ -16,17 +16,25 @@ "name": "商品模块", "key": "stock", "folder": "stock", - "interfaceCount": 22 + "interfaceCount": 25 }, "changes": { "fromPreviousSnapshot": { "moduleAdded": false, "moduleRenamed": false, "interfaceChanges": { - "addedMethods": [], + "addedMethods": [ + "stock.warehouse.export", + "stock.warehouse.exportTaskProgress", + "stock.warehouse.import" + ], "deletedMethods": [], - "paramsUpdatedMethods": [], - "responseUpdatedMethods": [] + "paramsUpdatedMethods": [ + "stock.warehouse.handleBatchChange" + ], + "responseUpdatedMethods": [ + "stock.warehouse.handleBatchChange" + ] } } }, @@ -66,6 +74,186 @@ ], "response": [] }, + { + "method": "stock.warehouse.export", + "title": "提交导出任务,返回 task_id/status/progress/message/result/error/update_time", + "description": "提交导出任务,返回 task_id/status/progress/message/result/error/update_time", + "endpoint": "/system", + "authRequired": false, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "where", + "type": "object", + "required": false, + "description": "查询条件对象,与 stock.warehouse.list 的 where 语义一致;推荐使用 { operator, value, type } 标准结构,历史简写会在 main 中自动标准化。" + }, + { + "name": "sort", + "type": "object", + "required": false, + "description": "排序参数对象,支持 sortField/sortOrder 与 sort_field/sort_order 下划线别名兼容。" + }, + { + "name": "sort.sortField", + "type": "string", + "required": false, + "description": "排序字段(兼容 sort.sortField)。" + }, + { + "name": "sort.sort_field", + "type": "string", + "required": false, + "description": "排序字段下划线别名(兼容 sort.sort_field)。" + }, + { + "name": "sort.sortOrder", + "type": "string", + "required": false, + "description": "排序方向(ASC/DESC,大小写不敏感)。" + }, + { + "name": "sort.sort_order", + "type": "string", + "required": false, + "description": "排序方向下划线别名(兼容 sort.sort_order)。" + } + ], + "response": [ + { + "name": "task_id", + "type": "string", + "required": false, + "description": "任务 ID(后端生成的唯一标识)" + }, + { + "name": "status", + "type": "string", + "required": false, + "description": "任务状态,枚举:submitted/running/success/failed/not_found" + }, + { + "name": "progress", + "type": "number", + "required": false, + "description": "进度百分比(0-100)" + }, + { + "name": "message", + "type": "string", + "required": false, + "description": "额外提示信息或受理消息" + }, + { + "name": "result", + "type": "object", + "required": false, + "description": "任务成功时返回的结果对象(可选)" + }, + { + "name": "error", + "type": "string", + "required": false, + "description": "失败时的错误信息(可选)" + }, + { + "name": "update_time", + "type": "string", + "required": false, + "description": "最近一次状态更新时间,ISO8601 字符串(可选)" + } + ] + }, + { + "method": "stock.warehouse.exportTaskProgress", + "title": "按 task_id 查询导出任务进度,未找到时 status=not_found", + "description": "按 task_id 查询导出任务进度,未找到时 status=not_found", + "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,兼容 taskId" + } + ], + "response": [ + { + "name": "task_id", + "type": "string", + "required": false, + "description": "任务 ID" + }, + { + "name": "status", + "type": "string", + "required": false, + "description": "任务状态:submitted/running/success/failed/not_found" + }, + { + "name": "progress", + "type": "number", + "required": false, + "description": "进度百分比(0-100)" + }, + { + "name": "message", + "type": "string", + "required": false, + "description": "额外提示信息" + }, + { + "name": "result", + "type": "object", + "required": false, + "description": "任务成功时返回的结果对象(可选)" + }, + { + "name": "error", + "type": "string", + "required": false, + "description": "失败时的错误信息(可选)" + }, + { + "name": "download_url", + "type": "string", + "required": false, + "description": "任务完成后可直接下载的文件地址(若有)" + }, + { + "name": "update_time", + "type": "string", + "required": false, + "description": "最近一次状态更新时间,ISO8601 字符串(可选)" + } + ] + }, { "method": "stock.warehouse.getProhibitedType", "title": "查询违禁品类型列表(系统预设+仓库自定义)", @@ -214,6 +402,78 @@ "params": [], "response": [] }, + { + "method": "stock.warehouse.import", + "title": "批量导入或更新仓库商品。请求体优先直接传入商品数据数组 JSON(主方式为数组);也兼容以 rows/items/list/data 包装。每项仅需包含商品相关字段;当 SKU 为空时创建新商品,SKU 非空时为更新操作;更新会写操作日志以便审计。未传 store_id 时默认使用当前上下文仓库/主体(ctx.user.store_id)。", + "description": "批量导入或更新仓库商品。请求体优先直接传入商品数据数组 JSON(主方式为数组);也兼容以 rows/items/list/data 包装。每项仅需包含商品相关字段;当 SKU 为空时创建新商品,SKU 非空时为更新操作;更新会写操作日志以便审计。未传 store_id 时默认使用当前上下文仓库/主体(ctx.user.store_id)。", + "endpoint": "/system", + "authRequired": true, + "loginRequired": true, + "status": { + "isUsed": false, + "isPlaceholder": false + }, + "headers": [ + { + "name": "Authorization", + "type": "string", + "required": true, + "description": "Bearer token" + } + ], + "params": [ + { + "name": "items / rows / list / data", + "type": "array", + "required": true, + "description": "商品数组(主方式为直接传数组 []),也兼容对象包装:{ rows: [...] } / { items: [...] } / { list: [...] } / { data: [...] }。每项可使用下列字段别名:" + } + ], + "response": [ + { + "name": "total_count", + "type": "number", + "required": false, + "description": "解析到的总条目数" + }, + { + "name": "created_count", + "type": "number", + "required": false, + "description": "成功创建的新商品数" + }, + { + "name": "updated_count", + "type": "number", + "required": false, + "description": "成功更新的商品数" + }, + { + "name": "fail_count", + "type": "number", + "required": false, + "description": "导入失败数" + }, + { + "name": "created_ids", + "type": "array", + "required": false, + "description": "创建成功的商品 ID 列表" + }, + { + "name": "updated_ids", + "type": "array", + "required": false, + "description": "更新成功的商品 ID 列表" + }, + { + "name": "fail_items", + "type": "array", + "required": false, + "description": "失败项明细数组,每项包含原始输入与错误信息" + } + ] + }, { "method": "stock.warehouse.getBarcodes", "title": "查询商品条码列表", @@ -516,8 +776,52 @@ "description": "Bearer token" } ], - "params": [], - "response": [] + "params": [ + { + "name": "ids", + "type": "array", + "required": true, + "description": "要批量修改的仓库商品记录 ID 数组(stock_warehouse.id)" + }, + { + "name": "method", + "type": "string", + "required": true, + "description": "要修改的字段名,可选值:brand_name、prohibited_id、gross_weight、packing_requirements、managementFlags、stock_unit" + }, + { + "name": "value", + "type": "string|number|object", + "required": true, + "description": "修改值,类型依 method 而定:brand_name/packing_requirements/stock_unit 为 string(<=255 字符);prohibited_id 为 number(整数);gross_weight 为 number(正数,可含小数);managementFlags 为 object,必须包含 is_sn_mgmt/is_shelf_life_mgmt/is_batch_mgmt,值为 'Y' 或 'N'" + }, + { + "name": "values", + "type": "any", + "required": false, + "description": "兼容字段:当前实现以 `value` 为准,不使用 `values`。若客户端历史使用 `values`,请切换为 `value`。" + } + ], + "response": [ + { + "name": "code", + "type": "number", + "required": false, + "description": "业务状态码,200 表示成功;405 表示参数/权限校验不通过;500 表示服务器错误" + }, + { + "name": "message", + "type": "string", + "required": false, + "description": "业务提示信息" + }, + { + "name": "data", + "type": "object", + "required": false, + "description": "成功时返回的结果对象" + } + ] }, { "method": "stock.warehouse.getStockUnits", 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 5152dd4c..96523fad 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 0eee3062..7f04bd34 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 fcf34b16..ecd3f6d1 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 a0c94834..cb3ec163 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "source": "remote", "filter": { "platform": { diff --git a/workflows/api-doc-system/data/module/storage.report/_module.lifecycle.json b/workflows/api-doc-system/data/module/storage.report/_module.lifecycle.json index c286a758..d63d8e95 100644 --- a/workflows/api-doc-system/data/module/storage.report/_module.lifecycle.json +++ b/workflows/api-doc-system/data/module/storage.report/_module.lifecycle.json @@ -6,7 +6,7 @@ }, "status": "active", "createdAt": "2026-05-15 17:32:36", - "updatedAt": "2026-05-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "deletedAt": null, "restoredAt": null } diff --git a/workflows/api-doc-system/data/module/storage.report/module.json b/workflows/api-doc-system/data/module/storage.report/module.json index f6adccd0..07456ed7 100644 --- a/workflows/api-doc-system/data/module/storage.report/module.json +++ b/workflows/api-doc-system/data/module/storage.report/module.json @@ -1,6 +1,6 @@ { - "generatedAt": "2026-05-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 24e4eca5..f8be9603 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 ccdbe67d..d75569ad 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 29f791da..74d7af90 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 b69d0253..c0c3dc6c 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "source": "remote", "filter": { "platform": { @@ -16,7 +16,7 @@ "name": "收货单模块", "key": "storage_receiving", "folder": "storage_receiving", - "interfaceCount": 18 + "interfaceCount": 17 }, "changes": { "fromPreviousSnapshot": { @@ -24,9 +24,18 @@ "moduleRenamed": false, "interfaceChanges": { "addedMethods": [], - "deletedMethods": [], - "paramsUpdatedMethods": [], - "responseUpdatedMethods": [] + "deletedMethods": [ + "storage.receiving.addItem" + ], + "paramsUpdatedMethods": [ + "storage.receiving.addDetail", + "storage.receiving.deleteDetail" + ], + "responseUpdatedMethods": [ + "storage.receiving.addDetail", + "storage.receiving.deleteDetail", + "storage.receiving.getReceivingDetail" + ] } } }, @@ -131,6 +140,30 @@ "required": false, "description": "收货单明细列表,单条记录包含明细字段(见下文)" }, + { + "name": "receiving.details.*.space_id", + "type": "string", + "required": false, + "description": "库位展示名称(string|null)。优先取 custom_space_name,其次取 space_name。兼容说明:该字段历史上为数值库位ID,现已调整为展示名称;原始ID请使用 receiving.details.*.space_id_raw。" + }, + { + "name": "receiving.details.*.space_id_raw", + "type": "number", + "required": false, + "description": "原始库位ID(number|null),用于兼容依赖旧语义(space_id=数字ID)的调用方。" + }, + { + "name": "receiving.details.*.space_name", + "type": "string", + "required": false, + "description": "库位名称/编码(string|null),作为展示名称的回退来源。" + }, + { + "name": "receiving.details.*.custom_space_name", + "type": "string", + "required": false, + "description": "库位自定义名称(string|null,可空)。" + }, { "name": "receiving.details.*.box_remainder", "type": "number", @@ -529,41 +562,6 @@ } ] }, - { - "method": "storage.receiving.addItem", - "title": "storage.receiving.addItem 接口", - "description": "storage.receiving.addItem 接口", - "endpoint": "/system", - "authRequired": true, - "loginRequired": true, - "status": { - "isUsed": false, - "isPlaceholder": false - }, - "headers": [ - { - "name": "Authorization", - "type": "string", - "required": true, - "description": "Bearer token" - } - ], - "params": [ - { - "name": "id", - "type": "number", - "required": false, - "description": "id 参数" - }, - { - "name": "item", - "type": "object", - "required": false, - "description": "item 参数" - } - ], - "response": [] - }, { "method": "storage.receiving.removeItem", "title": "storage.receiving.removeItem 接口", @@ -781,8 +779,8 @@ }, { "method": "storage.receiving.addDetail", - "title": "storage.receiving.addDetail 接口", - "description": "storage.receiving.addDetail 接口", + "title": "支持新增可选入参 item;item 有值时按传入字段创建明细(服务端会覆盖 receiving_id 与 creator_id);item 无值时沿原链路创建空白明细。返回的 selectId 与 data.details 语义不变(仍返回新创建明细的 selectId 与更新后的明细列表)。", + "description": "支持新增可选入参 item;item 有值时按传入字段创建明细(服务端会覆盖 receiving_id 与 creator_id);item 无值时沿原链路创建空白明细。返回的 selectId 与 data.details 语义不变(仍返回新创建明细的 selectId 与更新后的明细列表)。", "endpoint": "/system", "authRequired": false, "loginRequired": true, @@ -798,13 +796,51 @@ "description": "Bearer token" } ], - "params": [], - "response": [] + "params": [ + { + "name": "receiving_id", + "type": "number", + "required": true, + "description": "收货单ID" + }, + { + "name": "item", + "type": "object", + "required": false, + "description": "可选:按传入字段创建明细;不传则创建空白明细。item.children 需覆盖以下字段(有则写、无则补齐):actual_quantity, box_quantity, boxes_per_pallet, space_id, system_product_id, box_width, box_height, box_length, box_remainder, box_weight, weight, barcode, product_name, pallet_quantity, receiving_time, production_date, expiry_date, remark, batch_number, product_snapshot。若传入 item,服务端仍会覆盖 receiving_id 与 creator_id。" + } + ], + "response": [ + { + "name": "code", + "type": "number", + "required": true, + "description": "业务状态码,200 表示添加成功" + }, + { + "name": "message", + "type": "string", + "required": true, + "description": "结果描述,成功时为 '添加成功'" + }, + { + "name": "data.details", + "type": "array", + "required": true, + "description": "收货单明细数组(每项为明细对象)" + }, + { + "name": "data.selectId", + "type": "number", + "required": true, + "description": "新创建的明细ID,用于前端选中" + } + ] }, { "method": "storage.receiving.deleteDetail", - "title": "storage.receiving.deleteDetail 接口", - "description": "storage.receiving.deleteDetail 接口", + "title": "删除收货单明细并回算统计。仅允许明细创建者在收货中状态删除未入库的明细;服务端从登录用户上下文获取 creator_id(ctx.user.employees_id)与 warehouse_id(ctx.user.store_id)。若关联收货单状态为 completed(已完成)或 cancelled(已取消),接口会返回删除失败(400),不允许删除明细。", + "description": "删除收货单明细并回算统计。仅允许明细创建者在收货中状态删除未入库的明细;服务端从登录用户上下文获取 creator_id(ctx.user.employees_id)与 warehouse_id(ctx.user.store_id)。若关联收货单状态为 completed(已完成)或 cancelled(已取消),接口会返回删除失败(400),不允许删除明细。", "endpoint": "/system", "authRequired": false, "loginRequired": true, @@ -820,8 +856,46 @@ "description": "Bearer token" } ], - "params": [], - "response": [] + "params": [ + { + "name": "detail_id", + "type": "number", + "required": true, + "description": "收货单明细 ID(必填)" + } + ], + "response": [ + { + "name": "code", + "type": "number", + "required": false, + "description": "业务状态码,200 表示成功,400/404/500 表示失败" + }, + { + "name": "message", + "type": "string", + "required": false, + "description": "简短的错误或成功信息" + }, + { + "name": "data", + "type": "object", + "required": false, + "description": "成功时返回的结果对象" + }, + { + "name": "data.details", + "type": "array", + "required": false, + "description": "删除后收货单剩余的明细数组。每项字段与 storage.receiving.getReceivingDetail 返回的明细项一致;product_snapshot 为解析后的对象或 null" + }, + { + "name": "data.selectId", + "type": "number|null", + "required": false, + "description": "删除后建议前端选中的明细 ID;无剩余明细时为 null" + } + ] }, { "method": "storage.receiving.detailChange", 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 89c45561..0f7b1b8b 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 e0a63a12..a9b29070 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "source": "remote", "filter": { "platform": { @@ -25,7 +25,10 @@ "interfaceChanges": { "addedMethods": [], "deletedMethods": [], - "paramsUpdatedMethods": [], + "paramsUpdatedMethods": [ + "store.createStore", + "store.createWarehouse" + ], "responseUpdatedMethods": [] } } @@ -33,8 +36,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、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(关闭))", + "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(关闭))、enable_external_express_code=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(关闭))、enable_external_express_code=false(是否启用外部快递编码,默认 false(关闭))", "endpoint": "/system", "authRequired": false, "loginRequired": true, @@ -92,14 +95,20 @@ "type": "boolean", "required": false, "description": "是否自动加团,默认 false(关闭)" + }, + { + "name": "subject_config.enable_external_express_code", + "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、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(关闭))", + "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(关闭))、enable_external_express_code=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(关闭))、enable_external_express_code=false(是否启用外部快递编码,默认 false(关闭))", "endpoint": "/system", "authRequired": false, "loginRequired": true, @@ -157,6 +166,12 @@ "type": "boolean", "required": false, "description": "是否自动加团,默认 false(关闭)" + }, + { + "name": "subject_config.enable_external_express_code", + "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 4708567c..e7be2a62 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 09353c2a..db0d689d 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "source": "remote", "filter": { "platform": { @@ -25,8 +25,13 @@ "interfaceChanges": { "addedMethods": [], "deletedMethods": [], - "paramsUpdatedMethods": [], - "responseUpdatedMethods": [] + "paramsUpdatedMethods": [ + "storeWarehouse.store.savePolicyConfig" + ], + "responseUpdatedMethods": [ + "storeWarehouse.store.getPolicyConfig", + "storeWarehouse.store.savePolicyConfig" + ] } } }, @@ -480,7 +485,26 @@ "description": "签约关系ID,兼容 contract_id" } ], - "response": [] + "response": [ + { + "name": "data.contract_id", + "type": "number", + "required": true, + "description": "签约关系ID" + }, + { + "name": "data.policy_config", + "type": "object", + "required": true, + "description": "策略配置对象(包含默认值补齐后的字段)" + }, + { + "name": "data.policy_config.enable_external_express_code", + "type": "number", + "required": true, + "description": "是否启用外部快递编码(flag:0=关闭,1=开启;默认 0)" + } + ] }, { "method": "storeWarehouse.store.getPolicyConfigFields", @@ -534,10 +558,35 @@ "name": "policy_config", "type": "object", "required": true, - "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、waybill_custom_display_type(面单自定义显示类型:1=隐藏,2=商品名称和数量,3=拣货库位和条码和数量,4=拣货库位和条码后5位和数量,5=拣货库位商品名称条码和数量)" + "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、waybill_custom_display_type(面单自定义显示类型:1=隐藏,2=商品名称和数量,3=拣货库位和条码和数量,4=拣货库位和条码后5位和数量,5=拣货库位商品名称条码和数量)、enable_external_express_code(是否启用外部快递编码,flag:0=关闭,1=开启;默认 0)" + }, + { + "name": "policy_config.enable_external_express_code", + "type": "number", + "required": false, + "description": "是否启用外部快递编码(flag:0=关闭,1=开启;默认 0)" } ], - "response": [] + "response": [ + { + "name": "data.contract_id", + "type": "number", + "required": true, + "description": "签约关系ID" + }, + { + "name": "data.policy_config", + "type": "object", + "required": true, + "description": "保存后并补齐默认值的策略配置对象" + }, + { + "name": "data.policy_config.enable_external_express_code", + "type": "number", + "required": true, + "description": "是否启用外部快递编码(flag:0=关闭,1=开启;默认 0)" + } + ] }, { "method": "storeWarehouse.store.listApiConfig", 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 549b158f..37cc9cac 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 ca2c46db..e5e2a1b9 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "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 79575058..791622e5 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-16 17:38:39", + "updatedAt": "2026-05-18 09:09:02", "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 db02a139..78310b2f 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-16 17:38:39", - "generatedAtLocal": "2026-05-16 17:38:39", + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", "source": "remote", "filter": { "platform": { @@ -25,7 +25,9 @@ "interfaceChanges": { "addedMethods": [], "deletedMethods": [], - "paramsUpdatedMethods": [], + "paramsUpdatedMethods": [ + "warehouse.getSpaceInfo" + ], "responseUpdatedMethods": [] } } @@ -803,7 +805,7 @@ { "name": "id", "type": "number", - "required": false, + "required": true, "description": "id 参数" } ], diff --git a/workflows/api-doc-system/data/pending-updates.json b/workflows/api-doc-system/data/pending-updates.json index 0967ef42..b13ee1f8 100644 --- a/workflows/api-doc-system/data/pending-updates.json +++ b/workflows/api-doc-system/data/pending-updates.json @@ -1 +1,184 @@ -{} +{ + "generatedAt": "2026-05-18 09:09:02", + "generatedAtLocal": "2026-05-18 09:09:02", + "source": "remote", + "filter": { + "platform": { + "value": "web", + "label": "网页端" + }, + "project": { + "value": "all", + "label": "全部" + } + }, + "summary": { + "moduleAdded": 0, + "moduleDeleted": 0, + "interfaceAdded": 3, + "interfaceDeleted": 1, + "interfaceParamsUpdated": 11, + "interfaceResponseUpdated": 10, + "totalChangedItems": 25 + }, + "interfaceUpdates": { + "added": [ + { + "moduleName": "商品模块", + "moduleKey": "stock", + "folder": "stock", + "method": "stock.warehouse.export" + }, + { + "moduleName": "商品模块", + "moduleKey": "stock", + "folder": "stock", + "method": "stock.warehouse.exportTaskProgress" + }, + { + "moduleName": "商品模块", + "moduleKey": "stock", + "folder": "stock", + "method": "stock.warehouse.import" + } + ], + "deleted": [ + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.addItem" + } + ], + "paramsUpdated": [ + { + "moduleName": "配置模块", + "moduleKey": "config", + "folder": "config", + "method": "config.list" + }, + { + "moduleName": "仓库设置模块", + "moduleKey": "setting.warehouse", + "folder": "setting.warehouse", + "method": "setting.warehouse.saveSettings" + }, + { + "moduleName": "快递接口管理模块", + "moduleKey": "setting.expressInterface", + "folder": "setting.expressinterface", + "method": "setting.expressInterface.create" + }, + { + "moduleName": "快递接口管理模块", + "moduleKey": "setting.expressInterface", + "folder": "setting.expressinterface", + "method": "setting.expressInterface.update" + }, + { + "moduleName": "商品模块", + "moduleKey": "stock", + "folder": "stock", + "method": "stock.warehouse.handleBatchChange" + }, + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.addDetail" + }, + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.deleteDetail" + }, + { + "moduleName": "主体模块", + "moduleKey": "store", + "folder": "store", + "method": "store.createStore" + }, + { + "moduleName": "主体模块", + "moduleKey": "store", + "folder": "store", + "method": "store.createWarehouse" + }, + { + "moduleName": "货主-仓库签约模块", + "moduleKey": "storeWarehouse.store", + "folder": "storewarehouse.store", + "method": "storeWarehouse.store.savePolicyConfig" + }, + { + "moduleName": "仓库模块", + "moduleKey": "warehouse", + "folder": "warehouse", + "method": "warehouse.getSpaceInfo" + } + ], + "responseUpdated": [ + { + "moduleName": "配置模块", + "moduleKey": "config", + "folder": "config", + "method": "config.list" + }, + { + "moduleName": "仓库设置模块", + "moduleKey": "setting.warehouse", + "folder": "setting.warehouse", + "method": "setting.warehouse.getSettings" + }, + { + "moduleName": "仓库设置模块", + "moduleKey": "setting.warehouse", + "folder": "setting.warehouse", + "method": "setting.warehouse.saveSettings" + }, + { + "moduleName": "快递接口管理模块", + "moduleKey": "setting.expressInterface", + "folder": "setting.expressinterface", + "method": "setting.expressInterface.update" + }, + { + "moduleName": "商品模块", + "moduleKey": "stock", + "folder": "stock", + "method": "stock.warehouse.handleBatchChange" + }, + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.addDetail" + }, + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.deleteDetail" + }, + { + "moduleName": "收货单模块", + "moduleKey": "storage_receiving", + "folder": "storage_receiving", + "method": "storage.receiving.getReceivingDetail" + }, + { + "moduleName": "货主-仓库签约模块", + "moduleKey": "storeWarehouse.store", + "folder": "storewarehouse.store", + "method": "storeWarehouse.store.getPolicyConfig" + }, + { + "moduleName": "货主-仓库签约模块", + "moduleKey": "storeWarehouse.store", + "folder": "storewarehouse.store", + "method": "storeWarehouse.store.savePolicyConfig" + } + ] + } +}