This commit is contained in:
yin 2026-05-18 18:13:38 +08:00
parent 4afce2376d
commit 207a21e272
85 changed files with 2522 additions and 440 deletions

View File

@ -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<string, unknown>
subject_config: SettingWarehouseSubjectConfig
cache_warehouse_id?: number
cacheWarehouseId?: number
}
export function settingWarehouseGetSettings(data: Record<string, unknown> = {}): Promise<any> {
export type SettingWarehouseSaveSettingsPayload = SettingWarehouseSettingsPayload & {
cache_cleared_warehouse_id: number | null
}
export function unwrapSettingWarehousePayload(
res: Record<string, unknown> | null | undefined
): Record<string, unknown> {
const payload = res?.data
if (payload && typeof payload === 'object' && !Array.isArray(payload)) {
return payload as Record<string, unknown>
}
return (res ?? {}) as Record<string, unknown>
}
export function settingWarehouseGetSettings(
data: Record<string, unknown> = {}
): Promise<{ code?: number; message?: string; data?: SettingWarehouseSettingsPayload } & Record<string, unknown>> {
return request({
url: '/system',
method: 'post',
@ -36,7 +69,9 @@ export function settingWarehouseGetFieldMeta(): Promise<any> {
} as any)
}
export function settingWarehouseSaveSettings(data: SettingWarehouseSaveSettingsParams): Promise<any> {
export function settingWarehouseSaveSettings(
data: SettingWarehouseSaveSettingsParams
): Promise<{ code?: number; message?: string; data?: SettingWarehouseSaveSettingsPayload } & Record<string, unknown>> {
return request({
url: '/system',
method: 'post',

View File

@ -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'

View File

@ -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<string, unknown>)
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)

View File

@ -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<string, unknown>)
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)

View File

@ -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) => {

View File

@ -231,12 +231,23 @@
/>
</el-drawer>
<!-- 批量修改库存单位对话框 -->
<el-dialog title="批量修改库存单位" align-center v-model="showBatchDialog" width="420px">
<!-- 批量修改(下拉类:库存单位、违禁品类型等) -->
<el-dialog :title="batchDialogTitle" align-center v-model="showBatchDialog" width="420px">
<el-form label-width="100px">
<el-form-item label="库存单位">
<el-select v-model="batchDialogValue" placeholder="请选择库存单位" filterable>
<el-option v-for="opt in batchDialogOptions" :key="opt.value" :label="opt.label" :value="opt.value" />
<el-form-item :label="batchDialogFieldLabel">
<el-select
v-model="batchDialogValue"
:placeholder="batchDialogPlaceholder"
filterable
clearable
style="width: 100%"
>
<el-option
v-for="opt in batchDialogOptions"
:key="`${batchDialogCommand}-${opt.value}`"
:label="opt.label"
:value="opt.value"
/>
</el-select>
</el-form-item>
</el-form>
@ -387,8 +398,41 @@ const showBatchDialog = ref(false)
const batchDialogOptions = ref<any[]>([])
const batchDialogValue = ref<any>(null)
const batchDialogCommand = ref('')
const BATCH_SELECT_COMMANDS = new Set(['stock_unit', 'prohibited_id'])
const importFileInputRef = ref<HTMLInputElement | null>(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) {

View File

@ -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') {

View File

@ -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<string | null>(null)
const currentConditionRaw = ref<any>(buildDefaultReportScanCondition())
const currentConditionRaw = ref<any>({})
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)

View File

@ -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<stri
if (arr.length) where.store_ids = arr
}
if (Object.prototype.hasOwnProperty.call(conds, 'by_space')) {
const bySpaceRaw = conds.by_space?.value ?? conds.by_space
if (bySpaceRaw === true || bySpaceRaw === 'true' || bySpaceRaw === 1 || bySpaceRaw === '1') {
where.by_space = true
} else if (
bySpaceRaw === false ||
bySpaceRaw === 'false' ||
bySpaceRaw === 0 ||
bySpaceRaw === '0'
) {
where.by_space = false
}
}
return where
}

View File

@ -237,7 +237,11 @@ import { ElMessage } from 'element-plus'
import {
settingWarehouseGetSettings,
settingWarehouseGetFieldMeta,
settingWarehouseSaveSettings
settingWarehouseSaveSettings,
unwrapSettingWarehousePayload,
type SettingWarehouseSaveSettingsParams,
type SettingWarehouseSaveSettingsPayload,
type SettingWarehouseSettingsPayload
} from '@/api/setting.warehouse/settingwarehouse'
const okCode = (code: unknown) => 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<string, unknown>, keys: string[]): string | undefined {
@ -531,15 +542,7 @@ function onArrayObjectItemInput(
subjectConfig[field.key] = list
}
function unwrapApiPayload(res: Record<string, any> | null | undefined): Record<string, any> {
const payload = res?.data
if (payload && typeof payload === 'object' && !Array.isArray(payload)) {
return payload as Record<string, any>
}
return (res ?? {}) as Record<string, any>
}
function applySettingsPayload(settingsRes: Record<string, any>) {
function applySettingsPayload(settingsRes: SettingWarehouseSettingsPayload | Record<string, any>) {
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<string, any>)
const settingsPayload = unwrapSettingWarehousePayload(
settingsRes as Record<string, unknown>
) as SettingWarehouseSettingsPayload
applySettingsPayload(settingsPayload)
const metaPayload = unwrapApiPayload(metaRes as Record<string, any>)
const metaPayload = unwrapSettingWarehousePayload(metaRes as Record<string, unknown>)
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<typeof settingWarehouseSaveSettings>[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<string, any>))
const savePayload = unwrapSettingWarehousePayload(
res as Record<string, unknown>
) as SettingWarehouseSaveSettingsPayload
applySettingsPayload(savePayload)
const cleared = res.cache_cleared_warehouse_id
const cleared = savePayload.cache_cleared_warehouse_id
if (cleared != null) {
ElMessage.info(`已清理仓库缓存:${cleared}`)
}

View File

@ -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"
},

View File

@ -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
}

View File

@ -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": "成功时返回的结果对象"
}
]
}
]
}

View File

@ -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
}

View File

@ -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": {

View File

@ -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
}

View File

@ -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": {

View File

@ -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"
}

View File

@ -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": {

View File

@ -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"
}

View File

@ -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": {

View File

@ -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"
}

View File

@ -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": {

View File

@ -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"
}

View File

@ -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": {

View File

@ -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"
}

View File

@ -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": {

View File

@ -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"
}

View File

@ -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": {

View File

@ -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"
}

View File

@ -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": {

View File

@ -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"
}

View File

@ -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": {

View File

@ -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
}

View File

@ -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": {

View File

@ -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"
}

View File

@ -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": {

View File

@ -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
}

View File

@ -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": {

View File

@ -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
}

View File

@ -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": {

View File

@ -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
}

View File

@ -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": {

View File

@ -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
}

View File

@ -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": {

View File

@ -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
}

View File

@ -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": {

View File

@ -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
}

View File

@ -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": {

View File

@ -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
}

View File

@ -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": {

View File

@ -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
}

View File

@ -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"
},
{

View File

@ -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
}

View File

@ -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": {

View File

@ -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
}

View File

@ -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": {

View File

@ -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
}

View File

@ -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": {

View File

@ -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
}

View File

@ -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": {

View File

@ -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
}

View File

@ -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 值"
}
]
}

View File

@ -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
}

View File

@ -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",

View File

@ -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
}

View File

@ -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": {

View File

@ -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
}

View File

@ -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": {

View File

@ -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
}

View File

@ -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": {

View File

@ -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
}

View File

@ -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": {

View File

@ -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"
}

View File

@ -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",

View File

@ -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
}

View File

@ -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": []

View File

@ -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
}

View File

@ -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",

View File

@ -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
}

View File

@ -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": {

View File

@ -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
}

View File

@ -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 参数"
}
],

View File

@ -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"
}
]
}
}